What problem does it solve? Codebases accumulate architectural knowledge that the code itself cannot express: dependency direction, cross-cutting invariants, user flows, and the reasoning behind irreversible decisions. This Skill maintains a single root DESIGN.md holding exactly that information, keeping it converged with the codebase as it evolves. ## Core Features & Use Cases - Sync mode: Bootstraps a new DESIGN.md from a top-down investigation of entry points, manifests, and module roots, or updates an existing one by diffing against its recorded source commit and reporting stale, uncovered, obsolete, or defective sections. - Review mode: Reports drift between DESIGN.md and the code without writing anything, including detecting a missing file as a finding. - Hard Rule enforcement: Rejects content that restates what reading the code answers (route tables, schemas, signatures), keeping only boundaries, invariants, users, flows, and dated append-only decisions. - Use Case: As a stage of the wayfare workflow, run review to check whether DESIGN.md has drifted from the current HEAD, then run sync to converge confirmed findings and re-anchor the source reference. ## Quick Start Ask the AI to run the architecture skill in review mode to check whether the repository's DESIGN.md has drifted from the current code.
