agileflow 2.75.0 → 2.77.0

package/src/core/commands/babysit.md

@@ -1,5 +1,6 @@
 ---
 description: Interactive mentor for end-to-end feature implementation
+argument-hint: "[EPIC=<id>] [MODE=loop] [MAX=<iterations>]"
 compact_context:
   priority: critical
   preserve_rules:
@@ -34,6 +35,78 @@ This gathers: git status, stories/epics, session state, docs structure, research
 
 ---
 
+## LOOP MODE (Autonomous Execution)
+
+When invoked with `MODE=loop`, babysit runs autonomously through an epic's stories:
+
+```
+/agileflow:babysit EPIC=EP-0042 MODE=loop MAX=20
+```
+
+### How Loop Mode Works
+
+1. **Initialization**: Writes loop config to `session-state.json`
+2. **First Story**: Picks first "ready" story, marks it "in_progress"
+3. **Work**: You implement the story normally
+4. **Stop Hook**: When you stop, `ralph-loop.js` runs:
+   - Runs `npm test` (or configured test command)
+   - If tests pass → marks story complete, loads next story
+   - If tests fail → shows failures, you continue fixing
+5. **Loop**: Continues until epic complete or MAX iterations reached
+
+### Parameters
+
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `EPIC` | Yes | Epic ID to process (e.g., EP-0042) |
+| `MODE` | Yes | Must be `loop` for autonomous mode |
+| `MAX` | No | Max iterations (default: 20) |
+
+### To Start Loop Mode
+
+After running the context script, if EPIC and MODE=loop are specified:
+
+```bash
+# Initialize the loop
+node scripts/ralph-loop.js --init --epic=EP-0042 --max=20
+```
+
+Or manually write to session-state.json:
+
+```json
+{
+  "ralph_loop": {
+    "enabled": true,
+    "epic": "EP-0042",
+    "current_story": "US-0015",
+    "iteration": 0,
+    "max_iterations": 20
+  }
+}
+```
+
+### Loop Control Commands
+
+```bash
+node scripts/ralph-loop.js --status   # Check loop status
+node scripts/ralph-loop.js --stop     # Stop the loop
+node scripts/ralph-loop.js --reset    # Reset loop state
+```
+
+### When to Use Loop Mode
+
+**Good for:**
+- Working through a well-defined epic with clear stories
+- Test-driven development (tests define "done")
+- Batch processing multiple stories overnight
+
+**Not good for:**
+- Exploratory work without clear acceptance criteria
+- Stories requiring human review before proceeding
+- Complex multi-domain work needing coordination
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 
 ## Compact Summary

package/src/core/commands/configure.md

@@ -36,7 +36,9 @@ node .agileflow/scripts/agileflow-configure.js --repair=statusline  # Fix specif
 
 ### Features
 
-`sessionstart`, `precompact`, `archival`, `statusline`, `autoupdate`
+`sessionstart`, `precompact`, `ralphloop`, `selfimprove`, `archival`, `statusline`, `autoupdate`
+
+**Stop hooks** (ralphloop, selfimprove) run when Claude completes or pauses work.
 
 ### Critical Rules
 
@@ -162,12 +164,12 @@ node .agileflow/scripts/agileflow-configure.js --enable=archival --archival-days
 
 ## Profile Details
 
-| Profile | SessionStart | PreCompact | Archival | StatusLine |
-|---------|-------------|------------|----------|------------|
-| `full` | ✅ | ✅ | ✅ 30 days | ✅ |
-| `basic` | ✅ | ✅ | ✅ 30 days | ❌ |
-| `minimal` | ✅ | ❌ | ✅ 30 days | ❌ |
-| `none` | ❌ | ❌ | ❌ | ❌ |
+| Profile | SessionStart | PreCompact | RalphLoop | SelfImprove | Archival | StatusLine |
+|---------|-------------|------------|-----------|-------------|----------|------------|
+| `full` | ✅ | ✅ | ✅ | ✅ | ✅ 30 days | ✅ |
+| `basic` | ✅ | ✅ | ❌ | ❌ | ✅ 30 days | ❌ |
+| `minimal` | ✅ | ❌ | ❌ | ❌ | ✅ 30 days | ❌ |
+| `none` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
 
 ## Interactive Mode (via /configure command)
 
@@ -204,6 +206,8 @@ Based on selection, run appropriate command.
   "options": [
     {"label": "SessionStart Hook", "description": "Welcome display with project status"},
     {"label": "PreCompact Hook", "description": "Context preservation on compact"},
+    {"label": "RalphLoop (Stop Hook)", "description": "Autonomous story loop - runs tests, advances stories"},
+    {"label": "SelfImprove (Stop Hook)", "description": "Auto-update agent expertise from work"},
     {"label": "Archival", "description": "Auto-archive old completed stories"},
     {"label": "Status Line", "description": "Custom status bar"},
     {"label": "Auto-Update", "description": "Automatically update AgileFlow on session start"}
@@ -215,6 +219,8 @@ Based on selection, run appropriate command.
 Map selections:
 - "SessionStart Hook" → `sessionstart`
 - "PreCompact Hook" → `precompact`
+- "RalphLoop (Stop Hook)" → `ralphloop`
+- "SelfImprove (Stop Hook)" → `selfimprove`
 - "Archival" → `archival`
 - "Status Line" → `statusline`
 - "Auto-Update" → `autoupdate`
@@ -241,6 +247,43 @@ node .agileflow/scripts/agileflow-configure.js --enable=autoupdate
 
 **Check frequencies:** `hourly`, `daily`, `weekly`, `never`
 
+## Stop Hook Features
+
+Stop hooks run when Claude completes a task or pauses for user input. These enable autonomous workflows.
+
+### RalphLoop (`ralphloop`)
+
+Autonomous story processing loop (named after the "Ralph Wiggum" pattern):
+- Runs tests automatically when Claude stops
+- If tests pass → marks story as completed, loads next story in epic
+- If tests fail → shows failures for Claude to fix
+- Tracks iterations with configurable limits (default: 20)
+- Enable: `--enable=ralphloop`
+
+**How to use:**
+1. Enable: `node .agileflow/scripts/agileflow-configure.js --enable=ralphloop`
+2. Start a loop: `node .agileflow/scripts/ralph-loop.js --init --epic=EP-XXXX`
+3. Work on stories - tests run automatically when Claude stops
+4. Check status: `node .agileflow/scripts/ralph-loop.js --status`
+5. Stop loop: `node .agileflow/scripts/ralph-loop.js --stop`
+
+### SelfImprove (`selfimprove`)
+
+Automatic agent expertise learning:
+- Analyzes git changes when Claude stops
+- Detects which domain (database, api, ui, etc.) was modified
+- Appends learnings to the relevant agent's expertise.yaml
+- Helps agents improve over time based on actual work
+- Enable: `--enable=selfimprove`
+
+**What it learns:**
+- Files modified per domain
+- New patterns discovered
+- Test file changes
+- Configuration updates
+
+Both Stop hooks use error suppression (`2>/dev/null || true`) to avoid blocking Claude if they fail.
+
 ## Format Migration Details
 
 The script handles these migrations automatically:

package/src/core/experts/documentation/expertise.yaml

@@ -113,6 +113,10 @@ conventions:
 
 # Learned from AgileFlow codebase exploration
 learnings:
+  - date: "2026-01-01"
+    auto_generated: true
+    context: "Test learning"
+    insight: "This is a test"
   - date: 2025-12-21
     context: "Analyzed docs/ directory structure"
     insight: "10 numbered directories (00-meta through 10-research) organize all project documentation"

package/src/core/experts/research/expertise.yaml

@@ -85,7 +85,7 @@ patterns:
     example: "See [Research](../10-research/20251216-agent-experts-self-improving-agents.md)"
 
   - name: Context Export
-    description: "/agileflow:context for external AI research"
+    description: "/agileflow:research:ask for external AI research prompts"
     command: "/agileflow:research:ask TOPIC=<topic>"
     purpose: "Generate prompt for ChatGPT/external AI with project context"
 
@@ -97,7 +97,7 @@ conventions:
   - "Include TL;DR at top for quick scanning"
   - "Flag research >90 days old as potentially stale"
   - "Create retrospective notes after major implementations"
-  - "Use /agileflow:context for external AI research prompts"
+  - "Use /agileflow:research:ask for external AI research prompts prompts"
 
 research_categories:
   - "Technology evaluation (framework, library)"

package/tools/cli/commands/list.js

@@ -10,7 +10,9 @@ const fs = require('fs-extra');
 const yaml = require('js-yaml');
 const { Installer } = require('../installers/core/installer');
 const { displayLogo, displaySection, success, warning, info } = require('../lib/ui');
-const { parseFrontmatter: parseYamlFrontmatter } = require('../../../scripts/lib/frontmatter-parser');
+const {
+  parseFrontmatter: parseYamlFrontmatter,
+} = require('../../../scripts/lib/frontmatter-parser');
 
 const installer = new Installer();
 

package/tools/cli/commands/uninstall.js

@@ -49,10 +49,7 @@ module.exports = {
 
         // Confirm removal
         if (!options.force) {
-          const proceed = await confirm(
-            `Remove ${formatIdeName(ideName)} configuration?`,
-            false
-          );
+          const proceed = await confirm(`Remove ${formatIdeName(ideName)} configuration?`, false);
           if (!proceed) {
             console.log(chalk.dim('\nCancelled\n'));
             process.exit(0);
@@ -91,7 +88,9 @@ module.exports = {
 
         console.log(chalk.green(`\n${formatIdeName(ideName)} has been removed.\n`));
         if (status.ides.length > 1) {
-          console.log(chalk.dim(`Remaining IDEs: ${status.ides.filter(i => i !== ideName).join(', ')}\n`));
+          console.log(
+            chalk.dim(`Remaining IDEs: ${status.ides.filter(i => i !== ideName).join(', ')}\n`)
+          );
         }
 
         process.exit(0);

package/tools/cli/commands/update.js

@@ -107,12 +107,20 @@ module.exports = {
         console.log();
         warning('Your global CLI is outdated!');
         console.log(
-          chalk.dim(`  You have a global installation at v${localCliVersion}, but v${npmLatestVersion} is available.\n`)
+          chalk.dim(
+            `  You have a global installation at v${localCliVersion}, but v${npmLatestVersion} is available.\n`
+          )
         );
         console.log(chalk.dim(`  Options:`));
         console.log(chalk.dim(`  1. Cancel and run: `) + chalk.cyan(`npx agileflow@latest update`));
-        console.log(chalk.dim(`  2. Remove global:  `) + chalk.cyan(`npm uninstall -g agileflow`) + chalk.dim(` (recommended)`));
-        console.log(chalk.dim(`  3. Update global:  `) + chalk.cyan(`npm install -g agileflow@latest\n`));
+        console.log(
+          chalk.dim(`  2. Remove global:  `) +
+            chalk.cyan(`npm uninstall -g agileflow`) +
+            chalk.dim(` (recommended)`)
+        );
+        console.log(
+          chalk.dim(`  3. Update global:  `) + chalk.cyan(`npm install -g agileflow@latest\n`)
+        );
 
         const useOutdated = options.force
           ? true

package/tools/cli/lib/content-injector.js

@@ -26,7 +26,12 @@ const path = require('path');
 
 // Use shared modules
 const { parseFrontmatter, normalizeTools } = require('../../../scripts/lib/frontmatter-parser');
-const { countCommands, countAgents, countSkills, getCounts } = require('../../../scripts/lib/counter');
+const {
+  countCommands,
+  countAgents,
+  countSkills,
+  getCounts,
+} = require('../../../scripts/lib/counter');
 
 // =============================================================================
 // List Generation Functions

package/tools/cli/lib/docs-setup.js

@@ -208,7 +208,7 @@ Research findings, investigations, and technical explorations.
 
 ## Format
 
-Use \`/agileflow:research\` to create new research notes.
+Use \`/agileflow:research:ask\` to generate research prompts for web AI, then \`/agileflow:research:import\` to bring results back.
 
 | Date | Topic | Path | Summary |
 |------|-------|------|---------|