sinapse-ai 1.11.3 → 1.12.1

package/README.md

@@ -13,48 +13,48 @@
 |____/ \___/|_| \_/_/   \_\_|   |____/|_____|
 ```
 
-> **Squads de IA que constroem com voce, nao para voce.**
+> **Squads de IA que constroem com você, não para você.**
 
-[**Portugues**] | [English](README.en.md)
+[**Português**] | [English](README.en.md)
 
 ---
 
-## O que e o SINAPSE?
+## O que é o SINAPSE?
 
-SINAPSE e um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro e governado por uma **Constitution com enforcement real** — 13 hooks ativos que bloqueiam violacoes em tempo de execucao.
+SINAPSE é um meta-framework open source que organiza **172 agentes de IA em 17 squads especializados**, operando direto no terminal via Claude Code ou Codex CLI. Cada agente tem um papel definido, cada squad domina uma disciplina, e o sistema inteiro é governado por uma **Constitution com enforcement real** — 19 hooks ativos que bloqueiam violações em tempo de execução.
 
-O conceito central e simples: em vez de um unico assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasao e conversao. Cada um com sua propria knowledge base, workflows e tasks — totalizando **1.200 tasks executaveis** prontas para uso, distribuidas pelos 17 squads.
+O conceito central é simples: em vez de um único assistente de IA tentando fazer tudo, o SINAPSE estrutura o trabalho em equipes especializadas. Um squad de branding cuida da identidade visual. Um squad de cybersecurity cuida de compliance e pentest. Um squad de copywriting cuida de persuasão e conversão. Cada um com sua própria knowledge base, workflows e tasks — totalizando **1.200 tasks executáveis** prontas para uso, distribuídas pelos 17 squads.
 
-Diferente de ferramentas que apenas conversam com IA, o SINAPSE impoe disciplina. O pipeline **Documentation-First** exige que uma story seja criada e validada antes de qualquer linha de codigo. Quality gates rodam automaticamente antes de merge. Agentes nao autorizados sao bloqueados de fazer push. Tudo isso via hooks que interceptam operacoes em tempo real — nao depois.
+Diferente de ferramentas que apenas conversam com IA, o SINAPSE impõe disciplina. O pipeline **Documentation-First** exige que uma story seja criada e validada antes de qualquer linha de código. Quality gates rodam automaticamente antes de merge. Agentes não autorizados são bloqueados de fazer push. Tudo isso via hooks que interceptam operações em tempo real — não depois.
 
 ---
 
-## Por que SINAPSE existe?
+## Por que o SINAPSE existe?
 
-IA generativa tem um problema conhecido: quanto mais voce pede, pior fica. Um unico assistente tentando fazer tudo — codigo, copy, branding, testes, deploy — perde contexto, inventa features e sofre de context amnesia depois de poucas iteracoes longas.
+IA generativa tem um problema conhecido: quanto mais você pede, pior fica. Um único assistente tentando fazer tudo — código, copy, branding, testes, deploy — perde contexto, inventa features e sofre de context amnesia depois de poucas iterações longas.
 
-SINAPSE resolve isso do jeito que times humanos resolvem: **especializacao coordenada**. Em vez de um generalista cansado, voce tem 172 agentes em 17 squads, cada um com papel definido, knowledge base propria e tasks executaveis. Um orquestrador roteia seu pedido para quem realmente sabe resolver — automaticamente, sem voce precisar decorar agent names ou comandos.
+O SINAPSE resolve isso do jeito que times humanos resolvem: **especialização coordenada**. Em vez de um generalista cansado, você tem 172 agentes em 17 squads, cada um com papel definido, knowledge base própria e tasks executáveis. Um orquestrador roteia seu pedido para quem realmente sabe resolver — automaticamente, sem você precisar decorar nomes de agentes ou comandos.
 
-O diferencial nao e apenas quantidade de agentes. E **governanca real**: 13 hooks ativos interceptam operacoes em tempo de execucao, uma Constitution com 11 artigos rege o framework, e 7 desses artigos sao NON-NEGOTIABLE — violacoes sao bloqueadas antes de executar, nao detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
+O diferencial não é apenas a quantidade de agentes. É **governança real**: 19 hooks ativos interceptam operações em tempo de execução, uma Constitution com 11 artigos rege o framework, e 7 desses artigos são NON-NEGOTIABLE — violações são bloqueadas antes de executar, não detectadas depois. **Velocidade com rigor, sem escolher entre os dois.**
 
 ---
 
 <!-- BEGIN GROUNDING (Story 10.47) -->
-## Grounding semantico (opt-in, foundation pre-GA)
+## Grounding semântico (opt-in, foundation pré-GA)
 
-Frameworks de agente assumem que o LLM ja sabe o que importa no seu projeto. SINAPSE-AI inverte: oferece **tres canais opcionais** para ancorar o agente no seu contexto real — vault de notas, design system, brandbook. Configuracao zero-overhead agora; injecao semantica completa entra nas proximas releases da linha 1.x.
+Frameworks de agente assumem que o LLM já sabe o que importa no seu projeto. O SINAPSE-AI inverte: oferece **três canais opcionais** para ancorar o agente no seu contexto real — vault de notas, design system, brandbook. Configuração zero-overhead agora; injeção semântica completa entra nas próximas releases da linha 1.x.
 
-| Canal | Funcao na release atual | Injecao semantica |
+| Canal | Função na release atual | Injeção semântica |
 |-------|------------------------|-------------------|
-| **Vault** | Detecta `~/.claude/sinapse-ai-config.yaml`, valida schema e expoe o path do seu vault aos hooks shipados | Roadmap — proxima minor 1.x |
-| **Design System** | Mesma foundation: detecta DS configurado, expoe path. Quando ausente, agentes seguem defaults de alta qualidade | Roadmap — proxima minor 1.x |
-| **Brand** | Mesma foundation: detecta brandbook, expoe path. Quando ausente, agentes seguem tom neutro | Roadmap — proxima minor 1.x |
+| **Vault** | Detecta `~/.claude/sinapse-ai-config.yaml`, valida schema e expõe o path do seu vault aos hooks shipados | Roadmap — próxima minor 1.x |
+| **Design System** | Mesma foundation: detecta DS configurado, expõe path. Quando ausente, agentes seguem defaults de alta qualidade | Roadmap — próxima minor 1.x |
+| **Brand** | Mesma foundation: detecta brandbook, expõe path. Quando ausente, agentes seguem tom neutro | Roadmap — próxima minor 1.x |
 
-**Por que configurar agora:** os 3 hooks ja sao shipados zero-overhead — sem config, `no-op` completo, zero ruido. Voce define os paths uma vez via `npx sinapse-ai install`, e quando a injecao semantica entrar, ativa automaticamente. Nada de reconfigurar, nada de migrar.
+**Por que configurar agora:** os 3 hooks já são shipados zero-overhead — sem config, `no-op` completo, zero ruído. Você define os paths uma vez via `npx sinapse-ai install`, e quando a injeção semântica entrar, ativa automaticamente. Nada de reconfigurar, nada de migrar.
 
-**Por que isso e diferencial:** outros frameworks de agente acoplam grounding ao runtime do framework (te forcam a entrar no ecossistema deles). SINAPSE-AI mantem grounding como **camada opt-in declarativa** — voce escolhe quando e o que ativar, em arquivo proprio, sem lock-in.
+**Por que isso é diferencial:** outros frameworks de agente acoplam o grounding ao runtime do framework (te forçam a entrar no ecossistema deles). O SINAPSE-AI mantém o grounding como **camada opt-in declarativa** — você escolhe quando e o que ativar, em arquivo próprio, sem lock-in.
 
-Configuracao detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding-setup.md).
+Configuração detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding-setup.md).
 <!-- END GROUNDING (Story 10.47) -->
 
 ---
@@ -67,7 +67,7 @@ Configuracao detalhada: [`docs/guides/grounding-setup.md`](docs/guides/grounding
 npx sinapse-ai install
 ```
 
-O wizard detecta seu ambiente, escolhe a IDE (Claude Code ou Codex), e instala os 17 squads automaticamente. Re-rodar o comando faz upsert idempotente — preserva suas customizacoes e so atualiza o que mudou.
+O wizard detecta seu ambiente, escolhe a IDE (Claude Code ou Codex) e instala os 17 squads automaticamente. Re-rodar o comando faz upsert idempotente — preserva suas customizações e só atualiza o que mudou.
 
 ### 2. Verifique
 
@@ -82,76 +82,76 @@ Se algo estiver fora do lugar, `doctor --fix` corrige automaticamente.
 
 ```
 @developer          # Ativa o agente de desenvolvimento
-*help               # Lista comandos disponiveis
+*help               # Lista comandos disponíveis
 ```
 
-Pronto. Voce tem 17 squads operando no seu terminal.
+Pronto. Você tem 17 squads operando no seu terminal.
 
-> **Nota sobre `npm install`:** A partir da v10.0.0-rc.4, o SINAPSE roda um postinstall automatico que sincroniza agents para o Claude Code, cria os diretorios de runtime (`.sinapse/handoffs/`, `.sinapse/scratchpad/`) e executa um health check rapido. Para desabilitar (CI, pipelines avancadas), defina `SINAPSE_SKIP_POSTINSTALL=1` antes do `npm install`, ou rode `npm install --ignore-scripts` (comportamento nativo do npm — nenhum postinstall eh executado). Nesse caso, rode `sinapse doctor --fix` apos a instalacao para garantir que o ambiente esteja pronto.
+> **Nota sobre `npm install`:** A partir da v10.0.0-rc.4, o SINAPSE roda um postinstall automático que sincroniza agents para o Claude Code, cria os diretórios de runtime (`.sinapse/handoffs/`, `.sinapse/scratchpad/`) e executa um health check rápido. Para desabilitar (CI, pipelines avançadas), defina `SINAPSE_SKIP_POSTINSTALL=1` antes do `npm install`, ou rode `npm install --ignore-scripts` (comportamento nativo do npm — nenhum postinstall é executado). Nesse caso, rode `sinapse doctor --fix` após a instalação para garantir que o ambiente esteja pronto.
 
 ---
 
 ## Por que instalar em cada projeto?
 
-Toda primeira instalacao levanta objecoes. Todas legitimas. Respondidas aqui, no espirito da cultura SINAPSE — direto, sem defensivo.
+Toda primeira instalação levanta objeções. Todas legítimas. Respondidas aqui, no espírito da cultura SINAPSE — direto, sem defensivo.
 
-### "Vou ter multiplas copias no computador. Nao e desperdicio?"
+### "Vou ter múltiplas cópias no computador. Não é desperdício?"
 
-Nao. Cada projeto tem seu proprio `.sinapse-ai/` — assim como tem seu proprio `package.json` ou `node_modules/`. E isso **nao e desperdicio, e isolamento**.
+Não. Cada projeto tem seu próprio `.sinapse-ai/` — assim como tem seu próprio `package.json` ou `node_modules/`. E isso **não é desperdício, é isolamento**.
 
-Tamanho real: `.sinapse-ai/` pesa ~500KB. Vinte projetos = 10MB. Menor que um unico `node_modules/` de um projeto Next.js tipico (300MB+). O custo de espaco e marginal. O ganho de isolamento e essencial.
+Tamanho real: `.sinapse-ai/` pesa ~500KB. Vinte projetos = 10MB. Menor que um único `node_modules/` de um projeto Next.js típico (300MB+). O custo de espaço é marginal. O ganho de isolamento é essencial.
 
-### "Por que nao instalar uma vez global e pronto?"
+### "Por que não instalar uma vez global e pronto?"
 
-Porque projetos open source precisam ser **auto-contidos**. Quando voce compartilha um projeto (ou alguem clona o seu), o framework precisa viajar junto.
+Porque projetos open source precisam ser **autocontidos**. Quando você compartilha um projeto (ou alguém clona o seu), o framework precisa viajar junto.
 
-**Com instalacao local:** `git clone` e pronto. Framework, rules, agentes, Constitution, contexto — tudo ja vem no projeto. Qualquer pessoa, qualquer maquina, qualquer horario: funciona igual.
+**Com instalação local:** `git clone` e pronto. Framework, rules, agentes, Constitution, contexto — tudo já vem no projeto. Qualquer pessoa, qualquer máquina, qualquer horário: funciona igual.
 
-**Com instalacao global:** quem clona o projeto precisa instalar SINAPSE separado, garantir a mesma versao, copiar rules manualmente, torcer pra nao ter drift entre maquinas. Open source morre assim.
+**Com instalação global:** quem clona o projeto precisa instalar o SINAPSE separado, garantir a mesma versão, copiar rules manualmente, torcer pra não ter drift entre máquinas. Open source morre assim.
 
-### "Qual a diferenca real entre global e local?"
+### "Qual a diferença real entre global e local?"
 
 | Aspecto | Global | Local (recomendado) |
 |---------|:------:|:-------------------:|
-| Espaco em disco | Menor (1 copia) | Maior (~500KB/projeto) |
-| Versionamento per-project | Nao | Sim |
-| Clone e funcionando | Nao | Sim |
-| Rules customizadas por projeto | Nao | Sim |
-| Colaboracao em time | Quebrada | Perfeita |
-| Atualizar sem quebrar outros projetos | Nao | Sim |
-| Open source compativel | Nao | Sim |
+| Espaço em disco | Menor (1 cópia) | Maior (~500KB/projeto) |
+| Versionamento per-project | Não | Sim |
+| Clone e funcionando | Não | Sim |
+| Rules customizadas por projeto | Não | Sim |
+| Colaboração em time | Quebrada | Perfeita |
+| Atualizar sem quebrar outros projetos | Não | Sim |
+| Open source compatível | Não | Sim |
 
 ### "Funciona no Windows?"
 
-Sim. Testado em Windows 11, macOS e Linux. O instalador detecta o OS automaticamente. WSL nao e obrigatorio (mas recomendado para algumas features avancadas como review automatizado via CodeRabbit).
+Sim. Testado em Windows 11, macOS e Linux. O instalador detecta o OS automaticamente. WSL não é obrigatório (mas recomendado para algumas features avançadas como review automatizado via CodeRabbit).
 
 ### Matriz de plataformas suportadas
 
-Cada release passa por uma matriz de instalacao de 27 combinacoes (3 OSes x 3 package managers x 3 metodos) executada em CI. A tabela abaixo resume os caminhos oficialmente suportados:
+Cada release passa por uma matriz de instalação de 27 combinações (3 OSes × 3 package managers × 3 métodos) executada em CI. A tabela abaixo resume os caminhos oficialmente suportados:
 
 | OS | npm | pnpm | Yarn v2+ (Berry) | Yarn v1 (Classic) |
 |----|:---:|:----:|:----------------:|:-----------------:|
-| Windows 11 | Sim | Sim | Sim | **Nao** |
+| Windows 11 | Sim | Sim | Sim | **Não** |
 | macOS (latest) | Sim | Sim | Sim | Sim |
 | Linux (Ubuntu 22.04) | Sim | Sim | Sim | Sim |
 
-**Sobre Yarn v1 no Windows:** Yarn v1 (Classic) esta em modo manutencao desde 2020, com Yarn v2+ (Berry) como sucessor oficial. A combinacao Windows + Yarn v1 apresenta falhas de resolucao de wrapper que nao compensam investigar por ser ecossistema em declinio. Usuarios Windows em Yarn v1 devem migrar para Yarn v2+ (recomendado) ou usar npm/pnpm. macOS e Linux em Yarn v1 continuam suportados.
+**Sobre Yarn v1 no Windows:** Yarn v1 (Classic) está em modo manutenção desde 2020, com Yarn v2+ (Berry) como sucessor oficial. A combinação Windows + Yarn v1 apresenta falhas de resolução de wrapper que não compensam investigar por ser ecossistema em declínio. Usuários Windows em Yarn v1 devem migrar para Yarn v2+ (recomendado) ou usar npm/pnpm. macOS e Linux em Yarn v1 continuam suportados.
 
-### "Como atualizar sem perder minhas customizacoes?"
+### "Como atualizar sem perder minhas customizações?"
 
 ```bash
 npx sinapse-ai update
 ```
 
-O update e **idempotente por design**. L1 (framework core) e L2 (templates) sao atualizados. L3 (configuracao) e L4 (suas stories, packages, customizacoes) **nunca sao tocados**. Voce pode rodar `update` quantas vezes quiser, inclusive apos customizar rules localmente. Nada se perde.
+O update é **idempotente por design**. L1 (framework core) e L2 (templates) são atualizados. L3 (configuração) e L4 (suas stories, packages, customizações) **nunca são tocados**. Você pode rodar `update` quantas vezes quiser, inclusive após customizar rules localmente. Nada se perde.
 
 ### TL;DR
 
-Instalacao local = um pouco mais de disco, muito mais robustez.
+Instalação local = um pouco mais de disco, muito mais robustez.
 
-Se voce trabalha sozinho e nunca compartilha projetos, global ate funciona — mas assim que voce entra em time, publica open source ou precisa de multiplas versoes em paralelo, local vira imprescindivel.
+Se você trabalha sozinho e nunca compartilha projetos, global até funciona — mas assim que você entra em time, publica open source ou precisa de múltiplas versões em paralelo, local vira imprescindível.
 
-O SINAPSE otimiza para o caso generico: **seu projeto deve funcionar para qualquer pessoa que clone ele, em qualquer maquina, a qualquer hora**.
+O SINAPSE otimiza para o caso genérico: **seu projeto deve funcionar para qualquer pessoa que clone ele, em qualquer máquina, a qualquer hora**.
 
 ---
 
@@ -163,32 +163,32 @@ O SINAPSE otimiza para o caso generico: **seu projeto deve funcionar para qualqu
 CLI First  >  Observability Second  >  UI Third
 ```
 
-Toda inteligencia vive no terminal. Dashboards observam. A UI nunca e requisito para operar o sistema. Esse e o Artigo I da Constitution — inegociavel.
+Toda inteligência vive no terminal. Dashboards observam. A UI nunca é requisito para operar o sistema. Esse é o Artigo I da Constitution — inegociável.
 
 ### Modelo de 4 Camadas
 
-O SINAPSE separa artefatos do framework e do projeto em 4 camadas com protecao automatica:
+O SINAPSE separa artefatos do framework e do projeto em 4 camadas com proteção automática:
 
 ```mermaid
 graph TB
-    subgraph L4["L4 - PROJETO (sempre mutavel)"]
+    subgraph L4["L4 - PROJETO (sempre mutável)"]
         L4A[Stories]
         L4B[Packages]
         L4C[Squads]
         L4D[Tests]
     end
-    subgraph L3["L3 - CONFIGURACAO (com restricoes)"]
+    subgraph L3["L3 - CONFIGURACAO (com restrições)"]
         L3A[Entity Registry]
         L3B[Agent Memory]
         L3C[Config files]
     end
-    subgraph L2["L2 - TEMPLATES (imutavel)"]
+    subgraph L2["L2 - TEMPLATES (imutável)"]
         L2A[Tasks]
         L2B[Templates]
         L2C[Checklists]
         L2D[Workflows]
     end
-    subgraph L1["L1 - FRAMEWORK CORE (imutavel)"]
+    subgraph L1["L1 - FRAMEWORK CORE (imutável)"]
         L1A[.sinapse-ai/core]
         L1B[bin/]
         L1C[Constitution]
@@ -202,20 +202,20 @@ graph TB
     style L4 fill:#1e293b,stroke:#10b981,color:#fff
 ```
 
-| Camada | Mutabilidade | Conteudo |
+| Camada | Mutabilidade | Conteúdo |
 |--------|-------------|----------|
 | **L1** Framework Core | Nunca | `.sinapse-ai/core/`, `bin/`, Constitution |
 | **L2** Templates | Nunca | Tasks, templates, checklists, workflows |
-| **L3** Configuracao | Com restricoes | Entity registry, agent memory, config |
+| **L3** Configuração | Com restrições | Entity registry, agent memory, config |
 | **L4** Projeto | Sempre | Stories, packages, squads, testes |
 
-Deny rules em `.claude/settings.json` reforcam isso deterministicamente. **Update do framework atualiza L1+L2, nunca L3+L4** — suas customizacoes sao preservadas.
+Deny rules em `.claude/settings.json` reforçam isso deterministicamente. **O update do framework atualiza L1+L2, nunca L3+L4** — suas customizações são preservadas.
 
 ### Constitution
 
-O SINAPSE e governado por uma Constitution formal com 11 artigos e 13 hooks de enforcement:
+O SINAPSE é governado por uma Constitution formal com 11 artigos e 19 hooks de enforcement:
 
-| Artigo | Principio | Severidade |
+| Artigo | Princípio | Severidade |
 |--------|-----------|------------|
 | I | CLI First | NON-NEGOTIABLE |
 | II | Agent Authority | NON-NEGOTIABLE |
@@ -229,7 +229,7 @@ O SINAPSE e governado por uma Constitution formal com 11 artigos e 13 hooks de e
 | X | Security & Data Protection | NON-NEGOTIABLE |
 | XI | Conservative Default | MUST |
 
-7 artigos sao NON-NEGOTIABLE — violacoes sao bloqueadas automaticamente antes de executar.
+7 artigos são NON-NEGOTIABLE — violações são bloqueadas automaticamente antes de executar.
 
 ---
 
@@ -239,18 +239,18 @@ O SINAPSE inclui 12 agentes core que cobrem o ciclo completo de desenvolvimento:
 
 | Agente | Persona | Papel |
 |--------|---------|-------|
-| `sinapse-orqx` | **Imperator** | Orquestrador principal — routing e coordenacao cross-squad |
-| `developer` | **Pixel** | Implementacao de codigo e story development |
+| `sinapse-orqx` | **Imperator** | Orquestrador principal — routing e coordenação cross-squad |
+| `developer` | **Pixel** | Implementação de código e story development |
 | `quality-gate` | **Litmus** | Testes, QA e quality gates |
-| `architect` | **Stratum** | Arquitetura e decisoes de tecnologia |
+| `architect` | **Stratum** | Arquitetura e decisões de tecnologia |
 | `project-lead` | **Beacon** | Product management e epics |
-| `product-lead` | **Axis** | Validacao de stories e priorizacao |
-| `sprint-lead` | **Sync** | Criacao de stories e sprints |
-| `analyst` | **Scope** | Pesquisa e analise de negocios |
+| `product-lead` | **Axis** | Validação de stories e priorização |
+| `sprint-lead` | **Sync** | Criação de stories e sprints |
+| `analyst` | **Scope** | Pesquisa e análise de negócios |
 | `data-engineer` | **Tensor** | Database design, migrations e RLS |
 | `ux-design-expert` | **Mosaic** | UX/UI design |
 | `devops` | **Pipeline** | CI/CD, git push (exclusivo), releases |
-| `squad-creator` | **Loom** | Criacao de novos squads |
+| `squad-creator` | **Loom** | Criação de novos squads |
 
 Ative qualquer agente com `@agent-name` e use `*help` para ver seus comandos.
 
@@ -274,37 +274,37 @@ flowchart LR
     style F fill:#1e293b,stroke:#ef4444,color:#fff
 ```
 
-O framework garante que nenhuma etapa seja pulada. Cada gate bloqueia automaticamente se a anterior nao foi cumprida.
+O framework garante que nenhuma etapa seja pulada. Cada gate bloqueia automaticamente se a anterior não foi cumprida.
 
 ---
 
 ## 17 Squads Especializados
 
-Cada squad e uma equipe autonoma com orquestrador, agentes especialistas, knowledge base, tasks e workflows proprios.
+Cada squad é uma equipe autônoma com orquestrador, agentes especialistas, knowledge base, tasks e workflows próprios.
 
-| Squad | Dominio | Agentes |
+| Squad | Domínio | Agentes |
 |-------|---------|---------|
-| **squad-brand** | Estrategia de marca, arquetipos, auditoria visual | 15 |
+| **squad-brand** | Estratégia de marca, arquétipos, auditoria visual | 15 |
 | **squad-design** | Design systems, componentes, tokens, UI, art direction, LP premium | 14 |
-| **squad-copy** | Copywriting persuasivo, headlines, conversao | 13 |
-| **squad-council** | Advisors estrategicos (Munger, Dalio, Thiel, ...) | 11 |
-| **squad-storytelling** | Narrativa, roteiros, frameworks de historia | 10 |
+| **squad-copy** | Copywriting persuasivo, headlines, conversão | 13 |
+| **squad-council** | Advisors estratégicos (Munger, Dalio, Thiel, ...) | 11 |
+| **squad-storytelling** | Narrativa, roteiros, frameworks de história | 10 |
 | **squad-commercial** | Vendas, funil, revenue, pipeline comercial | 10 |
-| **squad-paidmedia** | Meta Ads, Google Ads, campanhas, otimizacao | 9 |
-| **squad-animations** | Motion design, CSS, particulas, 3D | 9 |
+| **squad-paidmedia** | Meta Ads, Google Ads, campanhas, otimização | 9 |
+| **squad-animations** | Motion design, CSS, partículas, 3D | 9 |
 | **squad-cloning** | Clonagem cognitiva, mind synthesis, digital twins | 9 |
 | **squad-cybersecurity** | Threat intel, pentest, compliance, LGPD | 8 |
-| **squad-courses** | Cursos, curriculos, assessments, launch educacional | 8 |
-| **squad-research** | Market analysis, inteligencia competitiva | 7 |
-| **claude-code-mastery** | Claude Code avancado, MCP, integracao profunda | 8 |
-| **squad-content** | Governanca editorial, estrategia de conteudo | 7 |
-| **squad-product** | Product discovery, estrategia, operacoes | 7 |
+| **squad-courses** | Cursos, currículos, assessments, launch educacional | 8 |
+| **squad-research** | Market analysis, inteligência competitiva | 7 |
+| **claude-code-mastery** | Claude Code avançado, MCP, integração profunda | 8 |
+| **squad-content** | Governança editorial, estratégia de conteúdo | 7 |
+| **squad-product** | Product discovery, estratégia, operações | 7 |
 | **squad-growth** | Analytics, CRO, SEO, growth hacking | 7 |
 | **squad-finance** | Budget, pricing, profitability analysis | 8 |
 
 **Total: 17 squads, 172 agentes especializados, 1.200 tasks**
 
-Cada squad e ativado via seu orquestrador:
+Cada squad é ativado via seu orquestrador:
 
 ```
 @brand-orqx         # Squad de brand
@@ -319,75 +319,75 @@ O orquestrador recebe seu pedido e delega automaticamente ao especialista corret
 
 ## IDE Support
 
-O SINAPSE suporta duas IDEs com integracoes profundas:
+O SINAPSE suporta duas IDEs com integrações profundas:
 
-| IDE | Ativacao | Destaques |
+| IDE | Ativação | Destaques |
 |-----|----------|-----------|
 | **Claude Code** | `@agent-name` | Hooks, rules contextuais, deny/allow, Chrome Brain |
 | **Codex CLI** | `/skills` ou `$skill-name` | Skills nativas, multi-model, `codex exec` para CI/CD |
 
-Ambas as IDEs tem acesso a todos os 17 squads, 172 agentes, workflows e knowledge bases. O installer detecta e configura automaticamente.
+Ambas as IDEs têm acesso a todos os 17 squads, 172 agentes, workflows e knowledge bases. O installer detecta e configura automaticamente.
 
 ### Tabela de Paridade
 
 | Funcionalidade | Claude Code | Codex CLI |
 |---------------|:-----------:|:---------:|
-| Ativacao de agentes (@agent) | Completo | Completo |
+| Ativação de agentes (@agent) | Completo | Completo |
 | Hooks constitucionais (19) | Completo | Parcial (5) |
 | Story-driven development | Completo | Completo |
 | Quality gates | Completo | Completo |
-| Enforcement de delegacao | Completo | Parcial |
+| Enforcement de delegação | Completo | Parcial |
 | Secret scanning | Completo | Manual |
-| Integracao CodeRabbit | Completo | N/A |
+| Integração CodeRabbit | Completo | N/A |
 | Sistema de skills | Completo | Comandos |
 | MCP servers | Completo | N/A |
 | Terminal Bus | Completo | N/A |
 
-**Claude Code** para a experiencia mais integrada e automatizada.
-**Codex CLI** para flexibilidade de modelo e automacao CI/CD.
+**Claude Code** para a experiência mais integrada e automatizada.
+**Codex CLI** para flexibilidade de modelo e automação CI/CD.
 
 ---
 
-## Para quem e o SINAPSE?
+## Para quem é o SINAPSE?
 
-O SINAPSE nao e para todo mundo. Ele e opinativo, rigoroso e exige disciplina. Mas para quem precisa de velocidade **com rigor**, ele transforma IA generativa de brinquedo em infraestrutura real.
+O SINAPSE não é para todo mundo. Ele é opinativo, rigoroso e exige disciplina. Mas para quem precisa de velocidade **com rigor**, ele transforma IA generativa de brinquedo em infraestrutura real.
 
 ### Ideal para
 
-- **Founders tecnicos** que constroem SaaS sozinho ou em times pequenos e precisam operar como um time grande
-- **Consultores e agencias** que entregam projetos completos (brand + copy + dev + deploy) e precisam de qualidade consistente entre clientes
-- **Teams de produto** que querem eliminar inconsistencia entre requisitos, design, implementacao e QA
+- **Founders técnicos** que constroem SaaS sozinho ou em times pequenos e precisam operar como um time grande
+- **Consultores e agências** que entregam projetos completos (brand + copy + dev + deploy) e precisam de qualidade consistente entre clientes
+- **Teams de produto** que querem eliminar inconsistência entre requisitos, design, implementação e QA
 - **Educadores** que ensinam IA aplicada e precisam de um framework real para demonstrar em aula
-- **Builders independentes** que tratam IA como infraestrutura, nao como brinquedo
+- **Builders independentes** que tratam IA como infraestrutura, não como brinquedo
 
-### Nao e para
+### Não é para
 
 - Projetos one-shot sem continuidade ou disciplina processual
-- Equipes que preferem flexibilidade total sobre governanca
-- Usuarios que esperam "IA magica" sem metodologia
+- Equipes que preferem flexibilidade total sobre governança
+- Usuários que esperam "IA mágica" sem metodologia
 
-Se voce se identifica com o primeiro grupo, voce esta no lugar certo.
+Se você se identifica com o primeiro grupo, você está no lugar certo.
 
 ---
 
-## Qualidade e Seguranca
+## Qualidade e Segurança
 
 ### Enforcement Constitucional
 
-O SINAPSE nao apenas documenta regras — ele as impoe com **13 hooks ativos**:
+O SINAPSE não apenas documenta regras — ele as impõe com **19 hooks ativos**:
 
-- `enforce-git-push-authority.sh` — bloqueia push por agentes nao autorizados
-- `enforce-story-gate.cjs` — bloqueia codigo sem story validada
+- `enforce-git-push-authority.sh` — bloqueia push por agentes não autorizados
+- `enforce-story-gate.cjs` — bloqueia código sem story validada
 - `sql-governance.py` — bloqueia SQL perigoso (injection patterns)
-- `enforce-delegation.cjs` — bloqueia orquestradores executando trabalho de dominio
-- `enforce-architecture-first.cjs` — bloqueia codigo em paths protegidos sem documentacao
+- `enforce-delegation.cjs` — bloqueia orquestradores executando trabalho de domínio
+- `enforce-architecture-first.cjs` — bloqueia código em paths protegidos sem documentação
 
 ### 25 Deployment Blockers (3 Tiers)
 
-Nenhum projeto vai para producao sem passar por todos:
+Nenhum projeto vai para produção sem passar por todos:
 
 - **Tier 1** — 10 blockers absolutos: RLS, zero hardcoded keys, service_role protegido, MFA, APIs autenticadas, SQL parametrizado
-- **Tier 2** — 7 blockers de compliance: DPO, consentimento, direitos do titular, notificacao de breach (LGPD)
+- **Tier 2** — 7 blockers de compliance: DPO, consentimento, direitos do titular, notificação de breach (LGPD)
 - **Tier 3** — 8 blockers operacionais: logging, backup, vulnerability scanning, incident response
 
 ### Quality Gates
@@ -399,11 +399,11 @@ npm test               # Testes
 npm run test:coverage  # Cobertura
 ```
 
-Pre-commit e pre-push hooks validam automaticamente antes de cada operacao.
+Pre-commit e pre-push hooks validam automaticamente antes de cada operação.
 
 ---
 
-## Documentacao
+## Documentação
 
 | Recurso | Link |
 |---------|------|
@@ -412,36 +412,36 @@ Pre-commit e pre-push hooks validam automaticamente antes de cada operacao.
 | Erros do CLI (troubleshooting) | [docs/guides/cli-errors.md](docs/guides/cli-errors.md) |
 | Arquitetura | [docs/framework/core-architecture.md](docs/framework/core-architecture.md) |
 | Guia de Squads | [docs/guides/squads-guide.md](docs/guides/squads-guide.md) |
-| Referencia de Agentes | [docs/guides/agent-reference.md](docs/guides/agent-reference.md) |
+| Referência de Agentes | [docs/guides/agent-reference.md](docs/guides/agent-reference.md) |
 | Workflows | [docs/guides/workflows-guide.md](docs/guides/workflows-guide.md) |
-| Seguranca | [SECURITY.md](SECURITY.md) |
-| Contribuicao | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Segurança | [SECURITY.md](SECURITY.md) |
+| Contribuição | [CONTRIBUTING.md](CONTRIBUTING.md) |
 
 ---
 
 ## CLI Reference
 
-A superficie publica e proposital — quatro comandos canonicos de lifecycle, dois diagnosticos, um sub-comando avancado.
+A superfície pública é proposital — quatro comandos canônicos de lifecycle, dois diagnósticos, um sub-comando avançado.
 
 ```bash
 # Lifecycle
-npx sinapse-ai install           # Instala (idempotente — re-runs sao upserts)
+npx sinapse-ai install           # Instala (idempotente — re-runs são upserts)
 npx sinapse-ai install --force   # Reinstala do zero, ignorando estado existente
-npx sinapse-ai update            # Atualiza para a versao mais recente
+npx sinapse-ai update            # Atualiza para a versão mais recente
 npx sinapse-ai uninstall         # Remove o framework do projeto
 
-# Diagnostico
-npx sinapse-ai status            # Estado da instalacao + lista de squads
+# Diagnóstico
+npx sinapse-ai status            # Estado da instalação + lista de squads
 npx sinapse-ai doctor            # 12 health checks contra o ambiente
 npx sinapse-ai doctor --fix      # Auto-corrige problemas detectados
-npx sinapse-ai doctor --json     # Saida machine-readable para CI
+npx sinapse-ai doctor --json     # Saída machine-readable para CI
 npx sinapse-ai doctor --dry-run  # Mostra o que `--fix` faria sem aplicar
 
-# Avancado
+# Avançado
 npx sinapse-ai chrome-brain install   # Instala browser automation
 ```
 
-Todos os comandos sao seguros para re-rodar. Para listar agentes ativos depois de instalar, abra Claude Code ou Codex CLI e digite `@` para autocompletar.
+Todos os comandos são seguros para re-rodar. Para listar agentes ativos depois de instalar, abra o Claude Code ou o Codex CLI e digite `@` para autocompletar.
 
 ---
 
@@ -452,9 +452,9 @@ git clone https://github.com/caioimori/sinapse-ai.git
 cd sinapse-ai && npm install
 ```
 
-1. Fork o repositorio
+1. Faça um fork do repositório
 2. Crie sua branch (`git checkout -b feat/minha-feature`)
-3. Commit (`git commit -m 'feat: descricao'`)
+3. Commit (`git commit -m 'feat: descrição'`)
 4. Push (`git push origin feat/minha-feature`)
 5. Abra um Pull Request
 
@@ -466,10 +466,10 @@ Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes completos.
 
 | Documento | Link |
 |-----------|------|
-| Licenca | [MIT](LICENSE) |
-| Seguranca | [SECURITY.md](SECURITY.md) |
-| Codigo de Conduta | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
-| Contribuicao | [CONTRIBUTING.md](CONTRIBUTING.md) |
+| Licença | [MIT](LICENSE) |
+| Segurança | [SECURITY.md](SECURITY.md) |
+| Código de Conduta | [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md) |
+| Contribuição | [CONTRIBUTING.md](CONTRIBUTING.md) |
 
 ---
 
@@ -480,18 +480,18 @@ Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes completos.
 
 ---
 
-## Pronto para comecar?
+## Pronto para começar?
 
 ```bash
 npx sinapse-ai install
 ```
 
-Um comando. 17 squads. 172 agentes. Governanca constitucional. Tudo operando direto no terminal.
+Um comando. 17 squads. 172 agentes. Governança constitucional. Tudo operando direto no terminal.
 
-**[Documentacao completa](docs/guides/getting-started.md)** • **[Reportar issue](https://github.com/caioimori/sinapse-ai/issues)** • **[Discussions](https://github.com/caioimori/sinapse-ai/discussions)**
+**[Documentação completa](docs/guides/getting-started.md)** • **[Reportar issue](https://github.com/caioimori/sinapse-ai/issues)** • **[Discussions](https://github.com/caioimori/sinapse-ai/discussions)**
 
 ---
 
-**Construido para quem constroi. Governado por uma Constitution. Operando 100% no terminal.**
+**Construído para quem constrói. Governado por uma Constitution. Operando 100% no terminal.**
 
-**[Voltar ao topo](#sinapse-ai)**
+**[Voltar ao topo](#o-que-é-o-sinapse)**

package/bin/commands/doctor.js

@@ -33,7 +33,7 @@ Exit codes (Story A.3):
   }
 
   const doctorModulePath = path.join(__dirname, '..', '..', '.sinapse-ai', 'core', 'doctor');
-  // eslint-disable-next-line global-require
+   
   const { runDoctorChecks, resolveExitCode } = require(doctorModulePath);
   const result = await runDoctorChecks({
     fix: Boolean(opts.fix),

package/bin/commands/help.js

@@ -31,10 +31,9 @@ function cmdHelp() {
   logger.always(`  ${CYAN}sinapse --continue${NC}           Continua última sessão`);
   logger.always('');
   logger.always(`${BOLD}Agents:${NC}\n`);
-  logger.always(`  Invocação canônica:  ${CYAN}/SNPS:agents:{agent-id}${NC}`);
-  logger.always(`  Exemplo:             ${CYAN}/SNPS:agents:brand-orqx${NC}`);
-  logger.always(`  Master orchestrator: ${CYAN}@snps-orqx${NC} (alias: ${DIM}@sinapse-orqx${NC})`);
-  logger.always(`  ${DIM}Alias /SINAPSE:agents:* preservado até v1.3.0 (deprecação suave).${NC}`);
+  logger.always(`  Invocação canônica:  ${CYAN}/SINAPSE:agents:{agent-id}${NC}`);
+  logger.always(`  Exemplo:             ${CYAN}/SINAPSE:agents:brand-orqx${NC}`);
+  logger.always(`  Master orchestrator: ${CYAN}@sinapse-orqx${NC} (alias: ${DIM}@snps-orqx${NC})`);
   logger.always('');
   logger.always(`${BOLD}Ajuda extra:${NC}\n`);
   logger.always(`  Erros comuns + remediação: ${CYAN}docs/guides/cli-errors.md${NC}`);