synapos 2.5.0

package/.synapos/squad-templates/backend/pipelines/steps/bfbe-03-fix.md

@@ -0,0 +1,41 @@
+---
+id: bfbe-03-fix
+name: "Fix Backend"
+agent: alexandre-api
+execution: subagent
+model_tier: powerful
+veto_conditions:
+  - "Fix introduz SQL por concatenação"
+  - "Fix remove tratamento de erro existente"
+  - "Fix sem teste de regressão"
+on_reject: bfbe-03-fix
+---
+
+# Fix de Bug Backend
+
+Você é **Alexandre API**. Leia seu `.agent.md`.
+
+## Contexto
+
+- Diagnóstico: saída do step bfbe-02-diagnostico
+
+## Regras do fix
+
+1. **Mínimo viável** — corrija apenas o que está errado
+2. **Não degrade segurança** — nunca remova validação ou tratamento de erro
+3. **Teste de regressão** — adicione teste que cobre o bug
+4. **Explique** — se a causa raiz não for óbvia, adicione comentário
+
+## Estrutura de entrega
+
+```
+Arquivo: {caminho}
+Mudança: {descrição}
+{código do fix}
+
+Teste de regressão:
+{teste que falha antes do fix e passa depois}
+
+Sem regressão em:
+- {comportamento preservado}
+```

package/.synapos/squad-templates/backend/pipelines/steps/bfbe-04-review.md

@@ -0,0 +1,42 @@
+---
+id: bfbe-04-review
+name: "Review do Fix Backend"
+agent: roberto-revisao-be
+execution: inline
+model_tier: powerful
+gate: GATE-5
+output_files:
+  - bugfix-notes.md
+---
+
+# Review do Fix Backend
+
+Você é **Roberto Revisão**.
+
+## Checklist específica para bug fix
+
+- [ ] Fix resolve o problema descrito?
+- [ ] Fix é mínimo (não toca código não relacionado)?
+- [ ] Nenhuma segurança degradada?
+- [ ] Teste de regressão adicionado?
+- [ ] Sem SQL por concatenação introduzido?
+
+## Gerar `docs/bugfix-notes.md`
+
+```markdown
+# Bugfix Notes
+
+**Data:** {YYYY-MM-DD}
+**Bug:** {descrição}
+
+## Causa Raiz
+{diagnóstico confirmado}
+
+## Fix
+{o que foi alterado}
+
+## Teste de Regressão
+{teste adicionado}
+
+## Review: {Aprovado | Requer ajuste: {o que}}
+```

package/.synapos/squad-templates/backend/pipelines/steps/dm-02-schema.md

@@ -0,0 +1,85 @@
+---
+id: dm-02-schema
+name: "Design do Schema"
+agent: daniela-dados
+execution: subagent
+model_tier: powerful
+output_files:
+  - schema-design.md
+veto_conditions:
+  - "Tabela sem timestamps"
+  - "FK sem constraint"
+  - "Migration sem rollback"
+  - "Índice sem justificativa"
+---
+
+# Design do Schema
+
+Você é **Daniela Dados**. Leia seu `.agent.md`.
+
+## Contexto disponível
+
+- Task desta sessão: `_memory/memories.md`
+- Memória do squad: padrões aprovados
+
+## Documento a gerar
+
+### `docs/schema-design.md`
+
+```markdown
+# Schema Design: {nome da mudança}
+
+**Data:** {YYYY-MM-DD}
+
+## Mudanças Propostas
+
+### Novas Tabelas
+
+```sql
+CREATE TABLE {nome_tabela} (
+  id          UUID PRIMARY KEY DEFAULT gen_random_uuid(),
+  -- campos específicos
+  -- constraints CHECK para valores enumerados
+  created_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at  TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  deleted_at  TIMESTAMPTZ  -- soft delete, se aplicável
+);
+```
+
+### Alterações em Tabelas Existentes
+
+```sql
+-- Para cada ALTER TABLE: analise o impacto em dados existentes
+ALTER TABLE {tabela} ADD COLUMN {coluna} {tipo} {constraints};
+-- Impacto: {N} registros existentes | default aplicado: {valor}
+```
+
+### Índices
+
+```sql
+-- Justificativa de cada índice: qual query serve?
+CREATE INDEX idx_{tabela}_{coluna} ON {tabela}({coluna})
+  WHERE {condição};  -- partial index quando possível
+-- Serve para: SELECT ... WHERE {coluna} = ?
+-- Volume estimado: {N} linhas
+```
+
+## Análise de Impacto
+
+### Dados Existentes
+{como a migration afeta registros existentes}
+
+### Performance
+{queries beneficiadas pelos novos índices}
+{queries que podem ser afetadas negativamente}
+
+### Rollback
+{como desfazer — ALTER TABLE DROP COLUMN, DROP TABLE, DROP INDEX}
+```
+
+## Critérios de qualidade
+- [ ] Todas as tabelas com created_at e updated_at
+- [ ] FKs com ON DELETE definido (CASCADE ou RESTRICT — nunca omitir)
+- [ ] CHECK constraints para campos enumerados
+- [ ] Cada índice com justificativa da query que serve
+- [ ] Impacto em dados existentes analisado

package/.synapos/squad-templates/backend/pipelines/steps/dm-03-checkpoint.md

@@ -0,0 +1,30 @@
+---
+id: dm-03-checkpoint
+name: "Aprovação do Schema"
+execution: checkpoint
+---
+
+# Checkpoint — Aprovação do Schema
+
+Antes de escrever a migration, o usuário valida o design.
+
+## Apresentar resumo
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+SCHEMA PROPOSTO
+
+{lista de tabelas criadas/alteradas}
+
+Índices: {N} novos
+Impacto em dados existentes: {resumo}
+Rollback possível: {Sim | Atenção: {restrição}}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Pergunta
+
+```
+[1] Aprovado — gerar migration
+[2] Ajustar schema — {o que mudar?}
+```

package/.synapos/squad-templates/backend/pipelines/steps/dm-04-migration.md

@@ -0,0 +1,58 @@
+---
+id: dm-04-migration
+name: "Migration SQL"
+agent: daniela-dados
+execution: subagent
+model_tier: powerful
+output_files:
+  - migration.sql
+veto_conditions:
+  - "Migration sem BEGIN/COMMIT"
+  - "Sem seção DOWN (rollback)"
+  - "ALTER TABLE sem análise de impacto"
+---
+
+# Migration SQL
+
+Você é **Daniela Dados**. Leia seu `.agent.md`.
+
+## Contexto disponível
+
+- Schema design: `docs/schema-design.md` ← gere a migration exatamente conforme aqui
+
+## Documento a gerar
+
+### `docs/migration.sql`
+
+```sql
+-- Migration: {nome descritivo}
+-- Data: {YYYY-MM-DD}
+-- Descrição: {o que esta migration faz}
+-- Rollback: ver seção DOWN
+
+-- ============================================================
+-- UP
+-- ============================================================
+BEGIN;
+
+-- {comentário explicando cada bloco}
+{SQL de criação/alteração}
+
+COMMIT;
+
+-- ============================================================
+-- DOWN (rollback)
+-- ============================================================
+-- ATENÇÃO: execute apenas se necessário reverter
+-- BEGIN;
+-- {SQL de rollback}
+-- COMMIT;
+```
+
+## Regras obrigatórias
+
+1. **Sempre transacional** — BEGIN/COMMIT em tudo
+2. **Rollback documentado** — mesmo que seja `DROP TABLE`
+3. **Comentários** — explique cada ALTER TABLE não óbvio
+4. **Dados existentes** — se altera coluna com dados, adicione UPDATE ou DEFAULT explícito
+5. **Nomenclatura** — nome do arquivo: `{YYYY-MM-DD}_{descricao_slug}.sql`

package/.synapos/squad-templates/backend/pipelines/steps/dm-05-review.md

@@ -0,0 +1,44 @@
+---
+id: dm-05-review
+name: "Review da Migration"
+agent: roberto-revisao-be
+execution: inline
+model_tier: powerful
+gate: GATE-5
+output_files:
+  - migration-review.md
+---
+
+# Review da Migration
+
+Você é **Roberto Revisão**. Foque em segurança de dados e reversibilidade.
+
+## Checklist específica para migrations
+
+- [ ] Migration é transacional (BEGIN/COMMIT)?
+- [ ] DOWN (rollback) documentado e executável?
+- [ ] ALTER TABLE com dados existentes tem tratamento?
+- [ ] Nenhuma coluna NOT NULL adicionada sem DEFAULT em tabela com dados?
+- [ ] FKs têm ON DELETE definido?
+- [ ] Índices têm justificativa?
+- [ ] Nome da migration é descritivo?
+
+## Gerar `docs/migration-review.md`
+
+```markdown
+# Migration Review
+
+**Data:** {YYYY-MM-DD}
+
+## Checklist
+{resultado de cada item}
+
+## Riscos Identificados
+{se houver: descreva o risco e a mitigação}
+
+## Decisão
+{Aprovado para staging | Requer ajuste: {o que}}
+
+## Recomendações de Deploy
+{ordem de execução se múltiplas migrations, backfill necessário, etc.}
+```

package/.synapos/squad-templates/backend/pipelines/steps/qf-02-contexto.md

@@ -0,0 +1,34 @@
+---
+id: qf-02-contexto
+name: "Contexto Rápido"
+execution: inline
+model_tier: fast
+---
+
+# Contexto Rápido — Quick Fix
+
+Colete o contexto mínimo necessário antes de executar.
+
+Pergunte ao usuário:
+
+```
+O que precisa ser feito?
+(seja específico — isso vai direto para o agent executor)
+```
+
+Com a resposta, apresente um resumo de validação e aguarde confirmação:
+
+```
+CONTEXTO
+
+Objetivo: {o que foi descrito}
+Escopo: {o que está incluído}
+Fora do escopo: {o que NÃO deve ser tocado}
+Risco identificado: {se houver — senão "nenhum"}
+
+Prosseguir com este escopo?
+```
+
+Se confirmado → salve em `docs/quick-fix-contexto.md` e prossiga imediatamente.
+
+Se ajuste → colete o novo escopo e salve.

package/.synapos/squad-templates/backend/pipelines/steps/qf-03-executar.md

@@ -0,0 +1,49 @@
+---
+id: qf-03-executar
+name: "Executar"
+agent: alexandre-api
+execution: subagent
+model_tier: powerful
+output_files:
+  - quick-fix-output.md
+veto_conditions:
+  - "Mudança vai além do escopo descrito no contexto"
+  - "Output vazio ou sem implementação concreta"
+---
+
+# Execução Quick Fix — Backend
+
+Você é **Alexandre API**, dev backend. Implemente a mudança descrita no contexto coletado.
+
+## Regras do quick-fix
+
+- Implemente **apenas** o que foi solicitado — sem refatorações adjacentes
+- Se identificar um problema maior, **registre em `docs/quick-fix-output.md` mas não corrija agora**
+- Prefira a solução mais simples que resolve o problema
+- Para mudanças em banco: documente o impacto e se é reversível
+- Documente decisões não óbvias como comentários inline
+
+## Output obrigatório
+
+Salve em `docs/quick-fix-output.md`:
+
+```markdown
+# Quick Fix Output — Backend
+Data: {YYYY-MM-DD}
+Objetivo: {o que foi feito em 1 linha}
+
+## Implementação
+{descrição do que foi feito}
+
+## Arquivos modificados
+- {arquivo}: {o que mudou}
+
+## Decisões técnicas
+{escolhas feitas e por quê}
+
+## Impacto em banco / migrations
+{se houver — senão "nenhum"}
+
+## Observações fora do escopo
+{problemas encontrados mas não corrigidos — se houver}
+```

package/.synapos/squad-templates/backend/pipelines/steps/qf-04-registrar.md

@@ -0,0 +1,35 @@
+---
+id: qf-04-registrar
+name: "Registrar Decisão"
+execution: inline
+model_tier: fast
+output_files:
+  - quick-fix-log.md
+gate: GATE-5
+---
+
+# Registrar Decisão
+
+Consolide o quick fix para memória futura.
+
+Crie `docs/quick-fix-log.md`:
+
+```markdown
+# Quick Fix Log
+Data: {YYYY-MM-DD}
+Objetivo: {resumo em 1 linha}
+
+O que foi feito: {2-3 frases}
+Decisão técnica: {por que esta abordagem}
+Impacto: {o que isso afeta no sistema}
+```
+
+Adicione entrada em `docs/.squads/{slug}/_memory/memories.md`:
+
+```markdown
+## Quick Fix — {YYYY-MM-DD}
+{objetivo em 1 linha}
+Abordagem: {decisão técnica em 1 frase}
+```
+
+Pipeline concluído.

package/.synapos/squad-templates/backend/template.yaml

@@ -0,0 +1,72 @@
+name: backend
+displayName: "Squad de Backend"
+icon: "⚙️"
+version: "1.0.0"
+description: "Especialistas em desenvolvimento backend com foco em APIs robustas, segurança e escalabilidade"
+
+agents:
+  base:
+    - id: bruno-base
+      file: agents/bruno-base.agent.md
+      displayName: "Bruno Base"
+      icon: "🏗️"
+      role: "Arquiteto Backend"
+    - id: alexandre-api
+      file: agents/alexandre-api.agent.md
+      displayName: "Alexandre API"
+      icon: "🔌"
+      role: "Dev Backend"
+    - id: roberto-revisao-be
+      file: agents/roberto-revisao-be.agent.md
+      displayName: "Roberto Revisão"
+      icon: "🔍"
+      role: "Reviewer Backend"
+  optional:
+    - id: daniela-dados
+      file: agents/daniela-dados.agent.md
+      displayName: "Daniela Dados"
+      icon: "🗄️"
+      role: "Arquiteta de Dados"
+    - id: sergio-seguranca
+      file: agents/sergio-seguranca.agent.md
+      displayName: "Sérgio Segurança"
+      icon: "🔒"
+      role: "Engenheiro de Segurança"
+    - id: leo-engenheiro
+      file: ../engineer/agents/leo-engenheiro.agent.md
+      displayName: "Leo Engenheiro"
+      icon: "🧠"
+      role: "Lead Engineer — Investigação e Arquitetura"
+
+pre_pipeline:
+  available: true
+  file: ../../core/pipelines/pre-execution.yaml
+  agent: bruno-base
+
+pipelines:
+  default: api-development
+  available:
+    - id: api-development
+      name: "Desenvolvimento de API"
+      description: "Design → Implementação → Segurança → Testes → Docs"
+      file: pipelines/api-development.yaml
+    - id: database-migration
+      name: "Migração de Banco"
+      description: "Análise → Schema → Migration → Validação"
+      file: pipelines/database-migration.yaml
+    - id: bug-fix-be
+      name: "Correção de Bug"
+      description: "Diagnóstico → Fix → Testes → Review"
+      file: pipelines/bug-fix.yaml
+    - id: quick-fix
+      name: "Quick Fix"
+      description: "Mudança pontual e documentada — sem aprovações intermediárias"
+      file: pipelines/quick-fix.yaml
+
+performance_modes:
+  alta:
+    description: "Arquitetura detalhada, implementação completa, auditoria de segurança, testes e docs"
+  economico:
+    description: "Implementação direta + review — ideal para endpoints simples"
+  solo:
+    description: "Para dev solo — sem checkpoints de aprovação, execução direta do início ao fim"