---

name: ralph-graceful-exit description: | Detects Ralph Loop completion beyond tags. Use when checking if a task is complete, verifying completion status, or detecting graceful exit conditions. Implements 4-signal detection: test loops, done signals, completion indicators, and fix plan verification. allowed-tools: Read, Grep, Bash model: haiku context: fork agent: ralph-domain-agent user-invocable: false hooks: PostToolUse: - matcher: "Bash" hooks: - type: command command: "$HOME/.claude/hooks/ralph-activity-log.sh"

Ralph Graceful Exit

Purpose

Detect when a Ralph Loop iteration has truly completed its task, beyond just the <promise>DONE</promise> tag. This skill implements 4-signal detection to verify genuine completion.

Integrations

4-Signal Detection

Detection Logic

When evaluating completion:

1. Check activity log for test-only iterations

   Copygrep -c "test\|pytest\|jest\|npm test" ~/.ralph-state/activity.log
   

2. Scan recent output for done_signals patterns

   • "done", "complete", "finished", "all tests pass"
   • "implementation complete", "task finished"

3. Look for completion_indicators in conversation

   • Strong completion language
   • Summary of what was accomplished
   • No pending TODO items mentioned

4. Verify fix_plan if exists

   • Check if @fix_plan.md exists
   • Verify all checkbox items are checked [x]

Exit Recommendation

If ≥2 signals detected, recommend outputting:

Copy<promise>DONE</promise>

Signal Weights

Total weight ≥1.5 → Strong recommendation to exit Total weight ≥1.0 → Suggest checking completion status