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.
Self-contained execution loop. No external dependencies.
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.
# Install Smart Ralph
/plugin marketplace add tzachbon/smart-ralph
/plugin install ralph-specum@smart-ralph
# Restart Claude Code
<details>
<summary>Troubleshooting & alternative methods</summary>
Install from GitHub directly:
</details>No comments yet. Be the first to share your thoughts!
/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 |
|---------|--------------|
| /ralph-specum:start [name] [goal] | Smart entry: resume existing or create new |
| /ralph-specum:start [goal] --quick | Quick mode: auto-generate all specs and execute |
| /ralph-specum:new <name> [goal] | Create new spec, start research |
| /ralph-specum:research | Run/re-run research phase |
| /ralph-specum:requirements | Generate requirements from research |
| /ralph-specum:design | Generate technical design |
| /ralph-specum:tasks | Break design into executable tasks |
| /ralph-specum:implement | Execute tasks one-by-one |
| /ralph-specum:index | Scan codebase and generate component specs |
| /ralph-specum:status | Show all specs and progress |
| `/ralph-s...