cartographer
Maintain living architecture maps and interaction flows.
When & Why to Use This Skill
The Cartographer skill automates the maintenance of living architecture maps and interaction flows, ensuring that critical system documentation like ARCHITECTURE.md remains synchronized with the evolving codebase. By inventorying entrypoints and mapping component relationships, it provides a real-time, high-fidelity overview of software structure, which is essential for maintaining system integrity and accelerating developer onboarding.
Use Cases
- Automated Documentation Maintenance: Keep ARCHITECTURE.md and specialized agent-docs updated automatically as the codebase evolves, preventing documentation rot.
- System Flow Visualization: Map complex interaction flows between components to help developers understand dependencies and data paths within the application.
- Architectural Gap Analysis: Identify and record discrepancies or missing links in the system design to improve overall architectural confidence and code quality.
- Agent Context Optimization: Provide AI coding agents with a structured, up-to-date map of the project architecture to improve their navigation and code generation accuracy.
| name | cartographer |
|---|---|
| description | Maintain living architecture maps and interaction flows. |
| short-description | Architecture mapping |
Purpose
Keep ARCHITECTURE.md and .agent-docs/architecture/ up to date.
Steps
- Inventory entrypoints and components.
- Update interaction and flow maps.
- Record gaps and confidence levels.