antigravity-ai-kit 3.5.2 → 3.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agent/CheatSheet.md +1 -1
- package/.agent/checklists/pre-commit.md +1 -1
- package/.agent/checklists/session-end.md +1 -1
- package/.agent/checklists/session-start.md +1 -1
- package/.agent/checklists/task-complete.md +12 -9
- package/.agent/commands/help.md +2 -2
- package/.agent/engine/identity.json +2 -11
- package/.agent/manifest.json +6 -2
- package/.agent/session-context.md +1 -1
- package/.agent/workflows/README.md +4 -3
- package/.agent/workflows/deploy.md +2 -2
- package/.agent/workflows/pr.md +291 -0
- package/.agent/workflows/review.md +2 -2
- package/README.md +9 -8
- package/package.json +4 -3
package/.agent/CheatSheet.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Task-Complete Checkpoint
|
|
2
2
|
|
|
3
|
-
> **Framework**: Antigravity AI Kit v3.
|
|
3
|
+
> **Framework**: Antigravity AI Kit v3.6.0
|
|
4
4
|
> **Purpose**: Decision gate after task completion — present options before commit/push
|
|
5
5
|
> **Principle**: Human-in-the-loop governance
|
|
6
6
|
|
|
@@ -28,10 +28,11 @@ Present these options to the developer:
|
|
|
28
28
|
| 2 | 🛡️ Retrospective Audit | `/retrospective` | Sprint-end or milestone |
|
|
29
29
|
| 3 | 📋 Update Tracking | Manual | ✅ Always |
|
|
30
30
|
| 4 | 📦 Commit & Push | `git commit + push` | After review passes |
|
|
31
|
-
| 5 |
|
|
32
|
-
| 6 |
|
|
33
|
-
| 7 |
|
|
34
|
-
| 8 |
|
|
31
|
+
| 5 | 🔀 Pull Request | `/pr` | Feature branch with commits |
|
|
32
|
+
| 6 | 🔚 Session-End | Protocol | End of work session |
|
|
33
|
+
| 7 | 🚀 Deploy | `/deploy` | Production-impacting changes |
|
|
34
|
+
| 8 | 📝 Continue Working | Skip commit | Batching multiple changes |
|
|
35
|
+
| 9 | ⏭️ Skip Checkpoint | Session flag | Rapid iteration mode |
|
|
35
36
|
|
|
36
37
|
**Prompt format:**
|
|
37
38
|
|
|
@@ -42,10 +43,11 @@ How should we proceed?
|
|
|
42
43
|
2. 🛡️ /retrospective — Tier-1 audit (architecture, market benchmark, ethics)
|
|
43
44
|
3. 📋 Update tracking — Sync ROADMAP.md, session-context.md, session-state.json
|
|
44
45
|
4. 📦 Commit & push — Stage, commit (conventional), push to remote
|
|
45
|
-
5.
|
|
46
|
-
6.
|
|
47
|
-
7.
|
|
48
|
-
8.
|
|
46
|
+
5. 🔀 /pr — Create pull request with pre-flight checks and CI verification
|
|
47
|
+
6. 🔚 Session-end protocol — Preserve context and prepare for handoff
|
|
48
|
+
7. 🚀 /deploy — Production deployment with pre-flight checks
|
|
49
|
+
8. 📝 Continue working — Proceed to next task without committing
|
|
50
|
+
9. ⏭️ Skip checkpoint — Disable checkpoint for remainder of session
|
|
49
51
|
|
|
50
52
|
> Choose options (e.g., "1, 3, 4" or "1 through 5"):
|
|
51
53
|
```
|
|
@@ -62,6 +64,7 @@ Dynamically adjust recommendations based on:
|
|
|
62
64
|
- [ ] **File count**: If >5 files changed → recommend atomic commit review
|
|
63
65
|
- [ ] **New code without tests**: Flag with ⚠️ if test coverage gap detected
|
|
64
66
|
- [ ] **Security-sensitive**: If auth/crypto/token files changed → recommend `/review security`
|
|
67
|
+
- [ ] **Feature branch**: If on feature branch with unpushed commits → recommend `/pr`
|
|
65
68
|
|
|
66
69
|
---
|
|
67
70
|
|
package/.agent/commands/help.md
CHANGED
|
@@ -11,7 +11,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
|
|
|
11
11
|
```
|
|
12
12
|
/help # Quick overview of all capabilities
|
|
13
13
|
/help commands # All 31 slash commands with descriptions
|
|
14
|
-
/help workflows # All
|
|
14
|
+
/help workflows # All 15 workflows with descriptions
|
|
15
15
|
/help agents # All 19 AI agents with domains
|
|
16
16
|
/help skills # All 32 skill modules
|
|
17
17
|
/help rules # Governance rules
|
|
@@ -24,7 +24,7 @@ Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview
|
|
|
24
24
|
|
|
25
25
|
## Quick Overview
|
|
26
26
|
|
|
27
|
-
**Antigravity AI Kit v3.
|
|
27
|
+
**Antigravity AI Kit v3.6.0** — Trust-Grade AI Development Framework
|
|
28
28
|
|
|
29
29
|
| Category | Count | Description |
|
|
30
30
|
|:---------|:------|:------------|
|
|
@@ -1,13 +1,4 @@
|
|
|
1
1
|
{
|
|
2
|
-
"developers": [
|
|
3
|
-
|
|
4
|
-
"id": "9c1dbf58766b",
|
|
5
|
-
"name": "emredursun",
|
|
6
|
-
"email": "info.emredursun@gmail.com",
|
|
7
|
-
"role": "owner",
|
|
8
|
-
"registeredAt": "2026-03-16T17:02:45.476Z",
|
|
9
|
-
"lastActiveAt": "2026-03-16T17:02:45.476Z"
|
|
10
|
-
}
|
|
11
|
-
],
|
|
12
|
-
"activeId": "9c1dbf58766b"
|
|
2
|
+
"developers": [],
|
|
3
|
+
"activeId": null
|
|
13
4
|
}
|
package/.agent/manifest.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": "1.0.0",
|
|
3
|
-
"kitVersion": "3.
|
|
3
|
+
"kitVersion": "3.6.0",
|
|
4
4
|
"lastAuditedAt": null,
|
|
5
5
|
"description": "Antigravity AI Kit — Trust-Grade AI Development Framework",
|
|
6
6
|
"repository": "https://github.com/besync-labs/antigravity-ai-kit",
|
|
@@ -243,7 +243,7 @@
|
|
|
243
243
|
]
|
|
244
244
|
},
|
|
245
245
|
"workflows": {
|
|
246
|
-
"count":
|
|
246
|
+
"count": 15,
|
|
247
247
|
"items": [
|
|
248
248
|
{
|
|
249
249
|
"name": "brainstorm",
|
|
@@ -273,6 +273,10 @@
|
|
|
273
273
|
"name": "plan",
|
|
274
274
|
"file": "workflows/plan.md"
|
|
275
275
|
},
|
|
276
|
+
{
|
|
277
|
+
"name": "pr",
|
|
278
|
+
"file": "workflows/pr.md"
|
|
279
|
+
},
|
|
276
280
|
{
|
|
277
281
|
"name": "preview",
|
|
278
282
|
"file": "workflows/preview.md"
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# Antigravity AI Kit — Workflows
|
|
2
2
|
|
|
3
3
|
> **Purpose**: Process templates for common development tasks
|
|
4
|
-
> **Count**:
|
|
4
|
+
> **Count**: 15 Workflows
|
|
5
5
|
> **Standard**: Enterprise Workflow Standard (EWS) v1.0
|
|
6
6
|
|
|
7
7
|
---
|
|
@@ -27,6 +27,7 @@ Invoke them using slash commands (e.g., `/brainstorm authentication system`).
|
|
|
27
27
|
| **ui-ux-pro-max** | `/ui-ux-pro-max` | Build | Premium UI/UX design and implementation |
|
|
28
28
|
| **test** | `/test` | Verify | Systematic test writing and execution |
|
|
29
29
|
| **review** | `/review` | Verify | Sequential quality gate pipeline |
|
|
30
|
+
| **pr** | `/pr` | Ship | Production-grade PR creation with pre-flight checks |
|
|
30
31
|
| **deploy** | `/deploy` | Ship | Production deployment with pre-flight checks |
|
|
31
32
|
| **debug** | `/debug` | Reactive | Systematic problem investigation |
|
|
32
33
|
| **orchestrate** | `/orchestrate` | Reactive | Multi-agent coordination for complex tasks |
|
|
@@ -41,8 +42,8 @@ Invoke them using slash commands (e.g., `/brainstorm authentication system`).
|
|
|
41
42
|
Discover ──► Plan ──► Build ──► Verify ──► Ship ──► Evaluate
|
|
42
43
|
│ │ │ │ │ │
|
|
43
44
|
▼ ▼ ▼ ▼ ▼ ▼
|
|
44
|
-
/brainstorm /plan /create /test /
|
|
45
|
-
/quality-gate /enhance /review
|
|
45
|
+
/brainstorm /plan /create /test /pr /retrospective
|
|
46
|
+
/quality-gate /enhance /review /deploy
|
|
46
47
|
/preview
|
|
47
48
|
/ui-ux-pro-max
|
|
48
49
|
|
|
@@ -9,7 +9,7 @@ commit-types: [chore, fix]
|
|
|
9
9
|
# /deploy — Production Deployment
|
|
10
10
|
|
|
11
11
|
> **Trigger**: `/deploy [sub-command]`
|
|
12
|
-
> **Lifecycle**: Ship — after `/
|
|
12
|
+
> **Lifecycle**: Ship — after `/pr` is merged
|
|
13
13
|
|
|
14
14
|
> [!CAUTION]
|
|
15
15
|
> Deployment impacts production users and consumes platform credits. Every push to `production` triggers builds on hosting platforms (Vercel, Railway, etc.). Never deploy untested code. Always have a rollback plan before deploying.
|
|
@@ -189,7 +189,7 @@ Run `/deploy rollback` to restore [previous version].
|
|
|
189
189
|
|
|
190
190
|
## Related Resources
|
|
191
191
|
|
|
192
|
-
- **Previous**: `/
|
|
192
|
+
- **Previous**: `/pr` (PR must be created and merged before deployment)
|
|
193
193
|
- **Next**: `/status` (post-deploy monitoring)
|
|
194
194
|
- **Skill**: `.agent/skills/deployment-procedures/SKILL.md`
|
|
195
195
|
- **Global Rule**: Production Merge Discipline (see global rules)
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Production-grade PR creation with pre-flight checks, branch sync, and CI verification.
|
|
3
|
+
version: 2.1.0
|
|
4
|
+
sdlc-phase: ship
|
|
5
|
+
skills: [git-workflow, verification-loop]
|
|
6
|
+
commit-types: [feat, fix, refactor, perf, chore, docs, test]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# /pr — Production-Grade Pull Request Workflow
|
|
10
|
+
|
|
11
|
+
> **Trigger**: `/pr [target]` (default: `main`) · `/pr --draft [target]`
|
|
12
|
+
> **Lifecycle**: Ship — after `/review` gate passes, before `/deploy`
|
|
13
|
+
|
|
14
|
+
> [!CAUTION]
|
|
15
|
+
> PR creation pushes code to remote and triggers CI pipelines. Always run local pre-flight checks via `/review` before pushing. Never create PRs with unresolved conflicts or failing tests. Every CI run consumes pipeline credits.
|
|
16
|
+
|
|
17
|
+
> [!TIP]
|
|
18
|
+
> This workflow leverages the **git-workflow** skill. Read `.agent/skills/git-workflow/SKILL.md` for extended guidance on branching, conventional commits, and PR templates.
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## Scope Filter
|
|
23
|
+
|
|
24
|
+
| Commit Type | PR Mode | Gates Skipped |
|
|
25
|
+
| :---------- | :------ | :------------ |
|
|
26
|
+
| `feat()` — new features | ✅ Full (8 steps) | None |
|
|
27
|
+
| `fix()` — bug fixes | ✅ Full (8 steps) | None |
|
|
28
|
+
| `refactor()` — structural | ✅ Full (8 steps) | None |
|
|
29
|
+
| `perf()` — performance | ✅ Full (8 steps) | None |
|
|
30
|
+
| `chore()` — maintenance | ⚠️ Lightweight | Step 3 (pre-flight) |
|
|
31
|
+
| `docs()` — documentation | ⚠️ Lightweight | Steps 3, 7 (pre-flight, CI) |
|
|
32
|
+
| `test()` — test additions | ⚠️ Lightweight | Step 3 runs test gate only |
|
|
33
|
+
|
|
34
|
+
---
|
|
35
|
+
|
|
36
|
+
## Critical Rules
|
|
37
|
+
|
|
38
|
+
1. **ALWAYS** sync with target branch before creating PR — prevents merge conflicts
|
|
39
|
+
2. **ALWAYS** run pre-flight `/review` locally before pushing — catches issues pre-CI
|
|
40
|
+
3. **NEVER** create a PR from `main` or `production` branches
|
|
41
|
+
4. **NEVER** create a PR with known conflicts — resolve first
|
|
42
|
+
5. **NEVER** merge without all CI checks passing
|
|
43
|
+
6. **ATOMIC** PRs — one logical unit of work per PR, not multi-sprint kitchen sinks
|
|
44
|
+
7. **CONVENTIONAL** titles — `type(scope): description` format
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## Argument Parsing
|
|
49
|
+
|
|
50
|
+
| Command | Action |
|
|
51
|
+
| :---------------------- | :--------------------------------------------------- |
|
|
52
|
+
| `/pr` | Create PR targeting default branch (`main`) |
|
|
53
|
+
| `/pr [target]` | Create PR targeting specified branch (e.g., `/pr dev`) |
|
|
54
|
+
| `/pr --draft` | Create PR as draft (may not trigger CI) |
|
|
55
|
+
| `/pr --draft [target]` | Create draft PR targeting specified branch |
|
|
56
|
+
|
|
57
|
+
---
|
|
58
|
+
|
|
59
|
+
## Steps
|
|
60
|
+
|
|
61
|
+
Execute IN ORDER. Stop at first failure.
|
|
62
|
+
|
|
63
|
+
### Step 1: Verify Branch State
|
|
64
|
+
|
|
65
|
+
// turbo
|
|
66
|
+
|
|
67
|
+
```powershell
|
|
68
|
+
git branch --show-current
|
|
69
|
+
git status --porcelain
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
- If on `main` or `production` → **STOP**, instruct user to create feature branch
|
|
73
|
+
- If working tree dirty → prompt to commit or stash
|
|
74
|
+
|
|
75
|
+
### Step 2: Sync with Target Branch
|
|
76
|
+
|
|
77
|
+
// turbo
|
|
78
|
+
|
|
79
|
+
```powershell
|
|
80
|
+
git fetch origin <target>
|
|
81
|
+
git merge origin/<target> --no-edit
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
- If conflicts detected → invoke **Conflict Resolution Protocol** (see below)
|
|
85
|
+
- If clean merge → proceed to Step 3
|
|
86
|
+
|
|
87
|
+
> [!WARNING]
|
|
88
|
+
> If the branch has diverged significantly from the target, expect conflicts in shared files like `.gitignore`, `package.json`, or lock files. Always check `git diff --name-only origin/<target>..HEAD` before creating the PR.
|
|
89
|
+
|
|
90
|
+
### Step 3: Run Pre-Flight Checks
|
|
91
|
+
|
|
92
|
+
Delegate to `/review` pipeline (Gates 1-5: lint, type-check, test, security, build).
|
|
93
|
+
|
|
94
|
+
- Scope filter applies:
|
|
95
|
+
- `docs()` → skip all gates
|
|
96
|
+
- `chore()` → skip test + build gates
|
|
97
|
+
- `test()` → run test gate only
|
|
98
|
+
- All others → full pipeline
|
|
99
|
+
- If any gate fails → stop, fix, re-run
|
|
100
|
+
|
|
101
|
+
> [!CAUTION]
|
|
102
|
+
> If ANY pre-flight check fails, fix it BEFORE proceeding. Do NOT rely on CI to catch issues — that wastes pipeline credits and delays the team.
|
|
103
|
+
|
|
104
|
+
### Step 4: Push to Remote
|
|
105
|
+
|
|
106
|
+
```powershell
|
|
107
|
+
git push origin HEAD
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
- If rejected (upstream diverged) → re-run Step 2, then retry push
|
|
111
|
+
- If authentication error → guide user to configure credentials
|
|
112
|
+
|
|
113
|
+
### Step 5: Generate PR Title & Body
|
|
114
|
+
|
|
115
|
+
// turbo
|
|
116
|
+
|
|
117
|
+
**Title generation:**
|
|
118
|
+
- Parse branch name: `feature/ABC-123-add-user-auth` → `feat(auth): add user auth`
|
|
119
|
+
- Fallback: use first commit message subject line
|
|
120
|
+
- Format: `type(scope): description` (conventional commits)
|
|
121
|
+
|
|
122
|
+
**Body generation:**
|
|
123
|
+
- Populate from `git log origin/<target>..HEAD --oneline` and `git diff --stat origin/<target>..HEAD`
|
|
124
|
+
- Use **PR Body Template** (see below)
|
|
125
|
+
|
|
126
|
+
### Step 6: Create PR
|
|
127
|
+
|
|
128
|
+
**Pre-check:** Query existing PRs for current branch. If open PR exists → offer to update title/body instead of creating new.
|
|
129
|
+
|
|
130
|
+
**MCP-first 3-tier fallback:**
|
|
131
|
+
1. Attempt `mcp_github-mcp-server_create_pull_request` with title, body, `is_draft`, base, head
|
|
132
|
+
2. If MCP fails → attempt `gh pr create --title "<title>" --body "<body>" --base <target> [--draft]`
|
|
133
|
+
3. If `gh` fails → provide pre-formatted title + body for manual browser copy-paste
|
|
134
|
+
|
|
135
|
+
### Step 7: Verify CI Pipeline
|
|
136
|
+
|
|
137
|
+
- Poll via `mcp_github-mcp-server_pull_request_read` (method: `get_status`)
|
|
138
|
+
- Report each check as it resolves
|
|
139
|
+
- If draft PR → note: "Draft PRs may not trigger CI on some repositories. Convert to ready-for-review via MCP `update_pull_request` if CI doesn't appear."
|
|
140
|
+
|
|
141
|
+
> [!NOTE]
|
|
142
|
+
> If CI checks do NOT appear, check:
|
|
143
|
+
> 1. **Merge conflicts** — `mergeable_state: dirty` blocks CI entirely
|
|
144
|
+
> 2. **Workflow file** — `.github/workflows/` must contain CI config on the target branch
|
|
145
|
+
> 3. **Branch targeting** — CI may only trigger on PRs targeting specific branches
|
|
146
|
+
|
|
147
|
+
### Step 8: Handle Results
|
|
148
|
+
|
|
149
|
+
- ✅ All green → offer to assign reviewers via `update_pull_request`, link issues with `Closes #N`
|
|
150
|
+
- ❌ Any fail → read failure logs, suggest fix, re-run from Step 3
|
|
151
|
+
- ⏳ Timeout → provide manual check instructions
|
|
152
|
+
|
|
153
|
+
---
|
|
154
|
+
|
|
155
|
+
## PR Body Template
|
|
156
|
+
|
|
157
|
+
```markdown
|
|
158
|
+
## Summary
|
|
159
|
+
[One-line description derived from branch name and commits]
|
|
160
|
+
|
|
161
|
+
## Changes
|
|
162
|
+
|
|
163
|
+
### [Category — derived from commit types]
|
|
164
|
+
- [Change description from commit messages]
|
|
165
|
+
|
|
166
|
+
## Test Plan
|
|
167
|
+
- [x] Pre-flight `/review` passed locally (lint, type-check, test, security, build)
|
|
168
|
+
- [x] Branch synced with `{target}` — no conflicts
|
|
169
|
+
- [x] No secrets or PII in diff
|
|
170
|
+
|
|
171
|
+
## Breaking Changes
|
|
172
|
+
[None / List any breaking changes — derived from `BREAKING CHANGE:` commit footers]
|
|
173
|
+
|
|
174
|
+
## Related Issues
|
|
175
|
+
[Closes #N — derived from commit messages or branch name pattern]
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
---
|
|
179
|
+
|
|
180
|
+
## Conflict Resolution Protocol
|
|
181
|
+
|
|
182
|
+
When merge conflicts are detected in Step 2:
|
|
183
|
+
|
|
184
|
+
```powershell
|
|
185
|
+
# 1. Check conflicted files
|
|
186
|
+
git diff --name-only --diff-filter=U
|
|
187
|
+
|
|
188
|
+
# 2. Resolve each conflict manually
|
|
189
|
+
# - .gitignore: combine both versions, prefer more restrictive
|
|
190
|
+
# - Package manifests (package.json, pubspec.yaml): merge dependencies carefully
|
|
191
|
+
# - Source files: understand both changes, merge logically
|
|
192
|
+
|
|
193
|
+
# 3. Mark resolved and commit
|
|
194
|
+
git add <resolved-files>
|
|
195
|
+
git commit -m "merge: resolve conflicts with <target>"
|
|
196
|
+
|
|
197
|
+
# 4. Re-run pre-flight checks (Step 3)
|
|
198
|
+
# Invoke /review to verify merge didn't break anything
|
|
199
|
+
|
|
200
|
+
# 5. Resume from Step 4 (Push)
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
## Output Template
|
|
206
|
+
|
|
207
|
+
### ✅ PR Created Successfully
|
|
208
|
+
|
|
209
|
+
```markdown
|
|
210
|
+
## ✅ PR Created Successfully
|
|
211
|
+
|
|
212
|
+
| Field | Value |
|
|
213
|
+
| :--- | :--- |
|
|
214
|
+
| PR | #[N] |
|
|
215
|
+
| Title | [type(scope): description] |
|
|
216
|
+
| Branch | [source] → [target] |
|
|
217
|
+
| Status | [draft / ready for review] |
|
|
218
|
+
| URL | [link] |
|
|
219
|
+
|
|
220
|
+
### CI Status
|
|
221
|
+
| Check | Status |
|
|
222
|
+
| :--- | :--- |
|
|
223
|
+
| [name] | ✅ Pass / ⏳ Pending / ❌ Fail |
|
|
224
|
+
|
|
225
|
+
**Next**: Wait for CI → `/deploy` when ready.
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
### ❌ PR Creation Failed
|
|
229
|
+
|
|
230
|
+
```markdown
|
|
231
|
+
## ❌ PR Creation Failed at Step [N]
|
|
232
|
+
|
|
233
|
+
### Error
|
|
234
|
+
[Error description]
|
|
235
|
+
|
|
236
|
+
### Resolution
|
|
237
|
+
1. [Fix steps]
|
|
238
|
+
2. Re-run: `/pr [target]`
|
|
239
|
+
|
|
240
|
+
### Fallback
|
|
241
|
+
[Manual instructions if MCP + CLI both failed]
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
---
|
|
245
|
+
|
|
246
|
+
## Governance
|
|
247
|
+
|
|
248
|
+
**PROHIBITED:**
|
|
249
|
+
- Creating PRs from `main` or `production` branches
|
|
250
|
+
- Creating PRs with unresolved merge conflicts
|
|
251
|
+
- Pushing without local pre-flight `/review` passing
|
|
252
|
+
- Merging PRs with failing CI checks
|
|
253
|
+
- Including generated files, PII, secrets, or `.env` in diff
|
|
254
|
+
- Multi-sprint mega-PRs — keep PRs focused and reviewable
|
|
255
|
+
- Using `// turbo` on state-mutating steps (push, create, merge)
|
|
256
|
+
- Skipping failed steps · proceeding without resolution
|
|
257
|
+
|
|
258
|
+
**REQUIRED:**
|
|
259
|
+
- Branch sync with target before every PR
|
|
260
|
+
- Local pre-flight via `/review` before push
|
|
261
|
+
- Conventional commit PR title format
|
|
262
|
+
- Structured PR body using template
|
|
263
|
+
- CI verification after PR creation
|
|
264
|
+
- Human approval before push and PR creation (non-turbo)
|
|
265
|
+
- MCP-first with graceful fallback strategy
|
|
266
|
+
- Conflict resolution before push
|
|
267
|
+
|
|
268
|
+
---
|
|
269
|
+
|
|
270
|
+
## Completion Criteria
|
|
271
|
+
|
|
272
|
+
- [ ] On feature branch (not `main`/`production`)
|
|
273
|
+
- [ ] Working tree clean (committed or stashed)
|
|
274
|
+
- [ ] Target branch synced (no conflicts)
|
|
275
|
+
- [ ] Pre-flight `/review` passes (scope-filtered)
|
|
276
|
+
- [ ] Pushed to remote
|
|
277
|
+
- [ ] PR created with conventional title and structured body
|
|
278
|
+
- [ ] CI checks monitored and passed (or draft acknowledged)
|
|
279
|
+
- [ ] Review requested (if applicable)
|
|
280
|
+
- [ ] After CI passes: proceed to `/deploy` when ready
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Related Resources
|
|
285
|
+
|
|
286
|
+
- **Previous**: `/review` (quality gates must pass before PR)
|
|
287
|
+
- **Next**: `/deploy` (deployment after PR is merged)
|
|
288
|
+
- **Skills**: `.agent/skills/git-workflow/SKILL.md` · `.agent/skills/verification-loop/SKILL.md`
|
|
289
|
+
- **Global Rule**: Production Merge Discipline (see global rules)
|
|
290
|
+
- **Related**: `/status` (check PR and CI status)
|
|
291
|
+
- **Note**: PR body template supersedes the basic template in `git-workflow` skill
|
|
@@ -9,7 +9,7 @@ commit-types: [fix, refactor]
|
|
|
9
9
|
# /review — Code Review Quality Gate
|
|
10
10
|
|
|
11
11
|
> **Trigger**: `/review` (full) · `/review lint` · `/review tests` · `/review security` · `/review build`
|
|
12
|
-
> **Lifecycle**: After implementation, before `/
|
|
12
|
+
> **Lifecycle**: After implementation, before `/pr`
|
|
13
13
|
|
|
14
14
|
> [!CAUTION]
|
|
15
15
|
> Sequential gate pipeline — each step must pass before proceeding. Failed gates block merge. No overrides.
|
|
@@ -183,6 +183,6 @@ Re-run: `/review` or `/review {gate}`
|
|
|
183
183
|
## Related Resources
|
|
184
184
|
|
|
185
185
|
- **Previous**: `/test` (tests must pass before review)
|
|
186
|
-
- **Next**: `/
|
|
186
|
+
- **Next**: `/pr` (create pull request after all gates pass)
|
|
187
187
|
- **Skill**: `.agent/skills/verification-loop/SKILL.md`
|
|
188
188
|
- **Related**: `/quality-gate` (pre-task research) · `/retrospective` (sprint-level audit)
|
package/README.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# 🚀 Antigravity AI Kit
|
|
2
2
|
|
|
3
|
-

|
|
4
4
|

|
|
5
5
|

|
|
6
6
|

|
|
7
7
|

|
|
8
|
-

|
|
9
9
|

|
|
10
10
|

|
|
11
11
|

|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
</p>
|
|
16
16
|
|
|
17
17
|
<p align="center">
|
|
18
|
-
Antigravity AI Kit is a <b>Trust-Grade AI development framework</b> with a <b>29-module runtime engine</b>, <b>19 specialized agents</b>, <b>31 commands</b>, <b>32 skills</b>, and <b>
|
|
18
|
+
Antigravity AI Kit is a <b>Trust-Grade AI development framework</b> with a <b>29-module runtime engine</b>, <b>19 specialized agents</b>, <b>31 commands</b>, <b>32 skills</b>, and <b>15 workflows</b> — all backed by <b>341 tests</b> and governance-first principles.
|
|
19
19
|
</p>
|
|
20
20
|
|
|
21
21
|
<p align="center">
|
|
@@ -40,7 +40,7 @@
|
|
|
40
40
|
- [Commands](#%EF%B8%8F-commands-31)
|
|
41
41
|
- [Skills](#%EF%B8%8F-skills-32)
|
|
42
42
|
- [Runtime Engine](#%EF%B8%8F-runtime-engine-29-modules)
|
|
43
|
-
- [Workflows](#-workflows-
|
|
43
|
+
- [Workflows](#-workflows-15)
|
|
44
44
|
- [Operating Constraints](#%EF%B8%8F-operating-constraints)
|
|
45
45
|
- [Session Management](#-session-management)
|
|
46
46
|
- [How to Extend](#-how-to-extend)
|
|
@@ -58,7 +58,7 @@
|
|
|
58
58
|
| 🤖 **AI Agents** | 19 | Specialized roles (Mobile, DevOps, Database, Security, Performance...) |
|
|
59
59
|
| 🛠️ **Skills** | 32 | Domain knowledge modules (API, Testing, MCP, Architecture, Docker...) |
|
|
60
60
|
| ⌨️ **Commands** | 31 | Slash commands for every development workflow |
|
|
61
|
-
| 🔄 **Workflows** |
|
|
61
|
+
| 🔄 **Workflows** | 15 | Process templates (/create, /debug, /deploy, /pr, /test...) |
|
|
62
62
|
| ⚙️ **Runtime** | 29 | Runtime engine modules (governance, reputation, self-healing...) |
|
|
63
63
|
| ✅ **Checklists** | 4 | Quality gates (session-start, session-end, pre-commit, task-complete) |
|
|
64
64
|
| ⚖️ **Rules** | 8 | Modular governance constraints (coding, security, testing, git, docs, sprint) |
|
|
@@ -149,7 +149,7 @@ Antigravity AI Kit is designed to **never touch your project files**. All operat
|
|
|
149
149
|
┌─────────────────────────────────────────────────────────────────────┐
|
|
150
150
|
│ USER INTERFACE LAYER │
|
|
151
151
|
│ ┌─────────────────────────┐ ┌─────────────────────────┐ │
|
|
152
|
-
│ │ Slash Commands (31) │ │ Workflows (
|
|
152
|
+
│ │ Slash Commands (31) │ │ Workflows (15) │ │
|
|
153
153
|
│ └────────────┬────────────┘ └────────────┬────────────┘ │
|
|
154
154
|
├───────────────┼────────────────────────────┼────────────────────────┤
|
|
155
155
|
│ ▼ INTELLIGENCE LAYER ▼ │
|
|
@@ -423,7 +423,7 @@ Antigravity AI Kit v3.2.0 includes a **full runtime engine** built across 4 phas
|
|
|
423
423
|
|
|
424
424
|
---
|
|
425
425
|
|
|
426
|
-
## 🔄 Workflows (
|
|
426
|
+
## 🔄 Workflows (15)
|
|
427
427
|
|
|
428
428
|
| Workflow | Description | Command |
|
|
429
429
|
| :---------------- | :----------------------- | :--------------- |
|
|
@@ -434,6 +434,7 @@ Antigravity AI Kit v3.2.0 includes a **full runtime engine** built across 4 phas
|
|
|
434
434
|
| **enhance** | Improve existing code | `/enhance` |
|
|
435
435
|
| **orchestrate** | Multi-agent coordination | `/orchestrate` |
|
|
436
436
|
| **plan** | Implementation planning | `/plan` |
|
|
437
|
+
| **pr** | Production-grade PR creation | `/pr` |
|
|
437
438
|
| **preview** | Preview changes | `/preview` |
|
|
438
439
|
| **quality-gate** | Pre-task validation | `/quality-gate` |
|
|
439
440
|
| **retrospective** | Sprint audit & review | `/retrospective` |
|
|
@@ -634,7 +635,7 @@ antigravity-ai-kit/
|
|
|
634
635
|
│ ├── agents/ # 19 specialized agents
|
|
635
636
|
│ ├── commands/ # 31 slash commands
|
|
636
637
|
│ ├── skills/ # 32 capability modules
|
|
637
|
-
│ ├── workflows/ #
|
|
638
|
+
│ ├── workflows/ # 15 process templates
|
|
638
639
|
│ ├── engine/ # Autonomy Engine (state machine, loading rules, configs)
|
|
639
640
|
│ ├── hooks/ # 8 event hooks (runtime + git-hook)
|
|
640
641
|
│ ├── rules/ # 8 modular governance rules
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "antigravity-ai-kit",
|
|
3
|
-
"version": "3.
|
|
4
|
-
"description": "🚀 Trust-Grade AI development framework with a 29-module runtime engine — 19 Agents, 32 Skills, 31 Commands,
|
|
3
|
+
"version": "3.6.0",
|
|
4
|
+
"description": "🚀 Trust-Grade AI development framework with a 29-module runtime engine — 19 Agents, 32 Skills, 31 Commands, 15 Workflows, 8 Rules, 341 Tests. Workflow enforcement, task governance, agent reputation, self-healing, and skill marketplace.",
|
|
5
5
|
"main": "bin/ag-kit.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"ag-kit": "./bin/ag-kit.js"
|
|
@@ -10,7 +10,8 @@
|
|
|
10
10
|
"test": "vitest run",
|
|
11
11
|
"test:watch": "vitest watch",
|
|
12
12
|
"preversion": "npm test",
|
|
13
|
-
"version": "node scripts/sync-version.js && git add -A",
|
|
13
|
+
"version": "node scripts/sync-version.js && git add -A -- . ':!.agent/engine/identity.json'",
|
|
14
|
+
"prepublishOnly": "node scripts/clean-identity.js",
|
|
14
15
|
"postinstall": "echo '✅ Antigravity AI Kit installed! Run: ag-kit init'"
|
|
15
16
|
},
|
|
16
17
|
"keywords": [
|