/codebase-mapping

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)