# Claude Code Instructions

Read first:

- README.md
- TASKS.md
- PROJECT_STATE.md
- AGENT_HANDOFF.md
- context/agent-guidelines.md

Rules:

- Complete one task only.
- Make the smallest useful change.
- Run tests.
- Update documentation.
- Commit changes.
- Stop.

Do not start the next task automatically.

## Test Commands

Use the existing virtual environment.

From the repository root, run:

```bash
source .venv/bin/activate
python -m pytest
```

Do not search the filesystem for pytest.
Do not create a new virtual environment unless explicitly asked.

If pytest is unavailable, run:

```bash
pip install -e '.[dev]'
python -m pytest
```

## Validation Commands

For normal task validation, run:

```bash
python -m pytest
rdb status
rdb next
```