synapos 2.5.0

package/.synapos/squad-templates/fullstack/pipelines/steps/02-contrato-api.md

@@ -0,0 +1,63 @@
+---
+id: 02-contrato-api
+name: "Definição do Contrato de API"
+agent: carlos-coordenador
+execution: subagent
+model_tier: powerful
+output_files:
+  - api-contract.md
+---
+
+# Definição do Contrato de API
+
+**Agent:** Carlos Coordenador 🔗
+**Contexto injetado:** squad.yaml, memories.md, task da sessão
+
+## Instruções
+
+Leia `.synapos/squads/{slug}/agents/carlos-coordenador.agent.md` e execute como Carlos Coordenador.
+
+**Contexto disponível:**
+- Task da sessão: {task do memories.md}
+- Company profile: `docs/_memory/company.md`
+- **Regras críticas do projeto:** `docs/tech-context/briefing/critical-rules.md` ← leia antes de qualquer decisão
+- **ADRs existentes:** `docs/tech-context/briefing/adrs-summary.md` ← verifique conflitos com decisões anteriores
+
+## Tarefa
+
+1. Mapeie todos os endpoints que a feature necessita
+2. Para cada endpoint, documente:
+   - Método HTTP + path + versão
+   - Request body (schema tipado)
+   - Todos os códigos de resposta (sucesso e erro) com payload
+   - Autenticação e rate limits
+3. Defina tabela de responsabilidades (FE vs BE)
+4. Especifique estratégia de mock para desenvolvimento paralelo
+
+## Output Esperado
+
+Salve em `docs/api-contract.md`:
+
+```markdown
+# Contrato de API — {feature}
+
+## Endpoints
+
+### {MÉTODO} {/v1/recurso}
+...
+
+## Responsabilidades FE / BE
+
+| Responsabilidade | FE | BE |
+|...
+
+## Mocks para desenvolvimento paralelo
+...
+```
+
+## Critérios de Qualidade
+
+- [ ] Todos os endpoints com status codes completos
+- [ ] Schemas tipados (não "objeto genérico")
+- [ ] Responsabilidades demarcadas sem ambiguidade
+- [ ] Estratégia de mock documentada

package/.synapos/squad-templates/fullstack/pipelines/steps/03-checkpoint-contrato.md

@@ -0,0 +1,25 @@
+---
+id: 03-checkpoint-contrato
+name: "Aprovação do Contrato"
+execution: checkpoint
+---
+
+# Aprovação do Contrato de API
+
+Apresente ao usuário o contrato gerado em `docs/api-contract.md`.
+
+```
+Contrato definido por Carlos Coordenador:
+
+{resumo dos endpoints}
+
+Responsabilidades FE/BE:
+{tabela de responsabilidades}
+
+Revise e confirme:
+[1] Aprovar contrato → prosseguir com implementação FE e BE em paralelo
+[2] Solicitar ajuste → descreva o que precisa mudar
+```
+
+Aguarde confirmação antes de prosseguir.
+Se o usuário solicitar ajuste, retorne ao step 02-contrato-api com o feedback.

package/.synapos/squad-templates/fullstack/pipelines/steps/04-frontend.md

@@ -0,0 +1,35 @@
+---
+id: 04-frontend
+name: "Implementação Frontend"
+agent: rodrigo-react
+execution: subagent
+model_tier: powerful
+---
+
+# Implementação Frontend
+
+**Agent:** Rodrigo React ⚛️
+**Contexto injetado:** squad.yaml, api-contract.md, memories.md
+
+## Instruções
+
+Leia `.synapos/squads/{slug}/agents/rodrigo-react.agent.md` e execute como Rodrigo React.
+
+**Contexto disponível:**
+- Contrato de API: `docs/api-contract.md`
+- Task da sessão: {task do memories.md}
+- **Regras críticas do projeto:** `docs/tech-context/briefing/critical-rules.md` ← aplique todas as regras durante a implementação
+
+## Tarefa
+
+1. Implemente os componentes e páginas seguindo o contrato de API
+2. Use mock do contrato enquanto o backend ainda não está disponível
+3. Trate todos os estados: loading, error, empty, success
+4. Siga a arquitetura definida (se houver `docs/architecture-decision.md`)
+
+## Critérios de Qualidade
+
+- [ ] Todo componente async com loading + error + empty + success
+- [ ] Props tipadas (sem `any` não justificado)
+- [ ] Mock do contrato implementado para desenvolvimento paralelo
+- [ ] Integração com API seguindo o contrato aprovado

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

@@ -0,0 +1,36 @@
+---
+id: 05-backend
+name: "Implementação Backend"
+agent: alexandre-api
+execution: subagent
+model_tier: powerful
+---
+
+# Implementação Backend
+
+**Agent:** Alexandre API ⚙️
+**Contexto injetado:** squad.yaml, api-contract.md, memories.md
+
+## Instruções
+
+Leia `.synapos/squads/{slug}/agents/alexandre-api.agent.md` e execute como Alexandre API.
+
+**Contexto disponível:**
+- Contrato de API: `docs/api-contract.md`
+- Task da sessão: {task do memories.md}
+- **Regras críticas do projeto:** `docs/tech-context/briefing/critical-rules.md` ← aplique todas as regras durante a implementação
+
+## Tarefa
+
+1. Implemente os endpoints exatamente como definidos no contrato
+2. Valide todos os inputs com schema (Zod ou Joi)
+3. Trate todos os casos de erro documentados no contrato
+4. Adicione log estruturado com correlationId
+
+## Critérios de Qualidade
+
+- [ ] Endpoint segue exatamente o contrato aprovado (path, método, response)
+- [ ] Validação de schema em todos os inputs externos
+- [ ] Todos os erros documentados no contrato implementados
+- [ ] Log estruturado com correlationId
+- [ ] Sem secret ou informação sensível no código

package/.synapos/squad-templates/fullstack/pipelines/steps/06-integracao.md

@@ -0,0 +1,47 @@
+---
+id: 06-integracao
+name: "Verificação de Integração"
+agent: carlos-coordenador
+execution: inline
+model_tier: powerful
+output_files:
+  - integration-checklist.md
+---
+
+# Verificação de Integração
+
+**Agent:** Carlos Coordenador 🔗
+
+## Instruções
+
+Execute como Carlos Coordenador. Verifique a integração entre o frontend e backend implementados.
+
+## Checklist de Integração
+
+Para cada endpoint do contrato, verifique:
+
+- [ ] Request do frontend bate com o schema do contrato
+- [ ] Response do backend bate com o schema do contrato
+- [ ] Todos os status codes de erro do backend tratados no frontend
+- [ ] Loading state no frontend cobre o tempo de resposta real
+- [ ] Headers necessários (Authorization, Content-Type) incluídos nas requests
+
+## Output
+
+Salve em `docs/integration-checklist.md`:
+
+```markdown
+# Checklist de Integração — {feature}
+
+## Endpoints verificados
+
+### {MÉTODO} {/endpoint}
+- FE → BE: {OK | DIVERGÊNCIA: descrição}
+- BE → FE: {OK | DIVERGÊNCIA: descrição}
+- Erros tratados: {lista}
+
+## Status: APROVADO | BLOQUEADO
+
+### BLOCKERs (se houver)
+...
+```

package/.synapos/squad-templates/fullstack/pipelines/steps/07-review.md

@@ -0,0 +1,49 @@
+---
+id: 07-review
+name: "Review Duplo (FE + BE)"
+agent: renata-revisao-fe
+execution: inline
+model_tier: powerful
+output_files:
+  - review-notes.md
+gate: GATE-5
+---
+
+# Review Fullstack
+
+**Agent:** Renata Revisão 🔍
+
+## Instruções
+
+Execute como Renata Revisão. Faça review completo da implementação fullstack.
+
+## Escopo do Review
+
+### Frontend
+- Qualidade dos componentes e hooks
+- Tratamento de estados (loading/error/empty/success)
+- Tipagem TypeScript
+- Acessibilidade básica
+
+### Backend
+- Aderência ao contrato de API
+- Validação de inputs
+- Tratamento de erros
+- Segurança básica (sem secrets expostos, sem SQL injection)
+
+### Integração
+- Contrato sendo respeitado em ambos os lados
+- Erros de backend tratados no frontend
+
+## Formato de Output
+
+Salve em `docs/review-notes.md` usando categorias:
+- `BLOCKER:` — deve ser corrigido antes do merge
+- `SUGGESTION:` — recomendado mas não obrigatório
+- `QUESTION:` — dúvida que precisa de resposta
+- `PRAISE:` — reconhecimento explícito
+
+## Critérios de Aceite
+
+- [ ] Nenhum BLOCKER aberto
+- [ ] Todos os BLOCKERs com fix sugerido

package/.synapos/squad-templates/fullstack/pipelines/steps/atualizar-tarefa.md

@@ -0,0 +1,138 @@
+---
+id: atualizar-tarefa
+name: "Atualizar Tarefa"
+execution: checkpoint
+---
+
+# Atualizar Tarefa
+
+A implementação foi concluída. Registre o progresso onde as tarefas estão sendo gerenciadas.
+
+## Identificar tarefa e plataforma
+
+Leia `_memory/memories.md` da sessão atual:
+- `Task:` — descrição do que foi feito
+- `Issue:` — referência da tarefa (número, plataforma, local ou —)
+
+Apresente ao usuário:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+SESSÃO CONCLUÍDA
+
+Task: {Task da sessão}
+Issue: {Issue registrada}
+
+A tarefa foi concluída?
+
+✅ Sim — marcar como concluída
+🔄 Parcial — registrar progresso e manter aberta
+⏭️  Pular — não atualizar agora
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Aguarde a seleção. Se **Pular**, encerre aqui.
+
+---
+
+## Executar por plataforma
+
+### 📁 Local — `docs/specs/*-tasks.md`
+
+Abra o arquivo de tarefas identificado no `Issue:` do memories.md.
+
+Localize o item correspondente e marque como concluído:
+- `- [ ]` → `- [x]`
+
+Se parcial, adicione nota abaixo do item:
+```markdown
+- [~] RF-{N}: {título}
+  > Parcial — {YYYY-MM-DD}: {o que foi feito}. Pendente: {o que falta}
+```
+
+---
+
+### 🐙 GitHub Issues
+
+**Se concluída:**
+```bash
+# Fechar a issue
+gh issue close {número} --comment "Implementado. Referência: {branch ou PR}"
+
+# Ou adicionar label 'done' e fechar
+gh issue edit {número} --add-label "done"
+gh issue close {número}
+```
+
+**Se parcial:**
+```bash
+gh issue comment {número} --body "Progresso — {YYYY-MM-DD}: {o que foi implementado}. Pendente: {o que falta}"
+gh issue edit {número} --add-label "in-progress"
+```
+
+---
+
+### 📐 Linear
+
+**Se concluída:**
+- Se Linear MCP disponível: atualize o status para `Done` / `Completed`
+- Caso contrário, exiba instrução:
+
+```
+Linear — Atualizar manualmente:
+Issue: {ID registrado no memories.md}
+Novo status: Done
+Comentário: Implementado em {YYYY-MM-DD}
+```
+
+**Se parcial:**
+```
+Linear — Atualizar manualmente:
+Issue: {ID}
+Novo status: In Progress
+Comentário: {progresso + pendências}
+```
+
+---
+
+### 🔲 Jira
+
+Exiba instrução:
+
+```
+Jira — Atualizar manualmente:
+Issue: {ID registrado no memories.md}
+Transição: {Done | In Progress}
+Comentário: {resumo do que foi feito}
+```
+
+---
+
+## Registrar no memories.md
+
+Adicione entrada:
+
+```markdown
+## Tarefa concluída — {YYYY-MM-DD}
+Task: {descrição}
+Issue: {referência}
+Status: {concluída | parcial}
+{SE PARCIAL:}
+Pendente: {o que falta}
+```
+
+---
+
+## Confirmação
+
+```
+✅ Progresso registrado!
+
+Task: {descrição}
+Status: {concluída | parcial}
+Plataforma: {local | GitHub #{N} | Linear | Jira | —}
+
+{SE CONCLUÍDA E TODAS AS TAREFAS DONE:}
+🎉 Todas as tarefas da feature estão concluídas.
+   Próximo passo: verificar handoff em docs/specs/{feature-slug}-handoff.md
+```

package/.synapos/squad-templates/fullstack/pipelines/steps/bf-02-diagnostico.md

@@ -0,0 +1,34 @@
+---
+id: bf-02-diagnostico
+name: "Diagnóstico e Localização"
+agent: carlos-coordenador
+execution: subagent
+model_tier: powerful
+output_files:
+  - bug-diagnosis.md
+---
+
+# Diagnóstico de Bug Fullstack
+
+**Agent:** Carlos Coordenador 🔗
+
+## Tarefa
+
+1. Identifique a camada do bug: Frontend | Backend | Integração FE↔BE
+2. Reproduza o problema com steps claros
+3. Identifique o root cause
+4. Avalie se o contrato de API está sendo respeitado em ambos os lados
+
+## Output
+
+Salve em `docs/bug-diagnosis.md`:
+
+```markdown
+# Diagnóstico do Bug
+
+**Camada:** Frontend | Backend | Integração
+**Reprodução:** (steps para reproduzir)
+**Root cause:** (causa raiz identificada)
+**Contrato:** (está sendo respeitado? Se não, onde diverge?)
+**Agente responsável pelo fix:** (rodrigo-react | alexandre-api | ambos)
+```

package/.synapos/squad-templates/fullstack/pipelines/steps/bf-03-fix.md

@@ -0,0 +1,22 @@
+---
+id: bf-03-fix
+name: "Correção do Bug"
+execution: subagent
+model_tier: powerful
+---
+
+# Correção do Bug
+
+**Agent:** Determinado pelo diagnóstico (rodrigo-react | alexandre-api | ambos)
+
+## Tarefa
+
+1. Implemente o fix na(s) camada(s) identificada(s)
+2. Adicione teste que cobre o caso que causou o bug
+3. Verifique que o fix não quebra outros comportamentos
+
+## Critérios
+
+- [ ] Fix implementado na camada correta
+- [ ] Teste adicionado cobrindo o caso do bug
+- [ ] Contrato de API respeitado após o fix

package/.synapos/squad-templates/fullstack/pipelines/steps/bf-04-review.md

@@ -0,0 +1,22 @@
+---
+id: bf-04-review
+name: "Review da Correção"
+agent: renata-revisao-fe
+execution: inline
+model_tier: fast
+gate: GATE-5
+---
+
+# Review da Correção
+
+**Agent:** Renata Revisão 🔍
+
+## Tarefa
+
+Review focado na correção do bug:
+
+1. O fix resolve o problema reportado?
+2. O teste adicionado é adequado?
+3. Há risco de regressão em outras áreas?
+
+Use categorias: `BLOCKER:` / `SUGGESTION:` / `PRAISE:`

package/.synapos/squad-templates/fullstack/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/fullstack/pipelines/steps/qf-03-executar.md

@@ -0,0 +1,49 @@
+---
+id: qf-03-executar
+name: "Executar"
+agent: carlos-coordenador
+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"
+  - "Mudança em contrato de API sem documentar impacto no FE e BE"
+---
+
+# Execução Quick Fix — Fullstack
+
+Você é **Carlos Coordenador**, coordenador fullstack. Implemente a mudança descrita no contexto coletado.
+
+## Regras do quick-fix
+
+- Implemente **apenas** o que foi solicitado — sem refatorações adjacentes
+- Se a mudança tocar o contrato de API, documente o impacto em FE e BE
+- 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
+
+## Output obrigatório
+
+Salve em `docs/quick-fix-output.md`:
+
+```markdown
+# Quick Fix Output — Fullstack
+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}
+
+## Impacto no contrato de API
+{mudanças de interface FE ↔ BE — se houver}
+
+## Decisões técnicas
+{escolhas feitas e por quê}
+
+## Observações fora do escopo
+{problemas encontrados mas não corrigidos — se houver}
+```

package/.synapos/squad-templates/fullstack/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/fullstack/template.yaml

@@ -0,0 +1,93 @@
+name: fullstack
+displayName: "Squad Fullstack"
+icon: "📦"
+version: "1.0.0"
+description: "Frontend + Backend integrados com agente de coordenação de contratos de API"
+
+agents:
+  base:
+    - id: carlos-coordenador
+      file: agents/carlos-coordenador.agent.md
+      displayName: "Carlos Coordenador"
+      icon: "🔗"
+      role: "Coordenador Fullstack"
+    - id: ana-arquitetura-fe
+      file: ../frontend/agents/ana-arquitetura-fe.agent.md
+      displayName: "Ana Arquitetura"
+      icon: "🏗️"
+      role: "Arquiteta Frontend"
+    - id: rodrigo-react
+      file: ../frontend/agents/rodrigo-react.agent.md
+      displayName: "Rodrigo React"
+      icon: "⚛️"
+      role: "Dev Frontend"
+    - id: bruno-base
+      file: ../backend/agents/bruno-base.agent.md
+      displayName: "Bruno Base"
+      icon: "🏗️"
+      role: "Arquiteto Backend"
+    - id: alexandre-api
+      file: ../backend/agents/alexandre-api.agent.md
+      displayName: "Alexandre API"
+      icon: "⚙️"
+      role: "Dev Backend"
+  optional:
+    - id: leo-engenheiro
+      file: ../engineer/agents/leo-engenheiro.agent.md
+      displayName: "Leo Engenheiro"
+      icon: "🧠"
+      role: "Lead Engineer — Investigação e Arquitetura"
+    - id: ursula-ui
+      file: ../frontend/agents/ursula-ui.agent.md
+      displayName: "Úrsula UI"
+      icon: "🎨"
+      role: "UX/UI Designer"
+    - id: tiago-testes-fe
+      file: ../frontend/agents/tiago-testes-fe.agent.md
+      displayName: "Tiago Testes"
+      icon: "🧪"
+      role: "Engenheiro de Testes"
+    - id: sergio-seguranca
+      file: ../backend/agents/sergio-seguranca.agent.md
+      displayName: "Sérgio Segurança"
+      icon: "🔒"
+      role: "Engenheiro de Segurança"
+    - id: renata-revisao-fe
+      file: ../frontend/agents/renata-revisao-fe.agent.md
+      displayName: "Renata Revisão"
+      icon: "🔍"
+      role: "Reviewer Frontend"
+    - id: roberto-revisao-be
+      file: ../backend/agents/roberto-revisao-be.agent.md
+      displayName: "Roberto Revisão"
+      icon: "🔎"
+      role: "Reviewer Backend"
+
+pre_pipeline:
+  available: true
+  file: ../../core/pipelines/pre-execution.yaml
+  agent: carlos-coordenador
+
+pipelines:
+  default: integration-feature
+  available:
+    - id: integration-feature
+      name: "Feature Fullstack Integrada"
+      description: "Contrato API → Checkpoint → Frontend → Backend → Integração → Review"
+      file: pipelines/integration-feature.yaml
+    - id: bug-fix
+      name: "Correção de Bug"
+      description: "Diagnóstico → Fix (FE/BE) → Integração → 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: "Coordenação completa, frontend e backend em paralelo, segurança, testes e review duplo"
+  economico:
+    description: "Coordenador + dev frontend + dev backend + review — ideal para features pequenas"
+  solo:
+    description: "Para dev solo — sem checkpoints de aprovação, execução direta do início ao fim"