sinapse-ai 5.0.8 → 6.0.1

package/docs/guides/coderabbit/README.md

@@ -2,7 +2,7 @@
 
 **Version:** 1.0.0
 **Last Updated:** 2026-01-28
-**Applicable Agents:** @qa (Quinn), @devops (Gage)
+**Applicable Agents:** @quality-gate (Quinn), @devops (Gage)
 
 ---
 
@@ -48,7 +48,7 @@ Layer 3: HUMAN REVIEW
 
 ## Agents Using CodeRabbit
 
-### @qa (Quinn) - Quality Assurance Agent
+### @quality-gate (Quinn) - Quality Assurance Agent
 
 Quinn uses CodeRabbit for comprehensive story reviews with self-healing capabilities.
 
@@ -113,7 +113,7 @@ wsl bash -c '~/.local/bin/coderabbit auth status'
 
 CodeRabbit is configured in agent definition files:
 
-**Location:** `.sinapse-ai/development/agents/qa.md` and `devops.md`
+**Location:** `.sinapse-ai/development/agents/quality-gate.md` and `devops.md`
 
 ```yaml
 coderabbit_integration:
@@ -185,7 +185,7 @@ CodeRabbit categorizes issues by severity:
 
 ## Self-Healing Workflow
 
-The @qa agent implements automatic issue resolution:
+The @quality-gate agent implements automatic issue resolution:
 
 ```
 iteration = 0
@@ -323,13 +323,13 @@ wsl bash -c 'cd /path/to/repo && ~/.local/bin/coderabbit --prompt-only --base ma
 
 ```
 1. Developer works on story
-   └── @dev implements changes
+   └── @developer implements changes
 
 2. Pre-commit quality (Layer 1)
    └── Husky runs lint, tests
 
 3. Ready for review
-   └── @qa *review {story}
+   └── @quality-gate *review {story}
        └── CodeRabbit scans (Layer 2)
        └── Self-healing if needed
        └── QA gate decision
@@ -367,8 +367,8 @@ CodeRabbit results are recorded in story files:
 
 | Role      | Agent | Responsibility              |
 | --------- | ----- | --------------------------- |
-| Primary   | @dev  | Implementation              |
-| Secondary | @qa   | CodeRabbit review + QA gate |
+| Primary   | @developer  | Implementation              |
+| Secondary | @quality-gate   | CodeRabbit review + QA gate |
 ```
 
 ---
@@ -389,7 +389,7 @@ docs/qa/coderabbit-reports/
 ## Related Documentation
 
 - [Quality Gates Specification](../../../.sinapse-ai/docs/standards/QUALITY-GATES-SPECIFICATION.md)
-- [@qa Agent Definition](../../../.sinapse-ai/development/agents/qa.md)
+- [@quality-gate Agent Definition](../../../.sinapse-ai/development/agents/quality-gate.md)
 - [@devops Agent Definition](../../../.sinapse-ai/development/agents/devops.md)
 - [Pre-Push Quality Gate Task](../../../.sinapse-ai/development/tasks/github-devops-pre-push-quality-gate.md)
 

package/docs/guides/contextual-greeting-system-guide.md

@@ -277,9 +277,9 @@ builder.buildGreeting(mockAgent, { conversationHistory: [] })
 Quando a integração com o processo de ativação estiver implementada (Story 6.1.4/6.1.6), o sistema funcionará automaticamente ao ativar qualquer agente:
 
 ```
-@dev              → Greeting contextual automático
-@po               → Greeting contextual automático
-@qa               → Greeting contextual automático
+@developer              → Greeting contextual automático
+@product-lead               → Greeting contextual automático
+@quality-gate               → Greeting contextual automático
 ```
 
 ## 📁 Arquivos Relacionados
@@ -304,8 +304,8 @@ Quando a integração com o processo de ativação estiver implementada (Story 6
 - `.sinapse-ai/core-config.yaml` - Configuração global (git + agentIdentity sections)
 
 ### Agents (Updated)
-- `.sinapse-ai/agents/dev.md` - ✅ Command visibility metadata
-- `.sinapse-ai/agents/po.md` - ✅ Command visibility metadata
+- `.sinapse-ai/agents/developer.md` - ✅ Command visibility metadata
+- `.sinapse-ai/agents/product-lead.md` - ✅ Command visibility metadata
 - `.sinapse-ai/agents/*.md` - ⏳ Remaining 9 agents (pending update)
 
 ## 🎯 Próximos Passos

package/docs/guides/development-setup.md

@@ -703,7 +703,7 @@ stages:
   - id: stage-3-implement
     name: Implementation Phase
     description: Code implementation
-    agent: dev
+    agent: developer
     tasks:
       - develop-story
     outputs:

package/docs/guides/project-status-feature.md

@@ -225,7 +225,7 @@ All 11 SINAPSE agents display project status:
 8. **@devops** (Gage - Operator)
 9. **@data-engineer** (Dara - Sage)
 10. **@ux-design-expert** (Uma - Empathizer)
-11. **@sinapse-master** (Orion - Orchestrator)
+11. **@sinapse-orqx** (Orion - Orchestrator)
 
 ---
 
@@ -417,7 +417,7 @@ git --version
 
 Potential improvements (not yet implemented):
 
-- [ ] Per-agent status toggle (e.g., disable for @qa only)
+- [ ] Per-agent status toggle (e.g., disable for @quality-gate only)
 - [ ] Color-coded status indicators (🟢 clean, 🟡 modified, 🔴 conflicts)
 - [ ] Story progress percentage (completed tasks / total)
 - [ ] Estimated time to complete current story

package/docs/guides/quality-dashboard.md

@@ -118,7 +118,7 @@ Each quality gate layer has its own metrics card:
 | ----------------------- | ---------------------------------------- |
 | **Pass Rate**           | % of PRs passing automated review        |
 | **CodeRabbit Findings** | Issues found by CodeRabbit (by severity) |
-| **Quinn Findings**      | Issues found by @qa agent                |
+| **Quinn Findings**      | Issues found by @quality-gate agent                |
 | **Auto-Catch Rate**     | % of issues caught before human review   |
 
 **Expanded View (click to expand):**
@@ -136,7 +136,7 @@ Each quality gate layer has its own metrics card:
 │  └─────────────────────────────────────────────────┘   │
 │                                                         │
 │  ┌─────────────────────────────────────────────────┐   │
-│  │ Quinn (@qa) Findings                            │   │
+│  │ Quinn (@quality-gate) Findings                            │   │
 │  │ Blockers: 2  │  Warnings: 8  │  Info: 15       │   │
 │  └─────────────────────────────────────────────────┘   │
 │                                                         │

package/docs/guides/quality-gates.md

@@ -139,7 +139,7 @@ AI-assisted code review that runs on pull requests. Catches deeper issues like l
 | Tool            | Purpose             | Blocking Severity |
 | --------------- | ------------------- | ----------------- |
 | **CodeRabbit**  | AI code review      | CRITICAL          |
-| **Quinn (@qa)** | Automated QA review | CRITICAL          |
+| **Quinn (@quality-gate)** | Automated QA review | CRITICAL          |
 
 ### Configuration
 
@@ -162,7 +162,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/qa.md'
+    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
     severity:
       block: ['CRITICAL']
       warn: ['HIGH', 'MEDIUM']
@@ -177,7 +177,7 @@ sinapse qa run --layer=2
 # Run CodeRabbit only
 sinapse qa run --layer=2 --tool=coderabbit
 
-# Run Quinn (@qa) review
+# Run Quinn (@quality-gate) review
 sinapse qa run --layer=2 --tool=quinn
 ```
 
@@ -208,7 +208,7 @@ coderabbit --prompt-only -t uncommitted
 coderabbit --files "src/**/*.js" --prompt-only
 ```
 
-### Quinn (@qa) Integration
+### Quinn (@quality-gate) Integration
 
 The QA agent performs automated review focused on:
 
@@ -528,7 +528,7 @@ layer2:
   quinn:
     enabled: true
     autoReview: true
-    agentPath: '.claude/commands/SINAPSE/agents/qa.md'
+    agentPath: '.claude/commands/SINAPSE/agents/quality-gate.md'
     severity:
       block: [CRITICAL]
       warn: [HIGH, MEDIUM]
@@ -586,7 +586,7 @@ verbose:
 | ------------------- | --------------------------------------- |
 | CodeRabbit critical | Address security/breaking change issues |
 | CodeRabbit timeout  | Check network, try manual run           |
-| Quinn blocked       | Review @qa feedback, update code        |
+| Quinn blocked       | Review @quality-gate feedback, update code        |
 
 ### Layer 3 Issues
 

package/docs/guides/template-engine-v2.md

@@ -48,7 +48,7 @@ Date: {{DATE}}
 
 const variables = {
   TITLE: 'My Document',
-  AUTHOR: 'Dex (@dev)',
+  AUTHOR: 'Dex (@developer)',
   DATE: '2025-12-05',
   SUMMARY: 'This is a generated document.',
 };
@@ -62,7 +62,7 @@ console.log(output);
 ```markdown
 # My Document
 
-Created by: Dex (@dev)
+Created by: Dex (@developer)
 Date: 2025-12-05
 
 ## Summary

package/docs/guides/user-guide.md

@@ -89,16 +89,16 @@ SINAPSE includes 11 specialized agents, each with a distinct role and personalit
 | **Dara**  | `@data-engineer` | Architect    | Data engineering        |
 | **Felix** | `@devops`        | Optimizer    | CI/CD and operations    |
 | **Uma**   | `@ux-expert`     | Creator      | User experience         |
-| **Pax**   | `@sinapse-master`   | Orchestrator | Framework orchestration |
+| **Pax**   | `@sinapse-orqx`   | Orchestrator | Framework orchestration |
 
 ### Agent Activation
 
 ```bash
 # Activate an agent using @ syntax
-@dev                # Activate Dex (Developer)
-@qa                 # Activate Quinn (QA)
+@developer                # Activate Dex (Developer)
+@quality-gate                 # Activate Quinn (QA)
 @architect          # Activate Aria (Architect)
-@sinapse-master        # Activate Pax (Orchestrator)
+@sinapse-orqx        # Activate Pax (Orchestrator)
 
 # Agent commands use * prefix
 *help               # Show available commands
@@ -147,11 +147,11 @@ Each command has exactly one authoritative agent owner. When multiple agents mig
 
 | Command        | Owner      | Others Should...                |
 |----------------|------------|---------------------------------|
-| `*create-prd`  | @pm        | Delegate to @pm                 |
-| `*create-epic` | @pm        | Delegate to @pm                 |
-| `*draft`       | @sm        | Use @sm for story creation      |
-| `*develop`     | @dev       | Use @dev for implementation     |
-| `*review`      | @qa        | Use @qa for code review         |
+| `*create-prd`  | @project-lead        | Delegate to @project-lead                 |
+| `*create-epic` | @project-lead        | Delegate to @project-lead                 |
+| `*draft`       | @sprint-lead        | Use @sprint-lead for story creation      |
+| `*develop`     | @developer       | Use @developer for implementation     |
+| `*review`      | @quality-gate        | Use @quality-gate for code review         |
 
 See the [Command Authority Matrix](../architecture/command-authority-matrix.md) for the complete mapping.
 
@@ -432,7 +432,7 @@ sinapse rebuild
 Always create a story before implementing features:
 
 ```bash
-@sinapse-master
+@sinapse-orqx
 *create-story
 ```
 
@@ -442,10 +442,10 @@ Choose the appropriate agent for each task:
 
 | Task                | Agent      |
 | ------------------- | ---------- |
-| Write code          | @dev       |
-| Review code         | @qa        |
+| Write code          | @developer       |
+| Review code         | @quality-gate        |
 | Design system       | @architect |
-| Define requirements | @po        |
+| Define requirements | @product-lead        |
 
 ### 3. Follow Quality Gates
 

package/docs/guides/workflows/AUTO-WORKTREE-WORKFLOW.md

@@ -407,14 +407,14 @@ Alteracoes aqui nao afetam a branch principal ate o merge.
 - `*merge-worktree {storyId}` - Fazer merge da worktree
 - `*cleanup-worktrees` - Limpar worktrees obsoletas
 
-### @dev (Desenvolvedor)
+### @developer (Desenvolvedor)
 
 | Responsabilidade | Descricao |
 |------------------|-----------|
 | **Trigger Primario** | Inicia o workflow ao comecar uma story |
 | **Desenvolvimento** | Trabalha dentro da worktree isolada |
 
-### @po (Product Owner)
+### @product-lead (Product Owner)
 
 | Responsabilidade | Descricao |
 |------------------|-----------|
@@ -574,7 +574,7 @@ flowchart TD
 | Configuracao | Default | Impacto |
 |--------------|---------|---------|
 | `enabled` | true | Habilita/desabilita o workflow |
-| `createOnAssign` | false | Cria worktree quando @po atribui story |
+| `createOnAssign` | false | Cria worktree quando @product-lead atribui story |
 | `autoSwitch` | true | Muda automaticamente para a worktree |
 | `verbose` | true | Exibe resumo ao final |
 | `autoCleanup` | false | Limpa worktrees obsoletas automaticamente |

package/docs/guides/workflows/BROWNFIELD-DISCOVERY-WORKFLOW.md

@@ -604,8 +604,8 @@ mindmap
 | `db-schema-audit` | @data-engineer | 2 | Auditoria de schema de banco |
 | `security-audit` | @data-engineer | 2 | Auditoria de seguranca (RLS, PII) |
 | `create-front-end-spec` | @ux-design-expert | 3 | Especificacao de frontend |
-| `brownfield-create-epic` | @pm | 10 | Criacao de epic de debito tecnico |
-| `brownfield-create-story` | @pm | 10 | Criacao de stories (repetivel) |
+| `brownfield-create-epic` | @project-lead | 10 | Criacao de epic de debito tecnico |
+| `brownfield-create-story` | @project-lead | 10 | Criacao de stories (repetivel) |
 
 ### Acoes Manuais (workflow-action)
 
@@ -614,7 +614,7 @@ mindmap
 | `consolidate_findings_draft` | @architect | 4 | Consolidar DRAFT inicial |
 | `review_and_validate` | @data-engineer | 5 | Validar debitos de DB |
 | `review_and_validate` | @ux-design-expert | 6 | Validar debitos de UX |
-| `review_assessment` | @qa | 7 | Quality Gate review |
+| `review_assessment` | @quality-gate | 7 | Quality Gate review |
 | `finalize_assessment` | @architect | 8 | Assessment final |
 | `create_awareness_report` | @analyst | 9 | Relatorio executivo |
 
@@ -641,7 +641,7 @@ mindmap
 | `git` | @architect | Analise de repositorio |
 | `supabase-cli` | @data-engineer | Auditoria de database |
 | `psql` | @data-engineer | Queries de auditoria |
-| `coderabbit` | @qa | Review automatizado de codigo |
+| `coderabbit` | @quality-gate | Review automatizado de codigo |
 | `exa` | @analyst | Pesquisa de mercado/benchmark |
 
 ---
@@ -877,9 +877,9 @@ flowchart TD
 | @architect | `.sinapse-ai/development/agents/architect.md` |
 | @data-engineer | `.sinapse-ai/development/agents/data-engineer.md` |
 | @ux-design-expert | `.sinapse-ai/development/agents/ux-design-expert.md` |
-| @qa | `.sinapse-ai/development/agents/qa.md` |
+| @quality-gate | `.sinapse-ai/development/agents/quality-gate.md` |
 | @analyst | `.sinapse-ai/development/agents/analyst.md` |
-| @pm | `.sinapse-ai/development/agents/pm.md` |
+| @project-lead | `.sinapse-ai/development/agents/project-lead.md` |
 
 ### Documentacao Relacionada
 

package/docs/guides/workflows/BROWNFIELD-FULLSTACK-WORKFLOW.md

@@ -192,8 +192,8 @@ O analista determina a complexidade do enhancement para rotear ao caminho apropr
 
 | Rota | Agente | Task | Proxima Acao |
 |------|--------|------|--------------|
-| `single_story` | @pm | `brownfield-create-story` | Sair do workflow apos criacao da story |
-| `small_feature` | @pm | `brownfield-create-epic` | Sair do workflow apos criacao do epic |
+| `single_story` | @project-lead | `brownfield-create-story` | Sair do workflow apos criacao da story |
+| `small_feature` | @project-lead | `brownfield-create-epic` | Sair do workflow apos criacao do epic |
 | `major_enhancement` | - | - | Continuar para o proximo step |
 
 ---
@@ -244,7 +244,7 @@ Capturar o estado atual do sistema, divida tecnica e restricoes. Os achados sao
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @pm (Morgan) |
+| **Agente** | @project-lead (Morgan) |
 | **Template** | `brownfield-prd-tmpl` |
 | **Requisito** | Documentacao existente ou analise do Step 4 |
 | **Output** | `docs/prd.md` |
@@ -261,7 +261,7 @@ Capturar o estado atual do sistema, divida tecnica e restricoes. Os achados sao
 
 | Atributo | Valor |
 |----------|-------|
-| **Agentes** | @pm (Morgan) / @architect (Aria) |
+| **Agentes** | @project-lead (Morgan) / @architect (Aria) |
 | **Acao** | Determinar se documento de arquitetura e necessario |
 | **Condicao** | Apos criacao do PRD |
 
@@ -296,7 +296,7 @@ Crie documento de arquitetura APENAS para mudancas arquiteturais significativas.
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @po (Pax) |
+| **Agente** | @product-lead (Pax) |
 | **Checklist** | `po-master-checklist` |
 | **Input** | Todos os artefatos criados |
 | **Output** | Validacao ou lista de issues |
@@ -334,7 +334,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @po (Pax) |
+| **Agente** | @product-lead (Pax) |
 | **Task** | `shard-doc` |
 | **Input** | Documentos validados no projeto |
 | **Output** | `docs/prd/` e `docs/architecture/` com conteudo fragmentado |
@@ -352,7 +352,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @sm (River) |
+| **Agente** | @sprint-lead (River) |
 | **Repete** | Para cada epic ou enhancement |
 | **Input** | Documentos fragmentados ou docs brownfield |
 | **Output** | `story.md` em status "Draft" |
@@ -374,7 +374,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agentes** | @analyst / @pm |
+| **Agentes** | @analyst / @project-lead |
 | **Condicao** | Usuario deseja revisao da story |
 | **Input** | `story.md` em Draft |
 | **Output** | Story atualizada: Draft -> Approved |
@@ -387,7 +387,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @dev (Dex) |
+| **Agente** | @developer (Dex) |
 | **Requisito** | Story aprovada |
 | **Output** | Arquivos de implementacao |
 
@@ -404,7 +404,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @qa (Quinn) |
+| **Agente** | @quality-gate (Quinn) |
 | **Task** | `review-story` |
 | **Requisito** | Arquivos implementados |
 | **Output** | Implementacao revisada |
@@ -423,7 +423,7 @@ Valida todos os documentos quanto a:
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @dev (Dex) |
+| **Agente** | @developer (Dex) |
 | **Condicao** | QA deixou itens nao verificados |
 | **Acao** | Endereca itens restantes |
 
@@ -446,7 +446,7 @@ Continua ate que todas as stories no PRD estejam completas.
 
 | Atributo | Valor |
 |----------|-------|
-| **Agente** | @po (Pax) |
+| **Agente** | @product-lead (Pax) |
 | **Condicao** | Epic completo |
 | **Output** | `epic-retrospective.md` |
 
@@ -473,11 +473,11 @@ Continua ate que todas as stories no PRD estejam completas.
 |--------|------|-------------------|-------|
 | @analyst | Atlas | Classificacao de escopo, verificacao de documentacao | 1, 3 |
 | @architect | Aria | Documentacao de projeto, design de arquitetura | 4, 6, 7 |
-| @pm | Morgan | Criacao de PRD, epics e stories simples | 2, 5, 6 |
-| @po | Pax | Validacao de artefatos, sharding, retrospectiva | 8, 10, 17 |
-| @sm | River | Criacao detalhada de stories | 11 |
-| @dev | Dex | Implementacao de stories | 13, 15 |
-| @qa | Quinn | Review de implementacao | 14 |
+| @project-lead | Morgan | Criacao de PRD, epics e stories simples | 2, 5, 6 |
+| @product-lead | Pax | Validacao de artefatos, sharding, retrospectiva | 8, 10, 17 |
+| @sprint-lead | River | Criacao detalhada de stories | 11 |
+| @developer | Dex | Implementacao de stories | 13, 15 |
+| @quality-gate | Quinn | Review de implementacao | 14 |
 
 ---
 
@@ -485,16 +485,16 @@ Continua ate que todas as stories no PRD estejam completas.
 
 | Task | Step | Agente | Proposito |
 |------|------|--------|-----------|
-| `brownfield-create-story` | 2 | @pm | Criar story unica para enhancements simples |
-| `brownfield-create-epic` | 2 | @pm | Criar epic focado com 1-3 stories |
+| `brownfield-create-story` | 2 | @project-lead | Criar story unica para enhancements simples |
+| `brownfield-create-epic` | 2 | @project-lead | Criar epic focado com 1-3 stories |
 | `document-project` | 4 | @architect | Documentar estado atual do sistema brownfield |
-| `brownfield-prd-tmpl` | 5 | @pm | Template para PRD de projeto brownfield |
+| `brownfield-prd-tmpl` | 5 | @project-lead | Template para PRD de projeto brownfield |
 | `brownfield-architecture-tmpl` | 7 | @architect | Template para arquitetura brownfield |
-| `po-master-checklist` | 8 | @po | Validacao abrangente de artefatos |
-| `shard-doc` | 10 | @po | Fragmentar documentos em arquivos menores |
-| `create-next-story` | 11 | @sm | Criar story de PRD sharded |
-| `create-brownfield-story` | 11 | @sm | Criar story de docs brownfield |
-| `review-story` | 14 | @qa | Review de implementacao |
+| `po-master-checklist` | 8 | @product-lead | Validacao abrangente de artefatos |
+| `shard-doc` | 10 | @product-lead | Fragmentar documentos em arquivos menores |
+| `create-next-story` | 11 | @sprint-lead | Criar story de PRD sharded |
+| `create-brownfield-story` | 11 | @sprint-lead | Criar story de docs brownfield |
+| `review-story` | 14 | @quality-gate | Review de implementacao |
 
 ---
 
@@ -811,11 +811,11 @@ stateDiagram-v2
 |---------|--------|
 | `.sinapse-ai/development/agents/analyst.md` | @analyst (Atlas) |
 | `.sinapse-ai/development/agents/architect.md` | @architect (Aria) |
-| `.sinapse-ai/development/agents/pm.md` | @pm (Morgan) |
-| `.sinapse-ai/development/agents/po.md` | @po (Pax) |
-| `.sinapse-ai/development/agents/sm.md` | @sm (River) |
-| `.sinapse-ai/development/agents/dev.md` | @dev (Dex) |
-| `.sinapse-ai/development/agents/qa.md` | @qa (Quinn) |
+| `.sinapse-ai/development/agents/project-lead.md` | @project-lead (Morgan) |
+| `.sinapse-ai/development/agents/product-lead.md` | @product-lead (Pax) |
+| `.sinapse-ai/development/agents/sprint-lead.md` | @sprint-lead (River) |
+| `.sinapse-ai/development/agents/developer.md` | @developer (Dex) |
+| `.sinapse-ai/development/agents/quality-gate.md` | @quality-gate (Quinn) |
 
 ### Documentacao Relacionada