init-deep

To generate AGENTS.md and CLAUDE.md across a monorepo, automate directory discovery and content templating to create a deeply-nested knowledge base. Run an initialization command to auto-create root and subdirectory documentation with paired symlinks.

Keeping CLAUDE.md paired with AGENTS.md in a multi-package project is best handled via symlink pairing or file merges. This maintains alignment across root, package, and subdirectory knowledge bases without duplicating content manually.

To update existing codebase documentation without overwriting custom files, use the default update mode which applies safeguards. This modifies root and subdirectory AGENTS.md files while protecting your existing content from being overwritten.

Yes, you can fully regenerate AGENTS.md files for all subdirectories from scratch by running the initialization command with the create-new flag. This provides a fresh baseline for monorepos and multi-package projects, replacing existing documentation.

Generating hierarchical AGENTS.md documentation does work for deeply nested codebases. The process supports root, package, and subdirectory knowledge bases, applying directory discovery to map the entire structure efficiently.

You should not use symlinks to pair CLAUDE.md files if your environment restricts symlink creation or requires distinct file content. In such cases, file merges serve as an alternative to maintain alignment without relying on symlinks.