workflow-creator

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

```

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

Installation

Quick install (requires Go 1.22+):

```bash

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

```

Or build from source:

```bash

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

cd antigravity-factory

make install

```

Commands

```bash

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

| Preset | Skills | Description |

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

| all | 20 | Full blueprint |

| core | 5 | Pipeline essentials |

| backend | 9 | Go backend |

| frontend | 8 | Nuxt/Vue |

| fullstack | 12 | Backend + Frontend |

| tma | 8 | Telegram Mini Apps |

| cli | 8 | CLI/TUI apps |

| minimal | 2 | Utilities only |

Example Workflow

```bash

# 1. Go to your project

cd my-project

# 2. Install blueprint (interactive)

factory install

# Select preset via TUI or use --preset

# 3. Check inventory

factory list

# 📦 Installed Blueprint

# Skills (20)

```

Configuration

Config file: ~/.config/factory/config.yaml

```yaml

source: ~/Developer/antigravity/antigravity-factory/blueprint

```

```bash

# Run linter (FASCIST MODE)

make lint

# Run all tests

make test

# Build CLI

make build-factory

# Full install (build + install + completions)

make install

```

Architecture Enforcement

The project includes architecture_test.go that enforces Go Modern standards:

| Rule | Enforcement |

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

| NO_ANY | Forbid interface{}/any — use generics |

| NO_LEGACY_LOG | Forbid log package — use log/slog |

| NO_FMT_PRINT | Forbid fmt.Print* in library code |

| NO_GLOBALS | Forbid exported mutable globals |

| MODERN_ITER | Enforce Go 1.22+ range syntax |

| CTX_HYGIENE | context.Context must be first param |

| DOC_GO | Every package must have doc.go |

| Command | Description |

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

| make install | Build CLI, install to PATH, add completions |

| make build-factory | Build CLI binary to bin/factory |

| make install-factory | Symlink binary to /usr/local/bin |

| make install-completions | Add shell completions for zsh/bash |

| make lint | Run golangci-lint (FASCIST MODE) |

| make test | Run all tests |

| make clean | Remove build artifacts |

| make changelog | Generate CHANGELOG.md via git-cliff |

| make validate SKILL= | Validate a single skill |

| make validate-all | Validate all skills in blueprint/ |

| make generate-team | Regenerate TEAM.md from skills |

| Folder | Contents |

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

| skills/ | 20 expert agents (backend-go, frontend-nuxt, mcp, etc.) |

| workflows/ | doc-cleanup, refactor |

| rules/ | TEAM.md, PIPELINE.md |

| standards/ | TDD, GIT, TECH_DEBT, TRACEABILITY, DOCUMENT_STRUCTURE |

Antigravity artifacts (brain/...) are ephemeral. Documents (docs/...) are permanent.

Rule: Every skill MUST save its final output (e.g., discovery-brief.md) to the project/docs/ directory and change its status to "Approved" BEFORE handing off to the next skill.

1. Design First: Before creating a skill, answer: What triggers it? What's the decision tree?
2. Scaffold: Use @skill-creator to create the standard structure.
3. Refine: Edit SKILL.md with your logic and workflows.
4. Validate: Run make validate SKILL= to check quality.
5. Install: Run factory install in your project.

We welcome contributions! Please follow the Design-First philosophy:

1. Keep instructions concise (<500 lines).
2. Move details to resources/ o