Antigravity-Workflow-System

Antigravity-Workflow-System

πŸš€ A spec-driven workflow framework for AI-assisted development. Empowers prompt engineers to build production-ready software through structured PRD β†’ Architecture β†’ Task decomposition. Designed for Antigravity to enforce design-first principles and prevent architectural drift in vibe coding.

Stars: 88

Visit
 screenshot

Antigravity Workflow System is a structured workflow framework for Agentic AI assistants, addressing core pain points of the Vibe Coding era. It enforces architecture design first, tackles issues like architecture drift, spaghetti code, context amnesia, and lack of planning. The system includes workflows like `/genesis`, `/scout`, `/design-system`, `/challenge`, `/blueprint`, `/forge`, `/change`, `/explore`, and `/craft`, emphasizing versioned architecture, deep thinking first, and filesystem as memory. It requires the Antigravity environment with `.agent/workflows/` support and Sequential Thinking MCP Server for deep reasoning. Users can invoke workflows using the Slash Protocol or Intent Protocol, with a defined project structure under `.agent/` directory. Contributions are encouraged, and the system is licensed under MIT.

README:

Antigravity Workflow System

License: MIT Target: Antigravity Vibe Coding

English | δΈ­ζ–‡


⚑ What is this?

A structured workflow framework for Agentic AI assistants, designed to solve the core pain points of the Vibe Coding era.

πŸ’‘ TL;DR: Stop letting AI write spaghetti code. Force it to think like an architect first.

🎯 Problems We Solve

Pain Point The Problem Our Solution
Architecture Drift AI generates inconsistent patterns across the same codebase /genesis forces PRD & architecture design first
Spaghetti Code AI lacks project context, writes code that doesn't fit Tasks include constraints & acceptance criteria
Context Amnesia New session = AI forgets all previous decisions .agent/rules/agents.md + versioned docs as persistent memory
Lack of Planning Vibe Coding skips design, creates tech debt Mandatory design-first workflow

πŸš€ Quick Start

Option A β€” npm CLI (Recommended)

npm install -g @haaaiawd/anws
cd your-project
anws init

Requires Node.js β‰₯ 18.

Option B β€” GitHub Release

Download the latest .zip from Releases, then copy .agent/ to your project root.

πŸ“¦ Update Existing Installation

cd your-project
anws update

anws update overwrites all managed workflow/skill files to the latest version while preserving your agents.md. If the agents.md template has new content, an agents.md.new file will be generated for you to merge manually.

Your First Project 🐣

Example Prompt: "I want to build a web-based macOS simulator, including Dock, top bar, and several system apps. Please start this new project from scratch according to the development process."

Deep Thinking & Architecture Design: The AI will automatically execute the /genesis workflow, thinking deeply about project requirements and producing the PRD and architecture design. Genesis Workflow

Interactive Requirement Alignment: The AI will ask follow-up questions for ambiguous requirements to ensure the design matches your intuition. Human Interaction

Autonomous Task Breakdown & Execution: The AI will autonomously call necessary Skills (e.g., spec-writer, task-planner, etc.) to complete documentation and task decomposition. Skills Execution


πŸ—ΊοΈ Decision Flowchart

                    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                    β”‚  Where are you? β”‚
                    β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
           β–Ό                 β–Ό                 β–Ό
    β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
    β”‚   New    β”‚      β”‚  Legacy  β”‚      β”‚ Existing β”‚
    β”‚ Project  β”‚      β”‚ Takeover β”‚      β”‚  Change  β”‚
    β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜      β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜      β””β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”˜
         β”‚                 β”‚                 β”‚
         β–Ό                 β–Ό                 β–Ό
    /genesis          /scout        Tweak existing task?
         β”‚                 β”‚              /         \
         β”‚                 β”‚             /           \
         β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜     /change       /genesis
                  β”‚            (modify only)  (new tasks)
                  β–Ό                β”‚            β”‚
           /design-system <--------+------------+
          (optional, recommended)
                  |
                  v
            /challenge
          (audit & review)
                  |
                  v
             /blueprint
                  |
                  v
               /forge
          (code delivery)

πŸ”‘ Core Principles

1. Versioned Architecture

Don't "fix" architecture docs. Evolve them.

  • genesis/v1 β†’ genesis/v2 on major changes
  • Full traceability of decisions
  • No "it was always like this" mystery

2. Deep Thinking First

AI must think before it writes.

  • Workflows force multi-step reasoning via sequentialthinking
  • [!IMPORTANT] blocks as guardrails
  • No shallow, scan-and-output responses

3. Filesystem as Memory

Chat is ephemeral. Files are eternal.

  • AGENTS.md = AI's anchor
  • Architecture docs = persistent decisions
  • New session recovery in 30 seconds

πŸ“‹ Workflows

Command Purpose Input Output
/genesis Start from zero, create PRD & architecture Vague idea PRD, Architecture, ADRs
/scout Analyze legacy codebase risks Existing code Risk report, Gap analysis
/design-system Detailed design for a system Architecture System Design doc
/challenge Systemic 3-tier review & audit Full Design Docs Challenge Report (Graded)
/blueprint Break architecture into tasks PRD + Arch TASKS.md (WBS)
/forge Execute tasks β€” architecture to code TASKS.md Working code, verified
/change Tweak existing tasks (no new tasks) Minor tweak Updated TASKS + Design files (modify only)
/explore Deep research & brainstorm Topic/Question Exploration report
/craft Create workflows/skills/prompts Creation request Workflow / Skill / Prompt docs

πŸ› οΈ Compatibility & Prerequisites

⚠️ Important: This framework requires Antigravity environment with .agent/workflows/ support.

Environment Status Notes
Antigravity βœ… Supported Full workflow + skills support
Claude Code ❌ No native workflow support
Cursor ❌ No workflow support
GitHub Copilot ❌ No workflow support

What is Antigravity?

Antigravity is an Agentic AI coding environment that natively recognizes .agent/workflows/ directory and can execute slash commands like /genesis, /blueprint, etc.

πŸ”Œ Required: Sequential Thinking MCP Server

This framework uses sequentialthinking for deep reasoning. Install it via MCP Store:

  1. Open Antigravity Editor
  2. Click "..." (three dots) in the sidebar β†’ Additional Options
  3. Select MCP Servers
  4. Open MCP Store and search for sequential-thinking
  5. Click Add to install

πŸ’‘ Without this, workflows still work, but deep thinking features will be limited.


⚑ Invoke Workflows

Antigravity will automatically recognize the intent and trigger the appropriate workflow. You can use it in two ways:

⚑ Method A: Slash Protocol (Explicit)

Directly type the command in the chat or editor to trigger the workflow.

  • /genesis - Start project creation
  • /scout - Analyze existing codebase
  • /blueprint - Break down architecture into tasks

🧠 Method B: Intent Protocol (Implicit)

Just speak naturally. Antigravity will automatically select and run the right workflow.

  • "I want to start a new project for a todo app" β†’ Triggers /genesis
  • "Help me understand this legacy code and its risks" β†’ Triggers /scout
  • "I think there are gaps in this design, challenge it" β†’ Triggers /challenge
  • "The architecture is ready, let's plan the tasks" β†’ Triggers /blueprint
  • "Change the error message on the login page" β†’ Triggers /change (tweak existing task)
  • "I need to add a back-to-top button" β†’ Triggers /genesis (requires new task)

πŸ“ Project Structure

your-project/
β”œβ”€β”€ .agent/
β”‚   β”œβ”€β”€ rules/
β”‚   β”‚   └── agents.md          # 🧠 AI's anchor point
β”‚   β”œβ”€β”€ workflows/             # Workflow definitions
β”‚   β”‚   β”œβ”€β”€ genesis.md
β”‚   β”‚   β”œβ”€β”€ scout.md
β”‚   β”‚   β”œβ”€β”€ design-system.md
β”‚   β”‚   β”œβ”€β”€ challenge.md
β”‚   β”‚   β”œβ”€β”€ blueprint.md
β”‚   β”‚   β”œβ”€β”€ forge.md
β”‚   β”‚   β”œβ”€β”€ change.md
β”‚   β”‚   β”œβ”€β”€ explore.md
β”‚   β”‚   └── craft.md
β”‚   β”‚
β”‚   └── skills/            # Reusable skills
β”‚       β”œβ”€β”€ concept-modeler/
β”‚       β”œβ”€β”€ spec-writer/
β”‚       β”œβ”€β”€ task-planner/
β”‚       └── ...
β”‚
└── genesis/               # Versioned architecture docs
    β”œβ”€β”€ v1/
    β”‚   β”œβ”€β”€ 01_PRD.md
    β”‚   β”œβ”€β”€ 02_ARCHITECTURE.md
    β”‚   β”œβ”€β”€ 03_ADR/
    β”‚   β”œβ”€β”€ 05_TASKS.md
    β”‚   └── 07_CHALLENGE_REPORT.md
    └── v2/                # New version on major changes

πŸ™Œ Contributing

Contributions are welcome! Please read our contributing guidelines before submitting PRs.


πŸ“œ License

MIT Β© 2026


Made for architects who code, and AIs who think.

🧠 "Good architecture isn't written. It's designed."

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for Antigravity-Workflow-System

Similar Open Source Tools

For similar tasks

For similar jobs