Ralph Specum Implement

This is the execution engine for Ralph Specum's task runner. You call it explicitly when you want to run approved implementation tasks from a spec. It coordinates but doesn't execute directly. Instead it spins up spec-executor sub-agents for each task, handles batching when tasks are marked parallel and don't conflict, syncs progress to disk, and manages state between runs. The resume logic is solid: it reads checkboxes from tasks.md as source of truth and repairs state to match. One thing to know is it's strict about the contract. If there's no tasks.md or the spec isn't resolved, it stops. This is middleware, not a standalone tool.

GitHub stars: 340
last updated: May 19, 2026

View on GitHub

Install

$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-implement --agent claude-code

Installs into .claude/skills of the current project.

Files

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
Reconcile prototype records before dispatch and block only dependent work
Remove .ralph-state.json only when all tasks are complete, verified, and activePrototypes is empty