---
name: Ralph Specum Refactor
slug: ralph-specum-refactor
category: AI Engineering
description: Ralph Specum Refactor delegates spec updates to a refactor-specialist sub-agent after implementation learnings. Use it to revise requirements, design, tasks, and progress notes for an active spec.
github: "https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-refactor"
language: Shell
stars: 527
forks: 47
install: "npx degit https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-refactor ~/.claude/skills/ralph-specum-refactor"
installs_to: ~/.claude/skills/ralph-specum-refactor
source_path: plugins/ralph-specum-codex/skills/ralph-specum-refactor/SKILL.md
collection_size: 19
category_size: 2451
collection_url: "https://dirskills.com/collections/tzachbon/smart-ralph"
added: 2026-08-26T05:12:05.765Z
last_synced: 2026-08-26T05:12:05.765Z
canonical_url: "https://dirskills.com/skills/ralph-specum-refactor"
---

# Ralph Specum Refactor

Ralph Specum Refactor delegates spec updates to a refactor-specialist sub-agent after implementation learnings. Use it to revise requirements, design, tasks, and progress notes for an active spec.

**Install:**

```bash
npx degit https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum-codex/skills/ralph-specum-refactor ~/.claude/skills/ralph-specum-refactor
```

## README

# Ralph Specum Refactor

You are a **coordinator, not a refactor specialist** -- delegate spec revision to a `refactor-specialist` sub-agent.

## Contract

- Resolve the active spec by explicit path, exact name, or `.current-spec`
- Review files in order: `requirements.md`, `design.md`, `tasks.md`
- Cascade downstream updates when upstream content changes

## Action

1. Resolve the target spec.
2. Read `.progress.md` and existing spec files.
3. **Delegate** spec revision to a `refactor-specialist` sub-agent. Pass `.progress.md`, existing spec files, and implementation learnings. The sub-agent identifies what changed, what stayed accurate, and what is obsolete. Do NOT revise spec files yourself.
4. The sub-agent preserves newer Ralph concepts already expressed in the spec, including approval checkpoints, granularity choices, `[P]` tasks, `[VERIFY]` tasks, VE tasks, and epic constraints when relevant.
5. The sub-agent updates files in order:
   - `requirements.md`
   - `design.md`
   - `tasks.md`
6. If requirements changed, revisit design and tasks.
7. If design changed, revisit tasks.
8. Record the rationale and cascade decisions in `.progress.md`.

## Response Handoff

- After revising spec files, name the files that changed and summarize the updates briefly.
- End with exactly one explicit choice prompt:
  - `approve current artifact`
  - `request changes`
  - `continue to implementation`
- Treat `continue to implementation` as approval of the updated spec files.