antigravity-ai-kit 2.1.0 → 3.0.0

package/.agent/README.md

@@ -24,10 +24,10 @@ This loads your session context and activates the orchestrator.
 ├── rules.md                # Core governance & identity
 ├── session-state.json      # Machine-readable state
 │
-├── agents/                 # 15 specialized agents
-├── commands/               # 20 slash commands
-├── skills/                 # 14 capability extensions
-├── workflows/              # 8 slash command workflows
+├── agents/                 # 19 specialized agents
+├── commands/               # 31 slash commands
+├── skills/                 # 31 capability extensions
+├── workflows/              # 14 slash command workflows
 ├── hooks/                  # Event-driven automation
 ├── rules/                  # Modular governance
 ├── contexts/               # Mode switching

package/.agent/agents/README.md

@@ -1,7 +1,7 @@
 # Antigravity AI Kit — Agents
 
 > **Purpose**: Specialized sub-agents for task delegation
-> **Count**: 15 Core Agents
+> **Count**: 19 Core Agents
 
 ---
 
@@ -26,6 +26,8 @@ Agents are specialized personas that handle delegated tasks with focused experti
 | 🔍 **Code Reviewer**        | `code-reviewer.md`        | Quality & security review       |
 | 🧪 **TDD Guide**            | `tdd-guide.md`            | Test-driven development         |
 | 🔧 **Build Error Resolver** | `build-error-resolver.md` | Rapid build fixes               |
+| 🖥️ **Backend Specialist**   | `backend-specialist.md`   | Node.js, NestJS, API design     |
+| 🎨 **Frontend Specialist**  | `frontend-specialist.md`  | React, Next.js, UI architecture |
 
 ### Quality & Security Agents
 
@@ -37,20 +39,22 @@ Agents are specialized personas that handle delegated tasks with focused experti
 
 ### Infrastructure Agents
 
-| Agent                     | File                    | Purpose                       |
-| :------------------------ | :---------------------- | :---------------------------- |
-| 📱 **Mobile Developer**   | `mobile-developer.md`   | React Native/Expo development |
-| 🗄️ **Database Architect** | `database-architect.md` | Schema design, queries        |
-| 🚀 **DevOps Engineer**    | `devops-engineer.md`    | CI/CD, deployment             |
+| Agent                        | File                       | Purpose                       |
+| :--------------------------- | :------------------------- | :---------------------------- |
+| 📱 **Mobile Developer**      | `mobile-developer.md`      | React Native/Expo development |
+| 🗄️ **Database Architect**    | `database-architect.md`    | Schema design, queries        |
+| 🚀 **DevOps Engineer**       | `devops-engineer.md`       | CI/CD, deployment             |
+| 🛡️ **Reliability Engineer**  | `reliability-engineer.md`  | SRE, production readiness     |
 
 ### Maintenance & Discovery Agents
 
-| Agent                   | File                  | Purpose            |
-| :---------------------- | :-------------------- | :----------------- |
-| 🧹 **Refactor Cleaner** | `refactor-cleaner.md` | Dead code cleanup  |
-| 📚 **Doc Updater**      | `doc-updater.md`      | Documentation sync |
-| 🧠 **Knowledge Agent**  | `knowledge-agent.md`  | RAG retrieval      |
-| 🔭 **Explorer Agent**   | `explorer-agent.md`   | Codebase discovery |
+| Agent                      | File                     | Purpose                     |
+| :------------------------- | :----------------------- | :-------------------------- |
+| 🧹 **Refactor Cleaner**    | `refactor-cleaner.md`    | Dead code cleanup           |
+| 📚 **Doc Updater**         | `doc-updater.md`         | Documentation sync          |
+| 🧠 **Knowledge Agent**     | `knowledge-agent.md`     | RAG retrieval               |
+| 🔭 **Explorer Agent**      | `explorer-agent.md`      | Codebase discovery          |
+| 📊 **Sprint Orchestrator** | `sprint-orchestrator.md` | Sprint planning & velocity  |
 
 ---
 

package/.agent/agents/architect.md

@@ -5,6 +5,7 @@ model: opus
 authority: design-authority
 reports-to: alignment-engine
 integration: 3-role-architecture
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — Architect Agent

package/.agent/agents/backend-specialist.md

@@ -1,3 +1,14 @@
+---
+name: backend-specialist
+description: "Node.js backend architecture, API design, middleware patterns specialist"
+domain: backend
+triggers: [backend, api, server, nodejs, nestjs, express, middleware]
+model: opus
+authority: backend-code
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Backend Specialist Agent
 
 > **Domain**: Node.js backend architecture, API design, middleware patterns, error handling, logging, service layer patterns  

package/.agent/agents/code-reviewer.md

@@ -4,6 +4,7 @@ description: Expert code review specialist ensuring high standards of quality an
 model: opus
 authority: approval-gate
 reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — Code Reviewer Agent

package/.agent/agents/database-architect.md

@@ -1,3 +1,14 @@
+---
+name: database-architect
+description: "Database design, schema optimization, and query performance specialist"
+domain: database
+triggers: [database, sql, postgresql, schema, migration, query]
+model: opus
+authority: schema-level
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Database Architect
 
 > **Platform**: Antigravity AI Kit

package/.agent/agents/devops-engineer.md

@@ -1,3 +1,14 @@
+---
+name: devops-engineer
+description: "CI/CD, deployment, infrastructure, and monitoring specialist"
+domain: devops
+triggers: [deploy, ci, cd, docker, kubernetes, pipeline]
+model: opus
+authority: infrastructure
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # DevOps Engineer
 
 > **Platform**: Antigravity AI Kit

package/.agent/agents/e2e-runner.md

@@ -4,6 +4,7 @@ description: End-to-end testing specialist using Playwright for comprehensive us
 model: opus
 authority: test-execution
 reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — E2E Runner Agent

package/.agent/agents/explorer-agent.md

@@ -1,3 +1,14 @@
+---
+name: explorer-agent
+description: "Codebase discovery, architectural analysis, and onboarding specialist"
+domain: discovery
+triggers: [explore, discover, analyze, map, onboard]
+model: opus
+authority: read-only
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Explorer Agent
 
 > **Platform**: Antigravity AI Kit

package/.agent/agents/frontend-specialist.md

@@ -1,3 +1,14 @@
+---
+name: frontend-specialist
+description: "Frontend architecture, React/Next.js patterns, component design specialist"
+domain: frontend
+triggers: [frontend, component, css, react, nextjs, ui, ux]
+model: opus
+authority: frontend-code
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Frontend Specialist Agent
 
 > **Domain**: Frontend architecture, React/Next.js patterns, component design, CSS architecture, accessibility, responsive design  

package/.agent/agents/mobile-developer.md

@@ -1,3 +1,14 @@
+---
+name: mobile-developer
+description: "React Native/Expo mobile development specialist"
+domain: mobile
+triggers: [mobile, react native, expo, ios, android]
+model: opus
+authority: mobile-code
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Mobile Developer
 
 > **Platform**: Antigravity AI Kit

package/.agent/agents/performance-optimizer.md

@@ -1,3 +1,14 @@
+---
+name: performance-optimizer
+description: "Performance profiling, Core Web Vitals, and optimization specialist"
+domain: performance
+triggers: [slow, optimize, speed, bundle, lighthouse, web vitals]
+model: opus
+authority: performance-advisory
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Performance Optimizer
 
 > **Platform**: Antigravity AI Kit

package/.agent/agents/planner.md

@@ -4,6 +4,7 @@ description: Expert planning specialist for feature implementation. Use for comp
 model: opus
 authority: read-only-analysis
 reports-to: alignment-engine
+relatedWorkflows: [plan, orchestrate]
 ---
 
 # Antigravity AI Kit — Planner Agent

package/.agent/agents/refactor-cleaner.md

@@ -4,6 +4,7 @@ description: Dead code cleanup and refactoring specialist. Identifies and remove
 model: opus
 authority: cleanup-only
 reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — Refactor Cleaner Agent

package/.agent/agents/reliability-engineer.md

@@ -1,3 +1,14 @@
+---
+name: reliability-engineer
+description: "Operational reliability, CI/CD health, and production readiness specialist"
+domain: reliability
+triggers: [reliability, uptime, monitoring, sre, sla, slo, incident]
+model: opus
+authority: reliability-advisory
+reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
+---
+
 # Reliability Engineer Agent
 
 > **Domain**: Operational reliability, CI/CD health, dependency management, production readiness, error budgets, resilience patterns  

package/.agent/agents/security-reviewer.md

@@ -4,6 +4,7 @@ description: Security vulnerability analysis and comprehensive security audit sp
 model: opus
 authority: security-audit
 reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — Security Reviewer Agent

package/.agent/agents/sprint-orchestrator.md

@@ -1,3 +1,13 @@
+---
+name: sprint-orchestrator
+description: "Sprint planning, velocity tracking, and autonomous task prioritization specialist"
+domain: planning
+triggers: [sprint, velocity, backlog, milestone, retrospective, prioritize]
+model: opus
+authority: sprint-management
+reports-to: alignment-engine
+---
+
 # Sprint Orchestrator Agent
 
 > **Domain**: Sprint planning, velocity tracking, backlog management, retrospective analysis, autonomous task prioritization  

package/.agent/agents/tdd-guide.md

@@ -4,6 +4,7 @@ description: Test-Driven Development specialist enforcing write-tests-first meth
 model: opus
 authority: tdd-enforcement
 reports-to: alignment-engine
+relatedWorkflows: [orchestrate]
 ---
 
 # Antigravity AI Kit — TDD Guide Agent

package/.agent/commands/code-review.md

@@ -2,6 +2,7 @@
 name: code-review
 description: Perform comprehensive code review on files or directories
 invokes: code-reviewer
+workflow: review
 ---
 
 # /code-review

package/.agent/commands/debug.md

@@ -1,5 +1,6 @@
 ---
 description: Debug issues systematically
+workflow: debug
 ---
 
 # /debug Command

package/.agent/commands/deploy.md

@@ -1,5 +1,6 @@
 ---
 description: Deploy application to target environment
+workflow: deploy
 ---
 
 # /deploy Command

package/.agent/commands/plan.md

@@ -2,6 +2,7 @@
 name: plan
 description: Create a comprehensive implementation plan for a feature or change
 invokes: planner
+workflow: plan
 ---
 
 # /plan

package/.agent/commands/status.md

@@ -1,6 +1,7 @@
 ---
 name: status
 description: Display current session status and context
+workflow: status
 ---
 
 # /status

package/.agent/commands/tdd.md

@@ -2,6 +2,7 @@
 name: tdd
 description: Start test-driven development workflow for a component
 invokes: tdd-guide
+workflow: test
 ---
 
 # /tdd

package/.agent/contexts/brainstorm.md

@@ -0,0 +1,26 @@
+---
+mode: brainstorm
+description: "Ideas-only exploration mode — Socratic discovery without implementation"
+constraints: [no-code, no-modifications, socratic-only]
+agent-focus: [planner, explorer-agent]
+---
+
+# Brainstorm Mode Context
+
+## Behavioral Rules
+
+- Generate ideas and alternatives only — never write code
+- Ask Socratic questions to clarify requirements
+- Present minimum 3 options for every decision point
+- Support each option with evidence or industry precedent
+- Never commit to a single approach without user confirmation
+
+## Loaded Skills
+
+- `brainstorming` — Socratic discovery protocol
+
+## Exit Criteria
+
+- Requirements are clarified with concrete acceptance criteria
+- At least 3 viable approaches documented with trade-offs
+- User selects preferred approach for planning phase

package/.agent/contexts/debug.md

@@ -0,0 +1,28 @@
+---
+mode: debug
+description: "Systematic investigation mode — minimal changes, preserve evidence"
+constraints: [evidence-first, minimal-changes, root-cause-required]
+agent-focus: [build-error-resolver, tdd-guide]
+---
+
+# Debug Mode Context
+
+## Behavioral Rules
+
+- Identify root cause before applying any fix
+- Preserve all evidence (logs, stack traces, reproduction steps)
+- Make minimal, surgical changes — one fix per iteration
+- Always verify the fix resolves the original issue
+- Add regression tests to prevent recurrence
+
+## Loaded Skills
+
+- `debugging-strategies` — Systematic hypothesis testing
+- `testing-patterns` — Regression test creation
+
+## Exit Criteria
+
+- Root cause identified and documented
+- Fix applied with minimal code changes
+- Regression test added and passing
+- No new issues introduced (full test suite passes)

package/.agent/contexts/implement.md

@@ -0,0 +1,29 @@
+---
+mode: implement
+description: "Code-focused execution mode — follow approved plan, build incrementally"
+constraints: [plan-required, incremental-commits, tests-mandatory]
+agent-focus: [architect, tdd-guide, code-reviewer]
+---
+
+# Implement Mode Context
+
+## Behavioral Rules
+
+- Follow the approved implementation plan step-by-step
+- Write code that passes existing tests and adds new ones
+- Commit incrementally — one logical change per commit
+- Do not deviate from the plan without explicit user approval
+- Apply project conventions and coding standards strictly
+
+## Loaded Skills
+
+- `clean-code` — Code quality principles
+- `testing-patterns` — TDD and test structure
+- `architecture` — System design patterns
+
+## Exit Criteria
+
+- All plan steps completed
+- All tests pass (existing + new)
+- Build succeeds without errors
+- Code reviewed for quality standards

package/.agent/contexts/review.md

@@ -0,0 +1,27 @@
+---
+mode: review
+description: "Quality-focused critical analysis mode — verify standards compliance"
+constraints: [critical-lens, no-bias, evidence-based]
+agent-focus: [code-reviewer, security-reviewer]
+---
+
+# Review Mode Context
+
+## Behavioral Rules
+
+- Apply critical lens — assume nothing is correct until verified
+- Check against all quality gates (lint, types, tests, security)
+- No defense bias — report issues objectively regardless of author
+- Classify findings by severity (CRITICAL / HIGH / MEDIUM / LOW)
+- Block deployment for any CRITICAL or HIGH severity issue
+
+## Loaded Skills
+
+- `verification-loop` — Sequential quality gate pipeline
+- `security-practices` — OWASP vulnerability checks
+
+## Exit Criteria
+
+- All quality gates pass (lint, type-check, tests, security)
+- All CRITICAL and HIGH issues resolved
+- Review report generated with verdict (APPROVE / BLOCK / WARNING)

package/.agent/contexts/ship.md

@@ -0,0 +1,28 @@
+---
+mode: ship
+description: "Deployment-focused risk-aware mode — pre-flight checks, monitoring, rollback readiness"
+constraints: [rollback-plan-required, health-check-mandatory, no-friday-deploys]
+agent-focus: [devops-engineer, reliability-engineer]
+---
+
+# Ship Mode Context
+
+## Behavioral Rules
+
+- Verify all pre-flight checks pass before any deployment
+- Require a documented rollback plan for every deploy
+- Monitor health checks for minimum 15 minutes post-deploy
+- No deployments on Fridays unless critical hotfix
+- Follow the Production Merge Discipline from global rules
+
+## Loaded Skills
+
+- `deployment-procedures` — CI/CD workflows and rollback strategies
+
+## Exit Criteria
+
+- All pre-flight checks pass (tests, build, security, env vars)
+- Rollback plan documented and verified
+- Deployment executed successfully
+- Health checks pass for observation period
+- No error spikes in monitoring

package/.agent/engine/identity.json

@@ -0,0 +1,13 @@
+{
+  "developers": [
+    {
+      "id": "9c1dbf58766b",
+      "name": "emredursun",
+      "email": "info.emredursun@gmail.com",
+      "role": "owner",
+      "registeredAt": "2026-03-14T00:18:01.952Z",
+      "lastActiveAt": "2026-03-14T00:18:01.952Z"
+    }
+  ],
+  "activeId": "9c1dbf58766b"
+}

package/.agent/engine/loading-rules.json

@@ -94,5 +94,27 @@
     "maxSkillsPerSession": 6,
     "warningThresholdPercent": 80,
     "description": "Limits prevent context overflow. The kit selects only domain-relevant agents and skills for each task, keeping within the LLM context window."
-  }
+  },
+  "workflowBindings": [
+    { "workflow": "brainstorm", "loadAgents": [], "loadSkills": ["brainstorming"], "bindingType": "inferred" },
+    { "workflow": "quality-gate", "loadAgents": [], "loadSkills": ["brainstorming"], "bindingType": "inferred" },
+    { "workflow": "plan", "loadAgents": ["planner"], "loadSkills": ["plan-writing", "brainstorming"], "bindingType": "explicit" },
+    { "workflow": "create", "loadAgents": [], "loadSkills": ["app-builder", "clean-code"], "bindingType": "inferred" },
+    { "workflow": "enhance", "loadAgents": [], "loadSkills": ["clean-code", "testing-patterns"], "bindingType": "inferred" },
+    { "workflow": "preview", "loadAgents": [], "loadSkills": ["shell-conventions"], "bindingType": "inferred" },
+    { "workflow": "ui-ux-pro-max", "loadAgents": [], "loadSkills": ["ui-ux-pro-max", "frontend-patterns", "mobile-design"], "bindingType": "inferred" },
+    { "workflow": "test", "loadAgents": [], "loadSkills": ["testing-patterns", "webapp-testing"], "bindingType": "inferred" },
+    { "workflow": "review", "loadAgents": [], "loadSkills": ["verification-loop"], "bindingType": "inferred" },
+    { "workflow": "deploy", "loadAgents": [], "loadSkills": ["deployment-procedures"], "bindingType": "inferred" },
+    { "workflow": "debug", "loadAgents": [], "loadSkills": ["debugging-strategies"], "bindingType": "inferred" },
+    {
+      "workflow": "orchestrate",
+      "loadAgents": ["planner", "explorer-agent"],
+      "loadSkills": ["parallel-agents", "intelligent-routing"],
+      "bindingType": "explicit",
+      "dynamicAgentPool": ["architect", "backend-specialist", "frontend-specialist", "mobile-developer", "database-architect", "security-reviewer", "tdd-guide", "e2e-runner", "devops-engineer", "performance-optimizer", "reliability-engineer", "refactor-cleaner", "code-reviewer"]
+    },
+    { "workflow": "retrospective", "loadAgents": [], "loadSkills": ["verification-loop"], "bindingType": "inferred" },
+    { "workflow": "status", "loadAgents": [], "loadSkills": ["verification-loop"], "bindingType": "inferred" }
+  ]
 }

package/.agent/engine/marketplace-index.json

@@ -0,0 +1,29 @@
+{
+  "entries": [
+    {
+      "name": "ag-skill-docker-compose",
+      "description": "Docker Compose orchestration skill for multi-container deployments",
+      "repository": "https://github.com/antigravity-community/ag-skill-docker-compose",
+      "version": "1.0.0",
+      "tags": ["docker", "compose", "containers", "deployment", "devops"],
+      "author": "antigravity-community"
+    },
+    {
+      "name": "ag-skill-graphql-designer",
+      "description": "GraphQL schema design and query generation skill",
+      "repository": "https://github.com/antigravity-community/ag-skill-graphql-designer",
+      "version": "0.9.0",
+      "tags": ["graphql", "api", "schema", "design", "queries"],
+      "author": "antigravity-community"
+    },
+    {
+      "name": "ag-skill-accessibility-audit",
+      "description": "WCAG compliance auditing and remediation suggestions",
+      "repository": "https://github.com/antigravity-community/ag-skill-accessibility-audit",
+      "version": "1.1.0",
+      "tags": ["accessibility", "wcag", "a11y", "audit", "compliance"],
+      "author": "antigravity-community"
+    }
+  ],
+  "lastUpdated": null
+}

package/.agent/engine/reliability-config.json

@@ -0,0 +1,14 @@
+{
+  "schemaVersion": "1.0.0",
+  "description": "SRE reliability configuration — error budget tracking and operational thresholds",
+  "errorBudget": {
+    "enabled": true,
+    "description": "When error budget is exhausted, reliability work takes priority over feature work. Projects opt-in when monitoring infrastructure exists.",
+    "thresholds": {
+      "testFailureRatePercent": 5,
+      "buildFailureRatePercent": 2,
+      "deployRollbackRatePercent": 10
+    },
+    "resetCadence": "monthly"
+  }
+}

package/.agent/engine/sdlc-map.json

@@ -0,0 +1,44 @@
+{
+  "schemaVersion": "1.0.0",
+  "description": "Machine-readable SDLC phase-to-workflow mapping with bidirectional traversal",
+  "phases": {
+    "discover": {
+      "description": "Requirement exploration and validation",
+      "workflows": ["brainstorm", "quality-gate"],
+      "previous": null,
+      "next": "plan"
+    },
+    "plan": {
+      "description": "Structured implementation planning",
+      "workflows": ["plan"],
+      "previous": "discover",
+      "next": "build"
+    },
+    "build": {
+      "description": "Feature implementation and scaffolding",
+      "workflows": ["create", "enhance", "preview", "ui-ux-pro-max"],
+      "previous": "plan",
+      "next": "verify"
+    },
+    "verify": {
+      "description": "Testing and quality gate validation",
+      "workflows": ["test", "review"],
+      "previous": "build",
+      "next": "ship"
+    },
+    "ship": {
+      "description": "Production deployment with pre-flight checks",
+      "workflows": ["deploy"],
+      "previous": "verify",
+      "next": "evaluate"
+    },
+    "evaluate": {
+      "description": "Post-sprint retrospective audit",
+      "workflows": ["retrospective"],
+      "previous": "ship",
+      "next": "discover"
+    }
+  },
+  "reactive": ["debug", "orchestrate"],
+  "crossCutting": ["status"]
+}

package/.agent/engine/workflow-state.json

@@ -52,6 +52,14 @@
       "artifact": null,
       "startedAt": null,
       "completedAt": null
+    },
+    "MAINTAIN": {
+      "status": "pending",
+      "description": "Post-deploy monitoring and operational handoff",
+      "workflow": "status",
+      "artifact": null,
+      "startedAt": null,
+      "completedAt": null
     }
   },
   "transitions": [
@@ -111,9 +119,27 @@
     },
     {
       "from": "DEPLOY",
+      "to": "MAINTAIN",
+      "trigger": "Deployment health check passes",
+      "guard": "Health check verified healthy"
+    },
+    {
+      "from": "DEPLOY",
+      "to": "REVIEW",
+      "trigger": "Deployment health check fails",
+      "guard": "Health check failure detected"
+    },
+    {
+      "from": "IMPLEMENT",
+      "to": "PLAN",
+      "trigger": "Unexpected complexity discovered",
+      "guard": "Implementation reveals plan inadequacy"
+    },
+    {
+      "from": "MAINTAIN",
       "to": "IDLE",
-      "trigger": "Deployment complete",
-      "guard": "Health check passes"
+      "trigger": "Monitoring period complete",
+      "guard": "No issues detected during observation"
     }
   ],
   "history": []