# map-project

map-project inspects a single-app repository to build a concise CLAUDE.md router alongside detailed reference guides.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 176 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/map-project/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/map-project

## What it does

This skill builds an accurate context map for coding agents by parsing the source tree. It identifies the application framework, routes, exports, local repository skills under `.claude/skills/`, and MCP setups. Extensive findings move into separate reference guides, leaving `CLAUDE.md` as an uncluttered router that stays well within context limits.

The routine executes across five steps: scoping, code inventory discovery, reference file generation, router compilation, and verification against size budgets. Existing human-authored rules inside `CLAUDE.md` remain intact rather than getting overwritten.

Monorepos and Cargo workspaces will break this specific workflow. The skill operates strictly on single-application trees and requires direct user execution to alter repository files.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/map-project/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/map-project/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/map-project/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/map-project/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills map-project
```

2. **Manually: put the files in place**
- File: `.github/skills/map-project/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path map-project
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/map-project/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill map-project -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ulpi-io/skills/tree/HEAD/map-project/SKILL.md

## When to use it
- refresh agent memory following an architecture refactor
- inventory real routes, services, and exports directly from source code
- document active MCP servers and repository skills for the assistant
- condense bloated CLAUDE.md files into lean routing documents

## Example prompts
- /map-project
- update CLAUDE.md for this repo after auth refactor
- /map-project api only

## Similar
- [project-memory](https://affpapa.org/en/nevibecode/skills/project-memory.md) — skill · 180 installs
- [claude-md-management](https://affpapa.org/en/nevibecode/plugins/claude-md-management.md) — plugin · ★ 47914 repo stars
- [project-context](https://affpapa.org/en/nevibecode/skills/project-context.md) — skill · ★ 134 repo stars
- [claude-md](https://affpapa.org/en/nevibecode/skills/luongnv89-claude-md.md) — skill · ★ 47494 repo stars
- [establishing-project-context](https://affpapa.org/en/nevibecode/skills/establishing-project-context.md) — skill · ★ 1450 repo stars
- [memorize](https://affpapa.org/en/nevibecode/skills/memorize.md) — skill · 1400 installs

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
