gsd-antigravity-kit 1.22.2 → 1.22.5

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

@@ -1,6 +1,6 @@
 ---
 name: gsd
-version: 1.22.1
+version: 1.22.4
 description: "Antigravity GSD (Get Stuff Done) - A spec-driven hierarchical planning and execution system. Triggers on project planning, phase management, and GSD slash commands."
 ---
 
@@ -52,6 +52,7 @@ This skill should be used when:
 - `gsd:set-profile`
 - `gsd:settings`
 - `gsd:update`
+- `gsd:validate-phase`
 - `gsd:verify-work`
 
 ## System Overview
@@ -96,6 +97,7 @@ The following slash commands are available in this skill. Use them to drive the
 - **[`gsd:set-profile`](references/commands/set-profile.md)**: Switch model profile for GSD agents (quality/balanced/budget)
 - **[`gsd:settings`](references/commands/settings.md)**: Configure GSD workflow toggles and model profile
 - **[`gsd:update`](references/commands/update.md)**: Update GSD to latest version with changelog display
+- **[`gsd:validate-phase`](references/commands/validate-phase.md)**: Retroactively audit and fill Nyquist validation gaps for a completed phase
 - **[`gsd:verify-work`](references/commands/verify-work.md)**: Validate built features through conversational UAT
 
 ### 3. Directory Structure
@@ -128,6 +130,7 @@ General documentation on the GSD philosophy, usage patterns, and configuration.
 2.  **Use Templates**: Leverage `assets/templates/` for consistent file structures.
 3.  **Update State**: Keep the project state synchronized using `/gsd:progress`.
 4.  **One Context**: Keep separate contexts (channels/threads) for Planning vs Execution to avoid contamination.
+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-03-03*
+*Generated by gsd-converter on 2026-03-09*

package/.agent/skills/gsd/assets/templates/config.json

@@ -1,12 +1,12 @@
 {
   "mode": "interactive",
-  "depth": "standard",
+  "granularity": "standard",
   "workflow": {
     "research": true,
     "plan_check": true,
     "verifier": true,
     "auto_advance": false,
-    "nyquist_validation": false
+    "nyquist_validation": true
   },
   "planning": {
     "commit_docs": true,

package/.agent/skills/gsd/assets/templates/roadmap.md

@@ -105,7 +105,7 @@ Phases execute in numeric order: 2 → 2.1 → 2.2 → 3 → 3.1 → 4
 
 <guidelines>
 **Initial planning (v1.0):**
-- Phase count depends on depth setting (quick: 3-5, standard: 5-8, comprehensive: 8-12)
+- Phase count depends on granularity setting (coarse: 3-5, standard: 5-8, fine: 8-12)
 - Each phase delivers something coherent
 - Phases can have 1+ plans (split if >3 tasks or multiple subsystems)
 - Plans use naming: {phase}-{plan}-PLAN.md (e.g., 01-02-PLAN.md)

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

@@ -1,8 +1,26 @@
 #!/usr/bin/env node
+const HELP_MANIFEST = require('./help-manifest.json');
+
+function showHelp(cmd, sub) {
+  const info = HELP_MANIFEST.commands[cmd];
+  if (!info) {
+    console.log(`\n${HELP_MANIFEST.tools_usage}`);
+    console.log('\nAvailable Commands: ' + Object.keys(HELP_MANIFEST.commands).join(', '));
+    return;
+  }
+  console.log(`\nCommand: ${cmd}\nDescription: ${info.description}`);
+  if (sub && info.subcommands?.[sub]) {
+    console.log(`Subcommand: ${sub}\nUsage: ${info.subcommands[sub]}`);
+  } else if (info.subcommands) {
+    console.log('\nAvailable subcommands:');
+    Object.entries(info.subcommands).forEach(([s, d]) => console.log(`  - ${s.padEnd(15)} : ${d}`));
+  }
+}
+
 
 /**
  * GSD Tools — CLI utility for GSD workflow operations
- * Usage: node gsd-tools.cjs <command> [args] [--raw] [--include field1,field2]
+ * Usage: node .agent/skills/gsd/bin/gsd-tools.cjs <command> [args] [--raw] [--include field1,field2]
  *
  * Commands: state, resolve-model, find-phase, commit, verify-summary, generate-slug,
  *   current-timestamp, list-todos, verify-path-exists, config-ensure-section, config-set,
@@ -10,7 +28,7 @@
  *   validate, progress, todo, scaffold, phase-plan-index, state-snapshot, summary-extract,
  *   websearch, frontmatter, verify, template, init
  *
- * Run with --help for detailed usage of each command.
+ * Run with gsd:help command args for detailed usage of each command.
  */
 
 const fs = require('fs');
@@ -54,12 +72,24 @@ async function main() {
 
   const rawIndex = args.indexOf('--raw');
   const raw = rawIndex !== -1;
+
+  if (args.includes('--help') || args.includes('-h')) {
+    const cmd = args[0];
+    const sub = args[1];
+    if (raw) {
+      const { output } = require('./lib/core.cjs');
+      output(HELP_MANIFEST, true);
+    } else {
+      showHelp(cmd, sub);
+    }
+    process.exit(0);
+  }
   if (rawIndex !== -1) args.splice(rawIndex, 1);
 
   const command = args[0];
 
   if (!command) {
-  error('Usage: gsd-tools <command> [args] [--raw] [--cwd <path>]\nCommands: state, resolve-model, find-phase, commit, verify-summary, verify, frontmatter, template, generate-slug, current-timestamp, list-todos, verify-path-exists, config-ensure-section, init');
+  error('Usage: node .agent/skills/gsd/bin/gsd-tools.cjs <command> [args] [--raw] [--cwd <path>]\nCommands: state, resolve-model, find-phase, commit, verify-summary, verify, frontmatter, template, generate-slug, current-timestamp, list-todos, verify-path-exists, config-ensure-section, init');
   }
 
   switch (command) {
@@ -146,9 +176,13 @@ async function main() {
 
   case 'commit': {
     const amend = args.includes('--amend');
-    const message = args[1];
-    // Parse --files flag (collect args after --files, stopping at other flags)
     const filesIndex = args.indexOf('--files');
+    // Collect all positional args between command name and first flag,
+    // then join them — handles both quoted ("multi word msg") and
+    // unquoted (multi word msg) invocations from different shells
+    const endIndex = filesIndex !== -1 ? filesIndex : args.length;
+    const messageArgs = args.slice(1, endIndex).filter(a => !a.startsWith('--'));
+    const message = messageArgs.join(' ') || undefined;
     const files = filesIndex !== -1 ? args.slice(filesIndex + 1).filter(a => !a.startsWith('--')) : [];
     commands.cmdCommit(cwd, message, files, raw, amend);
     break;

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

@@ -0,0 +1,237 @@
+{
+  "version": "1.22.4",
+  "commands": {
+    "add-phase": {
+      "description": "Add phase to end of current milestone in roadmap"
+    },
+    "add-tests": {
+      "description": "Generate tests for a completed phase based on UAT criteria and implementation"
+    },
+    "add-todo": {
+      "description": "Capture idea or task as todo from current conversation context"
+    },
+    "audit-milestone": {
+      "description": "Audit milestone completion against original intent before archiving"
+    },
+    "check-todos": {
+      "description": "List pending todos and select one to work on"
+    },
+    "cleanup": {
+      "description": "Archive accumulated phase directories from completed milestones"
+    },
+    "complete-milestone": {
+      "description": "Archive completed milestone and prepare for next version"
+    },
+    "debug": {
+      "description": "Systematic debugging with persistent state across context resets"
+    },
+    "discuss-phase": {
+      "description": "Gather phase context through adaptive questioning before planning"
+    },
+    "execute-phase": {
+      "description": "Execute all plans in a phase with wave-based parallelization"
+    },
+    "health": {
+      "description": "Diagnose planning directory health and optionally repair issues"
+    },
+    "help": {
+      "description": "Show available GSD commands and usage guide"
+    },
+    "insert-phase": {
+      "description": "Insert urgent work as decimal phase (e.g., 72.1) between existing phases"
+    },
+    "join-discord": {
+      "description": "Join the GSD Discord community"
+    },
+    "list-phase-assumptions": {
+      "description": "Surface Antigravity's assumptions about a phase approach before planning"
+    },
+    "map-codebase": {
+      "description": "Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents"
+    },
+    "new-milestone": {
+      "description": "Start a new milestone cycle \u2014 update PROJECT.md and route to requirements"
+    },
+    "new-project": {
+      "description": "Initialize a new project with deep context gathering and PROJECT.md"
+    },
+    "pause-work": {
+      "description": "Create context handoff when pausing work mid-phase"
+    },
+    "plan-milestone-gaps": {
+      "description": "Create phases to close all gaps identified by milestone audit"
+    },
+    "plan-phase": {
+      "description": "Create detailed phase plan (PLAN.md) with verification loop"
+    },
+    "progress": {
+      "description": "Calculate and render project completion percentage.",
+      "subcommands": {
+        "json": "Output progress as raw JSON.",
+        "render": "Output a pretty-formatted progress bar (default)."
+      }
+    },
+    "quick": {
+      "description": "Execute a quick task with GSD guarantees (atomic commits, state tracking) but skip optional agents"
+    },
+    "reapply-patches": {
+      "description": "Reapply local modifications after a GSD update"
+    },
+    "remove-phase": {
+      "description": "Remove a future phase from roadmap and renumber subsequent phases"
+    },
+    "research-phase": {
+      "description": "Research how to implement a phase (standalone - usually use /gsd:plan-phase instead)"
+    },
+    "resume-work": {
+      "description": "Resume work from previous session with full context restoration"
+    },
+    "set-profile": {
+      "description": "Switch model profile for GSD agents (quality/balanced/budget)"
+    },
+    "settings": {
+      "description": "Configure GSD workflow toggles and model profile"
+    },
+    "update": {
+      "description": "Update GSD to latest version with changelog display"
+    },
+    "validate-phase": {
+      "description": "Retroactively audit and fill Nyquist validation gaps for a completed phase"
+    },
+    "verify-work": {
+      "description": "Validate built features through conversational UAT"
+    },
+    "state": {
+      "description": "Manage and query project state memory.",
+      "subcommands": {
+        "json": "Output full state as raw JSON.",
+        "update": "Update a state key. usage: state update <key> <value>",
+        "get": "Retrieve a specific state value. usage: state get <key>",
+        "patch": "Apply multiple state changes via flags.",
+        "advance-plan": "Advance to the next plan in the current phase.",
+        "record-metric": "Record execution metrics (duration, files, tasks).",
+        "update-progress": "Sync STATE.md progress with ROADMAP.md status.",
+        "add-decision": "Record a design decision with rationale.",
+        "add-blocker": "Record a new blocking issue.",
+        "resolve-blocker": "Mark a blocker as resolved.",
+        "record-session": "Record session continuity metadata."
+      }
+    },
+    "roadmap": {
+      "description": "Manage and analyze project roadmap and phases.",
+      "subcommands": {
+        "get-phase": "Retrieve details for a specific phase number.",
+        "analyze": "Analyze roadmap completion and next steps.",
+        "update-plan-progress": "Update completion status for a plan in ROADMAP.md."
+      }
+    },
+    "find-phase": {
+      "description": "Search for a phase directory by number or name. usage: find-phase <query>"
+    },
+    "resolve-model": {
+      "description": "Resolve the optimal AI model for a specific agent type. usage: resolve-model <agent-type>"
+    },
+    "commit": {
+      "description": "Create a standardized GSD commit. usage: commit [message] --files [file1...]",
+      "subcommands": {
+        "--amend": "Amend the last commit instead of creating a new one."
+      }
+    },
+    "verify-summary": {
+      "description": "Verify that a SUMMARY.md matches the corresponding PLAN.md. usage: verify-summary <path>"
+    },
+    "generate-slug": {
+      "description": "Convert a string into a URL-friendly slug. usage: generate-slug <text>"
+    },
+    "current-timestamp": {
+      "description": "Output the current timestamp in various formats. usage: current-timestamp [format]"
+    },
+    "list-todos": {
+      "description": "List all pending todos in the project. usage: list-todos [area]"
+    },
+    "verify-path-exists": {
+      "description": "Check if a specific path exists within the project. usage: verify-path-exists <path>"
+    },
+    "history-digest": {
+      "description": "Generate a concise digest of recent project activity."
+    },
+    "todo": {
+      "description": "Atomic operations on a single todo file.",
+      "subcommands": {
+        "complete": "Mark a todo as done. usage: todo complete <path>"
+      }
+    },
+    "scaffold": {
+      "description": "Scaffold new project structures or phase directories. usage: scaffold <type> --name <name>",
+      "subcommands": {
+        "phase": "Initialize a new phase structure."
+      }
+    },
+    "phase-plan-index": {
+      "description": "Sync and re-index plans within a phase directory."
+    },
+    "state-snapshot": {
+      "description": "Create a persistent snapshot of the current project state."
+    },
+    "summary-extract": {
+      "description": "Extract specific fields from a SUMMARY.md file. usage: summary-extract <path> --fields <f1,f2>"
+    },
+    "websearch": {
+      "description": "Perform a low-latency web search for technical info. usage: websearch <query>"
+    },
+    "phase": {
+      "description": "Atomic phase operations in the roadmap.",
+      "subcommands": {
+        "next-decimal": "Calculate the next available decimal phase for insertion.",
+        "add": "Add a new phase at the end of the milestone.",
+        "insert": "Insert a new decimal phase at a specific position.",
+        "remove": "Remove a phase and re-number subsequent phases.",
+        "complete": "Mark a phase as 100% complete in ROADMAP.md."
+      }
+    },
+    "verify": {
+      "description": "Run verification and consistency checks.",
+      "subcommands": {
+        "plan-structure": "Validate PLAN.md formatting and required sections.",
+        "phase-completeness": "Verify that all plans in a phase have summaries.",
+        "references": "Check for broken internal or artifact references.",
+        "commits": "Verify that git commits match planned work.",
+        "artifacts": "Confirm existence of required phase artifacts.",
+        "key-links": "Validate critical links and external references.",
+        "consistency": "Ensure ROADMAP.md, STATE.md and REQUIREMENTS.md are in sync.",
+        "health": "Check directory structure and general project health."
+      }
+    },
+    "template": {
+      "description": "Manage and fill GSD artifact templates.",
+      "subcommands": {
+        "select": "Suggest the best template for a specific task.",
+        "fill": "Generate artifact content from a template with variables."
+      }
+    },
+    "frontmatter": {
+      "description": "Query or modify Markdown frontmatter.",
+      "subcommands": {
+        "get": "Retrieve a value from frontmatter. usage: frontmatter get <file> --field <key>",
+        "set": "Update a frontmatter field. usage: frontmatter set <file> --field <key> --value <val>",
+        "merge": "Merge a JSON object into file frontmatter.",
+        "validate": "Validate frontmatter against a specific schema."
+      }
+    },
+    "init": {
+      "description": "Initialize specialized GSD workflows.",
+      "subcommands": {
+        "execute-phase": "Init execution state for a phase.",
+        "plan-phase": "Init planning state for a phase.",
+        "new-project": "Init a fresh project structure.",
+        "new-milestone": "Init a new milestone cycle.",
+        "quick": "Init a quick-task context.",
+        "resume": "Restore context from a paused session.",
+        "verify-work": "Init UAT/verification workflow.",
+        "map-codebase": "Init parallel codebase mapping.",
+        "progress": "Calculate current project progress metrics."
+      }
+    }
+  },
+  "tools_usage": "Commands: state, resolve-model, find-phase, commit, verify-summary, generate-slug,\ncurrent-timestamp, list-todos, verify-path-exists, config-ensure-section, config-set,\nconfig-get, history-digest, phases, roadmap, requirements, phase, milestone,\nvalidate, progress, todo, scaffold, phase-plan-index, state-snapshot, summary-extract,\nwebsearch, frontmatter, verify, template, init\nRun with gsd:help command args for detailed usage of each command."
+}

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

@@ -9,12 +9,31 @@ const { spawn } = require('child_process');
 
 const homeDir = os.homedir();
 const cwd = process.cwd();
-const cacheDir = path.join(homeDir, '.gemini', 'antigravity', 'cache');
+
+// Detect runtime config directory (supports Antigravity, OpenCode, Gemini)
+// Respects CLAUDE_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;
+  if (envDir && fs.existsSync(path.join(envDir, 'get-shit-done', 'VERSION'))) {
+    return envDir;
+  }
+  for (const dir of ['.config/opencode', '.opencode', '.gemini', '.antigravity']) {
+    if (fs.existsSync(path.join(baseDir, dir, 'get-shit-done', 'VERSION'))) {
+      return path.join(baseDir, dir);
+    }
+  }
+  return envDir || path.join(baseDir, '.antigravity');
+}
+
+const globalConfigDir = detectConfigDir(homeDir);
+const projectConfigDir = detectConfigDir(cwd);
+const cacheDir = path.join(globalConfigDir, 'cache');
 const cacheFile = path.join(cacheDir, 'gsd-update-check.json');
 
 // VERSION file locations (check project first, then global)
-const projectVersionFile = path.join(cwd, '.agent', 'skills', 'gsd', 'VERSION');
-const globalVersionFile = path.join(homeDir, '.gemini', 'antigravity', 'skills', 'gsd', 'VERSION');
+const projectVersionFile = path.join(projectConfigDir, 'get-shit-done', 'VERSION');
+const globalVersionFile = path.join(globalConfigDir, 'get-shit-done', 'VERSION');
 
 // Ensure cache directory exists
 if (!fs.existsSync(cacheDir)) {

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

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// Context Monitor - PostToolUse hook
+// 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
 // context limits (the statusline only shows the user).
@@ -27,9 +27,14 @@ const STALE_SECONDS = 60;      // ignore metrics older than 60s
 const DEBOUNCE_CALLS = 5;      // min tool uses between warnings
 
 let input = '';
+// Timeout guard: if stdin doesn't close within 3s (e.g. pipe issues on
+// Windows/Git Bash), exit silently instead of hanging until Antigravity
+// kills the process and reports "hook error". See #775.
+const stdinTimeout = setTimeout(() => process.exit(0), 3000);
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', chunk => input += chunk);
 process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
   try {
     const data = JSON.parse(input);
     const sessionId = data.session_id;
@@ -95,21 +100,35 @@ process.stdin.on('end', () => {
     warnData.lastLevel = currentLevel;
     fs.writeFileSync(warnPath, JSON.stringify(warnData));
 
-    // Build warning message
+    // Detect if GSD is active (has .planning/STATE.md in working directory)
+    const cwd = data.cwd || process.cwd();
+    const isGsdActive = fs.existsSync(path.join(cwd, '.planning', 'STATE.md'));
+
+    // Build advisory warning message (never use imperative commands that
+    // override user preferences — see #884)
     let message;
     if (isCritical) {
-      message = `CONTEXT MONITOR CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-        'STOP new work immediately. Save state NOW and inform the user that context is nearly exhausted. ' +
-        'If using GSD, run /gsd:pause-work to save execution state.';
+      message = isGsdActive
+        ? `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+          'Context is nearly exhausted. Do NOT start new complex work or write handoff files — ' +
+          'GSD state is already tracked in STATE.md. Inform the user so they can run ' +
+          '/gsd:pause-work at the next natural stopping point.'
+        : `CONTEXT CRITICAL: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+          'Context is nearly exhausted. Inform the user that context is low and ask how they ' +
+          'want to proceed. Do NOT autonomously save state or write handoff files unless the user asks.';
     } else {
-      message = `CONTEXT MONITOR WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
-        'Begin wrapping up current task. Do not start new complex work. ' +
-        'If using GSD, consider /gsd:pause-work to save state.';
+      message = isGsdActive
+        ? `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+          'Context is getting limited. Avoid starting new complex work. If not between ' +
+          'defined plan steps, inform the user so they can prepare to pause.'
+        : `CONTEXT WARNING: Usage at ${usedPct}%. Remaining: ${remaining}%. ` +
+          'Be aware that context is getting limited. Avoid unnecessary exploration or ' +
+          'starting new complex work.';
     }
 
     const output = {
       hookSpecificOutput: {
-        hookEventName: "PostToolUse",
+        hookEventName: process.env.GEMINI_API_KEY ? "AfterTool" : "PostToolUse",
         additionalContext: message
       }
     };

package/.agent/skills/gsd/bin/hooks/gsd-statusline.js

@@ -8,9 +8,13 @@ const os = require('os');
 
 // Read JSON from stdin
 let input = '';
+// Timeout guard: if stdin doesn't close within 3s (e.g. pipe issues on
+// Windows/Git Bash), exit silently instead of hanging. See #775.
+const stdinTimeout = setTimeout(() => process.exit(0), 3000);
 process.stdin.setEncoding('utf8');
 process.stdin.on('data', chunk => input += chunk);
 process.stdin.on('end', () => {
+  clearTimeout(stdinTimeout);
   try {
     const data = JSON.parse(input);
     const model = data.model?.display_name || 'Antigravity';
@@ -18,14 +22,15 @@ process.stdin.on('end', () => {
     const session = data.session_id || '';
     const remaining = data.context_window?.remaining_percentage;
 
-    // Context window display (shows USED percentage scaled to 80% limit)
-    // Antigravity enforces an 80% context limit, so we scale to show 100% at that point
+    // Context window display (shows USED percentage scaled to usable context)
+    // Antigravity reserves ~16.5% for autocompact buffer, so usable context
+    // is 83.5% of the total window. We normalize to show 100% at that point.
+    const AUTO_COMPACT_BUFFER_PCT = 16.5;
     let ctx = '';
     if (remaining != null) {
-      const rem = Math.round(remaining);
-      const rawUsed = Math.max(0, Math.min(100, 100 - rem));
-      // Scale: 80% real usage = 100% displayed
-      const used = Math.min(100, Math.round((rawUsed / 80) * 100));
+      // Normalize: subtract buffer from remaining, scale to usable range
+      const usableRemaining = Math.max(0, ((remaining - AUTO_COMPACT_BUFFER_PCT) / (100 - AUTO_COMPACT_BUFFER_PCT)) * 100);
+      const used = Math.max(0, Math.min(100, Math.round(100 - usableRemaining)));
 
       // Write context metrics to bridge file for the context-monitor PostToolUse hook.
       // The monitor reads this file to inject agent-facing warnings when context is low.
@@ -48,12 +53,12 @@ process.stdin.on('end', () => {
       const filled = Math.floor(used / 10);
       const bar = '█'.repeat(filled) + '░'.repeat(10 - filled);
 
-      // Color based on scaled usage (thresholds adjusted for new scale)
-      if (used < 63) {        // ~50% real
+      // Color based on usable context thresholds
+      if (used < 50) {
         ctx = ` \x1b[32m${bar} ${used}%\x1b[0m`;
-      } else if (used < 81) { // ~65% real
+      } else if (used < 65) {
         ctx = ` \x1b[33m${bar} ${used}%\x1b[0m`;
-      } else if (used < 95) { // ~76% real
+      } else if (used < 80) {
         ctx = ` \x1b[38;5;208m${bar} ${used}%\x1b[0m`;
       } else {
         ctx = ` \x1b[5;31m💀 ${bar} ${used}%\x1b[0m`;
@@ -63,7 +68,9 @@ process.stdin.on('end', () => {
     // Current task from todos
     let task = '';
     const homeDir = os.homedir();
-    const todosDir = path.join(homeDir, '.gemini', 'antigravity', 'todos');
+    // Respect CLAUDE_CONFIG_DIR for custom config directory setups (#870)
+    const claudeDir = process.env.CLAUDE_CONFIG_DIR || path.join(homeDir, '.antigravity');
+    const todosDir = path.join(claudeDir, 'todos');
     if (session && fs.existsSync(todosDir)) {
       try {
         const files = fs.readdirSync(todosDir)
@@ -85,7 +92,7 @@ process.stdin.on('end', () => {
 
     // GSD update available?
     let gsdUpdate = '';
-    const cacheFile = path.join(homeDir, '.gemini', 'antigravity', 'cache', 'gsd-update-check.json');
+    const cacheFile = path.join(claudeDir, 'cache', 'gsd-update-check.json');
     if (fs.existsSync(cacheFile)) {
       try {
         const cache = JSON.parse(fs.readFileSync(cacheFile, 'utf8'));

package/.agent/skills/gsd/bin/lib/commands.cjs

@@ -4,7 +4,7 @@
 const fs = require('fs');
 const path = require('path');
 const { execSync } = require('child_process');
-const { safeReadFile, loadConfig, isGitIgnored, execGit, normalizePhaseName, comparePhaseNum, getArchivedPhaseDirs, generateSlugInternal, getMilestoneInfo, resolveModelInternal, MODEL_PROFILES, output, error, findPhaseInternal } = require('./core.cjs');
+const { safeReadFile, loadConfig, isGitIgnored, execGit, normalizePhaseName, comparePhaseNum, getArchivedPhaseDirs, generateSlugInternal, getMilestoneInfo, resolveModelInternal, MODEL_PROFILES, toPosixPath, output, error, findPhaseInternal } = require('./core.cjs');
 const { extractFrontmatter } = require('./frontmatter.cjs');
 
 function cmdGenerateSlug(text, raw) {
@@ -68,7 +68,7 @@ function cmdListTodos(cwd, area, raw) {
       created: createdMatch ? createdMatch[1].trim() : 'unknown',
       title: titleMatch ? titleMatch[1].trim() : 'Untitled',
       area: todoArea,
-      path: path.join('.planning', 'todos', 'pending', file),
+      path: toPosixPath(path.join('.planning', 'todos', 'pending', file)),
     });
     } catch {}
   }
@@ -528,7 +528,7 @@ function cmdScaffold(cwd, type, options, raw) {
   }
 
   fs.writeFileSync(filePath, content, 'utf-8');
-  const relPath = path.relative(cwd, filePath);
+  const relPath = toPosixPath(path.relative(cwd, filePath));
   output({ created: true, path: relPath }, raw, relPath);
 }
 

package/.agent/skills/gsd/bin/lib/config.cjs

@@ -37,6 +37,13 @@ function cmdConfigEnsureSection(cwd, raw) {
   try {
   if (fs.existsSync(globalDefaultsPath)) {
     userDefaults = JSON.parse(fs.readFileSync(globalDefaultsPath, 'utf-8'));
+    // Migrate deprecated "depth" key to "granularity"
+    if ('depth' in userDefaults && !('granularity' in userDefaults)) {
+    const depthToGranularity = { quick: 'coarse', standard: 'standard', comprehensive: 'fine' };
+    userDefaults.granularity = depthToGranularity[userDefaults.depth] || userDefaults.depth;
+    delete userDefaults.depth;
+    try { fs.writeFileSync(globalDefaultsPath, JSON.stringify(userDefaults, null, 2), 'utf-8'); } catch {}
+    }
   }
   } catch (err) {
   // Ignore malformed global defaults, fall back to hardcoded
@@ -54,7 +61,7 @@ function cmdConfigEnsureSection(cwd, raw) {
     research: true,
     plan_check: true,
     verifier: true,
-    nyquist_validation: false,
+    nyquist_validation: true,
   },
   parallelization: true,
   brave_search: hasBraveSearch,