@ai-dev-methodologies/rlp-desk 0.0.1 → 0.1.0

package/src/scripts/init_ralph_desk.zsh

@@ -30,26 +30,44 @@ if [[ ! -f "$F" ]]; then
   cat > "$F" <<EOF
 Execute the plan for $SLUG.
 
-Required reads every iteration:
-- PRD: $DESK/plans/prd-$SLUG.md
-- Test Spec: $DESK/plans/test-spec-$SLUG.md
-- Campaign Memory: $DESK/memos/$SLUG-memory.md
-- Latest Context: $DESK/context/$SLUG-latest.md
-
-Iteration rules:
+## Before you start
+Read these files in order:
+1. Campaign Memory: $DESK/memos/$SLUG-memory.md → Next Iteration Contract is your mission
+2. PRD: $DESK/plans/prd-$SLUG.md → acceptance criteria
+3. Test Spec: $DESK/plans/test-spec-$SLUG.md → verification methods
+4. Latest Context: $DESK/context/$SLUG-latest.md → current state
+
+## SCOPE LOCK (hard constraint — violation causes verification failure)
+- You MUST only implement the work described in the "Next Iteration Contract" from campaign memory.
+- If the contract says "implement US-001 only", do ONLY that. Do NOT touch other stories.
+- If the contract says "implement all remaining stories", you may do all of them.
+- Do NOT go beyond the contracted scope, even if you can see more work in the PRD.
+- No file creation or modification outside the project root.
+- Do not modify this prompt file or any PRD/test-spec files.
+
+## Iteration rules
 - Use fresh context only; do NOT depend on prior chat history.
-- Execute exactly ONE bounded next action.
-- If campaign memory has an unresolved Next iteration contract, do that first.
+- Execute exactly the work specified in the Next Iteration Contract.
 - Refresh context file with the current frontier.
 - Rewrite campaign memory in full.
 - Write evidence artifacts.
+- **Commit all changes when the iteration is complete** (include iteration number and story ID in commit message).
+
+MANDATORY: When done with this iteration, write the following signal file:
+- Path: $DESK/memos/$SLUG-iter-signal.json
+- Format: {"iteration": N, "status": "continue|verify|blocked", "summary": "what was done", "timestamp": "ISO"}
+- Status values:
+  - "continue" = current action done but more work remains
+  - "verify" = all work complete + done-claim written
+  - "blocked" = autonomous blocker
 
-Stop behavior:
+## Stop behavior
 - Objective achieved → write done-claim JSON to $DESK/memos/$SLUG-done-claim.json, exit
 - Autonomous blocker → write to $DESK/memos/$SLUG-blocked.md, exit
 - Otherwise → set stop=continue, define next iteration contract in memory, exit
 
-Objective: $OBJECTIVE
+## Objective
+$OBJECTIVE
 EOF
   echo "  + $F"
 else echo "  · $F"; fi
@@ -63,25 +81,27 @@ Independent verifier for Ralph Desk: $SLUG
 Required reads:
 - PRD: $DESK/plans/prd-$SLUG.md
 - Test Spec: $DESK/plans/test-spec-$SLUG.md
-- Campaign Memory: $DESK/memos/$SLUG-memory.md
+- Campaign Memory: $DESK/memos/$SLUG-memory.md (orientation only — not source of truth)
 - Latest Context: $DESK/context/$SLUG-latest.md
 - Done Claim: $DESK/memos/$SLUG-done-claim.json
 
 Process:
 1. Read PRD acceptance criteria
 2. Read done claim
-3. Run fresh verification: build, test, lint, typecheck
-4. Check each criterion against fresh evidence
-5. Write verdict JSON to: $DESK/memos/$SLUG-verify-verdict.json
+3. Identify scope: run \`git diff --name-only\` to find changed files, then read those files + related imports only
+4. Run fresh verification: build, test, lint, typecheck (per test-spec tools)
+5. Check each criterion against fresh evidence
+6. Run smoke test if defined in PRD
+7. Write verdict JSON to: $DESK/memos/$SLUG-verify-verdict.json
 
 Verdict JSON:
 {
-  "verdict": "pass|fail|blocked",
+  "verdict": "pass|fail|request_info",
   "verified_at_utc": "ISO timestamp",
   "summary": "...",
   "criteria_results": [{"criterion":"...","met":true/false,"evidence":"..."}],
   "missing_evidence": [],
-  "issues": [],
+  "issues": [{"id":"...","severity":"critical|major|minor","description":"...","fix_hint":"(suggestion, non-authoritative)"}],
   "recommended_state_transition": "complete|continue|blocked",
   "next_iteration_contract": "...",
   "evidence_paths": []
@@ -89,7 +109,9 @@ Verdict JSON:
 
 Rules:
 - Do NOT trust the worker's claim. Verify with fresh evidence.
-- If uncertain, verdict = fail.
+- If uncertain, verdict = request_info (describe your specific question in summary so Leader can decide).
+- Campaign Memory is for orientation only — do NOT use it as source of truth for AC verification.
+- Deterministic checks (type hints, linting, security) delegate to test-spec tools; focus on AC verification + semantic review + smoke test.
 - Do NOT modify code or write sentinel files.
 EOF
   echo "  + $F"
@@ -130,9 +152,16 @@ $OBJECTIVE
 ## Current State
 Iteration 0 - not started
 
+## Completed Stories
+
 ## Next Iteration Contract
 Start from the beginning: read PRD and plan the first bounded action.
 
+**Criteria**:
+- (to be defined by first worker after reading PRD)
+
+## Key Decisions
+
 ## Patterns Discovered
 ## Learnings
 ## Evidence Chain
@@ -153,6 +182,8 @@ $OBJECTIVE
 
 ### US-001: [Title]
 - **Priority**: P0
+- **Size**: S|M|L
+- **Depends on**: []
 - **Acceptance Criteria**:
   - [ ] [Specific, testable criterion]
 - **Status**: not started
@@ -202,12 +233,7 @@ if [[ -f "$GITIGNORE" ]]; then
     echo "" >> "$GITIGNORE"
     cat >> "$GITIGNORE" <<'GIEOF'
 # RLP Desk runtime artifacts
-.claude/ralph-desk/logs/
-.claude/ralph-desk/memos/*-done-claim.json
-.claude/ralph-desk/memos/*-verify-verdict.json
-.claude/ralph-desk/memos/*-complete.md
-.claude/ralph-desk/memos/*-blocked.md
-.claude/ralph-desk/memos/*-iter-signal.json
+.claude/ralph-desk/
 GIEOF
     echo "  + .gitignore (rlp-desk rules appended)"
   else
@@ -216,12 +242,7 @@ GIEOF
 else
   cat > "$GITIGNORE" <<'GIEOF'
 # RLP Desk runtime artifacts
-.claude/ralph-desk/logs/
-.claude/ralph-desk/memos/*-done-claim.json
-.claude/ralph-desk/memos/*-verify-verdict.json
-.claude/ralph-desk/memos/*-complete.md
-.claude/ralph-desk/memos/*-blocked.md
-.claude/ralph-desk/memos/*-iter-signal.json
+.claude/ralph-desk/
 GIEOF
   echo "  + .gitignore (created with rlp-desk rules)"
 fi