agileflow 2.92.0 → 2.93.0

package/src/core/commands/auto.md

@@ -1,6 +1,6 @@
 ---
 description: Auto-generate stories from PRDs, mockups, or specs
-argument-hint: SOURCE=<path|url> [EPIC=<id>] [OWNER=<agent>] [AUTO_CREATE=yes|no]
+argument-hint: SOURCE=<path|url> [EPIC=<EP-ID>] [OWNER=<id>] [AUTO_CREATE=true|false]
 compact_context:
   priority: high
   preserve_rules:
@@ -471,3 +471,13 @@ OUTPUT
 - Story files (multiple)
 - Test stub files (multiple)
 - Updated status.json
+
+---
+
+## Related Commands
+
+- `/agileflow:story` - Create user stories manually
+- `/agileflow:epic` - Create epics
+- `/agileflow:epic-planner` - Plan epic breakdown
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:babysit` - Mentor workflow

package/src/core/commands/babysit.md

@@ -1,15 +1,14 @@
 ---
 description: Interactive mentor for end-to-end feature implementation
-argument-hint: "[EPIC=<id>] [MODE=loop] [MAX=<iterations>] [VISUAL=true] [COVERAGE=<percent>]"
+argument-hint: [EPIC=<EP-ID>] [MODE=loop|once] [MAX=<number>] [VISUAL=true|false] [COVERAGE=<number>]
 compact_context:
   priority: critical
   preserve_rules:
     - "ACTIVE COMMAND: /agileflow-babysit - Mentor mode with expert delegation"
     - "🔔 MANDATORY: Call AskUserQuestion tool at END of EVERY response - especially after completing tasks"
     - "NEVER end with text like 'Done!' or 'What's next?' - ALWAYS use AskUserQuestion tool instead"
-    - "MUST use EnterPlanMode FIRST for ANY non-trivial task (explore codebase, design approach, get approval)"
-    - "MUST delegate complex work to domain experts (don't do everything yourself)"
-    - "Simple task → do yourself | Complex single-domain → spawn expert | Multi-domain → spawn orchestrator"
+    - "{{RULES:plan_mode}}"
+    - "{{RULES:delegation}}"
     - "STUCK DETECTION: If same error 2+ times, suggest /agileflow:research:ask with 200+ line detailed prompt"
     - "Research prompts MUST include: 50+ lines actual code, exact error, what was tried, 3+ specific questions"
     - "STORY CLAIMING: Run 'node .agileflow/scripts/lib/story-claiming.js claim <id>' IMMEDIATELY after user selects story"
@@ -1059,3 +1058,15 @@ Based on your project state:
 3. You approve the plan
 4. I execute (directly or via domain experts)
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:sprint` - Sprint planning with velocity forecasting
+- `/agileflow:board` - Visual kanban board of stories
+- `/agileflow:story` - Create new user stories
+- `/agileflow:epic` - Create new epics
+- `/agileflow:status` - Update story status
+- `/agileflow:blockers` - Track and resolve blockers
+- `/agileflow:research:ask` - Generate research prompts when stuck

package/src/core/commands/baseline.md

@@ -1,6 +1,6 @@
 ---
 description: Mark current state as verified baseline
-argument-hint: [message] (optional)
+argument-hint: [<message>]
 compact_context:
   priority: critical
   preserve_rules:
@@ -657,3 +657,13 @@ Claude: 🧪 Verifying all requirements...
 
         ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:verify` - Run tests and update status
+- `/agileflow:ci` - CI/CD workflow
+- `/agileflow:tests` - Testing infrastructure
+- `/agileflow:changelog` - Generate changelog
+- `/agileflow:pr` - Create pull request

package/src/core/commands/batch.md

@@ -1,6 +1,6 @@
 ---
 description: Process multiple items with functional patterns (map/pmap/filter/reduce)
-argument-hint: <operation> <pattern> [action]
+argument-hint: <operation> <pattern> [<action>]
 compact_context:
   priority: normal
   preserve_rules:
@@ -475,3 +475,13 @@ Future versions may add: coverage, lint, types gates.
 - Works with `/agileflow:babysit` for batch story processing
 - **Loop mode** enables iterative batch processing with quality gates
 - Integrates with agent system for parallel work
+
+---
+
+## Related Commands
+
+- `/agileflow:babysit` - Mentor workflow
+- `/agileflow:story` - Create user stories
+- `/agileflow:tests` - Set up testing infrastructure
+- `/agileflow:verify` - Run tests and verify
+- `/agileflow:sprint` - Sprint planning

package/src/core/commands/blockers.md

@@ -1,6 +1,6 @@
 ---
 description: Track and resolve blockers with actionable suggestions
-argument-hint: "[AGENT=<id>] [SHOW_RESOLVED=true] [DETAILED=true]"
+argument-hint: [AGENT=<id>] [SHOW_RESOLVED=true|false] [DETAILED=true|false]
 model: haiku
 compact_context:
   priority: high
@@ -529,3 +529,13 @@ If yes, suggest:
 - `/story-new` for creating unblocking stories
 - `/handoff` for reassigning capacity-blocked stories
 - `/adr-new` for architectural blockers needing decisions
+
+---
+
+## Related Commands
+
+- `/agileflow:status` - Update story status
+- `/agileflow:board` - Kanban board view
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:handoff` - Document work handoff
+- `/agileflow:deps` - Dependency visualization

package/src/core/commands/board.md

@@ -1,6 +1,6 @@
 ---
 description: Display visual kanban board with WIP limits
-argument-hint: "[EPIC=<id>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]"
+argument-hint: [EPIC=<EP-ID>] [OWNER=<id>] [FORMAT=ascii|markdown|html] [GROUP_BY=status|owner|epic]
 model: haiku
 type: output-only  # Board display - read-only visualization, not an ongoing task
 compact_context:
@@ -430,3 +430,13 @@ OUTPUT
 - Statistics summary
 - Action suggestions
 - Optional: saved snapshot file
+
+---
+
+## Related Commands
+
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:status` - Update story status
+- `/agileflow:blockers` - Track blockers
+- `/agileflow:story:list` - List all stories
+- `/agileflow:epic:view` - View epic details

package/src/core/commands/changelog.md

@@ -1,5 +1,6 @@
 ---
 description: Auto-generate changelog from commit history
+argument-hint: (no arguments)
 compact_context:
   priority: high
   preserve_rules:
@@ -529,6 +530,16 @@ User selected: Changed
 [Continuing with remaining commits...]
 ```
 
+---
+
+## Related Commands
+
+- `/agileflow:docs` - Synchronize documentation with code
+- `/agileflow:update` - Generate stakeholder progress report
+- `/agileflow:pr` - Generate pull request from story
+- `/agileflow:deploy` - Set up deployment pipeline
+- `/agileflow:whats-new` - Show AgileFlow version history
+
 ### Version Suggestion
 
 ```

package/src/core/commands/choose.md

@@ -1,6 +1,6 @@
 ---
 description: AI-directed decision making with structured options
-argument-hint: <decision> [context]
+argument-hint: <decision> [<context>]
 compact_context:
   priority: normal
   preserve_rules:
@@ -8,6 +8,11 @@ compact_context:
     - "AI selects best option based on context"
     - "Always explain selection rationale"
     - "Can delegate to experts for analysis before choosing"
+  state_fields:
+    - decision_question
+    - options_analyzed
+    - selected_option
+    - selection_rationale
 ---
 
 # /agileflow:choose
@@ -335,3 +340,13 @@ Use `/agileflow:choose` for decisions that:
 3. **Be honest about trade-offs**: Every option has downsides
 4. **Document decisions**: Use `/agileflow:adr` for important architectural choices
 5. **Revisit decisions**: Circumstances change; choices may need updating
+
+---
+
+## Related Commands
+
+- `/agileflow:adr` - Create Architecture Decision Records
+- `/agileflow:multi-expert` - Deploy multiple experts for analysis
+- `/agileflow:workflow` - Run parameterized workflows
+- `/agileflow:babysit` - Interactive mentor workflow
+- `/agileflow:rpi` - Research-Plan-Implement workflow

package/src/core/commands/ci.md

@@ -7,7 +7,7 @@ compact_context:
     - "CI setup creates .github/workflows/ci.yml with lint/typecheck/test jobs"
     - "MUST parse OWNERS input (comma-separated GitHub handles or team names)"
     - "MUST create CODEOWNERS file with owner mappings for src/ and docs/03-decisions/"
-    - "ALWAYS show diff-first preview before creating files (YES/NO confirmation required)"
+    - "{{RULES:file_preview}}"
     - "Concurrency control and minimal permissions are required for security"
   state_fields:
     - owners_input
@@ -240,3 +240,13 @@ ACTIONS
 3) Print notes for enabling required checks.
 
 Diff-first; YES/NO.
+
+---
+
+## Related Commands
+
+- `/agileflow:configure` - Manage AgileFlow features and hooks
+- `/agileflow:deploy` - Set up deployment pipeline
+- `/agileflow:tests` - Set up testing infrastructure
+- `/agileflow:verify` - Run tests and verify stories
+- `/agileflow:pr` - Generate pull request from story

package/src/core/commands/configure.md

@@ -7,7 +7,7 @@ compact_context:
     - "ACTIVE COMMAND: /agileflow:configure - Configuration manager for AgileFlow features"
     - "CRITICAL: Max 4 options per AskUserQuestion - use hierarchical menus"
     - "CRITICAL: Run --detect FIRST, handle issues, then show Main Menu"
-    - "Main Menu (4 categories): Profiles | Features | Infrastructure | Maintenance"
+    - "Main Menu (5 categories): Profiles | Features | Sessions | Infrastructure | Maintenance"
     - "Each category has its own sub-menu with max 4 options"
     - "MUST show RED RESTART banner after ANY changes"
   state_fields:
@@ -27,7 +27,7 @@ Configuration management with **hierarchical menus** (4 options max per question
 
 1. **Run detection**: `node .agileflow/scripts/agileflow-configure.js --detect`
 2. **Handle issues**: If ⚠️ INVALID FORMAT → migrate. If 🔄 OUTDATED → upgrade.
-3. **Main menu** (4 categories): Profiles | Features | Infrastructure | Maintenance
+3. **Main menu** (5 categories): Profiles | Features | Sessions | Infrastructure | Maintenance
 4. **Sub-menu**: Based on selection, show category-specific options
 
 ### Menu Flow
@@ -39,6 +39,8 @@ Main Menu → "What would you like to configure?"
 │                   └─ Custom: Save, Export, Import, Delete
 ├─ Features       → Enable | Disable | View status
 │                   └─ Hooks (4) + Other Features (4)
+├─ Sessions       → Default startup mode for new sessions
+│                   └─ Normal | Skip permissions | Accept edits | No Claude
 ├─ Infrastructure → Visual E2E | Damage Control | CI/CD
 └─ Maintenance    → Fix format | Upgrade | Repair | Check status
 ```
@@ -133,6 +135,7 @@ After handling issues (or if none), present the main category menu:
   "options": [
     {"label": "Profiles", "description": "Quick setup with preset configurations (full, basic, minimal)"},
     {"label": "Features", "description": "Enable or disable individual hooks and features"},
+    {"label": "Sessions", "description": "Configure default startup mode for new sessions"},
     {"label": "Infrastructure", "description": "Set up Visual E2E, Damage Control, or CI/CD"},
     {"label": "Maintenance", "description": "Fix issues, repair scripts, or check status"}
   ]
@@ -341,6 +344,63 @@ node .agileflow/scripts/agileflow-configure.js --disable=feature1,feature2
 
 ---
 
+### If "Sessions" selected
+
+Configure default startup mode for new sessions created with `/agileflow:session:new`.
+
+First, read current setting:
+```bash
+cat docs/00-meta/agileflow-metadata.json | grep '"defaultStartupMode"' 2>/dev/null || echo "normal"
+```
+
+Then present options:
+```xml
+<invoke name="AskUserQuestion">
+<parameter name="questions">[{
+  "question": "What should be the default Claude startup mode for new sessions?",
+  "header": "Startup",
+  "multiSelect": false,
+  "options": [
+    {"label": "Normal (Recommended)", "description": "Standard Claude with permission prompts"},
+    {"label": "Skip permissions", "description": "claude --dangerously-skip-permissions (trusted mode)"},
+    {"label": "Accept edits only", "description": "claude --permission-mode acceptEdits"},
+    {"label": "Don't start Claude", "description": "Create worktree only, start Claude manually"}
+  ]
+}]</parameter>
+</invoke>
+```
+
+Map selection to value:
+| Selection | defaultStartupMode value |
+|-----------|--------------------------|
+| Normal | `normal` |
+| Skip permissions | `skip-permissions` |
+| Accept edits only | `accept-edits` |
+| Don't start Claude | `no-claude` |
+
+Update the metadata file:
+```bash
+# Read current metadata
+metadata=$(cat docs/00-meta/agileflow-metadata.json)
+
+# Update defaultStartupMode (using jq if available, or manual edit)
+# The value should be one of: normal, skip-permissions, accept-edits, no-claude
+```
+
+Or use the Edit tool to update `docs/00-meta/agileflow-metadata.json`:
+- Find: `"defaultStartupMode": "..."`
+- Replace with: `"defaultStartupMode": "{selected_value}"`
+
+Display confirmation:
+```
+✅ Default session startup mode set to: {selected_value}
+
+When creating new sessions with /agileflow:session:new, this will be the
+recommended option. You can still choose a different mode per-session.
+```
+
+---
+
 ### If "Infrastructure" selected
 
 ```xml
@@ -834,3 +894,14 @@ Repaired: 1, Errors: 0, Skipped: 18
 | Scripts outdated (feature version differs) | `--upgrade` |
 | Settings format broken | `--migrate` |
 | Major corruption/reinstall needed | `npx agileflow update --force`
+
+---
+
+## Related Commands
+
+- `/agileflow:ci` - Bootstrap CI/CD workflow
+- `/agileflow:deploy` - Set up deployment pipeline
+- `/agileflow:tests` - Set up testing infrastructure
+- `/agileflow:template` - Manage custom templates
+- `/agileflow:diagnose` - System health diagnostics
+- `/agileflow:help` - Display AgileFlow overview

package/src/core/commands/context/export.md

@@ -29,6 +29,14 @@ Reads `docs/context.md` and outputs a condensed excerpt (≤300 lines) ready to
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js context:export
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 
 ## ⚠️ COMPACT SUMMARY - /agileflow:context:export IS ACTIVE

package/src/core/commands/context/full.md

@@ -38,6 +38,14 @@ This file is designed to be pasted into ChatGPT, Perplexity, Gemini, or Claude w
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js context:full
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 
 ## ⚠️ COMPACT SUMMARY - /agileflow:context:full IS ACTIVE

package/src/core/commands/context/note.md

@@ -30,6 +30,14 @@ Quickly add a note to `docs/context.md` under the "Notes" section. Useful for re
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js context:note
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 
 ## ⚠️ COMPACT SUMMARY - /agileflow:context:note IS ACTIVE

package/src/core/commands/debt.md

@@ -1,5 +1,6 @@
 ---
 description: Track and prioritize technical debt items
+argument-hint: (no arguments)
 compact_context:
   priority: medium
   preserve_rules:
@@ -396,3 +397,13 @@ OUTPUT
 - Optional: Stories for top debt items
 - Optional: Trend analysis
 - Recommendations for debt reduction
+
+---
+
+## Related Commands
+
+- `/agileflow:diagnose` - System health diagnostics
+- `/agileflow:review` - AI-powered code review
+- `/agileflow:packages` - Manage dependencies and audits
+- `/agileflow:story` - Create stories for debt items
+- `/agileflow:retro` - Sprint retrospective with debt review

package/src/core/commands/deploy.md

@@ -778,3 +778,13 @@ OUTPUT
 - CI/CD workflow
 - Environment management guide
 - Next steps checklist
+
+---
+
+## Related Commands
+
+- `/agileflow:configure` - Manage AgileFlow features and hooks
+- `/agileflow:ci` - Bootstrap CI/CD workflow
+- `/agileflow:tests` - Set up testing infrastructure
+- `/agileflow:changelog` - Generate changelog for releases
+- `/agileflow:pr` - Generate pull request from story

package/src/core/commands/deps.md

@@ -1,6 +1,6 @@
 ---
 description: Visualize dependency graph with critical path detection
-argument-hint: [SCOPE=story|epic|all] [EPIC=<id>] [STORY=<id>] [FORMAT=ascii|mermaid|graphviz|json] [ANALYSIS=critical-path|circular|blocking|all]
+argument-hint: [SCOPE=story|epic|all] [EPIC=<EP-ID>] [STORY=<US-ID>] [FORMAT=ascii|mermaid|graphviz|json] [ANALYSIS=critical-path|circular|blocking|all]
 model: haiku
 compact_context:
   priority: high
@@ -648,3 +648,13 @@ OUTPUT
 - Blocking story impact analysis
 - Parallel work opportunities
 - Optional: Mermaid/GraphViz export for documentation
+
+---
+
+## Related Commands
+
+- `/agileflow:blockers` - Track blockers
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:board` - Kanban board view
+- `/agileflow:story:view` - View story details
+- `/agileflow:epic:view` - View epic details

package/src/core/commands/diagnose.md

@@ -1,5 +1,6 @@
 ---
 description: System health diagnostics
+argument-hint: (no arguments)
 compact_context:
   priority: high
   preserve_rules:
@@ -391,3 +392,12 @@ Next steps:
 2. Verify installation completed successfully
 3. Re-run diagnostics: /agileflow:diagnose
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:configure` - Manage AgileFlow features
+- `/agileflow:verify` - Run tests and verify
+- `/agileflow:validate-expertise` - Validate expertise files
+- `/agileflow:help` - Display AgileFlow overview

package/src/core/commands/docs.md

@@ -1,6 +1,6 @@
 ---
 description: Synchronize documentation with code changes
-argument-hint: [BRANCH=<name>] [BASE=<branch>] [AUTO_CREATE=yes|no]
+argument-hint: [BRANCH=<name>] [BASE=<branch>] [AUTO_CREATE=true|false]
 compact_context:
   priority: high
   preserve_rules:
@@ -8,7 +8,7 @@ compact_context:
     - "Categorize changes: API, UI, services, config, database"
     - "Generate gap report: missing, outdated, up-to-date docs"
     - "NEVER delete docs without explicit approval"
-    - "ALWAYS use diff-first, YES/NO pattern before writing"
+    - "{{RULES:file_preview}}"
     - "PRESERVE custom content - use managed section markers"
     - "INFER docs from TypeScript types, JSDoc, OpenAPI, tests"
     - "Optional AUTO_CREATE mode auto-generates all missing docs"
@@ -396,3 +396,13 @@ OUTPUT
 - Gap report (markdown)
 - List of actions to take
 - Optional: PR with doc updates (if approved)
+
+---
+
+## Related Commands
+
+- `/agileflow:readme-sync` - Sync folder README with contents
+- `/agileflow:changelog` - Generate changelog from commits
+- `/agileflow:update` - Generate stakeholder progress report
+- `/agileflow:template` - Manage custom templates
+- `/agileflow:pr` - Generate pull request from story

package/src/core/commands/epic/list.md

@@ -1,6 +1,18 @@
 ---
 description: List all epics with status and progress
 argument-hint: [STATUS=<status>]
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:epic:list - Lists all epics with progress tracking"
+    - "MUST read status.json for epic data"
+    - "MUST calculate story progress (completed/total) for each epic"
+    - "MUST display table with status, progress percentage, owner"
+    - "MUST offer actions: view details, add story, create new epic"
+    - "This is READ-ONLY - no file writes"
+  state_fields:
+    - status_filter
+    - epic_count
 ---
 
 # /agileflow:epic:list
@@ -21,6 +33,14 @@ Shows all epics from `docs/09-agents/status.json` with:
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js epic:list
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 ## Compact Summary
 

package/src/core/commands/epic/view.md

@@ -1,6 +1,23 @@
 ---
 description: View epic details with stories and contextual actions
 argument-hint: EPIC=<EP-ID>
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:epic:view - Views epic with all stories and context-aware actions"
+    - "MUST read epic from status.json and load all stories"
+    - "MUST display overview: title, owner, goal, progress bar"
+    - "MUST group stories by status: in_progress, ready, done"
+    - "MUST offer CONTEXT-AWARE actions based on progress"
+    - "Progress <50% → Add stories, start work, plan sprint"
+    - "Progress 50-99% → Work on remaining, view details"
+    - "Progress 100% → Close epic, view summary"
+    - "Status on-hold → Resume, view blockers, close"
+    - "ALWAYS offer next steps via AskUserQuestion"
+  state_fields:
+    - selected_epic_id
+    - epic_progress
+    - epic_status
 ---
 
 # /agileflow:epic:view
@@ -19,6 +36,14 @@ Displays complete epic information and offers **context-aware actions** based on
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js epic:view
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 ## Compact Summary
 

package/src/core/commands/epic.md

@@ -5,13 +5,12 @@ compact_context:
   priority: high
   preserve_rules:
     - "ACTIVE COMMAND: /agileflow:epic-new - Epic creator for feature planning"
-    - "MUST create TodoWrite task list immediately (6 steps: parse, create epic, create stories, merge status, append bus, confirm)"
-    - "MUST show file previews before confirming writes"
-    - "MUST use Edit tool or jq for JSON operations (never echo/cat > status.json)"
-    - "MUST validate JSON after every modification"
-    - "MUST use AskUserQuestion for user confirmation (YES/NO/CANCEL format)"
+    - "{{RULES:todo_tracking}}"
+    - "{{RULES:file_preview}}"
+    - "{{RULES:json_operations}}"
+    - "{{RULES:user_confirmation}}"
     - "STORIES format: 'US-ID|title|owner,US-ID2|title2|owner2' (comma-separated triplets)"
-    - "RESEARCH-FIRST: Validate research exists before creating epic; warn if missing for complex features"
+    - "{{RULES:research_first}}"
   state_fields:
     - epic_id
     - owner

package/src/core/commands/feedback.md

@@ -1,5 +1,6 @@
 ---
 description: Collect and process agent feedback
+argument-hint: (no arguments)
 compact_context:
   priority: medium
   preserve_rules:
@@ -521,3 +522,13 @@ OUTPUT
 - Saved feedback (markdown)
 - Optional: Retrospective summary
 - Optional: Auto-generated improvement stories
+
+---
+
+## Related Commands
+
+- `/agileflow:retro` - Sprint retrospective
+- `/agileflow:status` - Update story status
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:story` - Create improvement stories
+- `/agileflow:metrics` - Analytics and metrics dashboard

package/src/core/commands/handoff.md

@@ -6,8 +6,8 @@ compact_context:
   preserve_rules:
     - "STORY, FROM, TO are REQUIRED - always ask if missing"
     - "Create handoff note from template in docs/09-agents/comms/"
-    - "Append bus log entry with type='handoff' to docs/09-agents/bus/log.jsonl"
-    - "Always show diff/preview FIRST, wait for YES/NO confirmation BEFORE writing"
+    - "{{RULES:bus_messaging}}"
+    - "{{RULES:file_preview}}"
     - "Include SUMMARY (what was done) and BLOCKERS (issues for next agent)"
     - "Use template: @packages/cli/src/core/templates/comms-note-template.md"
   state_fields:
@@ -374,3 +374,13 @@ Check the FROM and TO parameters.
 Usage:
 /agileflow:handoff STORY=US-0042 FROM=AG-API TO=AG-UI SUMMARY="..."
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:assign` - Assign stories to owners
+- `/agileflow:status` - Update story status
+- `/agileflow:blockers` - Track blockers
+- `/agileflow:board` - Kanban board view
+- `/agileflow:sprint` - Sprint planning

package/src/core/commands/help.md

@@ -167,3 +167,13 @@ docs/
 - `/agileflow:diagnose` - System health check
 - `/agileflow:configure` - Setup AgileFlow
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:configure` - Manage AgileFlow features and hooks
+- `/agileflow:diagnose` - System health diagnostics
+- `/agileflow:whats-new` - Show what's new in AgileFlow
+- `/agileflow:board` - Visual kanban board
+- `/agileflow:babysit` - Interactive mentor workflow

package/src/core/commands/ideate.md

@@ -444,3 +444,13 @@ After generating output, present options:
 | OUTPUT | report, stories, both | report | What to generate |
 
 {{argument}}
+
+---
+
+## Related Commands
+
+- `/agileflow:multi-expert` - Deploy multiple experts for analysis
+- `/agileflow:story` - Create user stories from ideas
+- `/agileflow:epic` - Create epic for grouped improvements
+- `/agileflow:review` - AI-powered code review
+- `/agileflow:debt` - Track technical debt items