# Additional Constraints

- When writing code, add necessary comments to clarify non-obvious logic or intent.
- When creating a commit, include a detailed commit message (summary + body with key changes and rationale).

## Documentation-First Governance (Mandatory)

- Agent-driven development MUST follow documents under `docs/guides/` first, especially:
  - `docs/guides/Development_Constraints.md`
  - `docs/guides/Documentation_First_Development_SOP.md`
- Code implementation MUST align with `docs/design/` as the latest full design source of truth.
- If design and implementation diverge, update design docs first, then execute gap analysis before coding.
- Every design doc that governs implementation MUST explicitly contain:
  - overall architecture
  - core workflow
  - data structures
  - key interfaces
  - exception/error handling
- For any bug fix, feature, or refactor, follow the SOP sequence:
  1. perform full-scope analysis and create a master TODO backlog
  2. update design docs and governance docs (docs are canonical)
  3. slice TODO backlog into one or more OpenSpec changes
  4. execute fixes via OpenSpec workflow task-by-task per slice
  5. update TODO/evidence and archive analysis artifacts