## Deep Docs Index

### Always Read First
- `docs/spec.md`: stable product truth
- `tasks/todos.md`: deferred-goal ledger only
- `.ai/harness/handoff/current.md`: resumable session state
- `.ai/harness/policy.json`: machine-readable workflow contract

### Load On Demand
- `docs/researches/`: deep codebase analysis and hidden contracts
- `plans/plan-*.md`: timestamped plan catalog; use `.ai/harness/active-plan` only for its owning worktree, with `.ai/harness/active-worktree` recording that owner and `.claude/.active-plan` as a legacy fallback
- `tasks/contracts/`: active sprint done definitions
- `tasks/reviews/`: evaluator verdicts
- `tasks/notes/`: task-local implementation decisions and tradeoffs
- `.ai/harness/checks/latest.json`: structured verification evidence
- `.ai/harness/runs/`: immutable run snapshots for verification audit
- `.ai/context/context-map.json`: progressive context index for primary functional-block `CLAUDE.md` and `AGENTS.md` files
- `plans/archive/`: archived plans and outcomes
- `tasks/archive/`: archived todo snapshots
- `docs/reference-configs/agentic-development-flow.md`: gstack/Waza routing, P1/P2/P3 reporting triggers, and daily flow
- `docs/reference-configs/harness-overview.md`: orchestration playbook
- `docs/reference-configs/external-tooling.md`: gstack/Waza/gbrain routing, Codex-first Waza sync, and required CodeGraph readiness commands
- `docs/reference-configs/document-generation.md`: minimal docs profile and on-demand document rules
- `docs/reference-configs/global-working-rules.md`: user-level Claude/Codex rule template
- `docs/reference-configs/sprint-contracts.md`: contract rules
- `docs/reference-configs/evaluator-rubric.md`: review thresholds
- `docs/reference-configs/handoff-protocol.md`: handoff expectations
- `tasks/workstreams/`: durable capability progress ledgers
- `docs/decisions.md`: architecture decisions and trade-offs
- `docs/tech-stack.md`: dependency and runtime constraints

*Generated by local-repo-harness*
