What problem does it solve? Non-trivial code changes often get implemented before their architecture is thought through, leading to rework, mismatched patterns, and hidden risks. This Skill enforces a design-first workflow that investigates context, compares real alternatives, and produces a written architecture document for review before implementation begins. ## Core Features & Use Cases - Structured design loop: Moves through understanding, architecture design, doc writing, iteration, and only then a build plan, with code edits explicitly forbidden during design. - Alternatives analysis: Identifies genuine decision forks, lays out candidate approaches with explicit tradeoffs, and commits to a reasoned recommendation. - Persistent design doc: Writes a Markdown design document with sections for problem, context, architecture, key decisions, alternatives, risks, and a deferred implementation plan. - Use Case: Before refactoring a service layer or adding a feature that touches multiple modules, invoke the skill to map existing patterns, compare two or three architectural options, and iterate on a design doc with the user until the approach is approved. ## Quick Start Ask the assistant to design-first the change you have in mind, describing what you want to build or refactor.
