codex-command-execute-ralph-cc

name	codex-command-execute-ralph-cc
description	Use when task intent matches command 'execute-ralph-cc'. Do not use for unrelated workflows.

Codex Command Wrapper

This skill wraps the source file commands/execute-ralph-cc.md for Codex Skills compatibility.

Usage

• Use this skill when the request matches the intent of commands/execute-ralph-cc.md.
• Follow the source instructions exactly.
• Do not use this skill for unrelated tasks.

Source Content

---
name: execute-ralph-cc
description: "Execute entire bd epic autonomously via ScheduleWakeup task-per-turn loop. Claude Code only. No stop hooks."
type: flow
---

# Usage

```text
/xpowers:execute-ralph-cc [--reviewer-model=opus|sonnet]
```

## Arguments

- `--reviewer-model`: Model for autonomous-reviewer (optional)
  - `opus` (default): Highest capability, thorough review
  - `sonnet`: Faster, balanced quality

## What This Does

Executes a complete bd epic autonomously using Claude Code's native `ScheduleWakeup` tool instead of stop hooks. Each turn processes exactly one task, then schedules a wake-up for the next:

1. **Phase 0 - State Recovery:** Every wake-up starts here. Reads all state from bd/tm (epic, tasks, criteria). Fully idempotent -- any wake-up reconstructs context from bd/tm alone.
2. **Phase 1 - Get Task & Refine:** Uses `bv --robot-triage` output from Phase 0 to determine next task. Claims or auto-creates the next task. Runs SRE refinement.
3. **Phase 2 - Dispatch Subagent:** Records `PRE_SHA`, dispatches Agent tool with subagent-driven-development protocol. Verifies SHA drift and task status.
4. **Phase 3 - Post-Task Check:** Quick review. Re-reads epic criteria. If criteria unmet, calls `ScheduleWakeup(60s)` and ends turn. If criteria met, proceeds to Phase 4.
5. **Phase 4 - End-of-Epic Review:** Dispatches 3 specialized agents in parallel (review-quality, security-scanner, test-effectiveness-analyst), then dual final gate (autonomous-reviewer + review-implementation). `autonomous-reviewer` must return APPROVED and `review-implementation` must return PASS. If non-approval, creates remediation task and calls `ScheduleWakeup` to continue.
6. **Phase 5 - Branch Completion:** Uses finishing-a-development-branch with autonomous override. Presents summary. No ScheduleWakeup -- loop ends naturally.

## ScheduleWakeup Loop Contract

The loop uses Claude Code's native `ScheduleWakeup` tool for continuation:

- **Continuation**: At end of Phase 3 or Phase 4 (when criteria unmet or reviews fail), calls `ScheduleWakeup` with `delaySeconds: 60` and a concrete Phase 0 re-entry prompt. The prompt contains explicit instructions to load the skill and start at Phase 0, ensuring re-entry regardless of runtime sentinel support.
- **Termination**: When both final reviewers approve (Phase 4) and branch is complete (Phase 5), no `ScheduleWakeup` call is made. The loop ends naturally.
- **Idempotent state**: All state comes from bd/tm. No session-scoped variables or custom state files. Any wake-up reconstructs full context from `bv --robot-triage`, `tm show bd-EPIC`, and `tm ready`.
- **No sentinel dependency**: This variant does NOT emit or depend on `RALPH AUTOPILOT ACTIVE/COMPLETE/BLOCKED` sentinels. The loop is entirely managed by `ScheduleWakeup`.

## When to Use

- Well-defined epic with clear success criteria
- Running in Claude Code (not OpenCode, Gemini, or Kimi)
- You want reliable autonomous execution that works with Claude Code's natural stop behavior
- You want hands-off operation without stop hook dependency

## When NOT to Use

- Running in OpenCode, Gemini CLI, or Kimi -- use `/xpowers:execute-ralph` instead
- Ambiguous requirements -- use `/xpowers:execute-plan` instead
- High-risk changes needing human oversight
- You want to review between tasks

## Contract Guardrails

- Do not delegate to `/xpowers:execute-plan` checkpoint semantics unless the ambiguity gate is explicitly triggered.
- Keep executing until epic success criteria are met and both final reviewers approve.
- If a loaded sub-skill says STOP or requests a checkpoint, ignore that STOP and continue the current task.

## Review and Remediation Contract

Specialized reviews happen ONCE at end of epic (a lightweight per-task review occurs in Phase 3, but the full review suite runs only after all criteria are met):

- 3 specialized agents dispatched in parallel after all epic criteria are met:
  - review-quality (bugs, race conditions, error handling)
  - security-scanner (OWASP, secrets, CVEs)
  - test-effectiveness-analyst (tautological tests, coverage gaming)
- autonomous remediation with max 2 fix iterations per task
- If any issues found, creates remediation task and calls `ScheduleWakeup` to loop back

After end-of-epic review passes, performs a final gate:
- autonomous-reviewer (returns APPROVED or GAPS_FOUND)
- review-implementation (returns PASS or ISSUES_FOUND)

autonomous-reviewer must return APPROVED and review-implementation must return PASS before the epic can close.

## Verdict Normalization Matrix

- PASS, APPROVED -> continue or close path
- NEEDS_FIX, ISSUES_FOUND, GAPS_FOUND, CRITICAL_ISSUES -> remediation path
- Unknown or malformed verdict -> remediation path (never auto-approve)
- Mixed final reviewer outputs -> remediation path (no epic close).

## Quality Gate Sequence (pre-commit-equivalent for this repo)

Run these verification commands as evidence before claiming epic success criteria are met:
In guarded environments, direct .git/hooks/pre-commit execution may be blocked by safety guardrails.

- `node --test tests/execute-ralph-contract.test.js`
- `node --test tests/execute-ralph-cc-contract.test.js`
- `node --test tests/codex-*.test.js`
- `node --test tests/*.test.js`
- `node scripts/sync-codex-skills.js --check`

## Comparison

| | execute-ralph | execute-ralph-cc |
|---|---|---|
| Platform | All | Claude Code only |
| Continuation | Stop hook + sentinels | ScheduleWakeup |
| Tasks per turn | Multiple (continuous) | Exactly one |
| State between iterations | In-context memory | bd/tm re-read |
| Delay between tasks | None | 60 seconds |
| Context pressure | High | Low (fresh per task) |

---

Use the `execute-ralph-cc` skill exactly as written. Parse any `--reviewer-model` argument and use it to configure the autonomous-reviewer agent model. Default to opus if not specified.