git:20260507.8dfdcb4 to git:20260507.9f5be95

---

name: codebase-mapping

description: Automatic codebase indexing for invisible context injection. Catalogs project structure, file types, entry points, dependencies, and test layout.

allowed-tools: Read, Bash, Grep, Glob

graph:

domains: [domain:software-engineering]

skillAreas: [skill-area:agentic-loops, skill-area:orchestration-loop]

workflows: [workflow:feature-development]

topics: [topic:developer-experience]

roles: [role:tech-lead, role:backend-engineer]

- Directory tree with depth-limited enumeration

- Key file identification (entry points, configs, lock files)

### File Type Distribution

- Language breakdown (TypeScript, JavaScript, Python, etc.)

- Framework detection (React, Next.js, Express, etc.)

### Entry Points

- Main entry files (index, main, app)

- CLI entry points

- API route definitions

### Module Dependencies

- Import graph analysis

- Package boundary mapping

- Circular dependency detection

### Test Layout

- Test directory structure

- Test file patterns and conventions

- Test framework identification

## Context Injection

The codebase map is injected as invisible context during UserPromptSubmit, providing:

- Project type and framework awareness

- Convention awareness for code generation

- Dependency awareness for import suggestions

- Test pattern awareness for test generation

## When to Use

- Automatically at ClaudeKit session start

- When project structure changes significantly

- Before research or specification tasks

## Processes Used By

- `claudekit-orchestrator` (session initialization)

- `claudekit-research` (context for research agents)

- `claudekit-spec-workflow` (context for spec creation)