Skip to content

reese-allison/claude-tools

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

About

Claude Code plugin that generates hierarchical CLAUDE.md files throughout a repository. Runs /init at root, identifies subdirectories needing local context, and creates scoped documentation following Anthropic's guidelines.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors