Skip to content

An agentic skills framework & software development methodology that works.

codex: clarify subagent tool mapping in bootstrap

Daniel E.8904b7d9dc74
diff --git a/.codex/superpowers-bootstrap.md b/.codex/superpowers-bootstrap.md
index 18fe657f0..a8c3fb444 100644
--- a/.codex/superpowers-bootstrap.md
+++ b/.codex/superpowers-bootstrap.md
@@ -9,7 +9,8 @@ You have superpowers.
**Tool Mapping for Codex:**
When skills reference tools you don't have, substitute your equivalent tools:
- `TodoWrite` → `update_plan` (your planning/task tracking tool)
-- `Task` tool with subagents → Tell the user that subagents aren't available in Codex yet and you'll do the work the subagent would do
+- `Task` tool with subagents → Use Codex collab `spawn_agent` + `wait` when available; if collab is disabled, state that and proceed sequentially
+- `Subagent` / `Agent` tool mentions → Map to `spawn_agent` (collab) or sequential fallback when collab is disabled
- `Skill` tool → `~/.codex/superpowers/.codex/superpowers-codex use-skill` command (already available)
- `Read`, `Write`, `Edit`, `Bash` → Use your native tools with similar functions
@@ -30,4 +31,4 @@ When skills reference tools you don't have, substitute your equivalent tools:
- Personal skills: ~/.codex/skills/ (override superpowers when names match)
IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
-</EXTREMELY_IMPORTANT>
\ No newline at end of file
+</EXTREMELY_IMPORTANT>
diff --git a/docs/README.codex.md b/docs/README.codex.md
index e43004f42..b38744d39 100644
--- a/docs/README.codex.md
+++ b/docs/README.codex.md
@@ -107,7 +107,8 @@ The Codex implementation uses the shared `skills-core` module (ES module format)
Skills written for Claude Code are adapted for Codex with these mappings:
- `TodoWrite` → `update_plan`
-- `Task` with subagents → Tell user subagents aren't available, do work directly
+- `Task` with subagents → Use collab `spawn_agent` + `wait` when available; if collab is disabled, say so and proceed sequentially
+- `Subagent` / `Agent` tool mentions → Map to `spawn_agent` (collab) or sequential fallback when collab is disabled
- `Skill` tool → `~/.codex/superpowers/.codex/superpowers-codex use-skill`
- File operations → Native Codex tools