sinapse-ai 6.0.4 → 7.0.1

package/README.md

@@ -1,746 +1,288 @@
-# SINAPSE Squad: Artificial Intelligence Orchestration eXperience
+# SINAPSE AI
 
-> 🌍 [English](README.en.md) | **[Português](README.md)**
+> [English](README.en.md) | **Portugues**
 
-[![Versão NPM](https://img.shields.io/npm/v/sinapse-ai.svg)](https://www.npmjs.com/package/sinapse-ai)
-[![Licença: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
-[![Versão Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
-[![CI](https://github.com/SinapseAI/sinapse-ai/actions/workflows/ci.yml/badge.svg)](https://github.com/SinapseAI/sinapse-ai/actions/workflows/ci.yml)
-[![codecov](https://codecov.io/gh/SinapseAI/sinapse-ai/branch/main/graph/badge.svg)](https://codecov.io/gh/SinapseAI/sinapse-ai)
-[![Documentação](https://img.shields.io/badge/docs-disponível-orange.svg)](https://sinapsesquad.ai)
+[![npm](https://img.shields.io/npm/v/sinapse-ai.svg)](https://www.npmjs.com/package/sinapse-ai)
+[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org/)
 [![Open Source](https://img.shields.io/badge/Open%20Source-Yes-success.svg)](LICENSE)
-[![Contributions Welcome](https://img.shields.io/badge/contributions-welcome-brightgreen.svg)](CONTRIBUTING.md)
-[![Code of Conduct](https://img.shields.io/badge/code%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md)
 
-> 🌐 README por idioma: [EN](docs/README.md) | [PT](docs/pt/README.md)
+> **151 agentes de IA. 19 squads especializados. Uma CLI.**
 >
-> **Devolvendo às pessoas o poder de criar** — Framework open source de orquestração de IA que devolve o controle a quem tem coragem de construir. Agentes especializados, workflows e experiência CLI First para qualquer domínio.
+> O SINAPSE AI e um framework open source que organiza agentes de IA em squads especializados para resolver problemas reais de negocios, marketing, desenvolvimento, copy, design e mais. Funciona direto no seu terminal com Claude Code, Codex CLI ou qualquer IDE compativel.
 
-## Comece Aqui (10 Min)
-
-Se é sua primeira vez no SINAPSE, siga este caminho linear:
-
-1. Instale em um projeto novo ou existente:
-```bash
-# novo projeto
-npx sinapse-ai init meu-projeto
-
-# projeto existente
-cd seu-projeto
-npx sinapse-ai install
-```
-2. Escolha sua IDE/CLI e o caminho de ativação:
-- Claude Code: `/agent-name`
-- Gemini CLI: `/sinapse-menu` → `/sinapse-<agent>`
-- Codex CLI: `/skills` → `sinapse-<agent-id>`
-- Cursor/Copilot/AntiGravity: siga os limites e workarounds em `docs/ide-integration.md`
-3. Ative 1 agente e confirme o greeting.
-4. Rode 1 comando inicial (`*help` ou equivalente) para validar first-value.
-
-Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.
-
-
-## Compatibilidade de Hooks por IDE (Realidade SINAPSE 4.2)
-
-Muitos recursos avançados do SINAPSE dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:
+---
 
-| IDE/CLI | Paridade de Hooks vs Claude | Impacto Prático |
-| --- | --- | --- |
-| Claude Code | Completa (referência) | Automação máxima de contexto, guardrails e auditoria |
-| Gemini CLI | Alta (eventos nativos) | Cobertura forte de automações pre/post tool e sessão |
-| Codex CLI | Parcial/limitada | Parte das automações depende de `AGENTS.md`, `/skills`, MCP e fluxo operacional |
-| Cursor | Sem lifecycle hooks equivalentes | Menor automação de pre/post tool; foco em regras, MCP e fluxo do agente |
-| GitHub Copilot | Sem lifecycle hooks equivalentes | Menor automação de sessão/tooling; foco em instruções de repositório + MCP no VS Code |
-| AntiGravity | Workflow-based (não hook-based) | Integração por workflows, não por eventos de hook equivalentes ao Claude |
+## O que e o SINAPSE AI
 
-Impactos e mitigação detalhados: `docs/ide-integration.md`.
+O SINAPSE AI nao e mais um chatbot. E um sistema de orquestracao onde cada agente tem um papel claro, cada squad domina uma disciplina, e tudo funciona via CLI.
 
-## Visão Geral
+**O que voce ganha ao instalar:**
 
-### Premissa Arquitetural: CLI First
+- **19 orquestradores (orqx)** prontos para ativar direto no terminal
+- **151 agentes especializados** com knowledge bases proprias
+- **Workflows completos** de planejamento, desenvolvimento, QA e deploy
+- **Story-Driven Development** com rastreamento automatico de progresso
+- **Compatibilidade multi-IDE**: Claude Code, Codex CLI, Cursor, Gemini CLI
 
-O SINAPSE segue uma hierarquia clara de prioridades:
+### Arquitetura: CLI First
 
 ```
-CLI First → Observability Second → UI Third
+CLI First > Observability Second > UI Third
 ```
 
-| Camada            | Prioridade | Foco                                                                          | Exemplos                                     |
-| ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- |
-| **CLI**           | Máxima     | Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui. | Agentes (`@dev`, `@qa`), workflows, comandos |
-| **Observability** | Secundária | Observar e monitorar o que acontece no CLI em tempo real.                     | Dashboard SSE, logs, métricas, timeline      |
-| **UI**            | Terciária  | Gestão pontual e visualizações quando necessário.                             | Kanban, settings, story management           |
-
-**Princípios derivados:**
-
-- A CLI é a fonte da verdade - dashboards apenas observam
-- Funcionalidades novas devem funcionar 100% via CLI antes de ter UI
-- A UI nunca deve ser requisito para operação do sistema
-- Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo
+Toda inteligencia vive na CLI. Dashboards observam. A UI nunca e requisito.
 
 ---
 
-**As Duas Inovações Chave do SINAPSE:**
-
-**1. Planejamento Agêntico:** Agentes dedicados (analyst, pm, architect) colaboram com você para criar documentos de PRD e Arquitetura detalhados e consistentes. Através de engenharia avançada de prompts e refinamento com human-in-the-loop, estes agentes de planejamento produzem especificações abrangentes que vão muito além da geração genérica de tarefas de IA.
-
-**2. Desenvolvimento Contextualizado por Engenharia:** O agente sm (Scrum Master) então transforma estes planos detalhados em histórias de desenvolvimento hiperdetalhadas que contêm tudo que o agente dev precisa - contexto completo, detalhes de implementação e orientação arquitetural incorporada diretamente nos arquivos de histórias.
-
-Esta abordagem de duas fases elimina tanto a **inconsistência de planejamento** quanto a **perda de contexto** - os maiores problemas no desenvolvimento assistido por IA. Seu agente dev abre um arquivo de história com compreensão completa do que construir, como construir e por quê.
-
-**📖 [Veja o fluxo de trabalho completo no Guia do Usuário](docs/guides/user-guide.md)** - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes
-
-## Pré-requisitos
-
-- Node.js >=18.0.0 (v20+ recomendado)
-- npm >=9.0.0
-- GitHub CLI (opcional, necessário para colaboração em equipe)
-
-> **Problemas de instalação?** Consulte o [Guia de Troubleshooting](docs/guides/installation-troubleshooting.md)
-
-**Guias específicos por plataforma:**
-
-- 📖 [Guia de Instalação para macOS](docs/installation/macos.md)
-- 📖 [Guia de Instalação para Windows](docs/installation/windows.md)
-- 📖 [Guia de Instalação para Linux](docs/installation/linux.md)
-
-**Documentacao disponivel:** [English](docs/README.md) | [Portugues](docs/pt/README.md)
-
-## Navegação Rápida
-
-### Entendendo o Fluxo de Trabalho SINAPSE
-
-**Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o SINAPSE funciona:**
-
-1. **[Fluxo de Planejamento (Interface Web)](docs/guides/user-guide.md#the-planning-workflow-web-ui)** - Como criar documentos de PRD e Arquitetura
-2. **[Ciclo Principal de Desenvolvimento (IDE)](docs/guides/user-guide.md#the-core-development-cycle-ide)** - Como os agentes sm, dev e qa colaboram através de arquivos de histórias
-
-> ⚠️ **Estes diagramas explicam 90% da confusão sobre o fluxo SINAPSE Agentic Agile** - Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm/dev/qa e como os agentes passam notas através de arquivos de histórias é essencial - e também explica por que isto NÃO é taskmaster ou apenas um simples executor de tarefas!
-
-### O que você gostaria de fazer?
-
-- **[Instalar e Construir software com Equipe Ágil Full Stack de IA](#início-rápido)** → Instruções de Início Rápido
-- **[Aprender como usar o SINAPSE](docs/guides/user-guide.md)** → Guia completo do usuário e passo a passo
-- **[Ver agentes IA disponíveis](#agentes-disponíveis)** → Papéis especializados para sua equipe
-- **[Explorar usos não técnicos](#-além-do-desenvolvimento-de-software---squads)** → Escrita criativa, negócios, bem-estar, educação
-- **[Criar meus próprios agentes IA](#criando-seu-próprio-squad)** → Construir agentes para seu domínio
-- **[Navegar Squads prontos](docs/guides/squads-overview.md)** → Veja como criar e usar equipes de agentes IA
-- **[Entender a arquitetura](docs/architecture/ARCHITECTURE-INDEX.md)** → Mergulho técnico profundo
-- **[Reportar problemas](https://github.com/SinapseAI/sinapse-ai/issues)** → Bug reports e feature requests
-
-## Importante: Mantenha Sua Instalação SINAPSE Atualizada
-
-**Mantenha-se atualizado sem esforço!** Para atualizar sua instalação SINAPSE existente:
-
-```bash
-npx sinapse-ai@latest install
-```
-
-Isto vai:
-
-- ✅ Detectar automaticamente sua instalação existente
-- ✅ Atualizar apenas os arquivos que mudaram
-- ✅ Criar arquivos de backup `.bak` para quaisquer modificações customizadas
-- ✅ Preservar suas configurações específicas do projeto
-
-Isto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!
-
-## Início Rápido
-
-### 🚀 Instalação via NPX (Recomendado)
-
-**Instale o SINAPSE com um único comando:**
+## Instalacao (2 minutos)
 
 ```bash
-# Criar um novo projeto com assistente interativo moderno
+# Novo projeto
 npx sinapse-ai init meu-projeto
 
-# Ou instalar em projeto existente
-cd seu-projeto
-npx sinapse-ai install
-
-# Ou usar uma versão específica
-npx sinapse-ai@latest init meu-projeto
-```
-
-### ✨ Assistente de Instalação Moderno
-
-O SINAPSE agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:
-
-**Recursos do Instalador Interativo:**
-
-- 🎨 **Interface Moderna**: Prompts coloridos e visuais com @clack/prompts
-- ✅ **Validação em Tempo Real**: Feedback instantâneo sobre entradas inválidas
-- 🔄 **Indicadores de Progresso**: Spinners para operações longas (cópia de arquivos, instalação de deps)
-- 📦 **Seleção Multi-Componente**: Escolha quais componentes instalar com interface intuitiva
-- ⚙️ **Escolha de Gerenciador de Pacotes**: Selecione entre npm, yarn ou pnpm
-- ⌨️ **Suporte a Cancelamento**: Ctrl+C ou ESC para sair graciosamente a qualquer momento
-- 📊 **Resumo de Instalação**: Visualize todas as configurações antes de prosseguir
-- ⏱️ **Rastreamento de Duração**: Veja quanto tempo levou a instalação
-
-**O instalador oferece:**
-
-- ✅ Download da versão mais recente do NPM
-- ✅ Assistente de instalação interativo moderno
-- ✅ Configuração automática do IDE (Codex CLI, Cursor ou Claude Code)
-- ✅ Configuração de todos os agentes e fluxos de trabalho SINAPSE
-- ✅ Criação dos arquivos de configuração necessários
-- ✅ Inicialização do sistema de meta-agentes
-- ✅ Verificações de saúde do sistema
-- ✅ **Suporte Cross-Platform**: Testado em Windows, macOS e Linux
-
-> **É isso!** Sem clonar, sem configuração manual - apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.
-
-**Pré-requisitos**: [Node.js](https://nodejs.org) v18+ necessário (v20+ recomendado) | [Troubleshooting](docs/guides/installation-troubleshooting.md)
+# Projeto existente
+cd seu-projeto && npx sinapse-ai install
 
-### Atualizando uma Instalação Existente
-
-Se você já tem o SINAPSE instalado:
-
-```bash
+# Atualizar instalacao existente
 npx sinapse-ai@latest install
-# O instalador detectará sua instalação existente e a atualizará
 ```
 
-### Configure Seu IDE para Desenvolvimento SINAPSE
-
-O SINAPSE inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:
-
-#### Para Cursor:
+O wizard detecta seu ambiente, configura sua IDE e instala os squads automaticamente.
 
-1. Abra as configurações do Cursor
-2. Navegue até **User Rules**
-3. Copie o conteúdo de `.cursor/global-rules.md`
-4. Cole na seção de regras e salve
-
-#### Para Claude Code:
-
-- ✅ Já configurado! O arquivo `.claude/CLAUDE.md` é carregado automaticamente
-- Sync dedicado de agentes: `npm run sync:ide:claude`
-- Validacao dedicada: `npm run validate:claude-sync && npm run validate:claude-integration`
-
-#### Para Codex CLI:
-
-- ✅ Integração de primeira classe no SINAPSE 4.2 (pipeline de ativação e greeting compartilhado)
-- ✅ Já configurado! O arquivo `AGENTS.md` na raiz é carregado automaticamente
-- Opcional: sincronize agentes auxiliares com `npm run sync:ide:codex`
-- Recomendado neste repositório: gerar e versionar skills locais com `npm run sync:skills:codex`
-- Use `npm run sync:skills:codex:global` apenas fora deste projeto (para evitar duplicidade no `/skills`)
-- Validacao dedicada: `npm run validate:codex-sync && npm run validate:codex-integration`
-- Guardrails de skills/paths: `npm run validate:codex-skills && npm run validate:paths`
+```bash
+# Diagnostico
+npx sinapse-ai doctor
 
-#### Para Gemini CLI:
+# Informacoes do sistema
+npx sinapse-ai info
+```
 
-- ✅ Regras e agentes sincronizaveis com `npm run sync:ide:gemini`
-- Arquivos gerados em `.gemini/rules.md`, `.gemini/rules/SINAPSE/agents/` e `.gemini/commands/*.toml`
-- ✅ Hooks e settings locais no fluxo de instalacao (`.gemini/hooks/` + `.gemini/settings.json`)
-- ✅ Ativacao rapida por slash commands (`/sinapse-menu`, `/sinapse-dev`, `/sinapse-architect`, etc.)
-- Validacao dedicada: `npm run validate:gemini-sync && npm run validate:gemini-integration`
-- Paridade multi-IDE em um comando: `npm run validate:parity`
+**Requisitos:** Node.js 18+ (v20+ recomendado)
 
-Estas regras fornecem:
+---
 
-- 🤖 Reconhecimento e integração de comandos de agentes
-- 📋 Fluxo de trabalho de desenvolvimento dirigido por histórias
-- ✅ Rastreamento automático de checkboxes
-- 🧪 Padrões de teste e validação
-- 📝 Padrões de código específicos do SINAPSE
+## Squads Disponiveis
+
+Cada squad e uma equipe de agentes especializados com knowledge base, workflows e tasks proprias. Todos os squads sao **gratuitos e open source**.
+
+| Squad | Foco | Agentes |
+|-------|------|---------|
+| **squad-brand** | Estrategia de marca, arquetipos, auditoria | 15 |
+| **squad-copy** | Copywriting persuasivo, headlines, conversao | 13 |
+| **squad-council** | Advisors estrategicos (Munger, Dalio, Thiel) | 11 |
+| **squad-storytelling** | Narrativa, roteiros, frameworks de historia | 10 |
+| **squad-commercial** | Vendas, funil, revenue, pipeline | 10 |
+| **squad-animations** | Motion design, CSS, particulas, 3D | 9 |
+| **squad-paidmedia** | Meta Ads, Google Ads, campanhas, otimizacao | 9 |
+| **squad-claude** | Claude Code, MCP, integracao avancada | 8 |
+| **squad-cloning** | Clonagem cognitiva, mind synthesis | 8 |
+| **squad-courses** | Cursos, curriculos, assessments, launch | 8 |
+| **squad-cybersecurity** | Seguranca, threat intel, pentest | 8 |
+| **squad-design** | Design systems, componentes, tokens | 8 |
+| **squad-content** | Governanca editorial, estrategia de conteudo | 7 |
+| **squad-product** | Product discovery, estrategia, operacoes | 7 |
+| **squad-research** | Market analysis, inteligencia competitiva | 7 |
+| **squad-growth** | Analytics, CRO, SEO, growth hacking | 7 |
+| **squad-finance** | Budget, pricing, profitability analysis | 5 |
+| **claude-code-mastery** | Dominio avancado do Claude Code | 8 |
+
+**Total: 19 squads, 151+ agentes especializados**
 
-### Início Mais Rápido com Interface Web (2 minutos)
+---
 
-1. **Instale o SINAPSE**: Execute `npx sinapse-ai init meu-projeto`
-2. **Configure seu IDE**: Siga as instruções de configuração para Codex CLI, Cursor ou Claude Code
-3. **Comece a Planejar**: Ative um agente como `@analyst` para começar a criar seu briefing
-4. **Use comandos SINAPSE**: Digite `*help` para ver comandos disponíveis
-5. **Siga o fluxo**: Veja o [Guia do usuário](docs/guides/user-guide.md) para mais detalhes
+## Como Usar
 
-### Referência de Comandos CLI
+### No Claude Code
 
-O SINAPSE oferece uma CLI moderna e cross-platform com comandos intuitivos:
+Ative qualquer orquestrador pelo nome:
 
-```bash
-# Gerenciamento de Projeto (com assistente interativo)
-npx sinapse-ai init <nome-projeto> [opções]
-  --force              Forçar criação em diretório não vazio
-  --skip-install       Pular instalação de dependências npm
-  --template <nome>    Usar template específico (default, minimal, enterprise)
-
-# Instalação e Configuração (com prompts modernos)
-npx sinapse-ai install [opções]
-  --force              Sobrescrever configuração existente
-  --quiet              Saída mínima durante instalação
-  --dry-run            Simular instalação sem modificar arquivos
-
-# Comandos do Sistema
-npx sinapse-ai --version   Exibir versão instalada
-npx sinapse-ai --help      Exibir ajuda detalhada
-npx sinapse-ai info        Exibir informações do sistema
-npx sinapse-ai doctor      Executar diagnósticos do sistema
-npx sinapse-ai doctor --fix Corrigir problemas detectados automaticamente
-
-# Manutenção
-npx sinapse-ai update      Atualizar para versão mais recente
-npx sinapse-ai uninstall   Remover SINAPSE
 ```
-
-**Recursos da CLI:**
-
-- ✅ **Help System Abrangente**: `--help` em qualquer comando mostra documentação detalhada
-- ✅ **Validação de Entrada**: Feedback imediato sobre parâmetros inválidos
-- ✅ **Mensagens Coloridas**: Erros em vermelho, sucessos em verde, avisos em amarelo
-- ✅ **Cross-Platform**: Funciona perfeitamente em Windows, macOS e Linux
-- ✅ **Suporte a Dry-Run**: Teste instalações sem modificar arquivos
-
-### 💡 Exemplos de Uso
-
-#### Instalação Interativa Completa
-
-```bash
-$ npx sinapse-ai install
-
-🚀 SINAPSE Installation
-
-◆ What is your project name?
-│  my-awesome-project
-│
-◇ Which directory should we use?
-│  ./my-awesome-project
-│
-◆ Choose components to install:
-│  ● Core Framework (Required)
-│  ● Agent System (Required)
-│  ● Squads (optional)
-│  ○ Example Projects (optional)
-│
-◇ Select package manager:
-│  ● npm
-│  ○ yarn
-│  ○ pnpm
-│
-◆ Initialize Git repository?
-│  Yes
-│
-◆ Install dependencies?
-│  Yes
-│
-▸ Creating project directory...
-▸ Copying framework files...
-▸ Initializing Git repository...
-▸ Installing dependencies (this may take a minute)...
-▸ Configuring environment...
-▸ Running post-installation setup...
-
-✔ Installation completed successfully! (34.2s)
-
-Next steps:
-  cd my-awesome-project
-  sinapse-ai doctor     # Verify installation
-  sinapse-ai --help     # See available commands
+/sinapse            # Orquestrador principal
+@brand-orqx         # Squad de brand
+@copy-orqx          # Squad de copy
+@research-orqx      # Squad de research
 ```
 
-#### Instalação Silenciosa (CI/CD)
+Ou use os agentes de desenvolvimento:
 
-```bash
-# Instalação automatizada sem prompts
-$ npx sinapse-ai install --quiet --force
-✔ SINAPSE installed successfully
 ```
-
-#### Simulação de Instalação (Dry-Run)
-
-```bash
-# Testar instalação sem modificar arquivos
-$ npx sinapse-ai install --dry-run
-
-[DRY RUN] Would create: ./my-project/
-[DRY RUN] Would copy: .sinapse-ai/ (45 files)
-[DRY RUN] Would initialize: Git repository
-[DRY RUN] Would install: npm dependencies
-✔ Dry run completed - no files were modified
+@developer           # Implementacao de codigo
+@quality-gate        # Testes e qualidade
+@architect           # Arquitetura e design
+@sprint-lead         # Criacao de stories
+@product-lead        # Validacao de stories
+@project-lead        # Product management
+@analyst             # Pesquisa e analise
+@data-engineer       # Database design
+@devops              # CI/CD e git push (exclusivo)
 ```
 
-#### Diagnóstico do Sistema
+### No Codex CLI
 
-```bash
-$ npx sinapse-ai doctor
-
-🏥 SINAPSE System Diagnostics
-
-✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)
-✔ npm version: 10.2.3
-✔ Git installed: version 2.43.0
-✔ GitHub CLI: gh 2.40.1
-✔ SINAPSE: v4.2.11
-
-Configuration:
-✔ .sinapse-ai/ directory exists
-✔ Agent files: 11 found
-✔ Workflow files: 8 found
-✔ Templates: 15 found
-
-Dependencies:
-✔ @clack/prompts: ^0.7.0
-✔ commander: ^12.0.0
-✔ execa: ^9.0.0
-✔ fs-extra: ^11.0.0
-✔ picocolors: ^1.0.0
-
-✅ All checks passed! Your installation is healthy.
 ```
-
-#### Obter Ajuda
-
-```bash
-$ npx sinapse-ai --help
-
-Usage: sinapse-ai [options] [command]
-
-SINAPSE: AI-Orchestrated System for Full Stack Development
-
-Options:
-  -V, --version                output the version number
-  -h, --help                   display help for command
-
-Commands:
-  init <project-name>          Create new SINAPSE project with interactive wizard
-  install [options]            Install SINAPSE in current directory
-  info                         Display system information
-  doctor [options]             Run system diagnostics and health checks
-  help [command]               display help for command
-
-Run 'sinapse-ai <command> --help' for detailed information about each command.
+/skills              # Lista todos os agentes disponiveis
+sinapse-dev          # Ativa o developer
+sinapse-architect    # Ativa o architect
 ```
 
-### Alternativa: Clonar e Construir
+### Comandos dos Agentes
 
-Para contribuidores ou usuários avançados que queiram modificar o código fonte:
-
-```bash
-# Clonar o repositório
-git clone https://github.com/SinapseAI/sinapse-ai.git
-cd sinapse-ai
+Dentro de qualquer agente, use `*` para comandos:
 
-# Instalar dependências
-npm install
-
-# Executar o instalador
-npm run install:sinapse
 ```
-
-### Configuração Rápida para Equipe
-
-Para membros da equipe ingressando no projeto:
-
-```bash
-# Instalar SINAPSE no projeto
-npx sinapse-ai@latest install
-
-# Isto vai:
-# 1. Detectar instalação existente (se houver)
-# 2. Instalar/atualizar framework SINAPSE
-# 3. Configurar agentes e workflows
+*help                # Comandos disponiveis
+*create-story        # Criar story de desenvolvimento
+*task <nome>         # Executar task especifica
+*exit                # Sair do agente
 ```
 
-## 🌟 Além do Desenvolvimento de Software - Squads
-
-O framework de linguagem natural do SINAPSE funciona em QUALQUER domínio. Os Squads fornecem agentes IA especializados para escrita criativa, estratégia de negócios, saúde e bem-estar, educação e muito mais. Além disso, os Squads podem expandir o núcleo do SINAPSE com funcionalidade específica que não é genérica para todos os casos. [Veja o Guia de Squads](docs/guides/squads-guide.md) e aprenda a criar os seus próprios!
-
-## Agentes Disponíveis
-
-O SINAPSE vem com 12 agentes especializados:
-
-### Agentes Meta
-
-- **sinapse-orqx** - Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework)
-- **sinapse-orchestrator** - Orquestrador de fluxo de trabalho e coordenação de equipe
-
-### Agentes de Planejamento (Interface Web)
-
-- **analyst** - Especialista em análise de negócios e criação de PRD
-- **pm** (Product Manager) - Gerente de produto e priorização
-- **architect** - Arquiteto de sistema e design técnico
-- **ux-expert** - Design de experiência do usuário e usabilidade
-
-### Agentes de Desenvolvimento (IDE)
-
-- **sm** (Scrum Master) - Gerenciamento de sprint e criação de histórias
-- **dev** - Desenvolvedor e implementação
-- **qa** - Garantia de qualidade e testes
-- **po** (Product Owner) - Gerenciamento de backlog e histórias
-- **data-engineer** - Design de banco de dados e modelagem de dados
-- **devops** - CI/CD, infraestrutura e operações git (autoridade exclusiva de push)
-
-## Documentação e Recursos
-
-### Guias Essenciais
-
-- 📖 **[Guia do Usuário](docs/guides/user-guide.md)** - Passo a passo completo desde a concepção até a conclusão do projeto
-- 🏗️ **[Arquitetura Principal](docs/architecture/SINAPSE-VISUAL-OVERVIEW.md)** - Mergulho técnico profundo e design do sistema
-- 🚀 **[Guia de Squads](docs/guides/squads-guide.md)** - Estenda o SINAPSE para qualquer domínio além do desenvolvimento de software
-
-### Documentação Adicional
-
-- 🤖 **[Guia de Squads](docs/guides/squads-guide.md)** - Crie e publique equipes de agentes IA
-- 📋 **[Primeiros Passos](docs/getting-started.md)** - Tutorial passo a passo para iniciantes
-- 🔧 **[Solução de Problemas](docs/troubleshooting.md)** - Soluções para problemas comuns
-- 🎯 **[Princípios Orientadores](docs/GUIDING-PRINCIPLES.md)** - Filosofia e melhores práticas do SINAPSE
-- 🏛️ **[Visão Geral da Arquitetura](docs/architecture/SINAPSE-VISUAL-OVERVIEW.md)** - Visão detalhada da arquitetura do sistema
-- ⚙️ **[Guia de Ajuste de Performance](docs/performance-tuning-guide.md)** - Otimize seu fluxo de trabalho SINAPSE
-- 🔒 **[Melhores Práticas de Segurança](docs/security-best-practices.md)** - Segurança e proteção de dados
-- 🔄 **[Guia de Migração](docs/migration-guide.md)** - Migração de versões anteriores
-- 📦 **[Versionamento e Releases](docs/versioning-and-releases.md)** - Política de versões
-
-## 🤖 SINAPSE Autonomous Development Engine (ADE)
-
-O SINAPSE introduz o **Autonomous Development Engine (ADE)** - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.
+---
 
-### 🎯 O Que é o ADE?
+## Agentes de Desenvolvimento
 
-O ADE é um conjunto de **7 Epics** que habilitam execução autônoma de desenvolvimento:
+O SINAPSE vem com 12 agentes core para o ciclo completo de desenvolvimento:
 
-| Epic  | Nome             | Descrição                                  |
-| ----- | ---------------- | ------------------------------------------ |
-| **1** | Worktree Manager | Isolamento de branches via Git worktrees   |
-| **2** | Migration V2→V3  | Migração para formato autoClaude V3        |
-| **3** | Spec Pipeline    | Transforma requisitos em specs executáveis |
-| **4** | Execution Engine | Executa specs com 13 steps + self-critique |
-| **5** | Recovery System  | Recuperação automática de falhas           |
-| **6** | QA Evolution     | Review estruturado em 10 fases             |
-| **7** | Memory Layer     | Memória persistente de padrões e insights  |
+| Agente | Persona | Escopo |
+|--------|---------|--------|
+| `sinapse-orqx` | Imperator | Orquestrador principal de todos os squads |
+| `developer` | Dex | Implementacao de codigo |
+| `quality-gate` | Quinn | Testes, QA e quality gates |
+| `architect` | Aria | Arquitetura e design tecnico |
+| `project-lead` | Morgan | Product management e epics |
+| `product-lead` | Pax | Validacao de stories e backlog |
+| `sprint-lead` | River | Criacao de stories e sprints |
+| `analyst` | Alex | Pesquisa e analise de negocios |
+| `data-engineer` | Dara | Database design e migrations |
+| `ux-design-expert` | Uma | UX/UI design e experiencia |
+| `devops` | Gage | CI/CD, git push (exclusivo) |
+| `squad-creator` | - | Criacao de novos squads |
 
-### 🔄 Fluxo Principal
+### Workflow de Desenvolvimento
 
 ```
-User Request → Spec Pipeline → Execution Engine → QA Review → Working Code
-                                      ↓
-                              Recovery System
-                                      ↓
-                               Memory Layer
-```
-
-### ⚡ Quick Start ADE
-
-```bash
-# 1. Criar spec a partir de requisito
-@project-lead *gather-requirements
-@architect *assess-complexity
-@analyst *research-deps
-@project-lead *write-spec
-@quality-gate *critique-spec
-
-# 2. Executar spec aprovada
-@architect *create-plan
-@architect *create-context
-@developer *execute-subtask 1.1
-
-# 3. QA Review
-@quality-gate *review-build STORY-42
+@sprint-lead cria story > @product-lead valida > @developer implementa > @quality-gate testa > @devops push
 ```
 
-### 📖 Documentação ADE
-
-- **[Guia Completo do ADE](docs/guides/ade-guide.md)** - Tutorial passo a passo
-- **[Alterações nos Agentes](docs/architecture/ADE-AGENT-CHANGES.md)** - Comandos e capabilities por agente
-- **[Epic 1 - Worktree Manager](docs/architecture/ADE-EPIC1-HANDOFF.md)**
-- **[Epic 2 - Migration V2→V3](docs/architecture/ADE-EPIC2-HANDOFF.md)**
-- **[Epic 3 - Spec Pipeline](docs/architecture/ADE-EPIC3-HANDOFF.md)**
-- **[Epic 4 - Execution Engine](docs/architecture/ADE-EPIC4-HANDOFF.md)**
-- **[Epic 5 - Recovery System](docs/architecture/ADE-EPIC5-HANDOFF.md)**
-- **[Epic 6 - QA Evolution](docs/architecture/ADE-EPIC6-HANDOFF.md)**
-- **[Epic 7 - Memory Layer](docs/architecture/ADE-EPIC7-HANDOFF.md)**
-
-### 🆕 Novos Comandos por Agente
-
-**@devops:**
-
-- `*create-worktree`, `*list-worktrees`, `*merge-worktree`, `*cleanup-worktrees`
-- `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch`
-
-**@pm:**
-
-- `*gather-requirements`, `*write-spec`
-
-**@architect:**
-
-- `*assess-complexity`, `*create-plan`, `*create-context`, `*map-codebase`
-
-**@analyst:**
-
-- `*research-deps`, `*extract-patterns`
+---
 
-**@qa:**
+## Story-Driven Development
 
-- `*critique-spec`, `*review-build`, `*request-fix`, `*verify-fix`
+Todo desenvolvimento no SINAPSE segue stories:
 
-**@dev:**
+1. **Stories em** `docs/stories/` com acceptance criteria claros
+2. **Progresso rastreado** via checkboxes `[ ]` > `[x]`
+3. **File List** mantida atualizada na story
+4. **Quality gates** automaticos antes de merge
 
-- `*execute-subtask`, `*track-attempt`, `*rollback`, `*capture-insights`, `*list-gotchas`, `*apply-qa-fix`
+---
 
-## Criando Seu Próprio Squad
+## Criando Seu Proprio Squad
 
-Squads permitem estender o SINAPSE para qualquer domínio. Estrutura básica:
+Qualquer pessoa pode criar um squad para qualquer dominio:
 
 ```
-squads/seu-squad/
-├── config.yaml           # Configuração do squad
-├── agents/              # Agentes especializados
-├── tasks/               # Fluxos de trabalho de tarefas
-├── templates/           # Templates de documentos
-├── checklists/          # Checklists de validação
-├── data/                # Base de conhecimento
-├── README.md            # Documentação do squad
-└── user-guide.md        # Guia do usuário
+squads/meu-squad/
+  squad.yaml            # Manifesto do squad
+  agents/               # Agentes especializados
+  knowledge-base/       # Base de conhecimento
+  tasks/                # Tasks executaveis
+  workflows/            # Workflows do squad
 ```
 
-Veja o [Guia de Squads](docs/guides/squads-guide.md) para instruções detalhadas.
-
-## Squads Disponíveis
+Use `@squad-creator` ou veja o [Guia de Squads](docs/guides/squads-guide.md).
 
-Squads são equipes modulares de agentes IA. Veja a [Visão Geral de Squads](docs/guides/squads-overview.md) para mais informações.
-
-### Squads Externos
+---
 
-- **[hybrid-ops](https://github.com/SinapseAI/sinapse-hybrid-ops)** - Operações híbridas humano-agente (repositório separado)
+## Configuracao por IDE
 
-## SINAPSE Pro
+| IDE | Status | Ativacao |
+|-----|--------|----------|
+| **Claude Code** | Referencia | `@agent-name` ou `/sinapse` |
+| **Codex CLI** | Primeira classe | `/skills` > `sinapse-<agent>` |
+| **Gemini CLI** | Suportado | `/sinapse-menu` > `/sinapse-<agent>` |
+| **Cursor** | Parcial | Rules + MCP |
+| **GitHub Copilot** | Parcial | Repository instructions + MCP |
 
-O **SINAPSE Pro** (`@sinapse-fullstack/pro`) é o módulo premium do SINAPSE, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.
+Detalhes: `docs/ide-integration.md`
 
-> **Disponibilidade restrita:** O SINAPSE Pro está disponível exclusivamente para membros do **SINAPSE Cohort Advanced**. [Saiba mais sobre o programa](https://sinapsesquad.ai).
+---
 
-### Instalação
+## CLI
 
 ```bash
-npm install @sinapse-fullstack/pro
+npx sinapse-ai init <projeto>      # Criar projeto
+npx sinapse-ai install             # Instalar no projeto atual
+npx sinapse-ai update              # Atualizar
+npx sinapse-ai doctor              # Diagnostico
+npx sinapse-ai doctor --fix        # Corrigir problemas
+npx sinapse-ai info                # Info do sistema
+npx sinapse-ai uninstall           # Remover
 ```
 
-### Features Premium
-
-- **Squads Avançados** - Squads especializados com capacidades expandidas
-- **Memory Layer** - Memória persistente de padrões e insights entre sessões
-- **Métricas & Analytics** - Dashboard de produtividade e métricas de desenvolvimento
-- **Integrações Enterprise** - Conectores para Jira, Linear, Notion e mais
-- **Configuração em Camadas** - Sistema de configuração L1-L4 com herança
-- **Licenciamento** - Gerenciamento de licença via `sinapse pro activate --key <KEY>`
-
-Para mais informações, execute `npx sinapse-ai pro --help` após a instalação.
-
-## Suporte
-
-- 🐛 [Rastreador de Issues](https://github.com/SinapseAI/sinapse-ai/issues) - Bug reports e feature requests
-- 💡 [Processo de Features](docs/FEATURE_PROCESS.md) - Como propor novas funcionalidades
-- 📋 [Como Contribuir](CONTRIBUTING.md)
-- 🗺️ [Roadmap](docs/roadmap.md) - Veja o que estamos construindo
-- 🤖 [Guia de Squads](docs/guides/squads-guide.md) - Crie equipes de agentes IA
-
-## Git Workflow e Validação
-
-O SINAPSE implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:
-
-### 🛡️ Defense in Depth - 3 Camadas de Validação
-
-**Camada 1: Pre-commit (Local - Rápida)**
-
-- ✅ ESLint - Qualidade de código
-- ✅ TypeScript - Verificação de tipos
-- ⚡ Performance: <5s
-- 💾 Cache habilitado
-
-**Camada 2: Pre-push (Local - Validação de Stories)**
-
-- ✅ Validação de checkboxes de histórias
-- ✅ Consistência de status
-- ✅ Seções obrigatórias
-
-**Camada 3: CI/CD (Cloud - Obrigatório para merge)**
-
-- ✅ Todos os testes
-- ✅ Cobertura de testes (80% mínimo)
-- ✅ Validações completas
-- ✅ GitHub Actions
-
-### 📖 Documentação Detalhada
-
-- 📋 **[Guia Completo de Git Workflow](docs/git-workflow-guide.md)** - Guia detalhado do fluxo de trabalho
-- 📋 **[CONTRIBUTING.md](CONTRIBUTING.md)** - Guia de contribuição
+---
 
-### Comandos Disponíveis
+## Qualidade e Validacao
 
 ```bash
-# Validações locais
 npm run lint           # ESLint
 npm run typecheck      # TypeScript
-npm test              # Testes
-npm run test:coverage # Testes com cobertura
-
-# Validador SINAPSE
-node .sinapse-ai/utils/sinapse-validator.js pre-commit   # Validação pre-commit
-node .sinapse-ai/utils/sinapse-validator.js pre-push     # Validação pre-push
-node .sinapse-ai/utils/sinapse-validator.js stories      # Validar todas stories
+npm test               # Testes
+npm run test:coverage  # Cobertura
 ```
 
-### Branch Protection
+Pre-commit e pre-push hooks validam automaticamente.
 
-Configure proteção da branch master com:
+---
 
-```bash
-node scripts/setup-branch-protection.js
-```
+## Documentacao
 
-Requer:
+| Recurso | Link |
+|---------|------|
+| Guia do Usuario | [docs/guides/user-guide.md](docs/guides/user-guide.md) |
+| Arquitetura | [docs/architecture/](docs/architecture/) |
+| Guia de Squads | [docs/guides/squads-guide.md](docs/guides/squads-guide.md) |
+| Primeiros Passos | [docs/getting-started.md](docs/getting-started.md) |
+| Troubleshooting | [docs/troubleshooting.md](docs/troubleshooting.md) |
+| Principios | [docs/GUIDING-PRINCIPLES.md](docs/GUIDING-PRINCIPLES.md) |
 
-- GitHub CLI (gh) instalado e autenticado
-- Acesso de admin ao repositório
+---
 
 ## Contribuindo
 
-**Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads!** 🎉
-
-Para contribuir:
+```bash
+git clone https://github.com/SinapseAI/sinapse-ai.git
+cd sinapse-ai && npm install
+```
 
-1. Fork o repositório
-2. Crie uma branch para sua feature (`git checkout -b feature/MinhaNovaFeature`)
-3. Commit suas mudanças (`git commit -m 'feat: Adicionar nova feature'`)
-4. Push para a branch (`git push origin feature/MinhaNovaFeature`)
+1. Fork o repositorio
+2. Crie sua branch (`git checkout -b feat/minha-feature`)
+3. Commit (`git commit -m 'feat: descricao'`)
+4. Push (`git push origin feat/minha-feature`)
 5. Abra um Pull Request
 
-Veja também:
+Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes.
+
+---
 
-- 📋 [Como Contribuir com Pull Requests](docs/how-to-contribute-with-pull-requests.md)
-- 📋 [Guia de Git Workflow](docs/git-workflow-guide.md)
+## Legal
 
-## 📄 Legal
+| Doc | Link |
+|-----|------|
+| Licenca | [MIT](LICENSE) |
+| Privacidade | [Privacy](docs/legal/privacy.md) |
+| Termos | [Terms](docs/legal/terms.md) |
+| Conduta | [Code of Conduct](CODE_OF_CONDUCT.md) |
+| Seguranca | [Security](docs/security.md) |
 
-| Documento             | English                                     | Português                             |
-| --------------------- | ------------------------------------------- | ------------------------------------- |
-| **Licença**           | [MIT License](LICENSE)                      | -                                     |
-| **Modelo de Licença** | [Core vs Pro](docs/legal/license-clarification.md) | -                               |
-| **Privacidade**       | [Privacy Policy](docs/legal/privacy.md)     | -                                     |
-| **Termos de Uso**     | [Terms of Use](docs/legal/terms.md)         | -                                     |
-| **Código de Conduta** | [Code of Conduct](CODE_OF_CONDUCT.md)       | [PT-BR](docs/pt/code-of-conduct.md)   |
-| **Contribuição**      | [Contributing](CONTRIBUTING.md)             | [PT-BR](docs/pt/contributing.md)      |
-| **Segurança**         | [Security](docs/security.md)                | [PT-BR](docs/pt/security.md)          |
-| **Comunidade**        | [Community](docs/community.md)              | [PT-BR](docs/pt/community.md)         |
-| **Roadmap**           | [Roadmap](docs/roadmap.md)                  | [PT-BR](docs/pt/roadmap.md)           |
-| **Changelog**         | [Version History](CHANGELOG.md)             | -                                     |
+---
 
 ## Contribuidores
 
 [![Contributors](https://contrib.rocks/image?repo=SinapseAI/sinapse-ai)](https://github.com/SinapseAI/sinapse-ai/graphs/contributors)
 
-### 🌟 Contribuidores da Comunidade
-
-<!-- prettier-ignore-start -->
-<!-- Manually maintained — add new community contributors here -->
-<table>
-  <tr>
-    <td align="center"><a href="https://github.com/nikolasdehor"><img src="https://github.com/nikolasdehor.png?size=100" width="100px;" alt="Nikolas de Hor"/><br /><sub><b>Nikolas de Hor</b></sub></a><br />💻🐛⚠️👀</td>
-  </tr>
-</table>
-<!-- prettier-ignore-end -->
-
-<sub>Construído com ❤️ para a comunidade de desenvolvimento assistido por IA</sub>
-
 ---
 
-**[⬆ Voltar ao topo](#sinapse-squad-artificial-intelligence-orchestration-experience)**
+Construido para quem constroi.
+
+**[Voltar ao topo](#sinapse-ai)**