Skip to main content

Project init

Initialize project instructions and structure, synchronize documentation, and create ADRs, runbooks, and reference guides for either host.

Host-specific setup​

Claude Code uses the source plugin's commands, project-scaffolder knowledge skill, and doc-sync-checker agent. Codex uses generated overlays that adapt initialization to AGENTS.md, .agents/skills/, and available host tools. Do not install Claude hook JSON as if it were Codex configuration.

Workflows​

EntryResult
init-projectDetect the stack and add missing project structure
sync-docsCompare maintained documentation with code and settings
add-adrNumber and draft an architecture decision
add-moduleAdd module instructions and update architecture references
add-runbookCreate an operational runbook
add-reference-docCreate implementation reference material under docs/reference
generate-readmeCreate or refresh a user-facing README
generate-changelogUpdate the release record
health-checkInspect project setup and documentation quality
migrate-hooksMigrate pre-v2.3 hooks, settings.json, and .yml agents to the current stdin/exit 2 contract

Adaptation and quality​

Existing projects keep their detected language, framework, source layout, and user-authored instructions. Generated files should describe real commands and boundaries. Follow the user's language requirement; bilingual templates are an optional output capability, not a requirement to duplicate all documentation.

Health checks report missing setup, instruction quality, architecture coverage, and actionable repairs. Read the actual command rubric before interpreting a numeric score. PR autofix and decision reconciliation belong to co-agent.

Codex package · Source structure reference