agileflow 2.36.2 → 2.37.0

package/src/core/commands/session/status.md

@@ -5,7 +5,7 @@ argument-hint: (no arguments)
 
 # Session Status
 
-You are running the `/AgileFlow:session:status` command to view a quick snapshot of the current session state, including what you're working on, session duration, uncommitted changes, and test status.
+You are running the `/agileflow:session:status` command to view a quick snapshot of the current session state, including what you're working on, session duration, uncommitted changes, and test status.
 
 ## Command Purpose
 
@@ -25,7 +25,7 @@ Read from `docs/09-agents/session-state.json`:
 if [ ! -f "docs/09-agents/session-state.json" ]; then
   echo "⚠️  No active session"
   echo ""
-  echo "Run /AgileFlow:session:resume to start a session"
+  echo "Run /agileflow:session:resume to start a session"
   exit 0
 fi
 ```
@@ -114,9 +114,9 @@ Command: npm test
 ⚡ Quick Actions
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
-• Run tests: /AgileFlow:verify
-• End session: /AgileFlow:session:end
-• View full context: /AgileFlow:session:resume
+• Run tests: /agileflow:verify
+• End session: /agileflow:session:end
+• View full context: /agileflow:session:resume
 • View story: docs/06-stories/EP-0001/US-0043.md
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
@@ -139,7 +139,7 @@ For a shorter output, show minimal info:
 No session is currently tracked.
 
 To start a session:
-  /AgileFlow:session:resume
+  /agileflow:session:resume
 
 This will:
   • Run environment initialization
@@ -171,7 +171,7 @@ Ready stories (5):
   • US-0047: Add user roles
   • US-0048: Implement audit logging
 
-Assign a story: /AgileFlow:assign STORY=US-0044
+Assign a story: /agileflow:assign STORY=US-0044
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
@@ -196,7 +196,7 @@ Failed tests:
   ❌ auth.test.ts:42 - Session redirect
   ❌ auth.test.ts:67 - Token persistence
 
-Run /AgileFlow:verify to see full output
+Run /agileflow:verify to see full output
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
@@ -215,7 +215,7 @@ Duration: 8h 15m
 Consider:
   • Taking a break
   • Committing your work
-  • Running /AgileFlow:session:end to save progress
+  • Running /agileflow:session:end to save progress
 
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
@@ -224,10 +224,10 @@ Consider:
 
 | Command | Purpose |
 |---------|---------|
-| `/AgileFlow:session:init` | One-time setup of session harness |
-| `/AgileFlow:session:resume` | Start session with full verification |
-| `/AgileFlow:session:end` | Cleanly end session and record summary |
-| `/AgileFlow:session:history` | View past session history and metrics |
+| `/agileflow:session:init` | One-time setup of session harness |
+| `/agileflow:session:resume` | Start session with full verification |
+| `/agileflow:session:end` | Cleanly end session and record summary |
+| `/agileflow:session:history` | View past session history and metrics |
 
 ## Integration Points
 
@@ -237,7 +237,7 @@ Consider:
 - Git status - Uncommitted changes
 
 ### Does NOT
-- Run tests (use `/AgileFlow:verify` for that)
+- Run tests (use `/agileflow:verify` for that)
 - Modify any files
 - Start a new session
 

package/src/core/commands/sprint.md

@@ -451,7 +451,7 @@ Committed: X stories, Y.Z estimated days (Y% of capacity)
 1. Sequence stories: US-0043 (AG-API) → US-0042 (AG-UI) → US-0050 (AG-CI)
 2. Daily standup focus: AG-API unblocking AG-UI (check /blockers)
 3. Mid-sprint checkpoint: Day 5 - assess if US-0055 can be added
-4. End-of-sprint: Run /AgileFlow:velocity to update historical data
+4. End-of-sprint: Run /agileflow:velocity to update historical data
 
 📅 SPRINT TIMELINE
 ------------------
@@ -466,11 +466,11 @@ Definition of Done:
 ✅ Demo prepared for stakeholders
 
 Next Steps:
-${MODE == "suggest" && "1. Review commitment and run /AgileFlow:sprint-plan MODE=commit to finalize"}
+${MODE == "suggest" && "1. Review commitment and run /agileflow:sprint-plan MODE=commit to finalize"}
 ${MODE == "commit" && "1. ✅ Sprint committed! Stories updated in status.json"}
-2. Assign first stories: /AgileFlow:assign STORY=US-0043 (highest priority)
-3. Monitor progress: /AgileFlow:board
-4. Track blockers: /AgileFlow:blockers
+2. Assign first stories: /agileflow:assign STORY=US-0043 (highest priority)
+3. Monitor progress: /agileflow:board
+4. Track blockers: /agileflow:blockers
 ```
 
 RULES

package/src/core/commands/story-validate.md

@@ -1,5 +1,6 @@
 ---
 description: Validate story completeness before development
+argument-hint: STORY=<US-ID>
 ---
 
 # story-validate
@@ -194,7 +195,7 @@ WORKFLOW
 
 1. **Story Selection**:
    - Ask user: "Which story would you like to validate? (provide story ID like US-0001)"
-   - Or: Auto-detect if run with `/AgileFlow:story-validate US-0001`
+   - Or: Auto-detect if run with `/agileflow:story-validate US-0001`
 
 2. **Load Story File**:
    - Find story file: `docs/06-stories/*/{{STORY_ID}}*.md`
@@ -217,7 +218,7 @@ WORKFLOW
    - Determine if story is "ready for development"
 
 5. **Next Steps Recommendation**:
-   - If "ready": "Story is ready for development. Assign to owner with /AgileFlow:assign"
+   - If "ready": "Story is ready for development. Assign to owner with /agileflow:assign"
    - If warnings: "Story has X warnings. Consider addressing before assigning."
    - If failed: "Story needs X critical fixes before development can start"
 
@@ -234,7 +235,7 @@ FIRST ACTION
 
 When invoked:
 1. Ask user: "Which story would you like to validate? (e.g., US-0001)"
-2. Or parse story ID from command: `/AgileFlow:story-validate US-0001`
+2. Or parse story ID from command: `/agileflow:story-validate US-0001`
 3. Load story file
 4. Run all validation checks
 5. Generate comprehensive report

package/src/core/commands/story.md

@@ -1,5 +1,6 @@
 ---
 description: Create a user story with acceptance criteria
+argument-hint: EPIC=<EP-ID> STORY=<US-ID> TITLE=<text> OWNER=<id> [ESTIMATE=<pts>] [AC=<list>]
 ---
 
 # story-new

package/src/core/commands/template.md

@@ -105,7 +105,7 @@ Show all available templates:
 - incident-report.md (created 2025-10-10)
 - sprint-retro.md (created 2025-10-01)
 
-Usage: /AgileFlow:custom-template ACTION=use TYPE=custom NAME=meeting-notes
+Usage: /agileflow:custom-template ACTION=use TYPE=custom NAME=meeting-notes
 ```
 
 ### 2. Create Template
@@ -433,9 +433,9 @@ INTEGRATION
 
 ### Story Creation
 
-When `/AgileFlow:story-new` is called, use story-template.md:
+When `/agileflow:story-new` is called, use story-template.md:
 ```bash
-/AgileFlow:story-new EPIC=EP-0001 STORY=US-0050 TITLE="Login form"
+/agileflow:story-new EPIC=EP-0001 STORY=US-0050 TITLE="Login form"
 # Internally uses docs/00-meta/templates/story-template.md
 ```
 

package/src/core/commands/tests.md

@@ -10,6 +10,21 @@ Automatically set up testing infrastructure for projects without existing tests.
 
 ROLE: Test Infrastructure Bootstrapper
 
+INPUTS
+FRAMEWORK=<name>   jest|mocha|pytest|rspec|go-test|cargo-test (default: auto-detect)
+COVERAGE=yes|no    Enable coverage reporting (default: yes)
+E2E=yes|no         Include E2E tests (default: no)
+
+ACTIONS
+1) Detect language/runtime and framework
+2) Check existing test setup
+3) Install testing framework dependencies
+4) Create test configuration files
+5) Create example tests
+6) Add test scripts to package.json/equivalent
+7) Integrate with CI workflow
+8) Run tests to verify setup
+
 TODO LIST TRACKING
 **CRITICAL**: Immediately create a todo list using TodoWrite tool to track test infrastructure setup:
 ```

package/src/core/commands/update.md

@@ -334,7 +334,7 @@ Suggest adding to CI:
       runs-on: ubuntu-latest
       steps:
         - name: Generate update
-          run: npx claude-code /AgileFlow:stakeholder-update PERIOD=week
+          run: npx claude-code /agileflow:stakeholder-update PERIOD=week
 
         - name: Email stakeholders
           uses: dawidd6/action-send-mail@v3

package/src/core/commands/velocity.md

@@ -203,7 +203,7 @@ Actual: ● ─ ●
 
 3. **Long-term**:
    - Maintain 8-10 points/week sustained velocity
-   - Reserve 20% for tech debt (/AgileFlow:tech-debt command)
+   - Reserve 20% for tech debt (/agileflow:tech-debt command)
    - Keep story sizes ≤1.5d for predictability
 
 ---
@@ -358,7 +358,7 @@ WORKFLOW
 INTEGRATION
 
 - Save velocity history to docs/08-project/velocity/
-- Update /AgileFlow:stakeholder-update with velocity data
+- Update /agileflow:stakeholder-update with velocity data
 - Alert if velocity drops >20% from average
 - Suggest sprint planning capacity based on velocity
 

package/src/core/commands/verify.md

@@ -5,7 +5,25 @@ argument-hint: [story_id] (optional)
 
 # Verify Project Tests
 
-You are running the `/AgileFlow:verify` command to execute project tests and update test status for stories.
+Execute project tests and update test status for stories.
+
+## Prompt
+
+ROLE: Test Verifier
+
+INPUTS
+STORY=<US-ID>   Optional - verify specific story (default: all in_progress stories)
+
+ACTIONS
+1) Run pre-flight checks (session harness initialized)
+2) Load test configuration from environment.json
+3) Execute test command with timeout
+4) Parse test results (exit code + output)
+5) Update status.json with test_status for target stories
+6) Update session-state.json (if exists)
+7) Generate and display verification report
+
+---
 
 ## Command Purpose
 
@@ -34,8 +52,8 @@ Mark each step complete as you finish it. This ensures nothing is forgotten.
 
 ## Usage
 
-- `/AgileFlow:verify` - Run all tests, update all `in_progress` stories
-- `/AgileFlow:verify US-0042` - Run tests and update specific story's test status
+- `/agileflow:verify` - Run all tests, update all `in_progress` stories
+- `/agileflow:verify US-0042` - Run tests and update specific story's test status
 
 ## Execution Flow
 
@@ -46,7 +64,7 @@ Mark each step complete as you finish it. This ensures nothing is forgotten.
 if [ ! -f "docs/00-meta/environment.json" ]; then
   echo "⚠️  Session harness not initialized"
   echo ""
-  echo "Run /AgileFlow:session:init to set up test verification"
+  echo "Run /agileflow:session:init to set up test verification"
   exit 1
 fi
 ```
@@ -212,7 +230,7 @@ Updated stories:
 
 The verify command requires session harness configuration.
 
-Run /AgileFlow:session:init to:
+Run /agileflow:session:init to:
 1. Detect your project type and test command
 2. Create environment.json configuration
 3. Enable test verification for all stories
@@ -247,7 +265,7 @@ Update environment.json if needed.
 
 File docs/09-agents/status.json is invalid or missing.
 
-Run /AgileFlow:setup to initialize AgileFlow structure.
+Run /agileflow:setup to initialize AgileFlow structure.
 ```
 
 ### Specific Story Not Found
@@ -264,8 +282,8 @@ Run without story_id to verify all in_progress stories.
 ## Integration Points
 
 ### Used By
-- `/AgileFlow:session:resume` - Runs verify as part of session startup
-- `/AgileFlow:baseline` - Requires passing tests before creating baseline
+- `/agileflow:session:resume` - Runs verify as part of session startup
+- `/agileflow:baseline` - Requires passing tests before creating baseline
 - Development agents - Should run verify after implementation
 
 ### Uses
@@ -286,4 +304,4 @@ Run without story_id to verify all in_progress stories.
 ## Example Execution
 
 ```
-User: /AgileFlow:verify
+User: /agileflow:verify

package/src/core/skills/agileflow-tech-debt/SKILL.md

@@ -50,8 +50,8 @@ This skill activates when:
    - Include: Problem, Impact, Proposed Solution, Effort, Priority Score, Status
 
 6. **Suggest actions**:
-   - **High priority (>10)**: Create story via `/AgileFlow:story`
-   - **Major refactoring**: Document via `/AgileFlow:adr-new`
+   - **High priority (>10)**: Create story via `/agileflow:story`
+   - **Major refactoring**: Document via `/agileflow:adr-new`
    - **Blocking features**: Update status.json with blocked stories
 
 ## Tech Debt Item Template

package/src/core/templates/README-template.md

@@ -1,7 +1,7 @@
 # {{FOLDER_NAME}}
 
 ## Contents
-<!-- This section is managed by /AgileFlow:readme-sync -->
+<!-- This section is managed by /agileflow:readme-sync -->
 
 ## Overview
 {{OVERVIEW}}

package/src/core/templates/agent-profile-template.md

@@ -41,7 +41,7 @@ WORKFLOW
 3. Create feature branch
 4. Implement to AC with tests
 5. Update status.json and bus/log.jsonl
-6. Prepare PR with /AgileFlow:pr-template
+6. Prepare PR with /agileflow:pr-template
 ```
 
 ## Examples

package/src/core/templates/agileflow-statusline.sh

@@ -0,0 +1,161 @@
+#!/bin/bash
+# AgileFlow Status Line for Claude Code
+# Displays contextual information from status.json and session data
+#
+# This script is called by Claude Code and receives JSON via stdin.
+# Customize this script to change what's displayed in your status line.
+#
+# Available data from stdin JSON:
+#   .model.display_name          - Model name (Opus, Sonnet, etc.)
+#   .cost.total_cost_usd         - Session cost in USD
+#   .context_window.context_window_size - Total context window size
+#   .context_window.current_usage.input_tokens - Current input tokens
+#   .workspace.current_dir       - Current working directory
+
+# Read JSON input from stdin (Claude Code provides this)
+input=$(cat)
+
+# Parse model info
+MODEL_DISPLAY=$(echo "$input" | jq -r '.model.display_name // "Claude"')
+
+# Parse context usage
+CONTEXT_SIZE=$(echo "$input" | jq -r '.context_window.context_window_size // 200000')
+USAGE=$(echo "$input" | jq '.context_window.current_usage // null')
+
+CTX_DISPLAY=""
+if [ "$USAGE" != "null" ]; then
+  CURRENT_TOKENS=$(echo "$USAGE" | jq '.input_tokens + (.cache_creation_input_tokens // 0) + (.cache_read_input_tokens // 0)')
+  if [ "$CURRENT_TOKENS" != "null" ] && [ "$CURRENT_TOKENS" -gt 0 ] 2>/dev/null; then
+    PERCENT_USED=$((CURRENT_TOKENS * 100 / CONTEXT_SIZE))
+    CTX_DISPLAY="${PERCENT_USED}% ctx"
+  fi
+fi
+
+# Parse cost
+TOTAL_COST=$(echo "$input" | jq -r '.cost.total_cost_usd // 0')
+COST_DISPLAY=""
+if [ "$TOTAL_COST" != "0" ] && [ "$TOTAL_COST" != "null" ]; then
+  COST_DISPLAY=$(printf '$%.2f' "$TOTAL_COST")
+fi
+
+# AgileFlow Status - Read from status.json
+STORY_DISPLAY=""
+EPIC_DISPLAY=""
+NEXT_STORY=""
+WIP_DISPLAY=""
+
+if [ -f "docs/09-agents/status.json" ]; then
+  STATUS_JSON=$(cat docs/09-agents/status.json 2>/dev/null)
+
+  # Find first in-progress story and its epic
+  STORY_ID=$(echo "$STATUS_JSON" | jq -r '.stories | to_entries | map(select(.value.status == "in-progress")) | .[0].key // empty')
+
+  if [ -n "$STORY_ID" ] && [ "$STORY_ID" != "null" ]; then
+    STORY_TITLE=$(echo "$STATUS_JSON" | jq -r ".stories[\"$STORY_ID\"].title // \"\"")
+    EPIC_ID=$(echo "$STATUS_JSON" | jq -r ".stories[\"$STORY_ID\"].epic // \"\"")
+
+    if [ -n "$STORY_TITLE" ] && [ "$STORY_TITLE" != "null" ]; then
+      # Truncate title if too long (max 25 chars)
+      if [ ${#STORY_TITLE} -gt 25 ]; then
+        STORY_TITLE="${STORY_TITLE:0:22}..."
+      fi
+      STORY_DISPLAY="${STORY_ID}: ${STORY_TITLE}"
+    fi
+
+    # Get epic progress if we have an epic
+    if [ -n "$EPIC_ID" ] && [ "$EPIC_ID" != "null" ]; then
+      # Count total stories in this epic
+      TOTAL_IN_EPIC=$(echo "$STATUS_JSON" | jq "[.stories | to_entries[] | select(.value.epic == \"$EPIC_ID\")] | length")
+      # Count done stories in this epic
+      DONE_IN_EPIC=$(echo "$STATUS_JSON" | jq "[.stories | to_entries[] | select(.value.epic == \"$EPIC_ID\" and .value.status == \"done\")] | length")
+
+      if [ "$TOTAL_IN_EPIC" -gt 0 ] 2>/dev/null; then
+        EPIC_PCT=$((DONE_IN_EPIC * 100 / TOTAL_IN_EPIC))
+        EPIC_DISPLAY="${EPIC_ID}: ${DONE_IN_EPIC}/${TOTAL_IN_EPIC} (${EPIC_PCT}%)"
+      fi
+    fi
+  else
+    # No story in-progress - find next READY story (priority: high > medium > low)
+    # Look for stories with status "ready" or stories without blockers
+    NEXT_ID=$(echo "$STATUS_JSON" | jq -r '
+      .stories | to_entries
+      | map(select(.value.status == "ready" or .value.status == "backlog" or .value.status == "draft"))
+      | sort_by(
+          if .value.priority == "high" then 0
+          elif .value.priority == "medium" then 1
+          else 2
+          end
+        )
+      | .[0].key // empty
+    ')
+
+    if [ -n "$NEXT_ID" ] && [ "$NEXT_ID" != "null" ]; then
+      NEXT_TITLE=$(echo "$STATUS_JSON" | jq -r ".stories[\"$NEXT_ID\"].title // \"\"")
+      NEXT_PRIORITY=$(echo "$STATUS_JSON" | jq -r ".stories[\"$NEXT_ID\"].priority // \"\"")
+      if [ ${#NEXT_TITLE} -gt 20 ]; then
+        NEXT_TITLE="${NEXT_TITLE:0:17}..."
+      fi
+      # Add priority indicator
+      PRIORITY_ICON=""
+      case "$NEXT_PRIORITY" in
+        high) PRIORITY_ICON="🔴" ;;
+        medium) PRIORITY_ICON="🟡" ;;
+        *) PRIORITY_ICON="🟢" ;;
+      esac
+      NEXT_STORY="${PRIORITY_ICON} Next: ${NEXT_ID}"
+    fi
+  fi
+
+  # Calculate WIP count
+  WIP_COUNT=$(echo "$STATUS_JSON" | jq '[.stories | to_entries[] | select(.value.status == "in-progress" or .value.status == "in-review")] | length')
+  WIP_LIMIT=3  # Default WIP limit
+  if [ -n "$WIP_COUNT" ] && [ "$WIP_COUNT" != "null" ]; then
+    WIP_DISPLAY="WIP: ${WIP_COUNT}/${WIP_LIMIT}"
+  fi
+fi
+
+# Get git branch
+GIT_BRANCH=""
+if git rev-parse --git-dir > /dev/null 2>&1; then
+  BRANCH=$(git branch --show-current 2>/dev/null)
+  if [ -n "$BRANCH" ]; then
+    GIT_BRANCH="$BRANCH"
+  fi
+fi
+
+# Build status line
+OUTPUT="[${MODEL_DISPLAY}]"
+
+# Add current story OR next story suggestion
+if [ -n "$STORY_DISPLAY" ]; then
+  OUTPUT="${OUTPUT} 📋 ${STORY_DISPLAY}"
+elif [ -n "$NEXT_STORY" ]; then
+  OUTPUT="${OUTPUT} ${NEXT_STORY}"
+fi
+
+# Add epic progress (if working on a story in an epic)
+if [ -n "$EPIC_DISPLAY" ]; then
+  OUTPUT="${OUTPUT} | 📦 ${EPIC_DISPLAY}"
+fi
+
+# Add WIP count
+if [ -n "$WIP_DISPLAY" ]; then
+  OUTPUT="${OUTPUT} | ${WIP_DISPLAY}"
+fi
+
+# Add context usage
+if [ -n "$CTX_DISPLAY" ]; then
+  OUTPUT="${OUTPUT} | ${CTX_DISPLAY}"
+fi
+
+# Add cost
+if [ -n "$COST_DISPLAY" ]; then
+  OUTPUT="${OUTPUT} | ${COST_DISPLAY}"
+fi
+
+# Add git branch
+if [ -n "$GIT_BRANCH" ]; then
+  OUTPUT="${OUTPUT} | ${GIT_BRANCH}"
+fi
+
+echo "$OUTPUT"

package/src/core/templates/claude-settings.advanced.example.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo '🚀 AgileFlow v2.19.0 loaded - Type /AgileFlow:help for commands'"
+            "command": "echo '🚀 AgileFlow v2.19.0 loaded - Type /agileflow:help for commands'"
           },
           {
             "type": "command",
@@ -18,7 +18,7 @@
           },
           {
             "type": "command",
-            "command": "if [ -d docs ]; then echo '✅ AgileFlow docs/ structure found'; else echo '⚠️  No docs/ structure - run /AgileFlow:setup-system'; fi"
+            "command": "if [ -d docs ]; then echo '✅ AgileFlow docs/ structure found'; else echo '⚠️  No docs/ structure - run /agileflow:setup-system'; fi"
           }
         ]
       }

package/src/core/templates/claude-settings.example.json

@@ -6,7 +6,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "echo '🚀 AgileFlow v2.19.0 loaded - Use /AgileFlow:help to see available commands'"
+            "command": "echo '🚀 AgileFlow v2.19.0 loaded - Use /agileflow:help to see available commands'"
           }
         ]
       },

package/src/core/templates/resume-session.sh

@@ -1,7 +1,7 @@
 #!/bin/bash
 # AgileFlow Session Resume Script
 # This script is called by the SessionStart hook to automatically resume sessions.
-# It replicates the functionality of /AgileFlow:session:resume as a shell script.
+# It replicates the functionality of /agileflow:session:resume as a shell script.
 
 set -e
 
@@ -11,7 +11,7 @@ echo ""
 # Load environment configuration
 if [ ! -f "docs/00-meta/environment.json" ]; then
   echo "⚠️  Session harness not initialized"
-  echo "   Run /AgileFlow:session:init to set up session management"
+  echo "   Run /agileflow:session:init to set up session management"
   exit 0
 fi
 

package/src/core/templates/worktrees-guide.md

@@ -21,7 +21,7 @@ Git worktrees let you check out multiple branches into separate physical directo
 ```bash
 # You're 2 hours into building a dashboard, Claude has full context
 ~/myapp/
-/AgileFlow:babysit "Build analytics dashboard with charts and filters"
+/agileflow:babysit "Build analytics dashboard with charts and filters"
 
 # URGENT: Production authentication is broken!
 # Create hotfix worktree in 10 seconds
@@ -30,7 +30,7 @@ code ../myapp-hotfix    # Opens in NEW window
 
 # In hotfix window - fresh babysit session
 cd ../myapp-hotfix
-/AgileFlow:babysit "Fix authentication 500 error in src/auth/login.ts"
+/agileflow:babysit "Fix authentication 500 error in src/auth/login.ts"
 
 # Babysit reads CLAUDE.md, understands architecture, fixes bug
 # Creates PR, merges to main
@@ -53,12 +53,12 @@ git worktree remove ../myapp-hotfix
 # Test GraphQL implementation
 git worktree add ../myapp-graphql experiment/graphql-api
 cd ../myapp-graphql
-/AgileFlow:babysit "Implement user API using GraphQL with Apollo Server"
+/agileflow:babysit "Implement user API using GraphQL with Apollo Server"
 
 # Test REST implementation
 git worktree add ../myapp-rest experiment/rest-api
 cd ../myapp-rest
-/AgileFlow:babysit "Implement user API using Express REST endpoints"
+/agileflow:babysit "Implement user API using Express REST endpoints"
 
 # Compare: Performance, DX, bundle size, complexity
 # Merge the winner, delete the loser
@@ -72,12 +72,12 @@ git worktree remove ../myapp-graphql ../myapp-rest
 
 ```bash
 # Keep main work safe
-~/myapp/ → /AgileFlow:babysit "Continue building features on stable codebase"
+~/myapp/ → /agileflow:babysit "Continue building features on stable codebase"
 
 # Test risky migration in isolation
 git worktree add ../myapp-ts-migration experiment/typescript
 cd ../myapp-ts-migration
-/AgileFlow:babysit "Migrate entire codebase from JavaScript to TypeScript"
+/agileflow:babysit "Migrate entire codebase from JavaScript to TypeScript"
 
 # If migration succeeds → merge
 # If it fails catastrophically → delete worktree (no git history pollution)
@@ -97,12 +97,12 @@ AgileFlow's status.json and bus/log.jsonl are **file-based** (docs-as-code philo
 ```bash
 # Worktree 1
 cd ~/myapp-feature-a
-/AgileFlow:babysit "Work on EP-001: User Authentication"
+/agileflow:babysit "Work on EP-001: User Authentication"
 # Updates status.json: US-001 → in-progress
 
 # Worktree 2 (SIMULTANEOUSLY)
 cd ~/myapp-feature-b
-/AgileFlow:babysit "Work on EP-001: User Authentication"
+/agileflow:babysit "Work on EP-001: User Authentication"
 # Updates status.json: US-002 → in-progress
 
 # RESULT: Race condition! One update may be lost! ❌
@@ -112,11 +112,11 @@ cd ~/myapp-feature-b
 ```bash
 # Worktree 1: Epic isolation
 cd ~/myapp-auth
-/AgileFlow:babysit "Work on EP-001: User Authentication"
+/agileflow:babysit "Work on EP-001: User Authentication"
 
 # Worktree 2: DIFFERENT epic
 cd ~/myapp-payment
-/AgileFlow:babysit "Work on EP-002: Payment System"
+/agileflow:babysit "Work on EP-002: Payment System"
 
 # Different epics → different story files → no conflicts ✅
 ```
@@ -147,7 +147,7 @@ code ../myapp-new-feature
 
 # Start babysit
 cd ../myapp-new-feature
-/AgileFlow:babysit
+/agileflow:babysit
 ```
 
 ### Cleaning Up a Worktree

package/tools/cli/commands/config.js

@@ -262,7 +262,7 @@ async function handleSet(directory, status, manifestPath, key, value) {
  */
 function getIdeConfigPath(projectDir, ide) {
   const paths = {
-    'claude-code': '.claude/commands/AgileFlow',
+    'claude-code': '.claude/commands/agileflow',
     'cursor': '.cursor/rules/agileflow',
     'windsurf': '.windsurf/workflows/agileflow',
   };

package/tools/cli/commands/doctor.js

@@ -331,7 +331,7 @@ function compareVersions(a, b) {
  */
 function getIdeConfigPath(projectDir, ide) {
   const paths = {
-    'claude-code': '.claude/commands/AgileFlow',
+    'claude-code': '.claude/commands/agileflow',
     'cursor': '.cursor/rules/agileflow',
     'windsurf': '.windsurf/workflows/agileflow',
   };

package/tools/cli/commands/status.js

@@ -97,7 +97,7 @@ module.exports = {
  */
 function getIdeConfigPath(projectDir, ide) {
   const paths = {
-    'claude-code': '.claude/commands/AgileFlow',
+    'claude-code': '.claude/commands/agileflow',
     'cursor': '.cursor/rules/agileflow',
     'windsurf': '.windsurf/workflows/agileflow',
   };