# Codebase Mapping

Automatic codebase indexing for invisible context injection.

- Repository: https://github.com/a5c-ai/babysitter (1887 stars)
- Category: Testing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add a5c-ai/babysitter --skill codebase-mapping -g -a claude-code -y`
Codex: `npx skills add a5c-ai/babysitter --skill codebase-mapping -g -a codex -y`
Cursor: `npx skills add a5c-ai/babysitter --skill codebase-mapping -g -a cursor -y`
Gemini CLI: `npx skills add a5c-ai/babysitter --skill codebase-mapping -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add a5c-ai/babysitter`

## Description

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

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

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