sinapse-ai 7.4.3 → 7.4.5

package/.claude/rules/nsn-mode.md

@@ -0,0 +1,53 @@
+# NSN Mode — Never Say Never (Global Rule)
+
+> **NON-NEGOTIABLE**: This rule applies to ALL agents in the SINAPSE ecosystem.
+> No agent may say "I can't" without first exhausting alternatives.
+
+## Protocol
+
+When ANY agent encounters a barrier (technical limitation, permission denied, tool failure, unknown approach):
+
+1. **Classify** the barrier:
+   - `permission` — System permission missing
+   - `technical` — Tool or API limitation
+   - `knowledge` — Don't know how to do it
+   - `external` — External service blocks
+
+2. **Search** for solutions:
+   - Use WebSearch/WebFetch to find workarounds
+   - Query patterns: `"{tool} {error} workaround"`, `"{action} alternative approach"`
+   - Check documentation for the tool/service
+
+3. **Try 3+ alternatives** before escalating:
+   - If Tool A fails → try Tool B
+   - If API blocks → try browser automation
+   - If direct approach fails → try indirect approach
+   - If programmatic fails → try CLI tool
+
+4. **Configure and test** the solution found:
+   - Install dependencies if needed
+   - Adjust permissions
+   - Test in isolated context
+   - Validate result
+
+5. **Repeat** — If still blocked, return to step 2 with new context (max 5 cycles)
+
+6. **Escalate** — After 5 cycles, report to user with detailed log of what was tried
+
+## Anti-Patterns (FORBIDDEN)
+
+- Saying "I can't do this" without trying alternatives
+- Stopping at the first error
+- Assuming something is impossible without researching
+- Asking the user to do something the agent can automate
+- Giving up without documenting what was tried
+
+## Exceptions
+
+- Destructive actions affecting user data → ask confirmation first
+- Actions involving payment/purchase → ask confirmation first
+- Actions violating laws or terms of service → inform and stop
+
+## Applies To
+
+Every agent: @developer, @quality-gate, @architect, @sinapse-orqx, all squad orqx agents, and all specialist agents within squads. No exceptions.

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

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 7.4.3
-generated_at: "2026-03-27T15:24:41.748Z"
+version: 7.4.5
+generated_at: "2026-03-27T18:12:46.613Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1101
 files:

package/README.en.md

@@ -194,12 +194,73 @@ Use `@squad-creator` or see the [Squads Guide](docs/guides/squads-guide.md).
 
 ---
 
-## Supported IDEs
+## Claude Code vs Codex CLI — Full Comparison
+
+SINAPSE works on both IDEs. Both support most features with different approaches.
+
+### Features
+
+| Feature | Claude Code | Codex CLI | Notes |
+|---------|:-----------:|:---------:|-------|
+| **19 squads with 175 agents** | YES | YES | Identical on both |
+| **Knowledge bases per squad** | YES | YES | Identical on both |
+| **Tasks and workflows** | YES | YES | Identical on both |
+| **Story-Driven Development** | YES | YES | Identical on both |
+| **Agent commands (`*help`, `*task`)** | YES | YES | Identical on both |
+| **Squad awareness auto-routing** | YES | YES | Identical on both |
+| **NSN Mode (Never Say Never)** | YES | YES | Global rule on both |
+| **Chrome Brain (browser automation)** | YES | YES | Claude: hooks auto-launch. Codex: via MCP or chrome-cdp-skill |
+| **MCP servers** | YES | YES | Claude: `~/.claude.json`. Codex: `config.toml` or `codex mcp add` |
+| **Hooks (PreToolUse / PostToolUse)** | YES | PARTIAL | Codex: Bash tool only, disabled on Windows |
+| **Agent handoff protocol** | YES | YES | Via instructions + skills on both |
+| **SYNAPSE context engine** | YES | PARTIAL | Codex: via instructions.md + skills (no dynamic rules) |
+| **Native skills system** | NO | YES | Codex has `$skill-name` with progressive disclosure |
+| **Multi-model (Claude + others)** | NO | YES | Codex supports any OpenAI model |
+| **Parallel subagents** | YES | YES | Codex: configurable max 6 threads |
+| **Non-interactive CI/CD** | NO | YES | Codex: `codex exec` with `--json` |
+
+### How to Activate Agents
+
+| Action | Claude Code | Codex CLI |
+|--------|-------------|-----------|
+| Main orchestrator | `/SINAPSE:agents:sinapse-orqx` | `@sinapse-orqx` or `$sinapse-orqx` |
+| Brand squad | `@brand-orqx` | `@brand-orqx` or `$sinapse-brand` |
+| Copy squad | `@copy-orqx` | `@copy-orqx` or `$sinapse-copy` |
+| Developer | `@developer` | `@developer` or `$sinapse-dev` |
+| List agents | `@sinapse-orqx *help` | `/skills` |
+| Chrome Brain | Auto-activates by prompt | `codex mcp add chrome-devtools` |
+
+### Where Each IDE Shines
+
+**Claude Code** — Most integrated experience:
+- Chrome Brain auto-activates via hooks (zero manual config)
+- Context engine injects rules automatically by domain and file
+- Deny/allow rules protect files deterministically
+- Largest MCP server ecosystem (Figma, Supabase, Notion, etc.)
+
+**Codex CLI** — Most flexible and extensible:
+- Native skills with `$skill-name` and progressive disclosure
+- Supports any OpenAI model (not just Claude)
+- `codex exec` for non-interactive CI/CD automation
+- Can run AS an MCP server (other agents can invoke Codex)
+- Profiles for quick config switching
+- Subagents with max 6 parallel threads
+
+### Chrome Brain Setup on Codex CLI
 
-| IDE | How to activate |
-|-----|----------------|
-| **Claude Code** | `@agent-name` or `/sinapse` |
-| **Codex CLI** | `/skills` > `sinapse-<agent>` or `@agent-name` |
+```bash
+# Add Chrome DevTools MCP to Codex
+codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
+
+# OR install the chrome-cdp skill (direct connection, no Puppeteer)
+# pi install git:github.com/pasky/chrome-cdp-skill@v1.0.1
+```
+
+### Recommendation
+
+> **Claude Code** for the most integrated and automated experience — Chrome Brain auto-activates, hooks run automatically, context engine injects rules.
+>
+> **Codex CLI** for model flexibility, native skills, and CI/CD automation — with minimal manual setup for Chrome Brain.
 
 ---
 

package/README.md

@@ -7,7 +7,7 @@
 [![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)
 
-> **174 agentes de IA. 19 squads especializados. Uma CLI.**
+> **175 agentes de IA. 19 squads especializados. Uma CLI.**
 >
 > 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.
 
@@ -20,7 +20,7 @@ O SINAPSE AI nao e mais um chatbot. E um sistema de orquestracao onde cada agent
 **O que voce ganha ao instalar:**
 
 - **19 orquestradores (orqx)** prontos para ativar direto no terminal
-- **174 agentes especializados** com knowledge bases proprias
+- **175 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 e Codex CLI
@@ -87,7 +87,7 @@ Cada squad e uma equipe de agentes especializados com knowledge base, workflows
 | **squad-finance** | Budget, pricing, profitability analysis | 5 |
 | **claude-code-mastery** | Dominio avancado do Claude Code | 8 |
 
-**Total: 19 squads, 174 agentes especializados**
+**Total: 19 squads, 175 agentes especializados**
 
 ---
 
@@ -219,12 +219,73 @@ Use `@squad-creator` ou veja o [Guia de Squads](docs/guides/squads-guide.md).
 
 ---
 
-## IDEs Suportadas
+## Claude Code vs Codex CLI — Comparativo Completo
+
+O SINAPSE funciona em ambas as IDEs. Ambas suportam a maioria das funcionalidades com abordagens diferentes.
+
+### Funcionalidades
+
+| Funcionalidade | Claude Code | Codex CLI | Notas |
+|---------------|:-----------:|:---------:|-------|
+| **19 squads com 175 agentes** | SIM | SIM | Identico em ambas |
+| **Knowledge bases por squad** | SIM | SIM | Identico em ambas |
+| **Tasks e workflows** | SIM | SIM | Identico em ambas |
+| **Story-Driven Development** | SIM | SIM | Identico em ambas |
+| **Agent commands (`*help`, `*task`)** | SIM | SIM | Identico em ambas |
+| **Squad awareness auto-routing** | SIM | SIM | Identico em ambas |
+| **NSN Mode (Never Say Never)** | SIM | SIM | Regra global em ambas |
+| **Chrome Brain (browser automation)** | SIM | SIM | Claude: hooks auto-launch. Codex: via MCP ou chrome-cdp-skill |
+| **MCP servers** | SIM | SIM | Claude: `~/.claude.json`. Codex: `config.toml` ou `codex mcp add` |
+| **Hooks (PreToolUse / PostToolUse)** | SIM | PARCIAL | Codex: so Bash tool, desabilitado no Windows |
+| **Agent handoff protocol** | SIM | SIM | Via instructions + skills em ambas |
+| **SYNAPSE context engine** | SIM | PARCIAL | Codex: via instructions.md + skills (sem regras dinamicas) |
+| **Skills system nativo** | NAO | SIM | Codex tem `$skill-name` com progressive disclosure |
+| **Multi-model (Claude + outros)** | NAO | SIM | Codex suporta qualquer modelo OpenAI |
+| **Subagents paralelos** | SIM | SIM | Codex: max 6 threads configuraveis |
+| **CI/CD non-interactive** | NAO | SIM | Codex: `codex exec` com `--json` |
+
+### Como Ativar Agentes
+
+| Acao | Claude Code | Codex CLI |
+|------|-------------|-----------|
+| Orquestrador principal | `/SINAPSE:agents:sinapse-orqx` | `@sinapse-orqx` ou `$sinapse-orqx` |
+| Squad de brand | `@brand-orqx` | `@brand-orqx` ou `$sinapse-brand` |
+| Squad de copy | `@copy-orqx` | `@copy-orqx` ou `$sinapse-copy` |
+| Developer | `@developer` | `@developer` ou `$sinapse-dev` |
+| Listar agentes | `@sinapse-orqx *help` | `/skills` |
+| Chrome Brain | Auto-ativa por prompt | `codex mcp add chrome-devtools` |
+
+### Onde Cada IDE Brilha
+
+**Claude Code** — Experiencia mais integrada:
+- Chrome Brain auto-ativa por hooks (zero configuracao manual)
+- Context engine injeta regras automaticamente por dominio e arquivo
+- Deny/allow rules protegem arquivos deterministicamente
+- Maior ecossistema de MCP servers (Figma, Supabase, Notion, etc.)
+
+**Codex CLI** — Mais flexivel e extensivel:
+- Skills nativas com `$skill-name` e progressive disclosure
+- Suporta qualquer modelo OpenAI (nao apenas Claude)
+- `codex exec` para automacao CI/CD sem interacao
+- Pode rodar como MCP server (outros agentes invocam Codex)
+- Profiles para alternar configuracoes rapidamente
+- Subagents com max 6 threads paralelos
+
+### Setup Chrome Brain no Codex CLI
 
-| IDE | Como ativar |
-|-----|------------|
-| **Claude Code** | `@agent-name` ou `/sinapse` |
-| **Codex CLI** | `/skills` > `sinapse-<agent>` ou `@agent-name` |
+```bash
+# Adicionar Chrome DevTools MCP ao Codex
+codex mcp add chrome-devtools -- npx chrome-devtools-mcp@latest
+
+# OU instalar a skill chrome-cdp (conexao direta, sem Puppeteer)
+# pi install git:github.com/pasky/chrome-cdp-skill@v1.0.1
+```
+
+### Recomendacao
+
+> **Claude Code** para quem quer a experiencia mais integrada e automatizada — Chrome Brain auto-ativa, hooks rodam sozinhos, context engine injeta regras.
+>
+> **Codex CLI** para quem quer flexibilidade de modelo, skills nativas, e automacao CI/CD — com setup manual minimo para Chrome Brain.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "7.4.3",
+  "version": "7.4.5",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 18 squads, 174 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",

package/sinapse/agents/sinapse-orqx.md

@@ -71,6 +71,32 @@ When the user provides ANY briefing, request, or initiative (regardless of compl
 
 **The user should NEVER have to request orchestration or handoffs. This is Imperator's core function and must happen automatically on every briefing.**
 
+## NON-NEGOTIABLE: NSN MODE (NEVER SAY NEVER)
+
+> **Every agent under Imperator's command operates in NSN Mode.**
+
+Before ANY agent says "I can't", "this is not possible", or "I don't know how":
+1. Search the web for workarounds (WebSearch/WebFetch)
+2. Try 3+ alternative approaches
+3. Configure, test, repeat (max 5 cycles)
+4. Only escalate after exhausting all alternatives with a detailed report
+
+**Imperator enforces NSN across all squads.** If a squad agent gives up too early, Imperator intervenes with alternative routing or cross-squad coordination.
+
+See `.claude/rules/nsn-mode.md` for the full protocol.
+
+## NON-NEGOTIABLE: DOCUMENTATION HANDOFFS
+
+> **Every orchestration plan MUST include documentation handoffs.**
+
+No project continues without proper documentation. For every execution:
+1. **Story file** must be created/updated with progress checkboxes
+2. **File List** must be maintained in the story
+3. **Architectural decisions** must be documented in the handoff artifact
+4. **README/docs** must be updated when user-facing changes are made
+
+Documentation is NOT optional. It is a handoff deliverable like code.
+
 ## COMPLETE AGENT DEFINITION
 
 ```yaml