sinapse-ai 1.25.0 → 1.25.2

package/docs/pt/installation/troubleshooting.md

@@ -545,7 +545,8 @@ nvm use 16
 
 ### Problema 20: "Agents not appearing in IDE"
 
-**Sintomas:** Comandos de agentes (`/dev`, `@dev`) não funcionam após instalação.
+**Sintomas:** A ativação nativa (`@developer` no Claude Code ou
+`$sinapse-agent developer` no Codex) não funciona após a instalação.
 
 **Solução:**
 
@@ -554,10 +555,11 @@ nvm use 16
 
    ```bash
    # Claude Code
-   ls .claude/commands/SINAPSE/agents/
+   ls .claude/agents/
 
-   # Cursor
-   ls .cursor/rules/
+   # Codex
+   ls .codex/agents/
+   ls .agents/skills/
    ```
 
 3. Verifique se as configurações da IDE permitem comandos customizados
@@ -574,10 +576,10 @@ nvm use 16
 
 **Solução:**
 
-1. Verifique se a versão da IDE é compatível
-2. Para Cursor: Certifique-se que os arquivos têm extensão `.mdc`
-3. Para Claude Code: Arquivos devem estar em `.claude/commands/`
-4. Reinicie a IDE após a instalação
+1. Verifique se a versão do provedor é compatível.
+2. Para Claude Code, os agentes nativos devem estar em `.claude/agents/`.
+3. Para Codex, verifique `.codex/agents/` e `.agents/skills/`.
+4. Reinicie o provedor após a instalação.
 
 ---
 
@@ -698,7 +700,7 @@ ls -la .sinapse-ai/
 - SO: [Windows 11 / macOS 14 / Ubuntu 22.04]
 - Versão Node.js: [saída de `node --version`]
 - Versão npm: [saída de `npm --version`]
-- IDE: [Claude Code / Cursor / etc.]
+- Provedor: [Claude Code / Codex CLI]
 
 **Passos para Reproduzir:**
 1. [Primeiro passo]
@@ -733,4 +735,3 @@ ls -la .sinapse-ai/
 ## Documentação Relacionada
 
 - [FAQ](./faq.md)
-

package/docs/pt/installation/v4-quick-start.md

@@ -109,24 +109,24 @@ Digite *help para ver comandos disponíveis.
 
 ## Passo 4: Explorar Agentes Disponíveis
 
-| Agente              | Ativação             | Propósito                          |
+| Ativação            | Papel                | Propósito                          |
 | ------------------- | -------------------- | ---------------------------------- |
-| `@dev` (Dex)        | Desenvolvimento      | Implementação de código, debugging |
-| `@qa` (Quinn)       | Qualidade            | Testes e validação                 |
-| `@architect` (Aria) | Arquitetura          | Design de sistema e documentação   |
-| `@pm` (Sage)        | Product Manager      | Requisitos e planejamento          |
-| `@devops` (Gage)    | DevOps               | Git push, criação de PR, CI/CD     |
-| `@po` (Maven)       | Product Owner        | Criação de stories e backlog       |
-| `@sm` (River)       | Scrum Master         | Gerenciamento de sprint            |
-| `@analyst` (Nova)   | Analista de Negócios | Análise de requisitos              |
+| `@developer` (Pixel)     | Desenvolvimento    | Implementação de código, debugging |
+| `@quality-gate` (Litmus) | Qualidade          | Testes e validação                 |
+| `@architect` (Stratum)   | Arquitetura        | Design de sistema e documentação   |
+| `@project-lead` (Beacon) | Product Manager    | Requisitos e planejamento          |
+| `@devops` (Pipeline)     | DevOps             | Git push, criação de PR, CI/CD     |
+| `@product-lead` (Axis)   | Product Owner      | Validação de stories e backlog     |
+| `@sprint-lead` (Sync)    | Scrum Master       | Gerenciamento de sprint            |
+| `@analyst` (Scope)       | Analista de Negócios | Análise de requisitos            |
 
 ### Exemplo: Ativar Agente Desenvolvedor
 
-```
-@dev
+```text
+@developer
 ```
 
-O agente desenvolvedor (Dex) será ativado com uma saudação mostrando:
+O agente desenvolvedor (Pixel) será ativado com uma saudação mostrando:
 
 - Status do projeto
 - Comandos rápidos
@@ -190,7 +190,7 @@ seu-projeto/
 │   │   └── quality-gates/         # Camadas de validação de qualidade
 │   ├── development/               # Assets de desenvolvimento
 │   │   ├── agents/                # Definições de agentes (12 agentes)
-│   │   ├── tasks/                 # Workflows de tarefas (~140 tarefas)
+│   │   ├── tasks/                 # Workflows de development (211 development tasks)
 │   │   └── workflows/             # Workflows multi-etapa
 │   ├── product/                   # Assets de produto
 │   │   ├── templates/             # Templates de documentos
@@ -200,7 +200,7 @@ seu-projeto/
 │       ├── integrations/          # Adaptadores de PM tools
 │       └── templates/             # Templates de configuração
 ├── .claude/                       # Configuração Claude Code
-│   ├── commands/SINAPSE/agents/      # Skills de agentes
+│   ├── agents/                       # Agentes nativos do Claude
 │   └── rules/                     # Regras de agentes
 ├── docs/                          # Documentação
 │   └── stories/                   # Stories de desenvolvimento
@@ -232,9 +232,9 @@ npm cache clean --force
 
 ### Agente não responde
 
-1. Certifique-se de estar em uma IDE com IA (Cursor, VS Code com Claude, etc.) ou Claude Code CLI
-2. Verifique se está usando sintaxe correta: `@nome-do-agente`
-3. Verifique se o arquivo do agente existe: `ls .sinapse-ai/development/agents/`
+1. Certifique-se de estar usando Claude Code ou Codex CLI.
+2. No Claude Code, use `@developer`; no Codex, use `$sinapse-agent developer` ou `$snps`.
+3. Verifique `.claude/agents/` para Claude Code ou `.codex/agents/` e `.agents/skills/` para Codex.
 
 ### Erros de permissão
 
@@ -267,4 +267,3 @@ git clone https://github.com/caioimori/sinapse-ai.git
 ---
 
 **Bem-vindo ao SINAPSE! Bom coding!**
-

package/docs/pt/installation/windows.md

@@ -141,8 +141,8 @@ O instalador automaticamente:
 - ✅ Detecta Windows e aplica configurações específicas da plataforma
 - ✅ Cria diretórios necessários com permissões apropriadas
 - ✅ Configura caminhos de IDE para localizações Windows:
-  - Cursor: `%APPDATA%\Cursor\`
-  - Claude: `%USERPROFILE%\.claude\`
+  - Agentes do Claude Code: `.claude\agents\`
+  - Agentes e skills do Codex: `.codex\agents\` e `.agents\skills\`
 - ✅ Lida com separadores de caminho Windows (barras invertidas)
 - ✅ Configura terminações de linha corretamente (CRLF para batch, LF para scripts)
 - ✅ Configura scripts npm compatíveis com cmd.exe e PowerShell
@@ -151,28 +151,15 @@ O instalador automaticamente:
 
 ## Configuração Específica por IDE
 
-### Cursor
+### Claude Code
 
-1. Baixe de [cursor.sh](https://cursor.sh/)
-2. Execute o instalador
-3. Regras da IDE são instaladas em `.cursor\rules\`
-4. Atalho de teclado: `Ctrl+L` para abrir chat
-5. Use `@nome-do-agente` para ativar agentes
+1. Os adapters de agentes são instalados em `.claude\agents\`.
+2. Use `@developer` ou outro ID canônico para ativar um agente.
 
-### Claude Code (CLI)
+### Codex
 
-1. Instale o Claude Code:
-
-   ```powershell
-   npm install -g @anthropic-ai/claude-code
-   ```
-
-2. Comandos são instalados em `.claude\commands\SINAPSE\`
-3. Use `/nome-do-agente` para ativar agentes
-
-
-2. Execute o instalador
-4. Use `@nome-do-agente` para ativar agentes
+1. Os descritores são instalados em `.codex\agents\`, com skills em `.agents\skills\`.
+2. Use `$snps` para roteamento ou `$sinapse-agent developer` para ativação direta.
 
 ---
 

package/docs/pt/platforms/claude-code.md

@@ -403,7 +403,7 @@ O Claude Code mostra status em tempo real:
 flowchart LR
     Source["SINAPSE Core<br/>.sinapse-ai/development/agents"] --> Parser["Parser de Agente"]
     Parser --> Transform["Transformador Claude"]
-    Transform --> Output[".claude/commands/SINAPSE/agents"]
+    Transform --> Output[".claude/agents"]
 ```
 
 ### Comandos de Sincronização
@@ -450,7 +450,7 @@ activation: /dev
 
 Quando conflitos ocorrem:
 
-1. Alterações locais são salvas em `.claude/commands/SINAPSE/agents/.backup/`
+1. Alterações locais são salvas em `.claude/agents/.backup/`
 2. Sync solicita resolução
 3. Escolha: manter local, usar remoto ou mesclar
 
@@ -524,7 +524,7 @@ Error: Unknown command '/xyz'
 npm run sync:ide
 
 # Verificar se o agente existe
-ls .claude/commands/SINAPSE/agents/
+ls .claude/agents/
 ```
 
 #### Permissão de Ferramenta Negada
@@ -588,7 +588,7 @@ R: Simplesmente use o comando slash para o agente desejado: `/dev`, `/qa`, etc.
 R: Sim, através do Task tool que pode criar subagentes.
 
 **P: Onde as definições de agentes são armazenadas?**
-R: Em `.claude/commands/SINAPSE/agents/` após a sincronização.
+R: Em `.claude/agents/` após a sincronização.
 
 **P: Com que frequência devo sincronizar agentes?**
 R: Após atualizar o SINAPSE ou quando agentes são modificados no core.

package/docs/sinapse-agent-flows/analyst-system.md

@@ -56,7 +56,7 @@ O agente Analyst e projetado para:
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/analyst.md` | Definição core do agente Analyst |
-| `.claude/commands/SINAPSE/agents/analyst.md` | Comando Claude Code para ativar @analyst |
+| `.claude/agents/analyst.md` | Comando Claude Code para ativar @analyst |
 
 ### Tasks do Analyst
 

package/docs/sinapse-agent-flows/architect-system.md

@@ -56,7 +56,7 @@ O agente **@architect** (Aria) e o **Holistic System Architect & Full-Stack Tech
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/architect.md` | Definição core do agente Architect |
-| `.claude/commands/SINAPSE/agents/architect.md` | Comando Claude Code para ativar @architect |
+| `.claude/agents/architect.md` | Comando Claude Code para ativar @architect |
 
 ### Arquivos de Templates do @architect
 

package/docs/sinapse-agent-flows/data-engineer-system.md

@@ -89,7 +89,7 @@ O agente **@data-engineer (Dara)** e o Database Architect & Operations Engineer
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/data-engineer.md` | Definição core do agente @data-engineer (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/data-engineer.md` | Comando Claude Code para ativar @data-engineer |
+| `.claude/agents/data-engineer.md` | Comando Claude Code para ativar @data-engineer |
 
 ### Arquivos de Templates SQL
 

package/docs/sinapse-agent-flows/dev-system.md

@@ -55,7 +55,7 @@ O agente **@developer (Dex)** e o Full Stack Developer do SINAPSE, responsavel p
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/developer.md` | Definição core do agente @developer (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/developer.md` | Comando Claude Code para ativar @developer |
+| `.claude/agents/developer.md` | Comando Claude Code para ativar @developer |
 
 ### Arquivos de Checklists Usados pelo @dev
 

package/docs/sinapse-agent-flows/pm-system.md

@@ -41,7 +41,7 @@ O agente PM e projetado para:
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/project-lead.md` | Definição core do agente PM |
-| `.claude/commands/SINAPSE/agents/project-lead.md` | Comando Claude Code para ativar @project-lead |
+| `.claude/agents/project-lead.md` | Comando Claude Code para ativar @project-lead |
 
 ### Tasks do @pm
 

package/docs/sinapse-agent-flows/qa-system.md

@@ -64,7 +64,7 @@ O agente **@quality-gate (Quinn)** e o Test Architect & Quality Advisor do SINAP
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/quality-gate.md` | Definição completa do agente QA |
-| `.claude/commands/SINAPSE/agents/quality-gate.md` | Comando Claude Code para ativar @quality-gate |
+| `.claude/agents/quality-gate.md` | Comando Claude Code para ativar @quality-gate |
 
 ### Arquivos de Workflow
 

package/docs/sinapse-agent-flows/sm-system.md

@@ -43,7 +43,7 @@ O agente **@sprint-lead (River)** e o Scrum Master tecnico do SINAPSE, especiali
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/sprint-lead.md` | Definição core do agente SM |
-| `.claude/commands/SINAPSE/agents/sprint-lead.md` | Comando Claude Code para ativar @sprint-lead |
+| `.claude/agents/sprint-lead.md` | Comando Claude Code para ativar @sprint-lead |
 | `.cursor/rules/sm.md` | Regras para Cursor IDE |
 | `.cursor/rules/sm.mdc` | Regras compiladas para Cursor |
 

package/docs/sinapse-agent-flows/snps-orqx-system.md

@@ -60,7 +60,7 @@ O **@sinapse-orqx** (Orion - The Orchestrator) e o meta-agente principal do fram
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/sinapse-orqx.md` | Definição completa do agente (persona, comandos, dependencias) |
-| `.claude/commands/SINAPSE/agents/sinapse-orqx.md` | Comando Claude Code para ativar @sinapse-orqx |
+| `.claude/agents/sinapse-orqx.md` | Comando Claude Code para ativar @sinapse-orqx |
 
 ### Arquivos de Templates do @sinapse-orqx
 

package/docs/sinapse-agent-flows/squad-creator-system.md

@@ -39,7 +39,7 @@ Este sistema implementa a **arquitetura task-first** do SINAPSE, onde tasks sao
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/squad-creator.md` | Definição core do agente Squad Creator |
-| `.claude/commands/SINAPSE/agents/squad-creator.md` | Comando Claude Code para ativar @squad-creator |
+| `.claude/agents/squad-creator.md` | Comando Claude Code para ativar @squad-creator |
 
 ### Arquivos de Tasks do @squad-creator
 
@@ -668,7 +668,7 @@ flowchart LR
 - [Script: squad-validator.js](../../.sinapse-ai/development/scripts/squad/squad-validator.js)
 - [Schema: squad-schema.json](../../.sinapse-ai/schemas/squad-schema.json)
 - [Agent: squad-creator.md](../../.sinapse-ai/development/agents/squad-creator.md)
-- [Command: squad-creator.md](../../.claude/commands/SINAPSE/agents/squad-creator.md)
+- [Command: squad-creator.md](../../.claude/agents/squad-creator.md)
 
 ---
 

package/docs/sinapse-agent-flows/ux-design-expert-system.md

@@ -88,7 +88,7 @@ flowchart TB
 | Arquivo | Propósito |
 |---------|-----------|
 | `.sinapse-ai/development/agents/ux-design-expert.md` | Definição completa do agente (persona, comandos, workflows) |
-| `.claude/commands/SINAPSE/agents/ux-design-expert.md` | Comando Claude Code para ativar @ux-design-expert |
+| `.claude/agents/ux-design-expert.md` | Comando Claude Code para ativar @ux-design-expert |
 
 ### Tasks por Fase
 

package/docs/troubleshooting.md

@@ -40,10 +40,11 @@ npx sinapse-ai install --target "C:\Users\My User\projeto"
 
 ## Problemas de ativação de agentes
 
-### `@developer` não ativa
-1. Verifique IDE detectada: `cat .claude/settings.json` (Claude Code) ou `cat .codex/instructions.md` (Codex)
-2. Re-sincronize: `npx sinapse-ai install --reconfigure`
-3. Reinicie o IDE
+### O agente não ativa
+1. Confirme a sintaxe do provider: `@developer` no Claude Code; `$snps` ou `$sinapse-agent developer` no Codex.
+2. Verifique a configuração instalada: `.claude/settings.json` no Claude Code ou `.codex/config.toml` no Codex.
+3. Re-sincronize: `npx sinapse-ai@latest install --reconfigure`.
+4. Reinicie o provider.
 
 ### Agente ativa mas sem comandos
 ```bash
@@ -59,12 +60,13 @@ Cheque qual hook bloqueou (mensagem de erro tem o nome). Exemplos:
 - **enforce-git-push-authority**: só `@devops` pode push. Delegue: `@devops *push`.
 - **secret-scanning**: detectou secret. Verifique e remova OU mova pra `.env` (gitignored).
 
-Lista completa de hooks: `.claude/hooks/README.md`.
+Claude Code registra 20 hooks em `.claude/settings.json`. Codex registra 9 eventos
+de lifecycle em `.codex/hooks.json` e os encaminha pelo bridge de compatibilidade.
 
 ### Hook não está rodando
 ```bash
-cat .claude/settings.json | grep hooks    # confirma registro
-ls .claude/hooks/                          # confirma arquivo existe
+cat .claude/settings.json | grep hooks    # Claude Code: confirma registro
+cat .codex/hooks.json                     # Codex: confirma eventos registrados
 ```
 
 ## Problemas de CI

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sinapse-ai",
-  "version": "1.25.0",
+  "version": "1.25.2",
   "description": "SINAPSE AI: Framework de orquestracao de IA — 17 squads, 172 agentes especializados",
   "bin": {
     "sinapse": "bin/sinapse.js",
@@ -31,6 +31,7 @@
     "!.sinapse-ai/node_modules",
     "!**/node_modules/**",
     ".claude/CLAUDE.md",
+    ".claude/settings.json",
     ".claude/rules/",
     ".claude/hooks/",
     ".claude/agents/",
@@ -50,7 +51,6 @@
     ".codex/hooks/",
     ".codex/agents/",
     ".codex/scripts/",
-    ".codex/skills/",
     ".codex/tasks/",
     ".agents/skills/",
     "AGENTS.md",
@@ -113,29 +113,29 @@
     "validate:manifest": "node scripts/validate-manifest.js",
     "validate:manifest:parity": "node .sinapse-ai/infrastructure/scripts/validate-manifest-parity.js",
     "validate:agents": "node .sinapse-ai/infrastructure/scripts/validate-agents.js",
-    "sync:ide": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js sync",
-    "sync:ide:validate": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate",
-    "sync:ide:check": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate --strict",
-    "sync:ide:claude": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js sync --ide claude-code",
+    "sync:ide": "node scripts/sync-provider-adapters.js",
+    "sync:ide:validate": "node scripts/validate-provider-adapters.js",
+    "sync:ide:check": "node scripts/validate-provider-adapters.js",
+    "sync:ide:claude": "node scripts/sync-provider-adapters.js",
     "sync:ide:codex": "node .sinapse-ai/infrastructure/scripts/sync-codex-local-first.js && node .codex/scripts/sync-codex-native.js",
     "sync:providers": "node scripts/sync-provider-adapters.js",
-    "validate:claude-sync": "node .sinapse-ai/infrastructure/scripts/ide-sync/index.js validate --ide claude-code --strict",
-    "validate:claude-integration": "node .sinapse-ai/infrastructure/scripts/validate-claude-integration.js",
+    "validate:claude-sync": "node scripts/validate-provider-adapters.js",
+    "validate:claude-integration": "node scripts/validate-provider-adapters.js",
     "validate:providers": "node scripts/validate-provider-adapters.js",
     "validate:engineering-applicability": "jest tests/unit/engineering-applicability.test.js --runInBand",
     "validate:squad-schema": "node scripts/validate-squad-yaml.js",
     "validate:squad-schema:strict": "node scripts/validate-squad-yaml.js --strict",
-    "validate:codex-sync": "node .sinapse-ai/infrastructure/scripts/validate-codex-sync.js && node .codex/scripts/validate-codex-native.js",
+    "validate:codex-sync": "node .codex/scripts/validate-codex-native.js && node scripts/validate-codex-command-registry.js && node .sinapse-ai/infrastructure/scripts/validate-codex-integration.js && node .sinapse-ai/infrastructure/scripts/validate-codex-delegation.js",
     "validate:codex-native": "node .codex/scripts/validate-codex-native.js",
     "validate:codex-integration": "node .sinapse-ai/infrastructure/scripts/validate-codex-integration.js",
-    "validate:codex-commands": "node .sinapse-ai/infrastructure/scripts/validate-codex-command-registry.js",
+    "validate:codex-commands": "node scripts/validate-codex-command-registry.js",
     "validate:codex-delegation": "node .sinapse-ai/infrastructure/scripts/validate-codex-delegation.js",
-    "sync:skills:codex": "node .sinapse-ai/infrastructure/scripts/codex-skills-sync/index.js",
-    "sync:skills:codex:global": "node .sinapse-ai/infrastructure/scripts/codex-skills-sync/index.js --global --global-only",
-    "validate:codex-skills": "node .sinapse-ai/infrastructure/scripts/codex-skills-sync/validate.js --strict",
+    "sync:skills:codex": "node .codex/scripts/sync-codex-native.js",
+    "sync:skills:codex:global": "node bin/cli.js install --llm=codex --global-only",
+    "validate:codex-skills": "node .codex/scripts/validate-codex-native.js",
     "validate:paths": "node .sinapse-ai/infrastructure/scripts/validate-paths.js",
-    "validate:parity": "node .sinapse-ai/infrastructure/scripts/validate-parity.js",
-    "validate:parity:fast": "node .sinapse-ai/infrastructure/scripts/validate-parity.js --fast --quiet",
+    "validate:parity": "node scripts/validate-provider-adapters.js && node .codex/scripts/validate-codex-native.js && node scripts/validate-codex-command-registry.js && node .sinapse-ai/infrastructure/scripts/validate-codex-integration.js && node .sinapse-ai/infrastructure/scripts/validate-codex-delegation.js && node .sinapse-ai/infrastructure/scripts/validate-paths.js",
+    "validate:parity:fast": "node scripts/validate-provider-adapters.js && node scripts/validate-codex-command-registry.js",
     "collab:adopt": "node bin/utils/collab-start.js --adopt-current",
     "collab:check": "node bin/utils/collab-start.js --check",
     "collab:start": "node bin/utils/collab-start.js",
@@ -264,5 +264,10 @@
     "ip-address": "^10.1.1",
     "@babel/core": "^7.29.6",
     "js-yaml": "^4.2.0"
-  }
+  },
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  },
+  "type": "commonjs"
 }

package/packages/installer/src/config/ide-configs.js

@@ -38,7 +38,7 @@ const IDE_CONFIGS = {
     requiresDirectory: true,
     format: 'text',
     recommended: true,
-    agentFolder: path.join('.claude', 'commands', 'SINAPSE', 'agents'),
+    agentFolder: path.join('.claude', 'agents'),
   },
   codex: {
     name: 'Codex CLI',