flyee 0.1.0

package/core/skills/webapp-testing/scripts/playwright_runner.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""
+Skill: webapp-testing
+Script: playwright_runner.py
+Purpose: Run basic Playwright browser tests
+Usage: python playwright_runner.py <url> [--screenshot]
+Output: JSON with page info, health status, and optional screenshot path
+Note: Requires playwright (pip install playwright && playwright install chromium)
+Screenshots: Saved to system temp directory (auto-cleaned by OS)
+"""
+import sys
+import json
+import os
+import tempfile
+from datetime import datetime
+
+# Fix Windows console encoding for Unicode output
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except AttributeError:
+    pass  # Python < 3.7
+
+try:
+    from playwright.sync_api import sync_playwright
+    PLAYWRIGHT_AVAILABLE = True
+except ImportError:
+    PLAYWRIGHT_AVAILABLE = False
+
+
+def run_basic_test(url: str, take_screenshot: bool = False) -> dict:
+    """Run basic browser test on URL."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {
+            "error": "Playwright not installed",
+            "fix": "pip install playwright && playwright install chromium"
+        }
+    
+    result = {
+        "url": url,
+        "timestamp": datetime.now().isoformat(),
+        "status": "pending"
+    }
+    
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            context = browser.new_context(
+                viewport={"width": 1280, "height": 720},
+                user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+            )
+            page = context.new_page()
+            
+            # Navigate
+            response = page.goto(url, wait_until="networkidle", timeout=30000)
+            
+            # Basic info
+            result["page"] = {
+                "title": page.title(),
+                "url": page.url,
+                "status_code": response.status if response else None
+            }
+            
+            # Health checks
+            result["health"] = {
+                "loaded": response.ok if response else False,
+                "has_title": bool(page.title()),
+                "has_h1": page.locator("h1").count() > 0,
+                "has_links": page.locator("a").count() > 0,
+                "has_images": page.locator("img").count() > 0
+            }
+            
+            # Console errors
+            console_errors = []
+            page.on("console", lambda msg: console_errors.append(msg.text) if msg.type == "error" else None)
+            
+            # Performance metrics
+            result["performance"] = {
+                "dom_content_loaded": page.evaluate("window.performance.timing.domContentLoadedEventEnd - window.performance.timing.navigationStart"),
+                "load_complete": page.evaluate("window.performance.timing.loadEventEnd - window.performance.timing.navigationStart")
+            }
+            
+            # Screenshot - uses system temp directory (cross-platform, auto-cleaned)
+            if take_screenshot:
+                # Cross-platform: Windows=%TEMP%, Linux/macOS=/tmp
+                screenshot_dir = os.path.join(tempfile.gettempdir(), "maestro_screenshots")
+                os.makedirs(screenshot_dir, exist_ok=True)
+                screenshot_path = os.path.join(screenshot_dir, f"screenshot_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png")
+                page.screenshot(path=screenshot_path, full_page=True)
+                result["screenshot"] = screenshot_path
+                result["screenshot_note"] = "Saved to temp directory (auto-cleaned by OS)"
+            
+            # Element counts
+            result["elements"] = {
+                "links": page.locator("a").count(),
+                "buttons": page.locator("button").count(),
+                "inputs": page.locator("input").count(),
+                "images": page.locator("img").count(),
+                "forms": page.locator("form").count()
+            }
+            
+            browser.close()
+            
+            result["status"] = "success" if result["health"]["loaded"] else "failed"
+            result["summary"] = "[OK] Page loaded successfully" if result["status"] == "success" else "[X] Page failed to load"
+            
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+        result["summary"] = f"[X] Error: {str(e)[:100]}"
+    
+    return result
+
+
+def run_accessibility_check(url: str) -> dict:
+    """Run basic accessibility check."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {"error": "Playwright not installed"}
+    
+    result = {"url": url, "accessibility": {}}
+    
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            page = browser.new_page()
+            page.goto(url, wait_until="networkidle", timeout=30000)
+            
+            # Basic a11y checks
+            result["accessibility"] = {
+                "images_with_alt": page.locator("img[alt]").count(),
+                "images_without_alt": page.locator("img:not([alt])").count(),
+                "buttons_with_label": page.locator("button[aria-label], button:has-text('')").count(),
+                "links_with_text": page.locator("a:has-text('')").count(),
+                "form_labels": page.locator("label").count(),
+                "headings": {
+                    "h1": page.locator("h1").count(),
+                    "h2": page.locator("h2").count(),
+                    "h3": page.locator("h3").count()
+                }
+            }
+            
+            browser.close()
+            result["status"] = "success"
+            
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+    
+    return result
+
+
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print(json.dumps({
+            "error": "Usage: python playwright_runner.py <url> [--screenshot] [--a11y]",
+            "examples": [
+                "python playwright_runner.py https://example.com",
+                "python playwright_runner.py https://example.com --screenshot",
+                "python playwright_runner.py https://example.com --a11y"
+            ]
+        }, indent=2))
+        sys.exit(1)
+    
+    url = sys.argv[1]
+    take_screenshot = "--screenshot" in sys.argv
+    check_a11y = "--a11y" in sys.argv
+    
+    if check_a11y:
+        result = run_accessibility_check(url)
+    else:
+        result = run_basic_test(url, take_screenshot)
+    
+    print(json.dumps(result, indent=2))

package/core/templates/ARCHITECTURE.template.md

@@ -0,0 +1,407 @@
+# Antigravity Kit Architecture
+
+> Comprehensive AI Agent Capability Expansion Toolkit
+
+---
+
+## 📋 Overview
+
+Antigravity Kit is a modular system consisting of:
+
+- **21 Specialist Agents** - Role-based AI personas
+- **42 Skills** - Domain-specific knowledge modules
+- **40+ Workflows** - Slash command procedures
+- **9 Templates** - PRD, SDD, ADR, README, .env, SECURITY, Design System, docs-index, OpenAPI
+
+---
+
+## 🏗️ Directory Structure
+
+```plaintext
+.agent/                      # Kit (cloned from shared repo) - IMMUTABLE
+├── ARCHITECTURE.md          
+├── agents/
+│   └── *.md                 # Global agents (shared)
+├── skills/
+│   └── */                   # Global skills (shared)
+├── workflows/
+│   └── *.md                 # Global workflows (shared)
+├── templates/               
+├── rules/                   
+└── scripts/                 
+```
+
+## 📁 Project-Specific Customizations
+
+The `.agent/` directory is **IMMUTABLE** and should not be modified by projects.
+
+For project-specific customizations, use the `docs/` directory in the project root:
+
+| Location | Use Case | Example |
+|----------|----------|---------|
+| `docs/flows/` | Process documentation | `cadastro-produtos.md` |
+| `docs/architecture/` | Architecture decisions | `auth-system.md` |
+| `docs/INDEX.md` | Central documentation catalog | - |
+
+> **ℹ️ Note:** Use the `/document` workflow to create project-specific documentation.
+
+### Documentation Discovery
+
+The `/new-task` and `/document` workflows automatically:
+1. Check `docs/INDEX.md` for existing documentation
+2. Load context from `docs/flows/` for the affected module
+3. Prompt to create documentation if missing
+4. **Backlog Support:** Use `/new-task --backlog` to only register the task without immediate implementation.
+
+## Agent Loading Priority
+
+1. **`docs/`** (Project Documentation) - Context for implementation
+2. **Global** (Kit) - Agent behavior and skills
+
+
+---
+
+## 🤖 Agents (21)
+
+Specialist AI personas for different domains.
+
+| Agent | Focus | Skills Used |
+| ----- | ----- | ----------- |
+| `orchestrator` | Multi-agent coordination | parallel-agents, behavioral-modes |
+| `project-planner` | Discovery, task planning | brainstorming, plan-writing, architecture |
+| `frontend-specialist` | Web UI/UX | frontend-design, nextjs-react-expert, tailwind-patterns |
+| `backend-specialist` | API, business logic | api-patterns, nodejs-best-practices, database-design |
+| `database-architect` | Schema, SQL | database-design, prisma-expert |
+| `mobile-developer` | iOS, Android, RN | mobile-design |
+| `game-developer` | Game logic, mechanics | game-development |
+| `devops-engineer` | CI/CD, Docker | deployment-procedures, docker-expert |
+| `security-auditor` | Security compliance | vulnerability-scanner, red-team-tactics |
+| `penetration-tester` | Offensive security | red-team-tactics |
+| `test-engineer` | Testing strategies | testing-patterns, tdd-workflow, webapp-testing |
+| `debugger` | Root cause analysis | systematic-debugging |
+| `performance-optimizer` | Speed, Web Vitals | performance-profiling |
+| `seo-specialist` | Ranking, visibility | seo-fundamentals, geo-fundamentals |
+| `documentation-writer` | Manuals, docs | documentation-templates |
+| `product-manager` | Requirements, user stories | plan-writing, brainstorming |
+| `product-owner` | Strategy, backlog, MVP | plan-writing, brainstorming |
+| `qa-automation-engineer` | E2E testing, CI pipelines | webapp-testing, testing-patterns |
+| `code-archaeologist` | Legacy code, refactoring | clean-code, code-review-checklist |
+| `explorer-agent` | Codebase analysis | - |
+| `tdd-reviewer` | SDD review, validation | tdd-validation, brainstorming, architecture |
+
+---
+
+## 🧩 Skills (42)
+
+Modular knowledge domains that agents can load on-demand. based on task context.
+
+### Frontend & UI
+
+| Skill | Description |
+| ----- | ----------- |
+| `nextjs-react-expert` | React & Next.js performance optimization (Vercel - 57 rules) |
+| `web-design-guidelines` | Web UI audit - 100+ rules for accessibility, UX, performance (Vercel) |
+| `tailwind-patterns` | Tailwind CSS v4 utilities |
+| `frontend-design` | UI/UX patterns, design systems |
+| `ui-ux-pro-max` | 50 styles, 21 palettes, 50 fonts |
+| `atomic-design` | Stack-agnostic Atomic Design component generation (Atoms, Molecules, Organisms) |
+
+### Backend & API
+
+| Skill | Description |
+| ----- | ----------- |
+| `api-patterns` | REST, GraphQL, tRPC |
+| `nestjs-expert` | NestJS modules, DI, decorators |
+| `nodejs-best-practices` | Node.js async, modules |
+| `python-patterns` | Python standards, FastAPI |
+
+### Database
+
+| Skill | Description |
+| ----- | ----------- |
+| `database-design` | Schema design, optimization |
+| `prisma-expert` | Prisma ORM, migrations |
+
+### TypeScript/JavaScript
+
+| Skill | Description |
+| ----- | ----------- |
+| `typescript-expert` | Type-level programming, performance |
+
+### Cloud & Infrastructure
+
+| Skill | Description |
+| ----- | ----------- |
+| `docker-expert` | Containerization, Compose |
+| `deployment-procedures` | CI/CD, deploy workflows |
+| `server-management` | Infrastructure management |
+
+### Testing & Quality
+
+| Skill | Description |
+| ----- | ----------- |
+| `testing-patterns` | Jest, Vitest, strategies |
+| `webapp-testing` | E2E, Playwright |
+| `tdd-workflow` | Test-driven development |
+| `code-review-checklist` | Code review standards |
+| `lint-and-validate` | Linting, validation |
+
+### Security
+
+| Skill | Description |
+| ----- | ----------- |
+| `vulnerability-scanner` | Security auditing, OWASP |
+| `red-team-tactics` | Offensive security |
+
+### Architecture & Planning
+
+| Skill | Description |
+| ----- | ----------- |
+| `app-builder` | Full-stack app scaffolding |
+| `architecture` | System design patterns |
+| `plan-writing` | Task planning, breakdown |
+| `brainstorming` | Socratic questioning |
+
+### Mobile
+
+| Skill | Description |
+| ----- | ----------- |
+| `mobile-design` | Mobile UI/UX patterns |
+
+### Game Development
+
+| Skill | Description |
+| ----- | ----------- |
+| `game-development` | Game logic, mechanics |
+
+### SEO & Growth
+
+| Skill | Description |
+| ----- | ----------- |
+| `seo-fundamentals` | SEO, E-E-A-T, Core Web Vitals |
+| `geo-fundamentals` | GenAI optimization |
+
+### Shell/CLI
+
+| Skill | Description |
+| ----- | ----------- |
+| `bash-linux` | Linux commands, scripting |
+| `powershell-windows` | Windows PowerShell |
+
+### Other
+
+| Skill | Description |
+| ----- | ----------- |
+| `clean-code` | Coding standards (Global) |
+| `behavioral-modes` | Agent personas |
+| `parallel-agents` | Multi-agent patterns |
+| `mcp-builder` | Model Context Protocol |
+| `documentation-templates` | Doc formats |
+| `i18n-localization` | Internationalization |
+| `performance-profiling` | Web Vitals, optimization |
+| `tdd-validation` | SDD completeness validation |
+| `systematic-debugging` | Troubleshooting |
+
+### Documentation & Governance
+
+| Skill | Description |
+| ----- | ----------- |
+| `project-foundation` | Generates README, .env.example, SECURITY.md, INDEX.md, ADR-000 |
+| `document-registry` | Maintains `docs/INDEX.md` as source of truth (READ/WRITE/UPDATE protocol) |
+| `context-gathering-patterns` | Mandatory doc-reading gate before implementation |
+| `history-check-patterns` | Queries past task history before implementing |
+| `qa-test-generation` | Heuristics for generating test checklists by change type |
+---
+
+## 🔄 Workflows (40+)
+
+Slash command procedures. Invoke with `/command`.
+
+### Project Lifecycle
+
+| Command | Description |
+| ------- | ----------- |
+| `/new-project` | New project orchestrator (PRD → SDD → Security → Implementation → Deploy) |
+| `/legacy-project` | Legacy project: Foundation → Analysis → Docs → SDD Reverso → Security → Tasks |
+| `/discovery` | Full automated flow: brainstorm → SDD → Flyee tasks |
+| `/demand` | Commercial proposal generation |
+
+### Feature Development
+
+| Command | Description |
+| ------- | ----------- |
+| `/new-task` | Add or improve features with Flyee tracking (`--backlog` for registration only) |
+| `/execute` | Execute existing Flyee task |
+| `/tdd` | SDD workflow (create `SDD-*.md`, validate, breakdown) |
+| `/prd` | Create Product Requirements Document — outputs `PRD-*.md` |
+| `/atomic` | Create Atomic Design components (stack-agnostic) |
+
+### Task Management (Flyee)
+
+| Command | Description |
+| ------- | ----------- |
+| `/check-task` | Query task status without execution |
+| `/task-update` | Update task progress in Flyee |
+| `/task-complete` | Mandatory task completion: QA gate + Flyee sync + INDEX.md |
+| `/log` | Record completed work retroactively |
+
+### Utilities
+
+| Command | Description |
+| ------- | ----------- |
+| `/brainstorm` | Socratic discovery |
+| `/create` | Create new features |
+| `/debug` | Debug issues |
+| `/deploy` | Deploy application |
+| `/document` | Document existing flows |
+| `/orchestrate` | Multi-agent coordination |
+| `/plan` | Task breakdown |
+| `/preview` | Preview changes |
+| `/status` | Check project status |
+| `/test` | Run tests |
+
+### Meta (Creation)
+
+| Command | Description |
+| ------- | ----------- |
+| `/create-skill` | Create new skill |
+| `/create-agent` | Create new specialist |
+| `/create-workflow` | Create new workflow |
+
+---
+
+## 🎯 Skill Loading Protocol
+
+```plaintext
+User Request → Skill Description Match → Load SKILL.md
+                                            ↓
+                                    Read references/
+                                            ↓
+                                    Read scripts/
+```
+
+### Skill Structure
+
+```plaintext
+skill-name/
+├── SKILL.md           # (Required) Metadata & instructions
+├── scripts/           # (Optional) Python/Bash scripts
+├── references/        # (Optional) Templates, docs
+└── assets/            # (Optional) Images, logos
+```
+
+### Enhanced Skills (with scripts/references)
+
+| Skill | Files | Coverage |
+| ----- | ----- | -------- |
+| `typescript-expert` | 5 | Utility types, tsconfig, cheatsheet |
+| `ui-ux-pro-max` | 27 | 50 styles, 21 palettes, 50 fonts |
+| `app-builder` | 20 | Full-stack scaffolding |
+
+---
+
+## � Scripts (2)
+
+Master validation scripts that orchestrate skill-level scripts.
+
+### Master Scripts
+
+| Script | Purpose | When to Use |
+| ------ | ------- | ----------- |
+| `checklist.py` | Priority-based validation (Core checks) | Development, pre-commit |
+| `verify_all.py` | Comprehensive verification (All checks) | Pre-deployment, releases |
+
+### Usage
+
+```bash
+# Quick validation during development
+python .agent/scripts/checklist.py .
+
+# Full verification before deployment
+python .agent/scripts/verify_all.py . --url http://localhost:3000
+```
+
+### What They Check
+
+**checklist.py** (Core checks):
+
+- Security (vulnerabilities, secrets)
+- Code Quality (lint, types)
+- Schema Validation
+- Test Suite
+- UX Audit
+- SEO Check
+
+**verify_all.py** (Full suite):
+
+- Everything in checklist.py PLUS:
+- Lighthouse (Core Web Vitals)
+- Playwright E2E
+- Bundle Analysis
+- Mobile Audit
+- i18n Check
+
+For details, see [scripts/README.md](scripts/README.md)
+
+---
+
+## 📊 Statistics
+
+| Metric | Value |
+| ------ | ----- |
+| **Total Agents** | 21 |
+| **Total Skills** | 42 |
+| **Total Workflows** | 40+ |
+| **Total Templates** | 9 |
+| **Total Scripts** | 2 (master) + 19 (skill-level) |
+| **Coverage** | ~95% web/mobile development |
+
+---
+
+## 📝 Flyee Integration
+
+Workflows that integrate with Flyee for task management.
+
+### Required Database Properties
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| Título | Title | ✅ | Task name |
+| ID | Text | ✅ | Unique identifier (e.g., `1.1`, `M.2`) |
+| Épico | Select | ✅ | Logical grouping |
+| Status | Status | ✅ | `backlog` → `running` → `testing` → `completed` |
+| % Progresso | Number | ✅ | 0-100% |
+| Categoria | Multi-select | ✅ | Feature, Melhoria, Refatoração, Log, Bug |
+| Prioridade | Select | ❌ | P0, P1, P2, P3 |
+| Estimativa | Text | ❌ | Time estimate (e.g., "4h") |
+| Tempo Gasto | Text | ❌ | Time spent |
+| SDD Ref | Text | ❌ | Link to `docs/design/SDD-*.md` |
+
+### ID Convention
+
+| Source | Format | Example |
+|--------|--------|----------|
+| `/discovery` | `{Epic}.{Seq}` | `1.1`, `2.3` |
+| `/new-task` | `M.{Seq}` | `M.1`, `M.2` |
+| `/legacy-project` | `R.{Seq}` or `{module}.{Seq}` | `R.1`, `auth.2` |
+
+### Recommended Views
+
+- **Visão Cliente**: Name, Status, % Progresso only (for client transparency)
+- **Por Épico**: Grouped by Épico property
+- **Por Prioridade**: Sorted by Prioridade
+
+---
+
+## 🔗 Quick Reference
+
+| Need | Agent | Skills |
+| ---- | ----- | ------ |
+| Web App | `frontend-specialist` | nextjs-react-expert, frontend-design |
+| API | `backend-specialist` | api-patterns, nodejs-best-practices |
+| Mobile | `mobile-developer` | mobile-design |
+| Database | `database-architect` | database-design, prisma-expert |
+| Security | `security-auditor` | vulnerability-scanner |
+| Testing | `test-engineer` | testing-patterns, webapp-testing |
+| Debug | `debugger` | systematic-debugging |
+| Plan | `project-planner` | brainstorming, plan-writing |

package/core/templates/project-resources.example.json

@@ -0,0 +1,71 @@
+{
+  "version": 1,
+  "local_resources": [
+    {
+      "id": "design-system-landing",
+      "label": "UI References — Landing Page components",
+      "path": "docs/design/ui-references/components/landing/",
+      "scope": ["landing", "hero", "features", "how-it-works", "faq", "pricing", "cta", "social-proof"]
+    },
+    {
+      "id": "design-system-layout",
+      "label": "UI References — Layout (Header, Footer, Sidebar)",
+      "path": "docs/design/ui-references/components/layout/",
+      "scope": ["header", "footer", "sidebar", "navigation", "layout"]
+    },
+    {
+      "id": "design-system-dashboard",
+      "label": "UI References — Dashboard components",
+      "path": "docs/design/ui-references/components/dashboard/",
+      "scope": ["dashboard", "overview", "stats", "metrics"]
+    },
+    {
+      "id": "design-system-ui",
+      "label": "UI References — UI primitives (buttons, inputs, cards)",
+      "path": "docs/design/ui-references/components/ui/",
+      "scope": ["design", "ui", "button", "input", "card", "badge", "modal", "dialog"]
+    },
+    {
+      "id": "design-system-pricing",
+      "label": "UI References — Pricing page components",
+      "path": "docs/design/ui-references/components/pricing/",
+      "scope": ["pricing", "planos", "plans", "subscription"]
+    },
+    {
+      "id": "design-system-portal",
+      "label": "UI References — Portal (public pages)",
+      "path": "docs/design/ui-references/components/portal/",
+      "scope": ["portal", "public", "share", "embed"]
+    },
+    {
+      "id": "design-system-articles",
+      "label": "UI References — Articles/Blog components",
+      "path": "docs/design/ui-references/components/articles/",
+      "scope": ["blog", "article", "post", "content"]
+    },
+    {
+      "id": "design-system-docs",
+      "label": "UI References — Documentation page components",
+      "path": "docs/design/ui-references/components/docs/",
+      "scope": ["docs", "documentation", "api-reference", "guide"]
+    },
+    {
+      "id": "design-system-wizard",
+      "label": "UI References — Wizard/Onboarding components",
+      "path": "docs/design/ui-references/components/wizard/",
+      "scope": ["wizard", "onboarding", "stepper", "setup"]
+    },
+    {
+      "id": "sdd-flyee",
+      "label": "SDD — Software Design Document (arquitetura e specs técnicas)",
+      "path": "docs/design/SDD-flyee.md",
+      "scope": ["architecture", "api", "sdk", "models", "schemas", "routes"]
+    },
+    {
+      "id": "prd-flyee",
+      "label": "PRD — Requisitos do produto",
+      "path": "docs/PRD-flyee.md",
+      "scope": ["requirements", "personas", "user-stories", "mvp", "roadmap"]
+    }
+  ]
+}