Antigravity Factory 🚀

Build Complete Agent Infrastructure. A framework for managing AI agent blueprints: skills, workflows, team rules, and development standards.

What is this?

Antigravity Factory is a blueprint management system for AI agents. It provides:

• 20 Expert Skills — from backend-go-expert to mcp-expert
• Shared Standards — TDD, Git, Tech Debt protocols
• Team Structure — TEAM.md roster and PIPELINE.md workflow
• Factory Skills — meta-skills for creating and maintaining the ecosystem

Unlike simple scaffolding scripts, this tool enforces a Design-First Philosophy:

1. Context-Optimized: Enforces concise SKILL.md (<500 lines) to respect context windows.
2. IDE-Aware: Generates skills that understand absolute paths, task_boundary, and local environments.
3. Self-Verifying: Includes built-in QA checklists for agents to validate their own work.

✨ Features

• 🧠 20 Expert Skills: Backend, Frontend, DevOps, QA, MCP, CLI, TUI, and more
• 🛡️ Strict Validation: validate_skill.py enforces <500 lines and quality standards
• ✅ Auto-Checklists: Each skill has checklist.md for QA
• 🛠️ Factory CLI: Go-based factory install and factory list
• 📝 Standards Library: TDD, Git, Tech Debt, Traceability protocols
• 📦 Blueprint Pattern: Copy entire .agent/ structure to any project
• 🏗️ Architecture Tests: Enforces Go Modern standards via AST analysis

Factory Skills (Meta-Tooling)

📂 Repository Structure

antigravity-factory/
├── .agent/                      # 🏭 Factory-internal (NOT copied to projects)
│   ├── skills/
│   │   ├── skill-creator/       # Meta-skill that creates other skills
│   │   ├── skill-factory-expert/# Project expert
│   │   ├── skill-interviewer/   # Creative partner for skill ideation
│   │   ├── skill-updater/       # Mass updates to existing skills
│   │   └── workflow-creator/    # Designs automation workflows
│   └── workflows/
│       ├── commit.md            # Pre-commit checks
│       ├── push.md              # Merge + changelog + push
│       └── self-evolve.md       # Factory synchronization
│
├── blueprint/                   # 📦 Copied to .agent/ on install
│   ├── skills/                  # 20 expert skills
│   ├── workflows/               # doc-cleanup, refactor
│   ├── rules/                   # TEAM.md, PIPELINE.md
│   ├── standards/               # TDD, Git, Tech Debt protocols
│   ├── _meta/                   # Presets config (presets.yaml)
│   └── private/                 # Private skills (gitignored)
│
├── website/                     # 📚 VitePress skill catalog
│   ├── .vitepress/config.mts
│   ├── index.md
│   └── skills/                  # Generated skill pages
│
├── cmd/factory/                 # 🔧 CLI source code
│   ├── root.go, install.go, list.go
│   ├── doctor.go                # factory doctor
│   └── version.go
│
├── internal/
│   ├── installer/               # Blueprint copy logic
│   ├── doctor/                  # Link checker, diagnostics
│   ├── presets/                 # Preset loader
│   └── config/                  # Config handler
│
├── scripts/
│   └── generate_catalog.py      # Generate website skill pages
│
├── .github/workflows/
│   └── deploy-docs.yml          # Auto-deploy VitePress to GitHub Pages
│
├── Makefile
└── README.md

🔧 Factory CLI

The factory CLI copies the blueprint to any project's .agent/ folder.

Installation

Quick install (requires Go 1.22+):

go install github.com/ydnikolaev/antigravity-factory@latest

Or build from source:

git clone https://github.com/ydnikolaev/antigravity-factory.git
cd antigravity-factory
make install

Commands

factory install              # Interactive preset selection (TUI)
factory install --preset=backend  # Install specific preset
factory doctor               # Check for broken links and issues
factory list                 # Show installed inventory
factory version              # Show version

Presets

...