@luanpdd/kit-mcp 1.14.0 → 1.15.0

package/README.md

@@ -23,6 +23,10 @@ Inspired by [vinilana/dotcontext](https://github.com/vinilana/dotcontext) — se
 
 ---
 
+<!-- AUTOGEN-COUNTS-START -->
+**Bundled workflow:** 47 agents · 87 commands · 45 skills · 20 gates
+<!-- AUTOGEN-COUNTS-END -->
+
 ## What ships in the box
 
 ```

package/kit/COMPATIBILITY.md

@@ -0,0 +1,65 @@
+# Compatibilidade Agent × IDE
+
+> Source of truth para tier × capability de cada agent em cada IDE suportado.
+> Agents linkam para este arquivo via `**Compat:** ...` no header. Single source — atualize aqui, não em cada agent.
+
+## Visão Geral por Pattern
+
+Os agents do kit caem em 3 patterns de compatibilidade:
+
+- **Pattern A — Filesystem-only:** análise puramente local (Read/Grep/Bash + git, opcionalmente test runner ou LLM hospedeiro). Funciona idêntico em todos os IDEs (Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Antigravity, Copilot, Trae) — tier **Full** em todos.
+- **Pattern B — Supabase MCP-dependent:** precisa de queries live (`mcp__supabase__execute_sql`, `mcp__supabase__list_tables`, `mcp__supabase__apply_migration`, advisors). Tier varia por suporte do IDE ao Supabase MCP:
+  - **Full** em Claude Code + Cursor (com Supabase MCP instalado)
+  - **Partial** em Codex + Gemini CLI (lê filesystem; user roda queries manualmente e cola)
+  - **Offline-only** em Windsurf, Antigravity, Copilot, Trae (apenas estrutura artefatos; user faz queries manualmente)
+- **Pattern C — MCP-augmented (degrada para filesystem):** funciona razoavelmente sem MCP (usa filesystem como source-of-truth fallback) e ganha capability adicional quando MCP/embedder disponível. Tier:
+  - **Full** em Claude Code + Cursor + Codex (com MCP/embedder configurado)
+  - **Partial** em Gemini CLI + Windsurf/Antigravity/Copilot/Trae (modo degradado mas útil)
+
+Modo offline fallback (Patterns B e C): agent declara `[MODO OFFLINE — sem live data]` no output e marca itens MCP-dependentes como `EVIDENCE_PENDING_MCP` para o user preencher.
+
+## Matriz por Agent
+
+| Agent | Pattern | Claude Code | Cursor | Codex | Gemini CLI | Windsurf, Antigravity, Copilot, Trae | Capability resumida |
+|---|---|---|---|---|---|---|---|
+| ai-mutation-tester | A | Full | Full | Full | Full | Full | Mutação semântica via LLM hospedeiro (próprio Claude/Gemini); sem OpenAI key separada |
+| burn-rate-forecaster | B | Full | Full | Partial | Partial | Offline-only | Queries live em SLI views via `execute_sql`; offline gera SQL como text |
+| cascading-failures-auditor | A | Full | Full | Full | Full | Full | Análise estática filesystem + AST para 5 triggers cascade canônicos (cap 22) |
+| golden-signals-instrumenter | A | Full | Full | Full | Full | Full | Não usa `mcp__supabase__*` — instrumentação em arquivos do app (Edge Function, Node, Python) |
+| incident-investigator | B | Full | Full | Partial | Partial | Offline-only | Logs + SQL + advisors live para validar hipóteses; offline estrutura investigação por hipóteses |
+| legacy-characterizer | A | Full | Full | Full | Full | Full | Filesystem + test runner + coverage; não usa `mcp__supabase__*` |
+| load-shedding-instrumenter | A | Full | Full | Full | Full | Full | Read + Edit + verify para aplicar 5 patterns canônicos de load shedding |
+| observability-coverage-auditor | C | Full | Full | Full | Partial | Partial | MCP Supabase + filesystem; sem MCP reverte para enumeration via `supabase/functions/` (sem traffic 30d) |
+| observability-instrumenter | A | Full | Full | Full | Full | Full | Não usa `mcp__supabase__*` — instrumentação em arquivos do app, não no DB |
+| omm-auditor | B | Full | Full | Partial | Partial | Offline-only | Lê repo + queries SLI (se Supabase MCP disponível); offline apenas análise repo local |
+| payload-capture-instrumenter | C | Full | Full | Full | Partial | Partial | Drenagem de logs via `mcp__supabase__get_logs`; sem MCP gera instrumentação + script para user rodar `supabase functions logs` manualmente |
+| postmortem-writer | B | Full | Full | Partial | Partial | Partial | Lê investigation + escreve postmortem + AskUserQuestion; offline limitado a `--from-investigation` |
+| prr-conductor | B | Full | Full | Partial | Partial | Offline-only | Lista tabelas + executa SQL + advisors + Edge Functions live; offline estrutura template para preenchimento manual |
+| refactor-safety-auditor | A | Full | Full | Full | Full | Full | Filesystem + coverage tools + git; não usa `mcp__supabase__*` |
+| release-pipeline-auditor | A | Full | Full | Full | Full | Full | Filesystem + GitHub API via `gh` CLI |
+| seam-finder | A | Full | Full | Full | Full | Full | Lê + grep + escreve análise (técnicas cap 25 Feathers) |
+| shotgun-surgery-detector | C | Full | Full | Full | Partial | Partial | Detecção semântica via OpenAI API ou pgvector self-hosted; sem nenhum dos dois reverte para sintática only |
+| slo-engineer | B | Full | Full | Partial | Partial | Offline-only | Lê schema atual + `apply_migration` para criar view; offline escreve SLO.md + SQL como text |
+| storytelling-analyst | A | Full | Full | Full | Full | Full | Lê código + escreve análise; não usa MCP |
+| supabase-architect | B | Full | Full | Partial | Partial | Offline-only | Lista tabelas/extensions live para detectar estado atual; offline projeta plano em texto |
+| supabase-auth-bootstrapper | A | Full | Full | Full | Full | Full | Cria estrutura de pastas + arquivos + audit `.env*`; auth bootstrap totalmente offline |
+| supabase-edge-fn-writer | A | Full | Full | Full | Full | Full | Escreve Edge Functions (arquivos locais); não usa `mcp__supabase__*` tools |
+| supabase-migration-writer | B | Full | Full | Partial | Partial | Offline-only | Aplica migration via `mcp__supabase__apply_migration` após validação; offline escreve arquivo SQL para user aplicar |
+| supabase-realtime-implementer | B | Full | Full | Partial | Partial | Offline-only | Aplica RLS via `mcp__supabase__execute_sql` direto; offline escreve SQL + código client para user aplicar |
+| supabase-rls-writer | B | Full | Full | Partial | Partial | Offline-only | Detecta tabela existente + sugere indexes baseado em policy; offline gera SQL puro para migration manual |
+| supabase-storage-implementer | B | Full | Full | Partial | Partial | Offline-only | Aplica RLS via `mcp__supabase__execute_sql`; offline escreve SQL + código client para user aplicar |
+| toil-auditor | A | Full | Full | Full | Full | Full | Filesystem + git log + escreve `TOIL-AUDIT.md`; não usa `mcp__supabase__*` |
+
+## Troubleshooting
+
+**Pattern B agent reportou tier diferente do que esta matriz declara?** Verifique:
+1. Supabase MCP está instalado? `kit install dry-run claude-code` mostra MCP servers configurados.
+2. IDE host suporta MCP? Cursor/Claude Code têm suporte first-class; outros via stdio bridge ou paste.
+3. Versão do Supabase MCP — alguns tools (advisors, get_logs) requerem versão recente.
+
+**Pattern C agent reportou tier degradado inesperado?** Verifique:
+1. `OPENAI_API_KEY` env var presente (para `shotgun-surgery-detector` semântico).
+2. pgvector extension instalada no projeto Supabase (alternativa a OpenAI).
+3. `mcp__supabase__get_logs` tool disponível (para `payload-capture-instrumenter` drenagem).
+
+**Quer adicionar um agent novo aqui?** Edite a matriz acima — uma row. Não duplicar info no header do agent. Footer de cada agent já linka pra cá via `**Compat:** ...`.

package/kit/agents/ai-mutation-tester.md

@@ -16,17 +16,7 @@ Você consulta:
 - [`legacy-characterization-tests`](../skills/legacy-characterization-tests/SKILL.md) — Pattern 7 (behavioral coverage via mutation)
 - [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md) — Pattern 6 (mutation kill ≥ 70%)
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Filesystem + tests + LLM via Claude self |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem (LLM = Gemini) |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
-
-**Nota:** O agent USA o LLM hospedeiro (próprio Claude/Gemini/etc) para gerar mutants. Não precisa OpenAI API key separada.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/burn-rate-forecaster.md

@@ -7,15 +7,7 @@ color: orange
 
 Você é o forecaster de burn rate. Recebe nome de SLO + janelas (lookahead/baseline) e calcula burn rate atual, % budget gasto, ETA exhaustão, e ação recomendada (informativo / ticket / page). Você consulta a skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — conhecimento autoritativo sobre fórmulas de extrapolação.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Queries live em SLI views via execute_sql |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Apresenta SQL ao user, parsea resultado colado |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | SQL como text, sem execução |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/cascading-failures-auditor.md

@@ -13,15 +13,7 @@ Você consulta:
 - [`load-shedding-graceful-degradation`](../skills/load-shedding-graceful-degradation/SKILL.md) — server-side defenses
 - [`four-golden-signals`](../skills/four-golden-signals/SKILL.md) (v1.10) — Saturation como early warning
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Análise estática filesystem |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/golden-signals-instrumenter.md

@@ -7,17 +7,7 @@ color: yellow
 
 Você é o instrumentador dos **4 golden signals**. Recebe caminho de código de serviço/Edge Function/job e produz patches OTel com Latency + Traffic + Errors + Saturation conforme cap 6 do livro Google SRE. Você é especialização de [`observability-instrumenter`](./observability-instrumenter.md) (v1.9 — spans/atributos canônicos) — este agent foca em **métricas dos 4 signals universais** (não em spans/wide events). Você consulta a skill [`four-golden-signals`](../skills/four-golden-signals/SKILL.md) — conhecimento autoritativo sobre Latency/Traffic/Errors/Saturation, percentis, histogram bucketing, black-box vs white-box.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê + escreve + roda smoke (instrumentação local) |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Escrita de arquivos local |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem (só edita arquivos locais) |
-
-**Nota:** Este agente não usa `mcp__supabase__*` — instrumentação acontece em arquivos do app (Deno Edge Function, Node service, Python worker), não no DB. Por isso "Full" em todos os IDEs.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/incident-investigator.md

@@ -7,15 +7,7 @@ color: red
 
 Você é o investigador de incidentes. Recebe um sintoma (alerta, complaint, SLO burn) e aplica o Core Analysis Loop iterativamente — formando hipóteses a partir de DADOS (não intuição), validando com queries, refinando até root cause. Você consulta a skill [`core-analysis-loop`](../skills/core-analysis-loop/SKILL.md) — conhecimento autoritativo sobre as 4 fases iterativas.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Logs + SQL + advisors live para validar hipóteses |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Lê arquivos locais (logs exportados) — sem queries live |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas estrutura a investigação por hipóteses; user roda queries manualmente e cola resultados |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/legacy-characterizer.md

@@ -7,17 +7,7 @@ color: cyan
 
 Você é o **caracterizador de código legado**. Recebe um `target_file` (ou método/classe específica) e produz characterization tests que congelam o comportamento atual como oracle imutável durante o refactor. Aplica os patterns canônicos da skill [`legacy-characterization-tests`](../skills/legacy-characterization-tests/SKILL.md) — grupos de equivalência, golden snapshots, sanitização, determinismo.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê + escreve + roda testes/coverage |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
-
-**Nota:** Não usa `mcp__supabase__*` — operação puramente local (filesystem + test runner).
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/load-shedding-instrumenter.md

@@ -12,15 +12,7 @@ Você consulta:
 - [`retry-strategies`](../skills/retry-strategies/SKILL.md) — caller-side coopera com server-side
 - [`four-golden-signals`](../skills/four-golden-signals/SKILL.md) (v1.10) — Saturation gauge é trigger
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Read + Edit + verify |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/observability-coverage-auditor.md

@@ -14,17 +14,7 @@ Você consulta:
 - [`legacy-characterization-tests`](../skills/legacy-characterization-tests/SKILL.md) (v1.12) — cobertura de safety net
 - [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md) (v1.9) — Capacidade 5 (Comportamento)
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | MCP Supabase + filesystem |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Partial** | Sem MCP — modo offline (lista Edge Functions via filesystem; sem traffic data) |
-| Windsurf, Antigravity, Copilot, Trae | **Partial** | Idem |
-
-**Nota:** Sem MCP Supabase, agent reverte para enumeration via `supabase/functions/` directory (sem traffic 30d disponível — top 5 críticas sem prio).
+**Compat:** Full em Claude Code + Cursor + Codex (com MCP Supabase); Partial em Gemini CLI + Windsurf/Antigravity/Copilot/Trae (modo offline — sem traffic 30d). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/observability-instrumenter.md

@@ -7,17 +7,7 @@ color: yellow
 
 Você é o instrumentador de observabilidade. Recebe caminho de código + endpoints/handlers que precisam ser instrumentados e produz patches com OTel spans + atributos canônicos. Você consulta as skills [`structured-events`](../skills/structured-events/SKILL.md), [`distributed-tracing`](../skills/distributed-tracing/SKILL.md) e [`opentelemetry-standard`](../skills/opentelemetry-standard/SKILL.md) — conhecimento autoritativo sobre wide events e OTel.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê + escreve + roda smoke (instrumentação local) |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Escrita de arquivos local |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem (só edita arquivos locais) |
-
-**Nota:** Este agente não usa `mcp__supabase__*` — instrumentação acontece em arquivos do app, não no DB. Por isso "Full" em todos os IDEs.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/omm-auditor.md

@@ -7,15 +7,7 @@ color: purple
 
 Você é o auditor OMM. Recebe o repositório do projeto e gera OMM-REPORT.md com snapshot scored das 5 capacidades. Você consulta a skill [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md) — conhecimento autoritativo dos sintomas "doing well/poorly" por capacidade.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê repo + queries SLI (se Supabase MCP disponível) |
-| Cursor | **Full** | Idem |
-| Codex | **Partial** | Lê repo local; queries SLI via paste |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas análise repo local |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/payload-capture-instrumenter.md

@@ -13,17 +13,7 @@ Você consulta:
 - [`structured-events`](../skills/structured-events/SKILL.md) (v1.9) — wide events de alta cardinalidade
 - [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md) — Pattern 7 (captura de "payload real")
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | MCP Supabase + filesystem + git |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Partial** | Sem MCP — modo offline (pula drenagem; instrumenta + sanitiza apenas) |
-| Windsurf, Antigravity, Copilot, Trae | **Partial** | Idem Gemini — instrumenta mas não drena |
-
-**Nota:** Drenagem de logs via `mcp__supabase__get_logs` requer MCP Supabase conectado. Sem MCP, agent gera instrumentação + script para o user rodar `supabase functions logs <name>` manualmente.
+**Compat:** Full em Claude Code + Cursor + Codex (com MCP Supabase); Partial em Gemini CLI + Windsurf/Antigravity/Copilot/Trae (instrumenta mas não drena). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/postmortem-writer.md

@@ -7,17 +7,7 @@ color: red
 
 Você é o escritor de postmortems blameless. Recebe `--from-investigation <id>` (continuação de `incident-investigator` v1.9) OU `--incident "<descrição>"` (standalone) e produz postmortem blameless seguindo template canônico de 9 seções (Summary, Impact, Root Causes, Trigger, Resolution, Detection, Action Items, Lessons Learned, Timeline UTC) em `.planning/postmortems/<id>.md`. Você consulta a skill [`blameless-postmortems`](../skills/blameless-postmortems/SKILL.md) — knowledge base canônica do template, cultura blameless ("foco em sistema/processo, NÃO em pessoas"), princípio "no postmortem left unreviewed", Wheel of Misfortune, 5 Whys. Você é continuação natural de [`incident-investigator`](./incident-investigator.md) (v1.9) — após Core Analysis Loop fechar com root cause, este agent transforma `.planning/investigations/<id>.md` em postmortem revisável.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê investigation + escreve postmortem + AskUserQuestion |
-| Cursor | **Full** | Idem |
-| Codex | **Partial** | Lê investigation + escreve; sem AskUserQuestion live (default values) |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Partial** | Apenas modo `--from-investigation` (precisa investigation file existir); standalone limitado |
-
-**Nota:** Este agente não usa `mcp__supabase__*` — postmortem documenta investigation já feita; queries live ficam com `incident-investigator` (v1.9).
+**Compat:** Full em Claude Code + Cursor; Partial em Codex + Gemini CLI + Windsurf/Antigravity/Copilot/Trae (sem AskUserQuestion live — default values; standalone limitado). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/prr-conductor.md

@@ -7,17 +7,7 @@ color: purple
 
 Você é o conductor de Production Readiness Review (PRR). Recebe `--service <name>` ou `--feature <description>` e produz `PRR-REPORT.md` scored em 6 axes (System Architecture, Instrumentation/Metrics/Monitoring, Emergency Response, Capacity Planning, Change Management, Performance) em `.planning/prr/<service>.md`. Você consulta a skill [`production-readiness-review`](../skills/production-readiness-review/SKILL.md) — knowledge base canônica do checklist 6 axes, 3 engagement models (Simple PRR, Early Engagement, Frameworks/Platform), handoff dev→SRE, anti-patterns (PRR depois do launch, auto-PRR, rubber stamp).
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Lista tabelas + executa SQL + advisors + Edge Functions live; PRR completa com evidence |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Lê filesystem (`.planning/slos/`, `supabase/migrations/`, `runbooks/`); sem live data — PRR scored com evidence parcial |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas estrutura PRR-REPORT.md template; user preenche manualmente; sem MCP queries |
-
-**Modo offline fallback:** se MCP indisponível, agent declara `[MODO OFFLINE — sem live data]` no PRR-REPORT.md e usa apenas filesystem como evidence; itens MCP-dependentes ficam marcados `EVIDENCE_PENDING_MCP` para o user preencher manualmente.
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/refactor-safety-auditor.md

@@ -12,17 +12,7 @@ Você consulta:
 - [`legacy-characterization-tests`](../skills/legacy-characterization-tests/SKILL.md) — limiares de cobertura behavioral
 - [`legacy-seams-and-test-harness`](../skills/legacy-seams-and-test-harness/SKILL.md) — checklist de safe extraction
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê arquivo + roda coverage tools + escreve veredito |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem (filesystem + git only) |
-
-**Nota:** Não usa `mcp__supabase__*` — análise é puramente filesystem + coverage tools.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/release-pipeline-auditor.md

@@ -12,15 +12,7 @@ Você consulta:
 - [`release-engineering`](../skills/release-engineering/SKILL.md)
 - [`production-readiness-review`](../skills/production-readiness-review/SKILL.md) (v1.10) — Axe 5 (Change Management)
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Filesystem + GitHub API via gh CLI |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/seam-finder.md

@@ -12,15 +12,7 @@ Você consulta:
 - [`legacy-effect-analysis`](../skills/legacy-effect-analysis/SKILL.md) — para identificar quais deps são inflection points
 - [`_shared-legacy/glossary.md`](../skills/_shared-legacy/glossary.md) — vocabulário canônico
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê + grep + escreve análise |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/shotgun-surgery-detector.md

@@ -15,17 +15,7 @@ Você consulta:
 - [`legacy-effect-analysis`](../skills/legacy-effect-analysis/SKILL.md) — sketches helps prioritize
 - [`supabase-pgvector-rag`](../skills/supabase-pgvector-rag/SKILL.md) (v1.8) — pgvector self-hosted como alternative
 
-## Compatibilidade
-
-| IDE | Tier | Capability | Embedding source |
-|---|---|---|---|
-| Claude Code | **Full** | Filesystem + opt OpenAI/pgvector | OpenAI API OR pgvector |
-| Cursor | **Full** | Idem | Idem |
-| Codex | **Full** | Idem | Idem |
-| Gemini CLI | **Partial** | Sintática only se sem OpenAI key | — |
-| Windsurf, Antigravity, Copilot, Trae | **Partial** | Idem Gemini | — |
-
-**Nota:** Detecção semântica requer (a) `OPENAI_API_KEY` para embeddings via API, OU (b) pgvector self-hosted no Supabase do projeto. Sem nenhum dos dois, agent reverte para sintática only (cap 21 original).
+**Compat:** Full em Claude Code + Cursor + Codex (com OpenAI API ou pgvector); Partial em Gemini CLI + Windsurf/Antigravity/Copilot/Trae (sintática only sem embeddings). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/slo-engineer.md

@@ -7,15 +7,7 @@ color: green
 
 Você é o engenheiro de SLO. Recebe descrição de uma feature/jornada do user e produz `SLO.md` (definição canônica) + SQL para materializar SLI events em view/materialized view no Postgres. Você consulta a skill [`event-based-slos`](../skills/event-based-slos/SKILL.md) — conhecimento autoritativo sobre SLI event-based, sliding window, decouple what/why.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Lê schema atual + apply_migration para criar view |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Escreve SLO.md + SQL files locais; user aplica manualmente |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas SLO.md + SQL como text |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/storytelling-analyst.md

@@ -9,17 +9,7 @@ Você é o **analista de storytelling**. Recebe um `target` (arquivo, diretório
 
 **Você É a IA gerando o primeiro draft.** Sua leitura do código vira a "primeira passada" que humano refina depois. Não tente ser perfeito — seja útil.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê código + escreve análise |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
-
-**Nota:** Não usa MCP — análise puramente local.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-architect.md

@@ -7,15 +7,7 @@ color: blue
 
 Você é o arquiteto Supabase. O caller (orquestrador, geralmente Claude) entrega uma descrição de feature ou app e você produz um **plano de schema + RLS + topologia realtime** antes que qualquer código seja escrito. Você NÃO escreve migrations ou código de implementação — você projeta. A implementação é delegada para os outros agents Supabase via `/supabase` command.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Pode listar tabelas/extensions live para detectar estado atual |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Lê arquivos locais (`supabase/schemas/`, `supabase/migrations/`); sem live data |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas projeta plano em texto; user aplica manualmente |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-auth-bootstrapper.md

@@ -7,17 +7,7 @@ color: green
 
 Você é o auth-bootstrapper Supabase. Recebe projeto Next.js v16+ e produz a estrutura completa de autenticação Supabase com SSR: `utils/supabase/{client,server}.ts` + `middleware.ts` + audit de `.env*` para detectar service_role leak.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Cria estrutura de pastas + arquivos + audit `.env*` |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Escrita de arquivos local — sem MCP |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem |
-
-**Nota:** Auth bootstrap é totalmente offline — não depende de MCP.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-edge-fn-writer.md

@@ -7,17 +7,7 @@ color: cyan
 
 Você é o Edge Function writer Supabase. Recebe descrição de função (endpoint, comportamento, dependências) e escreve `supabase/functions/<name>/index.ts` em Deno com imports versionados, `Deno.serve`, env vars canônicas, file writes apenas em `/tmp`, e prefix `/<name>` em multi-rota.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Escreve + sugere `supabase functions deploy <name>` |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Escrita de arquivos local — sem dependência de MCP |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem (Edge Functions não dependem de live MCP) |
-
-**Nota:** Este agent não usa `mcp__supabase__*` tools — Edge Functions são arquivos locais. Por isso é "Full" em todos os IDEs.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-migration-writer.md

@@ -7,15 +7,7 @@ color: yellow
 
 Você é o migration-writer Supabase. Recebe descrição de mudança de schema e produz arquivo SQL no layout correto (`supabase/migrations/<YYYYMMDDHHmmss>_<name>.sql` ou `supabase/schemas/<NN>_<name>.sql` se projeto usa declarative). Sempre com RLS habilitado, granular policies, e style guide aplicado.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Aplica migration via `mcp__supabase__apply_migration` após validação |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Escreve arquivo; user aplica manualmente via `supabase db push` ou `db reset` |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas escreve arquivo SQL; user aplica manualmente |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-realtime-implementer.md

@@ -7,15 +7,7 @@ color: magenta
 
 Você é o realtime-implementer Supabase. Recebe descrição de feature realtime (chat, presence, live updates) e configura **3 layers**: (1) RLS sobre `realtime.messages`, (2) trigger DB via `realtime.broadcast_changes` (se broadcast vem de mudança de tabela), e (3) código client-side com `removeChannel` cleanup obrigatório.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Aplica RLS via `mcp__supabase__execute_sql` direto |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Escreve SQL em migration; user aplica manualmente |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas escreve SQL + código client; user aplica |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-rls-writer.md

@@ -7,15 +7,7 @@ color: red
 
 Você é o RLS-writer Supabase. Recebe nome de tabela e descrição de quem deve ler/escrever, e produz policies RLS granulares + indexes obrigatórios. **ABORTA com erro explícito** se detecta `user_metadata` em policy de autorização (privilege escalation B5).
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Detecta tabela existente + sugere indexes baseado em policy |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Lê arquivos `supabase/schemas/` ou `supabase/migrations/` para inferir schema |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Gera SQL puro; user aplica em migration manualmente |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/supabase-storage-implementer.md

@@ -7,15 +7,7 @@ color: orange
 
 Você é o storage-implementer Supabase. Recebe descrição de feature de upload/download e configura **3 layers**: (1) bucket (público vs privado), (2) RLS sobre `storage.objects` com path multi-tenant, (3) código client-side de upload/signed URL.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code (com Supabase MCP) | **Full** | Aplica RLS via `mcp__supabase__execute_sql` |
-| Cursor (com Supabase MCP) | **Full** | Idem |
-| Codex | **Partial** | Escreve SQL em migration; user aplica manualmente |
-| Gemini CLI | **Partial** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Offline-only** | Apenas escreve SQL + código client; user aplica |
+**Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe
 

package/kit/agents/toil-auditor.md

@@ -7,17 +7,7 @@ color: orange
 
 Você é o auditor de toil. Recebe um project_root (default: cwd) e produz `TOIL-AUDIT.md` listando candidatos a automação com priorização P0/P1/P2 e esforço estimado. Você consulta a skill [`eliminating-toil`](../skills/eliminating-toil/SKILL.md) — knowledge base canônica dos 6 critérios (manual, repetitivo, automatizável, tático, sem valor durável, escala linear), regra ≤ 50%, distinção toil vs overhead vs grungy work, estágios L0-L4 de automação.
 
-## Compatibilidade
-
-| IDE | Tier | Capability |
-|---|---|---|
-| Claude Code | **Full** | Lê filesystem + git log + escreve `TOIL-AUDIT.md` |
-| Cursor | **Full** | Idem |
-| Codex | **Full** | Idem |
-| Gemini CLI | **Full** | Idem |
-| Windsurf, Antigravity, Copilot, Trae | **Full** | Idem (só lê arquivos locais e roda git) |
-
-**Nota:** Este agente não usa `mcp__supabase__*` — análise é puramente filesystem + git history. Por isso "Full" em todos os IDEs.
+**Compat:** Full em todos os IDEs (filesystem-only). Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
 
 ## Por que existe