agileflow 2.94.0 → 2.95.0

package/src/core/commands/deploy.md

@@ -781,6 +781,79 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Deployment Configured
+
+```
+🚀 Deployment Setup
+══════════════════════════════════════════════════════════════
+
+Analyzing project...
+✓ Detected: Next.js application
+✓ Package manager: npm
+✓ Build command: npm run build
+✓ Output: .next/
+
+Platform Recommendation: Vercel (optimal for Next.js)
+
+Creating configuration...
+✓ Created vercel.json
+✓ Created .github/workflows/deploy.yml
+✓ Updated package.json scripts
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Deployment Setup Complete
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Next steps:
+1. Connect GitHub repo to Vercel dashboard
+2. Set environment variables in Vercel
+3. Push to trigger first deployment
+
+Environments:
+- Preview: Automatic on PR
+- Production: On merge to main
+
+Rollback: vercel rollback <deployment-id>
+```
+
+### Success - Multi-Environment
+
+```
+🚀 Deployment Setup (Multi-Environment)
+══════════════════════════════════════════════════════════════
+
+Environments configured:
+┌─────────────┬─────────────────────┬──────────────────┐
+│ Environment │ URL                 │ Trigger          │
+├─────────────┼─────────────────────┼──────────────────┤
+│ Development │ dev.example.com     │ Push to dev/*    │
+│ Staging     │ staging.example.com │ Push to staging  │
+│ Production  │ example.com         │ Push to main     │
+└─────────────┴─────────────────────┴──────────────────┘
+
+✓ All environments configured
+```
+
+### Error - Unsupported Project
+
+```
+❌ Error: Could not detect project type
+
+No supported framework found. Supported:
+- Next.js
+- Remix
+- Vite
+- Create React App
+- Node.js API
+
+Specify manually:
+/agileflow:deploy TYPE=nodejs PLATFORM=railway
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:configure` - Manage AgileFlow features and hooks

package/src/core/commands/deps.md

@@ -651,6 +651,74 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Dependency Graph
+
+```
+📊 Dependency Analysis: EP-0026
+══════════════════════════════════════════════════════════════
+
+Story Dependency Graph:
+
+US-0050 (User registration)
+    ↓
+US-0051 (User login) ←──────┐
+    ↓                       │
+US-0053 (OAuth Google) ─────┤
+    ↓                       │
+US-0056 (Session mgmt) ─────┘
+    ↓
+US-0057 (Dashboard)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🎯 Critical Path:
+US-0050 → US-0051 → US-0053 → US-0056 → US-0057
+Duration: 6.5 days
+
+⚡ Parallel Opportunities:
+- US-0054 (OAuth GitHub) can run parallel to US-0053
+- US-0055 (Rate limiting) has no dependencies
+
+⚠️ Bottleneck: US-0051 (blocks 3 stories)
+   Consider: Add second developer or reduce scope
+```
+
+### Success - Circular Dependency Warning
+
+```
+📊 Dependency Analysis
+══════════════════════════════════════════════════════════════
+
+⚠️ CIRCULAR DEPENDENCY DETECTED:
+
+US-0060 → US-0061 → US-0062 → US-0060
+
+This creates a deadlock. Suggested fix:
+1. Remove dependency: US-0062 → US-0060
+2. Or split US-0060 into two stories
+
+Show resolution options? [Y/n]
+```
+
+### Error - No Dependencies Defined
+
+```
+⚠️ No story dependencies found in EP-0026
+
+Stories exist but no depends_on defined.
+
+Add dependencies:
+/agileflow:story:view US-0050
+# Then edit to add depends_on: ["US-0049"]
+
+Or visualize by owner:
+/agileflow:deps VIEW=by-owner
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:blockers` - Track blockers

package/src/core/commands/docs.md

@@ -399,6 +399,66 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Gap Analysis
+
+```
+📚 Documentation Gap Analysis
+══════════════════════════════════════════════════════════════
+
+Scanning codebase...
+✓ Found 45 exported functions
+✓ Found 12 API endpoints
+✓ Found 8 React components
+
+📊 Coverage Report:
+┌────────────────────┬────────────┬────────────┬───────────┐
+│ Category           │ Documented │ Total      │ Coverage  │
+├────────────────────┼────────────┼────────────┼───────────┤
+│ API Endpoints      │ 10         │ 12         │ 83% 🟡    │
+│ Public Functions   │ 38         │ 45         │ 84% 🟡    │
+│ React Components   │ 8          │ 8          │ 100% 🟢   │
+│ README files       │ 5          │ 8          │ 63% 🔴    │
+└────────────────────┴────────────┴────────────┴───────────┘
+
+🔴 Missing Documentation:
+1. POST /api/orders/bulk - No JSDoc or OpenAPI spec
+2. POST /api/webhooks/stripe - No JSDoc or OpenAPI spec
+3. docs/06-stories/README.md - Folder missing README
+4. docs/07-testing/README.md - Folder missing README
+
+Generate missing docs? [Y/n]
+```
+
+### Success - Docs Updated
+
+```
+📚 Documentation Update
+══════════════════════════════════════════════════════════════
+
+✓ Updated docs/api/orders.md (added bulk endpoint)
+✓ Created docs/06-stories/README.md
+✓ Created docs/07-testing/README.md
+✓ Regenerated docs/api/openapi.yaml
+
+4 files updated.
+Coverage: 63% → 88% (+25%)
+```
+
+### Error - Source Not Found
+
+```
+❌ Error: Source directory not found
+
+Path: src/api/
+
+Please verify project structure or specify source:
+/agileflow:docs SOURCE=lib/
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:readme-sync` - Sync folder README with contents

package/src/core/commands/feedback.md

@@ -525,6 +525,74 @@ OUTPUT
 
 ---
 
+## Expected Output
+
+### Success - Feedback Collected
+
+```
+📝 Feedback Collection
+══════════════════════════════════════════════════════════════
+
+Session: Sprint 12 Review
+Agent: AG-API
+
+Questions:
+1. What went well this sprint?
+   > "Testing workflow improvements saved significant time"
+
+2. What could be improved?
+   > "Better documentation for new patterns"
+
+3. Any blockers or concerns?
+   > "None currently"
+
+4. Rate sprint (1-5): ⭐⭐⭐⭐☆ (4/5)
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Feedback Saved
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Saved to: docs/09-agents/feedback/sprint-12-AG-API.md
+
+Create improvement story for documentation? [Y/n]
+```
+
+### Success - Team Summary
+
+```
+📝 Sprint 12 Feedback Summary
+══════════════════════════════════════════════════════════════
+
+Responses: 5/6 agents (83%)
+Average Rating: 4.2/5
+
+🟢 Top Wins:
+- Testing workflow improvements (3 mentions)
+- Clear acceptance criteria (2 mentions)
+- Good collaboration on US-0050
+
+🟡 Areas for Improvement:
+- Documentation for new patterns (3 mentions)
+- Earlier blocker detection (2 mentions)
+
+📊 Sentiment: Positive
+Trend: ↑ from 3.8 last sprint
+```
+
+### Error - No Active Sprint
+
+```
+❌ Error: No active sprint found
+
+Start a sprint first:
+/agileflow:sprint ACTION=start
+
+Or provide sprint manually:
+/agileflow:feedback SPRINT=12
+```
+
+---
+
 ## Related Commands
 
 - `/agileflow:retro` - Sprint retrospective

package/src/core/commands/help.md

@@ -8,7 +8,69 @@ compact_context:
     - "ACTIVE COMMAND: /agileflow:help - System guide (display-only, no file writes)"
     - "MUST output markdown (never writes files)"
     - "MUST show folder map, concepts, daily workflow, all commands"
-    - "Include dynamic injection: <!-- {{COMMAND_LIST}} -->"
+    - "Include dynamic injection: Available commands (61 total):
+- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
+- `/agileflow:adr-list` - List all Architecture Decision Records
+- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
+- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
+- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
+- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
+- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
+- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
+- `/agileflow:baseline` - Mark current state as verified baseline
+- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
+- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
+- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
+- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
+- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
+- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
+- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
+- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
+- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
+- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
+- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
+- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
+- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
+- `/agileflow:epic-list` - List all epics with status and progress
+- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
+- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
+- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
+- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
+- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
+- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
+- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
+- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
+- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
+- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
+- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
+- `/agileflow:research-list \(no arguments\)` - Show research notes index
+- `/agileflow:research-view FILE=<filename>` - Read a specific research note
+- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
+- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
+- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
+- `/agileflow:session-history` - View past session history and metrics
+- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
+- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
+- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
+- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
+- `/agileflow:session-status` - View current session state and activity
+- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
+- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
+- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
+- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
+- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
+- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
+- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
+- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
+- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
+- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
+- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
+- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
+- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
+- `/agileflow:verify` - Run project tests and update story test status
+- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
+- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
+"
   state_fields:
     - display_mode
 ---
@@ -61,7 +123,69 @@ Output includes:
 - Daily flow: Pick story → Implement to AC → Tests → PR → Update status
 - WIP limit: max 2 stories/agent
 - All available commands with examples
-- Dynamic injection: <!-- {{COMMAND_LIST}} -->
+- Dynamic injection: Available commands (61 total):
+- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
+- `/agileflow:adr-list` - List all Architecture Decision Records
+- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
+- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
+- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
+- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
+- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
+- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
+- `/agileflow:baseline` - Mark current state as verified baseline
+- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
+- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
+- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
+- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
+- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
+- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
+- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
+- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
+- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
+- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
+- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
+- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
+- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
+- `/agileflow:epic-list` - List all epics with status and progress
+- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
+- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
+- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
+- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
+- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
+- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
+- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
+- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
+- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
+- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
+- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
+- `/agileflow:research-list \(no arguments\)` - Show research notes index
+- `/agileflow:research-view FILE=<filename>` - Read a specific research note
+- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
+- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
+- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
+- `/agileflow:session-history` - View past session history and metrics
+- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
+- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
+- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
+- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
+- `/agileflow:session-status` - View current session state and activity
+- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
+- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
+- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
+- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
+- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
+- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
+- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
+- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
+- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
+- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
+- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
+- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
+- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
+- `/agileflow:verify` - Run project tests and update story test status
+- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
+- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
+
 
 - **Related**: All AgileFlow commands, system documentation
 <!-- COMPACT_SUMMARY_END -->
@@ -89,7 +213,69 @@ Print a concise, one-screen overview:
 - WIP limit: max 2 stories/agent
 - List ALL available commands with one-line examples
 
-<!-- {{COMMAND_LIST}} -->
+Available commands (61 total):
+- `/agileflow:adr NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> \[LINKS=<text>\]` - Create an Architecture Decision Record
+- `/agileflow:adr-list` - List all Architecture Decision Records
+- `/agileflow:adr-update NUMBER=<number> \[STATUS=<status>\] \[REASON=<text>\]` - Update ADR status or content
+- `/agileflow:adr-view NUMBER=<number>` - View ADR details with contextual actions
+- `/agileflow:agent AGENT\_ID=<id> ROLE=<text> \[TOOLS=<list>\] \[SCOPE=<list>\]` - Onboard a new agent with profile and contract
+- `/agileflow:assign STORY=<US\-ID> NEW\_OWNER=<id> \[NEW\_STATUS=<status>\] \[NOTE=<text>\]` - Assign or reassign a story to an owner
+- `/agileflow:audit STORY=<US\-ID>` - Audit story completion \- tests \+ acceptance criteria verification \(GSD pattern\)
+- `/agileflow:auto SOURCE=<path\|url> \[EPIC=<EP\-ID>\] \[OWNER=<id>\] \[AUTO\_CREATE=true\|false\]` - Auto\-generate stories from PRDs, mockups, or specs
+- `/agileflow:baseline` - Mark current state as verified baseline
+- `/agileflow:batch <operation> <pattern> \[<action>\]` - Process multiple items with functional patterns \(map/pmap/filter/reduce\)
+- `/agileflow:changelog \(no arguments\)` - Auto\-generate changelog from commit history
+- `/agileflow:choose <decision> \[<context>\]` - AI\-directed decision making with structured options
+- `/agileflow:ci \(no arguments\)` - Bootstrap CI/CD workflow with testing and quality checks
+- `/agileflow:council <question> \[--mode parallel\|debate\] \[--rounds N\]` - Convene AI Council for strategic decisions with three perspectives \(Optimist, Advocate, Analyst\)
+- `/agileflow:compress \(no arguments\)` - Compress status\.json by removing verbose fields and keeping only tracking metadata
+- `/agileflow:context-export \(no arguments\)` - Export concise context excerpt for web AI tools
+- `/agileflow:context-full \(no arguments\)` - Generate/refresh full context brief for web AI tools
+- `/agileflow:context-note NOTE=<text>` - Add timestamped note to context file
+- `/agileflow:debt \(no arguments\)` - Track and prioritize technical debt items
+- `/agileflow:deploy \(no arguments\)` - Set up automated deployment pipeline
+- `/agileflow:diagnose \(no arguments\)` - System health diagnostics
+- `/agileflow:epic EPIC=<EP\-ID> TITLE=<text> OWNER=<id> GOAL=<text> \[STORIES=<list>\] \[RESEARCH=<file>\]` - Create a new epic with stories
+- `/agileflow:epic-list` - List all epics with status and progress
+- `/agileflow:epic-view EPIC=<EP\-ID>` - View epic details with stories and contextual actions
+- `/agileflow:feedback \(no arguments\)` - Collect and process agent feedback
+- `/agileflow:handoff STORY=<US\-ID> FROM=<id> TO=<id> \[SUMMARY=<text>\] \[BLOCKERS=<list>\]` - Document work handoff between agents
+- `/agileflow:help \(no arguments\)` - Display AgileFlow system overview and commands
+- `/agileflow:multi-expert <question>` - Deploy multiple domain experts on the same problem for higher confidence
+- `/agileflow:packages \(no arguments\)` - Manage dependencies with updates and security audits
+- `/agileflow:pr STORY=<US\-ID> \[TITLE=<text>\] \[TEST\_EVIDENCE=<text>\]` - Generate pull request description from story
+- `/agileflow:readme-sync FOLDER=<path>\|all` - Synchronize a folder's README\.md with its current contents
+- `/agileflow:research-analyze` - Analyze existing research for implementation in your project
+- `/agileflow:research-ask TOPIC=<text> \[DETAILS=<text>\] \[ERROR=<text>\]` - Generate detailed research prompt for web AI tools \(ChatGPT, Perplexity, etc\.\)
+- `/agileflow:research-import TOPIC=<text> \[CONTENT=<text>\] \[SOURCE=<url>\]` - Import research results and save to research folder
+- `/agileflow:research-list \(no arguments\)` - Show research notes index
+- `/agileflow:research-view FILE=<filename>` - Read a specific research note
+- `/agileflow:rlm DOCUMENT=<path> QUERY=<text> \[MAX\_ITERATIONS=<number>\] \[DEPTH=<number>\]` - Analyze complex documents using RLM \(Recursive Language Models\) pattern
+- `/agileflow:session-cleanup \(no arguments\)` - Interactive session cleanup with AI assessment
+- `/agileflow:session-end \(no arguments\)` - Cleanly end session with optional merge to main
+- `/agileflow:session-history` - View past session history and metrics
+- `/agileflow:session-init \(no arguments\)` - Initialize session harness with test verification
+- `/agileflow:session-new \(no arguments\)` - Create a new parallel session with git worktree
+- `/agileflow:session-resume \(no arguments\)` - Pick a session to switch to or resume
+- `/agileflow:session-spawn` - Spawn multiple parallel Claude Code sessions in git worktrees
+- `/agileflow:session-status` - View current session state and activity
+- `/agileflow:skill-create` - Generate a custom skill with web research, cookbook pattern, and MCP integration
+- `/agileflow:skill-delete` - Remove an installed skill from \.claude/skills/
+- `/agileflow:skill-edit` - Edit an existing skill's SKILL\.md, cookbook entries, or references
+- `/agileflow:skill-list \(no arguments\)` - List all installed skills with their descriptions and status
+- `/agileflow:skill-test` - Verify a skill works correctly by testing its activation and functionality
+- `/agileflow:skill-upgrade` - Upgrade existing skills with self\-improving learning capability
+- `/agileflow:status STORY=<US\-ID> STATUS=<status> \[SUMMARY=<text>\] \[PR=<url>\] \[TO=<agent\-id>\]` - Update story status and progress
+- `/agileflow:story EPIC=<EP\-ID> STORY=<US\-ID> TITLE=<text> OWNER=<id> \[ESTIMATE=<pts>\] \[AC=<list>\] \[TDD=true\]` - Create a user story with acceptance criteria
+- `/agileflow:story-validate STORY=<US\-ID>` - Validate story completeness before development
+- `/agileflow:story-view STORY=<US\-ID>` - View story details with contextual actions
+- `/agileflow:template ACTION=create\|edit\|list\|use \[TYPE=story\|epic\|adr\|custom\] \[NAME=<name>\]` - Create and manage custom document templates
+- `/agileflow:tests \(no arguments\)` - Set up automated testing infrastructure
+- `/agileflow:validate-expertise` - Validate expertise files for drift and staleness
+- `/agileflow:verify` - Run project tests and update story test status
+- `/agileflow:whats-new \(no arguments\)` - Show what's new in AgileFlow
+- `/agileflow:workflow <template> \[<arguments>\]` - Define and run parameterized workflow templates
+
 
 OUTPUT: plain markdown only (no file writes)