Codex: clarify subagent tool mapping in bootstrap + README

[deinspanjer]

Summary

Minimal Codex-only improvement to the tool-mapping docs so Codex users understand how subagent references should be handled when collab is enabled or disabled.

Changes

• Update .codex/superpowers-bootstrap.md to map Task/subagent tool references to Codex collab (spawn_agent + wait), with a sequential fallback if collab is disabled.
• Update docs/README.codex.md to match the same guidance.

Why

Codex has an experimental "Multi-agents"/"collab" feature. When enabled, Codex can use spawn_agent. When disabled (the default), it should fall back to sequential execution. This PR makes the mapping explicit and keeps behavior
consistent across bootstrap and documentation.

Impact

• Codex users only.
• No behavioral change for Claude users.
• No changes to skills or runtime code.

Testing

Tested in Codex with collab enabled and disabled. Behavior improved (more consistent spawn_agent usage), but reliable multi-agent behavior still depends on explicit guidance in dispatching-parallel-agents and subagent- driven-development, which currently requires personal overrides to be fully effective.

[coderabbitai]

📝 Walkthrough

Walkthrough

Documentation files updated to modify tool mappings guidance. "Task tool with subagents" mapping changed from unsupported stance to using Codex collab with spawn_agent and wait capability, with sequential processing as fallback when collab is disabled. Similar guidance added for subagent mentions.

Changes

Cohort / File(s)	Summary
Documentation Tool Mappings .codex/superpowers-bootstrap.md, docs/README.codex.md	Updated guidance for handling subagent/agent tool scenarios. Replaced no-op instructions with Codex collab spawn_agent and wait approach; added sequential fallback when collab is disabled. Minor formatting and newline adjustments.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Hop along, brave spawn_agent friend,
No longer shall subagents meet their end,
With collab's embrace and fallback's might,
The tools now guide us through the night! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and accurately summarizes the main change: updating Codex documentation to clarify how subagent tools map to spawn_agent with collab, mirroring the guidance in both bootstrap and README files.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[obra]

Thank you1