docs: add state.json update rule to AGENTS.md

2026-02-07 14:55:25 -08:00
parent 308e7f228e
commit c062f687d2
1 changed files with 1 additions and 0 deletions
@@ -5,6 +5,7 @@
 - **Parallelise with subagents:** For every task, use multiple subagents with the appropriate model to work more efficiently. Dispatch independent subtasks in parallel rather than executing them sequentially.
 - **Subagent model selection (MANDATORY):** You MUST use the right model tier for each subagent — `claude-haiku-4.5` for fast/simple/mechanical tasks, `claude-sonnet-4.5` for default/standard implementation work, and `claude-opus-4.6` for complex reasoning or architecture decisions. Never use the same model for all subagents.
 - **Commit often:** `git commit` frequently — after each meaningful unit of work, not just at the end of a task.
+- **Update state.json:** After every feature implementation, modification, or significant change, update `docs/plans/state.json` accordingly — add new phases/entries, update test counts, adjust the `overall_progress` section, and update the `feature_gap_scorecard` if the gap analysis is affected. Commit state.json alongside the feature change, not as a separate afterthought.

 ## Build, Lint, and Test Commands