tailscale-custom/.agent/ARCHITECTURE.md

Antigravity Kit Architecture

Comprehensive AI Agent Capability Expansion Toolkit

---

📋 Overview

Antigravity Kit is a modular system consisting of:

• 20 Specialist Agents - Role-based AI personas
• 38 Skills - Domain-specific knowledge modules
• 16 Workflows - Slash command procedures

---

🏗️ Directory Structure

.agent/
├── ARCHITECTURE.md          # This file
├── agents/                  # 20 Specialist Agents
├── skills/                  # 36 Skills
├── workflows/               # 12 Slash Commands
├── rules/                   # Global Rules
└── scripts/                 # Master Validation Scripts

---

🤖 Agents (20)

Specialist AI personas for different domains.

Agent	Focus	Skills Used
orchestrator	Multi-agent coordination	parallel-agents, behavioral-modes
project-planner	Discovery, task planning	brainstorming, plan-writing, architecture
frontend-specialist	Web UI/UX	frontend-design, react-best-practices, tailwind-patterns
backend-specialist	API, business logic	api-patterns, nodejs-best-practices, database-design
database-architect	Schema, SQL	database-design, prisma-expert
mobile-developer	iOS, Android, RN	mobile-design
game-developer	Game logic, mechanics	game-development
devops-engineer	CI/CD, Docker	deployment-procedures, docker-expert
security-auditor	Security compliance	vulnerability-scanner, red-team-tactics
penetration-tester	Offensive security	red-team-tactics
test-engineer	Testing strategies	testing-patterns, tdd-workflow, webapp-testing
debugger	Root cause analysis	systematic-debugging
performance-optimizer	Speed, Web Vitals	performance-profiling
seo-specialist	Ranking, visibility	seo-fundamentals, geo-fundamentals
documentation-writer	Manuals, docs	documentation-templates
product-manager	Requirements, user stories	plan-writing, brainstorming
product-owner	Strategy, backlog, MVP	plan-writing, brainstorming
qa-automation-engineer	E2E testing, CI pipelines	webapp-testing, testing-patterns
code-archaeologist	Legacy code, refactoring	clean-code, code-review-checklist
explorer-agent	Codebase analysis	-

---

🧩 Skills (36)

Modular knowledge domains that agents can load on-demand. based on task context.

Frontend & UI

Skill	Description
react-best-practices	React & Next.js performance optimization (Vercel - 57 rules)
web-design-guidelines	Web UI audit - 100+ rules for accessibility, UX, performance (Vercel)
tailwind-patterns	Tailwind CSS v4 utilities
frontend-design	UI/UX patterns, design systems
ui-ux-pro-max	50 styles, 21 palettes, 50 fonts

Backend & API

Skill	Description
api-patterns	REST, GraphQL, tRPC
nestjs-expert	NestJS modules, DI, decorators
nodejs-best-practices	Node.js async, modules
python-patterns	Python standards, FastAPI

Database

Skill	Description
database-design	Schema design, optimization
prisma-expert	Prisma ORM, migrations

TypeScript/JavaScript

Skill	Description
typescript-expert	Type-level programming, performance

Cloud & Infrastructure

Skill	Description
docker-expert	Containerization, Compose
deployment-procedures	CI/CD, deploy workflows
server-management	Infrastructure management

Testing & Quality

Skill	Description
testing-patterns	Jest, Vitest, strategies
webapp-testing	E2E, Playwright
tdd-workflow	Test-driven development
code-review-checklist	Code review standards
lint-and-validate	Linting, validation

Security

Skill	Description
vulnerability-scanner	Security auditing, OWASP
red-team-tactics	Offensive security

Architecture & Planning

Skill	Description
app-builder	Full-stack app scaffolding
architecture	System design patterns
plan-writing	Task planning, breakdown
brainstorming	Socratic questioning

Mobile

Skill	Description
mobile-design	Mobile UI/UX patterns

Game Development

Skill	Description
game-development	Game logic, mechanics

SEO & Growth

Skill	Description
seo-fundamentals	SEO, E-E-A-T, Core Web Vitals
geo-fundamentals	GenAI optimization

Shell/CLI

Skill	Description
bash-linux	Linux commands, scripting
powershell-windows	Windows PowerShell

Other

Skill	Description
clean-code	Coding standards (Global)
coding-levels	Adaptive communication (0-5)
behavioral-modes	Agent personas
parallel-agents	Multi-agent patterns
mcp-builder	Model Context Protocol
documentation-templates	Doc formats
i18n-localization	Internationalization
performance-profiling	Web Vitals, optimization
systematic-debugging	Troubleshooting

---

🔄 Workflows (12)

Slash command procedures. Invoke with /command.

Command	Description
/brainstorm	Socratic discovery
/create	Create new features
/debug	Debug issues
/deploy	Deploy application
/enhance	Improve existing code
/ins-develop	INS Module development
/orchestrate	Multi-agent coordination
/plan	Task breakdown
/preview	Preview changes
/status	Check project status
/test	Run tests
/ui-ux-pro-max	Design with 50 styles

---

🎯 Skill Loading Protocol

User Request → Skill Description Match → Load SKILL.md
                                            ↓
                                    Read references/
                                            ↓
                                    Read scripts/

Skill Structure

skill-name/
├── SKILL.md           # (Required) Metadata & instructions
├── scripts/           # (Optional) Python/Bash scripts
├── references/        # (Optional) Templates, docs
└── assets/            # (Optional) Images, logos

Enhanced Skills (with scripts/references)

Skill	Files	Coverage
ui-ux-pro-max	27	50 styles, 21 palettes, 50 fonts
app-builder	20	Full-stack scaffolding

---

� Scripts (2)

Master validation scripts that orchestrate skill-level scripts.

Master Scripts

Script	Purpose	When to Use
checklist.py	Priority-based validation (Core checks)	Development, pre-commit
verify_all.py	Comprehensive verification (All checks)	Pre-deployment, releases

Usage

# Quick validation during development
python .agent/scripts/checklist.py .

# Full verification before deployment
python .agent/scripts/verify_all.py . --url http://localhost:3000

What They Check

checklist.py (Core checks):

• Security (vulnerabilities, secrets)
• Code Quality (lint, types)
• Schema Validation
• Test Suite
• UX Audit
• SEO Check

verify_all.py (Full suite):

• Everything in checklist.py PLUS:
• Lighthouse (Core Web Vitals)
• Playwright E2E
• Bundle Analysis
• Mobile Audit
• i18n Check

For details, see scripts/README.md

---

📊 Statistics

Metric	Value
Total Agents	20
Total Skills	38
Total Workflows	16
Total Scripts	2 (master) + 18 (skill-level)
Coverage	~90% web/mobile development

---

🔗 Quick Reference

Need	Agent	Skills
Web App	frontend-specialist	react-best-practices, frontend-design
API	backend-specialist	api-patterns, nodejs-best-practices
Mobile	mobile-developer	mobile-design
Database	database-architect	database-design, prisma-expert
Security	security-auditor	vulnerability-scanner
Testing	test-engineer	testing-patterns, webapp-testing
Debug	debugger	systematic-debugging
Plan	project-planner	brainstorming, plan-writing