antigravity-devkit 1.0.0

package/template/skills/azure-devops/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: azure-devops
+description: Azure DevOps CI/CD pipelines and YAML configuration
+---
+
+# Azure DevOps
+
+> CI/CD pipelines with YAML configuration.
+
+---
+
+## Pipeline Structure
+
+```yaml
+trigger:
+  - main
+  - develop
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+variables:
+  buildConfiguration: 'Release'
+
+stages:
+  - stage: Build
+  - stage: Test
+  - stage: Deploy
+```
+
+---
+
+## Build Stage
+
+```yaml
+- stage: Build
+  jobs:
+    - job: BuildJob
+      steps:
+        - task: UseDotNet@2
+          inputs:
+            version: '8.x'
+            
+        - task: DotNetCoreCLI@2
+          displayName: 'Restore'
+          inputs:
+            command: 'restore'
+            
+        - task: DotNetCoreCLI@2
+          displayName: 'Build'
+          inputs:
+            command: 'build'
+            arguments: '--configuration $(buildConfiguration)'
+```
+
+---
+
+## Test Stage
+
+```yaml
+- stage: Test
+  dependsOn: Build
+  jobs:
+    - job: TestJob
+      steps:
+        - task: DotNetCoreCLI@2
+          displayName: 'Test'
+          inputs:
+            command: 'test'
+            arguments: '--collect:"XPlat Code Coverage"'
+```
+
+---
+
+## Deploy Stage
+
+```yaml
+- stage: Deploy
+  dependsOn: Test
+  condition: eq(variables['Build.SourceBranch'], 'refs/heads/main')
+  jobs:
+    - deployment: DeployJob
+      environment: 'production'
+      strategy:
+        runOnce:
+          deploy:
+            steps:
+              - task: AzureWebApp@1
+                inputs:
+                  appName: 'my-app'
+```
+
+---
+
+## KeyVault Integration
+
+```yaml
+- task: AzureKeyVault@2
+  inputs:
+    azureSubscription: 'MySubscription'
+    KeyVaultName: 'MyKeyVault'
+    SecretsFilter: '*'
+    RunAsPreJob: true
+```
+
+---
+
+## Approval Gates
+
+Configure in Azure DevOps UI:
+1. Environments → Production
+2. Approvals and checks
+3. Add approvers
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| YAML pipelines | Classic editor |
+| Environment approvals | Auto-deploy to prod |
+| KeyVault for secrets | Variable secrets |

package/template/skills/azure-keyvault/SKILL.md

@@ -0,0 +1,100 @@
+---
+name: azure-keyvault
+description: Azure KeyVault secrets management
+---
+
+# Azure KeyVault
+
+> Secure secrets management for Azure applications.
+
+---
+
+## ASP.NET Core Integration
+
+```csharp
+// Program.cs
+var builder = WebApplication.CreateBuilder(args);
+
+// Add KeyVault
+var keyVaultName = builder.Configuration["KeyVaultName"];
+var keyVaultUri = new Uri($"https://{keyVaultName}.vault.azure.net/");
+
+builder.Configuration.AddAzureKeyVault(
+    keyVaultUri,
+    new DefaultAzureCredential());
+```
+
+---
+
+## Required Package
+
+```xml
+<PackageReference Include="Azure.Extensions.AspNetCore.Configuration.Secrets" Version="1.*" />
+<PackageReference Include="Azure.Identity" Version="1.*" />
+```
+
+---
+
+## Secret Naming
+
+```
+KeyVault: ConnectionStrings--DefaultConnection
+Config:   ConnectionStrings:DefaultConnection
+```
+
+Use `--` in KeyVault, maps to `:` in configuration.
+
+---
+
+## Access Configuration
+
+```csharp
+// Access secret like any config
+var connectionString = builder.Configuration["ConnectionStrings:DefaultConnection"];
+var apiKey = builder.Configuration["ExternalApi:Key"];
+```
+
+---
+
+## Managed Identity
+
+For Azure-hosted apps (AKS, App Service):
+
+1. Enable Managed Identity on the resource
+2. Grant KeyVault access policy to the identity
+3. Use `DefaultAzureCredential()` - auto-detects
+
+---
+
+## Local Development
+
+```json
+// appsettings.Development.json
+{
+  "KeyVaultName": "my-keyvault-dev"
+}
+```
+
+Use Azure CLI login: `az login`
+
+---
+
+## Pipeline Integration
+
+```yaml
+- task: AzureKeyVault@2
+  inputs:
+    azureSubscription: 'MySubscription'
+    KeyVaultName: 'my-keyvault'
+    SecretsFilter: 'ConnectionString,ApiKey'
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| KeyVault for secrets | appsettings.json secrets |
+| Managed Identity | Service Principal keys |
+| Secret rotation | Static secrets forever |

package/template/skills/brainstorming/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: brainstorming
+description: Socratic discovery and requirement clarification
+---
+
+# Brainstorming
+
+> Clarify requirements before implementation.
+
+---
+
+## Socratic Method
+
+**Ask questions to uncover hidden requirements.**
+
+| Question Type | Purpose |
+|---------------|---------|
+| Clarifying | What exactly do you mean? |
+| Probing | Why is this important? |
+| Challenging | What if we did X instead? |
+| Boundary | What's out of scope? |
+
+---
+
+## Discovery Questions
+
+### Scope
+- What problem are we solving?
+- Who are the users?
+- What's the expected outcome?
+
+### Technical
+- What systems are involved?
+- Any existing constraints?
+- Performance requirements?
+
+### Timeline
+- What's the deadline?
+- MVP or full feature?
+- Can we iterate?
+
+---
+
+## Question Flow
+
+```
+1. Understand the GOAL
+   └─ "What should users be able to do?"
+
+2. Identify USERS
+   └─ "Who will use this?"
+
+3. Define SCOPE
+   └─ "What's in/out of scope?"
+
+4. Explore CONSTRAINTS
+   └─ "Any technical limitations?"
+
+5. Clarify PRIORITIES
+   └─ "What's most important?"
+```
+
+---
+
+## Response Format
+
+```markdown
+🤔 **Before we proceed, let me clarify:**
+
+1. [Clarifying question 1]
+2. [Clarifying question 2]
+3. [Clarifying question 3]
+
+Please answer these so I can create the best solution.
+```
+
+---
+
+## When to Brainstorm
+
+| ✅ Brainstorm | ❌ Skip |
+|---------------|---------|
+| Vague requests | Clear specifications |
+| New features | Bug fixes |
+| Complex tasks | Simple changes |
+| Multi-domain | Single file edit |
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Ask before assuming | Guess requirements |
+| Minimum 3 questions | Skip discovery |
+| Wait for answers | Start coding |

package/template/skills/clean-code/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: clean-code
+description: Pragmatic coding standards - concise, direct, no over-engineering
+priority: CRITICAL
+---
+
+# Clean Code Standards
+
+> Be **concise, direct, and solution-focused**.
+
+---
+
+## Core Principles
+
+| Principle | Rule |
+|-----------|------|
+| SRP | Single Responsibility - one thing per function/class |
+| DRY | Don't Repeat Yourself |
+| KISS | Keep It Simple |
+| YAGNI | You Aren't Gonna Need It |
+
+---
+
+## Naming
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Variables | Reveal intent | `userCount` not `n` |
+| Functions | Verb + noun | `getUserById()` |
+| Booleans | Question form | `isActive`, `hasPermission` |
+| Constants | SCREAMING_SNAKE | `MAX_RETRY_COUNT` |
+
+---
+
+## Functions
+
+| Rule | Guideline |
+|------|-----------|
+| Small | Max 20 lines |
+| One Thing | Single purpose |
+| Few Args | Max 3 parameters |
+| No Side Effects | Don't mutate inputs |
+
+---
+
+## Code Structure
+
+| Pattern | Apply |
+|---------|-------|
+| Guard Clauses | Early returns |
+| Flat > Nested | Max 2 levels |
+| Composition | Small functions together |
+
+---
+
+## Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|-------|
+| Comment every line | Self-documenting names |
+| Helper for one-liner | Inline the code |
+| Factory for 2 objects | Direct instantiation |
+| Deep nesting | Guard clauses |
+| Magic numbers | Named constants |
+
+---
+
+## Before Editing
+
+| Question | Why |
+|----------|-----|
+| What imports this file? | They might break |
+| What tests cover this? | Tests might fail |
+| Is this shared? | Multiple places affected |
+
+---
+
+## Self-Check
+
+| Check | Question |
+|-------|----------|
+| ✅ Goal met? | Did exactly what was asked? |
+| ✅ Code works? | Verified the change? |
+| ✅ No errors? | Lint and types pass? |

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

@@ -0,0 +1,115 @@
+---
+name: csharp-patterns
+description: Modern C# best practices and patterns
+---
+
+# C# Patterns
+
+> Modern C# with async/await, nullable, and clean patterns.
+
+---
+
+## Async/Await
+
+```csharp
+// ✅ Correct
+public async Task<User> GetUserAsync(int id)
+{
+    return await _repository.GetByIdAsync(id);
+}
+
+// ❌ Wrong - blocking
+public User GetUser(int id)
+{
+    return _repository.GetByIdAsync(id).Result;
+}
+```
+
+---
+
+## Nullable Reference Types
+
+```csharp
+// Enable in .csproj
+<Nullable>enable</Nullable>
+
+// Usage
+public User? GetUser(int id)  // Can be null
+public User GetRequiredUser(int id)  // Never null
+```
+
+---
+
+## Records
+
+```csharp
+// Immutable data objects
+public record UserDto(int Id, string Name, string Email);
+
+// With modification
+var updated = user with { Name = "New Name" };
+```
+
+---
+
+## Pattern Matching
+
+```csharp
+var result = user switch
+{
+    { Role: "Admin" } => "Full access",
+    { Role: "User" } => "Limited access",
+    null => "No user",
+    _ => "Unknown"
+};
+```
+
+---
+
+## LINQ Best Practices
+
+```csharp
+// ✅ Correct - efficient
+var activeUsers = users
+    .Where(u => u.IsActive)
+    .Select(u => u.Name)
+    .ToList();
+
+// ❌ Wrong - N+1
+foreach (var user in users)
+{
+    var orders = await GetOrdersAsync(user.Id);
+}
+```
+
+---
+
+## Exception Handling
+
+```csharp
+try
+{
+    await ProcessAsync();
+}
+catch (NotFoundException ex)
+{
+    _logger.LogWarning(ex, "Item not found: {Id}", id);
+    throw;
+}
+catch (Exception ex)
+{
+    _logger.LogError(ex, "Unexpected error");
+    throw;
+}
+```
+
+---
+
+## DO / DON'T
+
+| ✅ Do | ❌ Don't |
+|-------|---------|
+| Async all the way | .Result or .Wait() |
+| Nullable types | Ignore null warnings |
+| Records for DTOs | Mutable classes |
+| Pattern matching | Long if-else chains |

package/template/skills/documentation-templates/SKILL.md

@@ -0,0 +1,127 @@
+---
+name: documentation-templates
+description: Templates for technical documentation
+---
+
+# Documentation Templates
+
+> Standard templates for project documentation.
+
+---
+
+## README Template
+
+```markdown
+# Project Name
+
+Brief description.
+
+## Quick Start
+
+\`\`\`bash
+# Installation
+npm install
+
+# Run
+npm run dev
+\`\`\`
+
+## Features
+
+- Feature 1
+- Feature 2
+
+## Configuration
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| API_URL | API endpoint | http://localhost |
+
+## API Reference
+
+See [API Documentation](./docs/api.md)
+
+## Contributing
+
+1. Fork the repo
+2. Create feature branch
+3. Submit PR
+
+## License
+
+MIT
+```
+
+---
+
+## API Endpoint Template
+
+```markdown
+## GET /api/users/{id}
+
+Get user by ID.
+
+### Parameters
+
+| Name | Type | Description |
+|------|------|-------------|
+| id | int | User ID |
+
+### Response
+
+\`\`\`json
+{
+  "id": 1,
+  "name": "John",
+  "email": "john@example.com"
+}
+\`\`\`
+
+### Errors
+
+| Status | Description |
+|--------|-------------|
+| 404 | User not found |
+```
+
+---
+
+## Architecture Doc Template
+
+```markdown
+# Architecture: [System Name]
+
+## Overview
+
+Brief description of the system.
+
+## Components
+
+| Component | Purpose |
+|-----------|---------|
+| API | REST endpoints |
+| Database | Data storage |
+
+## Data Flow
+
+1. User action
+2. API call
+3. Database query
+4. Response
+
+## Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| SQL Server | Existing infrastructure |
+```
+
+---
+
+## When to Document
+
+| ✅ Document | ❌ Skip |
+|-------------|---------|
+| Public APIs | Internal helpers |
+| Complex logic | Self-documenting code |
+| Architecture decisions | Obvious patterns |