# Ralph

> Drive an approved plan to completion as a single persistent owner. Third step of the canonical coding workflow.

- Skill: `chainlesschain/ralph` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add chainlesschain/ralph`
- Raw SKILL.md: https://api.skillmd.com/api/skills/chainlesschain/ralph/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: chainlesschain (https://skillmd.com/u/chainlesschain)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/chainlesschain/ralph

---


# Ralph Skill

Persistent completion loop — one owner keeps pushing on an approved
plan until every step is done and verified. Use this when the work
does not need coordinated parallelism and you want a single focused
execution context.

## Usage

```
$ralph "carry the approved auth plan to completion"
```

## Inputs (params)

- `note` (string, optional) — progress note to append to progress.log
- `sessionId` (string, optional) — workflow session

## Output

Appends to `progress.log` and returns LLM guidance: read the plan,
pick the next unfinished step, execute it with the coding agent's
normal tools (file_write, run_shell, tests, etc.), append progress,
repeat until the plan is complete.

## Gates

- Refuses if `plan.md` is missing.
- Refuses if `plan.md` frontmatter `approved: false`.