A skill does not appear
Confirm the matching adapter exists. Codex uses .agents/skills/; Claude Code uses .claude/skills/. Restart Claude Code if the adapter was installed while the session was already open.
Overview refuses to run
Replace template placeholders in both planning files. The build plan must contain real feature-sized checkbox items, not examples such as Feature one.
Implement says there is no spec
Run feature for planned work or fix for an unplanned bug. Review the resulting current-feature.md, then implement.
Git blocks the workflow
Blueprint expects a Git repository and a feature or fix branch. Resolve unrelated working-tree changes before starting an automated run. Never discard changes merely to satisfy the workflow.
Build passes but behavior is wrong
Run check against the feature’s done-when criteria. Use browser, CLI, or API evidence that exercises the actual behavior instead of relying on compilation alone.
Setup still feels wrong
Run doctor for a read-only health report. It checks files, adapters, commands, plan readiness, overview freshness, and common drift.