What problem does it solve?
Cartography files that map flows to code drift over time and miss updates, causing agents and auditors to rely on stale or incomplete context. This skill closes the gap by verifying documented flows against the actual repository, correcting stale paths, adding missing entry points, and preserving reliable navigation maps for audits.
Core Features & Use Cases
- Independent verification: Spawn focused subagents to validate entry points, key components, flow sequences, and security notes by reading the code.
- Automated corrections: Update frontmatter, fix file/symbol references, add missing components or entry points, and preserve created timestamps while updating metadata.
- Cross-references & overlap detection: Add reciprocal related links across flows and run overlap detection to identify candidates for merging.
- Conditionalization & validation: Extract conditional sub-flows when content grows large and run validation to ensure format and reciprocal links are correct.
- Use Case: Regularly run as part of an audit to keep cartography files accurate after refactors, new handlers, or security fixes.
Quick Start
Use the review-cartography skill to verify and update a specified cartography flow against the repository, apply fixes, and run validation and overlap checks.