antigravity-ai-kit 3.7.0 → 3.9.0

package/.agent/commands/pr-status.md

@@ -0,0 +1,56 @@
+---
+description: Triage pull requests with CI status, staleness detection, and dependency readiness
+---
+
+# /pr-status Command
+
+Quick triage view for one or more pull requests — CI status, review state, staleness, dependency readiness, and merge eligibility at a glance.
+
+## Usage
+
+```
+/pr-status                          # All open PRs in current repo
+/pr-status #<number>                # Single PR status
+/pr-status <url>                    # PR at GitHub URL
+/pr-status <owner/repo>            # All open PRs in specified repo
+/pr-status #<number> --deps         # Show dependency chain status
+```
+
+## Examples
+
+```
+/pr-status                          # Triage all open PRs
+/pr-status #42                      # Status of PR #42
+/pr-status https://github.com/org/repo/pull/10
+/pr-status deelmarkt/app            # All open PRs in deelmarkt/app
+/pr-status #42 --deps               # Dependency chain for PR #42
+```
+
+## What It Does
+
+1. Fetches PR metadata (state, reviews, checks, labels)
+2. Classifies CI status (passing / failing / pending / none)
+3. Detects staleness (days since last update, sync status with target)
+4. Validates dependency chain (`Depends-On:` references)
+5. Calculates merge readiness score (0-100)
+6. Outputs a triage dashboard with actionable next steps
+
+## Output
+
+```
+PR #42 — feat(auth): add OAuth2 provider
+├─ Status: OPEN
+├─ Reviews: 1/1 APPROVED
+├─ CI: ✓ All checks passing (3/3)
+├─ Staleness: Fresh (updated 2h ago, in sync with main)
+├─ Dependencies: #40 MERGED, #41 OPEN (blocking)
+├─ Merge Ready: No — dependency #41 not yet merged
+└─ Next: Merge #41 first, then this PR is ready
+```
+
+## Related
+
+- `/pr` — Create a pull request
+- `/pr-review` — Review a pull request
+- `/pr-merge` — Merge a pull request safely
+- `/pr-describe` — Auto-generate PR description

package/.agent/commands/pr.md

@@ -1,30 +1,58 @@
----
-description: Create and manage pull requests
----
-
-# /pr Command
-
-Create, review, or manage pull requests.
-
-## Usage
-
-```
-/pr create             # Create new PR
-/pr review <number>    # Review existing PR
-/pr update             # Update PR description
-```
-
-## Examples
-
-```
-/pr create
-/pr review 123
-/pr update with latest changes
-```
-
-## PR Template
-
-- **Title**: Clear, conventional commit style
-- **Description**: What changes were made
-- **Testing**: How to test the changes
-- **Checklist**: Required checks completed
+---
+description: Create production-grade pull requests with branch validation, size guards, and CI verification
+---
+
+# /pr Command
+
+Create pull requests with branch strategy validation, size/scope guards, pre-flight checks, and CI verification.
+
+## Usage
+
+```
+/pr                    # Create PR targeting default branch
+/pr [target]           # Create PR targeting specific branch (e.g., /pr dev)
+/pr --draft            # Create PR as draft
+/pr --draft [target]   # Create draft PR targeting specific branch
+```
+
+## Examples
+
+```
+/pr                    # Auto-detects target via branch strategy
+/pr dev                # Target dev branch explicitly
+/pr --draft            # Create draft PR
+/pr main               # Target main (validated against strategy)
+```
+
+## What It Does
+
+1. Detects branch strategy (GitFlow / Trunk-Based) and validates target
+2. Syncs with target branch and resolves conflicts
+3. Checks PR size (XS-XL) and scope coherence
+4. Runs pre-flight `/review` pipeline (lint, types, tests, security, build)
+5. Generates conventional commit title from branch name
+6. Creates PR with structured body (Summary, Changes, Test Plan)
+7. Monitors CI pipeline status
+
+## PR Toolkit
+
+| Command | Purpose |
+| :--- | :--- |
+| `/pr` | Create a pull request |
+| `/pr-review #N` | Review an existing PR |
+| `/pr-fix #N` | Fix PR based on review comments |
+| `/pr-merge #N` | Merge PR safely with validation |
+| `/pr-split` | Split oversized PR into sub-PRs |
+| `/pr-status` | Triage PRs with merge readiness |
+| `/pr-describe` | Auto-generate PR description |
+
+## Related
+
+- `/pr-review` — Review a pull request
+- `/pr-fix` — Fix issues from review comments
+- `/pr-merge` — Merge with dependency validation
+- `/pr-split` — Split oversized PRs
+- `/pr-status` — Check merge readiness
+- `/pr-describe` — Auto-generate description
+- `/review` — Local code quality gates
+- `/preflight` — Production readiness check

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

@@ -126,6 +126,11 @@
     { "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": "pr", "loadAgents": ["pr-reviewer"], "loadSkills": ["git-workflow", "pr-toolkit", "verification-loop"], "bindingType": "explicit" },
+    { "workflow": "pr-review", "loadAgents": ["pr-reviewer"], "loadSkills": ["pr-toolkit", "verification-loop"], "bindingType": "explicit" },
+    { "workflow": "pr-fix", "loadAgents": ["pr-reviewer"], "loadSkills": ["pr-toolkit", "verification-loop"], "bindingType": "explicit" },
+    { "workflow": "pr-merge", "loadAgents": ["pr-reviewer"], "loadSkills": ["pr-toolkit", "verification-loop"], "bindingType": "explicit" },
+    { "workflow": "pr-split", "loadAgents": ["pr-reviewer"], "loadSkills": ["pr-toolkit"], "bindingType": "explicit" },
     { "workflow": "deploy", "loadAgents": [], "loadSkills": ["deployment-procedures"], "bindingType": "inferred" },
     { "workflow": "debug", "loadAgents": [], "loadSkills": ["debugging-strategies"], "bindingType": "inferred" },
     {

package/.agent/hooks/README.md

@@ -1,7 +1,7 @@
 # Antigravity AI Kit — Hooks
 
 > **Purpose**: Event-driven automation triggered by specific actions  
-> **Count**: 4 Core Hooks + Templates
+> **Count**: 8 Event Hooks
 
 ---
 
@@ -15,10 +15,14 @@ Hooks are automated actions triggered by events during development sessions. The
 
 | Hook               | Trigger           | Action                | Status |
 | :----------------- | :---------------- | :-------------------- | :----- |
-| `session-start`    | Session begins    | Load context          | Active |
-| `session-end`      | Session ends      | Save state            | Active |
-| `pre-commit`       | Before git commit | Run verification      | Active |
-| `secret-detection` | After file write  | Block exposed secrets | Active |
+| `session-start`      | Session begins       | Load context            | Active |
+| `session-end`        | Session ends         | Save state              | Active |
+| `pre-commit`         | Before git commit    | Run verification        | Active |
+| `secret-detection`   | After file write     | Block exposed secrets   | Active |
+| `phase-transition`   | Workflow phase change| Enforce SDLC gates      | Active |
+| `sprint-checkpoint`  | Sprint milestone     | Progress verification   | Active |
+| `plan-complete`      | Plan finalized       | Plan validation trigger | Active |
+| `task-complete`      | Task finished        | Completion verification | Active |
 
 ---
 

package/.agent/manifest.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": "1.0.0",
-  "kitVersion": "3.7.0",
+  "kitVersion": "3.9.0",
   "lastAuditedAt": null,
   "description": "Antigravity AI Kit — Trust-Grade AI Development Framework",
   "repository": "https://github.com/besync-labs/antigravity-ai-kit",
   "capabilities": {
     "agents": {
-      "count": 19,
+      "count": 20,
       "items": [
         {
           "name": "architect",
@@ -78,6 +78,11 @@
           "file": "agents/planner.md",
           "domain": "Task breakdown, Socratic analysis"
         },
+        {
+          "name": "pr-reviewer",
+          "file": "agents/pr-reviewer.md",
+          "domain": "PR review, branch strategy, code quality"
+        },
         {
           "name": "refactor-cleaner",
           "file": "agents/refactor-cleaner.md",
@@ -106,11 +111,11 @@
       ]
     },
     "commands": {
-      "count": 31,
+      "count": 37,
       "directory": "commands/"
     },
     "skills": {
-      "count": 33,
+      "count": 34,
       "items": [
         {
           "name": "api-patterns",
@@ -208,6 +213,10 @@
           "name": "plan-writing",
           "directory": "skills/plan-writing/"
         },
+        {
+          "name": "pr-toolkit",
+          "directory": "skills/pr-toolkit/"
+        },
         {
           "name": "production-readiness",
           "directory": "skills/production-readiness/"
@@ -247,7 +256,7 @@
       ]
     },
     "workflows": {
-      "count": 16,
+      "count": 21,
       "items": [
         {
           "name": "brainstorm",
@@ -281,6 +290,22 @@
           "name": "pr",
           "file": "workflows/pr.md"
         },
+        {
+          "name": "pr-review",
+          "file": "workflows/pr-review.md"
+        },
+        {
+          "name": "pr-fix",
+          "file": "workflows/pr-fix.md"
+        },
+        {
+          "name": "pr-merge",
+          "file": "workflows/pr-merge.md"
+        },
+        {
+          "name": "pr-split",
+          "file": "workflows/pr-split.md"
+        },
         {
           "name": "preflight",
           "file": "workflows/preflight.md"
@@ -312,12 +337,20 @@
         {
           "name": "ui-ux-pro-max",
           "file": "workflows/ui-ux-pro-max.md"
+        },
+        {
+          "name": "upgrade",
+          "file": "workflows/upgrade.md"
         }
       ]
     },
     "rules": {
-      "count": 8,
+      "count": 9,
       "items": [
+        {
+          "name": "agent-upgrade-policy",
+          "file": "rules/agent-upgrade-policy.md"
+        },
         {
           "name": "architecture",
           "file": "rules/architecture.md"

package/.agent/rules/agent-upgrade-policy.md

@@ -0,0 +1,56 @@
+# Agent Upgrade Policy
+
+> **Priority**: CRITICAL — Inviolable
+> **Scope**: All AI Agent interactions related to framework initialization, upgrading, and state mutation.
+
+---
+
+## 1. The Preservation Contract
+
+The Antigravity AI Kit exists organically alongside user code. User customizations must survive framework upgrades.
+
+The following files and directories are **STRICTLY PROTECTED**:
+
+| Protected Item | Type | Reason |
+| :--- | :--- | :--- |
+| `.agent/session-state.json` | File | Active session metadata |
+| `.agent/session-context.md` | File | Session narrative context |
+| `.agent/identity.json` | File | User/project identity (may contain PII) |
+| `.agent/rules/` | Directory | User-customized governance rules |
+| `.agent/checklists/` | Directory | User-customized quality gates |
+| `.agent/decisions/` | Directory | Architecture Decision Records |
+| `.agent/contexts/` | Directory | Learning data and plan quality logs |
+
+This is the **canonical list**. The `/upgrade` workflow references this list — do not duplicate or abbreviate it elsewhere.
+
+---
+
+## 2. Non-Destructive Upgrades Only
+
+| Command | Purpose | Safety |
+| :--- | :--- | :--- |
+| `ag-kit update` | Non-destructive AST merger | Safe — preserves protected items |
+| `ag-kit update --dry-run` | Preview upgrade changes | Safe — read-only |
+| `init --force` | Catastrophic repair | **DESTRUCTIVE** — wipes protected items |
+
+- **Mandated**: Use `ag-kit update` for all routine upgrades
+- **Prohibited**: Never use `init --force` for routine upgrades. This is a last-resort catastrophic repair command that wipes protected files
+
+---
+
+## 3. Upgrade Governance
+
+The `/upgrade` workflow follows the standard EWS v1.0 governance model:
+
+- **Human confirmation required** before executing `ag-kit update`
+- **Post-upgrade verification** via `ag-kit verify` is mandatory
+- **Preservation verification** — all 7 protected items must be confirmed intact after upgrade
+- **Rollback available** — `git checkout -- .agent/` restores pre-upgrade state if uncommitted
+
+---
+
+## Related Resources
+
+- **Workflow**: `.agent/workflows/upgrade.md` (`/upgrade`)
+- **Skill**: `.agent/skills/verification-loop/SKILL.md`
+- **See also**: `.agent/rules/security.md` (secrets in upgrade payloads), `.agent/rules/git-workflow.md` (commit conventions after upgrade)

package/.agent/session-context.md

@@ -32,7 +32,7 @@
 
 **Branch**: —  
 **Repository**: —  
-**Framework**: Antigravity AI Kit v3.7.0
+**Framework**: Antigravity AI Kit v3.9.0
 
 ### Key File Locations
 

package/.agent/skills/README.md

@@ -1,7 +1,7 @@
 # Antigravity AI Kit — Skills
 
 > **Purpose**: Workflow definitions and domain knowledge extensions
-> **Count**: 32 Skills (6 Operational + 4 Orchestration + 13 Domain + 9 Development)
+> **Count**: 34 Skills (7 Operational + 4 Orchestration + 13 Domain + 10 Development)
 
 ---
 
@@ -34,6 +34,7 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 | [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    |
+| [plan-validation](plan-validation/SKILL.md)           | Plan quality gate           |
 | [production-readiness](production-readiness/SKILL.md) | Production readiness audits |
 
 ---
@@ -81,7 +82,7 @@ Skills are automatically loaded based on task context. Agents invoke relevant sk
 
 ---
 
-## Development Skills (9)
+## Development Skills (10)
 
 | Skill                                                   | Purpose                       |
 | :------------------------------------------------------ | :---------------------------- |
@@ -92,6 +93,7 @@ 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     |
+| [pr-toolkit](pr-toolkit/SKILL.md)                       | PR lifecycle domain knowledge |
 | [shell-conventions](shell-conventions/SKILL.md)         | PowerShell/Bash conventions   |
 | [ui-ux-pro-max](ui-ux-pro-max/SKILL.md)                | Premium UI/UX design system   |