by tzachbon
Spec-driven development with smart compaction. Claude Code plugin combining Ralph Wiggum loop with structured specification workflow.
# Add to your Claude Code skills
git clone https://github.com/tzachbon/smart-ralphSpec-driven development for Claude Code. Task-by-task execution with fresh context per task.
Ralph Loop + Spec-Driven Development = <3
Quick Start | Commands | How It Works | Troubleshooting
</div>Smart Ralph is a Claude Code plugin that turns your vague feature ideas into structured specs, then executes them task-by-task. Like having a tiny product team in your terminal.
You: "Add user authentication"
Ralph: *creates research.md, requirements.md, design.md, tasks.md*
Ralph: *executes each task with fresh context*
Ralph: "I'm helping!"
Named after the Ralph agentic loop pattern and everyone's favorite Springfield student. Ralph doesn't overthink. Ralph just does the next task. Be like Ralph.
v2.0.0+ requires the Ralph Loop plugin for task execution:
/plugin install ralph-loop@claude-plugins-official
Note: The plugin is named ralph-loop (implementing the Ralph Wiggum technique). Some documentation may reference - both refer to the same plugin, use .
ralph-wiggumralph-loopRalph Loop provides the execution loop. Smart Ralph provides the spec-driven workflow on top.
# 1. Install Ralph Loop (required dependency)
/plugin install ralph-loop@claude-plugins-official
# 2. Install Smart Ralph
/plugin marketplace add tzachbon/smart-ralph
/plugin install ralph-specum@smart-ralph
# 3. Restart Claude Code
"marketplace not found" error? Add the official marketplace first:
/plugin marketplace add anthropics/claude-code
/plugin install ralph-loop@claude-plugins-official
Install from GitHub directly:
/plugin install https://github.com/tzachbon/smart-ralph
Local development:
git clone https://github.com/tzachbon/smart-ralph.git
claude --plugin-dir ./smart-ralph/plugins/ralph-specum
# The smart way (auto-detects resume or new)
/ralph-specum:start user-auth Add JWT authentication
# Quick mode (skip spec phases, auto-generate everything)
/ralph-specum:start "Add user auth" --quick
# The step-by-step way
/ralph-specum:new user-auth Add JWT authentication
/ralph-specum:requirements
/ralph-specum:design
/ralph-specum:tasks
/ralph-specum:implement
| Command | What it does | |---------|----...