Final commit

scripts/ralph/CLAUDE.md

@@ -2,6 +2,10 @@
 
 You are an autonomous coding agent working on a software project.
 
+## CRITICAL: One Story Per Iteration
+
+You MUST complete exactly ONE user story and then STOP. Do NOT start a second story. After committing and updating progress, your job is done — output your summary and stop.
+
 ## Your Task
 
 1. Read the PRD at `prd.json` (in the same directory as this file)
@@ -14,6 +18,7 @@ You are an autonomous coding agent working on a software project.
 8. If checks pass, commit ALL changes with message: `feat: [Story ID] - [Story Title]`
 9. Update the PRD to set `passes: true` for the completed story
 10. Append your progress to `progress.txt`
+11. **STOP.** Output a short summary and end your response. Do NOT pick up the next story.
 
 ## Progress Report Format
 
@@ -89,16 +94,7 @@ If no browser tools are available, note in your progress report that manual brow
 
 ## Stop Condition
 
-After completing a user story, check if ALL stories have `passes: true`.
+After completing ONE user story, check if ALL stories now have `passes: true`.
 
-If ALL stories are complete and passing, reply with:
-<promise>COMPLETE</promise>
-
-If there are still stories with `passes: false`, end your response normally (another iteration will pick up the next story).
-
-## Important
-
-- Work on ONE story per iteration
-- Commit frequently
-- Keep CI green
-- Read the Codebase Patterns section in progress.txt before starting
+- If ALL stories are complete: reply with `<promise>COMPLETE</promise>` and stop.
+- If stories remain: output a short summary of what you did and **STOP immediately**. Do NOT continue to the next story. The outer loop will spawn a fresh iteration for it.

scripts/ralph/ralph.sh

@@ -146,9 +146,9 @@ for i in $(seq 1 $MAX_ITERATIONS); do
   ELAPSED_SEC=$((ELAPSED % 60))
   printf "  \033[0;90mFinished: $(date +%H:%M:%S) (elapsed: ${ELAPSED_MIN}m${ELAPSED_SEC}s)\033[0m\n"
 
-  # Check for completion signal in raw log and text log
-  if grep -q "<promise>COMPLETE</promise>" "$RAW_LOG" 2>/dev/null || \
-     grep -q "<promise>COMPLETE</promise>" "$TEXT_LOG" 2>/dev/null; then
+  # Check for completion signal in text log ONLY (not raw log — raw log contains
+  # the CLAUDE.md prompt which has the literal <promise>COMPLETE</promise> instruction)
+  if grep -q "<promise>COMPLETE</promise>" "$TEXT_LOG" 2>/dev/null; then
     echo ""
     printf "\033[0;32mRalph completed all tasks!\033[0m\n"
     echo "Completed at iteration $i of $MAX_ITERATIONS"