🤖 Antigravity Agent OS

A comprehensive agentic workflow system for Google Deepmind's Antigravity AI coding assistant

Transform how you build software with structured, repeatable AI-assisted workflows

---

🙏 Credits & Origin

This project is a fork and adaptation of the excellent Agent OS created by Builder Methods.

Original Project	buildermethods/agent-os
Original Website	buildermethods.com/agent-os
This Fork	ellfarnaz/antigravity-agent-os

💡 What's different? This fork has been adapted specifically for Google Deepmind's Antigravity AI coding assistant with global installation support, updated directory structures, and enhanced documentation.

---

✨ What is Agent OS?

Agent OS is a structured workflow system that transforms how you interact with AI coding assistants. Instead of ad-hoc prompting, you get:

• 📋 Predefined Workflows - Battle-tested processes for common development tasks
• 🤖 Specialized Agents - Role-specific AI personas for different aspects of development
• 📏 Coding Standards - Consistent code quality across all outputs
• 📁 Organized Artifacts - Structured output with specs, tasks, and documentation

Traditional AI Coding          vs          Agent OS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
"Build me a login feature"     →    /plan-product → /write-spec → /create-tasks → /implement-tasks
                                    
Unpredictable results          →    Consistent, documented output
No process                     →    Structured workflow
Variable quality               →    Standards-enforced code

---

🚀 Quick Start

1. Clone the Repository

git clone https://github.com/ellfarnaz/antigravity-agent-os.git
cd antigravity-agent-os

2. Install to Antigravity (One Command)

cd .agent
./install-to-antigravity.sh

This will:

• ✅ Sync all workflows to ~/.gemini/antigravity/
• ✅ Update global rules in ~/.gemini/GEMINI.md
• ✅ Make workflows available in ALL projects

3. Use Workflows Anywhere

/plan-product      → Product planning & roadmap
/write-spec        → Write feature specification  
/shape-spec        → Refine existing spec
/create-tasks      → Create task breakdown
/implement-tasks   → Implement code
/orchestrate-tasks → Multi-phase implementation

4. Done! 🎉

Workflows are now available globally in Antigravity.

---

📦 What's Included

🔄 6 Main Workflows Command Purpose /plan-product Create product mission, roadmap, tech stack /write-spec Write detailed feature specifications /shape-spec Refine and improve existing specs /create-tasks Break down specs into actionable tasks /implement-tasks Implement tasks with code /orchestrate-tasks Orchestrate multi-phase work

🤖 8 Specialized Agents Agent Responsibility Product Planner Product vision & roadmap Spec Writer Specification writing Spec Shaper Spec refinement Spec Initializer Spec initialization Spec Verifier Spec quality verification Tasks Creator Task breakdown Implementer Code implementation Impl. Verifier Implementation verification

📏 16 Coding Standards

Category	Count	Description
Global	6	Coding style, commenting, error handling, validation
Frontend	4	Accessibility, components, CSS, responsive design
Backend	4	API design, migrations, models, queries
Testing	1	Test writing guidelines
Combined	1	All global standards merged

📊 Total: 68 System Files

---

📂 Project Structure

antigravity-agent-os/
│
├── README.md                    ← You are here
├── rules.md                     ← Agent workflow rules
│
├── 📁 docs/                     ← All documentation
│   ├── DOCS_INDEX.md            ← Master documentation index ⭐
│   ├── INTEGRATION_GUIDE.md     
│   ├── INSTALL_SCRIPT_GUIDE.md  
│   ├── QUICK_REFERENCE.md       
│   └── ... (more docs)
│
├── 📁 images/                   ← Visual diagrams
│
└── 📁 .agent/                   ← 🔥 Core System (syncs to Antigravity)
    ├── install-to-antigravity.sh   ← Installer script
    ├── AGENT_SYSTEM_README.md
    ├── 📁 workflows/            ← 6 main workflows
    ├── 📁 agents/               ← 8 agent definitions
    ├── 📁 details-workflows/    ← 15 detail workflows
    ├── 📁 commands-workflows/   ← 23 command variants
    └── 📁 standards/            ← 16 coding standards

---

🔄 How It Works

Installation Flow

flowchart TD
    subgraph SOURCE["📁 Source: .agent/"]
        W[workflows/]
        A[agents/]
        D[details-workflows/]
        CMD[commands-workflows/]
        S[standards/]
    end

    SCRIPT["🔧 install-to-antigravity.sh"]

    subgraph TARGET["📂 Target: ~/.gemini/antigravity/"]
        GW[global_workflows/]
        GA[global_agents/]
        GD[global_details_workflows/]
        GCMD[global_commands_workflows/]
        GS[global_standards/]
    end

    W --> SCRIPT
    A --> SCRIPT
    D --> SCRIPT
    CMD --> SCRIPT
    S --> SCRIPT

    SCRIPT --> GW
    SCRIPT --> GA
    SCRIPT --> GD
    SCRIPT --> GCMD
    SCRIPT --> GS

Loading

Workflow Execution Flow

flowchart LR
    subgraph USER["🧑‍💻 User"]
        U1["Types /plan-product"]
    end

    subgraph ENGINE["⚙️ Antigravity Engine"]
        L1["Load Workflow"]
        L2["Load Details"]
        L3["Load Commands"]
        L4["Load Agent"]
        L5["Apply Standards"]
    end

    subgraph OUTPUT["📄 Output"]
        O1["mission.md"]
        O2["roadmap.md"]
        O3["tech-stack.md"]
    end

    U1 --> L1
    L1 --> L2
    L2 --> L3
    L3 --> L4
    L4 --> L5
    L5 --> O1
    L5 --> O2
    L5 --> O3

Loading

Step-by-Step Execution:

1. User types: /plan-product
   ↓
2. Load workflow from: global_workflows/plan-product.md
   ↓
3. Load details from: global_details_workflows/planning/
   ↓
4. Load commands from: global_commands_workflows/plan-product/
   ↓
5. Use agent from: global_agents/product-planner.md
   ↓
6. Apply standards from: global_standards/
   ↓
7. Generate output in project: .agent/product/

---

📚 Documentation

All documentation is in the docs/ folder:

Document	Description
DOCS_INDEX.md	📖 Master documentation index
INTEGRATION_GUIDE.md	How to integrate with Antigravity
INSTALL_SCRIPT_GUIDE.md	Detailed install script docs
QUICK_REFERENCE.md	Quick command lookup
VISUAL_FLOWS.md	Visual flow diagrams

---

✅ Requirements

• Antigravity AI coding assistant by Google Deepmind
• macOS/Linux (or WSL on Windows)
• bash shell

---

🆘 Troubleshooting

Workflows not recognized?

# Re-run install script
cd .agent && ./install-to-antigravity.sh

Standards not applied?

# Check GEMINI.md was updated
grep "AGENT SYSTEM" ~/.gemini/GEMINI.md

Verify installation?

# Check file count
find ~/.gemini/antigravity -name "*.md" | wc -l
# Should show: 68+ files

# List workflows
ls ~/.gemini/antigravity/global_workflows/
# Should show 6 workflow files

---

🎉 Benefits

Benefit	Description
✅ Consistent	Same process every time
✅ Predictable	Know what to expect
✅ Standards-Compliant	Code quality enforced
✅ Global	Works in any project
✅ Documented	Complete documentation
✅ Maintainable	Easy to update and extend

---

🤝 Contributing

Contributions are welcome! Feel free to:

1. Fork this repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

---

📄 License

This project is open source and available under the MIT License.

---

🔗 Links

Original Agent OS	buildermethods/agent-os
Builder Methods	buildermethods.com
This Repository	ellfarnaz/antigravity-agent-os

---

Ready to use! Open any project, type /plan-product, and see the magic happen. ✨

_{Made with ❤️ for the AI-assisted development community}

---

Version: 1.0 | Last Updated: 2025-12-22 | Status: Production Ready