antigravity-devkit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Your Name
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/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/bin/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const TEMPLATE_DIR = path.join(__dirname, '..', 'template');
+const TARGET_DIR = path.join(process.cwd(), '.agent');
+
+const commands = {
+  init: initKit,
+  update: updateKit,
+  help: showHelp
+};
+
+function main() {
+  const args = process.argv.slice(2);
+  const command = args[0] || 'help';
+  
+  if (commands[command]) {
+    commands[command](args.slice(1));
+  } else {
+    console.error(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+  }
+}
+
+function initKit(args) {
+  console.log('\n🚀 Antigravity DevKit - Vue3 + ASP.NET + Azure\n');
+  
+  const force = args.includes('--force') || args.includes('-f');
+  
+  if (fs.existsSync(TARGET_DIR) && !force) {
+    console.error('❌ .agent folder already exists!');
+    console.log('   Use --force to overwrite: npx antigravity-devkit init --force\n');
+    process.exit(1);
+  }
+  
+  console.log('📁 Copying DevKit to .agent/...\n');
+  
+  try {
+    copyDirectory(TEMPLATE_DIR, TARGET_DIR);
+    
+    console.log('✅ DevKit installed successfully!\n');
+    console.log('📂 Created: .agent/');
+    console.log('   ├── README.md');
+    console.log('   ├── ARCHITECTURE.md');
+    console.log('   ├── rules/GEMINI.md');
+    console.log('   ├── agents/ (12 specialists)');
+    console.log('   ├── skills/ (20 modules)');
+    console.log('   ├── workflows/ (10 commands)');
+    console.log('   └── scripts/ (validation tools)\n');
+    
+    console.log('🎯 Quick Start:');
+    console.log('   /plan my new feature');
+    console.log('   /code create a component');
+    console.log('   /test generate tests\n');
+    
+    console.log('📖 See .agent/README.md for full documentation\n');
+    
+  } catch (error) {
+    console.error('❌ Error installing DevKit:', error.message);
+    process.exit(1);
+  }
+}
+
+function updateKit(args) {
+  console.log('\n🔄 Updating Antigravity DevKit...\n');
+  
+  if (!fs.existsSync(TARGET_DIR)) {
+    console.error('❌ .agent folder not found!');
+    console.log('   Run "npx antigravity-devkit init" first\n');
+    process.exit(1);
+  }
+  
+  // Backup existing customizations
+  const customSkills = path.join(TARGET_DIR, 'skills');
+  const backupDir = path.join(process.cwd(), '.agent-backup');
+  
+  console.log('📦 Backing up existing .agent to .agent-backup...');
+  
+  try {
+    if (fs.existsSync(backupDir)) {
+      fs.rmSync(backupDir, { recursive: true });
+    }
+    copyDirectory(TARGET_DIR, backupDir);
+    
+    // Remove and reinstall
+    fs.rmSync(TARGET_DIR, { recursive: true });
+    copyDirectory(TEMPLATE_DIR, TARGET_DIR);
+    
+    console.log('✅ DevKit updated successfully!');
+    console.log('📂 Backup saved to .agent-backup/\n');
+    console.log('⚠️  If you had custom skills, merge them from .agent-backup/\n');
+    
+  } catch (error) {
+    console.error('❌ Error updating DevKit:', error.message);
+    process.exit(1);
+  }
+}
+
+function showHelp() {
+  console.log(`
+🚀 Antigravity DevKit CLI
+   Vue3 + ASP.NET + Azure Development Toolkit
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+INSTALLATION OPTIONS:
+
+  Option 1: One-time use (npx)
+  $ npx antigravity-devkit init
+
+  Option 2: Global install (recommended for frequent use)
+  $ npm install -g antigravity-devkit
+  $ antigravity-devkit init
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+COMMANDS:
+
+  init              Install DevKit to .agent/ folder
+  init --force      Overwrite existing .agent/ folder
+  update            Update DevKit (backs up existing to .agent-backup/)
+  help              Show this help message
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+EXAMPLES:
+
+  # First time setup in a project
+  cd my-project
+  antigravity-devkit init
+
+  # Reinstall/reset the kit
+  antigravity-devkit init --force
+
+  # Update to latest version
+  npm update -g antigravity-devkit
+  antigravity-devkit update
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+AFTER INSTALLATION:
+
+  The kit will be installed to .agent/ folder.
+  Start using slash commands in your AI assistant:
+
+  /plan my new feature
+  /code create a component
+  /test generate tests
+  /deploy to production
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Documentation: https://github.com/yourusername/antigravity-devkit
+`);
+}
+
+function copyDirectory(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+  
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    
+    if (entry.isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "antigravity-devkit",
+  "version": "1.0.0",
+  "description": "AI DevKit for Vue3 + ASP.NET + Azure development with specialized agents, skills, and workflows",
+  "author": "tridp.it@outlook.com",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tridentsof/antigravity-devkit"
+  },
+  "keywords": [
+    "ai",
+    "devkit",
+    "antigravity",
+    "vue3",
+    "aspnet",
+    "azure",
+    "agents",
+    "workflows",
+    "cursor",
+    "gemini"
+  ],
+  "bin": {
+    "antigravity-devkit": "./bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "template/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "echo '\n✨ Run \"npx antigravity-devkit init\" to set up the kit in your project\n'"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}