/dev-deepinit

name: dev-deepinit
description: Deep codebase initialization — generate hierarchical AGENTS.md / CLAUDE.md context files for a new project so engineering agents have full context from session start.

Dev Deepinit

Derived from oh-my-claudecode (MIT, Yeachan Heo). Adapted for the EvoNexus Engineering Layer.

Deep codebase initialization. For a new project, generate hierarchical AGENTS.md / CLAUDE.md context files that give engineering agents full project context from session start — instead of forcing them to re-discover the codebase every session.

Use When

• Onboarding a new project to EvoNexus
• Existing project lacks AGENTS.md / CLAUDE.md / project context docs
• After a major refactor that invalidates existing context docs

Do Not Use When

• Project already has comprehensive context docs
• Trivial / experimental codebases (overhead not worth it)

Workflow

Phase 1 — Discovery

Delegate to `@scout-explorer`:

• Map the directory structure
• Identify the language(s), framework(s), build tools
• Find entry points (main files, package scripts, CI configs)
• Find test setup
• Find existing docs (README, ARCHITECTURE.md, etc.)

Phase 2 — Synthesis

• Project purpose (1-2 sentences)
• Tech stack
• Architecture overview
• Key directories with their purpose
• Build / test / run commands
• Conventions detected (naming, error handling, imports)
• Known gotchas (from comments, TODOs, recent commits)

Phase 3 — Generation

Create the hierarchical context:

{project-root}/
├── CLAUDE.md          # Top-level project context (this is what Claude reads first)
├── AGENTS.md          # Detailed context for engineering agents
└── docs/
    └── architecture/
        └── [C]project-overview-{date}.md

Phase 4 — Verification

• `@oath-verifier` reads the new context docs and confirms they're accurate

Output Files

CLAUDE.md (top of project)

# {Project Name}

[1-2 sentence purpose]

## Tech Stack
- Language: ...
- Framework: ...
- Build: ...

## Quick Commands
- Build: `...`
- Test: `...`
- Run: `...`

## Architecture
[high-level overview]

## Conventions
[detected patterns]

AGENTS.md (detailed context)

# Engineering Context

## Module Map
- `src/auth/` — authentication
- `src/db/` — database layer
- ...

## Key Files
- `src/main.ts:42` — entry point
- ...

## Patterns
[deep convention notes]

## Gotchas
[known pitfalls]

Pairs With

• `@scout-explorer` (Phase 1)
• `@quill-writer` (writes the actual docs)
• `@oath-verifier` (Phase 4 verification)