Codebase Mapping

Overview

Auto-indexes the project structure to build a comprehensive codebase map. This map is used for invisible context injection via the UserPromptSubmit hook, providing Claude with project awareness without explicit user prompting.

Map Contents

Project Structure

• 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)