synapos 2.5.0

package/.synapos/squad-templates/mobile/pipelines/bug-fix.yaml

@@ -0,0 +1,47 @@
+name: "Correção de Bug Mobile"
+description: "Diagnóstico → Fix → Testes em device → Review."
+version: "1.0.0"
+
+steps:
+  - id: 01-gate-integridade
+    name: "Verificação de Integridade"
+    execution: checkpoint
+    gate: GATE-0
+    file: pipeline/steps/01-gate-integridade.md
+
+  - id: bf-02-diagnostico
+    name: "Diagnóstico"
+    agent: marina-mobile
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/bf-02-diagnostico.md
+    depends_on: [01-gate-integridade]
+    output_files:
+      - bug-diagnosis.md
+    veto_conditions:
+      - "Plataforma afetada (iOS/Android/ambas) não identificada"
+      - "Root cause não definido"
+
+  - id: bf-03-fix
+    name: "Correção"
+    agent: felipe-feature
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/bf-03-fix.md
+    depends_on: [bf-02-diagnostico]
+    veto_conditions:
+      - "Fix sem teste cobrindo o caso que causou o bug"
+      - "Não testado em device real (Android ou iOS)"
+    on_reject: bf-03-fix
+
+  - id: bf-04-review
+    name: "Review"
+    agent: renata-revisao-fe
+    execution: inline
+    model_tier: fast
+    file: pipeline/steps/bf-04-review.md
+    depends_on: [bf-03-fix]
+    gate: GATE-5
+    veto_conditions:
+      - "Review sem BLOCKER/SUGGESTION/QUESTION/PRAISE"
+    on_reject: bf-03-fix

package/.synapos/squad-templates/mobile/pipelines/feature-development.yaml

@@ -0,0 +1,77 @@
+name: "Desenvolvimento de Feature Mobile"
+description: "Arquitetura → Design UI → Checkpoint → Implementação → Review → Testes."
+version: "1.0.0"
+
+steps:
+  - id: 01-gate-integridade
+    name: "Verificação de Integridade"
+    execution: checkpoint
+    gate: GATE-0
+    file: pipeline/steps/01-gate-integridade.md
+
+  - id: 02-arquitetura
+    name: "Arquitetura Mobile"
+    agent: marina-mobile
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/02-arquitetura.md
+    depends_on: [01-gate-integridade]
+    output_files:
+      - mobile-architecture.md
+    veto_conditions:
+      - "Estrutura de navegação não documentada"
+      - "Decisão de estado sem justificativa"
+      - "Integrações nativas não mapeadas"
+
+  - id: 03-design-ux
+    name: "Design UX Mobile"
+    agent: viviane-visual
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/03-design-ux.md
+    depends_on: [02-arquitetura]
+    output_files:
+      - ux-notes.md
+    veto_conditions:
+      - "Áreas de toque sem verificação de tamanho mínimo (44pt/48dp)"
+      - "Padrões de plataforma ignorados sem justificativa"
+
+  - id: 04-checkpoint
+    name: "Aprovação do Approach"
+    execution: checkpoint
+    file: pipeline/steps/04-checkpoint.md
+    depends_on: [03-design-ux]
+
+  - id: 05-implementacao
+    name: "Implementação Mobile"
+    agent: felipe-feature
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/05-implementacao.md
+    depends_on: [04-checkpoint]
+    veto_conditions:
+      - "Tela sem tratamento de loading/error/empty"
+      - "FlatList sem keyExtractor"
+      - "Tipo 'any' sem justificativa"
+    on_reject: 05-implementacao
+
+  - id: 06-review
+    name: "Code Review Mobile"
+    agent: renata-revisao-fe
+    execution: inline
+    model_tier: powerful
+    file: pipeline/steps/06-review.md
+    depends_on: [05-implementacao]
+    output_files:
+      - review-notes.md
+    gate: GATE-5
+    veto_conditions:
+      - "Review sem BLOCKER/SUGGESTION/QUESTION/PRAISE"
+      - "BLOCKER sem fix sugerido"
+    on_reject: 05-implementacao
+
+  - id: atualizar-tarefa
+    name: "Atualizar Tarefa"
+    execution: checkpoint
+    file: pipeline/steps/atualizar-tarefa.md
+    depends_on: [06-review]

package/.synapos/squad-templates/mobile/pipelines/quick-fix.yaml

@@ -0,0 +1,40 @@
+name: "Quick Fix"
+description: "Mudança pontual e documentada — contexto → execução → registro. Sem aprovações intermediárias."
+version: "1.0.0"
+
+steps:
+  - id: 01-gate-integridade
+    name: "Verificação de Integridade"
+    execution: checkpoint
+    gate: GATE-0
+    file: pipeline/steps/01-gate-integridade.md
+
+  - id: qf-02-contexto
+    name: "Contexto Rápido"
+    execution: inline
+    model_tier: fast
+    file: pipeline/steps/qf-02-contexto.md
+    depends_on: [01-gate-integridade]
+
+  - id: qf-03-executar
+    name: "Executar"
+    agent: felipe-feature
+    execution: subagent
+    model_tier: powerful
+    file: pipeline/steps/qf-03-executar.md
+    depends_on: [qf-02-contexto]
+    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"
+
+  - id: qf-04-registrar
+    name: "Registrar Decisão"
+    execution: inline
+    model_tier: fast
+    file: pipeline/steps/qf-04-registrar.md
+    depends_on: [qf-03-executar]
+    output_files:
+      - quick-fix-log.md
+    gate: GATE-5

package/.synapos/squad-templates/mobile/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 `marina-mobile.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 implementar nesta sessão?
+Inclua: feature/bug, plataforma alvo (iOS/Android/ambas), contexto de produto.
+```
+
+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/mobile/pipelines/steps/02-arquitetura.md

@@ -0,0 +1,35 @@
+---
+id: 02-arquitetura
+name: "Arquitetura Mobile"
+agent: marina-mobile
+execution: subagent
+model_tier: powerful
+output_files:
+  - mobile-architecture.md
+---
+
+# Arquitetura Mobile
+
+**Agent:** Marina Mobile 📐
+
+## 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 estrutura de navegação para a feature
+2. Decida estratégia de estado (local, server state, global, URL/params)
+3. Mapeie integrações nativas necessárias (câmera, localização, etc.)
+4. Defina estrutura de pastas
+5. Documente ADR para decisões relevantes
+
+## Output
+
+Salve em `docs/mobile-architecture.md` com:
+- Diagrama de navegação
+- Decisão de estado
+- Integrações nativas
+- Estrutura de pastas proposta

package/.synapos/squad-templates/mobile/pipelines/steps/03-design-ux.md

@@ -0,0 +1,29 @@
+---
+id: 03-design-ux
+name: "Design UX Mobile"
+agent: viviane-visual
+execution: subagent
+model_tier: powerful
+output_files:
+  - ux-notes.md
+---
+
+# Design UX Mobile
+
+**Agent:** Viviane Visual 🎨
+
+## Tarefa
+
+1. Revise o fluxo de usuário para a feature
+2. Verifique zonas de toque e tamanhos mínimos (44pt iOS / 48dp Android)
+3. Identifique padrões de plataforma a seguir (iOS vs Android)
+4. Revise acessibilidade: labels, contraste, font scaling
+5. Defina estados visuais: loading, error, empty, success
+
+## Output
+
+Salve em `docs/ux-notes.md` com:
+- Notas de UX por tela
+- Padrões de plataforma aplicados
+- Checklist de acessibilidade
+- Decisões de design

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

@@ -0,0 +1,20 @@
+---
+id: 04-checkpoint
+name: "Aprovação do Approach"
+execution: checkpoint
+---
+
+# Aprovação do Approach Mobile
+
+Apresente ao usuário o resultado da arquitetura e UX:
+
+```
+Arquitetura: {docs/mobile-architecture.md}
+UX Notes: {docs/ux-notes.md}
+
+[1] Aprovar → prosseguir com implementação
+[2] Ajustar arquitetura → descreva o que mudar
+[3] Ajustar UX → descreva o que mudar
+```
+
+Aguarde confirmação.

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

@@ -0,0 +1,26 @@
+---
+id: 05-implementacao
+name: "Implementação Mobile"
+agent: felipe-feature
+execution: subagent
+model_tier: powerful
+---
+
+# Implementação Mobile
+
+**Agent:** Felipe Feature 📱
+
+## Tarefa
+
+1. Implemente as telas e componentes seguindo a arquitetura e UX definidas
+2. Integre com a API usando React Query
+3. Trate todos os estados: loading, error, empty, success
+4. Otimize listas com FlatList (keyExtractor, getItemLayout)
+5. TypeScript strict — sem `any` não justificado
+
+## Critérios
+
+- [ ] Todos os estados async tratados em cada tela
+- [ ] FlatList otimizada para listas longas
+- [ ] Tipos corretos (sem any não justificado)
+- [ ] React Query para server state

package/.synapos/squad-templates/mobile/pipelines/steps/06-review.md

@@ -0,0 +1,27 @@
+---
+id: 06-review
+name: "Code Review Mobile"
+agent: renata-revisao-fe
+execution: inline
+model_tier: powerful
+output_files:
+  - review-notes.md
+gate: GATE-5
+---
+
+# Code Review Mobile
+
+**Agent:** Renata Revisão 🔍
+
+## Escopo
+
+- Qualidade do código e componentes
+- Tratamento de estados (loading/error/empty/success)
+- Performance (FlatList, memo, useCallback)
+- Tipagem TypeScript
+- Padrões de plataforma respeitados
+
+## Formato
+
+Use: `BLOCKER:` / `SUGGESTION:` / `QUESTION:` / `PRAISE:`
+Salve em `docs/review-notes.md`

package/.synapos/squad-templates/mobile/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/mobile/pipelines/steps/bf-02-diagnostico.md

@@ -0,0 +1,22 @@
+---
+id: bf-02-diagnostico
+name: "Diagnóstico de Bug Mobile"
+agent: marina-mobile
+execution: subagent
+model_tier: powerful
+output_files:
+  - bug-diagnosis.md
+---
+
+# Diagnóstico de Bug Mobile
+
+**Agent:** Marina Mobile 📐
+
+## Tarefa
+
+1. Identifique a plataforma afetada: iOS | Android | Ambas
+2. Reproduza com steps claros
+3. Identifique o root cause
+4. Classifique: UI | Lógica de estado | Integração nativa | API
+
+Salve em `docs/bug-diagnosis.md`.

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

@@ -0,0 +1,23 @@
+---
+id: bf-03-fix
+name: "Correção de Bug Mobile"
+agent: felipe-feature
+execution: subagent
+model_tier: powerful
+---
+
+# Correção de Bug Mobile
+
+**Agent:** Felipe Feature 📱
+
+## Tarefa
+
+1. Implemente o fix na camada identificada
+2. Adicione teste cobrindo o caso do bug
+3. Verifique nas plataformas afetadas (iOS e/ou Android)
+
+## Critérios
+
+- [ ] Fix implementado
+- [ ] Teste adicionado
+- [ ] Verificado em device real ou simulador das plataformas afetadas

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

@@ -0,0 +1,20 @@
+---
+id: bf-04-review
+name: "Review da Correção Mobile"
+agent: renata-revisao-fe
+execution: inline
+model_tier: fast
+gate: GATE-5
+---
+
+# Review da Correção Mobile
+
+**Agent:** Renata Revisão 🔍
+
+Review focado:
+1. Fix resolve o problema reportado?
+2. Teste é adequado?
+3. Risco de regressão em outras telas?
+4. Comportamento correto em ambas as plataformas?
+
+Use: `BLOCKER:` / `SUGGESTION:` / `PRAISE:`

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

@@ -0,0 +1,49 @@
+---
+id: qf-03-executar
+name: "Executar"
+agent: felipe-feature
+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 — Mobile
+
+Você é **Felipe Feature**, dev mobile. 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 afetar comportamento nativo (iOS / Android), documente as diferenças
+- 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 — Mobile
+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}
+
+## Comportamento por plataforma
+iOS: {impacto — se houver}
+Android: {impacto — 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/mobile/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.