Smart-ralph ralph-specum-implement

This skill should be used only when the user explicitly asks to use `$ralph-specum-implement`, or explicitly asks Ralph Specum in Codex to run implementation for approved tasks, quick mode, or an explicit continue request.

install

source · Clone the upstream repo

git clone https://github.com/tzachbon/smart-ralph

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/tzachbon/smart-ralph "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/ralph-specum-codex/skills/ralph-specum-implement" ~/.claude/skills/tzachbon-smart-ralph-ralph-specum-implement && rm -rf "$T"

manifest: plugins/ralph-specum-codex/skills/ralph-specum-implement/SKILL.md

Ralph Specum Implement

You are a coordinator, not an executor -- delegate each task to a

spec-executor

sub-agent.

Contract

Resolve the active spec by explicit path, exact name, or
```
.current-spec
```
Require
```
tasks.md
```
Recompute task counts from disk before execution
Merge state fields only
Remove
```
.ralph-state.json
```
only when all tasks are complete and verified

Action

Resolve the active spec. If none exists, stop.
Require
```
tasks.md
```
. Read
```
.progress.md
```
, current state, and current task markers.
Recompute task counters from disk:
```
total
```
,
```
completed
```
, and
```
next_index
```
.

Merge state for execution:

```
phase: "execution"
```
```
awaitingApproval: false
```
```
totalTasks: total
```
```
taskIndex: next_index
```

preserve

taskIteration

maxTaskIterations

globalIteration

maxGlobalIterations

commitSpec

, and

relatedSpecs

Delegate each task to a
```
spec-executor
```
sub-agent. Pass the task description, file targets, success criteria, and context from
```
.progress.md
```
. The sub-agent implements the task and outputs
```
TASK_COMPLETE
```
. Do NOT implement tasks yourself. Execute tasks in order until complete or blocked.
```
[P]
```
tasks may batch only when file sets do not overlap and verification is independent.
```
[VERIFY]
```
tasks stay in the same run and must produce explicit verification evidence.
Marker syntax must be explicitly present in
```
tasks.md
```
. If markers are absent, treat tasks as non-batchable by default.
VE tasks are valid quality tasks when the spec includes autonomous end-to-end verification.
Native task sync metadata should be preserved when present.
After each task or safe batch:

mark the checkbox
update
```
.progress.md
```
merge the state update
use the task
```
Commit
```
line unless commits were explicitly disabled

On failure or interruption, persist the current state and stop with a resumable summary.
On full completion, remove
```
.ralph-state.json
```
and report completion.

Resume Rules

Resume from the persisted task state when execution was already in progress.
If disk state and task checkboxes disagree, prefer
```
tasks.md
```
for completion and repair state to match.
If approval is still pending for tasks, stop and get approval unless quick mode or explicit user direction says to continue.