antigravity-devkit 1.0.0

package/template/ARCHITECTURE.md

@@ -0,0 +1,148 @@
+# Antigravity Kit Architecture
+
+> Vue3 + ASP.NET + Azure Development Toolkit
+
+---
+
+## Overview
+
+| Metric | Value |
+|--------|-------|
+| Agents | 12 |
+| Skills | 20 |
+| Workflows | 10 |
+| Scripts | 2 master + skill-level |
+
+---
+
+## Directory Structure
+
+```
+.agent-antigravity/
+├── ARCHITECTURE.md     # This file
+├── README.md           # Usage guide
+├── rules/GEMINI.md     # Global rules
+├── agents/             # 12 Specialist Agents
+├── skills/             # 20 Skill Modules
+├── workflows/          # 10 Slash Commands
+└── scripts/            # Validation Scripts
+```
+
+---
+
+## Agents (12)
+
+| Agent | Focus | Skills |
+|-------|-------|--------|
+| orchestrator | Multi-agent coordination | intelligent-routing, brainstorming |
+| project-planner | Discovery, planning | brainstorming, plan-writing, architecture |
+| frontend-specialist | Vue3, TypeScript, Pinia | vue3-patterns, vitest-testing |
+| backend-specialist | ASP.NET Core, C# | aspnet-patterns, csharp-patterns, api-patterns |
+| database-architect | SQL Server | sqlserver-design |
+| devops-engineer | Azure DevOps, AKS, GitOps | azure-devops, azure-aks, gitops-patterns |
+| security-auditor | KeyVault, OWASP | vulnerability-scanner, azure-keyvault |
+| test-engineer | xUnit, Vitest, E2E | xunit-testing, vitest-testing |
+| debugger | Root cause analysis | systematic-debugging |
+| performance-optimizer | Grafana, metrics | grafana-logging |
+| documentation-writer | API docs | documentation-templates |
+| explorer-agent | Codebase analysis | - |
+
+---
+
+## Skills (20)
+
+### Frontend & Vue3
+| Skill | Description |
+|-------|-------------|
+| vue3-patterns | Composition API, Pinia, Vue Router |
+| vitest-testing | Vue component testing |
+
+### Backend & ASP.NET
+| Skill | Description |
+|-------|-------------|
+| aspnet-patterns | Controllers, Services, Middleware |
+| csharp-patterns | C# best practices, async/await |
+| api-patterns | REST API design |
+
+### Database
+| Skill | Description |
+|-------|-------------|
+| sqlserver-design | Schema, stored procedures, optimization |
+
+### Azure & DevOps
+| Skill | Description |
+|-------|-------------|
+| azure-devops | CI/CD pipelines, YAML |
+| azure-aks | Kubernetes, Helm charts |
+| azure-keyvault | Secrets management |
+| grafana-logging | Metrics, dashboards |
+| gitops-patterns | ArgoCD, Flux |
+
+### Testing
+| Skill | Description |
+|-------|-------------|
+| xunit-testing | C# unit tests |
+| testing-patterns | Test strategies |
+
+### Core
+| Skill | Description |
+|-------|-------------|
+| clean-code | Coding standards |
+| architecture | System design patterns |
+| brainstorming | Socratic discovery |
+| plan-writing | Task breakdown |
+| intelligent-routing | Agent selection |
+| vulnerability-scanner | Security auditing |
+
+### Industry
+| Skill | Description |
+|-------|-------------|
+| english-education | Curriculum, lessons, quizzes |
+
+---
+
+## Workflows (10)
+
+| Command | Description |
+|---------|-------------|
+| /brainstorm | Socratic discovery |
+| /plan | Create PLAN-{slug}.md |
+| /create | Full feature build |
+| /code | Code generation |
+| /test | Generate tests |
+| /debug | Root cause analysis |
+| /review | Code review |
+| /deploy | Azure DevOps trigger |
+| /status | Project health |
+| /orchestrate | Multi-agent coordination |
+
+---
+
+## Skill Loading Protocol
+
+```
+User Request → Agent Selected → Load SKILL.md → Read references/
+```
+
+### Skill Structure
+```
+skill-name/
+├── SKILL.md       # Required - metadata & rules
+├── references/    # Optional - templates, docs
+└── scripts/       # Optional - validation scripts
+```
+
+---
+
+## Quick Reference
+
+| Need | Agent | Skills |
+|------|-------|--------|
+| Vue3 Component | frontend-specialist | vue3-patterns |
+| ASP.NET API | backend-specialist | aspnet-patterns, api-patterns |
+| SQL Schema | database-architect | sqlserver-design |
+| Deploy to AKS | devops-engineer | azure-aks, gitops-patterns |
+| Security Audit | security-auditor | vulnerability-scanner |
+| Tests | test-engineer | xunit-testing, vitest-testing |
+| Debug | debugger | systematic-debugging |
+| Plan | project-planner | brainstorming, plan-writing |

package/template/README.md

@@ -0,0 +1,421 @@
+# Antigravity DevKit for Vue3 + ASP.NET + Azure
+
+> A modular AI development toolkit that gives your AI assistant specialized knowledge for Vue3 + ASP.NET Core + Azure development.
+
+---
+
+## What is This Kit?
+
+This kit transforms a general AI assistant into a **specialized development team** with:
+- **12 Expert Agents** - AI personas with domain expertise
+- **20 Skills** - Reusable knowledge modules
+- **10 Workflows** - Slash commands for common tasks
+- **Validation Scripts** - Automated quality checks
+
+### Why Use It?
+
+| Without Kit | With Kit |
+|-------------|----------|
+| Generic AI responses | Specialized expertise for your stack |
+| Inconsistent patterns | Enforced best practices |
+| Manual quality checks | Automated validation |
+| One-shot responses | Multi-step workflows with checkpoints |
+
+---
+
+## Installations
+
+### Option 1: npm (Recommended)
+
+```bash
+# One-time use with npx
+npx antigravity-devkit init
+
+# OR install globally for frequent use
+npm install -g antigravity-devkit
+antigravity-devkit init
+```
+
+### Option 2: Manual Copy
+
+```bash
+# Copy to your project root
+cp -r .agent-antigravity .agent
+```
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `antigravity-devkit init` | Install kit to `.agent/` folder |
+| `antigravity-devkit init --force` | Overwrite existing `.agent/` |
+| `antigravity-devkit update` | Update kit (backs up existing) |
+| `antigravity-devkit help` | Show help and usage |
+
+---
+
+## Quick Start
+
+After installation, start using slash commands:
+
+```bash
+/plan user authentication feature
+/code create login component  
+/test generate tests
+/deploy to production
+```
+
+---
+
+## How It Works
+
+```
+User Request
+     ↓
+┌─────────────────────────────────────────────────────┐
+│  rules/GEMINI.md (Always Active)                    │
+│  - Classifies request type                          │
+│  - Routes to appropriate agent                      │
+│  - Enforces global standards                        │
+└─────────────────────────────────────────────────────┘
+     ↓
+┌─────────────────────────────────────────────────────┐
+│  agents/*.md (Specialist Selected)                  │
+│  - Applies domain expertise                         │
+│  - Loads required skills                            │
+│  - Follows agent-specific rules                     │
+└─────────────────────────────────────────────────────┘
+     ↓
+┌─────────────────────────────────────────────────────┐
+│  skills/*/SKILL.md (Knowledge Loaded)               │
+│  - Provides patterns and templates                  │
+│  - Defines best practices                           │
+│  - References additional docs if needed             │
+└─────────────────────────────────────────────────────┘
+     ↓
+Response with specialized knowledge
+```
+
+---
+
+## Directory Structure Explained
+
+```
+.agent-antigravity/
+├── README.md              # You are here
+├── ARCHITECTURE.md        # Quick reference for all components
+├── rules/                 # GLOBAL RULES (Always Active)
+│   └── GEMINI.md
+├── agents/                # SPECIALIST AGENTS (Selected per task)
+│   └── *.md
+├── skills/                # KNOWLEDGE MODULES (Loaded by agents)
+│   └── */SKILL.md
+├── workflows/             # SLASH COMMANDS (User-triggered)
+│   └── *.md
+└── scripts/               # VALIDATION TOOLS (Run manually or auto)
+    └── *.py
+```
+
+---
+
+## Folder Details
+
+### 📁 `rules/` - Global Rules (Always Active)
+
+**What:** Rules that apply to EVERY interaction.
+
+**When Applied:** Automatically, before any response.
+
+**Contains:**
+- `GEMINI.md` - Master rules file with:
+  - Request classification (question, code, design, etc.)
+  - Agent routing logic (which agent handles what)
+  - Universal coding standards
+  - Human-in-the-loop checkpoints
+  - Socratic Gate (ask before assuming)
+
+**Priority:** Highest - these rules override everything else.
+
+```
+Rule Priority: GEMINI.md > Agent.md > SKILL.md
+```
+
+---
+
+### 📁 `agents/` - Specialist Agents (Selected Per Task)
+
+**What:** AI personas with specialized expertise for specific domains.
+
+**When Applied:** When request matches agent's domain (auto-routed or manually invoked with `@agent-name`).
+
+**How It Works:**
+1. Request comes in: "Create a Vue component for user profile"
+2. GEMINI.md routes to `frontend-specialist`
+3. Agent file is loaded with its skills
+4. Response follows agent's patterns and rules
+
+**Available Agents:**
+
+| Agent | Domain | When to Use |
+|-------|--------|-------------|
+| `orchestrator` | Multi-agent coordination | Complex tasks spanning multiple domains |
+| `project-planner` | Discovery, planning | New features, architecture decisions |
+| `frontend-specialist` | Vue3, TypeScript | Components, state, UI logic |
+| `backend-specialist` | ASP.NET, C# | APIs, services, business logic |
+| `database-architect` | SQL Server | Schema design, queries, migrations |
+| `devops-engineer` | Azure DevOps, AKS | Pipelines, deployments, infrastructure |
+| `security-auditor` | Security, KeyVault | Audits, vulnerability checks |
+| `test-engineer` | xUnit, Vitest | Unit tests, integration tests |
+| `debugger` | Bug fixing | Root cause analysis, debugging |
+| `performance-optimizer` | Grafana, metrics | Performance tuning, monitoring |
+| `documentation-writer` | Docs, README | API docs, technical writing |
+| `explorer-agent` | Codebase analysis | Understanding existing code |
+
+**Manual Invocation:**
+```
+@backend-specialist create a user service
+@security-auditor review this controller
+```
+
+---
+
+### 📁 `skills/` - Knowledge Modules (Loaded by Agents)
+
+**What:** Reusable knowledge packages that agents load for specific tasks.
+
+**When Applied:** When an agent needs specialized knowledge (defined in agent's frontmatter).
+
+**Structure:**
+```
+skills/
+└── skill-name/
+    ├── SKILL.md           # Main skill file (required)
+    ├── references/        # Templates, examples (optional)
+    └── scripts/           # Validation scripts (optional)
+```
+
+**How Loading Works:**
+```yaml
+# In agent file (e.g., backend-specialist.md)
+---
+skills: clean-code, aspnet-patterns, api-patterns
+---
+```
+When `backend-specialist` is activated, these skills are loaded.
+
+**Available Skills by Category:**
+
+| Category | Skills | Purpose |
+|----------|--------|---------|
+| **Core** | `clean-code`, `architecture` | Universal coding standards |
+| **Planning** | `brainstorming`, `plan-writing` | Discovery and task breakdown |
+| **Frontend** | `vue3-patterns`, `vitest-testing` | Vue3 + Tailwind patterns |
+| **UI/UX Design** | `frontend-design` | Design thinking, UX psychology, anti-AI-slop, animations, Tailwind theming |
+| **Backend** | `aspnet-patterns`, `csharp-patterns`, `api-patterns` | ASP.NET best practices |
+| **Database** | `sqlserver-design` | SQL Server patterns |
+| **Azure** | `azure-devops`, `azure-aks`, `azure-keyvault` | Azure services |
+| **DevOps** | `gitops-patterns`, `grafana-logging` | CI/CD and monitoring |
+| **Testing** | `xunit-testing`, `testing-patterns` | Test strategies |
+| **Security** | `vulnerability-scanner` | Security checks |
+| **Industry** | `english-education` | Domain-specific (customizable) |
+
+---
+
+### 📁 `workflows/` - Slash Commands (User-Triggered)
+
+**What:** Pre-defined procedures for common development tasks.
+
+**When Applied:** When user types a slash command (e.g., `/plan`, `/code`).
+
+**Available Commands:**
+
+| Command | Purpose | Output |
+|---------|---------|--------|
+| `/brainstorm` | Clarify requirements | Questions → Understanding |
+| `/plan` | Create project plan | `docs/PLAN-{slug}.md` file |
+| `/create` | Build complete feature | Code + Tests + Verification |
+| `/code` | Generate specific code | Code for one task |
+| `/test` | Generate tests | Test files |
+| `/debug` | Fix bugs | Root cause → Fix → Verify |
+| `/review` | Code review | Review report |
+| `/deploy` | Trigger deployment | Pipeline trigger |
+| `/status` | Check project health | Status report |
+| `/orchestrate` | Multi-agent task | Coordinated execution |
+
+**Choosing the Right Command:**
+
+| Your Situation | Use This | Why |
+|----------------|----------|-----|
+| "I have a vague idea" | `/brainstorm` | Clarify before building |
+| "I know what to build" | `/plan` | Create task breakdown |
+| "I have a plan, build it all" | `/create` | Full feature with checkpoints |
+| "Just this one thing" | `/code` | Quick, focused output |
+| "Something is broken" | `/debug` | Systematic fix |
+| "Is this code good?" | `/review` | Quality check |
+| "Ready to ship" | `/deploy` | Trigger pipeline |
+
+**Key Differences:**
+
+| `/create` | `/code` |
+|-----------|---------|
+| Full feature (many files) | Single task (few files) |
+| Follows a plan file | No plan needed |
+| Multiple agents | One specialist |
+| Checkpoints for approval | Quick execution |
+
+| `/brainstorm` | `/plan` |
+|---------------|---------|
+| Discover requirements | Define tasks |
+| Output: understanding | Output: PLAN-*.md file |
+| Use when unclear | Use when clear |
+
+---
+
+### 📁 `scripts/` - Validation Tools (Manual or Auto)
+
+**What:** Python scripts for automated quality checks.
+
+**When Applied:** 
+- Manually: Run from terminal
+- Auto: Agents may run after completing tasks
+
+**Available Scripts:**
+
+| Script | Purpose | When to Use |
+|--------|---------|-------------|
+| `checklist.py` | Quick validation (lint, types, tests) | During development, pre-commit |
+| `verify_all.py` | Comprehensive check (all validations) | Before deployment, releases |
+
+**Usage:**
+```bash
+# Quick check during development
+python .agent/scripts/checklist.py .
+
+# Full verification before deploy
+python .agent/scripts/verify_all.py . --url http://localhost:3000
+```
+
+**What They Check:**
+- Security (secrets, vulnerabilities)
+- Code quality (lint, types)
+- Tests (pass/fail, coverage)
+- Build (compiles successfully)
+- Dependencies (outdated, vulnerable)
+
+---
+
+## Typical Workflows
+
+### Building a New Feature
+
+```
+1. /brainstorm user authentication
+   → AI asks clarifying questions
+   → You answer and confirm understanding
+
+2. /plan user authentication
+   → Creates docs/PLAN-user-auth.md
+   → Review and approve the plan
+
+3. /create user authentication
+   → AI follows the plan
+   → Builds backend → [Checkpoint] → Builds frontend → [Checkpoint]
+   → Generates tests → [Checkpoint]
+
+4. /review
+   → Security and quality check
+   → Approve for deployment
+
+5. /deploy
+   → Triggers Azure DevOps pipeline
+```
+
+### Quick Single Task
+
+```
+/code create a Vue component for user avatar
+→ Routes to frontend-specialist
+→ Generates component with TypeScript
+→ Done
+```
+
+### Fixing a Bug
+
+```
+/debug login fails with 401 error
+→ AI investigates root cause
+→ Proposes fix
+→ You approve
+→ Fix applied and tested
+```
+
+---
+
+## Customization
+
+### Adding Your Own Skill
+
+1. Create folder: `skills/your-skill/`
+2. Add `SKILL.md` with frontmatter:
+```yaml
+---
+name: your-skill
+description: What this skill does
+---
+# Your Skill Name
+
+[Your skill content - patterns, rules, templates]
+```
+3. Reference it in an agent's skills list
+
+### Modifying an Agent
+
+Edit the agent's `.md` file to:
+- Change which skills it loads
+- Modify its rules and patterns
+- Update its domain expertise
+
+### Adding Industry-Specific Knowledge
+
+Use `skills/english-education/` as a template:
+```
+skills/your-industry/
+├── SKILL.md              # Main skill file
+├── references/           # Industry templates
+│   ├── template-1.md
+│   └── template-2.md
+└── scripts/              # Industry validators
+    └── validator.py
+```
+
+---
+
+## Tech Stack
+
+| Layer | Technology |
+|-------|------------|
+| Frontend | Vue3, TypeScript, Pinia, Vitest |
+| Backend | ASP.NET Core, C#, xUnit |
+| Database | SQL Server |
+| Cloud | Azure DevOps, AKS, KeyVault |
+| Observability | Grafana |
+| GitOps | ArgoCD/Flux pattern |
+
+---
+
+## File Reference
+
+| File | Purpose |
+|------|---------|
+| `ARCHITECTURE.md` | Quick reference table of all components |
+| `rules/GEMINI.md` | Master rules (always active) |
+| `agents/*.md` | Specialist personas |
+| `skills/*/SKILL.md` | Knowledge modules |
+| `workflows/*.md` | Slash command definitions |
+| `scripts/*.py` | Validation scripts |
+
+---
+
+## License
+
+MIT

package/template/agents/backend-specialist.md

@@ -0,0 +1,137 @@
+---
+name: backend-specialist
+description: ASP.NET Core and C# expert. Builds APIs, services, and middleware. Triggers on api, controller, service, aspnet, csharp, backend.
+tools: Read, Grep, Glob, Bash, Edit, Write
+model: inherit
+skills: clean-code, aspnet-patterns, csharp-patterns, api-patterns, azure-keyvault
+---
+
+# Backend Specialist Agent
+
+You are an ASP.NET Core expert who builds secure, scalable backend systems.
+
+## Your Expertise
+
+- ASP.NET Core 8+
+- C# modern patterns
+- REST API design
+- Entity Framework Core
+- xUnit testing
+
+---
+
+## Before Coding: ASK
+
+| Aspect | Question |
+|--------|----------|
+| API Style | REST or minimal API? |
+| Auth | JWT, Cookie, or Azure AD? |
+| Database | SQL Server connection? |
+| Validation | FluentValidation or DataAnnotations? |
+
+---
+
+## Architecture Pattern
+
+```
+Controller → Service → Repository → Database
+     ↓           ↓           ↓
+  Validation  Business    Data Access
+              Logic
+```
+
+### Layer Responsibilities
+
+| Layer | Does | Doesn't |
+|-------|------|---------|
+| Controller | Route, validate, respond | Business logic |
+| Service | Business logic, orchestration | Data access |
+| Repository | Data access, queries | Business logic |
+
+---
+
+## C# Patterns
+
+### Async/Await
+```csharp
+public async Task<ActionResult<UserDto>> GetUser(int id)
+{
+    var user = await _userService.GetByIdAsync(id);
+    return user is null ? NotFound() : Ok(user);
+}
+```
+
+### Dependency Injection
+```csharp
+public class UserService : IUserService
+{
+    private readonly IUserRepository _repository;
+    
+    public UserService(IUserRepository repository)
+    {
+        _repository = repository;
+    }
+}
+```
+
+---
+
+## API Design
+
+| Method | Use Case | Response |
+|--------|----------|----------|
+| GET | Read | 200 OK, 404 Not Found |
+| POST | Create | 201 Created, 400 Bad Request |
+| PUT | Update | 200 OK, 404 Not Found |
+| DELETE | Delete | 204 No Content |
+
+### Response Format
+```json
+{
+  "success": true,
+  "data": { },
+  "error": null
+}
+```
+
+---
+
+## DO
+
+✅ Async/await everywhere
+✅ Dependency injection
+✅ Input validation
+✅ Proper HTTP status codes
+✅ Exception handling middleware
+✅ xUnit tests for services
+
+## DON'T
+
+❌ Business logic in controllers
+❌ Hardcoded secrets (use KeyVault)
+❌ Skip input validation
+❌ Return 200 for errors
+❌ Synchronous I/O
+
+---
+
+## Security
+
+| Rule | Implementation |
+|------|----------------|
+| Secrets | Azure KeyVault |
+| Auth | JWT or Azure AD |
+| Validation | Always validate input |
+| HTTPS | Required in production |
+
+---
+
+## Quality Control
+
+After editing:
+```bash
+dotnet build
+dotnet test
+```
+
+Fix ALL errors before completing.