Antigravity Setup

One-command scaffolding for Antigravity IDE — installs AI workflows, skills, and coding standards into any project.

🚀 Quick Start

Run this once per project from the project root:

# Interactive — choose your stacks from a menu
npx antigravity-workspace-kit

# Non-interactive — pass stacks directly
npx antigravity-workspace-kit --stack=react
npx antigravity-workspace-kit --stack=angular,node-express
npx antigravity-workspace-kit --stack=nextjs,python

That's it. The tool will install the right files and you're ready to work.

📦 What Gets Installed

Always (stack-agnostic)

| Path | Purpose | |---|---| | .agent/workflows/ | All slash commands (/develop, /commit, /archive, etc.) | | ai-specs/specs/base-standards.mdc | Core development rules | | ai-specs/specs/documentation-standards.mdc | Documentation conventions | | GEMINI.md | Antigravity context file (system-level instructions) | | ai-specs/{tasks,changes,archive,golden-rules}/ | Runtime directories for the task lifecycle |

Per Stack (only what you choose)

| Stack key | Skill installed | Standard installed | |---|---|---| | react | .agent/skills/react-developer/ | react-standards.mdc | | angular | .agent/skills/angular-developer/ | angular-standards.mdc | | nextjs | .agent/skills/nextjs-developer/ | nextjs-standards.mdc | | react-native | .agent/skills/react-native-developer/ | react-native-standards.mdc | | html-vanilla | .agent/skills/html-vanilla-developer/ | html-vanilla-standards.mdc | | node-express | .agent/skills/node-express-developer/ | node-express-standards.mdc | | php | .agent/skills/php-developer/ | php-standards.mdc | | python | .agent/skills/python-developer/ | python-standards.mdc | | wordpress | .agent/skills/wordpress-developer/ | wordpress-standards.mdc | | strategy | .agent/skills/product-strategy-analyst/ | (none) |

🎯 After Installation

Open your Antigravity chat and run:

/analyze-project

This command will:

• Scan the project structure and detect its framework, versions, and existing conventions.
• Generate ai-specs/golden-rules/project-rules.mdc — a hyper-specific override file tailored to this project's architecture, including literal code snippets so the AI replicates your exact style.

Commit ai-specs/golden-rules/ to version control so all teammates share the same project rules. The tasks/, changes/, and archive/ folders are automatically added to .gitignore (transient, not committed).

💡 Development Workflow

Once set up, all work follows this standardized pipeline:

Step 1: Enrich the Task

/create-task "Add authentication endpoint POST /api/auth"
# or, with ClickUp MCP:
/create-task 86aepknx5

Forces the AI to define API contracts, data models, and acceptance criteria before any code is written. Saves to ai-specs/tasks/[id].md.

Step 2: Plan the Implementation

/plan-backend-ticket ai-specs/tasks/86aepknx5.md
/plan-frontend-ticket 86aepknx5

Produces a detailed, step-by-step architectural blueprint in ai-specs/changes/[id].md.

Step 3: Execute the Plan

/develop ai-specs/changes/86aepknx5.md

The AI implements one step at a time, running linters and tests, and waits for your approval before proceeding.

Step 4: Commit & Open a PR

/commit 86aepknx5

Stages relevant files, pushes the branch, and opens a PR via GitHub CLI.

Step 5: Archive

/archive 86aepknx5

Moves the task and plan files to ai-specs/archive/ to keep the workspace clean.

🏗️ Architecture

This package uses a two-tier model:

| Tier | Location | Purpose | |---|---|---| | Global (this package) | Published on npm | Universal baseline rules and workflows — maintained centrally | | Local (per project) | ai-specs/golden-rules/project-rules.mdc | Project-specific exceptions — committed in the project repo |

The local override always wins over the global standard.

📖 Core Development Principles

All standards are aligned to the rules in ai-specs/specs/base-standards.mdc:

1. Small Tasks, One at a Time — Baby steps, never skip ahead.
2. Test-Driven Development (TDD) — Write failing tests first.
3. Type Safety — Fully typed code (TypeScript, strict typing).
4. Clear Contract Definition — API contracts and data models are defined before coding via local *.md files.
5. Incremental Changes — Focused, reviewable PR modifications.

🔧 Maintaining the Global Standards

When your organization updates its architectural standards (e.g., a new testing library, upgraded React version):

1. Update the relevant file in ai-specs/specs/ in this repository.
2. Bump the version in package.json.
3. Publish: npm publish
4. Notify the team. Each dev re-runs npx antigravity-workspace-kit in their projects to get the latest.