@luanpdd/kit-mcp 1.33.0 → 1.35.0

package/kit/COMANDOS.md

@@ -1,138 +1,138 @@
-# Comandos do framework — Referência Rápida
-
-## Fluxo Principal
-
-| Comando | O que faz |
-|---------|-----------|
-| `/novo-projeto` | Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md |
-| `/novo-marco` | Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos |
-| `/discutir-fase` | Reúne contexto da fase por questionamento adaptativo antes do planejamento (`--auto` para pular perguntas) |
-| `/planejar-fase` | Cria plano detalhado da fase (PLAN.md) com loop de verificação |
-| `/executar-fase` | Executa todos os planos de uma fase com paralelização por ondas |
-| `/proximo` | Avança automaticamente para o próximo passo lógico no workflow framework |
-| `/autonomo` | Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase |
-
-## Tarefas Rápidas
-
-| Comando | O que faz |
-|---------|-----------|
-| `/fazer` | Roteia texto livre para o comando do framework correto automaticamente |
-| `/rapido` | Executa tarefa trivial inline — sem subagentes, sem overhead de planejamento |
-| `/expresso` | Executa tarefa rápida com garantias framework (commits atômicos, rastreamento de estado), pula agentes opcionais |
-
-## Gerenciamento de Fases
-
-| Comando | O que faz |
-|---------|-----------|
-| `/adicionar-fase` | Adiciona fase ao final do milestone atual no roadmap |
-| `/inserir-fase` | Insere trabalho urgente como fase decimal (ex: 72.1) entre fases existentes |
-| `/remover-fase` | Remove uma fase futura do roadmap e renumera as subsequentes |
-| `/pesquisar-fase` | Pesquisa como implementar uma fase (standalone — normalmente use `/planejar-fase`) |
-| `/listar-hipoteses-fase` | Mostra as hipóteses do Claude sobre a abordagem de uma fase antes do planejamento |
-
-## Milestones e Progresso
-
-| Comando | O que faz |
-|---------|-----------|
-| `/progresso` | Verifica o progresso do projeto, mostra contexto e roteia para próxima ação |
-| `/auditar-marco` | Audita a conclusão do milestone contra a intenção original antes de arquivar |
-| `/concluir-marco` | Arquiva milestone concluído e prepara para próxima versão |
-| `/resumo-marco` | Gera resumo abrangente do projeto para onboarding e revisão da equipe |
-| `/planejar-lacunas` | Cria fases para fechar todas as lacunas identificadas pela auditoria de milestone |
-
-## Verificação e Qualidade
-
-| Comando | O que faz |
-|---------|-----------|
-| `/verificar-trabalho` | Valida funcionalidades construídas através de UAT conversacional |
-| `/validar-fase` | Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída |
-| `/auditar-uat` | Auditoria multi-fase de todos os itens de UAT e verificação pendentes |
-| `/adicionar-testes` | Gera testes para uma fase concluída com base nos critérios de UAT e implementação |
-| `/verificar-tarefas` | Lista todos os todos pendentes e seleciona um para trabalhar |
-
-## UI / Frontend
-
-| Comando | O que faz |
-|---------|-----------|
-| `/fase-ui` | Gera contrato de design UI (UI-SPEC.md) para fases de frontend |
-| `/revisar-ui` | Auditoria visual retroativa de 6 pilares do código frontend implementado |
-
-## Sessão e Contexto
-
-| Comando | O que faz |
-|---------|-----------|
-| `/pausar-trabalho` | Cria handoff de contexto ao pausar trabalho no meio de uma fase |
-| `/retomar-trabalho` | Retoma o trabalho da sessão anterior com restauração completa de contexto |
-| `/relatorio-sessao` | Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados |
-| `/fio` | Gerencia threads de contexto persistentes para trabalho entre sessões |
-
-## Análise e Diagnóstico
-
-| Comando | O que faz |
-|---------|-----------|
-| `/mapear-codebase` | Analisa a base de código com agentes paralelos, produz documentos em `.planning/codebase/` |
-| `/depurar` | Depuração sistemática com estado persistente entre resets de contexto |
-| `/forense` | Investigação post-mortem de workflows framework com falha — analisa git, artefatos e estado |
-| `/saude` | Diagnostica a integridade do diretório de planejamento e opcionalmente repara problemas |
-| `/estatisticas` | Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo |
-
-## Publicação e Colaboração
-
-| Comando | O que faz |
-|---------|-----------|
-| `/publicar` | Cria PR, executa revisão e prepara para merge após a verificação passar |
-| `/branch-pr` | Cria branch limpo para PR filtrando commits de `.planning/` — pronto para revisão de código |
-| `/revisar` | Solicita revisão entre IAs de planos de fase a partir de CLIs externas |
-
-## Backlog e Ideias
-
-| Comando | O que faz |
-|---------|-----------|
-| `/nota` | Captura de ideias sem fricção — adicionar, listar ou promover notas |
-| `/adicionar-tarefa` | Captura ideia ou tarefa como todo a partir do contexto da conversa atual |
-| `/adicionar-backlog` | Adiciona uma ideia ao estacionamento de backlog (numeração 999.x) |
-| `/revisar-backlog` | Revisa e promove itens do backlog para o milestone ativo |
-| `/plantar-ideia` | Captura ideia prospectiva com condições de gatilho — surge automaticamente no milestone certo |
-
-## Workspaces
-
-| Comando | O que faz |
-|---------|-----------|
-| `/novo-workspace` | Cria workspace isolado com cópias de repos e `.planning/` independente |
-| `/listar-workspaces` | Lista os workspaces framework ativos e seu status |
-| `/remover-workspace` | Remove um workspace framework e limpa as worktrees |
-| `/fluxos-trabalho` | Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, concluir e retomar |
-| `/gerenciador` | Central de comando interativa para gerenciar múltiplas fases em um terminal |
-
-## Perfil e Configurações
-
-| Comando | O que faz |
-|---------|-----------|
-| `/perfil-usuario` | Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude |
-| `/definir-perfil` | Altera o perfil de modelo para os agentes framework (quality/balanced/budget/inherit) |
-| `/configuracoes` | Configura os toggles de workflow framework e perfil de modelo |
-
-## Suíte Legacy Code (Feathers + modernizações IA/Supabase 2026)
-
-| Comando | O que faz |
-|---------|-----------|
-| `/legacy <subcomando>` | Orquestrador único — dispatch para agents da suíte (10 subcomandos com sinônimos PT/EN) |
-| `/caracterizar` | Gera characterization tests (cap 13) — golden snapshots cobrindo 7 grupos de equivalência |
-| `/encontrar-seams` | Identifica seams (cap 25) e recomenda técnica de dependency-breaking |
-| `/auditar-refactor` | Gate canônico — coleta evidências e retorna veredito GO/BLOCK/WARN/GO-OVERRIDE |
-| `/refactor-seguro` | Chain canônico — seams → caracterizar → auditar → executar; modos full/sprout/safe-extract/override |
-| `/capturar-payloads` | Instrumenta Edge Function Supabase para captura de payloads reais via mcp__supabase__get_logs (modernização) |
-| `/caracterizar-prompt` | Characterization de prompts/tools LLM com temperature=0 + seed fixo (modernização IA) |
-| `/storytelling` | IA gera mental model + naked CRC + extract candidates (cap 16-17 + modernização IA) |
-| `/detectar-duplicacao` | Shotgun surgery cross-codebase via embeddings + jscpd (cap 21 + modernização IA) |
-| `/auditar-observabilidade-cobertura` | Audit X/N Edge Functions com signals + SLO + burn alert + char (cross-suite) |
-
-## Utilitários
-
-| Comando | O que faz |
-|---------|-----------|
-| `/ajuda` | Mostra os comandos do framework disponíveis e o guia de uso |
-| `/atualizar` | Atualiza o framework para a versão mais recente com exibição de changelog |
-| `/reaplicar-patches` | Reaplicar modificações locais após uma atualização do framework |
-| `/limpeza` | Arquiva diretórios de fase acumulados de milestones concluídos |
-| `/entrar-discord` | Link para entrar na comunidade framework no Discord |
+# Comandos do framework — Referência Rápida
+
+## Fluxo Principal
+
+| Comando | O que faz |
+|---------|-----------|
+| `/novo-projeto` | Inicializa um novo projeto com coleta profunda de contexto e PROJECT.md |
+| `/novo-marco` | Inicia um novo ciclo de milestone — atualiza PROJECT.md e encaminha para requisitos |
+| `/discutir-fase` | Reúne contexto da fase por questionamento adaptativo antes do planejamento (`--auto` para pular perguntas) |
+| `/planejar-fase` | Cria plano detalhado da fase (PLAN.md) com loop de verificação |
+| `/executar-fase` | Executa todos os planos de uma fase com paralelização por ondas |
+| `/proximo` | Avança automaticamente para o próximo passo lógico no workflow framework |
+| `/autonomo` | Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase |
+
+## Tarefas Rápidas
+
+| Comando | O que faz |
+|---------|-----------|
+| `/fazer` | Roteia texto livre para o comando do framework correto automaticamente |
+| `/rapido` | Executa tarefa trivial inline — sem subagentes, sem overhead de planejamento |
+| `/expresso` | Executa tarefa rápida com garantias framework (commits atômicos, rastreamento de estado), pula agentes opcionais |
+
+## Gerenciamento de Fases
+
+| Comando | O que faz |
+|---------|-----------|
+| `/adicionar-fase` | Adiciona fase ao final do milestone atual no roadmap |
+| `/inserir-fase` | Insere trabalho urgente como fase decimal (ex: 72.1) entre fases existentes |
+| `/remover-fase` | Remove uma fase futura do roadmap e renumera as subsequentes |
+| `/pesquisar-fase` | Pesquisa como implementar uma fase (standalone — normalmente use `/planejar-fase`) |
+| `/listar-hipoteses-fase` | Mostra as hipóteses do Claude sobre a abordagem de uma fase antes do planejamento |
+
+## Milestones e Progresso
+
+| Comando | O que faz |
+|---------|-----------|
+| `/progresso` | Verifica o progresso do projeto, mostra contexto e roteia para próxima ação |
+| `/auditar-marco` | Audita a conclusão do milestone contra a intenção original antes de arquivar |
+| `/concluir-marco` | Arquiva milestone concluído e prepara para próxima versão |
+| `/resumo-marco` | Gera resumo abrangente do projeto para onboarding e revisão da equipe |
+| `/planejar-lacunas` | Cria fases para fechar todas as lacunas identificadas pela auditoria de milestone |
+
+## Verificação e Qualidade
+
+| Comando | O que faz |
+|---------|-----------|
+| `/verificar-trabalho` | Valida funcionalidades construídas através de UAT conversacional |
+| `/validar-fase` | Audita retroativamente e preenche lacunas de validação Nyquist para uma fase concluída |
+| `/auditar-uat` | Auditoria multi-fase de todos os itens de UAT e verificação pendentes |
+| `/adicionar-testes` | Gera testes para uma fase concluída com base nos critérios de UAT e implementação |
+| `/verificar-tarefas` | Lista todos os todos pendentes e seleciona um para trabalhar |
+
+## UI / Frontend
+
+| Comando | O que faz |
+|---------|-----------|
+| `/fase-ui` | Gera contrato de design UI (UI-SPEC.md) para fases de frontend |
+| `/revisar-ui` | Auditoria visual retroativa de 6 pilares do código frontend implementado |
+
+## Sessão e Contexto
+
+| Comando | O que faz |
+|---------|-----------|
+| `/pausar-trabalho` | Cria handoff de contexto ao pausar trabalho no meio de uma fase |
+| `/retomar-trabalho` | Retoma o trabalho da sessão anterior com restauração completa de contexto |
+| `/relatorio-sessao` | Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados |
+| `/fio` | Gerencia threads de contexto persistentes para trabalho entre sessões |
+
+## Análise e Diagnóstico
+
+| Comando | O que faz |
+|---------|-----------|
+| `/mapear-codebase` | Analisa a base de código com agentes paralelos, produz documentos em `.planning/codebase/` |
+| `/depurar` | Depuração sistemática com estado persistente entre resets de contexto |
+| `/forense` | Investigação post-mortem de workflows framework com falha — analisa git, artefatos e estado |
+| `/saude` | Diagnostica a integridade do diretório de planejamento e opcionalmente repara problemas |
+| `/estatisticas` | Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo |
+
+## Publicação e Colaboração
+
+| Comando | O que faz |
+|---------|-----------|
+| `/publicar` | Cria PR, executa revisão e prepara para merge após a verificação passar |
+| `/branch-pr` | Cria branch limpo para PR filtrando commits de `.planning/` — pronto para revisão de código |
+| `/revisar` | Solicita revisão entre IAs de planos de fase a partir de CLIs externas |
+
+## Backlog e Ideias
+
+| Comando | O que faz |
+|---------|-----------|
+| `/nota` | Captura de ideias sem fricção — adicionar, listar ou promover notas |
+| `/adicionar-tarefa` | Captura ideia ou tarefa como todo a partir do contexto da conversa atual |
+| `/adicionar-backlog` | Adiciona uma ideia ao estacionamento de backlog (numeração 999.x) |
+| `/revisar-backlog` | Revisa e promove itens do backlog para o milestone ativo |
+| `/plantar-ideia` | Captura ideia prospectiva com condições de gatilho — surge automaticamente no milestone certo |
+
+## Workspaces
+
+| Comando | O que faz |
+|---------|-----------|
+| `/novo-workspace` | Cria workspace isolado com cópias de repos e `.planning/` independente |
+| `/listar-workspaces` | Lista os workspaces framework ativos e seu status |
+| `/remover-workspace` | Remove um workspace framework e limpa as worktrees |
+| `/fluxos-trabalho` | Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, concluir e retomar |
+| `/gerenciador` | Central de comando interativa para gerenciar múltiplas fases em um terminal |
+
+## Perfil e Configurações
+
+| Comando | O que faz |
+|---------|-----------|
+| `/perfil-usuario` | Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude |
+| `/definir-perfil` | Altera o perfil de modelo para os agentes framework (quality/balanced/budget/inherit) |
+| `/configuracoes` | Configura os toggles de workflow framework e perfil de modelo |
+
+## Suíte Legacy Code (Feathers + modernizações IA/Supabase 2026)
+
+| Comando | O que faz |
+|---------|-----------|
+| `/legacy <subcomando>` | Orquestrador único — dispatch para agents da suíte (10 subcomandos com sinônimos PT/EN) |
+| `/caracterizar` | Gera characterization tests (cap 13) — golden snapshots cobrindo 7 grupos de equivalência |
+| `/encontrar-seams` | Identifica seams (cap 25) e recomenda técnica de dependency-breaking |
+| `/auditar-refactor` | Gate canônico — coleta evidências e retorna veredito GO/BLOCK/WARN/GO-OVERRIDE |
+| `/refactor-seguro` | Chain canônico — seams → caracterizar → auditar → executar; modos full/sprout/safe-extract/override |
+| `/capturar-payloads` | Instrumenta Edge Function Supabase para captura de payloads reais via mcp__supabase__get_logs (modernização) |
+| `/caracterizar-prompt` | Characterization de prompts/tools LLM com temperature=0 + seed fixo (modernização IA) |
+| `/storytelling` | IA gera mental model + naked CRC + extract candidates (cap 16-17 + modernização IA) |
+| `/detectar-duplicacao` | Shotgun surgery cross-codebase via embeddings + jscpd (cap 21 + modernização IA) |
+| `/auditar-observabilidade-cobertura` | Audit X/N Edge Functions com signals + SLO + burn alert + char (cross-suite) |
+
+## Utilitários
+
+| Comando | O que faz |
+|---------|-----------|
+| `/ajuda` | Mostra os comandos do framework disponíveis e o guia de uso |
+| `/atualizar` | Atualiza o framework para a versão mais recente com exibição de changelog |
+| `/reaplicar-patches` | Reaplicar modificações locais após uma atualização do framework |
+| `/limpeza` | Arquiva diretórios de fase acumulados de milestones concluídos |
+| `/entrar-discord` | Link para entrar na comunidade framework no Discord |

package/kit/COMPATIBILITY.md

@@ -1,70 +1,70 @@
-# 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-auth-hook-writer | B | Full | Full | Partial | Partial | Offline-only | Materializa Auth Hooks Postgres/HTTP; valida grants `supabase_auth_admin` via `execute_sql`; offline escreve SQL + Edge Function para user aplicar |
-| supabase-edge-fn-writer | A | Full | Full | Full | Full | Full | Escreve Edge Functions (arquivos locais); não usa `mcp__supabase__*` tools |
-| supabase-mfa-implementer | B | Full | Full | Partial | Partial | Offline-only | Materializa enrollment MFA + políticas RLS por AAL; valida `as restrictive` via `execute_sql`; offline escreve componentes + SQL |
-| 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-oauth-server-implementer | B | Full | Full | Partial | Partial | Offline-only | Materializa OAuth 2.1/OIDC server + MCP auth; aplica RLS por `client_id` via `execute_sql`; offline escreve config.toml + UI consentimento |
-| 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-social-auth-implementer | A | Full | Full | Full | Full | Full | Materializa social login OAuth (signInWithOAuth/IdToken) + rota callback PKCE + componentes nativos; totalmente filesystem |
-| supabase-sso-saml-architect | A | Full | Full | Full | Full | Full | Gera comandos `supabase sso` + attribute mapping JSON + RLS de tenant; totalmente filesystem (não usa MCP) |
-| 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:** ...`.
+# 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-auth-hook-writer | B | Full | Full | Partial | Partial | Offline-only | Materializa Auth Hooks Postgres/HTTP; valida grants `supabase_auth_admin` via `execute_sql`; offline escreve SQL + Edge Function para user aplicar |
+| supabase-edge-fn-writer | A | Full | Full | Full | Full | Full | Escreve Edge Functions (arquivos locais); não usa `mcp__supabase__*` tools |
+| supabase-mfa-implementer | B | Full | Full | Partial | Partial | Offline-only | Materializa enrollment MFA + políticas RLS por AAL; valida `as restrictive` via `execute_sql`; offline escreve componentes + SQL |
+| 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-oauth-server-implementer | B | Full | Full | Partial | Partial | Offline-only | Materializa OAuth 2.1/OIDC server + MCP auth; aplica RLS por `client_id` via `execute_sql`; offline escreve config.toml + UI consentimento |
+| 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-social-auth-implementer | A | Full | Full | Full | Full | Full | Materializa social login OAuth (signInWithOAuth/IdToken) + rota callback PKCE + componentes nativos; totalmente filesystem |
+| supabase-sso-saml-architect | A | Full | Full | Full | Full | Full | Gera comandos `supabase sso` + attribute mapping JSON + RLS de tenant; totalmente filesystem (não usa MCP) |
+| 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/README.md

@@ -1,76 +1,76 @@
-# Your kit lives here
-
-This `kit/` folder is the canonical source of your personal collection of
-agents, slash-commands and skills. `kit-mcp` reads from here and projects
-into every supported IDE.
-
-## Layout
-
-```
-kit/
-├── agents/                 one .md per sub-agent
-│   └── <name>.md
-├── commands/               one .md per slash-command
-│   └── <name>.md
-└── skills/                 one folder per skill, containing SKILL.md
-    └── <name>/
-        ├── SKILL.md
-        └── references/     optional reference docs
-```
-
-## File format
-
-Every file uses YAML frontmatter for metadata + Markdown body for the prompt:
-
-```markdown
----
-name: my-agent
-description: One-sentence description of what this agent does and when to use it.
-tools: Read, Write, Bash    # optional, agents only
-color: blue                 # optional, agents only
----
-
-The body of the agent prompt goes here. This is what the LLM sees when
-the agent is spawned. Keep it focused, give clear instructions, list
-constraints.
-```
-
-## Three example items ship in this folder
-
-- `agents/example-reviewer.md` — minimal sub-agent template
-- `commands/example-greeting.md` — minimal slash-command template
-- `skills/example-skill/SKILL.md` — minimal skill template
-
-Replace them with your own. Or, if you keep your kit elsewhere, point
-kit-mcp at it:
-
-```bash
-kit kit list-agents --kit-root /path/to/your/kit
-kit sync install claude-code --kit-root /path/to/your/kit --project-root .
-```
-
-Or set `KIT_MCP_KIT_ROOT` env var to make it the default for the session.
-
-## Suíte DDIA Foundations (v1.22)
-
-8ª suíte do kit, derivada de *Designing Data-Intensive Applications* (Martin Kleppmann, O'Reilly 2017). Cobre capítulos 4, 5, 6, 7, 8, 9, 11.
-
-**Convenção nova:** A partir de v1.22, todos os artefatos novos (skills, agents, commands) usam **PT-BR descritivo** para nome de arquivo/identificador. Termos técnicos canônicos (CDC, RLS, MVCC, write skew, fencing token) preservados em descrições/conteúdo.
-
-**Skills (7):**
-- `evolucao-schema-compativel` (Ch 4) — backward/forward compat, padrão 3-passos
-- `consistencia-leitura-replica` (Ch 5) — read-after-write, monotonic reads, prefix
-- `tenant-quente-mitigacao` (Ch 6) — Justin Bieber problem + 5 estratégias
-- `postgres-isolamento-concorrencia` (Ch 7) — 6 race conditions, isolation levels
-- `armadilhas-sistemas-distribuidos` (Ch 8) — clock skew, fencing tokens, GC pause
-- `escolha-modelo-consistencia` (Ch 9) — linearizable vs causal vs eventual
-- `streams-eventos-cdc` (Ch 11) — CDC, event sourcing, exactly-once
-
-**Agents (3):**
-- `auditor-consistencia-isolamento` — detecta 6 anti-patterns de race condition
-- `detector-tenant-quente` — detecta hot tenants via Supabase logs
-- `validador-evolucao-schema` — pré-validação de migration arriscada
-
-**Comando:** `/dados-distribuidos [auditar-consistencia | auditar-tenant-quente | validar-evolucao-schema | implementar-cdc]`
-
-**Glossário compartilhado:** `_shared-dados-distribuidos/glossary.md` (PT-BR↔EN, 60+ termos)
+# Your kit lives here
+
+This `kit/` folder is the canonical source of your personal collection of
+agents, slash-commands and skills. `kit-mcp` reads from here and projects
+into every supported IDE.
+
+## Layout
+
+```
+kit/
+├── agents/                 one .md per sub-agent
+│   └── <name>.md
+├── commands/               one .md per slash-command
+│   └── <name>.md
+└── skills/                 one folder per skill, containing SKILL.md
+    └── <name>/
+        ├── SKILL.md
+        └── references/     optional reference docs
+```
+
+## File format
+
+Every file uses YAML frontmatter for metadata + Markdown body for the prompt:
+
+```markdown
+---
+name: my-agent
+description: One-sentence description of what this agent does and when to use it.
+tools: Read, Write, Bash    # optional, agents only
+color: blue                 # optional, agents only
+---
+
+The body of the agent prompt goes here. This is what the LLM sees when
+the agent is spawned. Keep it focused, give clear instructions, list
+constraints.
+```
+
+## Three example items ship in this folder
+
+- `agents/example-reviewer.md` — minimal sub-agent template
+- `commands/example-greeting.md` — minimal slash-command template
+- `skills/example-skill/SKILL.md` — minimal skill template
+
+Replace them with your own. Or, if you keep your kit elsewhere, point
+kit-mcp at it:
+
+```bash
+kit kit list-agents --kit-root /path/to/your/kit
+kit sync install claude-code --kit-root /path/to/your/kit --project-root .
+```
+
+Or set `KIT_MCP_KIT_ROOT` env var to make it the default for the session.
+
+## Suíte DDIA Foundations (v1.22)
+
+8ª suíte do kit, derivada de *Designing Data-Intensive Applications* (Martin Kleppmann, O'Reilly 2017). Cobre capítulos 4, 5, 6, 7, 8, 9, 11.
+
+**Convenção nova:** A partir de v1.22, todos os artefatos novos (skills, agents, commands) usam **PT-BR descritivo** para nome de arquivo/identificador. Termos técnicos canônicos (CDC, RLS, MVCC, write skew, fencing token) preservados em descrições/conteúdo.
+
+**Skills (7):**
+- `evolucao-schema-compativel` (Ch 4) — backward/forward compat, padrão 3-passos
+- `consistencia-leitura-replica` (Ch 5) — read-after-write, monotonic reads, prefix
+- `tenant-quente-mitigacao` (Ch 6) — Justin Bieber problem + 5 estratégias
+- `postgres-isolamento-concorrencia` (Ch 7) — 6 race conditions, isolation levels
+- `armadilhas-sistemas-distribuidos` (Ch 8) — clock skew, fencing tokens, GC pause
+- `escolha-modelo-consistencia` (Ch 9) — linearizable vs causal vs eventual
+- `streams-eventos-cdc` (Ch 11) — CDC, event sourcing, exactly-once
+
+**Agents (3):**
+- `auditor-consistencia-isolamento` — detecta 6 anti-patterns de race condition
+- `detector-tenant-quente` — detecta hot tenants via Supabase logs
+- `validador-evolucao-schema` — pré-validação de migration arriscada
+
+**Comando:** `/dados-distribuidos [auditar-consistencia | auditar-tenant-quente | validar-evolucao-schema | implementar-cdc]`
+
+**Glossário compartilhado:** `_shared-dados-distribuidos/glossary.md` (PT-BR↔EN, 60+ termos)