antigravity-ai-kit 3.0.0 → 3.0.1

package/.agent/commands/help.md

@@ -1,31 +1,252 @@
----
-description: Get help on available commands
----
-
-# /help Command
-
-Show available commands and usage.
-
-## Usage
-
-```
-/help                  # List all commands
-/help <command>        # Detail on specific command
-```
-
-## Examples
-
-```
-/help
-/help plan
-/help verify
-```
-
-## Categories
-
-- **Core**: /plan, /implement, /verify, /status
-- **Development**: /build, /fix, /debug, /refactor
-- **Documentation**: /doc, /adr, /changelog
-- **Git**: /git, /pr, /checkpoint
-- **Quality**: /code-review, /tdd, /security-scan
-- **Workflow**: /cook, /scout, /research
+---
+description: Comprehensive reference for all Antigravity AI Kit capabilities
+---
+
+# /help Command
+
+Your complete guide to the Antigravity AI Kit. Type `/help` for a quick overview, or drill down into specific categories.
+
+## Usage
+
+```
+/help                  # Quick overview of all capabilities
+/help commands         # All 31 slash commands with descriptions
+/help workflows        # All 14 workflows with descriptions
+/help agents           # All 19 AI agents with domains
+/help skills           # All 31 skill modules
+/help rules            # Governance rules
+/help checklists       # Quality gate checklists
+/help cli              # Terminal CLI commands (ag-kit)
+/help <command-name>   # Detail on a specific command (e.g., /help plan)
+```
+
+---
+
+## Quick Overview
+
+**Antigravity AI Kit v3.0.0** — Trust-Grade AI Development Framework
+
+| Category | Count | Description |
+|:---------|:------|:------------|
+| ⌨️ Commands | 31 | Slash commands for every development task |
+| 🔄 Workflows | 14 | Multi-step development lifecycles |
+| 🤖 Agents | 19 | Specialized AI roles for delegation |
+| 🛠️ Skills | 31 | Domain knowledge modules |
+| ⚖️ Rules | 4 | Immutable governance constraints |
+| ✅ Checklists | 3 | Quality gate checklists |
+| ⚙️ Runtime | 21 | Engine modules (governance, reputation, self-healing) |
+
+### Getting Started
+
+```
+/status           → Check your session and project health
+/plan             → Create an implementation plan
+/create           → Build a new feature from scratch
+/review           → Run quality gates before committing
+```
+
+### Recommended Workflow
+
+```
+/brainstorm  →  /plan  →  /create  →  /test  →  /review  →  /deploy
+```
+
+---
+
+## Commands (31)
+
+### Core Workflow
+
+| Command | Description |
+|:--------|:------------|
+| `/plan` | Create structured implementation plan with task breakdown |
+| `/implement` | Execute an approved plan step by step |
+| `/verify` | Run all quality gates (lint, types, tests, security, build) |
+| `/status` | Check project health, session state, and capabilities |
+
+### Feature Development
+
+| Command | Description |
+|:--------|:------------|
+| `/build` | Build a new feature from scratch |
+| `/fix` | Fix linting, type, or build errors |
+| `/debug` | Systematic debugging with hypothesis tracking |
+| `/refactor` | Improve code quality without changing behavior |
+| `/cook` | Full scratch-to-done workflow (plan → build → test → review) |
+| `/design` | UI/UX design specifications and mockups |
+
+### Testing & Quality
+
+| Command | Description |
+|:--------|:------------|
+| `/tdd` | Test-driven development — write tests first, then implement |
+| `/code-review` | Comprehensive code review with security analysis |
+| `/security-scan` | Security audit and vulnerability scan |
+| `/perf` | Performance analysis and optimization |
+| `/eval` | Evaluate metrics and measure quality |
+
+### Documentation & Git
+
+| Command | Description |
+|:--------|:------------|
+| `/doc` | Generate or update documentation |
+| `/adr` | Create Architecture Decision Record |
+| `/changelog` | Generate changelog from commits |
+| `/git` | Git operations with best practices |
+| `/pr` | Create or manage pull requests |
+| `/checkpoint` | Save progress checkpoint for session continuity |
+
+### Exploration & Research
+
+| Command | Description |
+|:--------|:------------|
+| `/scout` | Explore and understand an unfamiliar codebase |
+| `/research` | Research technologies, libraries, or solutions |
+| `/ask` | Ask questions about code, architecture, or patterns |
+
+### Infrastructure & Integration
+
+| Command | Description |
+|:--------|:------------|
+| `/integrate` | Third-party service integration |
+| `/db` | Database schema design and migrations |
+| `/deploy` | Deploy to target environment with pre-flight checks |
+| `/setup` | Configure a new project with Antigravity AI Kit |
+
+### Context Management
+
+| Command | Description |
+|:--------|:------------|
+| `/learn` | Extract reusable patterns from current session (PAAL cycle) |
+| `/compact` | Compress context window for long sessions |
+| `/help` | This reference — show available capabilities |
+
+---
+
+## Workflows (14)
+
+Workflows are multi-step development lifecycles. Use them with the `/` prefix.
+
+| Workflow | Description | Key Steps |
+|:---------|:------------|:----------|
+| `/brainstorm` | Structured ideation and discovery | Socratic questioning → options → decision |
+| `/create` | Build new features from scratch | Scaffold → implement → test → review |
+| `/debug` | Systematic debugging | Reproduce → hypothesize → verify → fix |
+| `/deploy` | Production deployment | Pre-flight → execute → verify → monitor |
+| `/enhance` | Iterative feature improvement | Analyze → plan → implement → validate |
+| `/orchestrate` | Multi-agent task coordination | Decompose → delegate → merge → verify |
+| `/plan` | Implementation planning | Research → design → breakdown → verify |
+| `/preview` | Local dev server management | Start → verify → iterate → stop |
+| `/quality-gate` | Pre-task validation protocol | Market research → gap analysis → ethics review |
+| `/retrospective` | Sprint audit and review | Metrics → findings → action items |
+| `/review` | Quality gate pipeline | Lint → types → tests → security → build |
+| `/status` | Project state overview | Session → git → health → capabilities |
+| `/test` | Systematic test writing | Strategy → write → run → coverage |
+| `/ui-ux-pro-max` | Premium UI/UX design | Style → palette → typography → implement |
+
+---
+
+## Agents (19)
+
+Agents are specialized AI roles. They are automatically activated based on task context, or you can request a specific agent.
+
+| Agent | Domain |
+|:------|:-------|
+| `architect` | System design, DDD, Hexagonal Architecture |
+| `backend-specialist` | Node.js, NestJS, API design |
+| `build-error-resolver` | Rapid build/compile error fixes |
+| `code-reviewer` | Quality + security code review |
+| `database-architect` | Schema design, queries, optimization |
+| `devops-engineer` | CI/CD, Docker, deployment pipelines |
+| `doc-updater` | Documentation synchronization |
+| `e2e-runner` | End-to-end test execution |
+| `explorer-agent` | Codebase discovery and mapping |
+| `frontend-specialist` | React, Next.js, UI architecture |
+| `knowledge-agent` | RAG retrieval and context lookup |
+| `mobile-developer` | React Native, Expo mobile development |
+| `performance-optimizer` | Core Web Vitals, profiling, optimization |
+| `planner` | Task breakdown, Socratic analysis |
+| `refactor-cleaner` | Dead code cleanup, code improvement |
+| `reliability-engineer` | SRE, production readiness, SLA monitoring |
+| `security-reviewer` | Vulnerability analysis, OWASP compliance |
+| `sprint-orchestrator` | Sprint planning, velocity tracking |
+| `tdd-guide` | Test-first development enforcement |
+
+---
+
+## Skills (31)
+
+Skills are domain knowledge modules that agents use. They are loaded automatically based on task context.
+
+| Category | Skills |
+|:---------|:-------|
+| **Architecture** | `architecture`, `api-patterns`, `clean-code`, `database-design`, `docker-patterns` |
+| **Frontend** | `frontend-patterns`, `ui-ux-pro-max`, `mobile-design`, `i18n-localization` |
+| **Backend** | `nodejs-patterns`, `typescript-expert`, `security-practices` |
+| **Testing** | `testing-patterns`, `webapp-testing`, `eval-harness` |
+| **DevOps** | `deployment-procedures`, `git-workflow`, `shell-conventions` |
+| **AI & Orchestration** | `intelligent-routing`, `parallel-agents`, `mcp-integration`, `context-budget`, `behavioral-modes` |
+| **Planning** | `brainstorming`, `plan-writing`, `strategic-compact`, `continuous-learning` |
+| **Performance** | `performance-profiling` |
+| **Scaffolding** | `app-builder` |
+| **Debugging** | `debugging-strategies` |
+| **Verification** | `verification-loop` |
+
+---
+
+## Rules (4)
+
+Rules are immutable governance constraints that all agents must follow.
+
+| Rule | Purpose |
+|:-----|:--------|
+| `coding-style` | Naming conventions, file limits, type safety |
+| `git-workflow` | Conventional commits, atomic changes, branch strategy |
+| `security` | Secret management, input validation, OWASP |
+| `testing` | Test-first, coverage targets, test naming |
+
+---
+
+## Checklists (3)
+
+Checklists are quality gates run at specific lifecycle moments.
+
+| Checklist | When | Key Checks |
+|:----------|:-----|:-----------|
+| `session-start` | Beginning of each session | Read context, verify git, check dependencies |
+| `session-end` | End of each session | Update ROADMAP, CHANGELOG, commit tracking files |
+| `pre-commit` | Before git commit | Tests pass, lint clean, no secrets, build succeeds |
+
+---
+
+## CLI Commands (ag-kit)
+
+Terminal commands available after installing the kit:
+
+| Command | Description |
+|:--------|:------------|
+| `ag-kit init` | Install .agent/ into your project |
+| `ag-kit status` | Show project health dashboard |
+| `ag-kit verify` | Run manifest integrity checks (90 checks) |
+| `ag-kit scan` | Enhanced security scanning |
+| `ag-kit update` | Update to latest version (diff-based, preserves customizations) |
+| `ag-kit heal` | Detect and diagnose CI failures |
+| `ag-kit plugin list` | List installed plugins |
+| `ag-kit plugin install <path>` | Install a plugin |
+| `ag-kit plugin remove <name>` | Remove a plugin |
+| `ag-kit market search <query>` | Search marketplace plugins |
+| `ag-kit market info <name>` | Get marketplace plugin details |
+| `ag-kit market install <name>` | Install from marketplace |
+
+---
+
+## Quick Reference Card
+
+```
+Start here:        /status → /plan → /create → /review
+Debug issues:      /debug → /fix → /verify
+Write tests:       /tdd → /test → /verify
+Deploy:            /review → /deploy
+Learn more:        /help <topic>
+Terminal:          ag-kit verify | ag-kit scan | ag-kit status
+```

package/README.md

@@ -132,7 +132,7 @@ ag-kit scan       # Security scan
 graph TB
     subgraph "User Interface Layer"
         CMD["Slash Commands<br/>31 commands"]
-        WF["Workflows<br/>11 templates"]
+        WF["Workflows<br/>14 templates"]
     end
 
     subgraph "Intelligence Layer"
@@ -300,7 +300,7 @@ EXPLORE → PLAN → IMPLEMENT → VERIFY → REVIEW → DEPLOY
 | `/compact`    | Compress context  |
 | `/eval`       | Evaluate metrics  |
 | `/setup`      | Configure project |
-| `/help`       | Show help         |
+| `/help`       | **Comprehensive reference** — commands, workflows, agents, skills, rules, checklists |
 
 ---
 

package/bin/ag-kit.js

@@ -87,6 +87,10 @@ ${colors.bright}Examples:${colors.reset}
   ag-kit init --force
   ag-kit scan
   ag-kit plugin list
+
+${colors.bright}IDE Reference:${colors.reset}
+  Type ${colors.cyan}/help${colors.reset} in your AI-powered IDE for the full reference:
+  commands, workflows, agents, skills, rules, and checklists.
 `);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "antigravity-ai-kit",
-  "version": "3.0.0",
+  "version": "3.0.1",
   "description": "🚀 Trust-Grade AI development framework with a 21-module runtime engine — 19 Agents, 31 Skills, 31 Commands, 14 Workflows, 261 Tests. Workflow enforcement, task governance, agent reputation, self-healing, and skill marketplace.",
   "main": "bin/ag-kit.js",
   "bin": {