codex-validate-plan
Validate architecture/plan quality via Codex MCP. Use after writing context.md for complex feature/refactor work.
📖 中文导读:Validate architecture/plan quality via Codex MCP. Use after writing context.md for complex feature/refactor work. 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: codex-validate-plan description: Validate architecture/plan quality via claude-delegator (Plan Reviewer expert). Use after writing context.md for complex feature/refactor work. context: fork
Codex Plan Validation (via claude-delegator)
When to use
complexity:complextaskType:featureorrefactorcontext.mdexists or was updated
Procedure
- Collect the path to context.md (default:
{tasksRoot}/{feature-name}/context.md) and read its content - Build delegation prompt using the 7-section format below
- Try Codex first:
- Call
mcp__codex__codex(include Plan Reviewer instructions in developer-instructions) - If successful, proceed to step 5
- Call
- Fallback to Claude (if Codex unavailable):
- Error conditions: "quota exceeded", "rate limit", "API error", "unavailable"
- Claude directly performs the plan review following the Plan Reviewer guidelines below
- Add note:
"codex-fallback: Claude performed review directly"
- Summarize critical/warning/suggestion items and decide pass/fail
- Per
.claude/docs/guidelines/document-memory-policy.md: Store full review inarchives/review-v{n}.md, keep only short summary incontext.md
Delegation Format
Use the 7-section format:
TASK: Review implementation plan at [context.md path] for completeness and clarity.
EXPECTED OUTCOME: APPROVE/REJECT verdict with specific feedback.
CONTEXT:
- Plan to review: [content of context.md]
- Goals: [what the plan is trying to achieve]
- Constraints: [project constraints]
MUST DO:
- Evaluate all 4 criteria (Clarity, Verifiability, Completeness, Big Picture)
- Simulate actually doing the work to find gaps
- Provide specific improvements if rejecting
MUST NOT DO:
- Rubber-stamp without real analysis
- Provide vague feedback
- Approve plans with critical gaps
OUTPUT FORMAT:
[APPROVE / REJECT]
Justification: [explanation]
Summary: [4-criteria assessment]
[If REJECT: Top 3-5 improvements needed]
Tool Call
mcp__codex__codex({
prompt: "[7-section delegation prompt with full context]",
"developer-instructions": "[contents of plan-reviewer.md]",
sandbox: "read-only", // Advisory mode
cwd: "[current working directory]"
})
Output (patch)
notes:
- "codex-plan: [APPROVE/REJECT], warnings=[count]"