refresh-architecture

What problem does it solve?

Outdated or missing architecture-analysis artifacts make planning, impact assessment, and parallel work unsafe and slow by depriving engineers and agents of a canonical graph, flow traces, and visual views of the codebase. This Skill provides a reproducible, auditable pipeline to rebuild, validate, diff, and visualize architecture artifacts so teams and automation can make informed decisions.

Core Features & Use Cases

• Regenerate a multi-layer architecture analysis pipeline that produces per-language analysis, a canonical architecture graph, cross-layer flows, high-impact rankings, and summary reports.
• Validate existing graphs to detect broken cross-layer flows and schema issues without regenerating state, and run diffs against a baseline commit to assess architectural impact of changes.
• Produce Mermaid views, parallel modification zone analysis, feature-slice diagrams, and CI-friendly diagnostics; useful before planning work, when validating a PR, or when triaging architectural regressions.

Quick Start

Run a full architecture refresh pipeline to regenerate docs/architecture-analysis artifacts including graphs, views, diagnostics, and summary reports.