What problem does it solve? Keeping design documentation consistent with evolving code and specs is tedious and error-prone. This Skill automates the generation and synchronization of structured, language-agnostic design docs (domain.md, technical-spec.md, behavior-spec.md) so documentation never drifts from the actual system. ## Core Features & Use Cases - Structured Doc Generation: Creates a fixed set of design documents (domain, technical spec, behavior spec, reference/) with stable section IDs (D-###, S-###, B-###, R-###) that are never renumbered. - Sync Mode: Updates existing docs to match current code and spec changes, preserving all existing section IDs and appending entries to a design changelog. - Traceability Registry: Maintains a machine-readable traceability.json mapping every section to spec FR IDs, invariants, and code anchors. - Use Case: After completing a development phase, trigger a sync so the design docs reflect the new behavior specs and the traceability table stays aligned with the requirements spec. ## Quick Start Ask the agent to generate design docs for the project into the docs directory using the DESIGN_DOCS mode with a short system description.
