Agent skill
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 this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/ralph-specum-refactor
Metadata
Additional technical details for this skill
- action
- refactor
- surface
- helper
SKILL.md
Ralph Specum Refactor
Use this to revise spec artifacts after implementation learnings.
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.mdand existing spec files. - Identify what implementation changed, what stayed accurate, and what is now obsolete.
- Preserve newer Ralph concepts already expressed in the spec, including approval checkpoints, granularity choices,
[P]tasks,[VERIFY]tasks, VE tasks, and epic constraints when relevant. - Update 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
continue to implementationas approval of the updated spec files.
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?