What problem does it solve?
Teams often cannot tell whether the architecture their system actually executes still fits current product needs, because documentation drifts, hidden cycles accumulate, and cross-component ownership becomes ambiguous. This Skill performs a read-only, evidence-driven audit of the real architecture so structural risks are found before they become correctness, deployment, or maintenance failures.
Core Features & Use Cases
- Actual Architecture Discovery: Maps modules, layers, entrypoints, deployment units, and runtime wiring from executable evidence rather than folder names or stale diagrams.
- Contract and Dependency Analysis: Traces dependency direction, cycles, forbidden imports, event schema agreement, and configuration ownership with materiality gating.
- Verdict-Based Reporting: Produces a prioritized P0-P3 findings table with PASS, CONCERNS, FAIL, or BLOCKED verdicts and verified practice references.
- Use Case: Before a major refactor, run the audit to confirm whether a suspected cross-layer dependency actually creates change amplification, and get the smallest safe boundary correction with migration risk assessed.
Quick Start
Ask the agent to audit this repository's architecture for boundary violations, dependency cycles, and ownership ambiguity, and return a verdict with prioritized findings.
