improveCodebase scan for module-level friction (shallow modules, seam leaks, locality gaps): an HTML candidate report, then a Design-It-Twice interview on the chosen one. Use when 'improve architecture', 'find deepening opportunities', 'shallow modules', 'design it twice', 'compare alternative interfaces',
map-componentsC4 component view of the modules inside one deployable, one directed arrow per internal build reference, each citing its declaration. Use when 'component diagram', 'what is inside this service', 'module dependencies', 'which way do the arrows point', 'layering of this deployable'. Skip for which rep
map-containersC4 container diagram of one software system: deployables, the stores and brokers their tracked configuration binds, and the edges those endpoints resolve to. Use when 'what actually runs', 'deployables and databases', 'modular monolith', 'which services bind to which broker'. Skip for which reposito
map-contextC4 system context of one software system from tracked configuration: operator-stated actors and external systems named by connection strings, base URLs, and broker namespaces, credentials redacted. Use when 'context diagram', 'what does this system talk to', 'who uses this system'. Skip for many rep
map-dataEntity-relationship diagram from committed schema declarations, with no database connection: Prisma models win over a stated subset of Entity Framework fluent mappings, which win over SQL migrations read from a stated subset of statements, and a disagreement is reported. Use when 'map data', 'ERD',
map-dependenciesProject dependency graph from build manifests, citing the file and declaration on every edge. Use when 'project reference graph', 'what references what', 'internal dependencies', 'package references', 'which projects depend on which'. Skip for which repositories exist (map-landscape), shallow module
map-deploymentC4 deployment view of committed infrastructure: which containers sit on which declared nodes, per environment, and what differs between two environments. Use when 'map deployment', 'deployment diagram', 'what is different in production', 'IaC topology', or 'where does this container run'. Skip when
map-eventsAsync message topology from committed C# publish, send, and consumer registrations. Orphan publishers and consumers are findings; one short name in two namespaces is two messages. Use when 'map events', 'who publishes this message', 'message topology', 'orphan consumer', 'publish subscribe'. Skip wh
map-flowSequence diagram of one C# entry point, each hop citing a tracked call site: an interface, service-locator, or reflection hop stays unresolved, and Publish or Send is a hand-off to map-events. Use when 'map flow', 'sequence diagram', 'trace this request', 'walk me through what happens', or 'dynamic
map-landscapeC4 System Landscape plus application-portfolio table of a repository and the systems it references, with drift reported against a committed landscape record. Use when 'what systems do we have', 'what does this repo depend on', 'who owns which repo', 'what runtimes are we on', 'inventory our systems'
record-decisionArchitecture decision record in the repo's ADR convention, retiring the record it reverses after a yes; with no convention, nothing is written until the human picks a shape. audit lists records the code no longer backs, read-only. Use when 'record this decision', 'write an ADR', 'capture this decisi
setupVerify and converge the architecture plugin's consumer configuration: the convention-home binding, and the architecture topic doc declaring where landscape and portfolio artifacts land (architecture_dir) and which landscape dialect to emit (landscape_dialect). Use when: 'set up architecture', 'where