gsd-antigravity-kit 1.32.0 → 2.0.0

package/.agent/skills/gsd/references/commands/{gsd-new-workspace.md → project/new-workspace.md}

@@ -1,14 +1,15 @@
 ---
-name: gsd-new-workspace
-description: "Create an isolated workspace with repo copies and independent .planning/"
+name: gsd:new-workspace
+description: Create an isolated workspace with repo copies and independent .planning/
 argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
 allowed-tools:
   - Read
   - Bash
   - Write
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <context>
 **Flags:**
 - `--name` (required) — Workspace name

package/.agent/skills/gsd/references/commands/{gsd-remove-workspace.md → project/remove-workspace.md}

@@ -1,13 +1,14 @@
 ---
-name: gsd-remove-workspace
-description: "Remove a GSD workspace and clean up worktrees"
+name: gsd:remove-workspace
+description: Remove a GSD workspace and clean up worktrees
 argument-hint: "<workspace-name>"
 allowed-tools:
   - Bash
   - Read
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <context>
 **Arguments:**
 - `<workspace-name>` (required) — Name of the workspace to remove

package/.agent/skills/gsd/references/commands/project/scan.md

@@ -0,0 +1,28 @@
+---
+name: gsd:scan
+description: Rapid codebase assessment — lightweight alternative to /gsd-map-codebase
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Grep
+  - Glob
+  - Agent
+  - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
+---
+<objective>
+Run a focused codebase scan for a single area, producing targeted documents in `.planning/codebase/`.
+Accepts an optional `--focus` flag: `tech`, `arch`, `quality`, `concerns`, or `tech+arch` (default).
+
+Lightweight alternative to `/gsd-map-codebase` — spawns one mapper agent instead of four parallel ones.
+</objective>
+
+<execution_context>
+@references/workflows/scan.md
+</execution_context>
+
+<process>
+Execute the scan workflow from @references/workflows/scan.md end-to-end.
+</process>

package/.agent/skills/gsd/references/commands/{gsd-autonomous.md → system/autonomous.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-autonomous
-description: "Run all remaining phases autonomously — discuss→plan→execute per phase"
+name: gsd:autonomous
+description: Run all remaining phases autonomously — discuss→plan→execute per phase
 argument-hint: "[--from N] [--to N] [--only N] [--interactive]"
 allowed-tools:
   - Read
@@ -10,8 +10,9 @@ allowed-tools:
   - Grep
   - AskUserQuestion
   - Task
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <objective>
 Execute all remaining milestone phases autonomously. For each phase: discuss → plan → execute. Pauses only for user decisions (grey area acceptance, blockers, validation requests).
 

package/.agent/skills/gsd/references/commands/system/code-review-fix.md

@@ -0,0 +1,54 @@
+---
+name: gsd:code-review-fix
+description: Auto-fix issues found by code review in REVIEW.md. Spawns fixer agent, commits each fix atomically, produces REVIEW-FIX.md summary.
+argument-hint: "<phase-number> [--all] [--auto]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Edit
+  - Task
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
+---
+<objective>
+Auto-fix issues found by code review. Reads REVIEW.md from the specified phase, spawns gsd-code-fixer agent to apply fixes, and produces REVIEW-FIX.md summary.
+
+Arguments:
+- Phase number (required) — which phase's REVIEW.md to fix (e.g., "2" or "02")
+- `--all` (optional) — include Info findings in fix scope (default: Critical + Warning only)
+- `--auto` (optional) — enable fix + re-review iteration loop, capped at 3 iterations
+
+Output: {padded_phase}-REVIEW-FIX.md in phase directory + inline summary of fixes applied
+</objective>
+
+<execution_context>
+@references/workflows/code-review-fix.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (first positional argument is phase number)
+
+Optional flags parsed from $ARGUMENTS:
+- `--all` — Include Info findings in fix scope. Default behavior fixes Critical + Warning only.
+- `--auto` — Enable fix + re-review iteration loop. After applying fixes, re-run code-review at same depth. If new issues found, iterate. Cap at 3 iterations total. Without this flag, single fix pass only.
+
+Context files (ANTIGRAVITY.md, REVIEW.md, phase state) are resolved inside the workflow via `gsd-tools init phase-op` and delegated to agent via config blocks.
+</context>
+
+<process>
+This command is a thin dispatch layer. It parses arguments and delegates to the workflow.
+
+Execute the code-review-fix workflow from @references/workflows/code-review-fix.md end-to-end.
+
+The workflow (not this command) enforces these gates:
+- Phase validation (before config gate)
+- Config gate check (workflow.code_review)
+- REVIEW.md existence check (error if missing)
+- REVIEW.md status check (skip if clean/skipped)
+- Agent spawning (gsd-code-fixer)
+- Iteration loop (if --auto, capped at 3 iterations)
+- Result presentation (inline summary + next steps)
+</process>

package/.agent/skills/gsd/references/commands/system/code-review.md

@@ -0,0 +1,57 @@
+---
+name: gsd:code-review
+description: Review source files changed during a phase for bugs, security issues, and code quality problems
+argument-hint: "<phase-number> [--depth=quick|standard|deep] [--files file1,file2,...]"
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+  - Grep
+  - Write
+  - Task
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
+---
+<objective>
+Review source files changed during a phase for bugs, security vulnerabilities, and code quality problems.
+
+Spawns the gsd-code-reviewer agent to analyze code at the specified depth level. Produces REVIEW.md artifact in the phase directory with severity-classified findings.
+
+Arguments:
+- Phase number (required) — which phase's changes to review (e.g., "2" or "02")
+- `--depth=quick|standard|deep` (optional) — review depth level, overrides workflow.code_review_depth config
+  - quick: Pattern-matching only (~2 min)
+  - standard: Per-file analysis with language-specific checks (~5-15 min, default)
+  - deep: Cross-file analysis including import graphs and call chains (~15-30 min)
+- `--files file1,file2,...` (optional) — explicit comma-separated file list, skips SUMMARY/git scoping (highest precedence for scoping)
+
+Output: {padded_phase}-REVIEW.md in phase directory + inline summary of findings
+</objective>
+
+<execution_context>
+@references/workflows/code-review.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS (first positional argument is phase number)
+
+Optional flags parsed from $ARGUMENTS:
+- `--depth=VALUE` — Depth override (quick|standard|deep). If provided, overrides workflow.code_review_depth config.
+- `--files=file1,file2,...` — Explicit file list override. Has highest precedence for file scoping per D-08. When provided, workflow skips SUMMARY.md extraction and git diff fallback entirely.
+
+Context files (ANTIGRAVITY.md, SUMMARY.md, phase state) are resolved inside the workflow via `gsd-tools init phase-op` and delegated to agent via `<files_to_read>` blocks.
+</context>
+
+<process>
+This command is a thin dispatch layer. It parses arguments and delegates to the workflow.
+
+Execute the code-review workflow from @references/workflows/code-review.md end-to-end.
+
+The workflow (not this command) enforces these gates:
+- Phase validation (before config gate)
+- Config gate check (workflow.code_review)
+- File scoping (--files override > SUMMARY.md > git diff fallback)
+- Empty scope check (skip if no files)
+- Agent spawning (gsd-code-reviewer)
+- Result presentation (inline summary + next steps)
+</process>

package/.agent/skills/gsd/references/commands/{gsd-debug.md → system/debug.md}

@@ -1,15 +1,16 @@
 ---
-name: gsd-debug
-description: "Systematic debugging with persistent state across context resets"
-argument-hint: "[--diagnose] [issue description]"
+name: gsd:debug
+description: Systematic debugging with persistent state across context resets
+argument-hint: [--diagnose] [issue description]
 allowed-tools:
   - Read
   - Bash
   - Task
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Debug issues using scientific method with subagent isolation.
 
@@ -44,13 +45,13 @@ ls .planning/debug/*.md 2>/dev/null | grep -v resolved | head -5
 ## 0. Initialize Context
 
 ```bash
-INIT=$(node ".agent/skills/gsd/bin/gsd-tools.cjs" state load)
+.agent/skills/gsd/bin/gsd-tools.cjs" state load)
 if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
 ```
 
 Extract `commit_docs` from init JSON. Resolve debugger model:
 ```bash
-debugger_model=$(node ".agent/skills/gsd/bin/gsd-tools.cjs" resolve-model gsd-debugger --raw)
+.agent/skills/gsd/bin/gsd-tools.cjs" resolve-model gsd-debugger --raw)
 ```
 
 ## 1. Check Active Sessions

package/.agent/skills/gsd/references/commands/{gsd-docs-update.md → system/docs-update.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-docs-update
-description: "Generate or update project documentation verified against the codebase"
+name: gsd:docs-update
+description: Generate or update project documentation verified against the codebase
 argument-hint: "[--force] [--verify-only]"
 allowed-tools:
   - Read
@@ -11,8 +11,9 @@ allowed-tools:
   - Grep
   - Task
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <objective>
 Generate and update up to 9 documentation files for the current project. Each doc type is written by a gsd-doc-writer subagent that explores the codebase directly — no hallucinated paths, phantom endpoints, or stale signatures.
 

package/.agent/skills/gsd/references/commands/{gsd-fast.md → system/fast.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-fast
-description: "Execute a trivial task inline — no subagents, no planning overhead"
+name: gsd:fast
+description: Execute a trivial task inline — no subagents, no planning overhead
 argument-hint: "[task description]"
 allowed-tools:
   - Read
@@ -9,9 +9,10 @@ allowed-tools:
   - Bash
   - Grep
   - Glob
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Execute a trivial task directly in the current context without spawning subagents
 or generating PLAN.md files. For tasks too small to justify planning overhead:

package/.agent/skills/gsd/references/commands/{gsd-forensics.md → system/forensics.md}

@@ -1,6 +1,7 @@
 ---
-name: gsd-forensics
-description: "Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong"
+type: prompt
+name: gsd:forensics
+description: Post-mortem investigation for failed GSD workflows — analyzes git history, artifacts, and state to diagnose what went wrong
 argument-hint: "[problem description]"
 allowed-tools:
   - Read
@@ -8,9 +9,10 @@ allowed-tools:
   - Bash
   - Grep
   - Glob
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Investigate what went wrong during a GSD workflow execution. Analyzes git history, `.planning/` artifacts, and file system state to detect anomalies and generate a structured diagnostic report.
 

package/.agent/skills/gsd/references/commands/{gsd-health.md → system/health.md}

@@ -1,14 +1,15 @@
 ---
-name: gsd-health
-description: "Diagnose planning directory health and optionally repair issues"
-argument-hint: "[--repair]"
+name: gsd:health
+description: Diagnose planning directory health and optionally repair issues
+argument-hint: [--repair]
 allowed-tools:
   - Read
   - Bash
   - Write
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <objective>
 Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
 </objective>

package/.agent/skills/gsd/references/commands/{gsd-manager.md → system/manager.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-manager
-description: "Interactive command center for managing multiple phases from one terminal"
+name: gsd:manager
+description: Interactive command center for managing multiple phases from one terminal
 allowed-tools:
   - Read
   - Write
@@ -10,8 +10,9 @@ allowed-tools:
   - AskUserQuestion
   - Skill
   - Task
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <objective>
 Single-terminal command center for managing a milestone. Shows a dashboard of all phases with visual status indicators, recommends optimal next actions, and dispatches work — discuss runs inline, plan/execute run as background agents.
 

package/.agent/skills/gsd/references/commands/{gsd-pause-work.md → system/pause-work.md}

@@ -1,13 +1,14 @@
 ---
-name: gsd-pause-work
-description: "Create context handoff when pausing work mid-phase"
+name: gsd:pause-work
+description: Create context handoff when pausing work mid-phase
 allowed-tools:
   - Read
   - Write
   - Bash
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Create `.continue-here.md` handoff file to preserve complete work state across sessions.
 

package/.agent/skills/gsd/references/commands/{gsd-pr-branch.md → system/pr-branch.md}

@@ -1,14 +1,15 @@
 ---
-name: gsd-pr-branch
-description: "Create a clean PR branch by filtering out .planning/ commits — ready for code review"
+name: gsd:pr-branch
+description: Create a clean PR branch by filtering out .planning/ commits — ready for code review
 argument-hint: "[target branch, default: main]"
 allowed-tools:
   - Bash
   - Read
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Create a clean branch suitable for pull requests by filtering out .planning/ commits
 from the current branch. Reviewers see only code changes, not GSD planning artifacts.

package/.agent/skills/gsd/references/commands/{gsd-profile-user.md → system/profile-user.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-profile-user
-description: "Generate developer behavioral profile and create Antigravity-discoverable artifacts"
+name: gsd:profile-user
+description: Generate developer behavioral profile and create Antigravity-discoverable artifacts
 argument-hint: "[--questionnaire] [--refresh]"
 allowed-tools:
   - Read
@@ -10,9 +10,10 @@ allowed-tools:
   - Grep
   - AskUserQuestion
   - Task
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Generate a developer behavioral profile from session analysis (or questionnaire) and produce artifacts (USER-PROFILE.md, /gsd-dev-preferences, ANTIGRAVITY.md section) that personalize Antigravity's responses.
 

package/.agent/skills/gsd/references/commands/{gsd-quick.md → system/quick.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-quick
-description: "Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents"
+name: gsd:quick
+description: Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents
 argument-hint: "[--full] [--validate] [--discuss] [--research]"
 allowed-tools:
   - Read
@@ -11,8 +11,9 @@ allowed-tools:
   - Bash
   - Task
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
-
 <objective>
 Execute small, ad-hoc tasks with GSD guarantees (atomic commits, STATE.md tracking).
 

package/.agent/skills/gsd/references/commands/{gsd-reapply-patches.md → system/reapply-patches.md}

@@ -1,9 +1,11 @@
 ---
-name: gsd-reapply-patches
-description: "Reapply local modifications after a GSD update"
+name: gsd:reapply-patches
+description: Reapply local modifications after a GSD update
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <purpose>
 After a GSD update wipes and reinstalls files, this command merges user's previously saved local modifications back into the new version. Uses three-way comparison (pristine baseline, user-modified backup, newly installed version) to reliably distinguish user customizations from version drift.
 
@@ -75,8 +77,8 @@ if [ -z "$PATCHES_DIR" ] && [ -n "$CODEX_HOME" ]; then
   fi
 fi
 
-if [ -z "$PATCHES_DIR" ] && [ -n "$CLAUDE_CONFIG_DIR" ]; then
-  candidate="$(expand_home "$CLAUDE_CONFIG_DIR")/gsd-local-patches"
+if [ -z "$PATCHES_DIR" ] && [ -n "$ANTIGRAVITY_CONFIG_DIR" ]; then
+  candidate="$(expand_home "$ANTIGRAVITY_CONFIG_DIR")/gsd-local-patches"
   if [ -d "$candidate" ]; then
     PATCHES_DIR="$candidate"
   fi
@@ -95,7 +97,7 @@ if [ -z "$PATCHES_DIR" ]; then
   elif [ -d "$HOME/.codex/gsd-local-patches" ]; then
     PATCHES_DIR="$HOME/.codex/gsd-local-patches"
   else
-    PATCHES_DIR="$HOME/.antigravity/gsd-local-patches"
+    PATCHES_DIR="C:/projects/GSD-Antigravity/.antigravity/gsd-local-patches"
   fi
 fi
 # Local install fallback — check all runtime directories
@@ -201,7 +203,7 @@ When no pristine baseline is available, use these **strengthened heuristics**:
 For each file:
 a. Read both versions completely
 b. Identify ALL differences, then classify each as:
-   - **Mechanical drift** — path substitutions (e.g. `/Users/xxx/.antigravity/` → `$HOME/.antigravity/`), variable additions (`${GSD_WS}`, `${AGENT_SKILLS_*}`), error handling additions (`|| true`)
+   - **Mechanical drift** — path substitutions (e.g. `/Users/xxx/.antigravity/` → `C:/projects/GSD-Antigravity/.antigravity/`), variable additions (`${GSD_WS}`, `${AGENT_SKILLS_*}`), error handling additions (`|| true`)
    - **User customization** — added steps/sections, removed sections, reordered content, changed behavior, added frontmatter fields, modified instructions
 
 c. **If ANY differences remain after filtering out mechanical drift → those are user customizations. Merge them.**
@@ -217,6 +219,21 @@ git -C "$CONFIG_DIR" log --oneline --no-merges -- "{file_path}" | grep -v "gsd:u
 Each matching commit represents an intentional user modification. Use the commit messages and diffs to understand what was changed and why.
 
 4. **Write merged result** to the installed location
+
+### Post-merge verification
+
+After writing each merged file, verify that user modifications survived the merge:
+
+1. **Line-count check:** Count lines in the backup and the merged result. If the merged result has fewer lines than the backup minus the expected upstream removals, flag for review.
+2. **Hunk presence check:** For each user-added section identified during diff analysis, search the merged output for at least the first significant line (non-blank, non-comment) of each addition. Missing signature lines indicate a dropped hunk.
+3. **Report warnings inline** (do not block):
+   ```
+   ⚠ Potential dropped content in {file_path}:
+     - Missing hunk near line {N}: "{first_line_preview}..." ({line_count} lines)
+     - Backup available: {patches_dir}/{file_path}
+   ```
+4. **Track verification status** — add to per-file report: `Merged (verified)` vs `Merged (⚠ {N} hunks may be missing)`
+
 5. **Report status per file:**
    - `Merged` — user modifications applied cleanly (show summary of what was preserved)
    - `Conflict` — user reviewed and chose resolution
@@ -253,4 +270,5 @@ Ask user:
 - [ ] User modifications identified and merged into new version
 - [ ] Conflicts surfaced to user with both versions shown
 - [ ] Status reported for each file with summary of what was preserved
+- [ ] Post-merge verification checks each file for dropped hunks and warns if content appears missing
 </success_criteria>

package/.agent/skills/gsd/references/commands/{gsd-resume-work.md → system/resume-work.md}

@@ -1,15 +1,16 @@
 ---
-name: gsd-resume-work
-description: "Resume work from previous session with full context restoration"
+name: gsd:resume-work
+description: Resume work from previous session with full context restoration
 allowed-tools:
   - Read
   - Bash
   - Write
   - AskUserQuestion
   - SlashCommand
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Restore complete project context and resume work seamlessly from previous session.
 

package/.agent/skills/gsd/references/commands/{gsd-review.md → system/review.md}

@@ -1,6 +1,6 @@
 ---
-name: gsd-review
-description: "Request cross-AI peer review of phase plans from external AI CLIs"
+name: gsd:review
+description: Request cross-AI peer review of phase plans from external AI CLIs
 argument-hint: "--phase N [--gemini] [--antigravity] [--codex] [--opencode] [--all]"
 allowed-tools:
   - Read
@@ -8,9 +8,10 @@ allowed-tools:
   - Bash
   - Glob
   - Grep
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Invoke external AI CLIs (Gemini, Antigravity, Codex, OpenCode) to independently review phase plans.
 Produces a structured REVIEWS.md with per-reviewer feedback that can be fed back into

package/.agent/skills/gsd/references/commands/system/set-profile.md

@@ -0,0 +1,14 @@
+---
+name: gsd:set-profile
+description: Switch model profile for GSD agents (quality/balanced/budget/inherit)
+argument-hint: <profile (quality|balanced|budget|inherit)>
+model: haiku
+allowed-tools:
+  - Bash
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
+---
+
+Show the following output to the user verbatim, with no extra commentary:
+
+.agent/skills/gsd/bin/gsd-tools.cjs" config-set-model-profile $ARGUMENTS --raw`

package/.agent/skills/gsd/references/commands/{gsd-settings.md → system/settings.md}

@@ -1,14 +1,15 @@
 ---
-name: gsd-settings
-description: "Configure GSD workflow toggles and model profile"
+name: gsd:settings
+description: Configure GSD workflow toggles and model profile
 allowed-tools:
   - Read
   - Write
   - Bash
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Interactive configuration of GSD workflow agents and model profile via multi-question prompt.
 

package/.agent/skills/gsd/references/commands/{gsd-update.md → system/update.md}

@@ -1,12 +1,13 @@
 ---
-name: gsd-update
-description: "Update GSD to latest version with changelog display"
+name: gsd:update
+description: Update GSD to latest version with changelog display
 allowed-tools:
   - Bash
   - AskUserQuestion
+gsd-source-version: 1.34.2
+migration-date: 2026-04-08
 ---
 
-
 <objective>
 Check for GSD updates, install if available, and display what changed.