antigravity-ai-kit 3.7.0 → 3.9.0

package/.agent/commands/README.md

@@ -1,119 +1,130 @@
-# Antigravity AI Kit — Commands
-
-> **Purpose**: Slash commands for quick access to common operations
-> **Count**: 31 Commands
-
----
-
-## Overview
-
-Commands are quick invocations that trigger specific actions or workflows. Type `/command-name` in chat to use.
-
----
-
-## Command Categories
-
-### Core Workflow
-
-| Command      | Description                |
-| :----------- | :------------------------- |
-| `/plan`      | Create implementation plan |
-| `/implement` | Execute the approved plan  |
-| `/verify`    | Run all quality gates      |
-| `/status`    | Check project status       |
-
-### Development
-
-| Command     | Description                        |
-| :---------- | :--------------------------------- |
-| `/build`    | Build a new feature from scratch   |
-| `/fix`      | Fix linting, type, or build errors |
-| `/debug`    | Systematic debugging process       |
-| `/refactor` | Improve code quality               |
-| `/cook`     | Full scratch-to-done workflow      |
-
-### Documentation & Git
-
-| Command      | Description                         |
-| :----------- | :---------------------------------- |
-| `/doc`       | Generate documentation              |
-| `/adr`       | Create Architecture Decision Record |
-| `/changelog` | Generate changelog from commits     |
-| `/git`       | Git operations with best practices  |
-| `/pr`        | Create or manage pull requests      |
-
-### Exploration & Research
-
-| Command     | Description                        |
-| :---------- | :--------------------------------- |
-| `/scout`    | Explore and understand codebase    |
-| `/research` | Research technologies or solutions |
-| `/ask`      | Ask questions about code           |
-
-### Quality & Security
-
-| Command          | Description                           |
-| :--------------- | :------------------------------------ |
-| `/code-review`   | Run code review                       |
-| `/tdd`           | Test-driven development workflow      |
-| `/security-scan` | Security audit and vulnerability scan |
-| `/perf`          | Performance analysis and optimization |
-
-### Integration & Deployment
-
-| Command      | Description                     |
-| :----------- | :------------------------------ |
-| `/integrate` | Third-party service integration |
-| `/db`        | Database schema and migrations  |
-| `/deploy`    | Deploy to target environment    |
-| `/design`    | UI/UX design specifications     |
-
-### Context Management
-
-| Command       | Description                   |
-| :------------ | :---------------------------- |
-| `/learn`      | Extract patterns from session |
-| `/checkpoint` | Save progress checkpoint      |
-| `/compact`    | Compress context for memory   |
-| `/eval`       | Evaluate metrics              |
-| `/setup`      | Configure project with kit    |
-| `/help`       | Show available commands       |
-
----
-
-## Command Format
-
-```markdown
----
-description: What this command does
----
-
-# /command-name Command
-
-Brief description.
-
-## Usage
-
-\`\`\`
-/command-name [options]
-\`\`\`
-
-## Examples
-
-\`\`\`
-/command-name example usage
-\`\`\`
-
-## Process
-
-1. Step 1
-2. Step 2
-```
-
----
-
-## Creating Custom Commands
-
-1. Create `commands/my-command.md`
-2. Add frontmatter with `description`
-3. Define usage, examples, and process
+# Antigravity AI Kit — Commands
+
+> **Purpose**: Slash commands for quick access to common operations
+> **Count**: 37 Commands
+
+---
+
+## Overview
+
+Commands are quick invocations that trigger specific actions or workflows. Type `/command-name` in chat to use.
+
+---
+
+## Command Categories
+
+### Core Workflow
+
+| Command      | Description                |
+| :----------- | :------------------------- |
+| `/plan`      | Create implementation plan |
+| `/implement` | Execute the approved plan  |
+| `/verify`    | Run all quality gates      |
+| `/status`    | Check project status       |
+
+### Development
+
+| Command     | Description                        |
+| :---------- | :--------------------------------- |
+| `/build`    | Build a new feature from scratch   |
+| `/fix`      | Fix linting, type, or build errors |
+| `/debug`    | Systematic debugging process       |
+| `/refactor` | Improve code quality               |
+| `/cook`     | Full scratch-to-done workflow      |
+
+### Documentation & Git
+
+| Command      | Description                         |
+| :----------- | :---------------------------------- |
+| `/doc`       | Generate documentation              |
+| `/adr`       | Create Architecture Decision Record |
+| `/changelog` | Generate changelog from commits     |
+| `/git`       | Git operations with best practices  |
+| `/pr`        | Create production-grade pull requests |
+
+### PR Toolkit
+
+| Command        | Description                                     |
+| :------------- | :---------------------------------------------- |
+| `/pr-review`   | Review a PR with senior engineering expertise    |
+| `/pr-fix`      | Fix PR issues based on review comments           |
+| `/pr-merge`    | Merge PR safely with dependency validation       |
+| `/pr-split`    | Split oversized PRs into focused sub-PRs         |
+| `/pr-status`   | Triage PRs with CI, staleness, and merge readiness |
+| `/pr-describe` | Auto-generate PR title, summary, and labels      |
+
+### Exploration & Research
+
+| Command     | Description                        |
+| :---------- | :--------------------------------- |
+| `/scout`    | Explore and understand codebase    |
+| `/research` | Research technologies or solutions |
+| `/ask`      | Ask questions about code           |
+
+### Quality & Security
+
+| Command          | Description                           |
+| :--------------- | :------------------------------------ |
+| `/code-review`   | Run code review                       |
+| `/tdd`           | Test-driven development workflow      |
+| `/security-scan` | Security audit and vulnerability scan |
+| `/perf`          | Performance analysis and optimization |
+
+### Integration & Deployment
+
+| Command      | Description                     |
+| :----------- | :------------------------------ |
+| `/integrate` | Third-party service integration |
+| `/db`        | Database schema and migrations  |
+| `/deploy`    | Deploy to target environment    |
+| `/design`    | UI/UX design specifications     |
+
+### Context Management
+
+| Command       | Description                   |
+| :------------ | :---------------------------- |
+| `/learn`      | Extract patterns from session |
+| `/checkpoint` | Save progress checkpoint      |
+| `/compact`    | Compress context for memory   |
+| `/eval`       | Evaluate metrics              |
+| `/setup`      | Configure project with kit    |
+| `/help`       | Show available commands       |
+
+---
+
+## Command Format
+
+```markdown
+---
+description: What this command does
+---
+
+# /command-name Command
+
+Brief description.
+
+## Usage
+
+\`\`\`
+/command-name [options]
+\`\`\`
+
+## Examples
+
+\`\`\`
+/command-name example usage
+\`\`\`
+
+## Process
+
+1. Step 1
+2. Step 2
+```
+
+---
+
+## Creating Custom Commands
+
+1. Create `commands/my-command.md`
+2. Add frontmatter with `description`
+3. Define usage, examples, and process

package/.agent/commands/help.md

@@ -10,10 +10,10 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
 
 ```
 /help                  # Quick overview of all capabilities
-/help commands         # All 31 slash commands with descriptions
-/help workflows        # All 15 workflows with descriptions
-/help agents           # All 19 AI agents with domains
-/help skills           # All 32 skill modules
+/help commands         # All 37 slash commands with descriptions
+/help workflows        # All 21 workflows with descriptions
+/help agents           # All 20 AI agents with domains
+/help skills           # All 34 skill modules
 /help rules            # Governance rules
 /help checklists       # Quality gate checklists
 /help cli              # Terminal CLI commands (ag-kit)
@@ -24,15 +24,15 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
 
 ## Quick Overview
 
-**Antigravity AI Kit v3.7.0** — Trust-Grade AI Development Framework
+**Antigravity AI Kit v3.9.0** — Trust-Grade AI Development Framework
 
 | Category | Count | Description |
 |:---------|:------|:------------|
-| ⌨️ Commands | 31 | Slash commands for every development task |
-| 🔄 Workflows | 14 | Multi-step development lifecycles |
-| 🤖 Agents | 19 | Specialized AI roles for delegation |
-| 🛠️ Skills | 32 | Domain knowledge modules |
-| ⚖️ Rules | 8 | Modular governance constraints |
+| ⌨️ Commands | 37 | Slash commands for every development task |
+| 🔄 Workflows | 21 | Multi-step development lifecycles |
+| 🤖 Agents | 20 | Specialized AI roles for delegation |
+| 🛠️ Skills | 34 | Domain knowledge modules |
+| ⚖️ Rules | 9 | Modular governance constraints |
 | ✅ Checklists | 4 | Quality gate checklists |
 | ⚙️ Runtime | 29 | Engine modules (governance, reputation, self-healing) |
 
@@ -53,7 +53,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
 
 ---
 
-## Commands (31)
+## Commands (37)
 
 ### Core Workflow
 
@@ -93,7 +93,13 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
 | `/adr` | Create Architecture Decision Record |
 | `/changelog` | Generate changelog from commits |
 | `/git` | Git operations with best practices |
-| `/pr` | Create or manage pull requests |
+| `/pr` | Create production-grade pull requests |
+| `/pr-review` | Review a pull request with senior engineering expertise |
+| `/pr-fix` | Fix PR issues based on review comments |
+| `/pr-merge` | Merge PR safely with dependency validation |
+| `/pr-split` | Split oversized PRs into focused sub-PRs |
+| `/pr-status` | Triage PRs with CI, staleness, and merge readiness |
+| `/pr-describe` | Auto-generate PR title, summary, and labels |
 | `/checkpoint` | Save progress checkpoint for session continuity |
 
 ### Exploration & Research
@@ -123,7 +129,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
 
 ---
 
-## Workflows (14)
+## Workflows (21)
 
 Workflows are multi-step development lifecycles. Use them with the `/` prefix.
 
@@ -136,6 +142,12 @@ Workflows are multi-step development lifecycles. Use them with the `/` prefix.
 | `/enhance` | Iterative feature improvement | Analyze → plan → implement → validate |
 | `/orchestrate` | Multi-agent task coordination | Decompose → delegate → merge → verify |
 | `/plan` | Implementation planning | Research → design → breakdown → verify |
+| `/pr` | Production-grade PR creation | Branch validation → size guard → review → push → CI |
+| `/pr-review` | Multi-perspective PR review | Fetch → analyze → 6-perspective review → post verdict |
+| `/pr-fix` | Fix PR based on review comments | Fetch reviews → prioritize → fix → verify → push |
+| `/pr-merge` | Safe PR merge | Validate → verify prerequisites → merge → post-merge checks |
+| `/pr-split` | Split oversized PRs | Analyze → categorize → split plan → create sub-PRs |
+| `/preflight` | Production readiness audit | 10-domain assessment → scoring → verdict |
 | `/preview` | Local dev server management | Start → verify → iterate → stop |
 | `/quality-gate` | Pre-task validation protocol | Market research → gap analysis → ethics review |
 | `/retrospective` | Sprint audit and review | Metrics → findings → action items |
@@ -143,10 +155,11 @@ Workflows are multi-step development lifecycles. Use them with the `/` prefix.
 | `/status` | Project state overview | Session → git → health → capabilities |
 | `/test` | Systematic test writing | Strategy → write → run → coverage |
 | `/ui-ux-pro-max` | Premium UI/UX design | Style → palette → typography → implement |
+| `/upgrade` | Non-destructive framework updates | Backup → update → verify → preserve |
 
 ---
 
-## Agents (19)
+## Agents (20)
 
 Agents are specialized AI roles. They are automatically activated based on task context, or you can request a specific agent.
 
@@ -166,6 +179,7 @@ Agents are specialized AI roles. They are automatically activated based on task
 | `mobile-developer` | React Native, Expo mobile development |
 | `performance-optimizer` | Core Web Vitals, profiling, optimization |
 | `planner` | Task breakdown, Socratic analysis |
+| `pr-reviewer` | PR review, branch strategy, code quality |
 | `refactor-cleaner` | Dead code cleanup, code improvement |
 | `reliability-engineer` | SRE, production readiness, SLA monitoring |
 | `security-reviewer` | Vulnerability analysis, OWASP compliance |
@@ -174,7 +188,7 @@ Agents are specialized AI roles. They are automatically activated based on task
 
 ---
 
-## Skills (32)
+## Skills (34)
 
 Skills are domain knowledge modules that agents use. They are loaded automatically based on task context.
 
@@ -184,17 +198,18 @@ Skills are domain knowledge modules that agents use. They are loaded automatical
 | **Frontend** | `frontend-patterns`, `ui-ux-pro-max`, `mobile-design`, `i18n-localization` |
 | **Backend** | `nodejs-patterns`, `typescript-expert`, `security-practices` |
 | **Testing** | `testing-patterns`, `webapp-testing`, `eval-harness` |
-| **DevOps** | `deployment-procedures`, `git-workflow`, `shell-conventions` |
+| **DevOps** | `deployment-procedures`, `git-workflow`, `pr-toolkit`, `shell-conventions` |
 | **AI & Orchestration** | `intelligent-routing`, `parallel-agents`, `mcp-integration`, `context-budget`, `behavioral-modes` |
-| **Planning** | `brainstorming`, `plan-writing`, `strategic-compact`, `continuous-learning` |
+| **Planning** | `brainstorming`, `plan-writing`, `plan-validation`, `strategic-compact`, `continuous-learning` |
 | **Performance** | `performance-profiling` |
+| **Production** | `production-readiness` |
 | **Scaffolding** | `app-builder` |
 | **Debugging** | `debugging-strategies` |
 | **Verification** | `verification-loop` |
 
 ---
 
-## Rules (8)
+## Rules (9)
 
 Rules are modular governance constraints that all agents must follow.
 
@@ -208,10 +223,11 @@ Rules are modular governance constraints that all agents must follow.
 | `sprint-tracking` | ROADMAP.md as SSOT, session protocols |
 | `quality-gate` | Pre-task validation and quality standards |
 | `architecture` | System design patterns and ADR governance |
+| `agent-upgrade-policy` | Framework upgrade preservation rules |
 
 ---
 
-## Checklists (3)
+## Checklists (4)
 
 Checklists are quality gates run at specific lifecycle moments.
 
@@ -220,6 +236,7 @@ Checklists are quality gates run at specific lifecycle moments.
 | `session-start` | Beginning of each session | Read context, verify git, check dependencies |
 | `session-end` | End of each session | Update ROADMAP, CHANGELOG, commit tracking files |
 | `pre-commit` | Before git commit | Tests pass, lint clean, no secrets, build succeeds |
+| `task-complete` | After task completion | Verification, documentation, cleanup |
 
 ---
 

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

@@ -0,0 +1,65 @@
+---
+description: Auto-generate PR title, summary, and labels from diff analysis
+---
+
+# /pr-describe Command
+
+Automatically generate a conventional-commit title, structured summary, change categorization, and suggested labels by analyzing the PR diff.
+
+## Usage
+
+```
+/pr-describe                        # Describe current branch diff
+/pr-describe #<number>              # Describe existing PR
+/pr-describe <url>                  # Describe PR at GitHub URL
+/pr-describe #<number> --update     # Update existing PR description in-place
+/pr-describe --format brief         # Short summary only
+```
+
+## Examples
+
+```
+/pr-describe                        # Generate description for current branch
+/pr-describe #42                    # Generate description for PR #42
+/pr-describe #42 --update           # Overwrite PR #42's description
+/pr-describe --format brief         # One-paragraph summary
+```
+
+## What It Does
+
+1. Analyzes the full diff (commits, file changes, additions/deletions)
+2. Detects the primary change type (feat, fix, refactor, chore, etc.)
+3. Generates conventional-commit title from branch name and diff content
+4. Creates structured body (Summary, Changes by Category, Test Plan)
+5. Suggests labels based on file types and change patterns
+6. Optionally updates the PR description on GitHub
+
+## Output
+
+```markdown
+## Generated PR Description
+
+**Title**: feat(auth): add OAuth2 provider support
+
+**Summary**:
+Adds Google and GitHub OAuth2 providers with PKCE flow,
+token refresh, and session management.
+
+**Changes**:
+- Feature: 4 files (OAuth provider, token service, session middleware, config)
+- Tests: 3 files (unit + integration for OAuth flow)
+- Config: 1 file (environment variables for provider credentials)
+
+**Labels**: `feature`, `auth`, `needs-review`
+
+**Test Plan**:
+- [ ] OAuth login flow with Google provider
+- [ ] Token refresh after expiry
+- [ ] Session persistence across browser restart
+```
+
+## Related
+
+- `/pr` — Create a pull request (uses /pr-describe internally)
+- `/pr-review` — Review a pull request
+- `/pr-status` — Check PR merge readiness

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

@@ -0,0 +1,45 @@
+---
+description: Fix pull request issues based on review comments
+---
+
+# /pr-fix Command
+
+Fix PR issues by fetching review comments, prioritizing by severity, implementing fixes, and pushing resolution.
+
+## Usage
+
+```
+/pr-fix <url>                      # Fix PR at GitHub URL
+/pr-fix <owner/repo>#<number>      # Fix PR by repo and number
+/pr-fix #<number>                  # Fix PR in current repo
+/pr-fix #<number> --critical-only  # Fix only CRITICAL findings
+/pr-fix #<number> --dry-run        # Show fix plan without implementing
+```
+
+## Examples
+
+```
+/pr-fix https://github.com/org/repo/pull/42
+/pr-fix deelmarkt/app#10
+/pr-fix #5
+/pr-fix #5 --critical-only
+/pr-fix #5 --dry-run
+```
+
+## What It Does
+
+1. Fetches all review comments and requested changes
+2. Categorizes fixes by severity (P0-P3)
+3. Checks out the PR branch
+4. Implements fixes in priority order
+5. Runs `/review` verification pipeline
+6. Pushes fixes and posts resolution summary
+7. Re-requests review from original reviewer
+
+## Related
+
+- `/pr-review` — Review a pull request
+- `/pr` — Create a pull request
+- `/pr-merge` — Merge with dependency validation
+- `/pr-status` — Check merge readiness
+- `/review` — Local code quality gates

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

@@ -0,0 +1,45 @@
+---
+description: Merge a pull request safely with dependency validation and post-merge checks
+---
+
+# /pr-merge Command
+
+Safely merge a pull request after validating CI status, review approval, dependency chain, and branch strategy compliance. Includes post-merge verification and dependent PR notification.
+
+## Usage
+
+```
+/pr-merge #<number>                 # Merge PR in current repo
+/pr-merge <url>                     # Merge PR at GitHub URL
+/pr-merge #<number> --squash        # Force squash merge
+/pr-merge #<number> --merge-commit  # Force merge commit
+/pr-merge #<number> --rebase        # Force rebase merge
+/pr-merge #<number> --dry-run       # Validate merge readiness without merging
+```
+
+## Examples
+
+```
+/pr-merge #42                       # Merge with auto-detected strategy
+/pr-merge #42 --squash              # Squash merge
+/pr-merge #42 --dry-run             # Check if #42 is ready to merge
+/pr-merge https://github.com/org/repo/pull/42
+```
+
+## What It Does
+
+1. Validates PR state (open, mergeable, not blocked)
+2. Verifies review approval and CI checks passing
+3. Validates dependency chain (`Depends-On:` PRs all merged)
+4. Checks branch strategy compliance (correct merge target)
+5. Selects merge strategy (squash / merge commit / rebase)
+6. Executes merge and deletes merged branch
+7. Runs post-merge validation (CI on target branch)
+8. Notifies dependent PRs that this dependency is resolved
+
+## Related
+
+- `/pr` — Create a pull request
+- `/pr-review` — Review a pull request
+- `/pr-status` — Check merge readiness
+- `/pr-split` — Split oversized PR into sub-PRs

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

@@ -0,0 +1,50 @@
+---
+description: Review a pull request with Senior Staff Engineer expertise
+---
+
+# /pr-review Command
+
+Review any pull request with multi-perspective analysis covering PR hygiene, branch strategy, code quality, security, testing, and architecture.
+
+## Usage
+
+```
+/pr-review <url>                    # Review PR at GitHub URL
+/pr-review <owner/repo>#<number>    # Review PR by repo and number
+/pr-review #<number>                # Review PR in current repo
+/pr-review #<number> --local        # Review locally only (don't post)
+/pr-review #<number> --focus <area> # Focus on specific perspective
+```
+
+## Examples
+
+```
+/pr-review https://github.com/org/repo/pull/42
+/pr-review deelmarkt/app#10
+/pr-review #5
+/pr-review #5 --local
+/pr-review #5 --focus security
+```
+
+## Focus Areas
+
+- `security` — Security-only review
+- `quality` — Code quality-only review
+- `hygiene` — PR structure and process compliance
+
+## What It Does
+
+1. Fetches PR metadata, diff, and existing reviews
+2. Detects branch strategy (GitFlow / Trunk-Based)
+3. Applies 6-perspective review framework
+4. Generates findings with severity and fix suggestions
+5. Posts review to GitHub (REQUEST_CHANGES / APPROVE / COMMENT)
+
+## Related
+
+- `/pr` — Create 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
+- `/review` — Local code quality gates

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

@@ -0,0 +1,54 @@
+---
+description: Split oversized PRs into focused sub-PRs by concern category
+---
+
+# /pr-split Command
+
+Split large (L/XL) pull requests into focused, independently-reviewable sub-PRs organized by concern category with a dependency-ordered merge plan.
+
+## Usage
+
+```
+/pr-split                           # Analyze current branch for splitting
+/pr-split #<number>                 # Analyze existing PR for splitting
+/pr-split --dry-run                 # Show split plan without creating branches
+/pr-split --auto                    # Auto-split by file category
+```
+
+## Examples
+
+```
+/pr-split                           # Split current branch
+/pr-split #42                       # Split PR #42
+/pr-split --dry-run                 # Preview split plan only
+/pr-split #42 --auto                # Auto-split without manual grouping
+```
+
+## What It Does
+
+1. Analyzes full diff and classifies PR size (must be L or XL)
+2. Categorizes files by concern (feature, tests, config, deps, docs, infra)
+3. Proposes split plan with merge ordering and dependencies
+4. Waits for user approval of the split plan
+5. Creates sub-branches with selective cherry-pick/checkout
+6. Verifies each sub-branch independently (build + tests)
+7. Creates sub-PRs with structured bodies and dependency declarations
+8. Updates original PR with links to all sub-PRs
+
+## Split Categories
+
+| Category | Examples |
+| :--- | :--- |
+| Feature Code | `src/`, application logic |
+| Tests | `tests/`, `*.test.*`, `*.spec.*` |
+| Configuration | `.eslintrc`, `tsconfig`, tool configs |
+| Dependencies | `package.json`, lock files |
+| Documentation | `README`, `docs/`, `CHANGELOG` |
+| Infrastructure | `Dockerfile`, CI/CD, deploy configs |
+
+## Related
+
+- `/pr` — Create a pull request (warns on XL size)
+- `/pr-review` — Review each sub-PR
+- `/pr-merge` — Merge sub-PRs in dependency order
+- `/pr-status` — Check status of all sub-PRs