# Contributing to Owilix

Welcome to the owilix developer documentation!

## Quick Links

- [Architecture](architecture) - Project structure and core abstractions
- [Coding Guidelines](coding_guidelines) - Coding standards and conventions
- [AI Development](ai_development) - Working with AI agents
- [Epics](epics) - Current work and backlog

## Development Workflow

We use a structured development process:

```
Epic → Feature Branch → Cycles → Phases → Tasks
```

See [Epics](epics) for current work and backlog.

## Getting Started

1. **Setup environment**:
   ```bash
   uv sync
   ```

2. **Run tests**:
   ```bash
   uv run pytest tests/
   ```

3. **Build docs**:
   ```bash
   cd docs
   uv run sphinx-build -b html source/ build/html
   ```

## Documentation Structure

| Location | Purpose |
|----------|---------|
| `docs/source/` | User-facing Sphinx docs |
| `docs/` | Developer/AI reference docs |
| `.agent/workflows/` | AI agent workflows |

```{toctree}
:hidden:
:maxdepth: 1

architecture
coding_guidelines
ai_development
epics
```