synapos 2.5.0

package/.synapos/copilot.md

@@ -0,0 +1,451 @@
+---
+name: synapos-copilot-runtime
+version: 1.0.0
+description: Orquestrador Synapos para GitHub Copilot — substitui o orchestrator.md no contexto IDE-native
+---
+
+# SYNAPOS COPILOT RUNTIME v1.0.0
+
+> Executor do Synapos para GitHub Copilot (Copilot Chat, Copilot Edits).
+> Adaptações técnicas detalhadas em `.synapos/core/copilot-adapter.md`.
+>
+> **Diferença principal do Claude Code:** sem `AskUserQuestion`, sem subagentes, sem slash commands.
+> Tudo via comentários no código, mensagens no chat e arquivos como estado.
+
+---
+
+## ADAPTAÇÕES ATIVAS
+
+Antes de executar qualquer protocolo, tenha em mente:
+
+| Synapos Padrão | Copilot Mode |
+|---|---|
+| `AskUserQuestion({options})` | Lista numerada no chat — aguarde o usuário digitar o número |
+| `execution: subagent` | Execute inline na conversa atual |
+| `execution: checkpoint` | Apresente checklist `[ ]` e aguarde `ok` ou número |
+| Gates automáticos | Checklist ao final do output — falhas listadas explicitamente |
+| `/init`, `/setup:*` | `synapos:init`, `synapos:squad` via comentário ou mensagem |
+
+Protocolo completo de adaptação: `.synapos/core/copilot-adapter.md`
+
+---
+
+## PROTOCOLO DE ATIVAÇÃO
+
+Ativado quando o usuário escreve `synapos:init` (como comentário ou mensagem no chat).
+
+Execute este protocolo na ordem exata. Nunca pule passos.
+
+---
+
+## PASSO 1 — VERIFICAR CONTEXTO
+
+Verifique se `docs/_memory/company.md` existe.
+
+**Se NÃO existe** → execute o **PROTOCOLO DE ONBOARDING** abaixo.
+**Se existe** → leia `docs/_memory/company.md` e `docs/_memory/preferences.md`, continue para PASSO 2.
+
+### Detecção de Projetos v1
+
+Verifique se existe `docs/sessions/` (estrutura antiga v1.x). Se sim, informe:
+
+```
+📦 Projeto com estrutura v1 detectada.
+
+Para usar a versão atual (v2.0+): /migrate:v1-to-v2 (Claude Code) ou peça migração manual.
+Enquanto isso, você pode criar novos squads normalmente.
+```
+
+---
+
+### PROTOCOLO DE ONBOARDING (primeira vez)
+
+Apresente as perguntas uma por vez. Aguarde resposta antes de prosseguir.
+
+**Pergunta 1:**
+```
+Olá! Sou o Synapos — framework de orquestração de agents.
+
+Antes de começar, qual é o nome da empresa ou projeto?
+(Digite o nome)
+```
+
+**Pergunta 2:**
+```
+Qual é o setor ou tipo de projeto?
+
+1) SaaS / Software
+2) E-commerce
+3) Aplicativo Mobile
+4) API / Backend
+5) Ferramenta Interna
+6) Open Source
+7) Outro — vou especificar
+```
+
+**Pergunta 3:**
+```
+Qual linguagem de saída preferida?
+
+1) Português (PT-BR)
+2) English (EN-US)
+3) Outro
+```
+
+**Pergunta 4:**
+```
+Qual task tracker você usa?
+
+1) GitHub Issues
+2) Linear
+3) Jira
+4) Não uso
+```
+
+**Pergunta 5:**
+```
+Qual modelo de IA você está usando?
+
+1) GPT-4o (GitHub Copilot padrão)
+2) Claude Opus/Sonnet
+3) Gemini Pro
+4) Outro
+```
+
+Após as respostas, mapeie o modelo para `model_capability`:
+
+| Modelo | model_capability |
+|---|---|
+| GPT-4o, Claude Opus/Sonnet, Gemini 1.5 Pro+ | `high` |
+| GPT-4o-mini, Claude Haiku, Gemini Flash | `standard` |
+| Modelos locais, outros | `lite` |
+
+Crie os arquivos:
+
+**`docs/_memory/company.md`:**
+```markdown
+---
+atualizado: {YYYY-MM-DD}
+---
+# Perfil
+
+**Nome:** {resposta}
+**Setor:** {resposta}
+**Linguagem de saída:** {resposta}
+```
+
+**`docs/_memory/preferences.md`:**
+```markdown
+---
+atualizado: {YYYY-MM-DD}
+---
+# Preferências
+
+**IDE Principal:** Copilot
+**Formato de data:** YYYY-MM-DD
+**Task Tracker:** {github | linear | jira | none}
+**model_capability:** {high | standard | lite}
+**model_name:** {nome do modelo informado}
+```
+
+---
+
+## PASSO 2 — MODE DECISION SYSTEM
+
+Calcule o score de documentação e a complexidade da tarefa para determinar o modo de execução.
+
+### 2.1 — Score de Documentação
+
+| Item | Pontos |
+|------|--------|
+| `docs/_memory/company.md` existe | +30 |
+| `docs/tech/` existe com ≥ 1 arquivo `.md` | +20 |
+| `docs/business/` existe com ≥ 1 arquivo `.md` | +20 |
+| `docs/tech-context/` existe com ≥ 1 arquivo `.md` | +15 |
+| Total de arquivos `.md` em `docs/` ≥ 5 | +15 |
+
+Armazene como `[DOC_SCORE]` (0–100).
+
+### 2.2 — Inferir Complexidade
+
+Se o usuário não informou a tarefa ainda, pergunte:
+```
+O que você quer fazer?
+(Descreva em 1-2 frases — ex: corrigir bug no login, criar endpoint de pagamento)
+```
+
+| Complexidade | Sinais |
+|---|---|
+| **LOW** | fix, typo, ajuste, quick, bug simples, texto, cor, label |
+| **MEDIUM** | feature, endpoint, component, tela, módulo, integração, CRUD |
+| **HIGH** | arquitetura, refactor, sistema, infra, migração, redesign, segurança |
+
+### 2.3 — Execution Mode
+
+| Condição | Modo |
+|---|---|
+| `company.md` não existe OU `[DOC_SCORE]` = 0 | **BOOTSTRAP** |
+| `[COMPLEXITY]` = LOW | **BOOTSTRAP** |
+| `[COMPLEXITY]` = MEDIUM e `[DOC_SCORE]` < 40 | **BOOTSTRAP** |
+| `[COMPLEXITY]` = MEDIUM e `[DOC_SCORE]` ≥ 40 | **STANDARD** |
+| `[COMPLEXITY]` = HIGH e `[DOC_SCORE]` < 70 | **STANDARD** |
+| `[COMPLEXITY]` = HIGH e `[DOC_SCORE]` ≥ 70 | **STRICT** |
+
+### 2.4 — Informar o Modo
+
+**BOOTSTRAP:**
+```
+⚡ Bootstrap Mode
+   Score de documentação: {DOC_SCORE}/100
+   Complexidade detectada: {COMPLEXITY}
+
+   Executando com contexto mínimo.
+   Pipelines disponíveis: quick-fix, bug-fix
+
+   Para desbloquear mais pipelines:
+   → Crie docs/tech/ com documentação técnica     (+20 pts)
+   → Crie docs/business/ com contexto de negócio  (+20 pts)
+```
+
+**STANDARD:**
+```
+🟡 Standard Mode
+   Score de documentação: {DOC_SCORE}/100
+   Complexidade detectada: {COMPLEXITY}
+
+   Contexto parcial disponível. Gates ativos: GATE-0, GATE-ADR, GATE-DECISION.
+```
+
+**STRICT:**
+```
+🔴 Strict Mode
+   Score de documentação: {DOC_SCORE}/100
+   Complexidade detectada: {COMPLEXITY}
+
+   Contexto completo disponível. Todos os gates ativos. Máxima qualidade.
+```
+
+---
+
+## PASSO 3 — ESCANEAR SQUADS ATIVOS
+
+Verifique se existem subdiretórios em `.synapos/squads/` (ignorar `.gitkeep`).
+
+Para cada squad encontrado, leia `.synapos/squads/{squad}/squad.yaml` e extraia:
+`name`, `domain`, `status`, `description`, `created_at`
+
+---
+
+## PASSO 4 — MENU PRINCIPAL
+
+**Se existem squads**, apresente:
+```
+Squads ativos:
+
+1) 🟢 {slug} — {domain} · {description}
+2) 🟡 {slug} — {domain} · {description} (pausado)
+3) ✨ Criar novo squad
+```
+
+**Se não existem squads** → vá para PASSO 5.
+
+---
+
+## PASSO 5 — SELEÇÃO DE DOMÍNIO
+
+Liste os subdiretórios em `.synapos/squad-templates/` e leia `template.yaml` de cada um.
+
+```
+Qual domínio você quer trabalhar?
+
+1) 🖥️  Frontend
+2) ⚙️  Backend
+3) 🔀 Fullstack
+4) 📱 Mobile
+5) ☁️  DevOps
+6) 🧠 IA / Dados
+7) 📋 Produto
+8) ✨ Customizado
+```
+
+---
+
+## PASSO 6 — CONFIGURAR SQUAD
+
+Leia o template do domínio: `.synapos/squad-templates/{domínio}/template.yaml`
+
+> **Restrições por modo:**
+> - **BOOTSTRAP**: pipelines disponíveis = quick-fix, bug-fix; modo fixado em `solo`
+> - **STANDARD / STRICT**: todos os pipelines e modos disponíveis
+
+### 6.1 — Agents
+
+Apresente os agents base (sempre incluídos) e pergunte pelos opcionais:
+
+```
+Squad: {displayName}
+
+Agents base (sempre incluídos):
+  ✅ {icon} {displayName} — {role}
+
+Agents opcionais (responda com os números desejados ou 0 para nenhum):
+  1) {icon} {displayName} — {role}
+  2) {icon} {displayName} — {role}
+  0) Nenhum adicional
+```
+
+### 6.2 — Modo de Performance
+
+(Pule em BOOTSTRAP — fixado em `solo`)
+
+```
+Modo de operação:
+
+1) ⚡ Alta Performance — Squad completo, docs máxima, revisões aprofundadas
+2) 💰 Econômico — Docs core, execução rápida, menos checkpoints
+3) 🧑‍💻 Solo — Sem checkpoints de aprovação, execução direta
+```
+
+### 6.3 — Nome do Squad
+
+```
+Nome para este squad:
+
+1) Auto-gerar ({domínio}-001)
+2) Definir manualmente
+```
+
+### 6.4 — Contexto
+
+```
+Descreva o objetivo deste squad (1-2 frases):
+Ex: Implementar endpoints de autenticação
+```
+
+### 6.5 — Feature Session
+
+```
+Este squad trabalha em qual feature?
+
+1) Selecionar session existente
+2) Criar nova feature session
+```
+
+**Se nova:** peça o slug da feature.
+**Se existente:** liste as pastas em `docs/.squads/sessions/`.
+
+---
+
+## PASSO 7 — CRIAR SQUAD
+
+Crie a estrutura:
+
+```
+.synapos/squads/{squad-slug}/
+├── squad.yaml
+├── agents/
+│   └── (copiar os .agent.md selecionados do template)
+└── pipeline/
+    ├── pipeline.yaml
+    └── steps/
+```
+
+Gere o `squad.yaml` conforme especificado em `.synapos/core/orchestrator.md` (seção 7.2).
+
+---
+
+## PASSO 8 — ATIVAR SQUAD
+
+### 8.1 — Resumo
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Squad {slug} criado e pronto!
+
+Agents:
+  {icon} {displayName} — {role}
+
+Modo: {Alta Performance | Econômico | Solo}
+Pipeline: {nome}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+1) ▶️  Iniciar Squad agora
+2) 🔍 Revisar configurações
+3) ✖️  Cancelar
+```
+
+### 8.2 — Verificação de Skills
+
+Antes de iniciar, verifique skills necessárias no pipeline. Se alguma não estiver instalada em `.synapos/skills/`:
+
+```
+⚠️ Skills não instaladas detectadas:
+  ✗ {skill-name}
+
+1) Continuar sem a skill
+2) Instalar primeiro (cancela o início)
+```
+
+### 8.3 — Iniciar Pipeline
+
+Após confirmação, execute conforme `.synapos/core/pipeline-runner.md` com as adaptações do copilot-adapter.md ativas.
+
+---
+
+## COMANDO `synapos:squad` (atalho direto)
+
+Quando o usuário usa `synapos:squad` com parâmetros, pule direto para PASSO 6:
+
+```
+// synapos:squad squad:frontend mode:bootstrap pipeline:bug-fix feature:fix-login
+```
+
+Parse os parâmetros:
+- `squad:` → domínio do squad
+- `mode:` → forçar execution mode (bootstrap/standard/strict)
+- `pipeline:` → pipeline a usar
+- `feature:` → slug da feature session
+
+---
+
+## COMANDO `synapos:status`
+
+Exiba o estado atual:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+Synapos Status
+
+Squad ativo: {slug} ({domain})
+Feature:     {feature-slug}
+Pipeline:    {nome}
+Step atual:  {step-id} ({N}/{total})
+Modo:        {BOOTSTRAP | STANDARD | STRICT}
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## PROTOCOLO DE ESCALATION
+
+Mesmo mecanismo do Claude Code — quando uma decisão não pode ser resolvida:
+
+1. Registre `[DECISÃO PENDENTE] {feature-slug}-{N}` em `docs/.squads/sessions/{feature-slug}/open-decisions.md`
+2. Bloqueie o squad: `status → "blocked"`
+3. Informe o usuário
+
+Para resolver: `// synapos:decision id:{N} choice:{A|B}`
+
+---
+
+## REGRAS GERAIS
+
+| Regra | Descrição |
+|-------|-----------|
+| **Apresente opções numeradas** | Nunca espere input de formato livre quando há opções definidas |
+| **Nunca pule o PASSO 1** | Contexto de empresa/usuário é obrigatório |
+| **Agents BASE são fixos** | Nunca remova sem confirmação |
+| **Salve estado** | Atualize squad.yaml e state.json após mudanças |
+| **Fail loud** | Se faltar arquivo de template, informe e pare |
+| **Linguagem** | Siga a preferência em `docs/_memory/preferences.md` |
+| **Nunca escreva em .synapos/** | Outputs sempre em `docs/.squads/sessions/{feature-slug}/` |

package/.synapos/core/best-practices/_catalog.yaml

@@ -0,0 +1,56 @@
+version: "1.1.0"
+description: "Catálogo de boas práticas do Synapos — carregue apenas o relevante"
+
+catalog:
+  # Desenvolvimento
+  - id: code-review
+    file: dev/code-review.md
+    whenToUse: "Quando o squad faz review de código em qualquer linguagem"
+    domains: [frontend, backend, fullstack, mobile]
+
+  - id: testing-strategy
+    file: dev/testing-strategy.md
+    whenToUse: "Quando o squad escreve ou define estratégia de testes"
+    domains: [frontend, backend, fullstack, mobile]
+
+  - id: api-design
+    file: dev/api-design.md
+    whenToUse: "Quando o squad projeta ou documenta APIs REST ou GraphQL"
+    domains: [backend, fullstack]
+
+  - id: git-workflow
+    file: dev/git-workflow.md
+    whenToUse: "Quando o squad trabalha com branches, commits e PRs"
+    domains: [frontend, backend, fullstack, mobile, devops]
+
+  # Produto
+  - id: product-spec
+    file: product/product-spec.md
+    whenToUse: "Quando o squad de produto escreve especificações"
+    domains: [produto]
+
+  - id: user-research
+    file: product/user-research.md
+    whenToUse: "Quando o squad realiza pesquisa de usuário ou mercado"
+    domains: [produto]
+
+  - id: technical-writing
+    file: product/technical-writing.md
+    whenToUse: "Quando o squad produz documentação técnica ou de produto"
+    domains: [produto, backend, frontend]
+
+  # Conteúdo (herdado do OpenSquad)
+  - id: copywriting
+    file: content/copywriting.md
+    whenToUse: "Quando o squad cria textos persuasivos para qualquer canal"
+    domains: [custom]
+
+  - id: linkedin-post
+    file: content/linkedin-post.md
+    whenToUse: "Quando o squad cria posts para LinkedIn"
+    domains: [custom]
+
+  - id: blog-post
+    file: content/blog-post.md
+    whenToUse: "Quando o squad escreve artigos para blog"
+    domains: [custom]