@luanpdd/kit-mcp 1.27.0 → 1.29.0

package/kit/commands/auditar-marco.md

@@ -1,180 +1,180 @@
----
-name: auditar-marco
-description: Audita a conclusão do milestone contra a intenção original antes de arquivar
-argument-hint: "[version]"
-allowed-tools:
-  - Read
-  - Glob
-  - Grep
-  - Bash
-  - Task
-  - Write
----
-<objective>
-Verificar se o milestone alcançou sua definição de pronto. Checar cobertura de requisitos, integração entre fases e fluxos de ponta a ponta.
-
-**Este comando É o orquestrador.** Lê os arquivos VERIFICATION.md existentes (fases já verificadas durante o executar-fase), agrega dívidas técnicas e lacunas adiadas, então invoca o verificador de integração para a fiação entre fases.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/audit-milestone.md
-</execution_context>
-
-<context>
-Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
-
-Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
-
-**Trabalho Concluído:**
-Glob: .planning/phases/*/*-SUMMARY.md
-Glob: .planning/phases/*/*-VERIFICATION.md
-</context>
-
-<process>
-Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
-Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
-</process>
-
-<observability_integration>
-**OMM scoring (v1.9 — INT-FW-04):**
-
-Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
-
-```text
-Skill(skill="framework:auditar-observabilidade")
-```
-
-O comando `/auditar-observabilidade` invoca o agente [`omm-auditor`](../agents/omm-auditor.md) que pontua as 5 capacidades (resiliência, qualidade, complexidade, cadência, comportamento) contra o marco anterior. O OMM-REPORT.md gerado é incluído como anexo no MILESTONE-AUDIT.md.
-
-Resultado de regression OMM:
-- **0 regressions:** audit aprovado
-- **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
-- **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
-
-Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
-
-**REQ:** INT-FW-04.
-</observability_integration>
-
-<sre_integration>
-**Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
-
-Quando `workflow.audit_milestone_toil = true` (default), o workflow inclui passo Toil audit auto-invocação **antes** do passo de OMM scoring (que já existe via `<observability_integration>` v1.9 — INT-FW-04):
-
-```text
-Skill(skill="framework:auditar-toil")
-```
-
-O comando `/auditar-toil` invoca o agente [toil-auditor](../agents/toil-auditor.md) que analisa `git log` recente (≤ 90 dias) + scripts shell em `scripts/` + comandos manuais documentados em README/runbooks/`.planning/runbooks/` + tarefas repetitivas em `.planning/phases/*/SUMMARY.md`. O agent classifica candidatos a automação (P0/P1/P2 por esforço × frequência) e produz `.planning/TOIL-AUDIT.md` na raiz do `.planning/`. Cap 5 do livro Google SRE (*Eliminating Toil*) define toil canonicamente: **manual + repetitivo + automatizável + tático + sem valor durável + escala linear com tráfego/team**.
-
-**Loop fechado canônico:**
-
-```text
-/auditar-marco
-  ↓
-Step A: invoca /auditar-toil   ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
-  ↓
-Step B: invoca /auditar-observabilidade   ← OMM scoring v1.9 (INT-FW-04)
-  ↓
-omm-auditor consulta .planning/TOIL-AUDIT.md   ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
-  ↓
-OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
-  ↓
-MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
-```
-
-**Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
-
-O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
-
-> "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
-
-Se TOIL-AUDIT.md ausente ou stale (> 30d), `omm-auditor` delega geração via `Task(subagent_type=toil-auditor)` ad-hoc — duplicação. Auto-invocar `/auditar-toil` em `/auditar-marco` evita essa duplicação ao garantir que `omm-auditor` encontre TOIL-AUDIT.md fresco.
-
-**Tabela de score Capacidade 3 (consumida por omm-auditor):**
-
-| % toil pelo time | OMM Capacidade 3 score | Implicação |
-|---|---|---|
-| < 15% | 5 | Excelente — automação madura |
-| 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
-| 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
-| 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
-| > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
-
-Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
-
-**Output esperado:**
-
-`.planning/TOIL-AUDIT.md` contém:
-
-1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
-2. Lista de candidatos a automação P0/P1/P2 com:
-   - Comando/processo manual identificado
-   - Frequência (× por sprint/mês)
-   - Esforço estimado de automação (S/M/L)
-   - ROI = Frequência × Tempo Manual / Esforço Automação
-3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
-4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
-
-**Quando desligar gate:**
-
-- Solo developer side project (toil = você mesmo, audit é overhead)
-- Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
-- Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
-
-Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
-
-**Skill consultada:** [eliminating-toil](../skills/eliminating-toil/SKILL.md) (cap 5 livro Google SRE — *Eliminating Toil* — define toil canonicamente, regra ≤ 50%, padrões de automação, distinção toil vs overhead vs grungy work).
-
-**Anti-patterns prevenidos:**
-
-- "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
-- "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
-- "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
-- "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
-
-**REQ:** INT-FW-V2-03.
-</sre_integration>
-
-<legacy_refactor_integration>
-**Legacy refactor safety audit (opt-in):**
-
-Quando `workflow.audit_milestone_legacy_refactor = true` (default: false em projetos < 50% OMM maturity, true acima), o workflow inclui passo de auditoria de refactor safety:
-
-```text
-Para cada arquivo modificado por tasks com kind=refactor no milestone:
-  Task(
-    subagent_type="refactor-safety-auditor",
-    prompt="
-target_file: <file>
-change_kind: refactor
-mode: blocking
-output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
-
-Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
-"
-  )
-```
-
-**Critérios de aprovação:**
-- Cada refactor de risco no milestone tem characterization tests linkados E pass verde
-- Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
-- Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
-
-**Resultado de regression:**
-- 0 refactors sem char → audit aprovado
-- 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
-- 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
-
-Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
-Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
-
-**Quando desligar gate:**
-- Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
-- Solo dev side project sem stakes de produção (audit é overhead)
-- Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
-
-Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
-
-**REQ:** INT-LEGACY-FW-01.
+---
+name: auditar-marco
+description: Audita a conclusão do milestone contra a intenção original antes de arquivar
+argument-hint: "[version]"
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - Write
+---
+<objective>
+Verificar se o milestone alcançou sua definição de pronto. Checar cobertura de requisitos, integração entre fases e fluxos de ponta a ponta.
+
+**Este comando É o orquestrador.** Lê os arquivos VERIFICATION.md existentes (fases já verificadas durante o executar-fase), agrega dívidas técnicas e lacunas adiadas, então invoca o verificador de integração para a fiação entre fases.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/audit-milestone.md
+</execution_context>
+
+<context>
+Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
+
+Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
+
+**Trabalho Concluído:**
+Glob: .planning/phases/*/*-SUMMARY.md
+Glob: .planning/phases/*/*-VERIFICATION.md
+</context>
+
+<process>
+Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
+Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
+</process>
+
+<observability_integration>
+**OMM scoring (v1.9 — INT-FW-04):**
+
+Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
+
+```text
+Skill(skill="framework:auditar-observabilidade")
+```
+
+O comando `/auditar-observabilidade` invoca o agente [`omm-auditor`](../agents/omm-auditor.md) que pontua as 5 capacidades (resiliência, qualidade, complexidade, cadência, comportamento) contra o marco anterior. O OMM-REPORT.md gerado é incluído como anexo no MILESTONE-AUDIT.md.
+
+Resultado de regression OMM:
+- **0 regressions:** audit aprovado
+- **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
+- **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
+
+Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
+
+**REQ:** INT-FW-04.
+</observability_integration>
+
+<sre_integration>
+**Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
+
+Quando `workflow.audit_milestone_toil = true` (default), o workflow inclui passo Toil audit auto-invocação **antes** do passo de OMM scoring (que já existe via `<observability_integration>` v1.9 — INT-FW-04):
+
+```text
+Skill(skill="framework:auditar-toil")
+```
+
+O comando `/auditar-toil` invoca o agente [toil-auditor](../agents/toil-auditor.md) que analisa `git log` recente (≤ 90 dias) + scripts shell em `scripts/` + comandos manuais documentados em README/runbooks/`.planning/runbooks/` + tarefas repetitivas em `.planning/phases/*/SUMMARY.md`. O agent classifica candidatos a automação (P0/P1/P2 por esforço × frequência) e produz `.planning/TOIL-AUDIT.md` na raiz do `.planning/`. Cap 5 do livro Google SRE (*Eliminating Toil*) define toil canonicamente: **manual + repetitivo + automatizável + tático + sem valor durável + escala linear com tráfego/team**.
+
+**Loop fechado canônico:**
+
+```text
+/auditar-marco
+  ↓
+Step A: invoca /auditar-toil   ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
+  ↓
+Step B: invoca /auditar-observabilidade   ← OMM scoring v1.9 (INT-FW-04)
+  ↓
+omm-auditor consulta .planning/TOIL-AUDIT.md   ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
+  ↓
+OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
+  ↓
+MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
+```
+
+**Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
+
+O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
+
+> "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
+
+Se TOIL-AUDIT.md ausente ou stale (> 30d), `omm-auditor` delega geração via `Task(subagent_type=toil-auditor)` ad-hoc — duplicação. Auto-invocar `/auditar-toil` em `/auditar-marco` evita essa duplicação ao garantir que `omm-auditor` encontre TOIL-AUDIT.md fresco.
+
+**Tabela de score Capacidade 3 (consumida por omm-auditor):**
+
+| % toil pelo time | OMM Capacidade 3 score | Implicação |
+|---|---|---|
+| < 15% | 5 | Excelente — automação madura |
+| 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
+| 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
+| 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
+| > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
+
+Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
+
+**Output esperado:**
+
+`.planning/TOIL-AUDIT.md` contém:
+
+1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
+2. Lista de candidatos a automação P0/P1/P2 com:
+   - Comando/processo manual identificado
+   - Frequência (× por sprint/mês)
+   - Esforço estimado de automação (S/M/L)
+   - ROI = Frequência × Tempo Manual / Esforço Automação
+3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
+4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
+
+**Quando desligar gate:**
+
+- Solo developer side project (toil = você mesmo, audit é overhead)
+- Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
+- Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
+
+Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
+
+**Skill consultada:** [eliminating-toil](../skills/eliminating-toil/SKILL.md) (cap 5 livro Google SRE — *Eliminating Toil* — define toil canonicamente, regra ≤ 50%, padrões de automação, distinção toil vs overhead vs grungy work).
+
+**Anti-patterns prevenidos:**
+
+- "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
+- "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
+- "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
+- "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
+
+**REQ:** INT-FW-V2-03.
+</sre_integration>
+
+<legacy_refactor_integration>
+**Legacy refactor safety audit (opt-in):**
+
+Quando `workflow.audit_milestone_legacy_refactor = true` (default: false em projetos < 50% OMM maturity, true acima), o workflow inclui passo de auditoria de refactor safety:
+
+```text
+Para cada arquivo modificado por tasks com kind=refactor no milestone:
+  Task(
+    subagent_type="refactor-safety-auditor",
+    prompt="
+target_file: <file>
+change_kind: refactor
+mode: blocking
+output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
+
+Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
+"
+  )
+```
+
+**Critérios de aprovação:**
+- Cada refactor de risco no milestone tem characterization tests linkados E pass verde
+- Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
+- Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
+
+**Resultado de regression:**
+- 0 refactors sem char → audit aprovado
+- 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
+- 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
+
+Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
+Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
+
+**Quando desligar gate:**
+- Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
+- Solo dev side project sem stakes de produção (audit é overhead)
+- Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
+
+Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
+
+**REQ:** INT-LEGACY-FW-01.
 </legacy_refactor_integration>

package/kit/commands/auditar-observabilidade-cobertura.md

@@ -1,6 +1,6 @@
 ---
 name: auditar-observabilidade-cobertura
-description: Audita projeto Supabase mostrando X/N Edge Functions com 4 golden signals + Y/N com SLO + Z/N com burn alert + W/N com characterization tests. Top 5 críticas (por traffic 30d) sem cobertura. User-request explícito.
+description: Audita projeto Supabase mostrando X/N Edge Functions com 4 golden signals + Y/N com SLO + Z/N com burn alert + W/N com characterization tests. Top 5 críticas (por traffic 30d) sem cobertura.
 argument-hint: "[--traffic-window 30d] [--top-n 5] [--dimensions signals,slo,burn-alert,characterization] [--output PATH]"
 allowed-tools:
   - Read

package/kit/commands/auditar-refactor.md

@@ -1,6 +1,6 @@
 ---
 name: auditar-refactor
-description: Invoca refactor-safety-auditor — gate canônico antes de qualquer refactor. Coleta evidências (linhas, contrato externo, coverage, mutation) e retorna veredito GO/BLOCK/WARN/GO-OVERRIDE. Bloqueia refactor de risco sem characterization.
+description: Invoca refactor-safety-auditor — gate canônico antes de qualquer refactor. Coleta evidências (linhas, contrato externo, coverage, mutation) e retorna veredito GO/BLOCK/WARN/GO-OVERRIDE.
 argument-hint: "<target_file> [--change-kind refactor|sprout|safe-extract|override] [--mode blocking|consultive] [--ticket REQ-N] [--reason \"...\"]"
 allowed-tools:
   - Read

package/kit/commands/auditar-release.md

@@ -1,6 +1,6 @@
 ---
 name: auditar-release
-description: Invoca release-pipeline-auditor — audita CI/CD para hermeticidade (lockfile + frozen-install + image SHA + sem network), reprodutibilidade (versions pinned), policy enforcement (branch protection, signed commits, CODEOWNERS). Cap 8 livro Google SRE.
+description: Invoca release-pipeline-auditor — audita CI/CD para hermeticidade (lockfile + frozen-install + image SHA + sem network), reprodutibilidade (versions pinned), policy enforcement (branch protection…
 argument-hint: "[--dimensions hermeticidade,reprodutibilidade,policy-enforcement] [--gh-repo OWNER/REPO]"
 allowed-tools:
   - Read

package/kit/commands/auditar-uat.md

@@ -1,24 +1,24 @@
----
-name: auditar-uat
-description: Auditoria multi-fase de todos os itens de UAT e verificação pendentes
-allowed-tools:
-  - Read
-  - Glob
-  - Grep
-  - Bash
----
-<objective>
-Verificar todas as fases em busca de itens de UAT pendentes, ignorados, bloqueados e que precisam de humano. Cruzar com a base de código para detectar documentação desatualizada. Produzir plano de testes humanos priorizado.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/audit-uat.md
-</execution_context>
-
-<context>
-Arquivos principais de planejamento são carregados no workflow via CLI.
-
-**Escopo:**
-Glob: .planning/phases/*/*-UAT.md
-Glob: .planning/phases/*/*-VERIFICATION.md
+---
+name: auditar-uat
+description: Auditoria multi-fase de todos os itens de UAT e verificação pendentes
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+---
+<objective>
+Verificar todas as fases em busca de itens de UAT pendentes, ignorados, bloqueados e que precisam de humano. Cruzar com a base de código para detectar documentação desatualizada. Produzir plano de testes humanos priorizado.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/audit-uat.md
+</execution_context>
+
+<context>
+Arquivos principais de planejamento são carregados no workflow via CLI.
+
+**Escopo:**
+Glob: .planning/phases/*/*-UAT.md
+Glob: .planning/phases/*/*-VERIFICATION.md
 </context>

package/kit/commands/autonomo.md

@@ -1,41 +1,41 @@
----
-name: autonomo
-description: Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase
-argument-hint: "[--from N]"
-allowed-tools:
-  - Read
-  - Write
-  - Bash
-  - Glob
-  - Grep
-  - AskUserQuestion
-  - Task
----
-<objective>
-Executa todas as fases restantes do milestone de forma autônoma. Para cada fase: discutir → planejar → executar. Pausa apenas para decisões do usuário (aceitação de área cinzenta, bloqueadores, solicitações de validação).
-
-Usa descoberta de fases do ROADMAP.md e invocações Skill() flat para cada comando de fase. Após todas as fases concluírem: auditoria de milestone → concluir → limpeza.
-
-**Cria/Atualiza:**
-- `.planning/STATE.md` — atualizado após cada fase
-- `.planning/ROADMAP.md` — progresso atualizado após cada fase
-- Artefatos de fase — CONTEXT.md, PLANOs, SUMMARYs por fase
-
-**Após:** O milestone está completo e limpo.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/autonomous.md
-@./.claude/framework/references/ui-brand.md
-</execution_context>
-
-<context>
-Flag opcional: `--from N` — começar da fase N em vez da primeira fase incompleta.
-
-Contexto do projeto, lista de fases e estado são resolvidos dentro do workflow usando comandos init (`tools.cjs init milestone-op`, `tools.cjs roadmap analyze`). Sem carregamento prévio de contexto necessário.
-</context>
-
-<process>
-Execute o workflow autonomous de @./.claude/framework/workflows/autonomous.md do início ao fim.
-Preserve todos os checkpoints do workflow (descoberta de fases, execução por fase, tratamento de bloqueadores, exibição de progresso).
+---
+name: autonomo
+description: Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase
+argument-hint: "[--from N]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - Glob
+  - Grep
+  - AskUserQuestion
+  - Task
+---
+<objective>
+Executa todas as fases restantes do milestone de forma autônoma. Para cada fase: discutir → planejar → executar. Pausa apenas para decisões do usuário (aceitação de área cinzenta, bloqueadores, solicitações de validação).
+
+Usa descoberta de fases do ROADMAP.md e invocações Skill() flat para cada comando de fase. Após todas as fases concluírem: auditoria de milestone → concluir → limpeza.
+
+**Cria/Atualiza:**
+- `.planning/STATE.md` — atualizado após cada fase
+- `.planning/ROADMAP.md` — progresso atualizado após cada fase
+- Artefatos de fase — CONTEXT.md, PLANOs, SUMMARYs por fase
+
+**Após:** O milestone está completo e limpo.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/autonomous.md
+@./.claude/framework/references/ui-brand.md
+</execution_context>
+
+<context>
+Flag opcional: `--from N` — começar da fase N em vez da primeira fase incompleta.
+
+Contexto do projeto, lista de fases e estado são resolvidos dentro do workflow usando comandos init (`tools.cjs init milestone-op`, `tools.cjs roadmap analyze`). Sem carregamento prévio de contexto necessário.
+</context>
+
+<process>
+Execute o workflow autonomous de @./.claude/framework/workflows/autonomous.md do início ao fim.
+Preserve todos os checkpoints do workflow (descoberta de fases, execução por fase, tratamento de bloqueadores, exibição de progresso).
 </process>

package/kit/commands/branch-pr.md

@@ -1,25 +1,25 @@
----
-name: branch-pr
-description: Cria um branch limpo para PR filtrando commits de .planning/ — pronto para revisão de código
-argument-hint: "[branch destino, padrão: main]"
-allowed-tools:
-  - Bash
-  - Read
-  - AskUserQuestion
----
-
-<objective>
-Criar um branch limpo adequado para pull requests filtrando commits de .planning/
-do branch atual. Revisores veem apenas mudanças de código, não artefatos de planejamento framework.
-
-Isso resolve o problema de diffs de PR poluídos com mudanças de PLAN.md, SUMMARY.md, STATE.md
-que são irrelevantes para revisão de código.
-</objective>
-
-<execution_context>
-@./.claude/framework/workflows/pr-branch.md
-</execution_context>
-
-<process>
-Execute o workflow pr-branch de @./.claude/framework/workflows/pr-branch.md do início ao fim.
+---
+name: branch-pr
+description: Cria um branch limpo para PR filtrando commits de .planning/ — pronto para revisão de código
+argument-hint: "[branch destino, padrão: main]"
+allowed-tools:
+  - Bash
+  - Read
+  - AskUserQuestion
+---
+
+<objective>
+Criar um branch limpo adequado para pull requests filtrando commits de .planning/
+do branch atual. Revisores veem apenas mudanças de código, não artefatos de planejamento framework.
+
+Isso resolve o problema de diffs de PR poluídos com mudanças de PLAN.md, SUMMARY.md, STATE.md
+que são irrelevantes para revisão de código.
+</objective>
+
+<execution_context>
+@./.claude/framework/workflows/pr-branch.md
+</execution_context>
+
+<process>
+Execute o workflow pr-branch de @./.claude/framework/workflows/pr-branch.md do início ao fim.
 </process>

package/kit/commands/burn-rate-status.md

@@ -1,6 +1,6 @@
 ---
 name: burn-rate-status
-description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/. Calcula SLI atual, fast_burn (1h) + slow_burn (6h) independentes, ETA exhaustão e ação combinada (PAGE/TICKET/WARN/OK). Aplica skill burn-rate-alerting (fator 4× lookahead/baseline canônico Google SRE).
+description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/.
 argument-hint: "[<slo_name>] [--fast-baseline 1h] [--slow-baseline 6h] [--format table|json]"
 allowed-tools:
   - Read

package/kit/commands/capturar-payloads.md

@@ -1,6 +1,6 @@
 ---
 name: capturar-payloads
-description: Invoca payload-capture-instrumenter — instrumenta Edge Function Supabase para captura via mcp__supabase__get_logs por N dias, sanitiza PII, gera fixtures para legacy-characterizer. Modernização 2026.
+description: Invoca payload-capture-instrumenter — instrumenta Edge Function Supabase para captura via mcp__supabase__get_logs por N dias, sanitiza PII, gera fixtures para legacy-characterizer.
 argument-hint: "<edge_function_path> [--days N] [--max-payloads N] [--mode instrument|drain|full] [--sanitize-keys k1,k2,...]"
 allowed-tools:
   - Read

package/kit/commands/caracterizar.md

@@ -1,6 +1,6 @@
 ---
 name: caracterizar
-description: Invoca legacy-characterizer — gera characterization tests (cap 13 Feathers) capturando comportamento atual como golden snapshots; cobre 5+ grupos de equivalência canônicos; valida cobertura via mutation testing.
+description: Invoca legacy-characterizer — gera characterization tests (cap 13 Feathers) capturando comportamento atual como golden snapshots; cobre 5+ grupos de equivalência canônicos; valida cobertur…
 argument-hint: "<target_file> [--symbol <name>] [--min-inputs N] [--gap-fill] [--fixtures-dir <path>] [--no-mutation]"
 allowed-tools:
   - Read