What problem does it solve? Keeping architecture documentation accurate after code changes normally requires an expensive full re-scan of the codebase, so docs drift out of date. This Skill re-reads only the changed parts of the codebase and updates just the affected sections of the prose architecture docs, at roughly 5-10% of the cost of a full architect run. ## Core Features & Use Cases - Targeted refresh: Auto-detects changed source areas via git history (or accepts a subtree path) and updates only the corresponding sections of architecture.md, leaving everything else verbatim. - Mode flags: --deployment re-runs the deployment questionnaire, --data / --integrations / --security regenerate individual architecture doc files, and --decisions appends a new AD-NNN entry to the decisions log without touching existing entries. - Consent-gated reads: Applies a Category B source-file consent gate before reading changed entry-point files, and never touches the knowledge graph (that is /graph-sync's job). - Use Case: After refactoring the matters service, run /update-arch src/services/matters/ to refresh only that section of the architecture docs, then run /graph-sync separately if module structure changed. ## Quick Start Ask the AI to run /update-arch with no arguments to auto-detect changed areas and refresh the affected sections of the architecture documentation.
