pi-gsd 1.12.3 → 2.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-gsd",
-	"version": "1.12.3",
+	"version": "2.0.0",
 	"description": "Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven toolkit",
 	"main": "dist/pi-gsd-tools.js",
 	"bin": {
@@ -13,7 +13,11 @@
 		"typecheck": "tsc --noEmit",
 		"check": "tsc --noEmit && npm run build",
 		"postinstall": "node scripts/postinstall.js",
-		"prepublishOnly": "npm run build"
+		"prepublishOnly": "npm run build",
+		"test": "vitest run",
+		"test:unit": "vitest run src/wxp/__tests__ --ignore src/wxp/__tests__/integration.test.ts",
+		"test:integration": "vitest run src/wxp/__tests__/integration.test.ts",
+		"lint": "eslint src/ --ext .ts"
 	},
 	"files": [
 		"dist",
@@ -65,15 +69,19 @@
 		]
 	},
 	"dependencies": {
+		"@oclif/core": "^4.10.5",
 		"@toon-format/toon": "^2.1.0",
-		"commander": "^13.0.0",
 		"jsonpath-plus": "^10.4.0",
 		"zod": "^3.25.76"
 	},
 	"devDependencies": {
 		"@mariozechner/pi-coding-agent": "^0.65.0",
 		"@types/node": "^22.0.0",
+		"@typescript-eslint/eslint-plugin": "^8.58.0",
+		"@typescript-eslint/parser": "^8.58.0",
+		"eslint": "^10.2.0",
 		"tsup": "^8.0.0",
-		"typescript": "^5.0.0"
+		"typescript": "^5.0.0",
+		"vitest": "^4.1.2"
 	}
-}
+}

package/prompts/gsd-add-backlog.md

@@ -1,6 +1,5 @@
 ---
-description: Add an idea to the backlog parking lot (999.x numbering)
+description: Park idea in backlog (999.x). Args: idea (string, greedy)
+arguments: "Usage: /gsd-add-backlog <idea>"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-add-phase.md

@@ -1,6 +1,7 @@
 ---
-description: Add phase to end of current milestone in roadmap
+description: Add phase to end of roadmap. Args: description (string, greedy)
+arguments: "Usage: /gsd-add-phase <description>"
 ---
-<gsd-include path=".pi/gsd/workflows/add-phase.md" />
+<gsd-include path=".pi/gsd/workflows/add-phase.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-add-tests.md

@@ -1,6 +1,7 @@
 ---
-description: Generate tests for a completed phase based on UAT criteria and implementation
+description: Generate tests for a phase. Args: phase (number)
+arguments: "Usage: /gsd-add-tests <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/add-tests.md" />
+<gsd-include path=".pi/gsd/workflows/add-tests.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-add-todo.md

@@ -1,6 +1,7 @@
 ---
-description: Capture idea or task as todo from current conversation context
+description: Capture a todo. Args: text (string, greedy)
+arguments: "Usage: /gsd-add-todo <text>"
 ---
-<gsd-include path=".pi/gsd/workflows/add-todo.md" />
+<gsd-include path=".pi/gsd/workflows/add-todo.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-audit-milestone.md

@@ -1,6 +1,7 @@
 ---
-description: Audit milestone completion against original intent before archiving
+description: Audit milestone before archiving. No required args.
+arguments: "Usage: /gsd-audit-milestone"
 ---
-<gsd-include path=".pi/gsd/workflows/audit-milestone.md" />
+<gsd-include path=".pi/gsd/workflows/audit-milestone.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-audit-uat.md

@@ -1,6 +1,7 @@
 ---
-description: Cross-phase audit of all outstanding UAT and verification items
+description: Cross-phase UAT gap audit. No required args.
+arguments: "Usage: /gsd-audit-uat"
 ---
-<gsd-include path=".pi/gsd/workflows/audit-uat.md" />
+<gsd-include path=".pi/gsd/workflows/audit-uat.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-autonomous.md

@@ -1,7 +1,8 @@
 ---
-description: Run all remaining phases autonomously - discuss→plan→execute per phase
+description: Run all remaining phases. Flags: --from N (start phase), --to N (end phase)
+arguments: "Usage: /gsd-autonomous"
 ---
-<gsd-include path=".pi/gsd/workflows/autonomous.md" />
+<gsd-include path=".pi/gsd/workflows/autonomous.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-check-todos.md

@@ -1,6 +1,7 @@
 ---
-description: List pending todos and select one to work on
+description: List and select a todo to work on. No required args.
+arguments: "Usage: /gsd-check-todos"
 ---
-<gsd-include path=".pi/gsd/workflows/check-todos.md" />
+<gsd-include path=".pi/gsd/workflows/check-todos.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-cleanup.md

@@ -1,6 +1,7 @@
 ---
-description: Archive accumulated phase directories from completed milestones
+description: Archive completed phase directories. No required args.
+arguments: "Usage: /gsd-cleanup"
 ---
-<gsd-include path=".pi/gsd/workflows/cleanup.md" />
+<gsd-include path=".pi/gsd/workflows/cleanup.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-complete-milestone.md

@@ -1,6 +1,5 @@
 ---
-description: Archive completed milestone and prepare for next version
+description: Archive milestone. Args: version (string, e.g. v1.0)
+arguments: "Usage: /gsd-complete-milestone <version>"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-debug.md

@@ -1,6 +1,5 @@
 ---
-description: Systematic debugging with persistent state across context resets
+description: Systematic debugging session. No required args.
+arguments: "Usage: /gsd-debug"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-discuss-phase.md

@@ -1,8 +1,9 @@
 ---
-description: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (the agent picks recommended defaults).
+description: Gather phase context. Args: phase (number) | Flags: --auto
+arguments: "Usage: /gsd-discuss-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/discuss-phase.md" />
-<gsd-include path=".pi/gsd/workflows/discuss-phase-assumptions.md" />
+<gsd-include path=".pi/gsd/workflows/discuss-phase.md" include-arguments />
+<gsd-include path=".pi/gsd/workflows/discuss-phase-assumptions.md" include-arguments />
 <gsd-include path=".pi/gsd/templates/context.md" />
 
 $ARGUMENTS

package/prompts/gsd-do.md

@@ -1,7 +1,8 @@
 ---
-description: Route freeform text to the right GSD command automatically
+description: Auto-route to right command. Args: text (string, greedy)
+arguments: "Usage: /gsd-do <text>"
 ---
-<gsd-include path=".pi/gsd/workflows/do.md" />
+<gsd-include path=".pi/gsd/workflows/do.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-execute-milestone.md

@@ -1,7 +1,8 @@
 ---
-description: Execute all planned phases + full lifecycle (audit→complete→cleanup), scope guardian, UAT gates, worktree isolation
+description: Execute all phases with lifecycle. Flags: --from N, --uat-threshold N (default 80)
+arguments: "Usage: /gsd-execute-milestone"
 ---
-<gsd-include path=".pi/gsd/workflows/execute-milestone.md" />
+<gsd-include path=".pi/gsd/workflows/execute-milestone.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" />
 <gsd-include path=".planning/REQUIREMENTS.md" />
 <gsd-include path=".planning/ROADMAP.md" />

package/prompts/gsd-execute-phase.md

@@ -1,7 +1,8 @@
 ---
-description: Execute all plans in a phase with wave-based parallelization
+description: Execute all plans in a phase. Args: phase (number) | Flags: --auto (skip transition), --wave N (single wave), --interactive
+arguments: "Usage: /gsd-execute-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/execute-phase.md" />
+<gsd-include path=".pi/gsd/workflows/execute-phase.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-fast.md

@@ -1,5 +1,6 @@
 ---
-description: Execute a trivial task inline - no subagents, no planning overhead
+description: Inline task, no subagents. Args: task (string, greedy)
+arguments: "Usage: /gsd-fast <task>"
 ---
 <gsd-include path=".pi/gsd/workflows/fast.md" />
 

package/prompts/gsd-forensics.md

@@ -1,6 +1,7 @@
 ---
-description: Post-mortem investigation for failed GSD workflows - analyzes git history, artifacts, and state to diagnose what went wrong
+description: Post-mortem investigation. No required args.
+arguments: "Usage: /gsd-forensics"
 ---
-<gsd-include path=".pi/gsd/workflows/forensics.md" />
+<gsd-include path=".pi/gsd/workflows/forensics.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-insert-phase.md

@@ -1,6 +1,7 @@
 ---
-description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+description: Insert decimal phase after existing phase. Args: after-phase (number), description (string, greedy)
+arguments: "Usage: /gsd-insert-phase <after-phase> <description>"
 ---
-<gsd-include path=".pi/gsd/workflows/insert-phase.md" />
+<gsd-include path=".pi/gsd/workflows/insert-phase.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-join-discord.md

@@ -1,6 +1,5 @@
 ---
-description: Join the GSD Discord community
+description: Join the GSD Discord community. No required args.
+arguments: "Usage: /gsd-join-discord"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-list-phase-assumptions.md

@@ -1,5 +1,6 @@
 ---
-description: Surface the agent's assumptions about a phase approach before planning
+description: Surface agent assumptions before planning. Args: phase (number)
+arguments: "Usage: /gsd-list-phase-assumptions <phase>"
 ---
 <gsd-include path=".pi/gsd/workflows/list-phase-assumptions.md" />
 

package/prompts/gsd-list-workspaces.md

@@ -1,6 +1,7 @@
 ---
-description: List active GSD workspaces and their status
+description: List active workspaces. No required args.
+arguments: "Usage: /gsd-list-workspaces"
 ---
-<gsd-include path=".pi/gsd/workflows/list-workspaces.md" />
+<gsd-include path=".pi/gsd/workflows/list-workspaces.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-manager.md

@@ -1,6 +1,7 @@
 ---
-description: Interactive command center for managing multiple phases from one terminal
+description: Interactive multi-phase command center. No required args.
+arguments: "Usage: /gsd-manager"
 ---
-<gsd-include path=".pi/gsd/workflows/manager.md" />
+<gsd-include path=".pi/gsd/workflows/manager.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-map-codebase.md

@@ -1,6 +1,7 @@
 ---
-description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+description: Analyze codebase with parallel agents. No required args.
+arguments: "Usage: /gsd-map-codebase"
 ---
-<gsd-include path=".pi/gsd/workflows/map-codebase.md" />
+<gsd-include path=".pi/gsd/workflows/map-codebase.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-milestone-summary.md

@@ -1,6 +1,7 @@
 ---
-description: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
+description: Generate milestone summary. No required args.
+arguments: "Usage: /gsd-milestone-summary"
 ---
-<gsd-include path=".pi/gsd/workflows/milestone-summary.md" />
+<gsd-include path=".pi/gsd/workflows/milestone-summary.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-new-milestone.md

@@ -1,7 +1,8 @@
 ---
-description: Start a new milestone cycle - update PROJECT.md and route to requirements
+description: Start new milestone cycle. Flags: --auto, --skip-research
+arguments: "Usage: /gsd-new-milestone"
 ---
-<gsd-include path=".pi/gsd/workflows/new-milestone.md" />
+<gsd-include path=".pi/gsd/workflows/new-milestone.md" include-arguments />
 <gsd-include path=".pi/gsd/references/questioning.md" />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 <gsd-include path=".pi/gsd/templates/project.md" />

package/prompts/gsd-new-project.md

@@ -1,7 +1,8 @@
 ---
-description: Initialize a new project with deep context gathering and PROJECT.md
+description: Initialize new project. Flags: --auto, --skip-research
+arguments: "Usage: /gsd-new-project"
 ---
-<gsd-include path=".pi/gsd/workflows/new-project.md" />
+<gsd-include path=".pi/gsd/workflows/new-project.md" include-arguments />
 <gsd-include path=".pi/gsd/references/questioning.md" />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 <gsd-include path=".pi/gsd/templates/project.md" />

package/prompts/gsd-new-workspace.md

@@ -1,6 +1,7 @@
 ---
-description: Create an isolated workspace with repo copies and independent .planning/
+description: Create isolated workspace. Args: name (string)
+arguments: "Usage: /gsd-new-workspace <name>"
 ---
-<gsd-include path=".pi/gsd/workflows/new-workspace.md" />
+<gsd-include path=".pi/gsd/workflows/new-workspace.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-note.md

@@ -1,5 +1,6 @@
 ---
-description: Zero-friction idea capture. Append, list, or promote notes to todos.
+description: Capture/list/promote notes. Args: text (greedy) or subcommand
+arguments: "Usage: /gsd-note <text> | /gsd-note list | /gsd-note promote <id>"
 ---
 <gsd-include path=".pi/gsd/workflows/note.md" />
 

package/prompts/gsd-pause-work.md

@@ -1,6 +1,7 @@
 ---
-description: Create context handoff when pausing work mid-phase
+description: Create handoff for pausing work. No required args.
+arguments: "Usage: /gsd-pause-work"
 ---
-<gsd-include path=".pi/gsd/workflows/pause-work.md" />
+<gsd-include path=".pi/gsd/workflows/pause-work.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-plan-milestone-gaps.md

@@ -1,6 +1,7 @@
 ---
-description: Create phases to close all gaps identified by milestone audit
+description: Create phases to close audit gaps. No required args.
+arguments: "Usage: /gsd-plan-milestone-gaps"
 ---
-<gsd-include path=".pi/gsd/workflows/plan-milestone-gaps.md" />
+<gsd-include path=".pi/gsd/workflows/plan-milestone-gaps.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-plan-milestone.md

@@ -1,7 +1,8 @@
 ---
-description: Plan all unplanned phases in the current milestone — one mode question, scope pre-check per phase, context-safe checkpointing
+description: Plan all unplanned phases. Flags: --interactive
+arguments: "Usage: /gsd-plan-milestone"
 ---
-<gsd-include path=".pi/gsd/workflows/plan-milestone.md" />
+<gsd-include path=".pi/gsd/workflows/plan-milestone.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 <gsd-include path=".planning/REQUIREMENTS.md" />
 <gsd-include path=".planning/ROADMAP.md" />

package/prompts/gsd-plan-phase.md

@@ -1,7 +1,8 @@
 ---
-description: Create detailed phase plan (PLAN.md) with verification loop
+description: Plan a phase with research→plan→verify loop. Args: phase (number) | Flags: --auto, --skip-research, --gaps, --text
+arguments: "Usage: /gsd-plan-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/plan-phase.md" />
+<gsd-include path=".pi/gsd/workflows/plan-phase.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" select="tag:core" />
 
 $ARGUMENTS

package/prompts/gsd-plant-seed.md

@@ -1,6 +1,7 @@
 ---
-description: Capture a forward-looking idea with trigger conditions - surfaces automatically at the right milestone
+description: Capture forward-looking idea with trigger. Args: idea (string, greedy)
+arguments: "Usage: /gsd-plant-seed <idea>"
 ---
-<gsd-include path=".pi/gsd/workflows/plant-seed.md" />
+<gsd-include path=".pi/gsd/workflows/plant-seed.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-pr-branch.md

@@ -1,5 +1,6 @@
 ---
-description: Create a clean PR branch by filtering out .planning/ commits - ready for code review
+description: Create clean PR branch. No required args.
+arguments: "Usage: /gsd-pr-branch"
 ---
 <gsd-include path=".pi/gsd/workflows/pr-branch.md" />
 

package/prompts/gsd-profile-user.md

@@ -1,6 +1,7 @@
 ---
-description: Generate developer behavioral profile and create Claude-discoverable artifacts
+description: Generate developer behavioral profile. No required args.
+arguments: "Usage: /gsd-profile-user"
 ---
-<gsd-include path=".pi/gsd/workflows/profile-user.md" />
+<gsd-include path=".pi/gsd/workflows/profile-user.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-quick.md

@@ -1,6 +1,7 @@
 ---
-description: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
+description: Quick tracked task. Args: task (string, greedy) | Flags: --no-commit
+arguments: "Usage: /gsd-quick <task>"
 ---
-<gsd-include path=".pi/gsd/workflows/quick.md" />
+<gsd-include path=".pi/gsd/workflows/quick.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-reapply-patches.md

@@ -1,6 +1,5 @@
 ---
-description: Reapply local modifications after a GSD update
+description: Reapply local mods after GSD update. No required args.
+arguments: "Usage: /gsd-reapply-patches"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-remove-phase.md

@@ -1,6 +1,7 @@
 ---
-description: Remove a future phase from roadmap and renumber subsequent phases
+description: Remove a phase from roadmap. Args: phase (number)
+arguments: "Usage: /gsd-remove-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/remove-phase.md" />
+<gsd-include path=".pi/gsd/workflows/remove-phase.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-remove-workspace.md

@@ -1,6 +1,7 @@
 ---
-description: Remove a GSD workspace and clean up worktrees
+description: Remove workspace. Args: name (string)
+arguments: "Usage: /gsd-remove-workspace <name>"
 ---
-<gsd-include path=".pi/gsd/workflows/remove-workspace.md" />
+<gsd-include path=".pi/gsd/workflows/remove-workspace.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-research-phase.md

@@ -1,6 +1,5 @@
 ---
-description: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
+description: Research phase implementation. Args: phase (number)
+arguments: "Usage: /gsd-research-phase <phase>"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-resume-work.md

@@ -1,6 +1,7 @@
 ---
-description: Resume work from previous session with full context restoration
+description: Restore previous session context. No required args.
+arguments: "Usage: /gsd-resume-work"
 ---
-<gsd-include path=".pi/gsd/workflows/resume-project.md" />
+<gsd-include path=".pi/gsd/workflows/resume-project.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-review-backlog.md

@@ -1,6 +1,5 @@
 ---
-description: Review and promote backlog items to active milestone
+description: Review and promote backlog items. No required args.
+arguments: "Usage: /gsd-review-backlog"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-review.md

@@ -1,6 +1,7 @@
 ---
-description: Request cross-AI peer review of phase plans from external AI CLIs
+description: Cross-AI peer review of phase plan. Args: phase (number)
+arguments: "Usage: /gsd-review <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/review.md" />
+<gsd-include path=".pi/gsd/workflows/review.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-session-report.md

@@ -1,5 +1,6 @@
 ---
-description: Generate a session report with token usage estimates, work summary, and outcomes
+description: Generate session report. No required args.
+arguments: "Usage: /gsd-session-report"
 ---
 <gsd-include path=".pi/gsd/workflows/session-report.md" />
 

package/prompts/gsd-set-profile.md

@@ -1,6 +1,5 @@
 ---
-description: Switch model profile for GSD agents (quality/balanced/budget/inherit)
+description: Set model profile. Args: profile (quality|balanced|budget|inherit)
+arguments: "Usage: /gsd-set-profile <profile>"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-settings.md

@@ -1,6 +1,7 @@
 ---
-description: Configure GSD workflow toggles and model profile
+description: Configure workflow toggles. No required args.
+arguments: "Usage: /gsd-settings"
 ---
-<gsd-include path=".pi/gsd/workflows/settings.md" />
+<gsd-include path=".pi/gsd/workflows/settings.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-ship.md

@@ -1,6 +1,7 @@
 ---
-description: Create PR, run review, and prepare for merge after verification passes
+description: Create PR and prepare for merge. No required args.
+arguments: "Usage: /gsd-ship"
 ---
-<gsd-include path=".pi/gsd/workflows/ship.md" />
+<gsd-include path=".pi/gsd/workflows/ship.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-thread.md

@@ -1,6 +1,5 @@
 ---
-description: Manage persistent context threads for cross-session work
+description: Manage context threads. Subcommands: list, new, switch
+arguments: "Usage: /gsd-thread [list|new <name>|switch <name>]"
 ---
-
-
 $ARGUMENTS

package/prompts/gsd-ui-phase.md

@@ -1,7 +1,8 @@
 ---
-description: Generate UI design contract (UI-SPEC.md) for frontend phases
+description: Generate UI design contract. Args: phase (number)
+arguments: "Usage: /gsd-ui-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/ui-phase.md" />
+<gsd-include path=".pi/gsd/workflows/ui-phase.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-ui-review.md

@@ -1,7 +1,8 @@
 ---
-description: Retroactive 6-pillar visual audit of implemented frontend code
+description: Visual audit of frontend phase. Args: phase (number)
+arguments: "Usage: /gsd-ui-review <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/ui-review.md" />
+<gsd-include path=".pi/gsd/workflows/ui-review.md" include-arguments />
 <gsd-include path=".pi/gsd/references/ui-brand.md" />
 
 $ARGUMENTS

package/prompts/gsd-validate-phase.md

@@ -1,6 +1,7 @@
 ---
-description: Retroactively audit and fill Nyquist validation gaps for a completed phase
+description: Retroactive Nyquist validation. Args: phase (number)
+arguments: "Usage: /gsd-validate-phase <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/validate-phase.md" />
+<gsd-include path=".pi/gsd/workflows/validate-phase.md" include-arguments />
 
 $ARGUMENTS

package/prompts/gsd-verify-work.md

@@ -1,7 +1,8 @@
 ---
-description: Validate built features through conversational UAT
+description: Run UAT for a phase. Args: phase (number) | Flags: --plan N (specific plan only)
+arguments: "Usage: /gsd-verify-work <phase>"
 ---
-<gsd-include path=".pi/gsd/workflows/verify-work.md" />
+<gsd-include path=".pi/gsd/workflows/verify-work.md" include-arguments />
 <gsd-include path=".pi/gsd/templates/UAT.md" />
 
 $ARGUMENTS