Monorepo Initialization Skill

Purpose

Systematically initialize AGENTS.md files throughout a monorepo, creating a hierarchical context system where:

• Root AGENTS.md coordinates all agents
• Each package/service has its own AGENTS.md with hierarchy metadata
• All files link back to root CLAUDE.md (philosophy)
• AI agents can navigate context efficiently across packages

This enables large projects to maintain clear, navigable agent guidance without overwhelming token budgets.

When to Use

• New monorepo setup - Initialize entire project structure
• Adding new packages - Run on new subdirectory
• Improving agent context - Refresh existing AGENTS.md files
• Scaling team - Ensure new members understand cross-package dependencies
• Microservices - Document each service's agent context independently