agileflow 2.49.0 → 2.51.0

package/src/core/agents/compliance.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js compliance
+node .agileflow/scripts/obtain-context.js compliance
 ```
 
 ---

package/src/core/agents/configuration/archival.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-archival
+node .agileflow/scripts/obtain-context.js configuration-archival
 ```
 
 ---
@@ -151,7 +151,7 @@ if ! grep -q "archive-completed-stories.sh" .claude/settings.json 2>/dev/null; t
     "matcher": "",
     "hooks": [{
       "type": "command",
-      "command": "bash scripts/archive-completed-stories.sh > /dev/null 2>&1 &"
+      "command": "bash .agileflow/scripts/archive-completed-stories.sh > /dev/null 2>&1 &"
     }]
   }]' .claude/settings.json > .claude/settings.json.tmp && mv .claude/settings.json.tmp .claude/settings.json
 
@@ -233,7 +233,7 @@ AgileFlow automatically manages \`docs/09-agents/status.json\` file size by arch
 
 **Auto-Archival Hook** (runs on SessionStart):
 - Checks \`docs/09-agents/status.json\` size
-- If large enough, runs: \`bash scripts/archive-completed-stories.sh <DAYS>\`
+- If large enough, runs: \`bash .agileflow/scripts/archive-completed-stories.sh <DAYS>\`
 - Moves completed stories older than threshold to status-archive.json
 - Updates status.json with only active + recent stories
 - Runs silently in background (no interruption)
@@ -253,7 +253,7 @@ AgileFlow automatically manages \`docs/09-agents/status.json\` file size by arch
 ### Troubleshooting
 
 **If agents fail with "file too large"**:
-1. Run manual archival: \`bash scripts/archive-completed-stories.sh 7\`
+1. Run manual archival: \`bash .agileflow/scripts/archive-completed-stories.sh 7\`
 2. Reduce threshold in \`docs/00-meta/agileflow-metadata.json\` (e.g., 3 days instead of 30)
 3. Verify auto-archival hook is in \`.claude/settings.json\`
 
@@ -291,8 +291,8 @@ How it works:
 - Full history preserved in docs/09-agents/status-archive.json
 
 Manual archival and compression:
-- Archival: bash scripts/archive-completed-stories.sh (reads from metadata)
-- Archival with custom threshold: bash scripts/archive-completed-stories.sh 7
+- Archival: bash .agileflow/scripts/archive-completed-stories.sh (reads from metadata)
+- Archival with custom threshold: bash .agileflow/scripts/archive-completed-stories.sh 7
 - Compression: /agileflow:compress (strips verbose fields if archival isn't enough)
 - View status: ls -lh docs/09-agents/status*.json
 

package/src/core/agents/configuration/attribution.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-attribution
+node .agileflow/scripts/obtain-context.js configuration-attribution
 ```
 
 ---

package/src/core/agents/configuration/ci.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-ci
+node .agileflow/scripts/obtain-context.js configuration-ci
 ```
 
 ---

package/src/core/agents/configuration/git-config.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-git-config
+node .agileflow/scripts/obtain-context.js configuration-git-config
 ```
 
 ---

package/src/core/agents/configuration/hooks.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-hooks
+node .agileflow/scripts/obtain-context.js configuration-hooks
 ```
 
 ---
@@ -277,7 +277,7 @@ Create `scripts/get-env.js` for dynamic environment variable loading:
 #!/usr/bin/env node
 /**
  * get-env.js - Dynamic environment variable helper for hooks
- * Usage: node scripts/get-env.js VARIABLE_NAME [default_value]
+ * Usage: node .agileflow/scripts/get-env.js VARIABLE_NAME [default_value]
  */
 const fs = require('fs');
 const path = require('path');
@@ -286,7 +286,7 @@ const varName = process.argv[2];
 const defaultValue = process.argv[3] || '';
 
 if (!varName) {
-  console.error('Usage: node scripts/get-env.js VARIABLE_NAME [default_value]');
+  console.error('Usage: node .agileflow/scripts/get-env.js VARIABLE_NAME [default_value]');
   process.exit(1);
 }
 
@@ -340,7 +340,7 @@ if (userSelectedSessionStart) {
     matcher: "",
     hooks: [{
       type: "command",
-      command: "node scripts/agileflow-welcome.js 2>/dev/null || echo 'AgileFlow loaded'"
+      command: "node .agileflow/scripts/agileflow-welcome.js 2>/dev/null || echo 'AgileFlow loaded'"
     }]
   });
 }
@@ -351,7 +351,7 @@ if (userSelectedPreCompact) {
     matcher: "",
     hooks: [{
       type: "command",
-      command: "bash scripts/precompact-context.sh"
+      command: "bash .agileflow/scripts/precompact-context.sh"
     }]
   });
 }
@@ -362,7 +362,7 @@ if (userSelectedStop) {
     matcher: "",
     hooks: [{
       type: "command",
-      command: "bash scripts/agileflow-stop.sh 2>/dev/null"
+      command: "bash .agileflow/scripts/agileflow-stop.sh 2>/dev/null"
     }]
   });
 }
@@ -390,7 +390,7 @@ if (userSelectedUserPromptSubmit) {
         "hooks": [
           {
             "type": "command",
-            "command": "node scripts/agileflow-welcome.js 2>/dev/null || echo 'AgileFlow loaded'"
+            "command": "node .agileflow/scripts/agileflow-welcome.js 2>/dev/null || echo 'AgileFlow loaded'"
           }
         ]
       }
@@ -401,7 +401,7 @@ if (userSelectedUserPromptSubmit) {
         "hooks": [
           {
             "type": "command",
-            "command": "bash scripts/precompact-context.sh"
+            "command": "bash .agileflow/scripts/precompact-context.sh"
           }
         ]
       }
@@ -412,7 +412,7 @@ if (userSelectedUserPromptSubmit) {
         "hooks": [
           {
             "type": "command",
-            "command": "bash scripts/agileflow-stop.sh 2>/dev/null"
+            "command": "bash .agileflow/scripts/agileflow-stop.sh 2>/dev/null"
           }
         ]
       }
@@ -498,21 +498,21 @@ AgileFlow supports event-driven automation through Claude Code's official hooks
 ### Enabled Hooks
 
 {{#if SessionStart}}
-**SessionStart Hook** - `node scripts/agileflow-welcome.js`
+**SessionStart Hook** - `node .agileflow/scripts/agileflow-welcome.js`
 - Displays project status when Claude Code starts
 - Shows active stories, WIP count, git branch
 - Runs archival and session cleanup
 {{/if}}
 
 {{#if PreCompact}}
-**PreCompact Hook** - `bash scripts/precompact-context.sh`
+**PreCompact Hook** - `bash .agileflow/scripts/precompact-context.sh`
 - Preserves project context during conversation compacts
 - Outputs version, branch, active stories, key conventions
 - Preserves active command behavioral rules (e.g., babysit's AskUserQuestion requirement)
 {{/if}}
 
 {{#if Stop}}
-**Stop Hook** - `bash scripts/agileflow-stop.sh`
+**Stop Hook** - `bash .agileflow/scripts/agileflow-stop.sh`
 - Warns about uncommitted changes when Claude stops
 - Shows staged, modified, and untracked file counts
 - Reminds about in-progress stories
@@ -542,7 +542,7 @@ Use `scripts/get-env.js` to load environment variables:
 
 **Use in hooks**:
 \`\`\`bash
-echo "Welcome $(node scripts/get-env.js USER_NAME)!"
+echo "Welcome $(node .agileflow/scripts/get-env.js USER_NAME)!"
 \`\`\`
 ```
 
@@ -575,9 +575,9 @@ Files created:
 ═══════════════════════════════════════════════════════════
 
 Test hooks manually:
-{{#if SessionStart}}  node scripts/agileflow-welcome.js{{/if}}
-{{#if PreCompact}}  bash scripts/precompact-context.sh{{/if}}
-{{#if Stop}}  bash scripts/agileflow-stop.sh{{/if}}
+{{#if SessionStart}}  node .agileflow/scripts/agileflow-welcome.js{{/if}}
+{{#if PreCompact}}  bash .agileflow/scripts/precompact-context.sh{{/if}}
+{{#if Stop}}  bash .agileflow/scripts/agileflow-stop.sh{{/if}}
 ```
 
 ## Verification (Optional)

package/src/core/agents/configuration/precompact.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-precompact
+node .agileflow/scripts/obtain-context.js configuration-precompact
 ```
 
 ---
@@ -178,7 +178,7 @@ Read current `.claude/settings.json` and add PreCompact hook:
         "hooks": [
           {
             "type": "command",
-            "command": "bash scripts/precompact-context.sh"
+            "command": "bash .agileflow/scripts/precompact-context.sh"
           }
         ]
       }
@@ -220,7 +220,7 @@ console.log('Updated metadata with precompact version 2.40.0');
 ### Step 6: Test the Hook
 
 ```bash
-bash scripts/precompact-context.sh
+bash .agileflow/scripts/precompact-context.sh
 ```
 
 Should output project context. Verify it shows:
@@ -284,7 +284,7 @@ What happens now:
 - Your conventions and current work survive summarization
 
 Test it now:
-  bash scripts/precompact-context.sh
+  bash .agileflow/scripts/precompact-context.sh
 
 To trigger a compact manually:
   /compact "Additional focus areas to preserve"

package/src/core/agents/configuration/status-line.md

@@ -14,7 +14,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-status-line
+node .agileflow/scripts/obtain-context.js configuration-status-line
 ```
 
 ---
@@ -272,7 +272,7 @@ The NEW format uses an object:
 {
   "statusLine": {
     "type": "command",
-    "command": "bash scripts/agileflow-statusline.sh",
+    "command": "bash .agileflow/scripts/agileflow-statusline.sh",
     "padding": 0
   }
 }
@@ -281,7 +281,7 @@ The NEW format uses an object:
 The OLD format (invalid) was just a string:
 ```json
 {
-  "statusLine": "bash scripts/agileflow-statusline.sh"
+  "statusLine": "bash .agileflow/scripts/agileflow-statusline.sh"
 }
 ```
 
@@ -304,7 +304,7 @@ Use `jq` to add/update the statusLine field (this will replace old string format
 cp .claude/settings.json .claude/settings.json.backup 2>/dev/null
 
 # Add statusLine configuration (replaces any old format)
-jq '. + {"statusLine": {"type": "command", "command": "bash scripts/agileflow-statusline.sh", "padding": 0}}' .claude/settings.json > .claude/settings.json.tmp && mv .claude/settings.json.tmp .claude/settings.json
+jq '. + {"statusLine": {"type": "command", "command": "bash .agileflow/scripts/agileflow-statusline.sh", "padding": 0}}' .claude/settings.json > .claude/settings.json.tmp && mv .claude/settings.json.tmp .claude/settings.json
 ```
 
 ### Step 6: Update .gitignore
@@ -356,7 +356,7 @@ Edit `scripts/agileflow-statusline.sh` to change what's displayed. The script re
 
 If the status line doesn't appear:
 1. Verify script is executable: `chmod +x scripts/agileflow-statusline.sh`
-2. Test manually: `echo '{"model":{"display_name":"Test"}}' | bash scripts/agileflow-statusline.sh`
+2. Test manually: `echo '{"model":{"display_name":"Test"}}' | bash .agileflow/scripts/agileflow-statusline.sh`
 3. Check `.claude/settings.json` has the statusLine configuration
 4. **Restart Claude Code** (quit completely, wait 5 seconds, restart)
 ```
@@ -405,7 +405,7 @@ echo "$SAMPLE_INPUT" | jq .
 echo ""
 echo "Status line output:"
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-echo "$SAMPLE_INPUT" | bash scripts/agileflow-statusline.sh
+echo "$SAMPLE_INPUT" | bash .agileflow/scripts/agileflow-statusline.sh
 echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
 echo ""
 
@@ -509,16 +509,16 @@ Components can be toggled individually using the configure script:
 
 ```bash
 # List current component status
-node scripts/agileflow-configure.js --components
+node .agileflow/scripts/agileflow-configure.js --components
 
 # Show specific components
-node scripts/agileflow-configure.js --show=agileflow,context,git
+node .agileflow/scripts/agileflow-configure.js --show=agileflow,context,git
 
 # Hide specific components
-node scripts/agileflow-configure.js --hide=model,cost,wip
+node .agileflow/scripts/agileflow-configure.js --hide=model,cost,wip
 
 # Minimal statusline (just branding and context)
-node scripts/agileflow-configure.js --hide=model,story,epic,wip,cost,git
+node .agileflow/scripts/agileflow-configure.js --hide=model,story,epic,wip,cost,git
 ```
 
 Components are stored in `docs/00-meta/agileflow-metadata.json`:

package/src/core/agents/configuration/verify.md

@@ -15,7 +15,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js configuration-verify
+node .agileflow/scripts/obtain-context.js configuration-verify
 ```
 
 ---
@@ -423,7 +423,7 @@ test_get_env() {
   fi
 
   # Test basic functionality
-  TEST_VALUE=$(node scripts/get-env.js USER_NAME "TestUser")
+  TEST_VALUE=$(node .agileflow/scripts/get-env.js USER_NAME "TestUser")
 
   if [ $? -eq 0 ]; then
     echo "✅ get-env.js works (returned: $TEST_VALUE)"

package/src/core/agents/database.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js database
+node .agileflow/scripts/obtain-context.js database
 ```
 
 ---

package/src/core/agents/datamigration.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js datamigration
+node .agileflow/scripts/obtain-context.js datamigration
 ```
 
 ---

package/src/core/agents/design.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js design
+node .agileflow/scripts/obtain-context.js design
 ```
 
 ---

package/src/core/agents/devops.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js devops
+node .agileflow/scripts/obtain-context.js devops
 ```
 
 ---

package/src/core/agents/documentation.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js documentation
+node .agileflow/scripts/obtain-context.js documentation
 ```
 
 ---

package/src/core/agents/epic-planner.md

@@ -8,7 +8,7 @@ model: sonnet
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js epic-planner
+node .agileflow/scripts/obtain-context.js epic-planner
 ```
 
 ---

package/src/core/agents/integrations.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js integrations
+node .agileflow/scripts/obtain-context.js integrations
 ```
 
 ---

package/src/core/agents/mentor.md

@@ -8,7 +8,7 @@ model: sonnet
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js mentor
+node .agileflow/scripts/obtain-context.js mentor
 ```
 
 ---

package/src/core/agents/mobile.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js mobile
+node .agileflow/scripts/obtain-context.js mobile
 ```
 
 ---

package/src/core/agents/monitoring.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js monitoring
+node .agileflow/scripts/obtain-context.js monitoring
 ```
 
 ---

package/src/core/agents/multi-expert.md

@@ -8,7 +8,7 @@ model: sonnet
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js multi-expert
+node .agileflow/scripts/obtain-context.js multi-expert
 ```
 
 ---

package/src/core/agents/performance.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js performance
+node .agileflow/scripts/obtain-context.js performance
 ```
 
 ---

package/src/core/agents/product.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js product
+node .agileflow/scripts/obtain-context.js product
 ```
 
 ---

package/src/core/agents/qa.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js qa
+node .agileflow/scripts/obtain-context.js qa
 ```
 
 ---

package/src/core/agents/readme-updater.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js readme-updater
+node .agileflow/scripts/obtain-context.js readme-updater
 ```
 
 ---

package/src/core/agents/refactor.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js refactor
+node .agileflow/scripts/obtain-context.js refactor
 ```
 
 ---

package/src/core/agents/research.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js research
+node .agileflow/scripts/obtain-context.js research
 ```
 
 ---

package/src/core/agents/security.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js security
+node .agileflow/scripts/obtain-context.js security
 ```
 
 ---

package/src/core/agents/testing.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js testing
+node .agileflow/scripts/obtain-context.js testing
 ```
 
 ---

package/src/core/agents/ui.md

@@ -8,7 +8,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js ui
+node .agileflow/scripts/obtain-context.js ui
 ```
 
 ---

package/src/core/commands/adr.md

@@ -10,7 +10,7 @@ Create a new Architecture Decision Record.
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js adr
+node .agileflow/scripts/obtain-context.js adr
 ```
 
 <!-- COMPACT_SUMMARY_START -->

package/src/core/commands/agent.md

@@ -10,7 +10,7 @@ Onboard a new agent with profile and system prompt.
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js agent
+node .agileflow/scripts/obtain-context.js agent
 ```
 
 <!-- COMPACT_SUMMARY_START -->

package/src/core/commands/assign.md

@@ -10,7 +10,7 @@ Assign or reassign a story to an owner with status update.
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js assign
+node .agileflow/scripts/obtain-context.js assign
 ```
 
 <!-- COMPACT_SUMMARY_START -->

package/src/core/commands/auto.md

@@ -9,7 +9,7 @@ Automatically generate user stories from product artifacts like PRDs, mockups, o
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js auto
+node .agileflow/scripts/obtain-context.js auto
 ```
 
 <!-- COMPACT_SUMMARY_START -->

package/src/core/commands/babysit.md

@@ -27,7 +27,7 @@ End-to-end mentor for implementing features.
 **Before doing ANYTHING else, run the context script to gather all project state in one shot:**
 
 ```bash
-node scripts/obtain-context.js babysit
+node .agileflow/scripts/obtain-context.js babysit
 ```
 
 This single command gathers:
@@ -70,7 +70,7 @@ Keep this section under 150 lines - it contains the critical behavioral rules an
 ### TodoWrite Tracking
 
 **CRITICAL**: Track progress with TodoWrite tool. Typical workflow:
-1. Run context script (`node scripts/obtain-context.js babysit`)
+1. Run context script (`node .agileflow/scripts/obtain-context.js babysit`)
 2. Present suggestions using AskUserQuestion
 3. Read task-specific docs based on user's choice
 4. Plan implementation steps with file paths
@@ -145,7 +145,7 @@ ROLE: Babysitter (Mentor + Orchestrator)
 TODO LIST TRACKING
 **CRITICAL**: Immediately create a todo list using TodoWrite tool to track mentoring workflow:
 ```
-1. Run context script (node scripts/obtain-context.js babysit)
+1. Run context script (node .agileflow/scripts/obtain-context.js babysit)
 2. Present intelligent suggestions using AskUserQuestion
 3. Read task-specific docs (based on what user chooses)
 4. Validate story readiness and architecture context
@@ -173,7 +173,7 @@ GOAL
 **Run the context script IMMEDIATELY - DO NOT SKIP:**
 
 ```bash
-node scripts/obtain-context.js babysit
+node .agileflow/scripts/obtain-context.js babysit
 ```
 
 This single command gathers all essential context:

package/src/core/commands/baseline.md

@@ -10,7 +10,7 @@ Create a verified checkpoint representing a known-good state of the project.
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js baseline
+node .agileflow/scripts/obtain-context.js baseline
 ```
 
 <!-- COMPACT_SUMMARY_START -->

package/src/core/commands/blockers.md

@@ -9,7 +9,7 @@ model: haiku
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js blockers
+node .agileflow/scripts/obtain-context.js blockers
 ```
 
 This gathers git status, stories/epics, session state, and registers for PreCompact.

package/src/core/commands/board.md

@@ -10,7 +10,7 @@ Generate a visual kanban board from current story statuses.
 ## STEP 0: Gather Context
 
 ```bash
-node scripts/obtain-context.js board
+node .agileflow/scripts/obtain-context.js board
 ```
 
 This gathers git status, stories/epics, session state, and registers for PreCompact.