sinapse-ai 5.0.8 → 6.0.1

package/docs/pt/architecture/agent-config-audit.md

@@ -22,7 +22,7 @@
 
 ## Análise de Agentes
 
-### Morgan (@pm)
+### Morgan (@project-lead)
 
 **Título:** Product Manager
 
@@ -64,7 +64,7 @@
 
 ---
 
-### Pax (@po)
+### Pax (@product-lead)
 
 **Título:** Product Owner
 
@@ -85,7 +85,7 @@
 
 ---
 
-### River (@sm)
+### River (@sprint-lead)
 
 **Título:** Scrum Master
 
@@ -171,7 +171,7 @@
 
 ---
 
-### Dex (@dev)
+### Dex (@developer)
 
 **Título:** Desenvolvedor Full Stack
 

package/docs/pt/architecture/agent-responsibility-matrix.md

@@ -8,7 +8,7 @@
 
 **Versão do Documento**: 1.0
 **Última Atualização**: 2025-10-25
-**Autor**: Winston (@architect) + Sarah (@po)
+**Autor**: Winston (@architect) + Sarah (@product-lead)
 **Contexto**: Epic 3 Fase 2 - Melhorias Estratégicas (Stories 3.13-3.19)
 
 ---
@@ -18,7 +18,7 @@
 Este documento define limites claros de responsabilidade para todos os agentes SINAPSE, com foco particular em:
 1. **Centralização do GitHub DevOps** - Apenas @github-devops pode fazer push para repositório remoto
 2. **Especialização em Arquitetura de Dados** - @data-architect gerencia banco de dados/ciência de dados
-3. **Divisão de Gerenciamento de Branches** - @sm (local) vs @github-devops (remoto)
+3. **Divisão de Gerenciamento de Branches** - @sprint-lead (local) vs @github-devops (remoto)
 4. **Restrições de Operações Git** - Quais agentes podem fazer o quê com git/GitHub
 
 **Regra Crítica**: SOMENTE o agente @github-devops pode executar `git push` para o repositório remoto.
@@ -29,7 +29,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 ### Autoridade Total de Operações
 
-| Operação | @github-devops | @dev | @sm | @qa | @architect | @po |
+| Operação | @github-devops | @developer | @sprint-lead | @quality-gate | @architect | @product-lead |
 |----------|:--------------:|:----:|:---:|:---:|:----------:|:---:|
 | **git push** | ✅ ÚNICO | ❌ | ❌ | ❌ | ❌ | ❌ |
 | **git push --force** | ✅ ÚNICO | ❌ | ❌ | ❌ | ❌ | ❌ |
@@ -126,7 +126,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 ---
 
-### @dev (James) 💻
+### @developer (James) 💻
 **Papel**: Engenheiro de Software Sênior Expert e Especialista em Implementação
 
 **Escopo Principal**:
@@ -147,7 +147,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 ---
 
-### @sm (Bob) 🏃
+### @sprint-lead (Bob) 🏃
 **Papel**: Scrum Master Técnico - Especialista em Preparação de Stories
 
 **Escopo Principal**:
@@ -166,7 +166,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 2. Desenvolvedor faz commits localmente
 3. Story completa → Notificar @github-devops para fazer push e criar PR
 
-**Nota**: @sm gerencia branches LOCAIS durante desenvolvimento, @github-devops gerencia operações REMOTAS
+**Nota**: @sprint-lead gerencia branches LOCAIS durante desenvolvimento, @github-devops gerencia operações REMOTAS
 
 ---
 
@@ -207,7 +207,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 ---
 
-### @qa (Quinn) 🧪
+### @quality-gate (Quinn) 🧪
 **Papel**: Arquiteto de Testes e Consultor de Qualidade
 
 **Escopo Principal**:
@@ -219,11 +219,11 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 **Operações Git**: Somente leitura (status, log, diff para revisão) - SEM COMMIT, SEM PUSH
 
-**Nota**: QA revisa código mas não commita. @dev commita, @github-devops faz push.
+**Nota**: QA revisa código mas não commita. @developer commita, @github-devops faz push.
 
 ---
 
-### @po (Sarah) 📝
+### @product-lead (Sarah) 📝
 **Papel**: Product Owner Técnica e Guardiã de Processos
 
 **Escopo Principal**:
@@ -235,7 +235,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 **Operações Git**: Nenhuma (papel de PO é não-técnico em relação ao git)
 
-**Nota**: @po valida requisitos e prioriza trabalho, não interage com git.
+**Nota**: @product-lead valida requisitos e prioriza trabalho, não interage com git.
 
 ---
 
@@ -246,11 +246,11 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 ```
 1. Usuário: "Iniciar Story 3.14: Agente GitHub DevOps"
 
-2. @sm ativa:
+2. @sprint-lead ativa:
    - Cria feature branch: `git checkout -b feature/3.14-github-devops-agent`
    - Passa para @dev
 
-3. @dev ativa:
+3. @developer ativa:
    - Implementa tarefas da story
    - Commita localmente: `git add . && git commit -m "feat: implement pre-push quality gate"`
    - Marca story: "Pronta para Revisão"
@@ -340,7 +340,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 ## Responsabilidades de Gerenciamento de Branch
 
-### Branches Locais (@sm durante desenvolvimento)
+### Branches Locais (@sprint-lead durante desenvolvimento)
 
 **Responsabilidades**:
 - Criar feature branches quando story inicia
@@ -349,7 +349,7 @@ Este documento define limites claros de responsabilidade para todos os agentes S
 
 **Comandos**:
 ```bash
-# @sm pode executar:
+# @sprint-lead pode executar:
 git checkout -b feature/3.14-github-devops
 git branch -d feature/old-branch
 git merge feature/branch-to-integrate
@@ -383,9 +383,9 @@ gh pr merge
 
 - [ ] **Atualizar Todas as Definições de Agentes** (DONE ✅)
   - [x] @architect - Adicionado `git_restrictions` e limites de colaboração
-  - [x] @dev - Removido git push, adicionado redirecionamento de workflow
-  - [x] @sm - Clarificado gerenciamento apenas de branch local
-  - [x] @qa - Operações git somente leitura
+  - [x] @developer - Removido git push, adicionado redirecionamento de workflow
+  - [x] @sprint-lead - Clarificado gerenciamento apenas de branch local
+  - [x] @quality-gate - Operações git somente leitura
   - [x] @github-devops - Criado com autoridade exclusiva de push
   - [x] @data-architect - Criado com especialização em dados
 
@@ -403,7 +403,7 @@ gh pr merge
   - [ ] Atualizar docs de onboarding de desenvolvedor
 
 - [ ] **Testes**
-  - Testar @dev tentando git push (deve ser bloqueado)
+  - Testar @developer tentando git push (deve ser bloqueado)
   - Testar @github-devops git push (deve funcionar)
   - Testar quality gates antes do push
   - Testar workflow de criação de PR
@@ -430,7 +430,7 @@ Se novos agentes forem adicionados via Squads:
 **Pontos-Chave**:
 1. ✅ Apenas @github-devops pode fazer push para repositório remoto (aplicado via git hooks)
 2. ✅ @architect gerencia arquitetura de sistema, @data-architect gerencia camada de dados
-3. ✅ @sm gerencia branches locais, @github-devops gerencia operações remotas
+3. ✅ @sprint-lead gerencia branches locais, @github-devops gerencia operações remotas
 4. ✅ Quality gates são obrigatórios antes de qualquer push
 5. ✅ Todos os agentes têm limites claros e documentados
 
@@ -440,5 +440,5 @@ Se novos agentes forem adicionados via Squads:
 
 ---
 
-*Documento mantido por @architect (Winston) e @po (Sarah)*
+*Documento mantido por @architect (Winston) e @product-lead (Sarah)*
 *Última revisão: 2025-10-25*

package/docs/pt/architecture/agent-tool-integration-guide.md

@@ -59,7 +59,7 @@ Agentes declaram suas dependências no bloco YAML dentro de seu arquivo de defin
 ### Exemplo de Declaração
 
 ```yaml
-# Do arquivo .sinapse-ai/development/agents/dev.md
+# Do arquivo .sinapse-ai/development/agents/developer.md
 dependencies:
   checklists:
     - story-dod-checklist.md
@@ -82,7 +82,7 @@ dependencies:
 
 ## Categorias de Ferramentas por Agente
 
-### @dev (Dex - Agente Desenvolvedor)
+### @developer (Dex - Agente Desenvolvedor)
 
 | Ferramenta   | Tipo     | Propósito                                    |
 | ------------ | -------- | -------------------------------------------- |
@@ -115,7 +115,7 @@ dependencies:
 - Único agente autorizado para criar/fazer merge de PRs
 - Gerenciamento de infraestrutura MCP
 
-### @qa (Quinn - Agente QA)
+### @quality-gate (Quinn - Agente QA)
 
 | Ferramenta   | Tipo | Propósito                          |
 | ------------ | ---- | ---------------------------------- |
@@ -141,8 +141,8 @@ Servidores MCP (Model Context Protocol) fornecem APIs estruturadas para uso de a
 | Servidor MCP | Ferramentas Fornecidas                                               | Usado Por        |
 | ------------ | -------------------------------------------------------------------- | ---------------- |
 | EXA          | `web_search_exa`, `company_research_exa`, `get_code_context_exa`    | @architect       |
-| Context7     | `resolve-library-id`, `query-docs`                                  | @dev, @architect |
-| Playwright   | `browser_navigate`, `browser_screenshot`, `browser_click`           | @qa              |
+| Context7     | `resolve-library-id`, `query-docs`                                  | @developer, @architect |
+| Playwright   | `browser_navigate`, `browser_screenshot`, `browser_click`           | @quality-gate              |
 | Apify        | `search-actors`, `call-actor`, `get-actor-output`                   | @devops          |
 
 ### Configuração de MCP
@@ -163,7 +163,7 @@ Servidores MCP são configurados via Docker MCP Toolkit. Veja [Gerenciamento de
 
 ## Integração CodeRabbit
 
-O agente @dev inclui CodeRabbit para verificações de qualidade pré-commit.
+O agente @developer inclui CodeRabbit para verificações de qualidade pré-commit.
 
 ### Configuração
 
@@ -237,9 +237,9 @@ git_permissions:
 ### Workflow de Handoff
 
 ```
-@dev completa a story
+@developer completa a story
     ↓
-@dev marca status: "Pronto para Revisão"
+@developer marca status: "Pronto para Revisão"
     ↓
 Usuário ativa @devops
     ↓

package/docs/pt/architecture/contribution-workflow-research.md

@@ -8,7 +8,7 @@
 
 **Story:** COLLAB-1
 **Data:** 2025-12-30
-**Autor:** @dev (Dex) + @devops (Gage)
+**Autor:** @developer (Dex) + @devops (Gage)
 **Status:** Completo
 
 ---

package/docs/pt/architecture/dashboard-architecture.md

@@ -109,7 +109,7 @@ O SINAPSE Dashboard é uma aplicação web Next.js que fornece uma interface vis
                                      │
 ┌─────────────────────────────────────────────────────────────────────────┐
 │                         CLI / SINAPSE AGENTS                                │
-│  @dev │ @qa │ @architect │ @pm │ @po │ @analyst │ @devops               │
+│  @developer │ @quality-gate │ @architect │ @project-lead │ @product-lead │ @analyst │ @devops               │
 └─────────────────────────────────────────────────────────────────────────┘
 ```
 

package/docs/pt/architecture/hcs-check-specifications.md

@@ -10,7 +10,7 @@
 **Status:** Proposto
 **Criado:** 2025-12-30
 **Story:** Investigação HCS-1
-**Autor:** @architect (Aria) via @dev (Dex)
+**Autor:** @architect (Aria) via @developer (Dex)
 
 ---
 

package/docs/pt/architecture/hcs-execution-modes.md

@@ -10,7 +10,7 @@
 **Status:** Proposto
 **Criado:** 2025-12-30
 **Story:** Investigação HCS-1
-**Autor:** @architect (Aria) via @dev (Dex)
+**Autor:** @architect (Aria) via @developer (Dex)
 
 ---
 

package/docs/pt/architecture/hcs-self-healing-spec.md

@@ -10,7 +10,7 @@
 **Status:** Proposto
 **Criado:** 2025-12-30
 **Story:** Investigação HCS-1
-**Autor:** @architect (Aria) via @dev (Dex)
+**Autor:** @architect (Aria) via @developer (Dex)
 
 ---
 

package/docs/pt/architecture/high-level-architecture.md

@@ -290,7 +290,7 @@ sinapse-ai/
 | Dara   | `data-engineer` | Architect    | Engenharia de dados       |
 | Felix  | `devops`        | Optimizer    | CI/CD e operações         |
 | Uma    | `ux-expert`     | Creator      | Experiência do usuário    |
-| Pax    | `sinapse-master`   | Orchestrator | Orquestração do framework |
+| Pax    | `sinapse-orqx`   | Orchestrator | Orquestração do framework |
 
 ---
 

package/docs/pt/architecture/module-system.md

@@ -168,7 +168,7 @@ const QualityGateManager = require('./.sinapse-ai/core/quality-gates/quality-gat
 
 | Agente          | ID                 | Responsabilidade          |
 | --------------- | ------------------ | ------------------------- |
-| SINAPSE Master     | `sinapse-master`      | Orquestração do framework |
+| SINAPSE Master     | `sinapse-orqx`      | Orquestração do framework |
 | Developer       | `dev`              | Implementação de código   |
 | QA              | `qa`               | Garantia de qualidade     |
 | Architect       | `architect`        | Arquitetura técnica       |

package/docs/pt/architecture/source-tree.md

@@ -134,7 +134,7 @@ sinapse-ai/                             # Raiz (projeto brownfield)
 ```
 .sinapse-ai/
 ├── agents/                            # 145 definições de agentes
-│   ├── sinapse-master.md                 # Orquestrador master
+│   ├── sinapse-orqx.md                 # Orquestrador master
 │   ├── dev.md                         # Agente desenvolvedor
 │   ├── qa.md                          # Agente engenheiro de QA
 │   ├── architect.md                   # Agente arquiteto de sistema

package/docs/pt/architecture/squad-improvement-recommended-approach.md

@@ -302,8 +302,8 @@ outputs:
 
 | Papel | Agente | Responsabilidades |
 |------|-------|------------------|
-| Principal | @dev (Dex) | Implementar scripts e tarefas |
-| Suporte | @qa (Quinn) | Testar implementação |
+| Principal | @developer (Dex) | Implementar scripts e tarefas |
+| Suporte | @quality-gate (Quinn) | Testar implementação |
 | Revisão | @architect (Aria) | Revisão de arquitetura |
 
 ---

package/docs/pt/architecture/utility-integration-guide.md

@@ -8,7 +8,7 @@
 
 **Versão:** 1.0.0
 **Criado em:** 2025-10-29
-**Autores:** Sarah (@po), Winston (@architect)
+**Autores:** Sarah (@product-lead), Winston (@architect)
 **Propósito:** Definir padrões para integração de scripts utilitários no framework SINAPSE
 
 ---
@@ -42,7 +42,7 @@ Um utilitário é considerado **totalmente integrado** quando:
 
 ```yaml
 # .sinapse-ai/agents/dev.yaml
-id: dev
+id: developer
 name: Agente de Desenvolvimento
 dependencies:
   utils:

package/docs/pt/contributing.md

@@ -226,7 +226,7 @@ Tasks sao workflows executaveis que agents podem rodar.
 # Nome da Task
 
 **Descricao:** O que esta task faz
-**Agent(s):** @dev, @qa, etc.
+**Agent(s):** @developer, @quality-gate, etc.
 **Elicit:** true | false
 
 ---

package/docs/pt/core-architecture.md

@@ -75,11 +75,11 @@ O diretório `sinapse-ai` contém todas as definições e recursos que dão aos
 
 ### 3.1. Agentes (`sinapse-ai/agents/`)
 
-- **Propósito**: Estes são os blocos fundamentais do sistema. Cada arquivo markdown (ex: `sinapse-master.md`, `pm.md`, `dev.md`) define a persona, capacidades e dependências de um único agente de IA.
+- **Propósito**: Estes são os blocos fundamentais do sistema. Cada arquivo markdown (ex: `sinapse-orqx.md`, `pm.md`, `dev.md`) define a persona, capacidades e dependências de um único agente de IA.
 - **Estrutura**: Um arquivo de agente contém um cabeçalho YAML que especifica seu papel, persona, dependências e instruções de inicialização. Estas dependências são listas de tasks, templates, checklists e arquivos de dados que o agente tem permissão para usar.
 - **Instruções de Inicialização**: Agentes podem incluir sequências de inicialização que carregam documentação específica do projeto da pasta `docs/`, como padrões de codificação, especificações de API ou documentos de estrutura do projeto. Isso fornece contexto imediato do projeto na ativação.
 - **Integração de Documentos**: Agentes podem referenciar e carregar documentos da pasta `docs/` do projeto como parte de tasks, workflows ou sequências de inicialização. Os usuários também podem arrastar documentos diretamente para interfaces de chat para fornecer contexto adicional.
-- **Exemplo**: O agente `sinapse-master` lista suas dependências, o que informa à ferramenta de build quais arquivos incluir em um bundle web e informa ao agente sobre suas próprias capacidades.
+- **Exemplo**: O agente `sinapse-orqx` lista suas dependências, o que informa à ferramenta de build quais arquivos incluir em um bundle web e informa ao agente sobre suas próprias capacidades.
 
 ### 3.2. Times de Agentes (`sinapse-ai/agent-teams/`)
 

package/docs/pt/framework/source-tree.md

@@ -134,7 +134,7 @@ sinapse-ai/                             # Root project
 │
 ├── development/                       # Assets de Desenvolvimento
 │   ├── agents/                        # Definições de agentes (11 agentes core)
-│   │   ├── sinapse-master.md             # Orquestrador master
+│   │   ├── sinapse-orqx.md             # Orquestrador master
 │   │   ├── dev.md                     # Agente desenvolvedor
 │   │   ├── qa.md                      # Agente engenheiro QA
 │   │   ├── architect.md               # Agente arquiteto de sistemas

package/docs/pt/guides/ade-guide.md

@@ -93,11 +93,11 @@ Requisição → Coletar → Avaliar → Pesquisar → Escrever → Criticar →
 
 | Agente     | Comando                | Fase                   |
 | ---------- | ---------------------- | ---------------------- |
-| @pm        | `*gather-requirements` | Coletar requisitos     |
+| @project-lead        | `*gather-requirements` | Coletar requisitos     |
 | @architect | `*assess-complexity`   | Avaliar complexidade   |
 | @analyst   | `*research-deps`       | Pesquisar dependências |
-| @pm        | `*write-spec`          | Escrever spec          |
-| @qa        | `*critique-spec`       | Criticar e aprovar     |
+| @project-lead        | `*write-spec`          | Escrever spec          |
+| @quality-gate        | `*critique-spec`       | Criticar e aprovar     |
 
 **Documentação:** [ADE-EPIC3-HANDOFF.md](../../architecture/ADE-EPIC3-HANDOFF.md)
 
@@ -130,7 +130,7 @@ Requisição → Coletar → Avaliar → Pesquisar → Escrever → Criticar →
 - `*create-plan` - Criar plano de implementação
 - `*create-context` - Gerar contexto do projeto
 
-**Comandos (@dev):**
+**Comandos (@developer):**
 
 - `*execute-subtask` - Executar subtask
 
@@ -148,7 +148,7 @@ Requisição → Coletar → Avaliar → Pesquisar → Escrever → Criticar →
 Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento → Rollback → Escalar
 ```
 
-**Comandos (@dev):**
+**Comandos (@developer):**
 
 - `*track-attempt` - Registrar tentativa
 - `*rollback` - Voltar para estado anterior
@@ -174,13 +174,13 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 9. Casos Extremos e Tratamento de Erros
 10. Resumo Final e Decisão
 
-**Comandos (@qa):**
+**Comandos (@quality-gate):**
 
 - `*review-build {story}` - Review completo
 - `*request-fix {issue}` - Solicitar correção
 - `*verify-fix {issue}` - Verificar correção
 
-**Comandos (@dev):**
+**Comandos (@developer):**
 
 - `*apply-qa-fix` - Aplicar correção do QA
 
@@ -199,7 +199,7 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 - **Gotchas** - Armadilhas conhecidas
 - **Decisions** - Decisões arquiteturais
 
-**Comandos (@dev):**
+**Comandos (@developer):**
 
 - `*capture-insights` - Capturar insights da sessão
 - `*list-gotchas` - Listar gotchas conhecidas
@@ -222,7 +222,7 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 
 ```bash
 # Ativar PM e coletar requisitos
-@pm *gather-requirements
+@project-lead *gather-requirements
 
 # Avaliar complexidade
 @architect *assess-complexity
@@ -231,10 +231,10 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 @analyst *research-deps
 
 # Escrever spec
-@pm *write-spec
+@project-lead *write-spec
 
 # Criticar e aprovar
-@qa *critique-spec
+@quality-gate *critique-spec
 ```
 
 ### 2. Executar Spec Aprovada
@@ -247,8 +247,8 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 @architect *create-context
 
 # Executar subtasks (loop)
-@dev *execute-subtask 1.1
-@dev *execute-subtask 1.2
+@developer *execute-subtask 1.1
+@developer *execute-subtask 1.2
 ...
 ```
 
@@ -256,22 +256,22 @@ Subtask Falha → Registrar Tentativa → Retry (<3) → Detectar Travamento →
 
 ```bash
 # Review estruturado
-@qa *review-build STORY-42
+@quality-gate *review-build STORY-42
 
 # Se há issues:
-@qa *request-fix "Falta tratamento de erro"
-@dev *apply-qa-fix
-@qa *verify-fix
+@quality-gate *request-fix "Falta tratamento de erro"
+@developer *apply-qa-fix
+@quality-gate *verify-fix
 ```
 
 ### 4. Capturar Aprendizado
 
 ```bash
 # Capturar insights da sessão
-@dev *capture-insights
+@developer *capture-insights
 
 # Documentar gotchas
-@dev *list-gotchas
+@developer *list-gotchas
 ```
 
 ---
@@ -380,7 +380,7 @@ autoClaude:
 Cada Epic tem um QA Gate que deve passar antes de prosseguir:
 
 ```bash
-@qa *gate epic-{N}-{name}
+@quality-gate *gate epic-{N}-{name}
 ```
 
 **Decisões:**
@@ -398,13 +398,13 @@ Cada Epic tem um QA Gate que deve passar antes de prosseguir:
 
 ```bash
 # Verificar histórico de tentativas
-@dev *track-attempt --status
+@developer *track-attempt --status
 
 # Rollback para último estado bom
-@dev *rollback --hard
+@developer *rollback --hard
 
 # Tentar abordagem diferente
-@dev *execute-subtask 2.1 --approach alternative
+@developer *execute-subtask 2.1 --approach alternative
 ```
 
 ### Spec não Aprovada
@@ -414,10 +414,10 @@ Cada Epic tem um QA Gate que deve passar antes de prosseguir:
 cat docs/stories/STORY-42/spec-critique.json
 
 # Refinar spec
-@pm *write-spec --iterate
+@project-lead *write-spec --iterate
 
 # Re-submeter para critique
-@qa *critique-spec
+@quality-gate *critique-spec
 ```
 
 ### Conflito no Worktree