What problem does it solve? Designing system architecture alone often leads to unverified assumptions, missed trade-offs, and undocumented decisions. This Skill acts as an evidence-first design partner that grounds every claim in your actual codebase, separates facts from assumptions, and makes architecture decisions legible and reviewable. ## Core Features & Use Cases - Grounded Design Collaboration: Inspects your repository code, configuration, and docs before describing the current system, citing local paths and separating verified facts from assumptions and unknowns. - Structured Option Comparison: Develops two or three viable architecture approaches and compares them on fit, complexity, reliability, security, cost, reversibility, and failure modes before recommending one. - Design Review & ADRs: Reviews designs across boundaries, data consistency, concurrency, security, observability, and operability, then produces proportionate artifacts such as comparisons, diagrams, design documents, or architecture decision records. - Use Case: You are deciding between a message queue and direct API calls for a new service integration. The Skill inspects your existing services, lays out both options with trade-offs and evidence, and drafts an ADR only after you confirm the decision. ## Quick Start Ask the assistant to help design the architecture for a new feature in this repository and compare two viable approaches with their trade-offs.
