codebase-mapping

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