These are repository-development roles. They are not product runtime agents, prompts, or personas.
- Rehydrates requirements and current repository state from disk.
- Creates one bounded execution plan.
- Identifies decisions that require user or architecture approval.
- Defines observable acceptance before implementation starts.
- Implements only the accepted plan.
- Owns the files assigned by that plan.
- Adds focused tests with the change.
- Records deviations and new evidence in the plan.
- Reviews the diff against the plan, architecture, and repository contract.
- Runs focused tests and
./scripts/check.sh. - Rejects convenient mocks that do not match real contracts.
- Confirms that secrets, paid calls, and production mutations are absent.
When work cannot be completed in one run, use
docs/agent-runs/handoff-template.md. A handoff describes facts on disk,
commands already run, remaining risks, and the exact next action.