Create or update an ADR (Architecture Decision Record) under docs/ADR/ using docs/templates/ADR-Template.md: context, decision, alternatives, consequences, rollout, and verification. Use when changing architecture, boundaries, dependencies, data model, or cross-cutting patterns; ensure it is self-contained, has a…
Create or update docs/Architecture/Overview.md (architecture diagrams): maintain Mermaid diagrams for system/modules, interfaces/contracts, and key classes/types; document dependency rules; link to ADRs/features. Use when onboarding, refactoring, or adding modules/boundaries.
Create or update a feature spec under docs/Features/ using docs/templates/Feature-Template.md: business rules, user flows, system behaviour, Mermaid diagram(s), verification plan, and Definition of Done. Use before implementing a non-trivial feature or when behaviour changes; keep the spec executable (test flows +…
Format code and keep style consistent using the repository’s canonical formatting/lint commands from AGENTS.md. Use after implementing changes or when formatting drift causes noisy diffs; keep formatting changes intentional and verified with build/tests.
Add or update automated tests for a change (bugfix, feature, refactor) using the repository’s testing rules in AGENTS.md. Use TDD where applicable; derive scenarios from docs/Features/ and ADR invariants; prefer stable integration/API/UI tests, run build before tests, and verify meaningful assertions for…