dev-deepinit

To generate CLAUDE.md and AGENTS.md for a new codebase, run a deep codebase initialization process that scouts repository structure and synthesizes architecture into hierarchical context documents for engineering agents.

Deep codebase initialization is a process that generates hierarchical project context by discovering structure, synthesizing architecture and conventions, and verifying accuracy so engineering agents operate with full repository understanding from the first session.

You should regenerate project context documentation during new project onboarding, when AGENTS.md or CLAUDE.md files are missing, or after a major refactor where existing context docs become invalid and no longer reflect the repository architecture.

The best way to onboard an engineering agent is generating hierarchical context docs that summarize purpose, architecture, key directories, build commands, conventions, and known gotchas so the agent can plan, code, review, and test accurately.

Yes, alongside top-level CLAUDE.md and detailed AGENTS.md files, the initialization process can optionally generate dated architecture documentation under the docs/architecture directory to provide deeper structural understanding.

Yes, the initialization process includes an oath-verifier step that checks the accuracy of the synthesized architecture, conventions, and project context before finalizing the CLAUDE.md and AGENTS.md files for engineering workflows.