antigravity-ai-kit 2.1.0 → 3.0.1

package/.agent/skills/ui-ux-pro-max/scripts/search.py

@@ -0,0 +1,114 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+UI/UX Pro Max Search - BM25 search engine for UI/UX style guides
+Usage: python search.py "<query>" [--domain <domain>] [--stack <stack>] [--max-results 3]
+       python search.py "<query>" --design-system [-p "Project Name"]
+       python search.py "<query>" --design-system --persist [-p "Project Name"] [--page "dashboard"]
+
+Domains: style, prompt, color, chart, landing, product, ux, typography
+Stacks: html-tailwind, react, nextjs
+
+Persistence (Master + Overrides pattern):
+  --persist    Save design system to design-system/MASTER.md
+  --page       Also create a page-specific override file in design-system/pages/
+"""
+
+import argparse
+import sys
+import io
+from core import CSV_CONFIG, AVAILABLE_STACKS, MAX_RESULTS, search, search_stack
+from design_system import generate_design_system, persist_design_system
+
+# Force UTF-8 for stdout/stderr to handle emojis on Windows (cp1252 default)
+if sys.stdout.encoding and sys.stdout.encoding.lower() != 'utf-8':
+    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
+if sys.stderr.encoding and sys.stderr.encoding.lower() != 'utf-8':
+    sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
+
+
+def format_output(result):
+    """Format results for Claude consumption (token-optimized)"""
+    if "error" in result:
+        return f"Error: {result['error']}"
+
+    output = []
+    if result.get("stack"):
+        output.append(f"## UI Pro Max Stack Guidelines")
+        output.append(f"**Stack:** {result['stack']} | **Query:** {result['query']}")
+    else:
+        output.append(f"## UI Pro Max Search Results")
+        output.append(f"**Domain:** {result['domain']} | **Query:** {result['query']}")
+    output.append(f"**Source:** {result['file']} | **Found:** {result['count']} results\n")
+
+    for i, row in enumerate(result['results'], 1):
+        output.append(f"### Result {i}")
+        for key, value in row.items():
+            value_str = str(value)
+            if len(value_str) > 300:
+                value_str = value_str[:300] + "..."
+            output.append(f"- **{key}:** {value_str}")
+        output.append("")
+
+    return "\n".join(output)
+
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser(description="UI Pro Max Search")
+    parser.add_argument("query", help="Search query")
+    parser.add_argument("--domain", "-d", choices=list(CSV_CONFIG.keys()), help="Search domain")
+    parser.add_argument("--stack", "-s", choices=AVAILABLE_STACKS, help="Stack-specific search (html-tailwind, react, nextjs)")
+    parser.add_argument("--max-results", "-n", type=int, default=MAX_RESULTS, help="Max results (default: 3)")
+    parser.add_argument("--json", action="store_true", help="Output as JSON")
+    # Design system generation
+    parser.add_argument("--design-system", "-ds", action="store_true", help="Generate complete design system recommendation")
+    parser.add_argument("--project-name", "-p", type=str, default=None, help="Project name for design system output")
+    parser.add_argument("--format", "-f", choices=["ascii", "markdown"], default="ascii", help="Output format for design system")
+    # Persistence (Master + Overrides pattern)
+    parser.add_argument("--persist", action="store_true", help="Save design system to design-system/MASTER.md (creates hierarchical structure)")
+    parser.add_argument("--page", type=str, default=None, help="Create page-specific override file in design-system/pages/")
+    parser.add_argument("--output-dir", "-o", type=str, default=None, help="Output directory for persisted files (default: current directory)")
+
+    args = parser.parse_args()
+
+    # Design system takes priority
+    if args.design_system:
+        result = generate_design_system(
+            args.query, 
+            args.project_name, 
+            args.format,
+            persist=args.persist,
+            page=args.page,
+            output_dir=args.output_dir
+        )
+        print(result)
+        
+        # Print persistence confirmation
+        if args.persist:
+            project_slug = args.project_name.lower().replace(' ', '-') if args.project_name else "default"
+            print("\n" + "=" * 60)
+            print(f"✅ Design system persisted to design-system/{project_slug}/")
+            print(f"   📄 design-system/{project_slug}/MASTER.md (Global Source of Truth)")
+            if args.page:
+                page_filename = args.page.lower().replace(' ', '-')
+                print(f"   📄 design-system/{project_slug}/pages/{page_filename}.md (Page Overrides)")
+            print("")
+            print(f"📖 Usage: When building a page, check design-system/{project_slug}/pages/[page].md first.")
+            print(f"   If exists, its rules override MASTER.md. Otherwise, use MASTER.md.")
+            print("=" * 60)
+    # Stack search
+    elif args.stack:
+        result = search_stack(args.query, args.stack, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))
+    # Domain search
+    else:
+        result = search(args.query, args.domain, args.max_results)
+        if args.json:
+            import json
+            print(json.dumps(result, indent=2, ensure_ascii=False))
+        else:
+            print(format_output(result))

package/.agent/templates/adr-template.md

@@ -0,0 +1,32 @@
+# ADR Template
+
+Use this template for all Architecture Decision Records.
+
+## ADR-NNN: [Decision Title]
+
+### Status
+
+**[Proposed / Accepted / Deprecated / Superseded]** — [Date]
+
+### Context
+
+[What is the issue that we're seeing that is motivating this decision or change?]
+
+### Decision
+
+[What is the change that we're proposing and/or doing?]
+
+### Consequences
+
+#### Positive
+- [Benefit 1]
+- [Benefit 2]
+
+#### Negative
+- [Trade-off 1]
+- [Trade-off 2]
+
+### Alternatives Considered
+
+1. **[Alternative 1]** — [Why rejected]
+2. **[Alternative 2]** — [Why rejected]

package/.agent/templates/bug-report.md

@@ -0,0 +1,37 @@
+# Bug Report Template
+
+## Description
+
+[Clear description of the bug]
+
+## Steps to Reproduce
+
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+## Expected Behavior
+
+[What should happen]
+
+## Actual Behavior
+
+[What actually happens]
+
+## Environment
+
+- **OS**: [e.g., Windows 11, macOS 15, Ubuntu 24.04]
+- **Node.js**: [e.g., 20.x]
+- **Antigravity AI Kit version**: [e.g., 2.1.0]
+- **IDE**: [e.g., VS Code 1.95, Cursor 0.45]
+
+## Screenshots / Logs
+
+[Attach any relevant screenshots or error logs]
+
+## Severity
+
+- [ ] Critical (system unusable)
+- [ ] High (major feature broken)
+- [ ] Medium (workaround exists)
+- [ ] Low (cosmetic issue)

package/.agent/templates/feature-request.md

@@ -0,0 +1,32 @@
+# Feature Request Template
+
+## Feature Description
+
+[Clear, concise description of the desired feature]
+
+## Problem Statement
+
+[What problem does this feature solve? Why is it needed?]
+
+## Proposed Solution
+
+[High-level description of how this could be implemented]
+
+## Acceptance Criteria
+
+- [ ] [Criterion 1]
+- [ ] [Criterion 2]
+- [ ] [Criterion 3]
+
+## Technical Considerations
+
+- **Complexity**: [Low / Medium / High]
+- **Breaking Changes**: [Yes / No]
+- **Dependencies**: [List any new dependencies needed]
+
+## Priority
+
+- [ ] Critical (blocks production)
+- [ ] High (needed this sprint)
+- [ ] Medium (next sprint)
+- [ ] Low (backlog)

package/.agent/workflows/README.md

@@ -1,78 +1,92 @@
-# Antigravity AI Kit — Workflows
-
-> **Purpose**: Process templates for common development tasks
-> **Count**: 11 Workflows
-
----
-
-## Overview
-
-Workflows are structured process templates that guide you through complex tasks. Invoke them using slash commands.
-
----
-
-## Available Workflows
-
-| Workflow          | Command          | Description                                   |
-| :---------------- | :--------------- | :-------------------------------------------- |
-| **brainstorm**    | `/brainstorm`    | Creative ideation and problem exploration     |
-| **create**        | `/create`        | Scaffold new features, components, or modules |
-| **debug**         | `/debug`         | Systematic debugging process                  |
-| **deploy**        | `/deploy`        | Deployment workflow with verification         |
-| **enhance**       | `/enhance`       | Improve existing code quality                 |
-| **orchestrate**   | `/orchestrate`   | Multi-agent coordination                      |
-| **plan**          | `/plan`          | Create implementation plans                   |
-| **preview**       | `/preview`       | Preview changes before committing             |
-| **status**        | `/status`        | Check project status                          |
-| **test**          | `/test`          | Systematic test writing                       |
-| **ui-ux-pro-max** | `/ui-ux-pro-max` | Premium UI/UX design                          |
-
----
-
-## Workflow Format
-
-```markdown
----
-description: What this workflow does
----
-
-# /workflow-name Workflow
-
-> **Purpose**: Brief description
-
----
-
-## Workflow Steps
-
-### 1. Step Name
-
-Description and actions...
-
-### 2. Step Name
-
-Description and actions...
-
----
-
-## Checklist
-
-- [ ] Task 1
-- [ ] Task 2
-
----
-
-## Examples
-
-\`\`\`
-/workflow-name example usage
-\`\`\`
-```
-
----
-
-## Creating Custom Workflows
-
-1. Create `workflows/my-workflow.md`
-2. Add frontmatter with `description`
-3. Define workflow steps
-4. Include checklist and examples
+# Antigravity AI Kit — Workflows
+
+> **Purpose**: Process templates for common development tasks
+> **Count**: 14 Workflows
+> **Standard**: Enterprise Workflow Standard (EWS) v1.0
+
+---
+
+## Overview
+
+Workflows are structured process templates that guide you through complex tasks. Each workflow follows the EWS v1.0 standard with 11 mandatory sections including trigger/lifecycle definition, critical rules, argument parsing, governance alerts, and completion criteria.
+
+Invoke them using slash commands (e.g., `/brainstorm authentication system`).
+
+---
+
+## Available Workflows
+
+| Workflow | Command | Lifecycle | Description |
+| :---------------- | :--------------- | :------------ | :----------------------------------------------- |
+| **brainstorm** | `/brainstorm` | Discover | Creative ideation and option exploration |
+| **quality-gate** | `/quality-gate` | Discover | Pre-task market research, gap analysis, ethics |
+| **plan** | `/plan` | Plan | Structured implementation planning |
+| **create** | `/create` | Build | Scaffold new features, components, or modules |
+| **enhance** | `/enhance` | Build | Iterative feature development on existing code |
+| **preview** | `/preview` | Build | Local development server management |
+| **ui-ux-pro-max** | `/ui-ux-pro-max` | Build | Premium UI/UX design and implementation |
+| **test** | `/test` | Verify | Systematic test writing and execution |
+| **review** | `/review` | Verify | Sequential quality gate pipeline |
+| **deploy** | `/deploy` | Ship | Production deployment with pre-flight checks |
+| **debug** | `/debug` | Reactive | Systematic problem investigation |
+| **orchestrate** | `/orchestrate` | Reactive | Multi-agent coordination for complex tasks |
+| **retrospective** | `/retrospective` | Evaluate | Tier-1 quality audit against market standards |
+| **status** | `/status` | Cross-cutting | Project status overview and health check |
+
+---
+
+## SDLC Lifecycle Map
+
+```
+Discover ──► Plan ──► Build ──► Verify ──► Ship ──► Evaluate
+   │           │        │         │         │          │
+   ▼           ▼        ▼         ▼         ▼          ▼
+/brainstorm  /plan   /create   /test     /deploy   /retrospective
+/quality-gate        /enhance  /review
+                     /preview
+                     /ui-ux-pro-max
+
+    Reactive (any phase)          Cross-cutting (any phase)
+    ────────────────────          ────────────────────────
+    /debug                        /status
+    /orchestrate
+```
+
+---
+
+## EWS v1.0 Standard
+
+Every workflow conforms to the Enterprise Workflow Standard v1.0 with these sections:
+
+| # | Section | Purpose |
+| :- | :------------------- | :----------------------------------------------- |
+| 1 | Frontmatter | `description` and `version` fields |
+| 2 | Trigger / Lifecycle | When and where in SDLC this workflow runs |
+| 3 | Governance Alert | Risk-appropriate alert (NOTE/IMPORTANT/CAUTION) |
+| 4 | Critical Rules | Non-negotiable behavioral constraints |
+| 5 | Argument Parsing | Sub-commands and argument table |
+| 6 | Steps | Ordered steps with `// turbo` annotations |
+| 7 | Output Template | Structured output format |
+| 8 | Governance Footer | PROHIBITED / REQUIRED behavioral contracts |
+| 9 | Completion Criteria | Checklist of done criteria |
+| 10 | Related Resources | Links to skills, agents, and related workflows |
+| 11 | Scope Filter | When applicable: commit-type filtering table |
+
+---
+
+## Turbo Annotation Policy
+
+Steps annotated with `// turbo` can be auto-executed without user confirmation:
+
+- **Allowed**: Read-only steps (analysis, detection, research, diagnostics)
+- **Prohibited**: State-mutating steps (server start, deployment, code generation)
+
+---
+
+## Creating Custom Workflows
+
+1. Create `workflows/my-workflow.md`
+2. Add frontmatter with `description` and `version` fields
+3. Follow the EWS v1.0 template (11 sections)
+4. Map to an SDLC lifecycle phase
+5. Link to relevant skills and agents in Related Resources

package/.agent/workflows/brainstorm.md

@@ -1,100 +1,154 @@
----
-description: Structured brainstorming. Explore options before committing to implementation.
----
-
-# /brainstorm - Structured Idea Exploration
-
-$ARGUMENTS
-
----
-
-## Purpose
-
-Activates BRAINSTORM mode for exploring options before implementation. No code — ideas only.
-
----
-
-## Behavior
-
-1. **Understand the Goal**
-   - What problem are we solving?
-   - Who is the user?
-   - What constraints exist?
-
-2. **Generate Options**
-   - Provide at least 3 approaches
-   - Each with pros and cons
-   - Consider unconventional solutions
-
-3. **Compare and Recommend**
-   - Summarize tradeoffs
-   - Give recommendation with reasoning
-
----
-
-## Output Format
-
-```markdown
-## 🧠 Brainstorm: [Topic]
-
-### Context
-
-[Brief problem statement]
-
----
-
-### Option A: [Name]
-
-[Description]
-
-✅ **Pros:**
-
-- [benefit 1]
-- [benefit 2]
-
-❌ **Cons:**
-
-- [drawback 1]
-
-📊 **Effort:** Low | Medium | High
-
----
-
-### Option B: [Name]
-
-[Similar format]
-
----
-
-### Option C: [Name]
-
-[Similar format]
-
----
-
-## 💡 Recommendation
-
-**Option [X]** because [reasoning].
-
-What direction would you like to explore?
-```
-
----
-
-## Examples
-
-```
-/brainstorm authentication system
-/brainstorm state management for complex form
-/brainstorm database schema for social app
-/brainstorm caching strategy
-```
-
----
-
-## Key Principles
-
-- **No code** — ideas only
-- **Visual when helpful** — use diagrams for architecture
-- **Honest tradeoffs** — don't hide complexity
-- **Defer to user** — present options, let them decide
+---
+description: Structured brainstorming. Explore options before committing to implementation.
+version: 2.1.0
+sdlc-phase: discover
+skills: [brainstorming]
+commit-types: [docs]
+---
+
+# /brainstorm — Structured Idea Exploration
+
+> **Trigger**: `/brainstorm [topic]`
+> **Lifecycle**: Discover — before `/quality-gate` or `/plan`
+
+> [!NOTE]
+> This is an exploratory workflow. It produces ideas, not code. All options should be evidence-based.
+
+> [!TIP]
+> This workflow leverages the **brainstorming** skill. Read `.agent/skills/brainstorming/SKILL.md` for extended guidance.
+
+---
+
+## Critical Rules
+
+1. **No code** — produce ideas, diagrams, and analysis only
+2. **Minimum 3 options** — always present at least 3 approaches
+3. **Evidence-based** — support recommendations with reasoning, tradeoffs, and data
+4. **Socratic exploration** — ask clarifying questions before generating options
+5. **Honest tradeoffs** — never hide complexity or risk to make an option look better
+6. **Defer to user** — present options and recommend, but the user decides
+
+---
+
+## Argument Parsing
+
+| Command | Action |
+| :---------------------- | :----------------------------------------------- |
+| `/brainstorm` | Prompt for topic, then run full exploration |
+| `/brainstorm [topic]` | Explore the specified topic directly |
+
+---
+
+## Steps
+
+// turbo
+1. **Gather Context**
+   - What problem are we solving?
+   - Who is the target user?
+   - What constraints exist (time, budget, tech stack)?
+   - What has already been tried or ruled out?
+
+// turbo
+2. **Research & Analyze**
+   - Survey existing patterns and solutions in the codebase
+   - Identify industry best practices for the problem domain
+   - Note relevant constraints from the project architecture
+
+3. **Generate Options**
+   - Provide at least 3 distinct approaches
+   - Each with pros, cons, effort estimate, and risk level
+   - Consider unconventional or hybrid solutions
+
+4. **Compare & Recommend**
+   - Summarize tradeoffs in a comparison table
+   - Give a clear recommendation with reasoning
+   - Ask the user which direction to explore further
+
+---
+
+## Output Template
+
+```markdown
+## 🧠 Brainstorm: [Topic]
+
+### Context
+
+[Brief problem statement and constraints]
+
+---
+
+### Option A: [Name]
+
+[Description]
+
+✅ **Pros:** [benefits]
+❌ **Cons:** [drawbacks]
+📊 **Effort:** Low | Medium | High
+⚠️ **Risk:** Low | Medium | High
+
+---
+
+### Option B: [Name]
+
+[Similar format]
+
+---
+
+### Option C: [Name]
+
+[Similar format]
+
+---
+
+### Comparison Matrix
+
+| Criteria     | Option A | Option B | Option C |
+| :----------- | :------- | :------- | :------- |
+| Effort       |          |          |          |
+| Risk         |          |          |          |
+| Scalability  |          |          |          |
+| Maintainability |       |          |          |
+
+---
+
+## 💡 Recommendation
+
+**Option [X]** because [reasoning].
+
+After selection: proceed to `/quality-gate` for validation or `/plan` for implementation planning.
+```
+
+---
+
+## Governance
+
+**PROHIBITED:**
+- Writing implementation code during brainstorming
+- Presenting fewer than 3 options
+- Hiding complexity or risk to bias the recommendation
+- Skipping failed steps · proceeding without resolution
+
+**REQUIRED:**
+- Clarifying questions before generating options
+- Evidence-based reasoning for all recommendations
+- Comparison matrix for structured decision-making
+- User confirmation before proceeding to next workflow
+
+---
+
+## Completion Criteria
+
+- [ ] Problem statement and constraints are clearly documented
+- [ ] At least 3 distinct options are presented with pros/cons
+- [ ] Comparison matrix is included
+- [ ] Recommendation is given with reasoning
+- [ ] User has selected a direction
+- [ ] After selection: proceed to `/quality-gate` for validation or `/plan` for planning
+
+---
+
+## Related Resources
+
+- **Next**: `/quality-gate` (validate selected approach) · `/plan` (create implementation plan)
+- **Skill**: `.agent/skills/brainstorming/SKILL.md`
+- **Mode**: Activates BRAINSTORM behavioral mode (see `.agent/skills/behavioral-modes/SKILL.md`)