Tool Adapters

Codex

Codex reads project skills from .agents/skills/. Invoke them with names such as $discovery, $overview, $feature, $tests, $browser-tests, $ci, and $implement, or ask naturally to run the corresponding workflow.

Claude Code

Claude Code reads project skills from .claude/skills/. Invoke them with slash commands such as /discovery, /overview, /feature, /tests, /browser-tests, /ci, and /implement.

If Blueprint was installed while Claude Code was already open, restart Claude Code in the project folder so newly added skills are discovered.

GitHub Copilot

GitHub Copilot reads AGENTS.md and shares the project skills under .agents/skills/ with Codex. Ask Copilot to run the matching skill, such as the onboard, feature, implement, or check skill.

OpenCode

OpenCode reads AGENTS.md and can discover compatible skills under either .agents/skills/ or .claude/skills/. Ask OpenCode to run the matching skill. The installer reuses one of those compatible trees and does not create a duplicate .opencode/skills/ copy.

Select one or more adapters

The interactive installer shows all four tools in a checkbox list, selected by default. Keep the tools you want, or combine flags for a non-interactive setup:

npx create-ai-blueprint@latest -- --codex --opencode

Available flags are --codex, --claude, --copilot, and --opencode. --all selects every supported tool.

Shared state

All four adapters read and write the same files under blueprint/. Switching tools does not require exporting conversation memory because the current plan, feature checklist, standards, and history live in the repository.

During onboarding, Codex, GitHub Copilot, and OpenCode are grouped together only because they share .agents/. They remain three separate supported tools. Claude Code uses .claude/. Keeping all adapters preserves both compatible trees without creating a separate OpenCode copy.

Keep adapters aligned

When changing a shared skill, apply the equivalent behavior to both adapter folders. Codex and GitHub Copilot share .agents/skills/, while Claude Code uses .claude/skills/. OpenCode reuses either compatible tree. Tool-specific invocation wording can differ, but project safety and workflow boundaries should remain equivalent.