review-cartography

Verify and refine cartography files against repository code.

63|8|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/JoranHonig/grimoire --skill review-cartography
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-cartography
Source: https://github.com/JoranHonig/grimoire/tree/main/skills/review-cartography
Command: npx skills add https://github.com/JoranHonig/grimoire --skill review-cartography

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

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.

Frequently Asked Questions about review-cartography

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate security cartography files against a codebase after refactoring?

Security cartography validation works by spawning independent subagents to verify entry points, key components, flow sequences, and security notes against actual repository files. It corrects stale paths, adds missing handlers, updates frontmatter, and runs validation scripts to ensure format and reciprocal links remain accurate.

What is the best way to detect overlapping flow maps during a security audit?

Overlap detection identifies redundant or intersecting flow maps by running specialized validation scripts across cartography files. It flags candidates for merging and extracts conditional sub-flows when content grows large, keeping security audit documentation maintainable and free of duplicated navigation paths.

How do code review workflows handle stale flow mapping documentation?

Code review workflows handle stale flow mapping by applying automated corrections that fix file and symbol references, update metadata, and add missing entry points. They preserve original created timestamps while updating modified dates to maintain a reliable audit trail of documentation changes.

Can I use subagents to verify security notes and flow sequences in repository files?

Yes, independent subagents can be spawned to read the code and verify security notes, flow sequences, key components, and entry points. They perform focused validation checks against the actual codebase, ensuring documented cartography matches the current repository state.

Does cartography review update reciprocal related links across flow files?

Cartography review updates reciprocal related links by adding cross-references across flow files and running validation to confirm the links are correct. It also updates frontmatter metadata while preserving created dates, ensuring navigation maps stay synchronized for auditors.

When should I run cartography validation scripts for security audit workflows?

Cartography validation scripts should be run regularly as part of an audit to keep flow maps accurate after refactors, new handlers, or security fixes. Running them ensures documented entry points, flow sequences, and security notes match the actual codebase before reviewers rely on them.