thinking-map-territory

Identify and assess map-territory misalignments across debugging, documentation, and architecture decisions.

941|129|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-map-territory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: thinking-map-territory
Source: https://github.com/tjboudreaux/cc-thinking-skills/tree/main/skills/thinking-map-territory
Command: npx skills add https://github.com/tjboudreaux/cc-thinking-skills --skill thinking-map-territory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Recognizes that every representation is a simplification and helps you avoid costly mistakes when plans, diagrams, or metrics diverge from reality.

Core Features & Use Cases

  • Identify when maps diverge from the territory and surface misalignments
  • Provide a structured alignment process: identify maps, assess freshness, check correspondence, and identify gaps
  • Guide teams in debugging, requirements review, architecture decisions, and performance analysis by calibrating confidence and documenting limitations

Quick Start

Apply the Map-Territory Alignment process to verify model accuracy against reality and resolve discrepancies.

Frequently Asked Questions about thinking-map-territory

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

FAQPage Schema
What is map-territory alignment and when do I need to check it?

Map-territory alignment verifies that your architectural diagrams, metrics, and documentation accurately reflect reality. You need it to prevent flawed decisions during debugging, requirements review, architecture decisions, and performance analysis.

How do I verify model accuracy against reality for architecture decisions?

Verify model accuracy by identifying your maps, assessing their freshness, checking correspondence against reality, identifying gaps, calibrating confidence, and documenting limitations to resolve discrepancies and prevent flawed decisions.

How do I find gaps between documentation and actual system behavior?

Find gaps between documentation and system behavior by applying a structured alignment process to assess freshness, check correspondence, identify missing elements, and document limitations to surface misalignments.

Does map-territory alignment work for debugging and performance analysis?

Yes, map-territory alignment works for debugging and performance analysis by calibrating confidence in your metrics and diagrams, identifying gaps, and surfacing misalignments where representations diverge from actual system behavior.

What is the best way to calibrate confidence in metrics and documentation?

The best way to calibrate confidence is to assess map freshness, check correspondence with reality, identify gaps, and document limitations, ensuring your representations remain reliable for decision-making.

What are the limitations of relying on mental models for decision-making?

Mental models are simplifications that can lead to costly mistakes when they diverge from reality. Limitations arise from stale maps, missing gaps, and uncalibrated confidence, requiring structured alignment to document and resolve.