antigravity-devkit 1.0.0

package/template/skills/frontend-design/ux-psychology.md

@@ -0,0 +1,128 @@
+# UX Psychology Reference
+
+> Core UX laws, emotional design, trust building, and cognitive load management.
+
+---
+
+## Core UX Laws
+
+| Law | Principle | Application |
+|-----|-----------|-------------|
+| **Hick's Law** | More choices = slower decisions | Max 5-7 nav items, progressive disclosure |
+| **Fitts' Law** | Bigger + closer = easier to click | CTAs min 44px height, touch 44×44px |
+| **Miller's Law** | 7±2 items in working memory | Chunk content, group related items |
+| **Von Restorff** | Different = memorable | Make CTAs visually distinct |
+| **Serial Position** | First/last remembered | Key info at start and end |
+
+---
+
+## Emotional Design (Don Norman)
+
+```
+VISCERAL (instant)   → First impression: colors, imagery, overall feel
+                       "Wow, this looks beautiful!"
+
+BEHAVIORAL (use)     → Using it: speed, feedback, efficiency  
+                       "This works exactly how I expected!"
+
+REFLECTIVE (memory)  → After: identity, values, loyalty
+                       "This brand represents who I am"
+```
+
+### Designing for Each Level
+
+| Level | Focus | Implementation |
+|-------|-------|----------------|
+| **Visceral** | Beauty, first impression | Hero visuals, micro-interactions |
+| **Behavioral** | Usability, feedback | Instant confirmations, smooth flows |
+| **Reflective** | Identity, story | Brand values, testimonials, story |
+
+---
+
+## Trust Building
+
+| Category | Elements | Placement |
+|----------|----------|-----------|
+| **Security** | SSL badges, encryption | Forms, checkout |
+| **Social Proof** | Reviews, testimonials | Hero, product pages |
+| **Transparency** | Clear pricing, policies | Footer, checkout |
+| **Professional** | Consistent design | Everywhere |
+| **Authority** | Certifications, media mentions | Header, about |
+
+```
+Trust Signal Placement:
+┌─────────────────────────────────────────┐
+│ HEADER: Trust banner, security icons    │
+├─────────────────────────────────────────┤
+│ HERO: Social proof ("10,000+ users")    │
+├─────────────────────────────────────────┤
+│ PRODUCT: Reviews, guarantees            │
+├─────────────────────────────────────────┤
+│ CHECKOUT: Payment icons, SSL badge      │
+├─────────────────────────────────────────┤
+│ FOOTER: Contact, policies, certs        │
+└─────────────────────────────────────────┘
+```
+
+---
+
+## Cognitive Load Management
+
+| Type | Definition | Designer's Role |
+|------|------------|-----------------|
+| **Intrinsic** | Task complexity | Break into smaller steps |
+| **Extraneous** | Poor design load | **ELIMINATE THIS!** |
+| **Germane** | Learning effort | Support and encourage |
+
+### Reduction Strategies
+
+1. **Simplify** - Remove visual noise, clean layouts
+2. **Chunk** - Group into 5-7 item sets
+3. **Progressive Disclosure** - Hide advanced options
+4. **Familiar Patterns** - Standard placements
+5. **Offload** - Don't make users remember
+
+---
+
+## Audience → Design Approach
+
+| Audience | Colors | Typography | Layout | Trust |
+|----------|--------|------------|--------|-------|
+| **Gen Z** | Bold, vibrant | Large, experimental | Mobile-first, vertical | Peer reviews |
+| **Millennials** | Muted, earth tones | Clean sans-serif | Card-based | Values, sustainability |
+| **Gen X** | Professional | Conservative | Traditional hierarchy | Track record |
+| **Boomers** | High contrast | Large (18px+) | Simple, linear | Phone numbers, people |
+| **B2B** | Corporate blues | Professional | Data-focused | Certifications |
+| **Luxury** | Black, gold | Elegant serif | Spacious, minimal | Exclusivity |
+
+---
+
+## Emotion Color Mapping
+
+| Emotion | Colors | Industry Use |
+|---------|--------|--------------|
+| **Trust** | Blue, Green | Finance, Healthcare |
+| **Excitement** | Red, Orange | Sales, Sports |
+| **Calm** | Soft blue/green | Wellness, Spa |
+| **Luxury** | Black, Gold | Premium brands |
+| **Energy** | Yellow, Orange | Fitness, Kids |
+| **Nature** | Green, Brown | Eco, Organic |
+
+---
+
+## Psychology Checklist
+
+Before launch, verify:
+
+- [ ] **Hick's Law** - Max 7 nav items
+- [ ] **Fitts' Law** - Large, reachable CTAs
+- [ ] **Miller's Law** - Content chunked properly
+- [ ] **Von Restorff** - CTAs stand out
+- [ ] **Trust signals** - Security, reviews visible
+- [ ] **Cognitive load** - Clean, not overwhelming
+- [ ] **Feedback** - All actions confirmed
+- [ ] **Accessibility** - Inclusive for all users
+
+---
+
+> **Remember:** UX is psychology. Every design decision affects user behavior.

package/template/skills/gitops-patterns/SKILL.md

@@ -0,0 +1,105 @@
+---
+name: gitops-patterns
+description: GitOps patterns with ArgoCD and Flux
+---
+
+# GitOps Patterns
+
+> Git as the source of truth for infrastructure.
+
+---
+
+## GitOps Flow
+
+```
+Code Change → PR → Merge → CI Build → Image Push → Git Sync → Deploy
+```
+
+| Step | Tool |
+|------|------|
+| CI Build | Azure DevOps |
+| Image Push | Azure Container Registry |
+| Git Sync | ArgoCD / Flux |
+| Deploy | AKS |
+
+---
+
+## Repository Structure
+
+```
+gitops-repo/
+├── base/                 # Base manifests
+│   ├── deployment.yaml
+│   ├── service.yaml
+│   └── kustomization.yaml
+├── overlays/
+│   ├── dev/
+│   │   └── kustomization.yaml
+│   ├── staging/
+│   │   └── kustomization.yaml
+│   └── prod/
+│       └── kustomization.yaml
+```
+
+---
+
+## ArgoCD Application
+
+```yaml
+apiVersion: argoproj.io/v1alpha1
+kind: Application
+metadata:
+  name: myapp
+  namespace: argocd
+spec:
+  project: default
+  source:
+    repoURL: https://github.com/org/gitops-repo
+    targetRevision: HEAD
+    path: overlays/prod
+  destination:
+    server: https://kubernetes.default.svc
+    namespace: production
+  syncPolicy:
+    automated:
+      prune: true
+      selfHeal: true
+```
+
+---
+
+## Flux Configuration
+
+```yaml
+apiVersion: source.toolkit.fluxcd.io/v1
+kind: GitRepository
+metadata:
+  name: myapp
+spec:
+  interval: 1m
+  url: https://github.com/org/gitops-repo
+  ref:
+    branch: main
+---
+apiVersion: kustomize.toolkit.fluxcd.io/v1
+kind: Kustomization
+metadata:
+  name: myapp
+spec:
+  interval: 10m
+  path: ./overlays/prod
+  sourceRef:
+    kind: GitRepository
+    name: myapp
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Git for all changes | kubectl apply manually |
+| Automated sync | Manual deployments |
+| Environment overlays | Duplicate manifests |
+| PR reviews | Direct pushes |

package/template/skills/grafana-logging/SKILL.md

@@ -0,0 +1,107 @@
+---
+name: grafana-logging
+description: Grafana dashboards and metrics logging
+---
+
+# Grafana Logging
+
+> Metrics, dashboards, and alerting with Grafana.
+
+---
+
+## Key Metrics
+
+### Application Metrics
+| Metric | Description |
+|--------|-------------|
+| Request rate | Requests per second |
+| Error rate | Errors per second |
+| Duration | Response time percentiles |
+| Active requests | Concurrent requests |
+
+### Infrastructure Metrics
+| Metric | Description |
+|--------|-------------|
+| CPU usage | Percentage used |
+| Memory usage | Bytes used |
+| Disk I/O | Read/write operations |
+| Network | Bytes in/out |
+
+---
+
+## Prometheus Metrics (ASP.NET)
+
+```csharp
+// Install package
+// dotnet add package prometheus-net.AspNetCore
+
+// Program.cs
+app.UseMetricServer();  // /metrics endpoint
+app.UseHttpMetrics();   // HTTP request metrics
+```
+
+---
+
+## Custom Metrics
+
+```csharp
+using Prometheus;
+
+public class OrderService
+{
+    private static readonly Counter OrdersCreated = Metrics
+        .CreateCounter("orders_created_total", "Total orders created");
+    
+    private static readonly Histogram OrderDuration = Metrics
+        .CreateHistogram("order_duration_seconds", "Order processing time");
+    
+    public async Task CreateOrder(Order order)
+    {
+        using (OrderDuration.NewTimer())
+        {
+            await ProcessOrder(order);
+            OrdersCreated.Inc();
+        }
+    }
+}
+```
+
+---
+
+## Dashboard Queries
+
+```promql
+# Request rate
+rate(http_requests_total[5m])
+
+# Error rate
+rate(http_requests_total{status=~"5.."}[5m])
+
+# 95th percentile latency
+histogram_quantile(0.95, rate(http_request_duration_seconds_bucket[5m]))
+```
+
+---
+
+## Alerting
+
+```yaml
+# Alert rule
+- alert: HighErrorRate
+  expr: rate(http_requests_total{status=~"5.."}[5m]) > 0.1
+  for: 5m
+  labels:
+    severity: critical
+  annotations:
+    summary: High error rate detected
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| RED method (Rate, Error, Duration) | Track everything |
+| Set alerting thresholds | Alert fatigue |
+| Dashboard per service | One giant dashboard |

package/template/skills/intelligent-routing/SKILL.md

@@ -0,0 +1,75 @@
+---
+name: intelligent-routing
+description: Auto-select best agent for each request
+---
+
+# Intelligent Routing
+
+> Automatically select the best agent for each task.
+
+---
+
+## Routing Matrix
+
+| Keywords | Agent |
+|----------|-------|
+| vue, component, pinia, frontend | frontend-specialist |
+| api, controller, service, c#, aspnet | backend-specialist |
+| sql, database, schema, query | database-architect |
+| deploy, pipeline, aks, kubernetes | devops-engineer |
+| security, keyvault, audit, owasp | security-auditor |
+| test, xunit, vitest, coverage | test-engineer |
+| bug, error, fix, debug | debugger |
+| performance, slow, metrics | performance-optimizer |
+| docs, readme, documentation | documentation-writer |
+| analyze, explore, overview | explorer-agent |
+| plan, design, architecture | project-planner |
+| complex, multi-domain | orchestrator |
+
+---
+
+## Routing Protocol
+
+### Step 1: Analyze Request
+Identify keywords and domain indicators.
+
+### Step 2: Match Agent
+Use routing matrix to find best match.
+
+### Step 3: Check Complexity
+- Single domain → Direct to specialist
+- Multi-domain → Route to orchestrator
+
+### Step 4: Inform User
+```markdown
+🤖 **Applying `@[agent-name]`...**
+```
+
+---
+
+## Multi-Domain Detection
+
+| Indicators | Action |
+|------------|--------|
+| "full-stack" | orchestrator |
+| Frontend + Backend | orchestrator |
+| Multiple file types | orchestrator |
+
+---
+
+## Override Rules
+
+| User Says | Action |
+|-----------|--------|
+| @agent-name | Use specified agent |
+| /command | Follow command flow |
+| "don't ask" | Skip Socratic Gate |
+
+---
+
+## Fallback
+
+If no clear match:
+1. Ask user to clarify
+2. Default to `project-planner` for planning
+3. Default to `orchestrator` for execution

package/template/skills/plan-writing/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: plan-writing
+description: Task breakdown and project planning
+---
+
+# Plan Writing
+
+> Structure tasks for clear execution.
+
+---
+
+## Plan File Format
+
+**Location:** `docs/PLAN-{slug}.md`
+
+```markdown
+# PLAN: [Feature Name]
+
+## Overview
+Brief description of what we're building.
+
+## Requirements
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+## Tasks
+
+### Phase 1: Backend
+- [ ] Task 1 [@backend-specialist]
+- [ ] Task 2 [@database-architect]
+
+### Phase 2: Frontend
+- [ ] Task 3 [@frontend-specialist]
+
+### Phase 3: Testing
+- [ ] Task 4 [@test-engineer]
+
+## Verification
+- [ ] Run checklist.py
+- [ ] Manual testing
+- [ ] Code review
+```
+
+---
+
+## Task Breakdown Rules
+
+| Rule | Description |
+|------|-------------|
+| Specific | Clear deliverable |
+| Atomic | Single responsibility |
+| Assigned | Agent specified |
+| Ordered | Dependencies clear |
+
+---
+
+## Naming Convention
+
+| Request | Slug |
+|---------|------|
+| E-commerce cart | ecommerce-cart |
+| User authentication | user-auth |
+| Dashboard analytics | dashboard-analytics |
+
+---
+
+## Task Sizing
+
+| Size | Description | Time |
+|------|-------------|------|
+| S | Single file change | < 30 min |
+| M | Few files, one domain | 1-2 hours |
+| L | Multiple domains | 2-4 hours |
+| XL | Break into sub-tasks | - |
+
+---
+
+## Dependencies
+
+```markdown
+## Tasks
+- [ ] 1. Create database schema [@database-architect]
+- [ ] 2. Create API endpoints [@backend-specialist] (depends: 1)
+- [ ] 3. Create UI components [@frontend-specialist] (depends: 2)
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Assign agents | Leave unassigned |
+| Order by dependency | Random order |
+| Include verification | Skip testing tasks |
+| Break large tasks | Massive single tasks |

package/template/skills/sqlserver-design/SKILL.md

@@ -0,0 +1,97 @@
+---
+name: sqlserver-design
+description: SQL Server schema design and query optimization
+---
+
+# SQL Server Design
+
+> Efficient schema design and query optimization.
+
+---
+
+## Naming Conventions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Table | PascalCase, plural | Users, Orders |
+| Column | PascalCase | FirstName |
+| PK | Id | Id |
+| FK | {Table}Id | UserId |
+| Index | IX_{Table}_{Column} | IX_Users_Email |
+
+---
+
+## Standard Columns
+
+```sql
+CREATE TABLE Users (
+    Id INT IDENTITY(1,1) PRIMARY KEY,
+    -- Business columns
+    Email NVARCHAR(255) NOT NULL,
+    Name NVARCHAR(100) NOT NULL,
+    -- Audit columns
+    CreatedAt DATETIME2 DEFAULT GETUTCDATE(),
+    UpdatedAt DATETIME2 NULL,
+    IsDeleted BIT DEFAULT 0
+);
+```
+
+---
+
+## Relationships
+
+```sql
+-- One-to-Many
+ALTER TABLE Orders
+ADD CONSTRAINT FK_Orders_Users
+FOREIGN KEY (UserId) REFERENCES Users(Id);
+
+-- Many-to-Many
+CREATE TABLE UserRoles (
+    UserId INT,
+    RoleId INT,
+    PRIMARY KEY (UserId, RoleId)
+);
+```
+
+---
+
+## Indexing
+
+| Scenario | Index Type |
+|----------|------------|
+| Primary key | Clustered (auto) |
+| Foreign key | Non-clustered |
+| Search column | Non-clustered |
+| Composite search | Composite |
+
+```sql
+CREATE INDEX IX_Users_Email ON Users(Email);
+CREATE INDEX IX_Orders_UserId ON Orders(UserId);
+```
+
+---
+
+## Query Patterns
+
+```sql
+-- Parameterized (safe)
+SELECT * FROM Users WHERE Email = @Email
+
+-- Pagination
+SELECT * FROM Users
+ORDER BY CreatedAt DESC
+OFFSET @Skip ROWS
+FETCH NEXT @Take ROWS ONLY
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Parameterized queries | String concatenation |
+| Index foreign keys | Skip FK indexes |
+| UTC timestamps | Local time |
+| Soft delete | Hard delete (usually) |

package/template/skills/systematic-debugging/SKILL.md

@@ -0,0 +1,98 @@
+---
+name: systematic-debugging
+description: Root cause analysis and debugging methodology
+---
+
+# Systematic Debugging
+
+> Find root causes, not just symptoms.
+
+---
+
+## Debugging Flow
+
+```
+1. REPRODUCE → Can you trigger the bug?
+2. ISOLATE   → Where exactly does it fail?
+3. IDENTIFY  → What is the root cause?
+4. FIX       → Minimal change to solve it
+5. VERIFY    → Does it work? Any regressions?
+```
+
+---
+
+## Questions to Ask
+
+### Reproduce
+- What are the exact steps?
+- What's expected vs actual?
+- Is it consistent or intermittent?
+
+### Isolate
+- Which file/function fails?
+- What changed recently?
+- What are the inputs?
+
+### Identify
+- Is this the root cause or symptom?
+- Why does this happen?
+- Are there similar issues?
+
+---
+
+## Error Pattern Analysis
+
+| Symptom | Check |
+|---------|-------|
+| 500 error | Logs, exception details |
+| 404 error | Routes, URLs |
+| Null reference | Data flow, null checks |
+| Type error | Types, casting |
+| Works locally | Environment config |
+| Intermittent | Race conditions, timing |
+
+---
+
+## Logging Strategy
+
+```csharp
+// C# - structured logging
+_logger.LogError(ex, "Failed to process order {OrderId}", orderId);
+```
+
+```typescript
+// TypeScript
+console.error('Failed to fetch user:', { userId, error });
+```
+
+---
+
+## Fix Principles
+
+| Principle | Description |
+|-----------|-------------|
+| Minimal | Smallest change that works |
+| Focused | Only fix the bug |
+| Tested | Add regression test |
+| Documented | Comment if complex |
+
+---
+
+## Post-Fix Checklist
+
+- [ ] Root cause confirmed
+- [ ] Minimal fix applied
+- [ ] Regression test added
+- [ ] No side effects
+- [ ] Documentation updated
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Find root cause | Patch symptoms |
+| Minimal changes | Multiple fixes |
+| Add tests | Skip verification |
+| Check side effects | Assume it works |