deep-init

Deep Init

Generate hierarchical CLAUDE.md files throughout a repository, following Anthropic's best practices.

Installation

/plugin marketplace add reese-allison/claude-tools
/plugin install deep-init

Usage

Full Repository

/deep-init

Runs 3 phases:

1. Discovery - Builds directory tree from git ls-files with metadata
2. Judgment - Identifies directories warranting CLAUDE.md using semantic criteria
3. Generation - Parallel subagents write CLAUDE.md for each target

Single Directory

/deep-init services/api

Generates/updates CLAUDE.md for just that directory.

What Gets Generated

CLAUDE.md files contain:

• Build/lint/test commands (especially for running a single test)
• Code style guidelines (imports, formatting, types, naming, error handling)

Which Directories Get CLAUDE.md

A directory qualifies if it is any of:

Type	Description	Examples
Domain Boundary	Distinct conceptual area	auth/, billing/, search/
Integration Point	Connects to external systems	integrations/stripe/, api/webhooks/
Sub-App	Self-contained application	apps/admin/, services/worker/
High Technical Complexity	Complex code needing explanation	compiler/, query-engine/

If parent and child both qualify, only the child gets a file.

See deep-init/commands/init.md for full details.

License

MIT