synapos 2.5.0

package/.synapos/squad-templates/ia-dados/pipelines/steps/01-gate-integridade.md

@@ -0,0 +1,62 @@
+---
+id: 01-gate-integridade
+name: "Verificação de Integridade"
+execution: checkpoint
+gate: GATE-0
+---
+
+# Verificação de Integridade — GATE-0
+
+- [ ] `.synapos/core/orchestrator.md` existe
+- [ ] `docs/_memory/company.md` existe
+- [ ] `.synapos/squads/{slug}/squad.yaml` existe com `description` preenchida
+- [ ] `.synapos/squads/{slug}/agents/` tem ao menos `larissa-llm.agent.md` ou `diana-dados.agent.md`
+
+**Documentação do projeto (bloqueante):**
+- [ ] `docs/tech-context/project-briefing.md` existe
+- [ ] `docs/tech-context/briefing/critical-rules.md` existe
+
+Se ausente: 🚫 Execute `/setup:discover` antes de continuar. Implementação sem ADRs cria débito técnico imediato.
+
+## Contexto do squad
+
+```
+Squad: {name} | Modo: {modo}
+Objetivo: {description}
+Agents: {lista com ícones}
+```
+
+## Tarefas em aberto
+
+Antes de perguntar sobre a task, verifique:
+
+1. Procure arquivos `docs/specs/*-tasks.md` e liste itens `- [ ]` pendentes
+2. Leia `_memory/memories.md` — se houver `Platform:` registrado:
+   - **GitHub**: execute `gh issue list --label "feature" --state open`
+   - **Linear / Jira**: exiba as tarefas registradas no memories.md
+
+**Se encontrar tarefas em aberto**, apresente e pergunte:
+
+```
+Tarefas em aberto:
+  - [ ] RF-{N}: {título} {#issue se houver}
+  - [ ] RF-{N}: {título}
+
+Qual tarefa vamos trabalhar? (ou descreva uma nova)
+```
+
+**Se não houver tarefas**, pergunte:
+
+```
+O que vamos construir nesta sessão?
+Inclua: problema de negócio, dados disponíveis, métrica de sucesso esperada.
+```
+
+Salve a resposta em `_memory/memories.md`:
+```markdown
+## Sessão {YYYY-MM-DD}
+Task: {tarefa selecionada ou descrita}
+Issue: {#número | plataforma | local | —}
+```
+
+Prossiga.

package/.synapos/squad-templates/ia-dados/pipelines/steps/02-exploracao.md

@@ -0,0 +1,36 @@
+---
+id: 02-exploracao
+name: "Exploração e Definição"
+agent: nelson-notebook
+execution: subagent
+model_tier: powerful
+output_files:
+  - data-exploration.md
+---
+
+# Exploração e Definição do Problema
+
+**Agent:** Nelson Notebook 📊
+
+## Contexto disponível
+
+- Task desta sessão: `_memory/memories.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. Defina a pergunta de negócio clara
+2. Avalie a qualidade e volume dos dados disponíveis
+3. Estabeleça o baseline (o que existe hoje? qual é o benchmark?)
+4. Identifique as métricas técnicas alinhadas à métrica de negócio
+5. Documente limitações conhecidas dos dados
+
+## Output
+
+Salve em `docs/data-exploration.md` com:
+- Pergunta de negócio
+- Análise exploratória inicial
+- Baseline estabelecido
+- Métricas de sucesso
+- Limitações e riscos dos dados

package/.synapos/squad-templates/ia-dados/pipelines/steps/03-design.md

@@ -0,0 +1,25 @@
+---
+id: 03-design
+name: "Design da Solução"
+agent: larissa-llm
+execution: subagent
+model_tier: powerful
+output_files:
+  - solution-design.md
+---
+
+# Design da Solução IA/ML
+
+**Agent:** Larissa LLM 🧠
+
+## Tarefa
+
+1. Proponha a abordagem técnica (LLM + RAG? Fine-tuning? ML clássico? Pipeline de dados?)
+2. Justifique a escolha com trade-offs claros (custo vs qualidade vs latência)
+3. Defina o plano de avaliação (eval set, métricas, thresholds de aceite)
+4. Estime custo operacional (custo por request e custo mensal)
+5. Defina a estratégia de fallback e monitoramento
+
+## Output
+
+Salve em `docs/solution-design.md`.

package/.synapos/squad-templates/ia-dados/pipelines/steps/04-checkpoint.md

@@ -0,0 +1,23 @@
+---
+id: 04-checkpoint
+name: "Aprovação do Approach"
+execution: checkpoint
+---
+
+# Aprovação do Approach IA/ML
+
+Apresente ao usuário:
+
+```
+Exploração: {docs/data-exploration.md}
+Design da solução: {docs/solution-design.md}
+
+Custo estimado: {R$ X / mês}
+Métrica de sucesso: {métrica e threshold}
+
+[1] Aprovar → prosseguir com implementação
+[2] Ajustar abordagem → descreva o que mudar
+[3] Revisitar dados → problema nos dados identificado
+```
+
+Aguarde confirmação.

package/.synapos/squad-templates/ia-dados/pipelines/steps/05-implementacao.md

@@ -0,0 +1,26 @@
+---
+id: 05-implementacao
+name: "Implementação"
+agent: marco-ml
+execution: subagent
+model_tier: powerful
+---
+
+# Implementação IA/ML
+
+**Agent:** Marco ML 🔬
+
+## Tarefa
+
+1. Implemente feature engineering seguindo o design aprovado
+2. Configure rastreamento de experimentos (MLflow ou equivalente)
+3. Implemente e treine o modelo/pipeline
+4. Documente hiperparâmetros e decisões de implementação
+5. Garanta reprodutibilidade (seed fixo, dados versionados)
+
+## Critérios
+
+- [ ] Experimentos rastreados (MLflow)
+- [ ] Seed fixo para reprodutibilidade
+- [ ] Sem data leakage (test set separado antes do feature engineering)
+- [ ] Feature engineering documentado

package/.synapos/squad-templates/ia-dados/pipelines/steps/06-avaliacao.md

@@ -0,0 +1,29 @@
+---
+id: 06-avaliacao
+name: "Avaliação e Validação"
+agent: larissa-llm
+execution: subagent
+model_tier: powerful
+output_files:
+  - model-evaluation.md
+---
+
+# Avaliação e Validação
+
+**Agent:** Larissa LLM 🧠
+
+## Tarefa
+
+1. Execute avaliação no eval set definido no design
+2. Compare com o baseline estabelecido na exploração
+3. Analise os erros: onde o modelo/pipeline erra e por quê?
+4. Traduza métricas técnicas para impacto de negócio
+5. Defina se o resultado atinge o threshold de aceite
+
+## Output
+
+Salve em `docs/model-evaluation.md` com:
+- Métricas técnicas vs baseline
+- Análise de erros
+- Tradução para negócio
+- Recomendação: DEPLOY | ITERAR | REVER ABORDAGEM

package/.synapos/squad-templates/ia-dados/pipelines/steps/07-deploy.md

@@ -0,0 +1,30 @@
+---
+id: 07-deploy
+name: "Deploy e Monitoramento"
+agent: diana-dados
+execution: subagent
+model_tier: powerful
+output_files:
+  - deployment-plan.md
+gate: GATE-5
+---
+
+# Deploy e Monitoramento
+
+**Agent:** Diana Dados 🗄️
+
+## Tarefa
+
+1. Defina a estratégia de serving (batch, real-time API, feature store)
+2. Configure containerização do modelo
+3. Defina monitoramento de data drift e concept drift
+4. Configure alertas de degradação de performance
+5. Documente o plano de rollback
+
+## Output
+
+Salve em `docs/deployment-plan.md` com:
+- Arquitetura de serving
+- Checklist de deploy
+- Estratégia de monitoramento de drift
+- Plano de rollback

package/.synapos/squad-templates/ia-dados/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/ia-dados/pipelines/steps/dp-02-design.md

@@ -0,0 +1,21 @@
+---
+id: dp-02-design
+name: "Design do Pipeline de Dados"
+agent: diana-dados
+execution: subagent
+model_tier: powerful
+output_files:
+  - pipeline-design.md
+---
+
+# Design do Pipeline de Dados
+
+**Agent:** Diana Dados 🗄️
+
+1. Mapeie fontes, transformações e destinos
+2. Defina o modelo de dados (staging → intermediate → mart)
+3. Defina frequência de atualização e SLA de frescor
+4. Documente os consumidores (dashboards, modelos, outras tabelas)
+5. Identifique dados sensíveis e estratégia de mascaramento
+
+Salve em `docs/pipeline-design.md`.

package/.synapos/squad-templates/ia-dados/pipelines/steps/dp-03-checkpoint.md

@@ -0,0 +1,14 @@
+---
+id: dp-03-checkpoint
+name: "Aprovação do Design de Dados"
+execution: checkpoint
+---
+
+# Aprovação do Design de Dados
+
+Apresente ao usuário o design do pipeline (`docs/pipeline-design.md`).
+
+```
+[1] Aprovar → prosseguir com implementação
+[2] Ajustar design → descreva o que mudar
+```

package/.synapos/squad-templates/ia-dados/pipelines/steps/dp-04-implementacao.md

@@ -0,0 +1,19 @@
+---
+id: dp-04-implementacao
+name: "Implementação do Pipeline"
+agent: diana-dados
+execution: subagent
+model_tier: powerful
+---
+
+# Implementação do Pipeline de Dados
+
+**Agent:** Diana Dados 🗄️
+
+1. Implemente modelos dbt em 3 camadas (staging → intermediate → mart)
+2. Adicione testes de qualidade (not_null, unique, accepted_values, relationships)
+3. Documente todas as colunas das tabelas de mart
+4. Configure orquestração (Airflow DAG ou equivalente)
+5. Garanta idempotência do pipeline
+
+Critérios: idempotente, testado, documentado, sem dados sensíveis expostos.

package/.synapos/squad-templates/ia-dados/pipelines/steps/dp-05-qualidade.md

@@ -0,0 +1,21 @@
+---
+id: dp-05-qualidade
+name: "Validação de Qualidade de Dados"
+agent: nelson-notebook
+execution: subagent
+model_tier: fast
+output_files:
+  - data-quality-report.md
+---
+
+# Validação de Qualidade de Dados
+
+**Agent:** Nelson Notebook 📊
+
+1. Execute todos os testes dbt
+2. Analise o volume de dados (vs esperado)
+3. Verifique distribuições das colunas críticas
+4. Identifique anomalias ou valores suspeitos
+5. Valide que os dados de mart fazem sentido de negócio
+
+Salve relatório em `docs/data-quality-report.md`.

package/.synapos/squad-templates/ia-dados/pipelines/steps/dp-06-deploy.md

@@ -0,0 +1,22 @@
+---
+id: dp-06-deploy
+name: "Deploy e Agendamento"
+agent: diana-dados
+execution: subagent
+model_tier: fast
+output_files:
+  - pipeline-deployment.md
+gate: GATE-5
+---
+
+# Deploy e Agendamento do Pipeline
+
+**Agent:** Diana Dados 🗄️
+
+1. Configure agendamento de execução (cron, Airflow schedule)
+2. Configure alerta de frescor (SLA de frescor não atingido)
+3. Configure alerta de falha de execução
+4. Documente estratégia de reprocessamento em caso de falha
+5. Configure monitoramento de volume de dados
+
+Salve em `docs/pipeline-deployment.md`.

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

@@ -0,0 +1,53 @@
+---
+id: qf-03-executar
+name: "Executar"
+agent: larissa-llm
+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 — IA / Dados
+
+Você é **Larissa LLM**, especialista em LLM e IA. Implemente a mudança descrita no contexto coletado.
+
+## Regras do quick-fix
+
+- Implemente **apenas** o que foi solicitado — sem refatorações adjacentes
+- Para mudanças em prompts: documente o antes e o depois
+- Para mudanças em pipelines de dados: documente o impacto no schema ou saída
+- Se identificar um problema maior, **registre em `docs/quick-fix-output.md` mas não corrija agora**
+
+## Output obrigatório
+
+Salve em `docs/quick-fix-output.md`:
+
+```markdown
+# Quick Fix Output — IA / Dados
+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}
+
+## Mudança em prompt (se aplicável)
+Antes: {prompt anterior}
+Depois: {prompt novo}
+Motivo: {por que essa mudança melhora o resultado}
+
+## Impacto em dados / schema
+{mudanças de estrutura ou saída esperada — 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/ia-dados/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/ia-dados/template.yaml

@@ -0,0 +1,68 @@
+name: ia-dados
+displayName: "Squad IA / Dados"
+icon: "🤖"
+version: "1.0.0"
+description: "ML, pipelines de dados, LLMs e análise — da exploração ao modelo em produção"
+
+agents:
+  base:
+    - id: larissa-llm
+      file: agents/larissa-llm.agent.md
+      displayName: "Larissa LLM"
+      icon: "🧠"
+      role: "LLM Specialist"
+    - id: diana-dados
+      file: agents/diana-dados.agent.md
+      displayName: "Diana Dados"
+      icon: "🗄️"
+      role: "Engenheira de Dados"
+    - id: nelson-notebook
+      file: agents/nelson-notebook.agent.md
+      displayName: "Nelson Notebook"
+      icon: "📊"
+      role: "Analista de Dados"
+  optional:
+    - id: leo-engenheiro
+      file: ../engineer/agents/leo-engenheiro.agent.md
+      displayName: "Leo Engenheiro"
+      icon: "🧠"
+      role: "Lead Engineer — Investigação e Arquitetura"
+    - id: marco-ml
+      file: agents/marco-ml.agent.md
+      displayName: "Marco ML"
+      icon: "🔬"
+      role: "ML Engineer"
+    - id: tania-tecnica
+      file: ../produto/agents/tania-tecnica.agent.md
+      displayName: "Tânia Técnica"
+      icon: "📝"
+      role: "Tech Writer"
+
+pre_pipeline:
+  available: true
+  file: ../../core/pipelines/pre-execution.yaml
+  agent: larissa-llm
+
+pipelines:
+  default: ml-feature
+  available:
+    - id: ml-feature
+      name: "Feature de IA / ML"
+      description: "Exploração → Design → Implementação → Avaliação → Deploy"
+      file: pipelines/ml-feature.yaml
+    - id: data-pipeline
+      name: "Pipeline de Dados"
+      description: "Design → Implementação → Qualidade → Validação → Deploy"
+      file: pipelines/data-pipeline.yaml
+    - id: quick-fix
+      name: "Quick Fix"
+      description: "Ajuste pontual em modelo, prompt ou pipeline — sem aprovações intermediárias"
+      file: pipelines/quick-fix.yaml
+
+performance_modes:
+  alta:
+    description: "Exploração completa, ML engineering, pipelines de dados, documentação e análise"
+  economico:
+    description: "LLM specialist + dados + análise — para features de IA focadas"
+  solo:
+    description: "Para dev solo — sem checkpoints de aprovação, execução direta do início ao fim"