tzachbon avatar

Ralph Specum Refactor

This is a specialized coordinator for updating Ralph Specum spec artifacts after you've learned something during implementation. You explicitly invoke it by name or ask Ralph to revise specs based on what actually happened while building. It doesn't do the refactoring itself. Instead it spins up a sub-agent that reads your progress log and existing requirements, design, and tasks files, then cascades changes downstream so everything stays consistent. The sub-agent preserves newer Ralph conventions like approval checkpoints and verification tasks. Honest take: this is workflow glue for a specific spec methodology, not a general refactoring tool. If you're not already using Ralph Specum's structured approach with those particular artifact files, this won't help you.

GitHub stars
340
last updated
May 19, 2026

Install

$ npx -y skills add tzachbon/smart-ralph --skill ralph-specum-refactor --agent claude-code

Installs into .claude/skills of the current project.

Files

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
  • Reconcile activePrototypes and preserve unrelated refactor work

Action

Sponsors

Details

Repository
github.com/tzachbon/smart-ralph
Category
Code Review & Quality
License
MIT
First seen
Jun 11, 2026

More from tzachbon/smart-ralph

All 28
1VilnaCRM-Org avatarquality-standardsVilnaCRM-Org/user-serviceOverview of protected quality thresholds and quick reference for all quality tools. Use when you need to understand quality metrics, run comprehensive quality c0skills.sh installs
2emilkowalski avatarreview-animationsemilkowalski/skillsReviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.295.2Kskills.sh installs
3obra avatarrequesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements276.5Kskills.sh installs
4obra avatarreceiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical 235.1Kskills.sh installs
5coreyhaines31 avatarsite-architecturecoreyhaines31/marketingskillsWhen the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions131.3Kskills.sh installs
6juliusbrussee avatarsafe-refactorjuliusbrussee/cavemanRestructure code while preserving behavior. Use for extraction, consolidation, ownership moves, or cleanup where verification must bracket structural edits.121.2Kskills.sh installs