agileflow 2.92.1 → 2.94.0

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

@@ -1,6 +1,18 @@
 ---
 description: List all Architecture Decision Records
 argument-hint: [STATUS=<status>]
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:adr:list - Lists all ADRs with status and quick actions"
+    - "MUST read docs/03-decisions/ directory for ADR files"
+    - "MUST parse frontmatter for status, date, tags"
+    - "MUST display table sorted by number with status indicators"
+    - "MUST offer actions: view details, create new, update status"
+    - "This is READ-ONLY - no file writes"
+  state_fields:
+    - status_filter
+    - adr_count
 ---
 
 # /agileflow:adr:list
@@ -21,6 +33,14 @@ Shows all ADRs from `docs/03-decisions/` with:
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js adr:list
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 ## Compact Summary
 

package/src/core/commands/adr/update.md

@@ -1,6 +1,21 @@
 ---
 description: Update ADR status or content
-argument-hint: NUMBER=<4-digit> [STATUS=<status>] [REASON=<text>]
+argument-hint: NUMBER=<number> [STATUS=<status>] [REASON=<text>]
+compact_context:
+  priority: high
+  preserve_rules:
+    - "NUMBER is REQUIRED - always ask if missing"
+    - "Every status change MUST have documented reason"
+    - "Show preview of changes before writing (diff-first pattern)"
+    - "If superseded, MUST link to replacement ADR"
+    - "Never delete content - always append amendments"
+    - "Update timestamps in frontmatter when modifying"
+  state_fields:
+    - adr_number
+    - current_status
+    - new_status
+    - reason
+    - superseded_by
 ---
 
 # /agileflow:adr:update
@@ -19,6 +34,14 @@ Allows you to:
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js adr:update
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 ## Compact Summary
 

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

@@ -1,6 +1,20 @@
 ---
 description: View ADR details with contextual actions
-argument-hint: NUMBER=<4-digit>
+argument-hint: NUMBER=<number>
+compact_context:
+  priority: medium
+  preserve_rules:
+    - "ACTIVE COMMAND: /agileflow:adr:view - Views ADR with context-aware actions"
+    - "MUST read ADR file from docs/03-decisions/adr-NUMBER-*.md"
+    - "MUST display full ADR content: context, decision, consequences, links"
+    - "MUST offer CONTEXT-AWARE actions based on ADR status"
+    - "STATUS=proposed → Accept, reject, request changes"
+    - "STATUS=accepted → Create stories, supersede, deprecate"
+    - "STATUS=deprecated/superseded → View history, replacement"
+    - "ALWAYS offer next steps via AskUserQuestion"
+  state_fields:
+    - selected_adr_number
+    - adr_status
 ---
 
 # /agileflow:adr:view
@@ -19,6 +33,14 @@ Displays complete ADR information and offers **context-aware actions** based on
 
 ---
 
+## STEP 0: Gather Context
+
+```bash
+node .agileflow/scripts/obtain-context.js adr:view
+```
+
+---
+
 <!-- COMPACT_SUMMARY_START -->
 ## Compact Summary
 

package/src/core/commands/adr.md

@@ -1,13 +1,13 @@
 ---
 description: Create an Architecture Decision Record
-argument-hint: NUMBER=<4-digit> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> [LINKS=<text>]
+argument-hint: NUMBER=<number> TITLE=<text> CONTEXT=<text> DECISION=<text> CONSEQUENCES=<text> [LINKS=<text>]
 compact_context:
   priority: medium
   preserve_rules:
     - "NUMBER is REQUIRED - must be 4-digit sequentially (0001, 0002, etc.)"
     - "TITLE, CONTEXT, DECISION, CONSEQUENCES all REQUIRED"
     - "Create ADR file in docs/03-decisions/adr-<NUMBER>-<slug>.md"
-    - "Always show preview FIRST, wait for YES/NO confirmation BEFORE writing"
+    - "{{RULES:file_preview}}"
     - "Document BOTH positive and negative consequences"
     - "Keep ADRs concise: 1-2 pages max"
     - "Link related ADRs and stories in Related section"

package/src/core/commands/agent.md

@@ -1,6 +1,6 @@
 ---
 description: Onboard a new agent with profile and contract
-argument-hint: AGENT_ID=<id> ROLE=<role> [TOOLS=<list>] [SCOPE=<dirs>]
+argument-hint: AGENT_ID=<id> ROLE=<text> [TOOLS=<list>] [SCOPE=<list>]
 compact_context:
   priority: high
   preserve_rules:
@@ -225,6 +225,16 @@ Options:
 [AskUserQuestion: "How to proceed?"]
 ```
 
+---
+
+## Related Commands
+
+- `/agileflow:configure` - Manage AgileFlow features and hooks
+- `/agileflow:story` - Create user stories for agents
+- `/agileflow:status` - Update story status and progress
+- `/agileflow:babysit` - Interactive mentor workflow
+- `/agileflow:help` - Display AgileFlow overview
+
 ### Roster File Created
 
 ```

package/src/core/commands/assign.md

@@ -6,12 +6,11 @@ compact_context:
   preserve_rules:
     - "ACTIVE COMMAND: /agileflow:assign - Story assigner and owner changer"
     - "MUST update story frontmatter (owner, status, updated timestamp)"
-    - "MUST update docs/09-agents/status.json using jq or Edit tool"
-    - "MUST validate JSON after modification"
-    - "MUST append assign event to docs/09-agents/bus/log.jsonl"
-    - "MUST use AskUserQuestion for user confirmation (YES/NO format)"
-    - "MUST show diff preview before confirming (diff-first pattern)"
-    - "Status values: ready|in-progress|blocked|in-review|done"
+    - "{{RULES:json_operations}}"
+    - "{{RULES:bus_messaging}}"
+    - "{{RULES:user_confirmation}}"
+    - "{{RULES:file_preview}}"
+    - "{{RULES:status_updates}}"
   state_fields:
     - story_id
     - current_owner
@@ -357,3 +356,13 @@ Files to update:
    New owner: AG-UI
    Notification sent to both agents
 ```
+
+---
+
+## Related Commands
+
+- `/agileflow:status` - Update story status
+- `/agileflow:handoff` - Document work handoff
+- `/agileflow:sprint` - Sprint planning
+- `/agileflow:board` - Kanban board view
+- `/agileflow:story:view` - View story details

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