project-bro

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.

• 🧠 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)

| Skill | Purpose |

|-------|---------|

| @skill-creator | Creates new skills from specs |

| @skill-factory-expert | Knows the factory codebase, answers questions |

| @skill-interviewer | Creative partner for skill ideation |

| @skill-updater | Mass updates existing skills |

| @workflow-creator | Designs automation workflows |

```

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

```