gsd-antigravity-kit 1.30.1 → 1.32.1

package/.agent/skills/gsd/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: gsd
-version: 1.32.0
+version: 1.34.2
 description: "Antigravity GSD (Get Stuff Done) - A spec-driven hierarchical planning and execution system. Triggers on project planning, phase management, and GSD slash commands."
 ---
 
@@ -21,67 +21,75 @@ This skill should be used when:
 **Triggers:**
 - Keywords: "plan phase", "execute phase", "new project spec", "gsd", "gsd-tools"
 - Commands: 
-- `gsd:gsd-add-backlog`
-- `gsd:gsd-add-phase`
-- `gsd:gsd-add-tests`
-- `gsd:gsd-add-todo`
-- `gsd:gsd-analyze-dependencies`
-- `gsd:gsd-audit-milestone`
-- `gsd:gsd-audit-uat`
-- `gsd:gsd-autonomous`
-- `gsd:gsd-check-todos`
-- `gsd:gsd-cleanup`
-- `gsd:gsd-complete-milestone`
-- `gsd:gsd-debug`
-- `gsd:gsd-discuss-phase`
-- `gsd:gsd-do`
-- `gsd:gsd-docs-update`
-- `gsd:gsd-execute-phase`
-- `gsd:gsd-fast`
-- `gsd:gsd-forensics`
-- `gsd:gsd-health`
-- `gsd:gsd-help`
-- `gsd:gsd-insert-phase`
-- `gsd:gsd-join-discord`
-- `gsd:gsd-list-phase-assumptions`
-- `gsd:gsd-list-workspaces`
-- `gsd:gsd-manager`
-- `gsd:gsd-map-codebase`
-- `gsd:gsd-milestone-summary`
-- `gsd:gsd-new-milestone`
-- `gsd:gsd-new-project`
-- `gsd:gsd-new-workspace`
-- `gsd:gsd-next`
-- `gsd:gsd-note`
-- `gsd:gsd-pause-work`
-- `gsd:gsd-plan-milestone-gaps`
-- `gsd:gsd-plan-phase`
-- `gsd:gsd-plant-seed`
-- `gsd:gsd-pr-branch`
-- `gsd:gsd-profile-user`
-- `gsd:gsd-progress`
-- `gsd:gsd-quick`
-- `gsd:gsd-reapply-patches`
-- `gsd:gsd-remove-phase`
-- `gsd:gsd-remove-workspace`
-- `gsd:gsd-research-phase`
-- `gsd:gsd-resume-work`
-- `gsd:gsd-review-backlog`
-- `gsd:gsd-review`
-- `gsd:gsd-secure-phase`
-- `gsd:gsd-session-report`
-- `gsd:gsd-set-profile`
-- `gsd:gsd-settings`
-- `gsd:gsd-ship`
-- `gsd:gsd-stats`
-- `gsd:gsd-thread`
+- `gsd:add-backlog`
+- `gsd:add-phase`
+- `gsd:add-tests`
+- `gsd:add-todo`
+- `gsd:analyze-dependencies`
+- `gsd:audit-fix`
+- `gsd:audit-milestone`
+- `gsd:audit-uat`
+- `gsd:autonomous`
+- `gsd:check-todos`
+- `gsd:cleanup`
+- `gsd:code-review`
+- `gsd:code-review-fix`
+- `gsd:complete-milestone`
+- `gsd:debug`
+- `gsd:discuss-phase`
+- `gsd:do`
+- `gsd:docs-update`
+- `gsd:execute-phase`
+- `gsd:explore`
+- `gsd:fast`
+- `gsd:forensics`
 - `gsd:gsd-tools`
-- `gsd:gsd-ui-phase`
-- `gsd:gsd-ui-review`
-- `gsd:gsd-update`
-- `gsd:gsd-validate-phase`
-- `gsd:gsd-verify-work`
-- `gsd:gsd-workstreams`
+- `gsd:health`
+- `gsd:help`
+- `gsd:import`
+- `gsd:insert-phase`
+- `gsd:intel`
+- `gsd:join-discord`
+- `gsd:list-phase-assumptions`
+- `gsd:list-workspaces`
+- `gsd:manager`
+- `gsd:map-codebase`
+- `gsd:milestone-summary`
+- `gsd:new-milestone`
+- `gsd:new-project`
+- `gsd:new-workspace`
+- `gsd:next`
+- `gsd:note`
+- `gsd:pause-work`
+- `gsd:plan-milestone-gaps`
+- `gsd:plan-phase`
+- `gsd:plant-seed`
+- `gsd:pr-branch`
+- `gsd:profile-user`
+- `gsd:progress`
+- `gsd:quick`
+- `gsd:reapply-patches`
+- `gsd:remove-phase`
+- `gsd:remove-workspace`
+- `gsd:research-phase`
+- `gsd:resume-work`
+- `gsd:review`
+- `gsd:review-backlog`
+- `gsd:scan`
+- `gsd:secure-phase`
+- `gsd:session-report`
+- `gsd:set-profile`
+- `gsd:settings`
+- `gsd:ship`
+- `gsd:stats`
+- `gsd:thread`
+- `gsd:ui-phase`
+- `gsd:ui-review`
+- `gsd:undo`
+- `gsd:update`
+- `gsd:validate-phase`
+- `gsd:verify-work`
+- `gsd:workstreams`
 
 ## System Overview
 
@@ -94,67 +102,88 @@ The system enforces distinct phases. You typically cannot execute until you have
 ### 2. Available Commands
 The following slash commands are available in this skill. Use them to drive the GSD process:
 
-- **[`gsd:gsd-add-backlog`](references/commands/gsd-add-backlog.md)**: Add an idea to the backlog parking lot (999.x numbering)
-- **[`gsd:gsd-add-phase`](references/commands/gsd-add-phase.md)**: Add phase to end of current milestone in roadmap
-- **[`gsd:gsd-add-tests`](references/commands/gsd-add-tests.md)**: Generate tests for a completed phase based on UAT criteria and implementation
-- **[`gsd:gsd-add-todo`](references/commands/gsd-add-todo.md)**: Capture idea or task as todo from current conversation context
-- **[`gsd:gsd-analyze-dependencies`](references/commands/gsd-analyze-dependencies.md)**: Analyze phase dependencies and suggest Depends on entries for ROADMAP.md
-- **[`gsd:gsd-audit-milestone`](references/commands/gsd-audit-milestone.md)**: Audit milestone completion against original intent before archiving
-- **[`gsd:gsd-audit-uat`](references/commands/gsd-audit-uat.md)**: Cross-phase audit of all outstanding UAT and verification items
-- **[`gsd:gsd-autonomous`](references/commands/gsd-autonomous.md)**: Run all remaining phases autonomously — discuss→plan→execute per phase
-- **[`gsd:gsd-check-todos`](references/commands/gsd-check-todos.md)**: List pending todos and select one to work on
-- **[`gsd:gsd-cleanup`](references/commands/gsd-cleanup.md)**: Archive accumulated phase directories from completed milestones
-- **[`gsd:gsd-complete-milestone`](references/commands/gsd-complete-milestone.md)**: Archive completed milestone and prepare for next version
-- **[`gsd:gsd-debug`](references/commands/gsd-debug.md)**: Systematic debugging with persistent state across context resets
-- **[`gsd:gsd-discuss-phase`](references/commands/gsd-discuss-phase.md)**: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Antigravity picks recommended defaults). Use --chain for interactive discuss followed by automatic plan+execute. Use --power for bulk question generation into a file-based UI (answer at your own pace).
-- **[`gsd:gsd-do`](references/commands/gsd-do.md)**: Route freeform text to the right GSD command automatically
-- **[`gsd:gsd-docs-update`](references/commands/gsd-docs-update.md)**: Generate or update project documentation verified against the codebase
-- **[`gsd:gsd-execute-phase`](references/commands/gsd-execute-phase.md)**: Execute all plans in a phase with wave-based parallelization
-- **[`gsd:gsd-fast`](references/commands/gsd-fast.md)**: Execute a trivial task inline — no subagents, no planning overhead
-- **[`gsd:gsd-forensics`](references/commands/gsd-forensics.md)**: Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
-- **[`gsd:gsd-health`](references/commands/gsd-health.md)**: Diagnose planning directory health and optionally repair issues
-- **[`gsd:gsd-help`](references/commands/gsd-help.md)**: Show available GSD commands and usage guide
-- **[`gsd:gsd-insert-phase`](references/commands/gsd-insert-phase.md)**: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
-- **[`gsd:gsd-join-discord`](references/commands/gsd-join-discord.md)**: Join the GSD Discord community
-- **[`gsd:gsd-list-phase-assumptions`](references/commands/gsd-list-phase-assumptions.md)**: Surface Antigravity's assumptions about a phase approach before planning
-- **[`gsd:gsd-list-workspaces`](references/commands/gsd-list-workspaces.md)**: List active GSD workspaces and their status
-- **[`gsd:gsd-manager`](references/commands/gsd-manager.md)**: Interactive command center for managing multiple phases from one terminal
-- **[`gsd:gsd-map-codebase`](references/commands/gsd-map-codebase.md)**: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
-- **[`gsd:gsd-milestone-summary`](references/commands/gsd-milestone-summary.md)**: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
-- **[`gsd:gsd-new-milestone`](references/commands/gsd-new-milestone.md)**: Start a new milestone cycle — update PROJECT.md and route to requirements
-- **[`gsd:gsd-new-project`](references/commands/gsd-new-project.md)**: Initialize a new project with deep context gathering and PROJECT.md
-- **[`gsd:gsd-new-workspace`](references/commands/gsd-new-workspace.md)**: Create an isolated workspace with repo copies and independent .planning/
-- **[`gsd:gsd-next`](references/commands/gsd-next.md)**: Automatically advance to the next logical step in the GSD workflow
-- **[`gsd:gsd-note`](references/commands/gsd-note.md)**: Zero-friction idea capture. Append, list, or promote notes to todos.
-- **[`gsd:gsd-pause-work`](references/commands/gsd-pause-work.md)**: Create context handoff when pausing work mid-phase
-- **[`gsd:gsd-plan-milestone-gaps`](references/commands/gsd-plan-milestone-gaps.md)**: Create phases to close all gaps identified by milestone audit
-- **[`gsd:gsd-plan-phase`](references/commands/gsd-plan-phase.md)**: Create detailed phase plan (PLAN.md) with verification loop
-- **[`gsd:gsd-plant-seed`](references/commands/gsd-plant-seed.md)**: Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
-- **[`gsd:gsd-pr-branch`](references/commands/gsd-pr-branch.md)**: Create a clean PR branch by filtering out .planning/ commits — ready for code review
-- **[`gsd:gsd-profile-user`](references/commands/gsd-profile-user.md)**: Generate developer behavioral profile and create Antigravity-discoverable artifacts
-- **[`gsd:gsd-progress`](references/commands/gsd-progress.md)**: Check project progress, show context, and route to next action (execute or plan)
-- **[`gsd:gsd-quick`](references/commands/gsd-quick.md)**: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
-- **[`gsd:gsd-reapply-patches`](references/commands/gsd-reapply-patches.md)**: Reapply local modifications after a GSD update
-- **[`gsd:gsd-remove-phase`](references/commands/gsd-remove-phase.md)**: Remove a future phase from roadmap and renumber subsequent phases
-- **[`gsd:gsd-remove-workspace`](references/commands/gsd-remove-workspace.md)**: Remove a GSD workspace and clean up worktrees
-- **[`gsd:gsd-research-phase`](references/commands/gsd-research-phase.md)**: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
-- **[`gsd:gsd-resume-work`](references/commands/gsd-resume-work.md)**: Resume work from previous session with full context restoration
-- **[`gsd:gsd-review-backlog`](references/commands/gsd-review-backlog.md)**: Review and promote backlog items to active milestone
-- **[`gsd:gsd-review`](references/commands/gsd-review.md)**: Request cross-AI peer review of phase plans from external AI CLIs
-- **[`gsd:gsd-secure-phase`](references/commands/gsd-secure-phase.md)**: Retroactively verify threat mitigations for a completed phase
-- **[`gsd:gsd-session-report`](references/commands/gsd-session-report.md)**: Generate a session report with token usage estimates, work summary, and outcomes
-- **[`gsd:gsd-set-profile`](references/commands/gsd-set-profile.md)**: Switch model profile for GSD agents (quality/balanced/budget/inherit)
-- **[`gsd:gsd-settings`](references/commands/gsd-settings.md)**: Configure GSD workflow toggles and model profile
-- **[`gsd:gsd-ship`](references/commands/gsd-ship.md)**: Create PR, run review, and prepare for merge after verification passes
-- **[`gsd:gsd-stats`](references/commands/gsd-stats.md)**: Display project statistics — phases, plans, requirements, git metrics, and timeline
-- **[`gsd:gsd-thread`](references/commands/gsd-thread.md)**: Manage persistent context threads for cross-session work
-- **[`gsd:gsd-tools`](references/commands/gsd-tools.md)**: Direct access to GSD internal CLI tools for atomic operations (state, roadmap, phase, config, etc.)
-- **[`gsd:gsd-ui-phase`](references/commands/gsd-ui-phase.md)**: Generate UI design contract (UI-SPEC.md) for frontend phases
-- **[`gsd:gsd-ui-review`](references/commands/gsd-ui-review.md)**: Retroactive 6-pillar visual audit of implemented frontend code
-- **[`gsd:gsd-update`](references/commands/gsd-update.md)**: Update GSD to latest version with changelog display
-- **[`gsd:gsd-validate-phase`](references/commands/gsd-validate-phase.md)**: Retroactively audit and fill Nyquist validation gaps for a completed phase
-- **[`gsd:gsd-verify-work`](references/commands/gsd-verify-work.md)**: Validate built features through conversational UAT
-- **[`gsd:gsd-workstreams`](references/commands/gsd-workstreams.md)**: Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
+
+### Atomic Commands
+- **[`gsd:add-todo`](references/commands/atomic/add-todo.md)**: Capture idea or task as todo from current conversation context
+- **[`gsd:check-todos`](references/commands/atomic/check-todos.md)**: List pending todos and select one to work on
+- **[`gsd:cleanup`](references/commands/atomic/cleanup.md)**: Archive accumulated phase directories from completed milestones
+- **[`gsd:do`](references/commands/atomic/do.md)**: Route freeform text to the right GSD command automatically
+- **[`gsd:help`](references/commands/atomic/help.md)**: Show available GSD commands and usage guide
+- **[`gsd:join-discord`](references/commands/atomic/join-discord.md)**: Join the GSD Discord community
+- **[`gsd:note`](references/commands/atomic/note.md)**: Zero-friction idea capture. Append, list, or promote notes to todos.
+- **[`gsd:session-report`](references/commands/atomic/session-report.md)**: Generate a session report with token usage estimates, work summary, and outcomes
+- **[`gsd:ship`](references/commands/atomic/ship.md)**: Create PR, run review, and prepare for merge after verification passes
+- **[`gsd:stats`](references/commands/atomic/stats.md)**: Display project statistics — phases, plans, requirements, git metrics, and timeline
+- **[`gsd:thread`](references/commands/atomic/thread.md)**: Manage persistent context threads for cross-session work
+- **[`gsd:undo`](references/commands/atomic/undo.md)**: Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks.
+
+### Milestone Commands
+- **[`gsd:add-backlog`](references/commands/milestone/add-backlog.md)**: Add an idea to the backlog parking lot (999.x numbering)
+- **[`gsd:audit-milestone`](references/commands/milestone/audit-milestone.md)**: Audit milestone completion against original intent before archiving
+- **[`gsd:complete-milestone`](references/commands/milestone/complete-milestone.md)**: Archive completed milestone and prepare for next version
+- **[`gsd:milestone-summary`](references/commands/milestone/milestone-summary.md)**: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
+- **[`gsd:new-milestone`](references/commands/milestone/new-milestone.md)**: Start a new milestone cycle — update PROJECT.md and route to requirements
+- **[`gsd:plan-milestone-gaps`](references/commands/milestone/plan-milestone-gaps.md)**: Create phases to close all gaps identified by milestone audit
+- **[`gsd:plant-seed`](references/commands/milestone/plant-seed.md)**: Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
+- **[`gsd:review-backlog`](references/commands/milestone/review-backlog.md)**: Review and promote backlog items to active milestone
+
+### Misc Commands
+- **[`gsd:audit-fix`](references/commands/misc/audit-fix.md)**: Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit
+- **[`gsd:audit-uat`](references/commands/misc/audit-uat.md)**: Cross-phase audit of all outstanding UAT and verification items
+- **[`gsd:next`](references/commands/misc/next.md)**: Automatically advance to the next logical step in the GSD workflow
+- **[`gsd:progress`](references/commands/misc/progress.md)**: Check project progress, show context, and route to next action (execute or plan)
+- **[`gsd:verify-work`](references/commands/misc/verify-work.md)**: Validate built features through conversational UAT
+
+### Phase Commands
+- **[`gsd:add-phase`](references/commands/phase/add-phase.md)**: Add phase to end of current milestone in roadmap
+- **[`gsd:add-tests`](references/commands/phase/add-tests.md)**: Generate tests for a completed phase based on UAT criteria and implementation
+- **[`gsd:discuss-phase`](references/commands/phase/discuss-phase.md)**: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (Antigravity picks recommended defaults). Use --chain for interactive discuss followed by automatic plan+execute. Use --power for bulk question generation into a file-based UI (answer at your own pace).
+- **[`gsd:execute-phase`](references/commands/phase/execute-phase.md)**: Execute all plans in a phase with wave-based parallelization
+- **[`gsd:insert-phase`](references/commands/phase/insert-phase.md)**: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+- **[`gsd:list-phase-assumptions`](references/commands/phase/list-phase-assumptions.md)**: Surface Antigravity's assumptions about a phase approach before planning
+- **[`gsd:plan-phase`](references/commands/phase/plan-phase.md)**: Create detailed phase plan (PLAN.md) with verification loop
+- **[`gsd:remove-phase`](references/commands/phase/remove-phase.md)**: Remove a future phase from roadmap and renumber subsequent phases
+- **[`gsd:research-phase`](references/commands/phase/research-phase.md)**: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
+- **[`gsd:secure-phase`](references/commands/phase/secure-phase.md)**: Retroactively verify threat mitigations for a completed phase
+- **[`gsd:ui-phase`](references/commands/phase/ui-phase.md)**: Generate UI design contract (UI-SPEC.md) for frontend phases
+- **[`gsd:ui-review`](references/commands/phase/ui-review.md)**: Retroactive 6-pillar visual audit of implemented frontend code
+- **[`gsd:validate-phase`](references/commands/phase/validate-phase.md)**: Retroactively audit and fill Nyquist validation gaps for a completed phase
+- **[`gsd:workstreams`](references/commands/phase/workstreams.md)**: Manage parallel workstreams — list, create, switch, status, progress, complete, and resume
+
+### Project Commands
+- **[`gsd:analyze-dependencies`](references/commands/project/analyze-dependencies.md)**: Analyze phase dependencies and suggest Depends on entries for ROADMAP.md
+- **[`gsd:explore`](references/commands/project/explore.md)**: Socratic ideation and idea routing — think through ideas before committing to plans
+- **[`gsd:import`](references/commands/project/import.md)**: Ingest external plans with conflict detection against project decisions before writing anything.
+- **[`gsd:intel`](references/commands/project/intel.md)**: Query, inspect, or refresh codebase intelligence files in .planning/intel/
+- **[`gsd:list-workspaces`](references/commands/project/list-workspaces.md)**: List active GSD workspaces and their status
+- **[`gsd:map-codebase`](references/commands/project/map-codebase.md)**: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+- **[`gsd:new-project`](references/commands/project/new-project.md)**: Initialize a new project with deep context gathering and PROJECT.md
+- **[`gsd:new-workspace`](references/commands/project/new-workspace.md)**: Create an isolated workspace with repo copies and independent .planning/
+- **[`gsd:remove-workspace`](references/commands/project/remove-workspace.md)**: Remove a GSD workspace and clean up worktrees
+- **[`gsd:scan`](references/commands/project/scan.md)**: Rapid codebase assessment — lightweight alternative to /gsd-map-codebase
+
+### System Commands
+- **[`gsd:autonomous`](references/commands/system/autonomous.md)**: Run all remaining phases autonomously — discuss→plan→execute per phase
+- **[`gsd:code-review-fix`](references/commands/system/code-review-fix.md)**: Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.
+- **[`gsd:code-review`](references/commands/system/code-review.md)**: Review source files changed during a phase for bugs, security issues, and code quality problems
+- **[`gsd:debug`](references/commands/system/debug.md)**: Systematic debugging with persistent state across context resets
+- **[`gsd:docs-update`](references/commands/system/docs-update.md)**: Generate or update project documentation verified against the codebase
+- **[`gsd:fast`](references/commands/system/fast.md)**: Execute a trivial task inline — no subagents, no planning overhead
+- **[`gsd:forensics`](references/commands/system/forensics.md)**: Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
+- **[`gsd:gsd-tools`](references/commands/system/gsd-tools.md)**: Direct access to GSD internal CLI tools for atomic operations (state, roadmap, phase, config, etc.)
+- **[`gsd:health`](references/commands/system/health.md)**: Diagnose planning directory health and optionally repair issues
+- **[`gsd:manager`](references/commands/system/manager.md)**: Interactive command center for managing multiple phases from one terminal
+- **[`gsd:pause-work`](references/commands/system/pause-work.md)**: Create context handoff when pausing work mid-phase
+- **[`gsd:pr-branch`](references/commands/system/pr-branch.md)**: Create a clean PR branch by filtering out .planning/ commits — ready for code review
+- **[`gsd:profile-user`](references/commands/system/profile-user.md)**: Generate developer behavioral profile and create Antigravity-discoverable artifacts
+- **[`gsd:quick`](references/commands/system/quick.md)**: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
+- **[`gsd:reapply-patches`](references/commands/system/reapply-patches.md)**: Reapply local modifications after a GSD update
+- **[`gsd:resume-work`](references/commands/system/resume-work.md)**: Resume work from previous session with full context restoration
+- **[`gsd:review`](references/commands/system/review.md)**: Request cross-AI peer review of phase plans from external AI CLIs
+- **[`gsd:set-profile`](references/commands/system/set-profile.md)**: Switch model profile for GSD agents (quality/balanced/budget/inherit)
+- **[`gsd:settings`](references/commands/system/settings.md)**: Configure GSD workflow toggles and model profile
+- **[`gsd:update`](references/commands/system/update.md)**: Update GSD to latest version with changelog display
+
 
 ### 3. Directory Structure
 The skill uses a standardized directory structure for portability and organization:
@@ -189,4 +218,4 @@ General documentation on the GSD philosophy, usage patterns, and configuration.
 5.  **CLI Invocation**: `gsd-tools` is **NOT** a global command. Always invoke it with the full node path: `node .agent/skills/gsd/bin/gsd-tools.cjs <command> [args]`. Never run `gsd-tools` bare.
 
 ---
-*Generated by gsd-converter on 2026-04-05*
+*Generated by gsd-converter on 2026-04-08*

package/.agent/skills/gsd/VERSION

@@ -0,0 +1 @@
+1.34.2

package/.agent/skills/gsd/assets/templates/user-profile.md

@@ -22,7 +22,7 @@
 
 **Rating:** {{communication_style.rating}} | **Confidence:** {{communication_style.confidence}}
 
-**Directive:** {{communication_style.claude_instruction}}
+**Directive:** {{communication_style.antigravity_instruction}}
 
 {{communication_style.summary}}
 
@@ -36,7 +36,7 @@
 
 **Rating:** {{decision_speed.rating}} | **Confidence:** {{decision_speed.confidence}}
 
-**Directive:** {{decision_speed.claude_instruction}}
+**Directive:** {{decision_speed.antigravity_instruction}}
 
 {{decision_speed.summary}}
 
@@ -50,7 +50,7 @@
 
 **Rating:** {{explanation_depth.rating}} | **Confidence:** {{explanation_depth.confidence}}
 
-**Directive:** {{explanation_depth.claude_instruction}}
+**Directive:** {{explanation_depth.antigravity_instruction}}
 
 {{explanation_depth.summary}}
 
@@ -64,7 +64,7 @@
 
 **Rating:** {{debugging_approach.rating}} | **Confidence:** {{debugging_approach.confidence}}
 
-**Directive:** {{debugging_approach.claude_instruction}}
+**Directive:** {{debugging_approach.antigravity_instruction}}
 
 {{debugging_approach.summary}}
 
@@ -78,7 +78,7 @@
 
 **Rating:** {{ux_philosophy.rating}} | **Confidence:** {{ux_philosophy.confidence}}
 
-**Directive:** {{ux_philosophy.claude_instruction}}
+**Directive:** {{ux_philosophy.antigravity_instruction}}
 
 {{ux_philosophy.summary}}
 
@@ -92,7 +92,7 @@
 
 **Rating:** {{vendor_philosophy.rating}} | **Confidence:** {{vendor_philosophy.confidence}}
 
-**Directive:** {{vendor_philosophy.claude_instruction}}
+**Directive:** {{vendor_philosophy.antigravity_instruction}}
 
 {{vendor_philosophy.summary}}
 
@@ -106,7 +106,7 @@
 
 **Rating:** {{frustration_triggers.rating}} | **Confidence:** {{frustration_triggers.confidence}}
 
-**Directive:** {{frustration_triggers.claude_instruction}}
+**Directive:** {{frustration_triggers.antigravity_instruction}}
 
 {{frustration_triggers.summary}}
 
@@ -120,7 +120,7 @@
 
 **Rating:** {{learning_style.rating}} | **Confidence:** {{learning_style.confidence}}
 
-**Directive:** {{learning_style.claude_instruction}}
+**Directive:** {{learning_style.antigravity_instruction}}
 
 {{learning_style.summary}}
 

package/.agent/skills/gsd/bin/gsd-tools.cjs

@@ -50,6 +50,7 @@ const profilePipeline = require('./lib/profile-pipeline.cjs');
 const profileOutput = require('./lib/profile-output.cjs');
 const workstream = require('./lib/workstream.cjs');
 const docs = require('./lib/docs.cjs');
+const learnings = require('./lib/learnings.cjs');
 
 // ─── Arg parsing helpers ──────────────────────────────────────────────────────
 
@@ -187,6 +188,16 @@ async function main() {
   error('Usage: node .agent/skills/gsd/bin/gsd-tools.cjs <command> [args] [--raw] [--pick <field>] [--cwd <path>] [--ws <name>]\nCommands: state, resolve-model, find-phase, commit, verify-summary, verify, frontmatter, template, generate-slug, current-timestamp, list-todos, verify-path-exists, config-ensure-section, config-new-project, init, workstream, docs-init');
   }
 
+  // Reject flags that are never valid for any gsd-tools command. AI agents
+  // sometimes hallucinate --help or --version on tool invocations; silently
+  // ignoring them can cause destructive operations to proceed unchecked.
+  const NEVER_VALID_FLAGS = new Set(['-h', '--help', '-?', '--h', '--version', '-v', '--usage']);
+  for (const arg of args) {
+  if (NEVER_VALID_FLAGS.has(arg)) {
+    error(`Unknown flag: ${arg}\ngsd-tools does not accept help or version flags. Run "gsd-tools" with no arguments for usage.`);
+  }
+  }
+
   // Multi-repo guard: resolve project root for commands that read/write .planning/.
   // Skip for pure-utility commands that don't touch .planning/ to avoid unnecessary
   // filesystem traversal on every invocation.
@@ -497,7 +508,7 @@ async function runCommand(command, args, cwd, raw) {
     };
     phase.cmdPhasesList(cwd, options, raw);
     } else if (subcommand === 'clear') {
-    milestone.cmdPhasesClear(cwd, raw);
+    milestone.cmdPhasesClear(cwd, raw, args.slice(2));
     } else {
     error('Unknown phases subcommand. Available: list, clear');
     }
@@ -803,7 +814,7 @@ async function runCommand(command, args, cwd, raw) {
     const outputIdx = args.indexOf('--output');
     const outputPath = outputIdx !== -1 ? args[outputIdx + 1] : null;
     const globalFlag = args.includes('--global');
-    profileOutput.cmdGenerateClaudeProfile(cwd, { analysis: analysisPath, output: outputPath, global: globalFlag }, raw);
+    profileOutput.cmdGenerateAntigravityProfile(cwd, { analysis: analysisPath, output: outputPath, global: globalFlag }, raw);
     break;
   }
 
@@ -812,7 +823,7 @@ async function runCommand(command, args, cwd, raw) {
     const outputPath = outputIdx !== -1 ? args[outputIdx + 1] : null;
     const autoFlag = args.includes('--auto');
     const forceFlag = args.includes('--force');
-    profileOutput.cmdGenerateClaudeMd(cwd, { output: outputPath, auto: autoFlag, force: forceFlag }, raw);
+    profileOutput.cmdGenerateAntigravityMd(cwd, { output: outputPath, auto: autoFlag, force: forceFlag }, raw);
     break;
   }
 
@@ -843,6 +854,45 @@ async function runCommand(command, args, cwd, raw) {
     break;
   }
 
+  // ─── Intel ────────────────────────────────────────────────────────────
+
+  case 'intel': {
+    const intel = require('./lib/intel.cjs');
+    const subcommand = args[1];
+    if (subcommand === 'query') {
+    const term = args[2];
+    if (!term) error('Usage: gsd-tools intel query <term>');
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelQuery(term, planningDir), raw);
+    } else if (subcommand === 'status') {
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelStatus(planningDir), raw);
+    } else if (subcommand === 'diff') {
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelDiff(planningDir), raw);
+    } else if (subcommand === 'snapshot') {
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelSnapshot(planningDir), raw);
+    } else if (subcommand === 'patch-meta') {
+    const filePath = args[2];
+    if (!filePath) error('Usage: gsd-tools intel patch-meta <file-path>');
+    core.output(intel.intelPatchMeta(path.resolve(cwd, filePath)), raw);
+    } else if (subcommand === 'validate') {
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelValidate(planningDir), raw);
+    } else if (subcommand === 'extract-exports') {
+    const filePath = args[2];
+    if (!filePath) error('Usage: gsd-tools intel extract-exports <file-path>');
+    core.output(intel.intelExtractExports(path.resolve(cwd, filePath)), raw);
+    } else if (subcommand === 'update') {
+    const planningDir = path.join(cwd, '.planning');
+    core.output(intel.intelUpdate(planningDir), raw);
+    } else {
+    error('Unknown intel subcommand. Available: query, status, update, diff, snapshot, patch-meta, validate, extract-exports');
+    }
+    break;
+  }
+
   // ─── Documentation ────────────────────────────────────────────────────
 
   case 'docs-init': {
@@ -850,6 +900,34 @@ async function runCommand(command, args, cwd, raw) {
     break;
   }
 
+  // ─── Learnings ─────────────────────────────────────────────────────────
+
+  case 'learnings': {
+    const subcommand = args[1];
+    if (subcommand === 'list') {
+    learnings.cmdLearningsList(raw);
+    } else if (subcommand === 'query') {
+    const tagIdx = args.indexOf('--tag');
+    const tag = tagIdx !== -1 ? args[tagIdx + 1] : null;
+    if (!tag) error('Usage: gsd-tools learnings query --tag <tag>');
+    learnings.cmdLearningsQuery(tag, raw);
+    } else if (subcommand === 'copy') {
+    learnings.cmdLearningsCopy(cwd, raw);
+    } else if (subcommand === 'prune') {
+    const olderIdx = args.indexOf('--older-than');
+    const olderThan = olderIdx !== -1 ? args[olderIdx + 1] : null;
+    if (!olderThan) error('Usage: gsd-tools learnings prune --older-than <duration>');
+    learnings.cmdLearningsPrune(olderThan, raw);
+    } else if (subcommand === 'delete') {
+    const id = args[2];
+    if (!id) error('Usage: gsd-tools learnings delete <id>');
+    learnings.cmdLearningsDelete(id, raw);
+    } else {
+    error('Unknown learnings subcommand. Available: list, query, copy, prune, delete');
+    }
+    break;
+  }
+
   default:
     error(`Unknown command: ${command}`);
   }

package/.agent/skills/gsd/bin/help-manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.32.0",
+  "version": "1.34.2",
   "commands": {
     "state": {
       "description": "State operations.",
@@ -141,6 +141,19 @@
     "audit-uat": {
       "description": "Scan all phases for unresolved UAT/verification items"
     },
+    "intel": {
+      "description": "Intel operations.",
+      "subcommands": {
+        "query": "Query intel files for a term",
+        "status": "Show intel file freshness",
+        "update": "Trigger intel refresh (returns agent spawn hint)",
+        "diff": "Show changed intel entries since last snapshot",
+        "snapshot": "Save current intel state as diff baseline",
+        "patch-meta": "Update _meta.updated_at in an intel file",
+        "validate": "Validate intel file structure",
+        "extract-exports": "Extract exported symbols from a source file"
+      }
+    },
     "scaffold": {
       "description": "Scaffold operations.",
       "subcommands": {
@@ -192,6 +205,16 @@
     },
     "docs-init": {
       "description": "Project context for docs-update workflow"
+    },
+    "learnings": {
+      "description": "Learnings operations.",
+      "subcommands": {
+        "list": "List all global learnings (JSON)",
+        "query": "Query learnings by tag",
+        "copy": "Copy from current project's LEARNINGS.md",
+        "prune": "Remove entries older than duration (e.g. 90d)",
+        "delete": "Delete a learning by ID"
+      }
     }
   },
   "tools_usage": "Commands: state, roadmap, requirements, phase, milestone, todo, workstream,\nfind-phase, resolve-model, commit, verify, template, init, check-commit,\nstats, audit-uat, uat, agent-skills, phases, docs-init, scan-sessions,\nextract-messages, profile-sample, write-profile, generate-antigravity-profile,\ngenerate-antigravity-md, history-digest, progress, scaffold, state-snapshot\n  Run with gsd:help <command> for detailed usage."

package/.agent/skills/gsd/bin/hooks/gsd-check-update.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.32.0
+// gsd-hook-version: 1.34.2
 // Check for GSD updates in background, write result to cache
 // Called by SessionStart hook - runs once per session
 
@@ -12,14 +12,14 @@ const homeDir = os.homedir();
 const cwd = process.cwd();
 
 // Detect runtime config directory (supports Antigravity, OpenCode, Kilo, Gemini)
-// Respects CLAUDE_CONFIG_DIR for custom config directory setups
+// Respects ANTIGRAVITY_CONFIG_DIR for custom config directory setups
 function detectConfigDir(baseDir) {
   // Check env override first (supports multi-account setups)
-  const envDir = process.env.CLAUDE_CONFIG_DIR;
+  const envDir = process.env.ANTIGRAVITY_CONFIG_DIR;
   if (envDir && fs.existsSync(path.join(envDir, 'get-shit-done', 'VERSION'))) {
     return envDir;
   }
-  for (const dir of ['.config/kilo', '.kilo', '.config/opencode', '.opencode', '.gemini', '.antigravity']) {
+  for (const dir of ['.antigravity', '.gemini', '.config/kilo', '.kilo', '.config/opencode', '.opencode']) {
     if (fs.existsSync(path.join(baseDir, dir, 'get-shit-done', 'VERSION'))) {
       return path.join(baseDir, dir);
     }
@@ -81,12 +81,22 @@ const child = spawn(process.execPath, ['-e', `
 
   // Check for stale hooks — compare hook version headers against installed VERSION
 .agent/skills/gsd/bin/hooks/) (#1421)
+  // Only check hooks that GSD currently ships — orphaned files from removed features
+  // (e.g., gsd-intel-*.js) must be ignored to avoid permanent stale warnings (#1750)
+  const MANAGED_HOOKS = [
+    'gsd-check-update.js',
+    'gsd-context-monitor.js',
+    'gsd-prompt-guard.js',
+    'gsd-read-guard.js',
+    'gsd-statusline.js',
+    'gsd-workflow-guard.js',
+  ];
   let staleHooks = [];
   if (configDir) {
     const hooksDir = path.join(configDir, 'hooks');
     try {
       if (fs.existsSync(hooksDir)) {
-        const hookFiles = fs.readdirSync(hooksDir).filter(f => f.startsWith('gsd-') && f.endsWith('.js'));
+        const hookFiles = fs.readdirSync(hooksDir).filter(f => MANAGED_HOOKS.includes(f));
         for (const hookFile of hookFiles) {
           try {
             const content = fs.readFileSync(path.join(hooksDir, hookFile), 'utf8');

package/.agent/skills/gsd/bin/hooks/gsd-context-monitor.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// gsd-hook-version: 1.32.0
+// gsd-hook-version: 1.34.2
 // Context Monitor - PostToolUse/AfterTool hook (Gemini uses AfterTool)
 // Reads context metrics from the statusline bridge file and injects
 // warnings when context usage is high. This makes the AGENT aware of