Architectural Analysis

Overview

Produce diagram-first architectural reports for a codebase or a scoped subtree. The primary artifact is a set of mermaid diagrams under docs/architecture/<report-date>/<mode>/, accompanied by markdown reports that resolve every callout to a path:line citation. Every node and every edge in every diagram is grounded in the source — no exceptions outside the explicit synthesized-concept escape hatch.

When to use

Trigger this skill when the user asks for:

• A full architectural snapshot of a codebase ("run a full architectural analysis")
• A scoped diagram of a subsystem ("diagram the data flow through <path>")
• A specific mode by name ("ERD for this app", "where are the failure modes in <path>", "map the integration points")

Do not trigger for:

• Pure prose explanations with no diagram requirement (use code-explanation)
• New-system design from a blank page (use system-design)
• Single-file walkthroughs (use diffity-tour)