v2.0.0 - Ralph Wiggum Integration

Breaking Changes

Ralph Wiggum plugin now required for task execution.

Starting with v2.0.0, Smart Ralph delegates the execution loop to the official Ralph Wiggum plugin instead of using a custom stop-handler.

Before upgrading

Install the Ralph Wiggum dependency:

/plugin install ralph-wiggum@claude-plugins-official

Then restart Claude Code.

Migration Guide

See MIGRATION.md for detailed upgrade instructions.

What Changed

Before (v1.x)	After (v2.0.0)
Built-in stop-handler controlled loop	Ralph Wiggum plugin controls loop
/implement managed iterations directly	/implement invokes /ralph-loop
/cancel deleted state files only	/cancel calls /cancel-ralph + deletes state
~300 lines of bash for loop control	Thin wrapper around Ralph Wiggum

Highlights

• Deleted custom stop-handler.sh (274 lines)
• implement.md rewritten as thin wrapper invoking /ralph-loop
• Added stop-watcher.sh for logging/status (read-only, no loop control)
• cancel.md now calls /cancel-ralph for dual cleanup
• All existing spec files remain compatible (no changes needed)

Why This Change

• Less code to maintain
• Official plugin gets updates and bug fixes from Anthropic
• Better reliability for the execution loop
• Cleaner separation of concerns

Full Changelog

v1.7.0...v2.0.0