# Speckit.map

> Codebase Mapper - Automatically analyze project structure, draw dependency diagrams, and write architectural documents.

- Skill: `wedabro/speckit-map` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wedabro/speckit-map`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wedabro/speckit-map/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wedabro (https://skillmd.com/u/wedabro)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wedabro/speckit-map

---


## 🎯 Mission
Helps Agents and Users quickly understand the entire "map" of the codebase, especially old projects (Brownfield) or complex projects.

## 📋 Protocol

### Phase 1: Structure Discovery (Scan structure)
- Scan the entire directory with the command `tree` or `ls -R` .
- Identify core Tech Stack (frameworks, databases, libraries).

### Phase 2: Dependency Mapping (Dependency Diagram)
- Analyze the `import` or `require` commands to find dependencies between modules.
- Save the results to `.agents/codebase/STRUCTURE.md` .

### Phase 3: Integration Inventory (Integration Inventory)
- List 3rd party services (external API, DB connection).
- Save to `.agents/codebase/INTEGRATIONS.md` .

## 📤 Output Artifacts
- `.agents/codebase/ARCHITECTURE.md` : Architecture overview.
- `.agents/codebase/CONVENTIONS.md` : Code conventions in use.

## 🚫 Guard Rails
- DO NOT read the contents of all files at the same time to avoid context overflow. Prioritize reading headers and exports.
- MUST update the map after every major refactor.