vibetachyon 1.1.0 → 1.5.0

package/README.md

@@ -1,83 +1,129 @@
-# 🚀 VibeTachyon MCP v1.0
-### The "God-Tier" Frontend AI Copilot Engine
+# VibeTachyon — CodeAgent OS
 
-VibeTachyon is not just another MCP server. It is a high-performance **Autonomous Frontend Engineering System** designed to transform any AI (Claude, GPT, Gemini) into a God-Tier developer. Built on top of the VibeCodes ecosystem, it bridges the gap between design (Figma), **data architecture (Prisma, Drizzle, SQL)**, and pixel-perfect execution.
+> O sistema operacional que roda dentro do seu code agent.
+
+Transforma qualquer agente de código (Claude Code, Cursor, Windsurf, Cline...) em uma máquina especializada em desenvolvimento de produtos digitais — com **38 slash commands**, **50+ skills especializadas**, **8 personas** e **workflows estruturados** prontos para usar.
+
+```bash
+npx vibetachyon-cli
+```
 
 ---
 
-## 💎 Elite Features
+## O que você ganha
 
-### 🧠 The Self-Healing Matrix
-*   **AST Auto-Correction:** Uses `self_heal_typescript_errors` to run local `tsc` checks. If the AI generates a bug, Tachyon catches the AST error and forces the AI to fix it before you even see it.
-*   **Vision QA Loop:** Use `initiate_visual_qa` to perform pixel-perfect audits. Paste a screenshot, and Tachyon will autonomously patch Tailwind margins, padding, and alignment.
+- **38 slash commands** — `/vibe-review`, `/vibe-test`, `/vibe-explain`, `/vibe-bug`, `/vibe-pr`, `/vibe-changelog`, `/vibe-spec`, `/vibe-dev` e mais
+- **50+ skills especializadas** — busca de componentes, segurança, performance, ADR, métricas, backlog, geração de testes, code review
+- **8 personas** — Dev, QA, Architect, PM, Data, UX, DevOps, Analyst
+- **5 squads pré-configurados** — fullstack, qa-focused, minimal, design, release
+- **Missões & Tasks** — rastreamento de objetivos com progresso persistente
+- **ADR Engine** — registra decisões de arquitetura pesquisáveis em sessões futuras
+- **Métricas de Dev** — story cycle time, build duration, test coverage
+- **Backlog inteligente** — prioridade crítica→baixa com ordenação automática
+- **Memória por projeto** — o agente aprende e não repete os mesmos erros
 
-### 🎨 Design-to-Code Bridge
-*   **Figma Transcription:** `fetch_figma_design` pulls raw JSON nodes directly from Figma API and maps them to clean Tailwind/React code.
-*   **Theme Cloning:** `get_vibe_colors` and `learn_user_preferences` scan your local `globals.css` and `.prettierrc` to clone your exact coding style and color palette.
+---
 
-### 🛡️ "Accept-All" Guardrails (Zero friction)
-*   **Framework Agnostic:** Dynamically detects if you are using **Next.js** or **Vite**. It automatically translates `<Image>` to `<img>` and `Link` to `<a>` to prevent framework mismatches.
-*   **Dependency Resolver:** `analyze_and_install_deps` identifies missing packages (framer-motion, lucide, etc.) and generates the exact install command.
+## Instalação
 
-### 📈 Enterprise Standards
-*   **VibeSec Penetration Tester:** `run_security_penetration` automatically scans newly generated code for XSS vectors, SQL Injection risks, and hardcoded Secrets. If a vulnerability is found, it blocks delivery and forces the AI to rewrite the logic safely.
-*   **VibePilot CLI:** `update_terminal_status` gives the AI a literal "face" in your terminal. It writes chalk-colored progress bars and statuses (e.g. `🧠 Compiling AST Fixes...`) to `stderr` so you can visually watch the bot think.
-*   **VibeSpeed Local (Lighthouse):** `initiate_vibespeed_audit` runs an automated headless Lighthouse test on localhost. If the Performance score is <90, the Copilot forces itself to refactor the page (lazy loading, optimized images) until it passes.
-*   **Data Intelligence:** `analyze_business_logic` scans for **Prisma, Drizzle, or raw TS models** to ground UI generation in your real data structure. No hard dependencies.
-*   **Telemetry Engine:** `enforce_telemetry_tracking` forces the injection of `data-vibe-tracking` attributes for instant PostHog/GA integration.
-*   **i18n Globalization:** `enforce_i18n_standards` forbids hardcoded strings, forcing text extraction for easy translation.
-*   **SEO Heuristics:** `enforce_seo_metadata` injects framework-native SEO/OpenGraph tags for maximum ranking.
+```bash
+npx vibetachyon-cli
+```
 
----
+Selecione seu agente, cole o token VibeCodes MAX e pronto.
+
+### Flags não-interativas
 
-## 🛠️ Toolset Overview
+```bash
+npx vibetachyon-cli install --agent claude --token vcf_...
+npx vibetachyon-cli install --agent cursor --token vcf_... --dry-run
+npx vibetachyon-cli doctor
+```
 
-| Category | Tools | Description |
-| :--- | :--- | :--- |
-| **Search** | `search_vibecodes_snippets`, `compose_landing_page` | Semantic RAG search for UI and full-page composition. |
-| **Analysis** | `scan_local_architecture`, `analyze_business_logic` | Scans `package.json`, Prisma schemas, and API routes. |
-| **Styling** | `get_vibe_colors`, `patch_tailwind_config` | Real-time theme extraction and Tailwind config patching. |
-| **QA** | `self_heal_typescript_errors`, `initiate_visual_qa` | Autonomous AST error fixing and AI Vision validation. |
-| **Guardrails** | `enforce_atomic_design`, `audit_a11y_wcag`, `enforce_seo_metadata` | Enforces 150-line limits, WCAG compliance, and SEO tags. |
-| **Integration** | `fetch_figma_design`, `generate_local_assets` | Connects Figma designs and localizes remote assets. |
+**Agentes suportados:** `claude` | `cursor` | `windsurf` | `cline` | `copilot` | `gemini` | `codex`
 
 ---
 
-## 🚀 Getting Started (Automatic Installation)
+## Slash Commands
+
+### Essenciais — use todo dia
+
+| Comando | O que faz |
+|---------|-----------|
+| `/vibe-review` | Code review dos changes atuais — bugs, edge cases, segurança |
+| `/vibe-test` | Gera testes (Jest/Vitest/Playwright) para qualquer arquivo |
+| `/vibe-explain` | Explica qualquer arquivo como um dev sênior explicaria |
+| `/vibe-bug` | Fluxo estruturado de debug: hipóteses, checklist, quick fixes |
+| `/vibe-pr` | Gera PR description completa a partir do diff |
+| `/vibe-changelog` | Gera release notes a partir do git log |
+| `/vibe-env` | Verifica variáveis de ambiente — faltando, não documentadas |
+| `/vibe-deps` | Health check de dependências: outdated e vulnerabilidades |
+| `/vibe-copy` | Escreve UI copy: botões, erros, empty states, CTAs |
+| `/vibe-refactor` | Sugere refactoring priorizado com before/after |
+
+### Desenvolvimento e Qualidade
+
+| Comando | O que faz |
+|---------|-----------|
+| `/vibe-search` | Busca semântica em 6.000+ componentes UI |
+| `/vibe-dev` | Implementação com zero TypeScript errors |
+| `/vibe-commit` | Gera mensagem de commit Conventional Commits |
+| `/vibe-audit` | Auditoria: tech debt, console leaks, secrets, large files |
+| `/vibe-qa-loop` | Review iterativo: max 5× até approve |
+| `/vibe-security` | Scan de segurança: XSS, SQLi, hardcoded secrets |
+| `/vibe-speed` | Auditoria Lighthouse: LCP, INP, CLS, TTI |
+
+### Planejamento e Arquitetura
+
+| Comando | O que faz |
+|---------|-----------|
+| `/vibe-spec` | Pipeline de spec: ideia → spec executável em 6 fases |
+| `/vibe-story` | Cria user story com ACs testáveis |
+| `/vibe-architect` | Avalia complexidade e documenta trade-offs |
+| `/vibe-adr` | Registra Architecture Decision Record |
+| `/vibe-metrics` | Dashboard de métricas de desenvolvimento |
+| `/vibe-backlog` | Gerencia backlog de features com prioridades |
+| `/vibe-mission-start` | Inicia missão com tasks e rastreamento |
+| `/vibe-memory` | Visualiza/registra memória do projeto |
+| `/vibe-release` | Prepara release com checklist de 10 pontos |
+| `/vibe-workflow` | Seleção inteligente de workflow por situação |
 
-The easiest way to get VibeTachyon running in your IDE is via our interactive installer.
+---
+
+## 4 Workflows Principais
 
-### 1. Run the Installer
-In your project terminal, run:
-```bash
-npx vibetachyon@latest
 ```
+Story Development Cycle  →  feature nova do zero ao deploy
+QA Loop                  →  review iterativo max 5× com veredito
+Spec Pipeline            →  requisito informal → spec executável
+Brownfield Discovery     →  assessment de codebase legada em 10 fases
+```
+
+---
 
-### 2. Follow the Prompts
-1.  **Select your IDE:** Cursor, Windsurf, Claude Desktop, VS Code (Cline/Roo), etc.
-2.  **Authenticate:** Paste your **VibeCodes MAX Token**.
-3.  **Done:** The installer will autonomously inject the MCP configuration into your IDE's global settings.
-
-### 3. Manual Configuration (Optional)
-If you prefer manual setup, add this to your MCP config file:
-```json
-{
-  "mcpServers": {
-    "vibetachyon": {
-      "command": "npx",
-      "args": ["-y", "vibetachyon@latest", "server"],
-      "env": {
-        "VIBECODES_TOKEN": "YOUR_TOKEN_HERE"
-      }
-    }
-  }
-}
+## Arquitetura
+
+```
+SEU CODE AGENT (Claude Code / Cursor / Windsurf)
+       │
+       │ VibeTachyon Skills Layer
+       ▼
+VIBETACHYON — CodeAgent OS
+  40+ skills  •  8 personas  •  5 squads
+  Missões     •  Tasks  •  Memória  •  ADR
+       │
+       ▼
+.vibetachyon/ (Project Runtime)
+  missions/  tasks/  memory/  debriefs/
+  decisions/ metrics/ backlog/ releases/
 ```
 
 ---
 
-## 📜 Coding Philosophy
-VibeTachyon enforces **Atomic Design** and **Framework Awareness**. It treats the code as a living organism that must be performant (minified snippets), accessible (WCAG), and measurable (Telemetry).
+## Documentação
+
+[vibecodings.com.br/docs](https://vibecodings.com.br/docs)
+
+---
 
-**Made with 💙 by Davi Ravieri.**
-"Make it work, make it beautiful, make it God-Tier."
+Feito com ❤️ pela equipe VibeCodes.