Smart-ralph ralph-specum-refactor
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.
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-refactor" ~/.claude/skills/tzachbon-smart-ralph-ralph-specum-refactor && rm -rf "$T"
manifest:
plugins/ralph-specum-codex/skills/ralph-specum-refactor/SKILL.mdsource content
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.mdtasks.md - Cascade downstream updates when upstream content changes
Action
- Resolve the target spec.
- Read
and existing spec files..progress.md - Delegate spec revision to a
sub-agent. Passrefactor-specialist
, 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..progress.md - The sub-agent preserves newer Ralph concepts already expressed in the spec, including approval checkpoints, granularity choices,
tasks,[P]
tasks, VE tasks, and epic constraints when relevant.[VERIFY] - The sub-agent updates files in order:
requirements.mddesign.mdtasks.md
- If requirements changed, revisit design and tasks.
- If design changed, revisit tasks.
- 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 artifactrequest changescontinue to implementation
- Treat
as approval of the updated spec files.continue to implementation