gsd

GSD

Purpose

The Antigravity GSD (Get Stuff Done) skill implements a rigid, spec-driven hierarchy for managing software development tasks. It enforces a separation of concerns between Planning, Execution, and Verification phases to reduce context switching and improve reliability.

When to Use This Skill

This skill should be used when:

1. Starting a Project: Initializing a new codebase or feature set with a clear structure.
2. Planning Work: Breaking down vague requirements into actionable, verified specifications.
3. Executing Tasks: Implementing code based on approved specs without context switching.
4. Managing State: Tracking progress through defined phases (Plan -> Execute -> Verify).

Triggers:

• Keywords: "plan phase", "execute phase", "new project spec", "gsd", "gsd-tools"
• Commands:
• gsd:add-backlog
• gsd:add-phase
• gsd:add-tests
• gsd:add-todo
• gsd:ai-integration-phase
• 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:eval-review
• gsd:execute-phase
• gsd:explore
• gsd:extract_learnings
• gsd:fast
• gsd:forensics
• gsd:from-gsd2
• gsd:graphify
• gsd:gsd-tools
• gsd:health
• gsd:help
• gsd:import
• gsd:inbox
• 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:sketch
• gsd:sketch-wrap-up
• gsd:spec-phase
• gsd:spike
• gsd:spike-wrap-up
• gsd:stats
• gsd:thread
• gsd:ui-phase
• gsd:ui-review
• gsd:undo
• gsd:update
• gsd:validate-phase
• gsd:verify-work
• gsd:workstreams

System Overview

1. Phase-Based Development

The system enforces distinct phases. You typically cannot execute until you have planned.

• Plan: Define specs, tasks, and acceptance criteria. Output is a plan artifact.
• Execute: Write code to satisfy the specs. Driven by the plan artifact.
• Verify: Confirm the code meets criteria.

2. Available Commands

The following slash commands are available in this skill. Use them to drive the GSD process:

Atomic Commands

• gsd:add-todo: Capture idea or task as todo from current conversation context
• gsd:check-todos: List pending todos and select one to work on
• gsd:cleanup: Archive accumulated phase directories from completed milestones
• gsd:do: Route freeform text to the right GSD command automatically
• gsd:help: Show available GSD commands and usage guide
• gsd:join-discord: Join the GSD Discord community
• gsd:note: Zero-friction idea capture. Append, list, or promote notes to todos.
• gsd:session-report: Generate a session report with token usage estimates, work summary, and outcomes
• gsd:ship: Create PR, run review, and prepare for merge after verification passes
• gsd:stats: Display project statistics — phases, plans, requirements, git metrics, and timeline
• gsd:thread: Manage persistent context threads for cross-session work
• gsd:undo: Safe git revert. Roll back phase or plan commits using the phase manifest with dependency checks.

Milestone Commands

• gsd:add-backlog: Add an idea to the backlog parking lot (999.x numbering)
• gsd:audit-milestone: Audit milestone completion against original intent before archiving
• gsd:complete-milestone: Archive completed milestone and prepare for next version
• gsd:milestone-summary: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
• gsd:new-milestone: Start a new milestone cycle — update PROJECT.md and route to requirements
• gsd:plan-milestone-gaps: Create phases to close all gaps identified by milestone audit
• gsd:plant-seed: Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
• gsd:review-backlog: Review and promote backlog items to active milestone

Misc Commands

• gsd:ai-integration-phase: Generate AI design contract (AI-SPEC.md) for phases that involve building AI systems — framework selection, implementation guidance from official docs, and evaluation strategy
• gsd:audit-fix: Autonomous audit-to-fix pipeline — find issues, classify, fix, test, commit
• gsd:audit-uat: Cross-phase audit of all outstanding UAT and verification items
• gsd:eval-review: Retroactively audit an executed AI phase's evaluation coverage — scores each eval dimension as COVERED/PARTIAL/MISSING and produces an actionable EVAL-REVIEW.md with remediation plan
• gsd:extract_learnings: Extract decisions, lessons, patterns, and surprises from completed phase artifacts
• gsd:from-gsd2: Import a GSD-2 (.gsd/) project back to GSD v1 (.planning/) format
• gsd:graphify: Build, query, and inspect the project knowledge graph in .planning/graphs/
• gsd:inbox: Triage and review all open GitHub issues and PRs against project templates and contribution guidelines
• gsd:next: Automatically advance to the next logical step in the GSD workflow
• gsd:progress: Check project progress, show context, and route to next action (execute or plan). Use --forensic to append a 6-check integrity audit after the standard report.
• gsd:sketch-wrap-up: Package sketch design findings into a persistent project skill for future build conversations
• gsd:sketch: Rapidly sketch UI/design ideas using throwaway HTML mockups with multi-variant exploration
• gsd:spec-phase: Socratic spec refinement — clarify WHAT a phase delivers with ambiguity scoring before discuss-phase. Produces a SPEC.md with falsifiable requirements locked before implementation decisions begin.
• gsd:spike-wrap-up: Package spike findings into a persistent project skill for future build conversations
• gsd:spike: Rapidly spike an idea with throwaway experiments to validate feasibility before planning
• gsd:verify-work: Validate built features through conversational UAT

Phase Commands

• gsd:add-phase: Add phase to end of current milestone in roadmap
• gsd:add-tests: Generate tests for a completed phase based on UAT criteria and implementation
• gsd:discuss-phase: Gather phase context through adaptive questioning before planning. Use --all to skip area selection and discuss all gray areas interactively. 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: Execute all plans in a phase with wave-based parallelization
• gsd:insert-phase: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
• gsd:list-phase-assumptions: Surface Antigravity's assumptions about a phase approach before planning
• gsd:plan-phase: Create detailed phase plan (PLAN.md) with verification loop
• gsd:remove-phase: Remove a future phase from roadmap and renumber subsequent phases
• gsd:research-phase: Research how to implement a phase (standalone - usually use /gsd-plan-phase instead)
• **[gsd:secure-phase](references/commands/phase/secure

Content truncated.