architecture-diagram
Installation
SKILL.md
Architecture Diagram
This skill generates a two-layer architecture visualization: a high-level application architecture diagram and a detailed component relationship diagram. Produce both in a single pass and save to .github/modernize/assessment/engines/facts/architecture-diagram.md.
Input Parameters
workspace-path(optional): Path to the project to analyze (defaults to current directory)
⚠ Mermaid Safety Constraints — read BEFORE you write any ```mermaid block
Mermaid is unforgiving: one illegal character anywhere in a block crashes the whole diagram with Syntax error in text, not just the offending line. There is no partial rendering. Stay strictly inside this subset:
- Chart kind. Only
flowchart TD(Step 1) orflowchart LR(Step 2). Nevergraph TD, never mixed. - Subgraph form. Always
subgraph <AlphaNumId>["display label"]. The id must match[A-Za-z][A-Za-z0-9_]*(no spaces, no punctuation). NEVER use the anonymous formsubgraph "label"— it crashes whenever the label contains(,),:,/,-, etc., and the parser error appears on an unrelated line. - Node form. Only one of:
Id["label"](rectangle),Id(("label"))(circle),Id[("label")](cylinder for data stores). Pick one shape per node — do not stack brackets. - Arrow form. Solid
-->, dotted-.->. If you put a label on an arrow it MUST be double-quoted:-->|"label"|. Never bare-->|label|. - No line breaks in labels. The escape
\nwas removed in modern Mermaid and is the #1 cause of failures. Use<br/>in flowcharts when you really must break a line. Strongly prefer single-line ≤ 60-char labels — put detail in the Inventory / Stack tables instead. - Banned characters inside any label or subgraph title. Use the ASCII replacement: