antigravity-ai-kit 2.1.0

package/.agent/skills/webapp-testing/SKILL.md

@@ -0,0 +1,175 @@
+---
+name: webapp-testing
+description: Web application testing principles. E2E, Playwright, component testing, and deep audit strategies.
+version: 1.0.0
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Web App Testing
+
+> Discover and test everything. Leave no route untested.
+
+---
+
+## 1. Deep Audit Approach
+
+### Discovery First
+
+| Target        | How to Find                     |
+| ------------- | ------------------------------- |
+| Routes        | Scan app/, pages/, router files |
+| API endpoints | Grep for HTTP methods           |
+| Components    | Find component directories      |
+| Features      | Read documentation              |
+
+### Systematic Testing
+
+1. **Map** - List all routes/APIs
+2. **Scan** - Verify they respond
+3. **Test** - Cover critical paths
+
+---
+
+## 2. Testing Pyramid
+
+```
+        /\          E2E (Few)
+       /  \         Critical user flows
+      /----\
+     /      \       Integration (Some)
+    /--------\      API, data flow
+   /          \
+  /------------\    Unit/Component (Many)
+                    Individual pieces
+```
+
+---
+
+## 3. E2E Test Principles
+
+### What to Test
+
+| Priority | Tests                     |
+| -------- | ------------------------- |
+| 1        | Happy path user flows     |
+| 2        | Authentication flows      |
+| 3        | Critical business actions |
+| 4        | Error handling            |
+
+### Best Practices
+
+| Practice           | Why                |
+| ------------------ | ------------------ |
+| Use data-testid    | Stable selectors   |
+| Wait for elements  | Avoid flaky tests  |
+| Clean state        | Independent tests  |
+| Avoid impl details | Test user behavior |
+
+---
+
+## 4. Playwright Configuration
+
+### Recommended Settings
+
+| Setting     | Recommendation    |
+| ----------- | ----------------- |
+| Retries     | 2 on CI           |
+| Trace       | on-first-retry    |
+| Screenshots | on-failure        |
+| Video       | retain-on-failure |
+
+### Core Concepts
+
+| Concept           | Use                    |
+| ----------------- | ---------------------- |
+| Page Object Model | Encapsulate page logic |
+| Fixtures          | Reusable test setup    |
+| Assertions        | Built-in auto-wait     |
+| Trace Viewer      | Debug failures         |
+
+---
+
+## 5. Test Organization
+
+### File Structure
+
+```
+tests/
+├── e2e/           # Full user flows
+├── integration/   # API, data
+├── component/     # UI units
+└── fixtures/      # Shared data
+```
+
+### Naming Convention
+
+| Pattern       | Example                     |
+| ------------- | --------------------------- |
+| Feature-based | `login.spec.ts`             |
+| Descriptive   | `user-can-checkout.spec.ts` |
+
+---
+
+## 6. API Testing
+
+### Coverage Areas
+
+| Area           | Tests                       |
+| -------------- | --------------------------- |
+| Status codes   | 200, 400, 404, 500          |
+| Response shape | Matches schema              |
+| Error messages | User-friendly               |
+| Edge cases     | Empty, large, special chars |
+
+---
+
+## 7. CI Integration
+
+### Pipeline Steps
+
+1. Install dependencies
+2. Install browsers (`npx playwright install`)
+3. Run tests
+4. Upload artifacts (traces, screenshots)
+
+### Parallelization
+
+| Strategy | Use                |
+| -------- | ------------------ |
+| Per file | Playwright default |
+| Sharding | Large suites       |
+| Workers  | Multiple browsers  |
+
+---
+
+## 8. Anti-Patterns
+
+| ❌ Don't            | ✅ Do          |
+| ------------------- | -------------- |
+| Test implementation | Test behavior  |
+| Hardcode waits      | Use auto-wait  |
+| Skip cleanup        | Isolate tests  |
+| Ignore flaky tests  | Fix root cause |
+
+---
+
+## 9. BeSync Testing Standards
+
+### Required Coverage
+
+| Vertical      | Minimum Coverage |
+| ------------- | ---------------- |
+| Auth          | 90%+             |
+| Payment       | 95%+             |
+| Core Features | 80%+             |
+
+### Test Types Required
+
+- [ ] Unit tests (Jest/Vitest)
+- [ ] Integration tests (Supertest)
+- [ ] E2E tests (Playwright)
+- [ ] Visual regression (optional)
+
+---
+
+> **Remember:** E2E tests are expensive. Use them for critical paths only.

package/.agent/workflows/README.md

@@ -0,0 +1,78 @@
+# Antigravity AI Kit — Workflows
+
+> **Purpose**: Process templates for common development tasks
+> **Count**: 11 Workflows
+
+---
+
+## Overview
+
+Workflows are structured process templates that guide you through complex tasks. Invoke them using slash commands.
+
+---
+
+## Available Workflows
+
+| Workflow          | Command          | Description                                   |
+| :---------------- | :--------------- | :-------------------------------------------- |
+| **brainstorm**    | `/brainstorm`    | Creative ideation and problem exploration     |
+| **create**        | `/create`        | Scaffold new features, components, or modules |
+| **debug**         | `/debug`         | Systematic debugging process                  |
+| **deploy**        | `/deploy`        | Deployment workflow with verification         |
+| **enhance**       | `/enhance`       | Improve existing code quality                 |
+| **orchestrate**   | `/orchestrate`   | Multi-agent coordination                      |
+| **plan**          | `/plan`          | Create implementation plans                   |
+| **preview**       | `/preview`       | Preview changes before committing             |
+| **status**        | `/status`        | Check project status                          |
+| **test**          | `/test`          | Systematic test writing                       |
+| **ui-ux-pro-max** | `/ui-ux-pro-max` | Premium UI/UX design                          |
+
+---
+
+## Workflow Format
+
+```markdown
+---
+description: What this workflow does
+---
+
+# /workflow-name Workflow
+
+> **Purpose**: Brief description
+
+---
+
+## Workflow Steps
+
+### 1. Step Name
+
+Description and actions...
+
+### 2. Step Name
+
+Description and actions...
+
+---
+
+## Checklist
+
+- [ ] Task 1
+- [ ] Task 2
+
+---
+
+## Examples
+
+\`\`\`
+/workflow-name example usage
+\`\`\`
+```
+
+---
+
+## Creating Custom Workflows
+
+1. Create `workflows/my-workflow.md`
+2. Add frontmatter with `description`
+3. Define workflow steps
+4. Include checklist and examples

package/.agent/workflows/brainstorm.md

@@ -0,0 +1,100 @@
+---
+description: Structured brainstorming. Explore options before committing to implementation.
+---
+
+# /brainstorm - Structured Idea Exploration
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Activates BRAINSTORM mode for exploring options before implementation. No code — ideas only.
+
+---
+
+## Behavior
+
+1. **Understand the Goal**
+   - What problem are we solving?
+   - Who is the user?
+   - What constraints exist?
+
+2. **Generate Options**
+   - Provide at least 3 approaches
+   - Each with pros and cons
+   - Consider unconventional solutions
+
+3. **Compare and Recommend**
+   - Summarize tradeoffs
+   - Give recommendation with reasoning
+
+---
+
+## Output Format
+
+```markdown
+## 🧠 Brainstorm: [Topic]
+
+### Context
+
+[Brief problem statement]
+
+---
+
+### Option A: [Name]
+
+[Description]
+
+✅ **Pros:**
+
+- [benefit 1]
+- [benefit 2]
+
+❌ **Cons:**
+
+- [drawback 1]
+
+📊 **Effort:** Low | Medium | High
+
+---
+
+### Option B: [Name]
+
+[Similar format]
+
+---
+
+### Option C: [Name]
+
+[Similar format]
+
+---
+
+## 💡 Recommendation
+
+**Option [X]** because [reasoning].
+
+What direction would you like to explore?
+```
+
+---
+
+## Examples
+
+```
+/brainstorm authentication system
+/brainstorm state management for complex form
+/brainstorm database schema for social app
+/brainstorm caching strategy
+```
+
+---
+
+## Key Principles
+
+- **No code** — ideas only
+- **Visual when helpful** — use diagrams for architecture
+- **Honest tradeoffs** — don't hide complexity
+- **Defer to user** — present options, let them decide

package/.agent/workflows/create.md

@@ -0,0 +1,75 @@
+---
+description: Create new features, components, or modules from scratch
+---
+
+# /create Workflow
+
+> **Purpose**: Scaffold new features, components, or modules with best practices
+
+---
+
+## Workflow Steps
+
+### 1. Clarify Requirements
+
+- What type of component/feature?
+- What framework/technology?
+- Any specific patterns to follow?
+
+### 2. Check Existing Patterns
+
+- Look for similar components in codebase
+- Identify established conventions
+- Reuse existing utilities and helpers
+
+### 3. Scaffold Structure
+
+```
+feature/
+├── components/       # UI components
+├── hooks/           # Custom hooks
+├── utils/           # Utility functions
+├── types/           # TypeScript types
+├── api/             # API calls
+├── __tests__/       # Tests
+└── index.ts         # Public exports
+```
+
+### 4. Implement Core Logic
+
+- Follow existing code patterns
+- Apply SOLID principles
+- Write self-documenting code
+
+### 5. Add Tests
+
+- Unit tests for utilities
+- Integration tests for components
+- E2E tests for critical flows
+
+### 6. Document
+
+- Add JSDoc comments
+- Update README if needed
+- Create usage examples
+
+---
+
+## Checklist
+
+- [ ] Requirements clarified
+- [ ] Existing patterns reviewed
+- [ ] Structure scaffolded
+- [ ] Core logic implemented
+- [ ] Tests written
+- [ ] Documentation added
+
+---
+
+## Examples
+
+```
+/create React component for user profile card
+/create NestJS module for authentication
+/create API endpoint for order processing
+```

package/.agent/workflows/debug.md

@@ -0,0 +1,98 @@
+---
+description: Systematic debugging workflow. Activates DEBUG mode for problem investigation.
+---
+
+# /debug - Systematic Problem Investigation
+
+$ARGUMENTS
+
+---
+
+## Purpose
+
+Activates DEBUG mode for systematic investigation of issues, errors, or unexpected behavior.
+
+---
+
+## Behavior
+
+1. **Gather Information**
+   - Error message
+   - Reproduction steps
+   - Expected vs actual behavior
+   - Recent changes
+
+2. **Form Hypotheses**
+   - List possible causes
+   - Order by likelihood
+
+3. **Investigate Systematically**
+   - Test each hypothesis
+   - Check logs, data flow
+   - Use elimination method
+
+4. **Fix and Prevent**
+   - Apply fix
+   - Explain root cause
+   - Add prevention measures
+
+---
+
+## Output Format
+
+```markdown
+## 🔍 Debug: [Issue]
+
+### 1. Symptom
+
+[What's happening]
+
+### 2. Information Gathered
+
+- Error: `[error message]`
+- File: `[filepath]`
+- Line: [line number]
+
+### 3. Hypotheses
+
+1. ❓ [Most likely cause]
+2. ❓ [Second possibility]
+3. ❓ [Less likely cause]
+
+### 4. Investigation
+
+**Testing hypothesis 1:**
+[What I checked] → [Result]
+
+### 5. Root Cause
+
+🎯 **[Explanation]**
+
+### 6. Fix
+
+[Code changes]
+
+### 7. Prevention
+
+🛡️ [How to prevent in future]
+```
+
+---
+
+## Examples
+
+```
+/debug login not working
+/debug API returns 500
+/debug form doesn't submit
+/debug data not saving
+```
+
+---
+
+## Key Principles
+
+- **Ask before assuming** — get full error context
+- **Test hypotheses** — don't guess randomly
+- **Explain why** — not just what to fix
+- **Prevent recurrence** — add tests, validation

package/.agent/workflows/deploy.md

@@ -0,0 +1,144 @@
+---
+description: Production deployment with pre-flight checks, execution, and verification.
+---
+
+# /deploy - Production Deployment
+
+$ARGUMENTS
+
+---
+
+## Sub-commands
+
+```
+/deploy            - Interactive deployment wizard
+/deploy check      - Run pre-deployment checks only
+/deploy preview    - Deploy to preview/staging
+/deploy production - Deploy to production
+/deploy rollback   - Rollback to previous version
+```
+
+---
+
+## Pre-Deployment Checklist
+
+```markdown
+## 🚀 Pre-Deploy Checklist
+
+### Code Quality
+
+- [ ] No TypeScript errors (`npx tsc --noEmit`)
+- [ ] ESLint passing (`npx eslint .`)
+- [ ] All tests passing (`npm test`)
+
+### Security
+
+- [ ] No hardcoded secrets
+- [ ] Environment variables documented
+- [ ] Dependencies audited (`npm audit`)
+
+### Performance
+
+- [ ] Bundle size acceptable
+- [ ] No console.log statements
+- [ ] Images optimized
+
+### Ready to deploy? (y/n)
+```
+
+---
+
+## Deployment Flow
+
+```
+/deploy
+    │
+    ▼
+Pre-flight checks
+    │
+    Pass? ──No──► Fix issues
+    │
+   Yes
+    │
+    ▼
+Build application
+    │
+    ▼
+Deploy to platform
+    │
+    ▼
+Health check & verify
+    │
+    ▼
+✅ Complete
+```
+
+---
+
+## Output Format
+
+### Successful Deploy
+
+```markdown
+## 🚀 Deployment Complete
+
+### Summary
+
+- **Version:** v1.2.3
+- **Environment:** production
+- **Duration:** 47 seconds
+- **Platform:** Vercel
+
+### URLs
+
+- 🌐 Production: https://app.example.com
+- 📊 Dashboard: https://vercel.com/project
+
+### Health Check
+
+✅ API responding (200 OK)
+✅ Database connected
+✅ All services healthy
+```
+
+### Failed Deploy
+
+```markdown
+## ❌ Deployment Failed
+
+### Error
+
+[Error description]
+
+### Resolution
+
+1. [Fix steps]
+2. [Verification]
+3. Try `/deploy` again
+
+### Rollback Available
+
+Run `/deploy rollback` if needed.
+```
+
+---
+
+## Platform Support
+
+| Platform | Command         | Auto-detect |
+| -------- | --------------- | ----------- |
+| Vercel   | `vercel --prod` | Next.js     |
+| Railway  | `railway up`    | NestJS      |
+| Expo EAS | `eas build`     | Mobile      |
+
+---
+
+## Examples
+
+```
+/deploy
+/deploy check
+/deploy preview
+/deploy production
+/deploy rollback
+```