← ClaudeAtlas

architecture-maplisted

Trigger: architecture map, C4 diagram, container diagram, flow map, visual architecture docs, architecture drift refresh. Generate compact C4-lite Mermaid architecture docs from code evidence and refresh them on re-run.
andresnator/agents-orchestrator · ★ 0 · AI & Automation · score 64
Install: claude install-skill andresnator/agents-orchestrator
# Architecture Map ## Activation Contract Use this skill when the user wants visual architecture documentation for a project: system context, containers, and key runtime flows. Do not use it for code-level design review, user story mapping (`usm`), or AI-harness analysis (`absorb`). ## Hard Rules - C4-lite: System Context (level 1) and Container (level 2) only. Component-level diagrams only on explicit request. - Every node and edge comes from code evidence: manifests, build files, configs, routes, entrypoints, deployment descriptors. Never from README claims. Unverifiable elements are marked `hypothesis`. - Derive containers, dependencies, and flows from imports, configs, deployment descriptors, or a code-graph index (for example, CodeGraph MCP/CLI) when available, before file-by-file search; a graph-resolved edge still cites the underlying `file:line`. - Budgets: at most ~30 nodes per diagram and ~120 lines per doc. Split flows into more diagrams before exceeding a budget. - Mermaid only (`flowchart`, `sequenceDiagram`), GitHub-renderable. No external image tooling. - Visual first: diagrams carry the weight; prose is one short paragraph per diagram. ## Doc Folder Rule Write under `<docfolder>/architecture/`, where `<docfolder>` is the project's existing `docs/`, else its existing `doc/`, else a newly created `doc/`. ## Doc Set Three files; concrete skeletons live in `assets/architecture-doc-set.md`: - `index.md`: ~10 lines — what each doc answers, generation date,