Reference
Role routing matrix
| Change type | Primary owner | Required follow-up |
|---|---|---|
| Schema change, migration, query performance | db | tester -> reviewer |
| API or auth update | backend | tester -> security -> reviewer |
| UI behavior and accessibility | frontend | tester -> reviewer |
| CI/CD, deployment, infra/runtime configuration | devops | tester -> security when needed -> reviewer |
| Privacy, retention, disclosure changes | owning layer | tester -> legal -> reviewer |
| Cross-layer feature | backend + frontend | tester -> security/legal when needed -> reviewer |
Core docs map
- AGENTS.md
- .agents/reference-links.md
- agent_docs/active_context.md
- agent_docs/project_brief.md
- agent_docs/tech_stack.md
- agent_docs/verification.md
Release quality bar
- Behavior verified in runtime conditions
- No contract mismatch at boundaries
- Risk reviews completed if applicable
- Reviewer confirms residual risk acceptable
Governance and safety files
- CODE_OF_CONDUCT.md
- SECURITY.md
- SUPPORT.md
- CHANGELOG.md
- .github/CODEOWNERS
CI and deployment workflows
- .github/workflows/deploy-pages.yml
- .github/workflows/installer-smoke-tests.yml
- .github/workflows/repo-production-readiness.yml
Installer Quick Reference
Option map by shell
| Intent | PowerShell option | Bash option |
|---|---|---|
| Set destination folder | -Destination |
--destination |
| Choose assistant directly | -Assistant codex|claude|github |
--assistant codex|claude|github |
| Overwrite existing files | -Force |
--force |
| Create backups before overwrite | -Backup |
--backup |
| Use custom source mirror | -RepoBase |
--repo-base |
Inter-Agent Contract
Required handoff checklist
| Field | Why it matters |
|---|---|
| goal | Defines what the next agent must achieve. |
| scope | Prevents drift outside target files/symbols/flows. |
| changes + evidence | Makes state reproducible and verifiable. |
| risks | Surfaces assumptions, blockers, and open questions. |
| next-owner + done-criteria | Ensures clean ownership transfer and clear exit gates. |