npx claudepluginhub vavasilva/ralph-plannerCreate structured execution plans in Ralph Wiggum format with auto-generated loop commands. Companion plugin for ralph-wiggum.
vavasilvaPlanning-first workflows for Ralph Wiggum loops
Turn a vague task into a clear execution plan — then run it in a loop.
Ralph Wiggum is a powerful loop execution plugin that iterates until a task is complete.
For complex tasks, having a structured plan before starting the loop helps:
Ralph Planner generates structured plans designed to integrate with ralph-wiggum loops.
/ralph-planner:plan-loop "Add user authentication with JWT"
That's it. You get a structured plan + a ready-to-run loop command.
The #1 reason loops run forever: no verifiable exit criteria.
Ralph Planner generates commands with specific DONE conditions:
# Bad (runs forever - no completion promise)
/ralph-wiggum:ralph-loop "Implement auth" --max-iterations 30
# Good (knows when to stop)
/ralph-wiggum:ralph-loop "Implement auth. DONE when: POST /login returns 200 with valid JWT, all tests pass, invalid credentials return 401. Output <promise>COMPLETE</promise> when done." --completion-promise "COMPLETE" --max-iterations 30
Every template includes verifiable promises like:
"All tests pass" (not "tests look good")"Endpoint returns 200" (not "endpoint works")"Bug no longer reproducible" (not "bug seems fixed")/plugin marketplace add vavasilva/ralph-planner
/plugin install ralph-planner@ralph-planner
claude plugin marketplace add vavasilva/ralph-planner
claude plugin install ralph-planner@ralph-planner
Requires ralph-wiggum:
/plugin install ralph-wiggum@claude-plugins-official
/ralph-planner:feature "Implement JWT authentication for the API"
## Phase 1: Discovery
- [ ] Analyze authentication requirements
- [ ] Identify affected endpoints
- [ ] Research JWT best practices
## Phase 2: Implementation
- [ ] Create JWT generation on login
- [ ] Add validation middleware
- [ ] Secure protected routes
## Phase 3: Testing
- [ ] Write unit tests for auth logic
- [ ] Write integration tests for endpoints
## Phase 4: Documentation
- [ ] Update API documentation
Estimated iterations: 30
/ralph-wiggum:ralph-loop "Implement JWT auth. DONE when: POST /login returns JWT, protected routes reject invalid tokens, all tests pass. Output <promise>COMPLETE</promise> when done." --completion-promise "COMPLETE" --max-iterations 30
Plan → Execute → Converge
| Command | Description |
|---|---|
/ralph-planner:plan-loop "<task>" | Generic plan for any task |
/ralph-planner:feature "<desc>" | New feature implementation |
/ralph-planner:bugfix "<desc>" | Bug fix with regression test |
/ralph-planner:refactor "<desc>" | Code refactoring |
/ralph-planner:migration "<desc>" | Data/code migration |
/ralph-planner:performance "<desc>" | Performance optimization |
/ralph-planner:from-file "<path>" | Create plan from existing .md file |
/ralph-planner:from-issue "#123" | Create plan from GitHub issue |
/ralph-planner:help | Show help documentation |
Each template has pre-defined phases and verifiable promises:
/ralph-planner:feature "Add user authentication with JWT"
| Phases | Discovery → Implementation → Testing → Documentation |
|---|---|
| DONE when | All new tests pass, Feature works as specified, No regressions |
/ralph-planner:bugfix "Users can't login after password reset"
| Phases | Reproduction → Root Cause → Fix → Verification |
|---|---|
| DONE when | Bug no longer reproducible, Regression test added, No new issues |
/ralph-planner:refactor "Extract payment logic into separate service"
| Phases | Analysis → Preparation → Refactor → Validation |
|---|---|
| DONE when | All existing tests pass, No behavior changes, Goals met |
/ralph-planner:migration "Move user data from MySQL to PostgreSQL"
| Phases | Assessment → Preparation → Migration → Verification |
|---|---|
| DONE when | All data migrated, Application functional, Rollback tested |
/ralph-planner:performance "Reduce API response time for /users endpoint"