Ralph specum refactor

Skill tzachbon/smart-ralph/plugins/ralph-specum-codex/skills/ralph-specum-refactor

Spec-driven development with smart compaction. Claude Code plugin combining Ralph Wiggum loop with structured specification workflow.

Install

npx -y skills add tzachbon/smart-ralph --skill ralph-specum-refactor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

What its author says it does

Copied from the file, not written here

This skill should be used only when the user explicitly asks to use `$ralph-specum-refactor`, or explicitly asks Ralph Specum in Codex to revise spec artifacts after implementation learnings.

SKILL.md

1.7 KB, as published. Nobody here has run it

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

Resolve the target spec.
Read .progress.md and existing spec files.
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.
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.
The sub-agent updates files in order:
- requirements.md
- design.md
- tasks.md
If requirements changed, revisit design and tasks.
If design changed, revisit tasks.
Record the rationale and cascade decisions in .progress.md.

Response Handoff