sinapse-ai 1.13.0 → 1.15.0

package/.sinapse-ai/development/agents/analyst/MEMORY.md

@@ -32,3 +32,22 @@
 <!-- Patterns no longer relevant — kept for history -->
 <!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+**Gates de pesquisa/análise com IA (KIT-ai-engineering):** saída de LLM é input NÃO confiável — valide grounding e cite a fonte de cada claim · separe fato de inferência · contexto curado por pergunta, o crítico nas bordas · não complete de memória o que o retrieval não trouxe (marque lacuna).
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/architect/MEMORY.md

@@ -72,3 +72,20 @@ Fonte completa: `engenharia-software/fase-4-agents/` (KIT-architect, KIT-orquest
 
 ### Loop operacional
 Loop mestre: Cynefin -> Entender(outcome+ASR) -> Modelar(bounded context) -> Escolher(estilo por trade-off) -> Avaliar(sensitivity/tradeoff points) -> Registrar(ADR) -> Proteger(fitness function) -> Validar(CI); cada gate bloqueia, loop evolutivo reentra quando o negocio muda. Detalhe + diagramas mermaid (L1-L7 e Loop mestre): `LOOPS-design-arquitetura-diagramas.md` e, pra squads, `LOOPS-onda-7-processo-pessoas-diagramas.md` (B1-B6).
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/data-engineer/MEMORY.md

@@ -69,3 +69,20 @@ Fonte completa: `engenharia-software/fase-4-agents/KIT-data-engineer.md` (repo g
 ### Loop operacional
 Entender (queries reais + invariantes) -> Modelar (BCNF, PK/FK, unique) -> Isolar (menor nivel; write skew -> SSI/lock + retry 40001) -> Indexar -> Provar (`EXPLAIN ANALYZE`, matar N+1) -> Migrar (versionada/reversivel) -> Especializar (RAG/event store/RLS/outbox) -> Verificar (rodar TODOS os gates ate verde) -> Registrar ADR + handoff (push/PR exclusivo do @devops). Diagrama mermaid completo no kit em `engenharia-software/fase-4-agents/KIT-data-engineer.md`.
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/developer/MEMORY.md

@@ -81,3 +81,20 @@
 ### Loop operacional
 Entender (legado -> characterizar) -> design barato (comentario de interface antes) -> teste que falha pela razao certa -> implementacao minima que passa -> refatorar com rede (smell->refactoring->pattern, passos atomicos AST) -> gate de qualidade -> Done. Nunca avance com a barra vermelha. Diagramas L1-L12 + loop mestre em `LOOPS-craftsmanship-diagramas.md` (e `LOOPS-onda-6-fundamentos-linguagens-diagramas` pro eval/apply).
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/devops/MEMORY.md

@@ -77,3 +77,20 @@ Kit completo em `engenharia-software/fase-4-agents/KIT-devops-sre.md` (repo gith
 ### Loop operacional
 CODAR (integrar pequeno, testavel, seguro, atras de flag) -> ENTREGAR (pipeline com gates + canary/rollback) -> MEDIR (DORA + SLO + wide events) -> PROTEGER (triade de estabilidade + blast radius); postmortem blameless realimenta o threat model e o error budget governa o ritmo. Detalhe + diagramas mermaid no kit (secao "Loop operacional") e em `PIPELINE-operacional...` / `PLAYBOOK-performance-execucao`.
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/product-lead/MEMORY.md

@@ -79,3 +79,20 @@ Fonte completa: kit `KIT-product-sprint.md` em `engenharia-software/fase-4-agent
 
 ### Loop operacional
 Classificar (Cynefin/risco) -> Descobrir (OST, >=3 solucoes) -> Mapear (Story Map + walking skeleton) -> Fatiar vertical (SPIDR) -> Refinar (Example Mapping <30min) -> Gate A+B -> Ready -> Pull sob WIP -> Implementar lote pequeno -> DoD jidoka -> Measure -> pivot-or-persevere -> Forecast -> Retro/kaizen. Diagrama mermaid completo na secao "## Loop operacional" do kit.
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/project-lead/MEMORY.md

@@ -73,3 +73,20 @@ Fonte completa: kit `KIT-product-sprint.md` em `engenharia-software/fase-4-agent
 ### Loop operacional
 Classificar (Cynefin) -> descobrir (OST, >=3 solucoes, testar assumption mais arriscada) -> mapear (Story Map) -> fatiar vertical (SPIDR) -> refinar (Example Mapping <30min) -> Gate A+B (Ready) -> puxar sob WIP -> implementar lote pequeno -> DoD jidoka -> medir actionable metric -> pivot-or-persevere -> forecast Monte Carlo -> retro (kaizen + OST + CFD). Diagrama mermaid completo na secao "## Loop operacional" do kit.
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/quality-gate/MEMORY.md

@@ -76,3 +76,20 @@ Fonte: kit completo em `engenharia-software/fase-4-agents/KIT-quality-gate.md` (
 ### Loop operacional
 QA Gate/Loop determinístico: suíte verde → qualidade do teste → mutation incremental → flakiness → segurança → least agency → verdict (PASS/CONCERNS/FAIL/WAIVED); qualquer gate aplicável vermelho ⇒ não assina Done; máx 5 iterações então escala. Diagrama/passo-a-passo completo no kit (`KIT-quality-gate.md` §"Loop operacional").
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/snps-orqx.md

@@ -783,3 +783,18 @@ Imperator can provide ecosystem-wide insights by combining capabilities across s
 - **Receives from:** Every squad (escalations, cross-squad requests)
 - **Sends to:** Every squad (routed work, coordination directives)
 - **Coordinates with:** All 17 squad orchestrators
+
+<!-- ENG-GROUNDING:v2 -->
+## ⚙️ Munição de Engenharia — Orquestração
+> Calibrada pra sua função (orquestrador + conselho-estrategico). Base: 60 domínios · 1.617 fichas (`engenharia-software/fase-4-agents/`). Lei de execução; saída de IA é rascunho a verificar, nunca verdade.
+
+**Núcleo (todo trabalho com IA):** Menor meio que resolve (não suba complexidade à toa) · spec/brief antes (todo entregável traça a um objetivo declarado; **No Invention** — nunca invente dado, fonte, número, citação ou claim) · todo loop com critério de parada definido antes · ação/entrega sem verificação é cega (valide contra o objetivo antes de fechar) · contexto é finito (cure o essencial, não encha) · saída de IA é input NÃO confiável (valide schema, fonte e fato antes de usar).
+
+**Da sua função (Orquestração):** Você COORDENA, não executa. Decomponha e delegue ao especialista certo; dê a cada worker contexto ISOLADO e mínimo, e exija de volta um resumo destilado (não o contexto inteiro); decida nº de agentes, orçamento e ordem ANTES de disparar; sintetize os resultados. Ação irreversível sobe pro humano. Nunca faça o trabalho de domínio do especialista.
+
+**Reforço (Conselho Estratégico):** Opinião com base, nunca palpite: ancore cada conselho num modelo/princípio explícito e nas premissas REAIS do caso.
+
+**Congruência:** Roteia 172 agentes; diagnostica antes de prescrever; delega, não executa.
+
+NUNCA declare "pronto" com objetivo não atendido, dado/fonte inventado, ou verificação pendente.
+<!-- /ENG-GROUNDING:v2 -->

package/.sinapse-ai/development/agents/sprint-lead/MEMORY.md

@@ -74,3 +74,20 @@ Fonte completa: `engenharia-software/fase-4-agents/KIT-product-sprint.md` (repo
 ### Loop operacional
 Classificar (Cynefin) -> descobrir (OST) -> mapear (Story Map) -> fatiar vertical (SPIDR) -> refinar (Example Mapping <30min) -> Gate A+B -> puxar sob WIP -> implementar lote pequeno (DoD jidoka) -> medir -> aprender (pivot/persevere) -> forecast Monte Carlo -> retro (1-3 kaizen + atualiza OST/CFD). Diagrama completo na secao "Loop operacional" do kit.
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/agents/squad-creator.md

@@ -398,3 +398,18 @@ Type `*help` to see all commands, or `*guide` for detailed usage.
 - **@devops (Pipeline)** - Handles deployment
 
 ---
+
+<!-- ENG-GROUNDING:v2 -->
+## ⚙️ Munição de Engenharia — Skills & Automação
+> Calibrada pra sua função (skills-automacao + arquiteto). Base: 60 domínios · 1.617 fichas (`engenharia-software/fase-4-agents/`). Lei de execução; saída de IA é rascunho a verificar, nunca verdade.
+
+**Núcleo (todo trabalho com IA):** Menor meio que resolve (não suba complexidade à toa) · spec/brief antes (todo entregável traça a um objetivo declarado; **No Invention** — nunca invente dado, fonte, número, citação ou claim) · todo loop com critério de parada definido antes · ação/entrega sem verificação é cega (valide contra o objetivo antes de fechar) · contexto é finito (cure o essencial, não encha) · saída de IA é input NÃO confiável (valide schema, fonte e fato antes de usar).
+
+**Da sua função (Skills & Automação):** Contexto rico > prompt elaborado, e skill que gerou arquivo ≠ skill correta (validar o output é obrigatório). Skill nasce de ENGENHARIA REVERSA de código real (few-shot), nunca à mão; a description carrega o gatilho (quando usar E quando NÃO); 1 rule = 1 responsabilidade; PREFIRA o determinístico (o fixo vira script idempotente); cure o contexto por task, nunca um prompt único gigante.
+
+**Reforço (Arquitetura):** Tudo é trade-off — nunca 'o melhor X', e sim 'X paga seu custo NESTE contexto porque…'.
+
+**Congruência:** Squads task-first validados contra schema; determinístico antes de IA.
+
+NUNCA declare "pronto" com objetivo não atendido, dado/fonte inventado, ou verificação pendente.
+<!-- /ENG-GROUNDING:v2 -->

package/.sinapse-ai/development/agents/ux/MEMORY.md

@@ -30,3 +30,24 @@
 <!-- Patterns no longer relevant — kept for history -->
 <!-- Format: - ~~{pattern}~~ | Archived: {YYYY-MM-DD} | Reason: {reason} -->
 
+
+<!-- ENG-GROUNDING:v1 -->
+## ⚙️ Núcleo: Engenharia com IA (base do Caio)
+
+> Complemento transversal à munição do seu papel. Base: 60 domínios · 1.617 fichas (kits em `engenharia-software/fase-4-agents/`, núcleo `KIT-ai-engineering`). Código gerado ≠ código verificado.
+
+**Leis invioláveis — Engenharia com IA (núcleo transversal):**
+1. Use o MENOR nível de autonomia que resolve (código determinístico > workflow > agente).
+2. Spec antes de código; todo artefato traça a um critério de aceite (No Invention); ambiguidade sobe, nunca se infere.
+3. Todo loop tem freio: max-iterações/timeout definido ANTES.
+4. Ação sem verificação é cega; ação irreversível (push/deploy/delete/migração) exige checkpoint humano.
+5. Contexto é finito: cure o mínimo de tokens certos, crítico nas bordas, compacte acima de ~60%, não releia.
+6. Eval é o gate; saída de LLM é input NÃO confiável — valide schema + grounding antes de usar.
+7. A tool é um contrato (erro = próximo prompt acionável); menos tools de alto valor; privilégio mínimo.
+
+**Gates de frontend (KIT-frontend):** rendering é decisão de produto · server state no TanStack Query · anime só transform/opacity, nunca bloqueie a main thread >50ms · meça no campo (P75/CrUX) · HTML semântico antes de ARIA, contraste ≥4.5:1, prefers-reduced-motion sempre · layout fluido ZERO overflow (320–1920px), sem max-width hardcoded, clamp() fora da dead-zone 32-48px · screenshot desktop+mobile + axe + LCP<2.5s/INP<200ms/CLS<0.1 antes de "pronto".
+
+**Gates de craft de produto (KIT-product-craft):** token SEMÂNTICO, nunca hex/primitivo · pesquise comportamento real (5 usuários ~85%) · 45-75ch, assimetria intencional, identity layer (#0A0A0A, nunca #000) · motion só se ensina algo · conversão reduz fricção antes de motivação, nunca dark pattern · teste dos 5 segundos antes de "pronto".
+
+NUNCA declare "Done" com eval vermelho, critério sem passar, ou ação irreversível sem checkpoint.
+<!-- /ENG-GROUNDING:v1 -->

package/.sinapse-ai/development/templates/chrome-brain/rules/chrome-brain-autoload.md

@@ -21,6 +21,10 @@ When the user's prompt matches ANY of these patterns, Chrome Brain is active:
 4. Track screenshot count — max 15 per session
 5. Handoff results to domain squad when applicable
 
+## Janela fixa & login (uma vez)
+
+A automação roda numa **janela de Chrome dedicada e fixa** (perfil `~/.chrome-debug-profile`), separada do Chrome pessoal do usuário. Ela é lançada **só quando uma tarefa de browser precisa** e **nunca é morta enquanto saudável** (o `chrome-ensure` só relança se a porta estiver realmente fora do ar). Na primeira vez que uma tarefa acessar um site que exige login, o usuário loga **uma vez** nessa janela — o perfil persiste, então não precisa logar de novo. Para logar proativamente em todas as contas de uma vez: `sinapse chrome-brain login`.
+
 ## Auto-Learning — MANDATORY
 
 After completing ANY browser automation task, evaluate:

package/.sinapse-ai/development/templates/chrome-brain/scripts/chrome-brain-log.cjs

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+'use strict';
+
+/*
+ * Chrome Brain — chrome-brain-log (Node, cross-platform).
+ *
+ * Called by the PostToolUse hook after every browser MCP tool. Appends a usage
+ * line and warns when the per-session screenshot count gets risky (the API has
+ * a ~20MB response cap). Node version of the old bash logger so it runs hidden
+ * on Windows (no console window) and needs no date/awk/grep.
+ *
+ * FAIL-SOFT: never throws, always exits 0.
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+function toolName() {
+  // Claude Code passes a JSON payload on stdin; fall back to env then 'unknown'.
+  try {
+    const raw = fs.readFileSync(0, 'utf8');
+    if (raw) {
+      const j = JSON.parse(raw);
+      return j.tool_name || j.toolName || process.env.HOOK_TOOL_NAME || 'unknown';
+    }
+  } catch {
+    /* no stdin / not JSON */
+  }
+  return process.env.HOOK_TOOL_NAME || 'unknown';
+}
+
+try {
+  const dir = path.join(os.homedir(), '.chrome-brain');
+  fs.mkdirSync(dir, { recursive: true });
+
+  const now = new Date();
+  const today = now.toISOString().slice(0, 10).replace(/-/g, ''); // YYYYMMDD
+  const time = now.toTimeString().slice(0, 8); // HH:MM:SS
+  const tool = toolName();
+
+  fs.appendFileSync(path.join(dir, `session-${today}.log`), `${time} ${tool}\n`);
+
+  if (/take_screenshot|take_snapshot/.test(tool)) {
+    const countFile = path.join(dir, '.screenshot-count');
+    const dateFile = path.join(dir, '.screenshot-date');
+
+    let lastDate = '';
+    try {
+      lastDate = fs.readFileSync(dateFile, 'utf8').trim();
+    } catch {
+      /* first run */
+    }
+    if (lastDate !== today) {
+      fs.writeFileSync(dateFile, today);
+      fs.writeFileSync(countFile, '0');
+    }
+
+    let count = 0;
+    try {
+      count = parseInt(fs.readFileSync(countFile, 'utf8'), 10) || 0;
+    } catch {
+      /* default 0 */
+    }
+    count += 1;
+    fs.writeFileSync(countFile, String(count));
+
+    if (count === 12) {
+      process.stderr.write('WARNING: 12 screenshots this session. Consider saving state and rotating.\n');
+    } else if (count >= 15) {
+      process.stderr.write('CRITICAL: 15+ screenshots. Session at risk of the API size cap. Save state NOW.\n');
+    }
+  }
+} catch {
+  /* fail-soft */
+}
+
+process.exit(0);

package/.sinapse-ai/development/templates/chrome-brain/scripts/chrome-ensure.cjs

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+'use strict';
+
+/*
+ * Chrome Brain — chrome-ensure (Node, cross-platform).
+ *
+ * Called by the PreToolUse hook before any browser MCP tool. Guarantees the
+ * SINGLE fixed-profile debug Chrome is up on the CDP port — and crucially:
+ *   - NEVER kills a healthy instance (the old bash script force-killed on a
+ *     flaky check, which dropped the live DevTools connection).
+ *   - Launches detached + windowsHide so NO console (CMD/PowerShell) window
+ *     ever pops (the old `#!/bin/bash` script spawned a console on Windows).
+ *   - Uses one fixed profile so the user logs in ONCE and stays logged in.
+ *
+ * Reads config from ~/.sinapse/chrome-brain.json (written at install time):
+ *   { "chromePath": "...", "port": 9222, "profile": "~/.chrome-debug-profile" }
+ *
+ * FAIL-SOFT: any error -> exit 0. A browser helper is never worth blocking a
+ * tool call (the MCP itself will surface a clear error if Chrome is truly down).
+ *
+ * Pass `--visible` (or run via `chrome-brain login`) to force a launch even when
+ * an instance is already up — used to open the window for first-time login.
+ */
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const http = require('http');
+const { spawn } = require('child_process');
+
+const CONFIG_PATH = path.join(os.homedir(), '.sinapse', 'chrome-brain.json');
+
+function readConfig() {
+  try {
+    const c = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf8'));
+    if (!c || !c.chromePath) return null;
+    return {
+      chromePath: c.chromePath,
+      port: Number(c.port) || 9222,
+      profile: c.profile || path.join(os.homedir(), '.chrome-debug-profile'),
+    };
+  } catch {
+    return null;
+  }
+}
+
+// True iff a debug Chrome is already answering CDP on the port. Short timeout so
+// the hook never stalls a tool call.
+function isAlive(port) {
+  return new Promise((resolve) => {
+    const req = http.get(
+      { host: '127.0.0.1', port, path: '/json/version', timeout: 1200 },
+      (res) => {
+        res.resume();
+        resolve(res.statusCode === 200);
+      }
+    );
+    req.on('error', () => resolve(false));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve(false);
+    });
+  });
+}
+
+function launch(cfg) {
+  const args = [
+    `--remote-debugging-port=${cfg.port}`,
+    `--user-data-dir=${cfg.profile}`,
+    '--no-first-run',
+    '--no-default-browser-check',
+  ];
+  // detached + ignored stdio + unref: Chrome survives this short-lived hook
+  // process and keeps the fixed profile alive across the whole session.
+  // windowsHide hides any console wrapper (chrome.exe itself is a GUI app, so
+  // its own window still shows — that is intentional, the user logs in there).
+  const child = spawn(cfg.chromePath, args, {
+    detached: true,
+    stdio: 'ignore',
+    windowsHide: true,
+  });
+  child.unref();
+}
+
+async function main() {
+  const force = process.argv.includes('--visible') || process.argv.includes('--force');
+  const cfg = readConfig();
+  if (!cfg) process.exit(0); // not configured -> do nothing, never block
+
+  const alive = await isAlive(cfg.port);
+  if (alive && !force) process.exit(0); // healthy -> NEVER touch it, just return
+
+  try {
+    launch(cfg);
+  } catch {
+    process.exit(0);
+  }
+
+  // Poll until ready (~10s max). We never kill anything; if it does not come up
+  // we exit quietly and let the MCP report the connection error.
+  for (let i = 0; i < 20; i++) {
+    await new Promise((r) => setTimeout(r, 500));
+    if (await isAlive(cfg.port)) process.exit(0);
+  }
+  process.exit(0);
+}
+
+main().catch(() => process.exit(0));

package/.sinapse-ai/install-manifest.yaml

@@ -7,9 +7,9 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.13.0
+version: 1.15.0
 generator: scripts/generate-install-manifest.js
-file_count: 1147
+file_count: 1150
 files:
   - path: cli/commands/config/index.js
     hash: sha256:bfa83cb1dc111b0b30dd298dc0abc2150b73f939b6cd4458effa8e6d407bc9e2
@@ -1344,9 +1344,9 @@ files:
     type: data
     size: 9602
   - path: data/entity-registry.yaml
-    hash: sha256:f69496e14239f505a58346dfdc7575081111db320af1b73a2a8253746c422235
+    hash: sha256:1754430439419493ac7b1c5a6c3473bfafb08a6f2bdb94826188f3dfcfb86849
     type: data
-    size: 558197
+    size: 547841
   - path: data/learned-patterns.yaml
     hash: sha256:1a4cd045c087b9dfd7046ff1464a9d2edb85fba77cf0b6fba14f4bb9004c741e
     type: data
@@ -1480,17 +1480,17 @@ files:
     type: agent
     size: 23745
   - path: development/agents/snps-orqx.md
-    hash: sha256:ac7f931f107fe2adc020ef26f8ea0e1aba57dd0ba3d02bbff3b92e3ca6466368
+    hash: sha256:313fd53fcb43bec1a0e0e1dc90867c6a6b3643e08a9a41e32e2fa86e090ce8ae
     type: agent
-    size: 41103
+    size: 42694
   - path: development/agents/sprint-lead.md
     hash: sha256:572289b770cdbb0cff9ae2de4b2d19c38ce814fe978df397aa2794297f562c91
     type: agent
     size: 14441
   - path: development/agents/squad-creator.md
-    hash: sha256:45326e5a21a8d0497f8164160c03db991ea8782300a8880ca46ec4df9835ac01
+    hash: sha256:80fc6cdfd6d7102803a5c477d576cbfadf96990ffd8f6c7246047603f2a80d33
     type: agent
-    size: 16584
+    size: 18180
   - path: development/agents/ux-design-expert.md
     hash: sha256:ef221c2ce9dc7b808feab65d04c80e5d0186fe3343e079404d761b1d9ff056a2
     type: agent
@@ -2708,9 +2708,13 @@ files:
     type: template
     size: 2048
   - path: development/templates/chrome-brain/rules/chrome-brain-autoload.md
-    hash: sha256:a3079e8e30f252f4a0da766b930bccc15d0288c3012482c0ad4901ccba27bc5d
+    hash: sha256:ff4eb0dfda916b7441e020ff722336c46d87ef47234f08cb2fef009cb5aaa467
     type: template
-    size: 1944
+    size: 2540
+  - path: development/templates/chrome-brain/scripts/chrome-brain-log.cjs
+    hash: sha256:baddce09225c16076a67afc0029e89dafcf9dcebbcef39a51c53dd9e63390710
+    type: template
+    size: 2268
   - path: development/templates/chrome-brain/scripts/chrome-brain-log.sh
     hash: sha256:d72c54d9b67745fac667f1fb05387f11b9bfc55b8bebb64cca67c9a44171d436
     type: template
@@ -2719,6 +2723,10 @@ files:
     hash: sha256:5907538f71757df0954533507e5efac4ebb4c18f92fb93cd305b61fa1c379809
     type: template
     size: 7207
+  - path: development/templates/chrome-brain/scripts/chrome-ensure.cjs
+    hash: sha256:7ff77f28a86fa655e89f292b6b5ebe51a20befb4faf7be99d221b338388472ba
+    type: template
+    size: 3578
   - path: development/templates/chrome-brain/scripts/chrome-ensure.sh
     hash: sha256:eab2018b622c8550381c6d4555f4496595859b98401dff63a3036abf8433ebfa
     type: template
@@ -4187,18 +4195,22 @@ files:
     hash: sha256:3f8bb48230df89cf987330f7c9aff19edbc35a65a9cbff799e28480155dd8919
     type: template
     size: 6764
+  - path: product/templates/statusline/agent-badges.json
+    hash: sha256:9a926dc37107a34880aef351f540f3425f1ec60e77870f7f319980ee53576ead
+    type: template
+    size: 18475
   - path: product/templates/statusline/statusline-script.js
-    hash: sha256:05945437a07c0156ff5bff3238ad8fc71728c591933db64fde94aa219d6f9146
+    hash: sha256:5860eecf6b02701666ff42f858bf25e3524f124210ef70d2b5243b829e893bb8
     type: template
-    size: 7530
+    size: 8748
   - path: product/templates/statusline/track-agent-clear.cjs
     hash: sha256:3cda606de2463374e60440ba6cae9ca98e39b782b19c6ae39aa7569a1b211f09
     type: template
     size: 2137
   - path: product/templates/statusline/track-agent.cjs
-    hash: sha256:898d576f257734e9954e8949e5a4685f38167af0dcad986745b411a3b318559e
+    hash: sha256:0194c9a5750ed9e7a11fb5de21060021f64636f21e8b91039543abccaf6a4c86
     type: template
-    size: 6244
+    size: 10990
   - path: product/templates/story-tmpl.yaml
     hash: sha256:43a050de5ef51f53f890fd20f77ac567b297a40597f467b3bc6d00c8193c7fa6
     type: template