agileflow 2.99.1 → 2.99.2

package/src/core/commands/help.md

@@ -1,6 +1,6 @@
 ---
 description: Display AgileFlow system overview and commands
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 type: output-only  # Display command - generates output, not an ongoing task
 compact_context:
   priority: medium
@@ -8,69 +8,7 @@ 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: 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
-"
+    - "Include dynamic command list in the output section"
   state_fields:
     - display_mode
 ---
@@ -123,69 +61,7 @@ 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: 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
-
+- Dynamic injection: <!-- {{COMMAND_LIST}} -->
 
 - **Related**: All AgileFlow commands, system documentation
 <!-- COMPACT_SUMMARY_END -->
@@ -213,69 +89,7 @@ Print a concise, one-screen overview:
 - WIP limit: max 2 stories/agent
 - List ALL available commands with one-line examples
 
-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
-
+<!-- {{COMMAND_LIST}} -->
 
 OUTPUT: plain markdown only (no file writes)
 

package/src/core/commands/ideate/history.md

@@ -1,6 +1,6 @@
 ---
 description: Query ideation history and idea status
-argument-hint: [IDEA-XXXX] [STATUS=pending|in-progress|implemented|recurring] [MODE=trends] [COMPARE=report1,report2]
+argument-hint: "[IDEA-XXXX] [STATUS=pending|in-progress|implemented|recurring] [MODE=trends] [COMPARE=report1,report2]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/ideate/new.md

@@ -1,6 +1,6 @@
 ---
 description: Generate categorized improvement ideas using multi-expert analysis
-argument-hint: [SCOPE=all|security|perf|code|ux] [DEPTH=quick|deep|ultradeep] [OUTPUT=report|stories|both] [HISTORY=true|false] [FOCUS=IDEA-XXXX]
+argument-hint: "[SCOPE=all|security|perf|code|ux] [DEPTH=quick|deep|ultradeep] [OUTPUT=report|stories|both] [HISTORY=true|false] [FOCUS=IDEA-XXXX]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/impact.md

@@ -1,6 +1,6 @@
 ---
 description: Analyze change impact across codebase
-argument-hint: [FILES=<paths>] [BASE=<branch>] [RUN_TESTS=true|false]
+argument-hint: "[FILES=<paths>] [BASE=<branch>] [RUN_TESTS=true|false]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/install.md

@@ -1,6 +1,6 @@
 ---
 description: Post-install validation
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/logic/audit.md

@@ -1,6 +1,6 @@
 ---
 description: Multi-agent logic analysis with consensus voting for finding logic bugs
-argument-hint: [file|directory] [DEPTH=quick|deep] [FOCUS=edge|invariant|flow|type|race|all]
+argument-hint: "[file|directory] [DEPTH=quick|deep] [FOCUS=edge|invariant|flow|type|race|all]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/maintain.md

@@ -1,6 +1,6 @@
 ---
 description: Periodic maintenance
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/metrics.md

@@ -1,6 +1,6 @@
 ---
 description: Analytics dashboard with cycle time and throughput
-argument-hint: [TIMEFRAME=7d|30d|90d|all] [EPIC=<EP-ID>] [OWNER=<id>] [FORMAT=ascii|json|csv] [METRIC=cycle-time|lead-time|throughput|all]
+argument-hint: "[TIMEFRAME=7d|30d|90d|all] [EPIC=<EP-ID>] [OWNER=<id>] [FORMAT=ascii|json|csv] [METRIC=cycle-time|lead-time|throughput|all]"
 model: haiku
 type: output-only  # Analytics display - read-only, not an ongoing task
 compact_context:

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

@@ -1,6 +1,6 @@
 ---
 description: Deploy multiple domain experts on the same problem for higher confidence
-argument-hint: <question>
+argument-hint: "<question>"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/packages.md

@@ -1,6 +1,6 @@
 ---
 description: Manage dependencies with updates and security audits
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/pr.md

@@ -1,6 +1,6 @@
 ---
 description: Generate pull request description from story
-argument-hint: STORY=<US-ID> [TITLE=<text>] [TEST_EVIDENCE=<text>]
+argument-hint: "STORY=<US-ID> [TITLE=<text>] [TEST_EVIDENCE=<text>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/readme-sync.md

@@ -1,6 +1,6 @@
 ---
 description: Synchronize a folder's README.md with its current contents
-argument-hint: FOLDER=<path>|all
+argument-hint: "FOLDER=<path>|all"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/research/analyze.md

@@ -1,6 +1,6 @@
 ---
 description: Analyze existing research for implementation in your project
-argument-hint: [FILE=<filename>]
+argument-hint: "[FILE=<filename>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/research/ask.md

@@ -1,6 +1,6 @@
 ---
 description: Generate detailed research prompt for web AI tools (ChatGPT, Perplexity, etc.)
-argument-hint: TOPIC=<text> [DETAILS=<text>] [ERROR=<text>]
+argument-hint: "TOPIC=<text> [DETAILS=<text>] [ERROR=<text>]"
 type: output-only  # This command generates output for user to copy - not an ongoing task
 compact_context:
   priority: critical

package/src/core/commands/research/import.md

@@ -1,6 +1,6 @@
 ---
 description: Import research results and save to research folder
-argument-hint: TOPIC=<text> [CONTENT=<text>] [SOURCE=<url>]
+argument-hint: "TOPIC=<text> [CONTENT=<text>] [SOURCE=<url>]"
 compact_context:
   priority: critical
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Show research notes index
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 type: output-only  # This command displays output - not an ongoing task
 compact_context:
   priority: medium

package/src/core/commands/research/synthesize.md

@@ -1,6 +1,6 @@
 ---
 description: Synthesize insights across multiple research files
-argument-hint: [TOPIC=<text>] [FILES=<list>]
+argument-hint: "[TOPIC=<text>] [FILES=<list>]"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Read a specific research note
-argument-hint: FILE=<filename>
+argument-hint: "FILE=<filename>"
 type: output-only  # This command displays output - not an ongoing task
 compact_context:
   priority: medium

package/src/core/commands/retro.md

@@ -1,6 +1,6 @@
 ---
 description: Generate retrospective with Start/Stop/Continue format
-argument-hint: [TIMEFRAME=sprint|2weeks|30d|90d] [EPIC=<EP-ID>] [FORMAT=ascii|markdown|html] [SAVE=true|false]
+argument-hint: "[TIMEFRAME=sprint|2weeks|30d|90d] [EPIC=<EP-ID>] [FORMAT=ascii|markdown|html] [SAVE=true|false]"
 model: haiku
 compact_context:
   priority: medium

package/src/core/commands/review.md

@@ -1,6 +1,6 @@
 ---
 description: AI-powered code review with quality suggestions
-argument-hint: [BRANCH=<name>] [BASE=<branch>] [FOCUS=all|security|performance|style]
+argument-hint: "[BRANCH=<name>] [BASE=<branch>] [FOCUS=all|security|performance|style]"
 compact_context:
   priority: critical
   preserve_rules:

package/src/core/commands/rlm.md

@@ -1,6 +1,6 @@
 ---
 description: Analyze complex documents using RLM (Recursive Language Models) pattern
-argument-hint: DOCUMENT=<path> QUERY=<text> [MAX_ITERATIONS=<number>] [DEPTH=<number>]
+argument-hint: "DOCUMENT=<path> QUERY=<text> [MAX_ITERATIONS=<number>] [DEPTH=<number>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/roadmap/analyze.md

@@ -1,6 +1,6 @@
 ---
 description: Automated competitor analysis with feature gap identification
-argument-hint: [COMPETITORS=<text>] [FOCUS=all|features|security|perf|ux] [OUTPUT=matrix|report|stories]
+argument-hint: "[COMPETITORS=<text>] [FOCUS=all|features|security|perf|ux] [OUTPUT=matrix|report|stories]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/rpi.md

@@ -1,6 +1,6 @@
 ---
 description: Orchestrate Research-Plan-Implement workflow with explicit phase transitions
-argument-hint: [TASK=<text>] [PHASE=research|plan|implement] [SKIP_RESEARCH=true|false]
+argument-hint: "[TASK=<text>] [PHASE=research|plan|implement] [SKIP_RESEARCH=true|false]"
 compact_context:
   priority: critical
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Interactive session cleanup with AI assessment
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Cleanly end session with optional merge to main
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: View past session history and metrics
-argument-hint: [DAYS=7|30|90|all]
+argument-hint: "[DAYS=7|30|90|all]"
 compact_context:
   priority: medium
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Initialize session harness with test verification
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Create a new parallel session with git worktree
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Pick a session to switch to or resume
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Spawn multiple parallel Claude Code sessions in git worktrees
-argument-hint: [--count N | --branches a,b,c | --from-epic EP-XXX]
+argument-hint: "[--count N | --branches a,b,c | --from-epic EP-XXX]"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: View current session state and activity
-argument-hint: [--kanban]
+argument-hint: "[--kanban]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/skill/create.md

@@ -1,6 +1,6 @@
 ---
 description: Generate a custom skill with web research, cookbook pattern, and MCP integration
-argument-hint: [<name>]
+argument-hint: "[<name>]"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/skill/delete.md

@@ -1,6 +1,6 @@
 ---
 description: Remove an installed skill from .claude/skills/
-argument-hint: [<name>]
+argument-hint: "[<name>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/skill/edit.md

@@ -1,6 +1,6 @@
 ---
 description: Edit an existing skill's SKILL.md, cookbook entries, or references
-argument-hint: [<name>]
+argument-hint: "[<name>]"
 compact_context:
   priority: medium
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: List all installed skills with their descriptions and status
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/skill/test.md

@@ -1,6 +1,6 @@
 ---
 description: Verify a skill works correctly by testing its activation and functionality
-argument-hint: [<name>]
+argument-hint: "[<name>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/skill/upgrade.md

@@ -1,6 +1,6 @@
 ---
 description: Upgrade existing skills with self-improving learning capability
-argument-hint: [<name>]
+argument-hint: "[<name>]"
 compact_context:
   priority: medium
   preserve_rules:

package/src/core/commands/sprint.md

@@ -1,6 +1,6 @@
 ---
 description: Data-driven sprint planning with velocity forecasting
-argument-hint: [SPRINT=<id>] [DURATION=<number>] [AGENTS=<list>] [MODE=suggest|commit] [FOCUS_EPIC=<EP-ID>]
+argument-hint: "[SPRINT=<id>] [DURATION=<number>] [AGENTS=<list>] [MODE=suggest|commit] [FOCUS_EPIC=<EP-ID>]"
 model: haiku
 compact_context:
   priority: critical

package/src/core/commands/status.md

@@ -1,6 +1,6 @@
 ---
 description: Update story status and progress
-argument-hint: STORY=<US-ID> STATUS=<status> [SUMMARY=<text>] [PR=<url>] [TO=<agent-id>]
+argument-hint: "STORY=<US-ID> STATUS=<status> [SUMMARY=<text>] [PR=<url>] [TO=<agent-id>]"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: List all stories with status and filters
-argument-hint: [EPIC=<EP-ID>] [STATUS=<status>] [OWNER=<id>]
+argument-hint: "[EPIC=<EP-ID>] [STATUS=<status>] [OWNER=<id>]"
 compact_context:
   priority: medium
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: View story details with contextual actions
-argument-hint: STORY=<US-ID>
+argument-hint: "STORY=<US-ID>"
 compact_context:
   priority: medium
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: Validate story completeness before development
-argument-hint: STORY=<US-ID>
+argument-hint: "STORY=<US-ID>"
 compact_context:
   priority: high
   preserve_rules:

package/src/core/commands/story.md

@@ -1,6 +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>] [TDD=true]
+argument-hint: "EPIC=<EP-ID> STORY=<US-ID> TITLE=<text> OWNER=<id> [ESTIMATE=<pts>] [AC=<list>] [TDD=true]"
 compact_context:
   priority: high
   preserve_rules:

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

@@ -1,6 +1,6 @@
 ---
 description: List available team templates
-argument-hint: (no arguments)
+argument-hint: "(no arguments)"
 compact_context:
   priority: low
   preserve_rules: