project-context-mapper

Project Context Mapper (Memory Optimizer)

English | Bahasa Indonesia

---

English

Orchestration & Integration

Connects and orchestrates with relevant domain skills like brainstorming, zero-to-prod-orchestrator, and project-context-mapper to ensure cohesive execution.

Description

LLMs struggle with repositories containing hundreds of files; they lose track of where things are, leading to hallucinations and excessive tool calls. This skill forces the agent to create, read, and maintain a CONTEXT_MAP.md—a highly compressed index of the repository's architecture, dependency graphs, and critical file locations. This acts as the agent's "photographic memory".

Trigger Conditions

Activate this skill when:

• The agent enters a massive, existing codebase for the first time.
• The user complains that the AI is "editing the wrong file" or "forgetting how the app is structured."
• Context token usage is dangerously high and needs optimization.

Core Concepts

1. The Context Map Format

The agent should execute a script or traverse the directory to generate a compressed map in CONTEXT_MAP.md (or within .agents/).

# CONTEXT MAP (Do not delete)

## Architecture
- Frontend: Next.js App Router (src/app)
- Backend: Hono RPC (src/server)
- DB: Drizzle (src/db/schema.ts)

## Dependency Graph (Critical Paths)
- `src/app/page.tsx` -> `src/components/ui/Button.tsx`
- `src/server/routes/users.ts` -> `src/db/queries/users.ts`

## State Locations
- Global Auth: `src/store/auth.ts` (Zustand)

2. Workflow

1. On Start: The agent reads CONTEXT_MAP.md instead of blindly listing directories.
2. On Modification: When the agent creates a new major component, route, or service, it MUST append that location to the context map.

Best Practices

• Keep it Ultra-Compressed: Do not store full code in the map. Store ONLY file paths, responsibilities (1 sentence), and connections.
• BM25 Search First: Before writing to the context map, consider using grep_search or semantic search for targeted lookups. The map is for architectural understanding, not exact variable finding.