vp-s07-architecture-decisions

Discover implicit architecture decisions by analyzing code patterns, decision traces, and module hotspots to surface undocumented ADRs with rationale and alternatives. The Skill extracts these implicit choices to provide traceable architectural reasoning across the codebase.

An implicit ADR is an architectural choice embedded in code patterns rather than explicit documentation. Code analysis locates these decisions by evaluating structural patterns, trace hotspots, and dependency impacts across modules to extract the underlying rationale.

SCIP indexes and codegraph analysis are utilized to assess structural patterns, locate hotspots, and evaluate impact across modules. They support extracting architectural decisions and documenting the context, rationale, and alternatives for future audits.

Extract and organize ADRs by running pattern discovery across modules to identify decision traces. The process surfaces both explicit and implicit architectural logic, organizing the detected decisions with their corresponding rationale, trade-offs, and alternatives.

Update the mental model with detected architectural decisions by exporting inferred ADRs after pattern discovery. This documents the architectural context, rationale, and alternatives within the mental-model service, enabling traceable reasoning for future audits.