masup9 Collaborative Planning Skill
Create and refine implementation plans through collaborative iteration between Claude and Codex. Plans only — no implementation.
Overview
Collaborative Planning produces a polished implementation plan by:
- Claude collects codebase context and drafts a plan based on the user's idea
- Codex reviews the plan and provides structured feedback
- Claude refines the plan based on feedback
- Iterate until plan quality is sufficient
Key constraint: This skill NEVER starts implementation. The deliverable is always a plan document.
Comparison with Other Skills
| Aspect | collab-planning | codex-collab | devils-advocate |
|---|---|---|---|
| Purpose | Create/refine plans only | Plan + implement + review | Stress-test a design |
| Implementation | Never | Yes (Claude or Codex) | No |
| Deliverable | Plan document (fixed template) | Implemented code | Verdict (APPROVE/CONDITIONAL/REJECT) |
| Claude's role | Context collection + draft | Implementation or review | Blue Team advocate |
| Codex's role | Plan review + improvement | Planning or implementation | Red Team critic |
| Use case | Pre-implementation planning | End-to-end task execution | Design validation |
Prerequisites
- The user has an idea, task, or feature to plan
- Relevant codebase context is available
- For Codex collaboration: Codex CLI available (
codex exec) or MCP configured
Workflow Phases
Phase 1: Context Collection
Claude gathers information:
- Read relevant files and architecture
- Identify affected components
- Understand constraints and dependencies
- Clarify scope with user if needed
Phase 2: Draft Plan
Claude creates an initial plan using the fixed template:
- Purpose, scope exclusions, work breakdown
- Implementation steps, risks, verification, completion criteria
Phase 3: Codex Review
Codex reviews the plan and provides:
- Quality assessment:
good/needs-improvement/major-revision - Specific feedback on each section
- Missing considerations or risks
- Summary snapshot (decisions, open items, rejected ideas)
Phase 4: Iteration
Based on quality assessment:
good→ Finalize and present to userneeds-improvement→ Claude refines, re-submit to Codexmajor-revision→ Ask user for direction, then re-draft or conclude
Phase 5: Final Output
Present the polished plan in the fixed template format.
Settings (.claude/codex-collab.local.md)
collab_planning:
max_iterations: 3 # Review improvement cycle limit
user_confirm: on_important # never | always | on_important
Existing settings (model, sandbox, language) are also respected.
Invoking the Skill
Use the /collab-planning command:
# Basic usage
/collab-planning Add pagination to the user list API
# With options
/collab-planning --max-iterations 5 Refactor authentication module
# Japanese
/collab-planning ユーザーリストAPIにページネーションを追加する計画を立てたい
References
Detailed templates in references/:
plan-draft-guide.md- Fixed template for plan documentsplan-review-prompt.md- Template for Codex review requests