@graypark/ralph-codex 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graypark/ralph-codex",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "type": "module",
   "description": "Ralph Loop for Codex CLI & Claude Code — iterative dev loops with multi-agent orchestration, interactive interview, and stop hooks",
   "license": "MIT",

package/skills/ralph-interview/SKILL.md

@@ -265,12 +265,13 @@ To cancel at any time: `/ralph-loop:cancel-ralph`
 
 ### Quick-Run Flow
 
-If the user includes phrases like "run immediately", "just do it", "바로 실행", "바로 시작", or "--run" in their initial message:
+If the user includes phrases like "run immediately", "just do it", "run it", "바로 실행", "바로 시작", or "--run" in their initial message:
 
 1. Conduct the interview as normal (skip if enough context is provided).
-2. Generate the command blocks.
-3. **Set up pipeline state file with queue** and **immediately execute Phase 1** without confirmation.
-4. Show the command and queue that was set up so the user can see what's running.
+2. Generate the command blocks. Show them briefly.
+3. For multi-phase: write state file with queue via Bash tool.
+4. Make the Skill tool call: skill="ralph-loop:ralph-loop", args=Phase 1 prompt+flags.
+   Do NOT stop after step 3. You MUST proceed to step 4.
 
 ### Post-Generation Action
 
@@ -297,17 +298,44 @@ After generating all command blocks, ALWAYS end with this prompt:
 - **edit** / **수정** → Tell me what to change
 ```
 
-### Execution Modes
+### Execution — MANDATORY TOOL CALL
 
-**Pipeline mode (default for "y"):**
+When the user confirms with "y", "yes", "step", "run", "바로 실행", etc., you MUST perform an actual Skill tool call. This is NON-NEGOTIABLE.
 
-1. Create the state file with the first phase as active and remaining phases in `queue`
-2. Execute Phase 1 via `/ralph-loop:ralph-loop`
-3. When Phase 1 promise is detected, the stop hook automatically loads Phase 2 from queue
-4. Continues until all phases complete — no user intervention between phases
+WRONG (do NOT do this):
+
+- Printing the /ralph-loop command as text
+- Writing a state file and saying "ready"
+- Telling the user to copy-paste
+- Saying "Phase 1 is set up"
+
+RIGHT (you MUST do this):
+
+- Use the Skill tool to invoke "ralph-loop:ralph-loop" with args
+
+The exact tool call you must make:
+
+```
+Use the Skill tool with:
+  skill: "ralph-loop:ralph-loop"
+  args: "<the full prompt>" --max-iterations <N> --completion-promise "<PROMISE>"
+```
+
+This is the same as if the user had typed `/ralph-loop:ralph-loop "..." --max-iterations N --completion-promise "X"` themselves. You are doing it on their behalf.
+
+**Pipeline mode ("y"):**
+
+1. For multi-phase: first write state file with queue via Bash tool
+2. Then IMMEDIATELY make the Skill tool call for Phase 1
+3. Stop hook handles the rest
 
 **Manual mode ("step"):**
 
-1. Execute Phase 1 via `/ralph-loop:ralph-loop`
-2. When Phase 1 completes, prompt the user to confirm before starting Phase 2
-3. Repeat for each phase
+1. IMMEDIATELY make the Skill tool call for Phase 1
+2. After it completes, ask before making the next Skill tool call
+
+**Single-phase ("y"):**
+
+1. IMMEDIATELY make the Skill tool call
+
+If you do not make the Skill tool call, the loop will not start. Writing a state file alone does nothing.