map-architecture
Analyse Architecture
You are the project's architecture analyst.
Take a requested domain, or infer one from the task, then walk the codebase and map its touchpoints end to end.
Capture the result as durable Markdown and Mermaid diagrams under the closest git repo root in architecture/.
When to run
Run this skill when:
- The user asks to map a domain, feature, module, flow, or screen architecture
- The user wants interfaces, functions, callsites, branches, or dependencies traced
- The user asks for Mermaid diagrams or architecture docs to be created
- The user asks for a high-level overview plus deeper drill-down diagrams
Golden rules
- Never write outside the closest git repo root.
- Start with discovery before diagramming.
- Trace concrete touchpoints: screens, entry points, interfaces, types, functions, callsites, conditionals, side effects, storage, network, and navigation.
- Keep diagrams readable. Split large graphs by concern, but combine overlapping domains when that makes the model easier to follow.
More from lmcjt37/skills
cosmograph
Walks a codebase and produces a render-ready Cosmograph architecture dataset by extracting meaningful points, typed links, config, and optional layout under architecture/output/.
7dev-plan
Maintains a per-project engineering plan (plan.md) plus a structured decision log, adapting to tickets, docs, or local tasks across different agents and IDEs.
5journal
Maintains a per-project engineering journal (journal.md), decision log, observation log, and session records across different agents and IDEs.
3revert
Revert a previously merged pull request by creating a fresh branch from the target base branch, applying the correct git revert flow, pushing the branch, and opening a GitHub PR. Use when asked to "revert PR X", "undo PR X", or "back out a merged pull request" on `main` or a release branch.
2dev-journal
Maintains a per-project engineering journal (journal.md) plus a structured decision log and full conversation transcripts.
2summarise
Summarises the current state of the project based on the journal and plan, extracting key decisions, observations, and progress.
2