agileflow 2.79.0 → 2.80.0

package/scripts/damage-control/write-tool-damage-control.js

@@ -114,27 +114,9 @@ function parsePathRules(content) {
  */
 function getDefaultPathRules() {
   return {
-    zeroAccessPaths: [
-      '~/.ssh/',
-      '~/.aws/credentials',
-      '.env',
-      '.env.local',
-      '.env.production',
-    ],
-    readOnlyPaths: [
-      '/etc/',
-      '~/.bashrc',
-      '~/.zshrc',
-      'package-lock.json',
-      'yarn.lock',
-      '.git/',
-    ],
-    noDeletePaths: [
-      '.agileflow/',
-      '.claude/',
-      'docs/09-agents/status.json',
-      'CLAUDE.md',
-    ],
+    zeroAccessPaths: ['~/.ssh/', '~/.aws/credentials', '.env', '.env.local', '.env.production'],
+    readOnlyPaths: ['/etc/', '~/.bashrc', '~/.zshrc', 'package-lock.json', 'yarn.lock', '.git/'],
+    noDeletePaths: ['.agileflow/', '.claude/', 'docs/09-agents/status.json', 'CLAUDE.md'],
   };
 }
 
@@ -247,9 +229,7 @@ function main() {
   }
 
   // Resolve to absolute path
-  const absolutePath = path.isAbsolute(filePath)
-    ? filePath
-    : path.join(projectDir, filePath);
+  const absolutePath = path.isAbsolute(filePath) ? filePath : path.join(projectDir, filePath);
 
   // Load rules
   const rules = loadPathRules(projectDir);

package/scripts/damage-control-bash.js

@@ -17,14 +17,7 @@
 
 const fs = require('fs');
 const path = require('path');
-
-// Color codes for output
-const c = {
-  red: '\x1b[38;5;203m',
-  yellow: '\x1b[38;5;215m',
-  reset: '\x1b[0m',
-  dim: '\x1b[2m'
-};
+const { c } = require('../lib/colors');
 
 /**
  * Find project root by looking for .agileflow directory
@@ -48,7 +41,7 @@ function parseSimpleYAML(content) {
   const config = {
     bashToolPatterns: [],
     askPatterns: [],
-    agileflowProtections: []
+    agileflowProtections: [],
   };
 
   let currentSection = null;
@@ -76,13 +69,22 @@ function parseSimpleYAML(content) {
       currentPattern = null;
     } else if (trimmed.startsWith('- pattern:') && currentSection) {
       // New pattern entry
-      const patternValue = trimmed.replace('- pattern:', '').trim().replace(/^["']|["']$/g, '');
+      const patternValue = trimmed
+        .replace('- pattern:', '')
+        .trim()
+        .replace(/^["']|["']$/g, '');
       currentPattern = { pattern: patternValue };
       config[currentSection].push(currentPattern);
     } else if (trimmed.startsWith('reason:') && currentPattern) {
-      currentPattern.reason = trimmed.replace('reason:', '').trim().replace(/^["']|["']$/g, '');
+      currentPattern.reason = trimmed
+        .replace('reason:', '')
+        .trim()
+        .replace(/^["']|["']$/g, '');
     } else if (trimmed.startsWith('flags:') && currentPattern) {
-      currentPattern.flags = trimmed.replace('flags:', '').trim().replace(/^["']|["']$/g, '');
+      currentPattern.flags = trimmed
+        .replace('flags:', '')
+        .trim()
+        .replace(/^["']|["']$/g, '');
     }
   }
 
@@ -96,7 +98,7 @@ function loadPatterns(projectRoot) {
   const configPaths = [
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yaml'),
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yml'),
-    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml')
+    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml'),
   ];
 
   for (const configPath of configPaths) {
@@ -135,14 +137,14 @@ function validateCommand(command, config) {
   // Check blocked patterns (bashToolPatterns + agileflowProtections)
   const blockedPatterns = [
     ...(config.bashToolPatterns || []),
-    ...(config.agileflowProtections || [])
+    ...(config.agileflowProtections || []),
   ];
 
   for (const rule of blockedPatterns) {
     if (matchesPattern(command, rule)) {
       return {
         action: 'block',
-        reason: rule.reason || 'Command blocked by damage control'
+        reason: rule.reason || 'Command blocked by damage control',
       };
     }
   }
@@ -152,7 +154,7 @@ function validateCommand(command, config) {
     if (matchesPattern(command, rule)) {
       return {
         action: 'ask',
-        reason: rule.reason || 'Please confirm this command'
+        reason: rule.reason || 'Please confirm this command',
       };
     }
   }
@@ -192,17 +194,21 @@ function main() {
       switch (result.action) {
         case 'block':
           // Output error message and block
-          console.error(`${c.red}[BLOCKED]${c.reset} ${result.reason}`);
-          console.error(`${c.dim}Command: ${command.substring(0, 100)}${command.length > 100 ? '...' : ''}${c.reset}`);
+          console.error(`${c.coral}[BLOCKED]${c.reset} ${result.reason}`);
+          console.error(
+            `${c.dim}Command: ${command.substring(0, 100)}${command.length > 100 ? '...' : ''}${c.reset}`
+          );
           process.exit(2);
           break;
 
         case 'ask':
           // Output JSON to trigger user confirmation
-          console.log(JSON.stringify({
-            result: 'ask',
-            message: result.reason
-          }));
+          console.log(
+            JSON.stringify({
+              result: 'ask',
+              message: result.reason,
+            })
+          );
           process.exit(0);
           break;
 

package/scripts/damage-control-edit.js

@@ -15,13 +15,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-
-// Color codes for output
-const c = {
-  red: '\x1b[38;5;203m',
-  reset: '\x1b[0m',
-  dim: '\x1b[2m'
-};
+const { c } = require('../lib/colors');
 
 /**
  * Find project root by looking for .agileflow directory
@@ -54,7 +48,7 @@ function parseSimpleYAML(content) {
   const config = {
     zeroAccessPaths: [],
     readOnlyPaths: [],
-    noDeletePaths: []
+    noDeletePaths: [],
   };
 
   let currentSection = null;
@@ -92,7 +86,7 @@ function loadPatterns(projectRoot) {
   const configPaths = [
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yaml'),
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yml'),
-    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml')
+    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml'),
   ];
 
   for (const configPath of configPaths) {
@@ -168,7 +162,7 @@ function validatePath(filePath, config) {
     return {
       action: 'block',
       reason: `Zero-access path: ${zeroMatch}`,
-      detail: 'This file is protected and cannot be accessed'
+      detail: 'This file is protected and cannot be accessed',
     };
   }
 
@@ -178,7 +172,7 @@ function validatePath(filePath, config) {
     return {
       action: 'block',
       reason: `Read-only path: ${readOnlyMatch}`,
-      detail: 'This file is read-only and cannot be edited'
+      detail: 'This file is read-only and cannot be edited',
     };
   }
 
@@ -215,7 +209,7 @@ function main() {
       const result = validatePath(filePath, config);
 
       if (result.action === 'block') {
-        console.error(`${c.red}[BLOCKED]${c.reset} ${result.reason}`);
+        console.error(`${c.coral}[BLOCKED]${c.reset} ${result.reason}`);
         console.error(`${c.dim}${result.detail}${c.reset}`);
         console.error(`${c.dim}File: ${filePath}${c.reset}`);
         process.exit(2);

package/scripts/damage-control-write.js

@@ -15,13 +15,7 @@
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
-
-// Color codes for output
-const c = {
-  red: '\x1b[38;5;203m',
-  reset: '\x1b[0m',
-  dim: '\x1b[2m'
-};
+const { c } = require('../lib/colors');
 
 /**
  * Find project root by looking for .agileflow directory
@@ -54,7 +48,7 @@ function parseSimpleYAML(content) {
   const config = {
     zeroAccessPaths: [],
     readOnlyPaths: [],
-    noDeletePaths: []
+    noDeletePaths: [],
   };
 
   let currentSection = null;
@@ -92,7 +86,7 @@ function loadPatterns(projectRoot) {
   const configPaths = [
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yaml'),
     path.join(projectRoot, '.agileflow/config/damage-control-patterns.yml'),
-    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml')
+    path.join(projectRoot, '.agileflow/templates/damage-control-patterns.yaml'),
   ];
 
   for (const configPath of configPaths) {
@@ -168,7 +162,7 @@ function validatePath(filePath, config) {
     return {
       action: 'block',
       reason: `Zero-access path: ${zeroMatch}`,
-      detail: 'This file is protected and cannot be accessed'
+      detail: 'This file is protected and cannot be accessed',
     };
   }
 
@@ -178,7 +172,7 @@ function validatePath(filePath, config) {
     return {
       action: 'block',
       reason: `Read-only path: ${readOnlyMatch}`,
-      detail: 'This file is read-only and cannot be written to'
+      detail: 'This file is read-only and cannot be written to',
     };
   }
 
@@ -215,7 +209,7 @@ function main() {
       const result = validatePath(filePath, config);
 
       if (result.action === 'block') {
-        console.error(`${c.red}[BLOCKED]${c.reset} ${result.reason}`);
+        console.error(`${c.coral}[BLOCKED]${c.reset} ${result.reason}`);
         console.error(`${c.dim}${result.detail}${c.reset}`);
         console.error(`${c.dim}File: ${filePath}${c.reset}`);
         process.exit(2);

package/scripts/get-env.js

@@ -156,12 +156,12 @@ function formatOutput(info, asJson = false, compact = false) {
     brand: '\x1b[38;2;232;104;58m', // #e8683a - AgileFlow brand orange
 
     // Vibrant 256-color palette (modern, sleek look)
-    mintGreen: '\x1b[38;5;158m',    // Healthy/success states
-    peach: '\x1b[38;5;215m',        // Warning states
-    coral: '\x1b[38;5;203m',        // Critical/error states
-    lightGreen: '\x1b[38;5;194m',   // Session healthy
-    skyBlue: '\x1b[38;5;117m',      // Directories/paths
-    lavender: '\x1b[38;5;147m',     // Model info
+    mintGreen: '\x1b[38;5;158m', // Healthy/success states
+    peach: '\x1b[38;5;215m', // Warning states
+    coral: '\x1b[38;5;203m', // Critical/error states
+    lightGreen: '\x1b[38;5;194m', // Session healthy
+    skyBlue: '\x1b[38;5;117m', // Directories/paths
+    lavender: '\x1b[38;5;147m', // Model info
   };
 
   // Beautiful compact colorful format (using vibrant 256-color palette)

package/scripts/obtain-context.js

@@ -18,6 +18,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
+const { c: C, box } = require('../lib/colors');
 
 const DISPLAY_LIMIT = 30000; // Claude Code's Bash tool display limit
 
@@ -44,8 +45,10 @@ if (commandName) {
         state: {},
       });
 
-      // Keep backwards compatibility - also set singular active_command to most recent
-      state.active_command = state.active_commands[state.active_commands.length - 1];
+      // Remove legacy active_command field (only use active_commands array now)
+      if (state.active_command !== undefined) {
+        delete state.active_command;
+      }
 
       fs.writeFileSync(sessionStatePath, JSON.stringify(state, null, 2) + '\n');
     } catch (e) {
@@ -54,33 +57,6 @@ if (commandName) {
   }
 }
 
-// ANSI colors
-const C = {
-  reset: '\x1b[0m',
-  dim: '\x1b[2m',
-  bold: '\x1b[1m',
-  cyan: '\x1b[36m',
-  yellow: '\x1b[33m',
-  green: '\x1b[32m',
-  red: '\x1b[31m',
-  magenta: '\x1b[35m',
-  blue: '\x1b[34m',
-  brightCyan: '\x1b[96m',
-  brightYellow: '\x1b[93m',
-  brightGreen: '\x1b[92m',
-  brand: '\x1b[38;2;232;104;58m', // AgileFlow brand orange
-
-  // Vibrant 256-color palette (modern, sleek look)
-  mintGreen: '\x1b[38;5;158m',    // Healthy/success states
-  peach: '\x1b[38;5;215m',        // Warning states
-  coral: '\x1b[38;5;203m',        // Critical/error states
-  lightGreen: '\x1b[38;5;194m',   // Session healthy
-  lightYellow: '\x1b[38;5;228m',  // Session warning
-  skyBlue: '\x1b[38;5;117m',      // Directories/paths
-  lavender: '\x1b[38;5;147m',     // Model info
-  softGold: '\x1b[38;5;222m',     // Cost/money
-};
-
 function safeRead(filePath) {
   try {
     return fs.readFileSync(filePath, 'utf8');
@@ -225,7 +201,8 @@ function generateSummary() {
 
   // Header row (full width, no column divider)
   const title = commandName ? `Context [${commandName}]` : 'Context Summary';
-  const branchColor = branch === 'main' ? C.mintGreen : branch.startsWith('fix') ? C.coral : C.skyBlue;
+  const branchColor =
+    branch === 'main' ? C.mintGreen : branch.startsWith('fix') ? C.coral : C.skyBlue;
   const maxBranchLen = 20;
   const branchDisplay =
     branch.length > maxBranchLen ? branch.substring(0, maxBranchLen - 2) + '..' : branch;
@@ -300,7 +277,12 @@ function generateSummary() {
 
   // Research
   const researchText = researchFiles.length > 0 ? `${researchFiles.length} notes` : 'none';
-  summary += row('Research', researchText, C.lavender, researchFiles.length > 0 ? C.skyBlue : C.dim);
+  summary += row(
+    'Research',
+    researchText,
+    C.lavender,
+    researchFiles.length > 0 ? C.skyBlue : C.dim
+  );
 
   // Epics
   const epicText = epicFiles.length > 0 ? `${epicFiles.length} epics` : 'none';
@@ -396,7 +378,36 @@ function generateFullContent() {
     content += `${C.dim}No session-state.json found${C.reset}\n`;
   }
 
-  // 4. DOCS STRUCTURE (using vibrant 256-color palette)
+  // 4. INTERACTION MODE (AskUserQuestion guidance)
+  const metadata = safeReadJSON('docs/00-meta/agileflow-metadata.json');
+  const askUserQuestionConfig = metadata?.features?.askUserQuestion;
+
+  if (askUserQuestionConfig?.enabled) {
+    content += `\n${C.brand}${C.bold}═══ ⚡ INTERACTION MODE: AskUserQuestion ENABLED ═══${C.reset}\n`;
+    content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
+    content += `${C.bold}CRITICAL RULE:${C.reset} End ${C.skyBlue}EVERY${C.reset} response with the AskUserQuestion tool.\n\n`;
+    content += `${C.mintGreen}✓ CORRECT:${C.reset} Call the actual AskUserQuestion tool\n`;
+    content += `${C.coral}✗ WRONG:${C.reset} Text like "Want me to continue?" or "What's next?"\n\n`;
+    content += `${C.lavender}Required format:${C.reset}\n`;
+    content += `${C.dim}\`\`\`xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What would you like to do next?",
+  "header": "Next step",
+  "multiSelect": false,
+  "options": [
+    {"label": "Option A (Recommended)", "description": "Why this is best"},
+    {"label": "Option B", "description": "Alternative approach"},
+    {"label": "Pause", "description": "Stop here for now"}
+  ]
+}]</parameter>
+</invoke>
+\`\`\`${C.reset}\n`;
+    content += `${C.dim}${'─'.repeat(60)}${C.reset}\n`;
+    content += `${C.dim}Mode: ${askUserQuestionConfig.mode || 'all'} | Configure: /agileflow:configure${C.reset}\n\n`;
+  }
+
+  // 5. DOCS STRUCTURE (using vibrant 256-color palette)
   content += `\n${C.skyBlue}${C.bold}═══ Documentation ═══${C.reset}\n`;
   const docsDir = 'docs';
   const docFolders = safeLs(docsDir).filter(f => {
@@ -420,7 +431,7 @@ function generateFullContent() {
     });
   }
 
-  // 5. RESEARCH NOTES - List + Full content of most recent (using vibrant 256-color palette)
+  // 6. RESEARCH NOTES - List + Full content of most recent (using vibrant 256-color palette)
   content += `\n${C.skyBlue}${C.bold}═══ Research Notes ═══${C.reset}\n`;
   const researchDir = 'docs/10-research';
   const researchFiles = safeLs(researchDir).filter(f => f.endsWith('.md') && f !== 'README.md');
@@ -443,7 +454,7 @@ function generateFullContent() {
     content += `${C.dim}No research notes${C.reset}\n`;
   }
 
-  // 6. BUS MESSAGES (using vibrant 256-color palette)
+  // 7. BUS MESSAGES (using vibrant 256-color palette)
   content += `\n${C.skyBlue}${C.bold}═══ Recent Agent Messages ═══${C.reset}\n`;
   const busPath = 'docs/09-agents/bus/log.jsonl';
   const busContent = safeRead(busPath);
@@ -467,7 +478,7 @@ function generateFullContent() {
     content += `${C.dim}No bus log found${C.reset}\n`;
   }
 
-  // 7. KEY FILES - Full content
+  // 8. KEY FILES - Full content
   content += `\n${C.cyan}${C.bold}═══ Key Context Files (Full Content) ═══${C.reset}\n`;
 
   const keyFilesToRead = [
@@ -493,7 +504,7 @@ function generateFullContent() {
   const settingsExists = fs.existsSync('.claude/settings.json');
   content += `\n  ${settingsExists ? `${C.green}✓${C.reset}` : `${C.dim}○${C.reset}`} .claude/settings.json\n`;
 
-  // 8. EPICS FOLDER
+  // 9. EPICS FOLDER
   content += `\n${C.cyan}${C.bold}═══ Epic Files ═══${C.reset}\n`;
   const epicFiles = safeLs('docs/05-epics').filter(f => f.endsWith('.md') && f !== 'README.md');
   if (epicFiles.length > 0) {

package/scripts/ralph-loop.js

@@ -134,7 +134,7 @@ function verifyScreenshots(rootDir) {
   const imageExtensions = ['.png', '.jpg', '.jpeg', '.webp', '.gif'];
   let files;
   try {
-    files = fs.readdirSync(fullPath).filter((file) => {
+    files = fs.readdirSync(fullPath).filter(file => {
       const ext = path.extname(file).toLowerCase();
       return imageExtensions.includes(ext);
     });
@@ -320,11 +320,13 @@ function handleLoop(rootDir) {
         console.log(`${c.yellow}⚠ ${screenshotResult.output}${c.reset}`);
         if (screenshotResult.unverified.length > 0) {
           console.log(`${c.dim}Unverified screenshots:${c.reset}`);
-          screenshotResult.unverified.slice(0, 5).forEach((file) => {
+          screenshotResult.unverified.slice(0, 5).forEach(file => {
             console.log(`  ${c.yellow}- ${file}${c.reset}`);
           });
           if (screenshotResult.unverified.length > 5) {
-            console.log(`  ${c.dim}... and ${screenshotResult.unverified.length - 5} more${c.reset}`);
+            console.log(
+              `  ${c.dim}... and ${screenshotResult.unverified.length - 5} more${c.reset}`
+            );
           }
         }
         state.ralph_loop.screenshots_verified = false;
@@ -334,8 +336,12 @@ function handleLoop(rootDir) {
     // Visual Mode: Enforce minimum iterations
     if (visualMode && iteration < minIterations) {
       console.log('');
-      console.log(`${c.yellow}⚠ Visual Mode requires ${minIterations}+ iterations for confirmation${c.reset}`);
-      console.log(`${c.dim}Current: iteration ${iteration}. Let loop run once more to confirm.${c.reset}`);
+      console.log(
+        `${c.yellow}⚠ Visual Mode requires ${minIterations}+ iterations for confirmation${c.reset}`
+      );
+      console.log(
+        `${c.dim}Current: iteration ${iteration}. Let loop run once more to confirm.${c.reset}`
+      );
 
       state.ralph_loop.iteration = iteration;
       saveSessionState(rootDir, state);
@@ -458,7 +464,9 @@ function handleCLI() {
       console.log(`  Current Story: ${loop.current_story}`);
       console.log(`  Iteration: ${loop.iteration || 0}/${loop.max_iterations || 20}`);
       if (loop.visual_mode) {
-        const verified = loop.screenshots_verified ? `${c.green}yes${c.reset}` : `${c.yellow}no${c.reset}`;
+        const verified = loop.screenshots_verified
+          ? `${c.green}yes${c.reset}`
+          : `${c.yellow}no${c.reset}`;
         console.log(`  Screenshots Verified: ${verified}`);
       }
     }

package/scripts/screenshot-verifier.js

@@ -97,7 +97,7 @@ function getImageFiles(dir) {
 
   try {
     const files = fs.readdirSync(dir);
-    return files.filter((file) => {
+    return files.filter(file => {
       const ext = path.extname(file).toLowerCase();
       return imageExtensions.includes(ext);
     });
@@ -172,7 +172,9 @@ function formatResult(result, options) {
 
   if (result.success) {
     console.log(`${c.green}${c.bold}All screenshots verified${c.reset}`);
-    console.log(`${c.dim}${result.verified}/${result.total} screenshots have 'verified-' prefix${c.reset}`);
+    console.log(
+      `${c.dim}${result.verified}/${result.total} screenshots have 'verified-' prefix${c.reset}`
+    );
   } else {
     console.log(`${c.red}${c.bold}Unverified screenshots found${c.reset}`);
     console.log(`${c.dim}${result.verified}/${result.total} verified${c.reset}`);

package/src/core/commands/configure.md

@@ -10,7 +10,7 @@ compact_context:
     - "CRITICAL: If 🔄 OUTDATED shown → offer --upgrade to re-deploy latest scripts"
     - "MUST backup created on migrate: .claude/settings.json.backup"
     - "MUST show RED RESTART banner after ANY changes (quit, wait 5s, restart)"
-    - "Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate"
+    - "Features: sessionstart, precompact, ralphloop, selfimprove, archival, statusline, autoupdate, askuserquestion"
     - "Stop hooks (ralphloop, selfimprove) run when Claude completes or pauses"
   state_fields:
     - detection_status
@@ -52,7 +52,7 @@ node .agileflow/scripts/agileflow-configure.js --repair=statusline  # Fix specif
 
 ### Features
 
-`sessionstart`, `precompact`, `ralphloop`, `selfimprove`, `archival`, `statusline`, `autoupdate`
+`sessionstart`, `precompact`, `ralphloop`, `selfimprove`, `archival`, `statusline`, `autoupdate`, `askuserquestion`
 
 **Stop hooks** (ralphloop, selfimprove) run when Claude completes or pauses work.
 
@@ -180,12 +180,12 @@ node .agileflow/scripts/agileflow-configure.js --enable=archival --archival-days
 
 ## Profile Details
 
-| Profile | SessionStart | PreCompact | RalphLoop | SelfImprove | Archival | StatusLine |
-|---------|-------------|------------|-----------|-------------|----------|------------|
-| `full` | ✅ | ✅ | ✅ | ✅ | ✅ 30 days | ✅ |
-| `basic` | ✅ | ✅ | ❌ | ❌ | ✅ 30 days | ❌ |
-| `minimal` | ✅ | ❌ | ❌ | ❌ | ✅ 30 days | ❌ |
-| `none` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
+| Profile | SessionStart | PreCompact | RalphLoop | SelfImprove | Archival | StatusLine | AskUserQuestion |
+|---------|-------------|------------|-----------|-------------|----------|------------|-----------------|
+| `full` | ✅ | ✅ | ✅ | ✅ | ✅ 30 days | ✅ | ✅ |
+| `basic` | ✅ | ✅ | ❌ | ❌ | ✅ 30 days | ❌ | ✅ |
+| `minimal` | ✅ | ❌ | ❌ | ❌ | ✅ 30 days | ❌ | ❌ |
+| `none` | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |
 
 ## Interactive Mode (via /configure command)
 
@@ -226,7 +226,8 @@ Based on selection, run appropriate command.
     {"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"}
+    {"label": "Auto-Update", "description": "Automatically update AgileFlow on session start"},
+    {"label": "AskUserQuestion Mode", "description": "End all responses with AskUserQuestion tool for guided interaction"}
   ]
 }]</parameter>
 </invoke>
@@ -240,6 +241,7 @@ Map selections:
 - "Archival" → `archival`
 - "Status Line" → `statusline`
 - "Auto-Update" → `autoupdate`
+- "AskUserQuestion Mode" → `askuserquestion`
 
 ## Auto-Update Configuration
 
@@ -263,6 +265,41 @@ node .agileflow/scripts/agileflow-configure.js --enable=autoupdate
 
 **Check frequencies:** `hourly`, `daily`, `weekly`, `never`
 
+## AskUserQuestion Mode
+
+Enable AskUserQuestion to have all commands end with guided options:
+
+```bash
+# Enable AskUserQuestion mode
+node .agileflow/scripts/agileflow-configure.js --enable=askuserquestion
+
+# Disable AskUserQuestion mode
+node .agileflow/scripts/agileflow-configure.js --disable=askuserquestion
+```
+
+**What it does:**
+- When enabled: All commands end with AskUserQuestion tool call (guided options)
+- When disabled: Commands can end with natural text questions
+
+**Storage in metadata:**
+```json
+{
+  "features": {
+    "askUserQuestion": {
+      "enabled": true,
+      "mode": "all"
+    }
+  }
+}
+```
+
+**Modes:**
+- `all`: All commands use AskUserQuestion (default)
+- `interactive`: Only interactive commands (babysit, mentor, configure, epic-planner)
+- `none`: Disabled
+
+The guidance is injected via `obtain-context.js` when commands run.
+
 ## Stop Hook Features
 
 Stop hooks run when Claude completes a task or pauses for user input. These enable autonomous workflows.

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

@@ -150,3 +150,28 @@ learnings:
     total_lines: 2009
     source: "packages/cli/src/core/commands/*.md"
     notes: "All files follow consistent documentation template: frontmatter, quick start, purpose, parameters table, examples with explanations, workflow steps, output/files, and related commands"
+
+  - date: 2026-01-09
+    context: "Created IDE Integrations documentation for AgileFlow"
+    insight: "IDE handler system supports 4 IDEs (Claude Code, Cursor, Windsurf, Codex CLI) through plugin architecture. Each IDE has custom config directory (.claude/, .cursor/, .windsurf/, .codex/) and different installation models. Claude Code most advanced (damage control, spawnable agents), Codex CLI unique (per-repo skills, user-level prompts, AGENTS.md instructions)"
+    created_files:
+      - "apps/docs/content/docs/features/ide-integrations.mdx (700+ lines)"
+      - "apps/docs/content/docs/features/index.mdx (updated with IDE section)"
+    total_lines: 700
+    source: "packages/cli/tools/cli/installers/ide/ (_base-ide.js, claude-code.js, cursor.js, windsurf.js, codex.js, manager.js)"
+    coverage:
+      - "IDE overview table with config dirs, types, status"
+      - "Quick start for Claude Code (default IDE)"
+      - "Multi-IDE installation instructions"
+      - "Detailed setup for each IDE with directory structure"
+      - "Command access patterns by IDE"
+      - "Claude Code subagent spawning, damage control hooks"
+      - "Cursor unique features, differences from Claude Code"
+      - "Windsurf workflow management, VSCode integration"
+      - "Codex CLI dual installation model (per-repo skills, user-level prompts, AGENTS.md)"
+      - "Dynamic IDE handler system, extensibility guide"
+      - "Content injection system explanation"
+      - "Troubleshooting guide for common issues"
+      - "Best practices for IDE selection and multi-IDE usage"
+      - "Configuration management and version control"
+    notes: "Comprehensive 700+ line documentation covering all 4 IDEs with detailed setup, command access, and unique features. Includes handler architecture for IDE developers extending with new IDEs."