antigravity-ai-kit 2.1.0 → 3.0.1

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": []

package/.agent/hooks/hooks.json

@@ -6,12 +6,12 @@
       "description": "Executed at the beginning of every AI session",
       "enforcement": "runtime",
       "actions": [
-        "Load session-context.md and session-state.json",
-        "Read engine/loading-rules.json for context budget",
-        "Read engine/workflow-state.json for lifecycle phase",
-        "Verify git status is clean or understood",
-        "Load domain-relevant agents and skills via loading-rules.json",
-        "Present session state to user before proceeding"
+        { "action": "Load session-context.md and session-state.json", "severity": "critical", "onFailure": "block" },
+        { "action": "Read engine/loading-rules.json for context budget", "severity": "high", "onFailure": "warn" },
+        { "action": "Read engine/workflow-state.json for lifecycle phase", "severity": "high", "onFailure": "warn" },
+        { "action": "Verify git status is clean or understood", "severity": "medium", "onFailure": "warn" },
+        { "action": "Load domain-relevant agents and skills via loading-rules.json", "severity": "high", "onFailure": "warn" },
+        { "action": "Present session state to user before proceeding", "severity": "critical", "onFailure": "block" }
       ]
     },
     {
@@ -19,12 +19,12 @@
       "description": "Executed at the end of every AI session",
       "enforcement": "runtime",
       "actions": [
-        "Update session-context.md with handoff notes",
-        "Update session-state.json with metadata",
-        "Update engine/workflow-state.json with phase progress",
-        "Trigger continuous-learning skill for pattern extraction",
-        "Update docs/ROADMAP.md if sprint items changed",
-        "Commit tracking files together"
+        { "action": "Update session-context.md with handoff notes", "severity": "critical", "onFailure": "block" },
+        { "action": "Update session-state.json with metadata", "severity": "critical", "onFailure": "block" },
+        { "action": "Update engine/workflow-state.json with phase progress", "severity": "high", "onFailure": "warn" },
+        { "action": "Trigger continuous-learning skill for pattern extraction", "severity": "low", "onFailure": "log" },
+        { "action": "Update docs/ROADMAP.md if sprint items changed", "severity": "medium", "onFailure": "warn" },
+        { "action": "Commit tracking files together", "severity": "high", "onFailure": "warn" }
       ]
     },
     {
@@ -32,17 +32,19 @@
       "description": "Verification before any git commit",
       "enforcement": "runtime",
       "actions": [
-        "Verify build passes (npm run build)",
-        "Verify lint passes (npm run lint)",
-        "Verify tests pass (npm test)",
-        "Check for console.log statements in production code",
-        "Verify no TypeScript errors (npx tsc --noEmit)"
+        { "action": "Verify build passes (npm run build)", "severity": "critical", "onFailure": "block" },
+        { "action": "Verify lint passes (npm run lint)", "severity": "critical", "onFailure": "block" },
+        { "action": "Verify tests pass (npm test)", "severity": "critical", "onFailure": "block" },
+        { "action": "Check for console.log statements in production code", "severity": "medium", "onFailure": "warn" },
+        { "action": "Verify no TypeScript errors (npx tsc --noEmit)", "severity": "critical", "onFailure": "block" }
       ]
     },
     {
       "event": "secret-detection",
       "description": "Scan for accidentally committed secrets",
       "enforcement": "git-hook",
+      "severity": "critical",
+      "onFailure": "block",
       "referenceScript": ".githooks/pre-commit",
       "patterns": [
         "sk-[a-zA-Z0-9]{20,}",
@@ -60,10 +62,10 @@
       "description": "Triggered when workflow lifecycle phase changes",
       "enforcement": "runtime",
       "actions": [
-        "Validate transition guard from engine/workflow-state.json",
-        "Record transition in workflow-state.json history",
-        "Load/unload agents appropriate for new phase",
-        "Notify user of phase change with next suggested action"
+        { "action": "Validate transition guard from engine/workflow-state.json", "severity": "critical", "onFailure": "block" },
+        { "action": "Record transition in workflow-state.json history", "severity": "high", "onFailure": "warn" },
+        { "action": "Load/unload agents appropriate for new phase", "severity": "high", "onFailure": "warn" },
+        { "action": "Notify user of phase change with next suggested action", "severity": "medium", "onFailure": "warn" }
       ]
     },
     {
@@ -71,10 +73,10 @@
       "description": "Triggered at sprint boundaries for health assessment",
       "enforcement": "runtime",
       "actions": [
-        "Sprint orchestrator generates health report",
-        "Review velocity metrics against plan",
-        "Identify carry-over candidates",
-        "Produce sprint retrospective if ending"
+        { "action": "Sprint orchestrator generates health report", "severity": "high", "onFailure": "warn" },
+        { "action": "Review velocity metrics against plan", "severity": "medium", "onFailure": "warn" },
+        { "action": "Identify carry-over candidates", "severity": "medium", "onFailure": "log" },
+        { "action": "Produce sprint retrospective if ending", "severity": "high", "onFailure": "warn" }
       ]
     }
   ]

package/.agent/manifest.json

@@ -1,6 +1,7 @@
 {
   "schemaVersion": "1.0.0",
-  "kitVersion": "2.1.0",
+  "kitVersion": "2.2.0",
+  "lastAuditedAt": "2026-03-13T19:55:00Z",
   "description": "Antigravity AI Kit — Trust-Grade AI Development Framework",
   "repository": "https://github.com/besync-labs/antigravity-ai-kit",
   "capabilities": {
@@ -33,7 +34,7 @@
       "directory": "commands/"
     },
     "skills": {
-      "count": 27,
+      "count": 31,
       "items": [
         { "name": "api-patterns", "directory": "skills/api-patterns/" },
         { "name": "app-builder", "directory": "skills/app-builder/" },
@@ -51,6 +52,8 @@
         { "name": "frontend-patterns", "directory": "skills/frontend-patterns/" },
         { "name": "git-workflow", "directory": "skills/git-workflow/" },
         { "name": "intelligent-routing", "directory": "skills/intelligent-routing/" },
+        { "name": "i18n-localization", "directory": "skills/i18n-localization/" },
+        { "name": "mcp-integration", "directory": "skills/mcp-integration/" },
         { "name": "mobile-design", "directory": "skills/mobile-design/" },
         { "name": "nodejs-patterns", "directory": "skills/nodejs-patterns/" },
         { "name": "parallel-agents", "directory": "skills/parallel-agents/" },
@@ -60,12 +63,14 @@
         { "name": "strategic-compact", "directory": "skills/strategic-compact/" },
         { "name": "testing-patterns", "directory": "skills/testing-patterns/" },
         { "name": "typescript-expert", "directory": "skills/typescript-expert/" },
+        { "name": "ui-ux-pro-max", "directory": "skills/ui-ux-pro-max/" },
         { "name": "verification-loop", "directory": "skills/verification-loop/" },
-        { "name": "webapp-testing", "directory": "skills/webapp-testing/" }
+        { "name": "webapp-testing", "directory": "skills/webapp-testing/" },
+        { "name": "shell-conventions", "directory": "skills/shell-conventions/" }
       ]
     },
     "workflows": {
-      "count": 11,
+      "count": 14,
       "items": [
         { "name": "brainstorm", "file": "workflows/brainstorm.md" },
         { "name": "create", "file": "workflows/create.md" },
@@ -75,6 +80,9 @@
         { "name": "orchestrate", "file": "workflows/orchestrate.md" },
         { "name": "plan", "file": "workflows/plan.md" },
         { "name": "preview", "file": "workflows/preview.md" },
+        { "name": "quality-gate", "file": "workflows/quality-gate.md" },
+        { "name": "retrospective", "file": "workflows/retrospective.md" },
+        { "name": "review", "file": "workflows/review.md" },
         { "name": "status", "file": "workflows/status.md" },
         { "name": "test", "file": "workflows/test.md" },
         { "name": "ui-ux-pro-max", "file": "workflows/ui-ux-pro-max.md" }

package/.agent/rules.md

@@ -60,7 +60,7 @@ Standardized entry points for developer intent across 8 categories.
 
 See `commands/README.md` for full documentation.
 
-### Skills (27 Core)
+### Skills (28 Core)
 
 | Skill                                                            | Purpose                       |
 | ---------------------------------------------------------------- | ----------------------------- |
@@ -90,6 +90,7 @@ See `commands/README.md` for full documentation.
 | [security-practices](./skills/security-practices/SKILL.md)       | OWASP, vulnerability prevention |
 | [docker-patterns](./skills/docker-patterns/SKILL.md)             | Containerization              |
 | [git-workflow](./skills/git-workflow/SKILL.md)                   | Branching, commits            |
+| [mcp-integration](./skills/mcp-integration/SKILL.md)             | MCP server integration        |
 
 ### Skill Loading Protocol
 

package/.agent/skills/README.md

@@ -1,7 +1,7 @@
 # Antigravity AI Kit — Skills
 
 > **Purpose**: Workflow definitions and domain knowledge extensions
-> **Count**: 26 Skills (4 Operational + 3 Orchestration + 12 Domain + 7 Development)
+> **Count**: 31 Skills (5 Operational + 4 Orchestration + 13 Domain + 9 Development)
 
 ---
 
@@ -25,7 +25,7 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 
 ---
 
-## Operational Skills (4)
+## Operational Skills (5)
 
 | Skill                                               | Purpose                   |
 | :-------------------------------------------------- | :------------------------ |
@@ -33,20 +33,22 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 | [continuous-learning](continuous-learning/SKILL.md) | Pattern extraction (PAAL) |
 | [strategic-compact](strategic-compact/SKILL.md)     | Context window management |
 | [eval-harness](eval-harness/SKILL.md)               | Performance evaluation    |
+| [context-budget](context-budget/SKILL.md)           | LLM token budget mgmt    |
 
 ---
 
-## Orchestration Skills (3)
+## Orchestration Skills (4)
 
 | Skill                                               | Purpose                     |
 | :-------------------------------------------------- | :-------------------------- |
 | [intelligent-routing](intelligent-routing/SKILL.md) | Automatic agent selection   |
 | [parallel-agents](parallel-agents/SKILL.md)         | Multi-agent orchestration   |
 | [behavioral-modes](behavioral-modes/SKILL.md)       | Adaptive AI operation modes |
+| [mcp-integration](mcp-integration/SKILL.md)         | MCP server integration      |
 
 ---
 
-## Domain Skills (12)
+## Domain Skills (13)
 
 ### Architecture & Design
 
@@ -57,6 +59,7 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 | [database-design](database-design/SKILL.md)     | Schema optimization      |
 | [frontend-patterns](frontend-patterns/SKILL.md) | React/component patterns |
 | [nodejs-patterns](nodejs-patterns/SKILL.md)     | Backend patterns         |
+| [i18n-localization](i18n-localization/SKILL.md) | Internationalization     |
 
 ### Code Quality
 
@@ -77,7 +80,7 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 
 ---
 
-## Development Skills (7)
+## Development Skills (9)
 
 | Skill                                                   | Purpose                       |
 | :------------------------------------------------------ | :---------------------------- |
@@ -88,6 +91,8 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 | [performance-profiling](performance-profiling/SKILL.md) | Core Web Vitals optimization  |
 | [brainstorming](brainstorming/SKILL.md)                 | Socratic discovery protocol   |
 | [plan-writing](plan-writing/SKILL.md)                   | Structured task breakdown     |
+| [shell-conventions](shell-conventions/SKILL.md)         | PowerShell/Bash conventions   |
+| [ui-ux-pro-max](ui-ux-pro-max/SKILL.md)                | Premium UI/UX design system   |
 
 ---