agentic-loop 3.1.5 → 3.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-loop",
-  "version": "3.1.5",
+  "version": "3.2.0",
   "description": "Autonomous AI coding loop - PRD-driven development with Claude Code",
   "author": "Allie Jones <allie@allthrive.ai>",
   "license": "MIT",

package/ralph/loop.sh

@@ -337,25 +337,17 @@ run_loop() {
 
     # 6. Run verification pipeline
     echo ""
-    if run_verification "$story"; then
+    # Capture verification output for failure context
+    local verify_log="$RALPH_DIR/last_verification.log"
+    set -o pipefail
+    if run_verification "$story" 2>&1 | tee "$verify_log"; then
       # Mark story as complete
       update_json "$RALPH_DIR/prd.json" \
         --arg id "$story" '(.stories[] | select(.id==$id) | .passes) = true'
 
       # Clear failure context on success
       rm -f "$RALPH_DIR/last_failure.txt"
-      rm -f "$RALPH_DIR/last_migration_failure.log"
-      rm -f "$RALPH_DIR/last_review_failure.json"
-      rm -f "$RALPH_DIR/last_test_failure.log"
-      rm -f "$RALPH_DIR/last_lint_failure.log"
-      rm -f "$RALPH_DIR/last_typescript_failure.log"
-      rm -f "$RALPH_DIR/last_build_failure.log"
-      rm -f "$RALPH_DIR/last_go_failure.log"
-      rm -f "$RALPH_DIR/last_rust_failure.log"
-      rm -f "$RALPH_DIR/last_playwright_failure.log"
-      rm -f "$RALPH_DIR/last_browser_failure.json"
-      rm -f "$RALPH_DIR/last_precommit_failure.log"
-      rm -f "$RALPH_DIR/last_prd_failure.log"
+      rm -f "$RALPH_DIR/last_verification.log"
 
       # Auto-commit if git is available
       if command -v git &>/dev/null && [[ -d ".git" ]]; then
@@ -601,24 +593,11 @@ _inject_failure_context() {
   echo ""
   echo "## Previous Iteration Failed"
   echo ""
-  echo "**IMPORTANT:** The previous attempt at this story failed verification. Review the errors below and fix them."
+  echo "Fix the errors below. If a PRD test step is broken, you can fix it in .ralph/prd.json."
   echo ""
   echo '```'
   echo "$failure_context"
   echo '```'
-  echo ""
-  echo "### What to do:"
-  echo "1. Read the error messages carefully"
-  echo "2. Identify the root cause - is it your implementation OR a flawed test step?"
-  echo "3. Fix the issue (do not just retry the same approach)"
-  echo "4. Run verification again"
-  echo ""
-  echo "### If the test step itself is broken:"
-  echo "If the error is in the PRD test step (not your implementation), you CAN fix it:"
-  echo "1. Read .ralph/prd.json to find the story index and broken testStep"
-  echo "2. Use jq to update: \`jq '.stories[IDX].testSteps[N] = \"fixed\"' .ralph/prd.json > tmp && mv tmp .ralph/prd.json\`"
-  echo "3. Common test step bugs: missing imports, str() triggering lazy loading, wrong paths"
-  echo "4. ONLY fix the test command - do NOT change acceptance criteria or story scope"
 }
 
 # Helper: Inject signs (learned patterns)

package/ralph/setup.sh

@@ -340,7 +340,7 @@ EOF
   fi
 }
 
-# Configure MCP (Chrome DevTools)
+# Configure MCP (Browser tools for verification)
 setup_mcp() {
   local claude_json="$HOME/.claude.json"
 
@@ -350,17 +350,82 @@ setup_mcp() {
   # Create claude.json if it doesn't exist
   [[ ! -f "$claude_json" ]] && echo '{}' > "$claude_json"
 
-  # Skip if already configured
-  jq -e '.mcpServers["chrome-devtools"]' "$claude_json" > /dev/null 2>&1 && return 0
+  local added_any=false
+
+  # Add Playwright MCP if not configured
+  if ! jq -e '.mcpServers["playwright"]' "$claude_json" > /dev/null 2>&1; then
+    echo "Configuring MCP servers..."
+    local tmp
+    tmp=$(mktemp)
+    jq '.mcpServers["playwright"] = {
+      "command": "npx",
+      "args": ["-y", "@anthropic-ai/mcp-server-playwright"]
+    }' "$claude_json" > "$tmp" && mv "$tmp" "$claude_json"
+    echo "  Added playwright MCP server (browser automation & testing)"
+    added_any=true
+  fi
 
-  echo "Configuring MCP servers..."
-  local tmp
-  tmp=$(mktemp)
-  jq '.mcpServers["chrome-devtools"] = {
-    "command": "npx",
-    "args": ["-y", "@anthropic-ai/mcp-server-chrome-devtools@0.0.5"]
-  }' "$claude_json" > "$tmp" && mv "$tmp" "$claude_json"
-  echo "  Added chrome-devtools MCP server"
+  # Add Chrome DevTools MCP if not configured
+  if ! jq -e '.mcpServers["chrome-devtools"]' "$claude_json" > /dev/null 2>&1; then
+    [[ "$added_any" == "false" ]] && echo "Configuring MCP servers..."
+    local tmp
+    tmp=$(mktemp)
+    jq '.mcpServers["chrome-devtools"] = {
+      "command": "npx",
+      "args": ["-y", "@anthropic-ai/mcp-server-chrome-devtools@0.0.5"]
+    }' "$claude_json" > "$tmp" && mv "$tmp" "$claude_json"
+    echo "  Added chrome-devtools MCP server (debugging & inspection)"
+    added_any=true
+  fi
+
+  # Ask about test credentials
+  if [[ "$added_any" == "true" ]]; then
+    setup_test_credentials
+  fi
+}
+
+# Set up test credentials for browser automation
+setup_test_credentials() {
+  echo ""
+  echo "  Browser automation often needs login credentials for testing."
+  echo ""
+  read -r -p "  Do you have test user credentials to configure? [y/N] " response
+
+  if [[ "$response" =~ ^[Yy]$ ]]; then
+    echo ""
+    echo "  These will be stored in .env (already in .gitignore - never committed)"
+    echo ""
+
+    # Create .env if it doesn't exist
+    if [[ ! -f ".env" ]]; then
+      touch ".env"
+      echo "  Created .env file"
+    fi
+
+    # Get credentials
+    read -r -p "  Test user email: " test_email
+    read -r -s -p "  Test user password: " test_password
+    echo ""
+
+    # Add to .env (append or update)
+    if grep -q "^RALPH_TEST_USER=" .env 2>/dev/null; then
+      # Update existing
+      local tmp
+      tmp=$(mktemp)
+      sed "s/^RALPH_TEST_USER=.*/RALPH_TEST_USER=$test_email/" .env > "$tmp" && mv "$tmp" .env
+      sed "s/^RALPH_TEST_PASSWORD=.*/RALPH_TEST_PASSWORD=$test_password/" .env > "$tmp" && mv "$tmp" .env
+    else
+      # Append new
+      echo "" >> .env
+      echo "# Test credentials for browser automation (auto-added by agentic-loop)" >> .env
+      echo "RALPH_TEST_USER=$test_email" >> .env
+      echo "RALPH_TEST_PASSWORD=$test_password" >> .env
+    fi
+
+    echo "  Saved credentials to .env"
+    echo ""
+    echo "  Note: .env is gitignored - your password will never be committed to git."
+  fi
 }
 
 # Set up pre-commit hooks

package/ralph/verify.sh

@@ -1,35 +1,14 @@
 #!/usr/bin/env bash
 # shellcheck shell=bash
-# verify.sh - Full UAT verification pipeline for ralph
+# verify.sh - Lightweight verification for ralph
 #
-# This file orchestrates the verification pipeline by sourcing modular components:
-#   - verify/review.sh  - Code review logic
-#   - verify/lint.sh    - Auto-fix + lint checks
-#   - verify/tests.sh   - Unit tests + PRD criteria
-#   - verify/browser.sh - Browser validation
-
-# Validate required source files exist before sourcing
-if [[ ! -f "$RALPH_LIB/playwright.sh" ]]; then
-  echo "Error: Missing $RALPH_LIB/playwright.sh" >&2
-  exit 1
-fi
-if [[ ! -f "$RALPH_LIB/api.sh" ]]; then
-  echo "Error: Missing $RALPH_LIB/api.sh" >&2
-  exit 1
-fi
+# Philosophy: Claude verifies its own work using MCP browser tools.
+# Ralph just runs lint, tests, and testSteps from the PRD.
 
 # Source verification modules
-source "$RALPH_LIB/playwright.sh"
-source "$RALPH_LIB/api.sh"
-
-# Determine the directory where this script lives
 VERIFY_DIR="${RALPH_LIB:-$(dirname "${BASH_SOURCE[0]}")}"
-
-# Source modular verification components
-source "$VERIFY_DIR/verify/review.sh"
 source "$VERIFY_DIR/verify/lint.sh"
 source "$VERIFY_DIR/verify/tests.sh"
-source "$VERIFY_DIR/verify/browser.sh"
 
 run_verification() {
   local story="$1"
@@ -38,142 +17,33 @@ run_verification() {
   print_info "=== Verification: $story ==="
   echo ""
 
-  # Clear old failure logs (so smart-skip logic uses fresh state)
-  rm -f "$RALPH_DIR/last_precommit_failure.log" \
-        "$RALPH_DIR/last_test_failure.log" \
-        "$RALPH_DIR/last_review_failure.json" 2>/dev/null
-
-  # Check for fast mode
-  local fast_mode="${RALPH_FAST_MODE:-false}"
-  if [[ "$fast_mode" == "true" ]]; then
-    echo "  (fast mode - skipping code review)"
-  fi
-
-  # Determine story type (single jq call for all story info)
-  local story_json
-  story_json=$(jq --arg id "$story" '.stories[] | select(.id==$id)' "$RALPH_DIR/prd.json" 2>/dev/null)
-
-  local story_type has_test_url has_api_endpoints
-  story_type=$(echo "$story_json" | jq -r '.type // "frontend"')
-  has_test_url=$(echo "$story_json" | jq -r '.testUrl // empty')
-  has_api_endpoints=$(echo "$story_json" | jq -r '.apiEndpoints[0] // empty')
-
-  # Auto-detect type if not specified
-  if [[ -n "$has_api_endpoints" && -z "$has_test_url" ]]; then
-    story_type="backend"
-  fi
-
   local failed=0
-  local lint_failed=0
-  local test_failed=0
 
   # ========================================
-  # STEP 1: Code review (skip in fast mode or if last failure was lint/test)
+  # STEP 1: Run lint checks
   # ========================================
-  local skip_review=false
-  if [[ "$fast_mode" == "true" ]]; then
-    skip_review=true
-  elif [[ -f "$RALPH_DIR/last_precommit_failure.log" ]] || [[ -f "$RALPH_DIR/last_test_failure.log" ]]; then
-    # Skip review if last failure was lint/test - review won't help
-    skip_review=true
-    echo "  [1/5] Skipping code review (last failure was lint/test)"
-  fi
-
-  if [[ "$skip_review" == "false" ]]; then
-    echo "  [1/5] Running code review..."
-    if ! run_code_review "$story"; then
-      failed=1
-    fi
+  echo "  [1/3] Running lint checks..."
+  if ! run_configured_checks; then
+    failed=1
   fi
 
   # ========================================
-  # STEP 2+3: Run lint and tests IN PARALLEL
+  # STEP 2: Run unit tests
   # ========================================
   if [[ $failed -eq 0 ]]; then
     echo ""
-    echo "  [2/5] Running lint + tests (parallel)..."
-
-    # Create temp files for results
-    local lint_log test_log
-    lint_log=$(mktemp)
-    test_log=$(mktemp)
-
-    # Run lint in background
-    (run_configured_checks > "$lint_log" 2>&1; echo $? > "${lint_log}.exit") &
-    local lint_pid=$!
-
-    # Run tests in background
-    (run_unit_tests > "$test_log" 2>&1; echo $? > "${test_log}.exit") &
-    local test_pid=$!
-
-    # Wait for both
-    wait $lint_pid 2>/dev/null
-    wait $test_pid 2>/dev/null
-
-    # Check results
-    lint_failed=$(cat "${lint_log}.exit" 2>/dev/null || echo "1")
-    test_failed=$(cat "${test_log}.exit" 2>/dev/null || echo "1")
-
-    # Show lint output
-    echo "    Lint:"
-    cat "$lint_log" | sed 's/^/      /'
-
-    # Show test output
-    echo "    Tests:"
-    cat "$test_log" | sed 's/^/      /'
-
-    # Cleanup
-    rm -f "$lint_log" "${lint_log}.exit" "$test_log" "${test_log}.exit"
-
-    if [[ "$lint_failed" != "0" ]] || [[ "$test_failed" != "0" ]]; then
+    echo "  [2/3] Running tests..."
+    if ! run_unit_tests; then
       failed=1
     fi
   fi
 
   # ========================================
-  # STEP 3: Run Playwright tests (frontend) or API tests (backend)
-  # ========================================
-  if [[ $failed -eq 0 ]]; then
-    echo ""
-    if [[ "$story_type" == "backend" ]]; then
-      echo "  [3/5] Running API tests..."
-      if ! run_api_validation "$story"; then
-        failed=1
-      elif ! run_api_error_tests "$story"; then
-        failed=1
-      fi
-    else
-      echo "  [3/5] Running Playwright tests..."
-      if ! run_playwright_tests "$story"; then
-        failed=1
-      fi
-    fi
-  fi
-
-  # ========================================
-  # STEP 4: Run browser validation (frontend) or API validation (backend)
+  # STEP 3: Run PRD test steps
   # ========================================
   if [[ $failed -eq 0 ]]; then
     echo ""
-    if [[ "$story_type" == "backend" ]]; then
-      echo "  [4/5] Running API validation..."
-      if ! run_api_tests "$story"; then
-        failed=1
-      fi
-    else
-      echo "  [4/5] Running browser validation..."
-      if ! run_browser_validation "$story"; then
-        failed=1
-      fi
-    fi
-  fi
-
-  # ========================================
-  # STEP 5: Run PRD test steps
-  # ========================================
-  if [[ $failed -eq 0 ]]; then
-    echo ""
-    echo "  [5/5] Running PRD test steps..."
+    echo "  [3/3] Running PRD test steps..."
     if ! verify_prd_criteria "$story"; then
       failed=1
     fi
@@ -188,7 +58,6 @@ run_verification() {
     return 0
   else
     print_error "=== Verification failed ==="
-    # Save failure context for next iteration
     save_failure_context "$story"
     return 1
   fi
@@ -197,151 +66,14 @@ run_verification() {
 # Save failure context for next iteration
 save_failure_context() {
   local story="$1"
-
   local context_file="$RALPH_DIR/last_failure.txt"
 
   {
-    echo "=== Failure Context for $story ==="
-    echo "Timestamp: $(date -Iseconds 2>/dev/null || date)"
+    echo "=== Verification failed for $story ==="
     echo ""
-
-    if [[ -f "$RALPH_DIR/last_migration_failure.log" ]]; then
-      echo "--- Migration Failure ---"
-      echo "Database migrations failed. Fix the migration or the code causing it:"
-      tail -50 "$RALPH_DIR/last_migration_failure.log"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_review_failure.json" ]]; then
-      echo "--- Code Review Failure ---"
-      echo "Issues found by code review:"
-      jq -r '.issues[] | "- [\(.severity)] \(.category): \(.message)\n  File: \(.file // "unknown"):\(.line // "?")\n  Fix: \(.suggestion // "See above")"' "$RALPH_DIR/last_review_failure.json" 2>/dev/null
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_test_failure.log" ]]; then
-      echo "--- Test Failure ---"
-      tail -50 "$RALPH_DIR/last_test_failure.log"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_playwright_failure.log" ]]; then
-      echo "--- Playwright Failure ---"
-      tail -50 "$RALPH_DIR/last_playwright_failure.log"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_browser_failure.json" ]]; then
-      echo "--- Browser Validation Failure ---"
-      jq -r '"Errors: " + (.errors | join(", "))' "$RALPH_DIR/last_browser_failure.json" 2>/dev/null
-      jq -r '"Console errors: " + (.consoleErrors | join(", "))' "$RALPH_DIR/last_browser_failure.json" 2>/dev/null
-      jq -r '"Missing elements: " + (.elementsMissing | join(", "))' "$RALPH_DIR/last_browser_failure.json" 2>/dev/null
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_lint_failure.log" ]]; then
-      echo "--- Lint Failure ---"
-      echo "Fix these lint errors. The auto-fixer couldn't resolve them, but you can:"
-      echo ""
-      cat "$RALPH_DIR/last_lint_failure.log"
-      echo ""
-      echo "Common fixes:"
-      echo "  - E722 bare except: Change 'except:' to 'except Exception:'"
-      echo "  - F401 unused import: Remove the unused import"
-      echo "  - F841 unused variable: Remove or use the variable"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_typescript_failure.log" ]]; then
-      echo "--- TypeScript Failure ---"
-      echo "Fix these TypeScript type errors:"
-      echo ""
-      cat "$RALPH_DIR/last_typescript_failure.log"
-      echo ""
-      echo "Common fixes:"
-      echo "  - TS2322: Type mismatch - ensure assigned value matches expected type"
-      echo "  - TS2339: Property not found - check spelling or add to interface"
-      echo "  - TS2345: Argument type mismatch - cast or fix the argument type"
-      echo "  - TS7006: Implicit any - add explicit type annotation"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_build_failure.log" ]]; then
-      echo "--- Build Failure ---"
-      echo "Fix these build errors:"
-      echo ""
-      cat "$RALPH_DIR/last_build_failure.log"
-      echo ""
-      echo "Common causes:"
-      echo "  - Import errors: Check file paths and exports"
-      echo "  - SSR issues (Next.js): Use dynamic imports for client-only code"
-      echo "  - Missing dependencies: Run npm install"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_go_failure.log" ]]; then
-      echo "--- Go Failure ---"
-      echo "Fix these Go errors:"
-      echo ""
-      cat "$RALPH_DIR/last_go_failure.log"
-      echo ""
-      echo "Common fixes:"
-      echo "  - Unused variable: Remove or use with _ prefix"
-      echo "  - Undefined: Check imports and spelling"
-      echo "  - Type mismatch: Ensure types align or use type assertion"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_rust_failure.log" ]]; then
-      echo "--- Rust Failure ---"
-      echo "Fix these Rust errors:"
-      echo ""
-      cat "$RALPH_DIR/last_rust_failure.log"
-      echo ""
-      echo "Common fixes:"
-      echo "  - Unused variable: Prefix with _ or remove"
-      echo "  - Borrow checker: Check ownership and lifetimes"
-      echo "  - Missing trait: Add #[derive(...)] or impl"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_precommit_failure.log" ]]; then
-      echo "--- Pre-commit / Lint Failure ---"
-      echo "Fix these errors before the story can be completed:"
-      echo ""
-      # Extract actual error lines (not warnings-only or file modification messages)
-      grep -E "^error:|: error:|Error:|SyntaxError|✖ [0-9]+ problems|^[^:]+:[0-9]+:[0-9]+: [EF][0-9]+" "$RALPH_DIR/last_precommit_failure.log" | head -30
-      # If no errors shown, show the full log tail
-      if ! grep -qE "^error:|: error:|Error:|SyntaxError|✖ [0-9]+ problems" "$RALPH_DIR/last_precommit_failure.log"; then
-        echo "(Full output):"
-        tail -40 "$RALPH_DIR/last_precommit_failure.log"
-      fi
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_fastapi_response_check.log" ]]; then
-      echo "--- FastAPI Response Model Failure ---"
-      echo "Add Pydantic response_model to these endpoints for proper Swagger docs:"
-      echo ""
-      cat "$RALPH_DIR/last_fastapi_response_check.log"
-      echo ""
-      echo "Fix by adding response_model parameter or return type annotation:"
-      echo '  @router.get("/items", response_model=list[ItemSchema])'
-      echo "  async def get_items() -> list[ItemSchema]:"
-      echo ""
-    fi
-
-    if [[ -f "$RALPH_DIR/last_prd_failure.log" ]]; then
-      echo "--- PRD Test Step Failure ---"
-      echo "A test step in the PRD failed. Either fix your implementation OR fix the test step:"
-      echo ""
-      cat "$RALPH_DIR/last_prd_failure.log"
-      echo ""
-      echo "If the test step itself is broken (not your code), you can fix it:"
-      echo "  1. Read .ralph/prd.json to find the story and testSteps array"
-      echo "  2. Fix the command (e.g., add missing imports for SQLAlchemy models)"
-      echo "  3. Update with: jq '.stories[IDX].testSteps[N] = \"fixed command\"' .ralph/prd.json > tmp && mv tmp .ralph/prd.json"
-      echo ""
+    # Just include the verification output - Claude can figure out what went wrong
+    if [[ -f "$RALPH_DIR/last_verification.log" ]]; then
+      tail -100 "$RALPH_DIR/last_verification.log"
     fi
   } > "$context_file"
 }

package/templates/PROMPT.md

@@ -14,36 +14,38 @@ Before writing any code, verify:
 
 For each story, you must:
 
-### 1. Write Tests First
+### 1. Implement the Feature
 
-**For frontend stories:**
-- Write a Playwright test that validates the acceptance criteria
-- Include tests for error handling (API fails, validation errors)
-- Include tests for empty/loading states
-- Include accessibility checks (axe-core)
-- Include mobile viewport test (375px)
-
-**For backend stories:**
-- Write unit tests for the business logic
-- Write API tests that validate all endpoints
-- Test error responses (400, 401, 500)
-- Test validation rules
-
-### 2. Implement the Feature
-
-- Write code to make all tests pass
 - Follow existing patterns in the codebase
 - Handle ALL error cases defined in the story
 - Implement loading states for async operations
 
+### 2. Write Tests
+
+- Write unit tests for the business logic
+- Write tests that validate acceptance criteria
+- Test error cases and edge cases
+
 ### 3. Verify It Actually Works
 
+**You have browser tools - USE THEM to verify your work:**
+
+**Playwright MCP** (testing & automation):
+- `browser_navigate` - Go to a URL and get page content
+- `browser_screenshot` - Take a screenshot to verify UI
+- `browser_click` - Click elements to test interactions
+- `browser_type` - Fill in forms to test inputs
+- `browser_snapshot` - Get accessibility tree for a11y testing
+
+**Chrome DevTools MCP** (debugging & inspection):
+- Inspect DOM, check console for errors
+- Debug network requests
+- Check element styles and computed properties
+
 **Do NOT say you're done until:**
 - All unit tests pass
-- All Playwright tests pass
-- You've opened the browser via MCP and visually verified
+- You've opened the browser and visually verified the feature works
 - Console has no errors
-- It works on mobile (375px viewport)
 - Error states are handled gracefully
 
 ## Rules
@@ -60,33 +62,14 @@ For each story, you must:
 
 Before considering any story complete:
 
-### Code
 - [ ] All acceptance criteria are met
 - [ ] All error handling from story is implemented
-- [ ] Loading states implemented (if frontend)
-- [ ] Validation implemented (if backend)
-- [ ] TypeScript compiles without errors
-
-### Tests
+- [ ] TypeScript/code compiles without errors
 - [ ] Unit tests written and passing
-- [ ] Playwright test written and passing (frontend)
-- [ ] API tests written and passing (backend)
-- [ ] Error cases tested
-- [ ] Edge cases tested (empty state, etc.)
-
-### Browser/API Validation
-- [ ] Browser check passes (frontend) - no console errors
-- [ ] Mobile viewport works (375px)
-- [ ] Accessibility passes (can Tab through, focus visible)
-- [ ] API returns correct responses (backend)
-
-### Documentation
-- [ ] Updated `.ralph/progress.txt` with files created/modified
-- [ ] Noted any key decisions or context for next story
-
-### Quality
+- [ ] **Browser verified** - used Playwright MCP to visually confirm it works
+- [ ] No console errors
 - [ ] Linting passes
-- [ ] Existing tests still pass
+- [ ] Updated `.ralph/progress.txt` with files created/modified
 
 ## If Verification Fails