antigravity-devkit 1.0.3 → 1.0.4

package/README.md

@@ -69,32 +69,46 @@ After installation, start using slash commands:
 
 ## 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
-```
+![Antigravity DevKit Workflow](./docs/workflow-diagram.png)
+
+### The Complete Flow
+
+**1. User Request** → Everything starts with your request to the AI assistant.
+
+**2. Classification Layer** (`rules/GEMINI.md`)
+   - **Always Active** - This runs before every response
+   - Analyzes your request to determine the type (question, code, design, etc.)
+   - Routes to the most appropriate specialist agent
+   - Enforces global coding standards and best practices
+
+**3. Agent Selection Layer** (`agents/*.md`)
+   - The right specialist is automatically selected based on your request
+   - Available specialists: Frontend, Backend, Database, DevOps, Test Engineer, and more
+   - Each agent brings domain-specific expertise
+   - Agents load their required skills for the task
+
+**4. Skills Loading Layer** (`skills/*/SKILL.md`)
+   - Agents load relevant knowledge modules
+   - Skills include: clean-code, vue3-patterns, aspnet-patterns, azure-devops, testing-patterns, architecture, and more
+   - Each skill provides patterns, templates, and best practices
+   - Skills can reference additional documentation and examples
+
+**5. Output Generation**
+   - AI generates specialized responses using the loaded knowledge
+   - Output types: Code files, Documentation, Tests, Configuration, etc.
+   - All outputs follow the patterns and standards from the loaded skills
+
+### Supporting Components
+
+**Optional Workflows** (Right Panel)
+- Slash commands like `/plan`, `/create`, `/code`, `/test`, `/deploy`
+- These trigger pre-defined multi-step procedures
+- Can be used to streamline common development tasks
+
+**Validation Scripts** (Left Panel)
+- `checklist.py` - Quick validation during development
+- `verify_all.py` - Comprehensive checks before deployment
+- Automatically run after certain operations or manually triggered
 
 ---
 
@@ -304,6 +318,119 @@ python .agent/scripts/verify_all.py . --url http://localhost:3000
 
 ---
 
+## Project Lifecycle
+
+![Project Lifecycle with Antigravity DevKit](./docs/project-lifecycle-diagram.png)
+
+### Understanding the Development Phases
+
+The antigravity-dev-kit supports your entire development lifecycle with specialized workflows for each phase:
+
+#### **Phase 1: Discovery & Planning** 🔍
+**Workflows:** `/brainstorm`, `/plan`
+
+Start here when you have a new feature idea or requirement. The kit helps you:
+- Clarify vague requirements through strategic questions
+- Create detailed task breakdowns
+- Generate a `PLAN-*.md` file for structured implementation
+
+**When to use:**
+- New feature requests
+- Complex requirements that need clarification
+- Architecture decisions
+
+---
+
+#### **Phase 2: Development** 💻
+**Workflows:** `/create` (full feature), `/code` (single task)
+
+Build your features with specialized agents:
+- **Frontend Specialist** - Vue3 components and UI
+- **Backend Specialist** - ASP.NET APIs and services
+- **Database Architect** - SQL schema and queries
+
+**Key features:**
+- Checkpoints for human approval
+- Follows your plan file
+- Multi-agent coordination for complex features
+
+---
+
+#### **Phase 3: Testing** 🧪
+**Workflows:** `/test`  
+**Scripts:** `checklist.py`
+
+Generate comprehensive tests:
+- Unit tests (xUnit for backend, Vitest for frontend)
+- Integration tests
+- Test coverage reports
+
+**Automated checks:**
+- Linting and type checking
+- Code quality validation
+- Test execution
+
+---
+
+#### **Phase 4: Code Review** 🔎
+**Workflows:** `/review`  
+**Agent:** Security Auditor
+
+Get automated code reviews covering:
+- Security vulnerabilities
+- Code quality issues
+- Best practice violations
+- Performance concerns
+
+**Output:** Detailed review report with actionable recommendations
+
+---
+
+#### **Phase 5: Deployment** 🚀
+**Workflows:** `/deploy`  
+**Scripts:** `verify_all.py`
+
+Deploy with confidence:
+- Comprehensive pre-deployment validation
+- Azure DevOps pipeline trigger
+- Deployment verification
+
+**Checks before deploy:**
+- All tests passing
+- No security vulnerabilities
+- Build successful
+- Dependencies up to date
+
+---
+
+#### **Phase 6: Maintenance** 🔧
+**Workflows:** `/debug`, `/status`  
+**Agents:** Debugger, Performance Optimizer
+
+Keep your application healthy:
+- Root cause analysis for bugs
+- Performance optimization
+- System health monitoring
+- Quick fixes and patches
+
+**Continuous improvement:**
+- Monitor application metrics
+- Optimize slow queries
+- Fix production issues
+- Iterate back to Phase 1 for new features
+
+---
+
+### Quick Reference: Common Scenarios
+
+| Scenario | Workflow Path | Duration |
+|----------|--------------|----------|
+| **New Feature** | `/brainstorm` → `/plan` → `/create` → `/test` → `/review` → `/deploy` | Full cycle |
+| **Bug Fix** | `/debug` → `/test` → `/review` → `/deploy` | Fast track |
+| **Quick Task** | `/code` → Done | Immediate |
+
+---
+
 ## Typical Workflows
 
 ### Building a New Feature

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-devkit",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "AI DevKit for Vue3 + ASP.NET + Azure development with specialized agents, skills, and workflows",
   "author": "tridp.it@outlook.com",
   "license": "MIT",

package/template/ARCHITECTURE.md

@@ -1,148 +0,0 @@
-# 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 |