Doctor - AI Blueprint Docs

Run a read-only health check for Blueprint setup, adapters, commands, verification, CI, plans, and workflow drift.

What doctor checks

Required Blueprint files and context wiring
blueprint/config.json validity and supported settings
Logical Codex, Claude Code, GitHub Copilot, and OpenCode selections
Compatible .agents/skills/ and .claude/skills/ trees without duplicate OpenCode skills
Project commands and coding-standard fit
Alignment between AGENTS.md, the project Verify command, and GitHub workflow
Root README placement and ignore rules
Plan readiness and overview freshness
Current feature state and git drift

When to run it

Run doctor after onboarding, after moving Blueprint files, or when a skill cannot find expected project state.

Result

Doctor classifies findings and points to the corrective workflow. It recommends $ci or /ci when the documented Verify command and automatic workflow disagree. Missing optional CI alone is informational.

Doctor does not repair files automatically, commit, or change the application.