@luanpdd/kit-mcp 1.21.0 → 1.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (275) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +914 -648
  3. package/kit/COMANDOS.md +138 -138
  4. package/kit/README.md +76 -52
  5. package/kit/agents/advisor-researcher.md +106 -106
  6. package/kit/agents/assumptions-analyzer.md +107 -107
  7. package/kit/agents/audit-log-implementer.md +138 -0
  8. package/kit/agents/auditor-consistencia-isolamento.md +413 -0
  9. package/kit/agents/codebase-mapper.md +768 -768
  10. package/kit/agents/crm-pipeline-implementer.md +106 -0
  11. package/kit/agents/debugger.md +813 -772
  12. package/kit/agents/detector-tenant-quente.md +337 -0
  13. package/kit/agents/evolution-go-integrator.md +21 -0
  14. package/kit/agents/example-reviewer.md +21 -21
  15. package/kit/agents/executor.md +564 -523
  16. package/kit/agents/integration-checker.md +200 -200
  17. package/kit/agents/invite-flow-implementer.md +52 -0
  18. package/kit/agents/lgpd-compliance-auditor.md +89 -0
  19. package/kit/agents/multi-tenant-isolation-auditor.md +10 -0
  20. package/kit/agents/multi-tenant-rls-writer.md +78 -0
  21. package/kit/agents/nyquist-auditor.md +178 -178
  22. package/kit/agents/org-onboarding-implementer.md +21 -0
  23. package/kit/agents/phase-researcher.md +696 -696
  24. package/kit/agents/plan-checker.md +272 -272
  25. package/kit/agents/planner.md +922 -891
  26. package/kit/agents/project-researcher.md +652 -652
  27. package/kit/agents/research-synthesizer.md +245 -245
  28. package/kit/agents/roadmapper.md +677 -677
  29. package/kit/agents/supabase-architect.md +27 -0
  30. package/kit/agents/supabase-auth-bootstrapper.md +80 -0
  31. package/kit/agents/supabase-column-privileges-writer.md +399 -0
  32. package/kit/agents/supabase-migration-writer.md +141 -14
  33. package/kit/agents/supabase-rbac-implementer.md +392 -0
  34. package/kit/agents/supabase-rls-hardener.md +521 -0
  35. package/kit/agents/supabase-rls-writer.md +105 -9
  36. package/kit/agents/supabase-roles-implementer.md +355 -0
  37. package/kit/agents/super-admin-implementer.md +99 -0
  38. package/kit/agents/ui-auditor.md +437 -437
  39. package/kit/agents/ui-checker.md +302 -302
  40. package/kit/agents/ui-researcher.md +355 -355
  41. package/kit/agents/user-profiler.md +175 -175
  42. package/kit/agents/validador-evolucao-schema.md +335 -0
  43. package/kit/agents/verifier.md +728 -728
  44. package/kit/commands/adicionar-backlog.md +75 -75
  45. package/kit/commands/adicionar-fase.md +42 -42
  46. package/kit/commands/adicionar-tarefa.md +45 -45
  47. package/kit/commands/adicionar-testes.md +41 -41
  48. package/kit/commands/ajuda.md +21 -21
  49. package/kit/commands/atualizar.md +37 -37
  50. package/kit/commands/auditar-marco.md +179 -179
  51. package/kit/commands/auditar-uat.md +23 -23
  52. package/kit/commands/autonomo.md +40 -40
  53. package/kit/commands/branch-pr.md +24 -24
  54. package/kit/commands/concluir-marco.md +247 -247
  55. package/kit/commands/configuracoes.md +36 -36
  56. package/kit/commands/dados-distribuidos.md +188 -0
  57. package/kit/commands/definir-perfil.md +10 -10
  58. package/kit/commands/depurar.md +190 -190
  59. package/kit/commands/discutir-fase.md +131 -131
  60. package/kit/commands/entrar-discord.md +17 -17
  61. package/kit/commands/estatisticas.md +18 -18
  62. package/kit/commands/example-greeting.md +33 -33
  63. package/kit/commands/executar-fase.md +58 -58
  64. package/kit/commands/expresso.md +56 -56
  65. package/kit/commands/fase-ui.md +34 -34
  66. package/kit/commands/fazer.md +57 -57
  67. package/kit/commands/fio.md +125 -125
  68. package/kit/commands/fluxos-trabalho.md +64 -64
  69. package/kit/commands/forense.md +176 -176
  70. package/kit/commands/gerenciador.md +38 -38
  71. package/kit/commands/inserir-fase.md +31 -31
  72. package/kit/commands/limpeza.md +17 -17
  73. package/kit/commands/listar-hipoteses-fase.md +45 -45
  74. package/kit/commands/listar-workspaces.md +18 -18
  75. package/kit/commands/mapear-codebase.md +70 -70
  76. package/kit/commands/nota.md +33 -33
  77. package/kit/commands/novo-marco.md +43 -43
  78. package/kit/commands/novo-projeto.md +41 -41
  79. package/kit/commands/novo-workspace.md +43 -43
  80. package/kit/commands/pausar-trabalho.md +37 -37
  81. package/kit/commands/perfil-usuario.md +45 -45
  82. package/kit/commands/pesquisar-fase.md +195 -195
  83. package/kit/commands/planejar-fase.md +67 -67
  84. package/kit/commands/planejar-lacunas.md +33 -33
  85. package/kit/commands/plantar-ideia.md +25 -25
  86. package/kit/commands/progresso.md +24 -24
  87. package/kit/commands/proximo.md +30 -30
  88. package/kit/commands/publicar.md +490 -490
  89. package/kit/commands/rapido.md +35 -35
  90. package/kit/commands/reaplicar-patches.md +124 -124
  91. package/kit/commands/relatorio-sessao.md +19 -19
  92. package/kit/commands/remover-fase.md +31 -31
  93. package/kit/commands/remover-workspace.md +26 -26
  94. package/kit/commands/resumo-marco.md +50 -50
  95. package/kit/commands/retomar-trabalho.md +40 -40
  96. package/kit/commands/revisar-backlog.md +60 -60
  97. package/kit/commands/revisar-ui.md +32 -32
  98. package/kit/commands/revisar.md +37 -37
  99. package/kit/commands/saude.md +21 -21
  100. package/kit/commands/setup-notion.md +93 -93
  101. package/kit/commands/supabase.md +55 -8
  102. package/kit/commands/sync-main.md +68 -68
  103. package/kit/commands/validar-fase.md +35 -35
  104. package/kit/commands/verificar-tarefas.md +44 -44
  105. package/kit/commands/verificar-trabalho.md +64 -64
  106. package/kit/file-manifest.json +52 -32
  107. package/kit/framework/bin/lib/commands.cjs +959 -959
  108. package/kit/framework/bin/lib/config.cjs +442 -442
  109. package/kit/framework/bin/lib/core.cjs +1230 -1230
  110. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  111. package/kit/framework/bin/lib/init.cjs +1442 -1442
  112. package/kit/framework/bin/lib/milestone.cjs +252 -252
  113. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  114. package/kit/framework/bin/lib/phase.cjs +888 -888
  115. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  116. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  117. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  118. package/kit/framework/bin/lib/security.cjs +382 -382
  119. package/kit/framework/bin/lib/state.cjs +1031 -1031
  120. package/kit/framework/bin/lib/template.cjs +222 -222
  121. package/kit/framework/bin/lib/uat.cjs +282 -282
  122. package/kit/framework/bin/lib/verify.cjs +888 -888
  123. package/kit/framework/bin/lib/workstream.cjs +491 -491
  124. package/kit/framework/bin/tools.cjs +918 -918
  125. package/kit/framework/commands/workstreams.md +63 -63
  126. package/kit/framework/references/checkpoints.md +778 -778
  127. package/kit/framework/references/continuation-format.md +249 -249
  128. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  129. package/kit/framework/references/git-integration.md +295 -295
  130. package/kit/framework/references/git-planning-commit.md +38 -38
  131. package/kit/framework/references/model-profile-resolution.md +36 -36
  132. package/kit/framework/references/model-profiles.md +139 -139
  133. package/kit/framework/references/phase-argument-parsing.md +61 -61
  134. package/kit/framework/references/planning-config.md +202 -202
  135. package/kit/framework/references/questioning.md +162 -162
  136. package/kit/framework/references/tdd.md +263 -263
  137. package/kit/framework/references/ui-brand.md +160 -160
  138. package/kit/framework/references/user-profiling.md +657 -657
  139. package/kit/framework/references/verification-patterns.md +612 -612
  140. package/kit/framework/references/workstream-flag.md +58 -58
  141. package/kit/framework/templates/DEBUG.md +164 -164
  142. package/kit/framework/templates/UAT.md +265 -265
  143. package/kit/framework/templates/UI-SPEC.md +100 -100
  144. package/kit/framework/templates/VALIDATION.md +76 -76
  145. package/kit/framework/templates/claude-md.md +122 -122
  146. package/kit/framework/templates/codebase/architecture.md +185 -185
  147. package/kit/framework/templates/codebase/concerns.md +205 -205
  148. package/kit/framework/templates/codebase/conventions.md +204 -204
  149. package/kit/framework/templates/codebase/integrations.md +192 -192
  150. package/kit/framework/templates/codebase/stack.md +158 -158
  151. package/kit/framework/templates/codebase/structure.md +199 -199
  152. package/kit/framework/templates/codebase/testing.md +301 -301
  153. package/kit/framework/templates/config.json +44 -44
  154. package/kit/framework/templates/context.md +352 -352
  155. package/kit/framework/templates/continue-here.md +78 -78
  156. package/kit/framework/templates/copilot-instructions.md +7 -7
  157. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  158. package/kit/framework/templates/dev-preferences.md +20 -20
  159. package/kit/framework/templates/discovery.md +146 -146
  160. package/kit/framework/templates/discussion-log.md +63 -63
  161. package/kit/framework/templates/milestone-archive.md +123 -123
  162. package/kit/framework/templates/milestone.md +115 -115
  163. package/kit/framework/templates/phase-prompt.md +610 -610
  164. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  165. package/kit/framework/templates/project.md +186 -186
  166. package/kit/framework/templates/requirements.md +231 -231
  167. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  168. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  169. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  170. package/kit/framework/templates/research-project/STACK.md +120 -120
  171. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  172. package/kit/framework/templates/research.md +419 -419
  173. package/kit/framework/templates/retrospective.md +54 -54
  174. package/kit/framework/templates/roadmap.md +202 -202
  175. package/kit/framework/templates/state.md +176 -176
  176. package/kit/framework/templates/summary-complex.md +59 -59
  177. package/kit/framework/templates/summary-minimal.md +41 -41
  178. package/kit/framework/templates/summary-standard.md +48 -48
  179. package/kit/framework/templates/summary.md +209 -209
  180. package/kit/framework/templates/user-profile.md +146 -146
  181. package/kit/framework/templates/user-setup.md +256 -256
  182. package/kit/framework/templates/verification-report.md +258 -258
  183. package/kit/framework/workflows/add-phase.md +112 -112
  184. package/kit/framework/workflows/add-tests.md +351 -351
  185. package/kit/framework/workflows/add-todo.md +158 -158
  186. package/kit/framework/workflows/audit-milestone.md +340 -340
  187. package/kit/framework/workflows/audit-uat.md +109 -109
  188. package/kit/framework/workflows/autonomous.md +891 -891
  189. package/kit/framework/workflows/check-todos.md +177 -177
  190. package/kit/framework/workflows/cleanup.md +152 -152
  191. package/kit/framework/workflows/complete-milestone.md +696 -696
  192. package/kit/framework/workflows/diagnose-issues.md +231 -231
  193. package/kit/framework/workflows/discovery-phase.md +289 -289
  194. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  195. package/kit/framework/workflows/discuss-phase.md +784 -784
  196. package/kit/framework/workflows/do.md +104 -104
  197. package/kit/framework/workflows/execute-phase.md +838 -838
  198. package/kit/framework/workflows/execute-plan.md +510 -510
  199. package/kit/framework/workflows/fast.md +102 -102
  200. package/kit/framework/workflows/forensics.md +265 -265
  201. package/kit/framework/workflows/health.md +181 -181
  202. package/kit/framework/workflows/help.md +619 -619
  203. package/kit/framework/workflows/insert-phase.md +130 -130
  204. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  205. package/kit/framework/workflows/list-workspaces.md +56 -56
  206. package/kit/framework/workflows/manager.md +362 -362
  207. package/kit/framework/workflows/map-codebase.md +377 -377
  208. package/kit/framework/workflows/milestone-summary.md +223 -223
  209. package/kit/framework/workflows/new-milestone.md +486 -486
  210. package/kit/framework/workflows/new-project.md +1159 -1159
  211. package/kit/framework/workflows/new-workspace.md +237 -237
  212. package/kit/framework/workflows/next.md +97 -97
  213. package/kit/framework/workflows/node-repair.md +92 -92
  214. package/kit/framework/workflows/note.md +156 -156
  215. package/kit/framework/workflows/pause-work.md +176 -176
  216. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  217. package/kit/framework/workflows/plan-phase.md +765 -765
  218. package/kit/framework/workflows/plant-seed.md +169 -169
  219. package/kit/framework/workflows/pr-branch.md +129 -129
  220. package/kit/framework/workflows/profile-user.md +450 -450
  221. package/kit/framework/workflows/progress.md +507 -507
  222. package/kit/framework/workflows/quick.md +757 -757
  223. package/kit/framework/workflows/remove-phase.md +155 -155
  224. package/kit/framework/workflows/remove-workspace.md +90 -90
  225. package/kit/framework/workflows/research-phase.md +82 -82
  226. package/kit/framework/workflows/resume-project.md +326 -326
  227. package/kit/framework/workflows/review.md +228 -228
  228. package/kit/framework/workflows/session-report.md +146 -146
  229. package/kit/framework/workflows/settings.md +283 -283
  230. package/kit/framework/workflows/ship.md +228 -228
  231. package/kit/framework/workflows/stats.md +60 -60
  232. package/kit/framework/workflows/transition.md +671 -671
  233. package/kit/framework/workflows/ui-phase.md +302 -302
  234. package/kit/framework/workflows/ui-review.md +165 -165
  235. package/kit/framework/workflows/update.md +323 -323
  236. package/kit/framework/workflows/validate-phase.md +174 -174
  237. package/kit/framework/workflows/verify-phase.md +252 -252
  238. package/kit/framework/workflows/verify-work.md +637 -637
  239. package/kit/hooks/check-update.js +118 -118
  240. package/kit/hooks/context-monitor.js +163 -163
  241. package/kit/hooks/prompt-guard.js +103 -103
  242. package/kit/hooks/statusline.js +125 -125
  243. package/kit/hooks/workflow-guard.js +101 -101
  244. package/kit/settings.json +45 -45
  245. package/kit/skills/_shared-dados-distribuidos/glossary.md +224 -0
  246. package/kit/skills/_shared-supabase/glossary.md +27 -0
  247. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -0
  248. package/kit/skills/audit-log-multi-tenant/SKILL.md +6 -0
  249. package/kit/skills/cascading-failures/SKILL.md +4 -0
  250. package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -0
  251. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +17 -0
  252. package/kit/skills/escolha-modelo-consistencia/SKILL.md +495 -0
  253. package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -0
  254. package/kit/skills/example-skill/SKILL.md +42 -42
  255. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +4 -0
  256. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +4 -0
  257. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -0
  258. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +37 -0
  259. package/kit/skills/streams-eventos-cdc/SKILL.md +712 -0
  260. package/kit/skills/supabase-column-level-security/SKILL.md +426 -0
  261. package/kit/skills/supabase-cron-queues/SKILL.md +9 -0
  262. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -0
  263. package/kit/skills/supabase-database-functions/SKILL.md +85 -0
  264. package/kit/skills/supabase-migrations/SKILL.md +133 -11
  265. package/kit/skills/supabase-postgres-roles/SKILL.md +392 -0
  266. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -0
  267. package/kit/skills/supabase-rls-policies/SKILL.md +462 -12
  268. package/kit/skills/super-admin-platform-pattern/SKILL.md +4 -0
  269. package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -0
  270. package/package.json +63 -63
  271. package/src/core/kit.js +216 -216
  272. package/src/core/reflect.js +247 -247
  273. package/src/core/reverse-sync.js +372 -372
  274. package/src/core/sync.js +418 -418
  275. package/src/core/watch.js +121 -121
@@ -1,180 +1,180 @@
1
- ---
2
- name: auditar-marco
3
- description: Audita a conclusão do milestone contra a intenção original antes de arquivar
4
- argument-hint: "[version]"
5
- allowed-tools:
6
- - Read
7
- - Glob
8
- - Grep
9
- - Bash
10
- - Task
11
- - Write
12
- ---
13
- <objective>
14
- 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.
15
-
16
- **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.
17
- </objective>
18
-
19
- <execution_context>
20
- @./.claude/framework/workflows/audit-milestone.md
21
- </execution_context>
22
-
23
- <context>
24
- Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
25
-
26
- Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
27
-
28
- **Trabalho Concluído:**
29
- Glob: .planning/phases/*/*-SUMMARY.md
30
- Glob: .planning/phases/*/*-VERIFICATION.md
31
- </context>
32
-
33
- <process>
34
- Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
35
- Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
36
- </process>
37
-
38
- <observability_integration>
39
- **OMM scoring (v1.9 — INT-FW-04):**
40
-
41
- Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
42
-
43
- ```text
44
- Skill(skill="framework:auditar-observabilidade")
45
- ```
46
-
47
- 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.
48
-
49
- Resultado de regression OMM:
50
- - **0 regressions:** audit aprovado
51
- - **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
52
- - **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
53
-
54
- Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
55
-
56
- **REQ:** INT-FW-04.
57
- </observability_integration>
58
-
59
- <sre_integration>
60
- **Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
61
-
62
- 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):
63
-
64
- ```text
65
- Skill(skill="framework:auditar-toil")
66
- ```
67
-
68
- 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**.
69
-
70
- **Loop fechado canônico:**
71
-
72
- ```text
73
- /auditar-marco
74
-
75
- Step A: invoca /auditar-toil ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
76
-
77
- Step B: invoca /auditar-observabilidade ← OMM scoring v1.9 (INT-FW-04)
78
-
79
- omm-auditor consulta .planning/TOIL-AUDIT.md ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
80
-
81
- OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
82
-
83
- MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
84
- ```
85
-
86
- **Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
87
-
88
- O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
89
-
90
- > "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
91
-
92
- 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.
93
-
94
- **Tabela de score Capacidade 3 (consumida por omm-auditor):**
95
-
96
- | % toil pelo time | OMM Capacidade 3 score | Implicação |
97
- |---|---|---|
98
- | < 15% | 5 | Excelente — automação madura |
99
- | 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
100
- | 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
101
- | 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
102
- | > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
103
-
104
- Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
105
-
106
- **Output esperado:**
107
-
108
- `.planning/TOIL-AUDIT.md` contém:
109
-
110
- 1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
111
- 2. Lista de candidatos a automação P0/P1/P2 com:
112
- - Comando/processo manual identificado
113
- - Frequência (× por sprint/mês)
114
- - Esforço estimado de automação (S/M/L)
115
- - ROI = Frequência × Tempo Manual / Esforço Automação
116
- 3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
117
- 4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
118
-
119
- **Quando desligar gate:**
120
-
121
- - Solo developer side project (toil = você mesmo, audit é overhead)
122
- - Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
123
- - Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
124
-
125
- Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
126
-
127
- **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).
128
-
129
- **Anti-patterns prevenidos:**
130
-
131
- - "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
132
- - "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
133
- - "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
134
- - "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
135
-
136
- **REQ:** INT-FW-V2-03.
137
- </sre_integration>
138
-
139
- <legacy_refactor_integration>
140
- **Legacy refactor safety audit (opt-in):**
141
-
142
- 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:
143
-
144
- ```text
145
- Para cada arquivo modificado por tasks com kind=refactor no milestone:
146
- Task(
147
- subagent_type="refactor-safety-auditor",
148
- prompt="
149
- target_file: <file>
150
- change_kind: refactor
151
- mode: blocking
152
- output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
153
-
154
- Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
155
- "
156
- )
157
- ```
158
-
159
- **Critérios de aprovação:**
160
- - Cada refactor de risco no milestone tem characterization tests linkados E pass verde
161
- - Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
162
- - Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
163
-
164
- **Resultado de regression:**
165
- - 0 refactors sem char → audit aprovado
166
- - 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
167
- - 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
168
-
169
- Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
170
- Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
171
-
172
- **Quando desligar gate:**
173
- - Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
174
- - Solo dev side project sem stakes de produção (audit é overhead)
175
- - Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
176
-
177
- Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
178
-
179
- **REQ:** INT-LEGACY-FW-01.
1
+ ---
2
+ name: auditar-marco
3
+ description: Audita a conclusão do milestone contra a intenção original antes de arquivar
4
+ argument-hint: "[version]"
5
+ allowed-tools:
6
+ - Read
7
+ - Glob
8
+ - Grep
9
+ - Bash
10
+ - Task
11
+ - Write
12
+ ---
13
+ <objective>
14
+ 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.
15
+
16
+ **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.
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @./.claude/framework/workflows/audit-milestone.md
21
+ </execution_context>
22
+
23
+ <context>
24
+ Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
25
+
26
+ Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
27
+
28
+ **Trabalho Concluído:**
29
+ Glob: .planning/phases/*/*-SUMMARY.md
30
+ Glob: .planning/phases/*/*-VERIFICATION.md
31
+ </context>
32
+
33
+ <process>
34
+ Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
35
+ Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
36
+ </process>
37
+
38
+ <observability_integration>
39
+ **OMM scoring (v1.9 — INT-FW-04):**
40
+
41
+ Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
42
+
43
+ ```text
44
+ Skill(skill="framework:auditar-observabilidade")
45
+ ```
46
+
47
+ 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.
48
+
49
+ Resultado de regression OMM:
50
+ - **0 regressions:** audit aprovado
51
+ - **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
52
+ - **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
53
+
54
+ Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
55
+
56
+ **REQ:** INT-FW-04.
57
+ </observability_integration>
58
+
59
+ <sre_integration>
60
+ **Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
61
+
62
+ 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):
63
+
64
+ ```text
65
+ Skill(skill="framework:auditar-toil")
66
+ ```
67
+
68
+ 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**.
69
+
70
+ **Loop fechado canônico:**
71
+
72
+ ```text
73
+ /auditar-marco
74
+
75
+ Step A: invoca /auditar-toil ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
76
+
77
+ Step B: invoca /auditar-observabilidade ← OMM scoring v1.9 (INT-FW-04)
78
+
79
+ omm-auditor consulta .planning/TOIL-AUDIT.md ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
80
+
81
+ OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
82
+
83
+ MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
84
+ ```
85
+
86
+ **Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
87
+
88
+ O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
89
+
90
+ > "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
91
+
92
+ 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.
93
+
94
+ **Tabela de score Capacidade 3 (consumida por omm-auditor):**
95
+
96
+ | % toil pelo time | OMM Capacidade 3 score | Implicação |
97
+ |---|---|---|
98
+ | < 15% | 5 | Excelente — automação madura |
99
+ | 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
100
+ | 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
101
+ | 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
102
+ | > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
103
+
104
+ Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
105
+
106
+ **Output esperado:**
107
+
108
+ `.planning/TOIL-AUDIT.md` contém:
109
+
110
+ 1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
111
+ 2. Lista de candidatos a automação P0/P1/P2 com:
112
+ - Comando/processo manual identificado
113
+ - Frequência (× por sprint/mês)
114
+ - Esforço estimado de automação (S/M/L)
115
+ - ROI = Frequência × Tempo Manual / Esforço Automação
116
+ 3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
117
+ 4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
118
+
119
+ **Quando desligar gate:**
120
+
121
+ - Solo developer side project (toil = você mesmo, audit é overhead)
122
+ - Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
123
+ - Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
124
+
125
+ Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
126
+
127
+ **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).
128
+
129
+ **Anti-patterns prevenidos:**
130
+
131
+ - "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
132
+ - "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
133
+ - "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
134
+ - "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
135
+
136
+ **REQ:** INT-FW-V2-03.
137
+ </sre_integration>
138
+
139
+ <legacy_refactor_integration>
140
+ **Legacy refactor safety audit (opt-in):**
141
+
142
+ 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:
143
+
144
+ ```text
145
+ Para cada arquivo modificado por tasks com kind=refactor no milestone:
146
+ Task(
147
+ subagent_type="refactor-safety-auditor",
148
+ prompt="
149
+ target_file: <file>
150
+ change_kind: refactor
151
+ mode: blocking
152
+ output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
153
+
154
+ Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
155
+ "
156
+ )
157
+ ```
158
+
159
+ **Critérios de aprovação:**
160
+ - Cada refactor de risco no milestone tem characterization tests linkados E pass verde
161
+ - Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
162
+ - Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
163
+
164
+ **Resultado de regression:**
165
+ - 0 refactors sem char → audit aprovado
166
+ - 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
167
+ - 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
168
+
169
+ Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
170
+ Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
171
+
172
+ **Quando desligar gate:**
173
+ - Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
174
+ - Solo dev side project sem stakes de produção (audit é overhead)
175
+ - Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
176
+
177
+ Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
178
+
179
+ **REQ:** INT-LEGACY-FW-01.
180
180
  </legacy_refactor_integration>
@@ -1,24 +1,24 @@
1
- ---
2
- name: auditar-uat
3
- description: Auditoria multi-fase de todos os itens de UAT e verificação pendentes
4
- allowed-tools:
5
- - Read
6
- - Glob
7
- - Grep
8
- - Bash
9
- ---
10
- <objective>
11
- 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.
12
- </objective>
13
-
14
- <execution_context>
15
- @./.claude/framework/workflows/audit-uat.md
16
- </execution_context>
17
-
18
- <context>
19
- Arquivos principais de planejamento são carregados no workflow via CLI.
20
-
21
- **Escopo:**
22
- Glob: .planning/phases/*/*-UAT.md
23
- Glob: .planning/phases/*/*-VERIFICATION.md
1
+ ---
2
+ name: auditar-uat
3
+ description: Auditoria multi-fase de todos os itens de UAT e verificação pendentes
4
+ allowed-tools:
5
+ - Read
6
+ - Glob
7
+ - Grep
8
+ - Bash
9
+ ---
10
+ <objective>
11
+ 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.
12
+ </objective>
13
+
14
+ <execution_context>
15
+ @./.claude/framework/workflows/audit-uat.md
16
+ </execution_context>
17
+
18
+ <context>
19
+ Arquivos principais de planejamento são carregados no workflow via CLI.
20
+
21
+ **Escopo:**
22
+ Glob: .planning/phases/*/*-UAT.md
23
+ Glob: .planning/phases/*/*-VERIFICATION.md
24
24
  </context>
@@ -1,41 +1,41 @@
1
- ---
2
- name: autonomo
3
- description: Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase
4
- argument-hint: "[--from N]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - AskUserQuestion
12
- - Task
13
- ---
14
- <objective>
15
- 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).
16
-
17
- 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.
18
-
19
- **Cria/Atualiza:**
20
- - `.planning/STATE.md` — atualizado após cada fase
21
- - `.planning/ROADMAP.md` — progresso atualizado após cada fase
22
- - Artefatos de fase — CONTEXT.md, PLANOs, SUMMARYs por fase
23
-
24
- **Após:** O milestone está completo e limpo.
25
- </objective>
26
-
27
- <execution_context>
28
- @./.claude/framework/workflows/autonomous.md
29
- @./.claude/framework/references/ui-brand.md
30
- </execution_context>
31
-
32
- <context>
33
- Flag opcional: `--from N` — começar da fase N em vez da primeira fase incompleta.
34
-
35
- 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.
36
- </context>
37
-
38
- <process>
39
- Execute o workflow autonomous de @./.claude/framework/workflows/autonomous.md do início ao fim.
40
- Preserve todos os checkpoints do workflow (descoberta de fases, execução por fase, tratamento de bloqueadores, exibição de progresso).
1
+ ---
2
+ name: autonomo
3
+ description: Executa todas as fases restantes de forma autônoma — discutir→planejar→executar por fase
4
+ argument-hint: "[--from N]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - AskUserQuestion
12
+ - Task
13
+ ---
14
+ <objective>
15
+ 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).
16
+
17
+ 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.
18
+
19
+ **Cria/Atualiza:**
20
+ - `.planning/STATE.md` — atualizado após cada fase
21
+ - `.planning/ROADMAP.md` — progresso atualizado após cada fase
22
+ - Artefatos de fase — CONTEXT.md, PLANOs, SUMMARYs por fase
23
+
24
+ **Após:** O milestone está completo e limpo.
25
+ </objective>
26
+
27
+ <execution_context>
28
+ @./.claude/framework/workflows/autonomous.md
29
+ @./.claude/framework/references/ui-brand.md
30
+ </execution_context>
31
+
32
+ <context>
33
+ Flag opcional: `--from N` — começar da fase N em vez da primeira fase incompleta.
34
+
35
+ 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.
36
+ </context>
37
+
38
+ <process>
39
+ Execute o workflow autonomous de @./.claude/framework/workflows/autonomous.md do início ao fim.
40
+ Preserve todos os checkpoints do workflow (descoberta de fases, execução por fase, tratamento de bloqueadores, exibição de progresso).
41
41
  </process>
@@ -1,25 +1,25 @@
1
- ---
2
- name: branch-pr
3
- description: Cria um branch limpo para PR filtrando commits de .planning/ — pronto para revisão de código
4
- argument-hint: "[branch destino, padrão: main]"
5
- allowed-tools:
6
- - Bash
7
- - Read
8
- - AskUserQuestion
9
- ---
10
-
11
- <objective>
12
- Criar um branch limpo adequado para pull requests filtrando commits de .planning/
13
- do branch atual. Revisores veem apenas mudanças de código, não artefatos de planejamento framework.
14
-
15
- Isso resolve o problema de diffs de PR poluídos com mudanças de PLAN.md, SUMMARY.md, STATE.md
16
- que são irrelevantes para revisão de código.
17
- </objective>
18
-
19
- <execution_context>
20
- @./.claude/framework/workflows/pr-branch.md
21
- </execution_context>
22
-
23
- <process>
24
- Execute o workflow pr-branch de @./.claude/framework/workflows/pr-branch.md do início ao fim.
1
+ ---
2
+ name: branch-pr
3
+ description: Cria um branch limpo para PR filtrando commits de .planning/ — pronto para revisão de código
4
+ argument-hint: "[branch destino, padrão: main]"
5
+ allowed-tools:
6
+ - Bash
7
+ - Read
8
+ - AskUserQuestion
9
+ ---
10
+
11
+ <objective>
12
+ Criar um branch limpo adequado para pull requests filtrando commits de .planning/
13
+ do branch atual. Revisores veem apenas mudanças de código, não artefatos de planejamento framework.
14
+
15
+ Isso resolve o problema de diffs de PR poluídos com mudanças de PLAN.md, SUMMARY.md, STATE.md
16
+ que são irrelevantes para revisão de código.
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @./.claude/framework/workflows/pr-branch.md
21
+ </execution_context>
22
+
23
+ <process>
24
+ Execute o workflow pr-branch de @./.claude/framework/workflows/pr-branch.md do início ao fim.
25
25
  </process>