@luanpdd/kit-mcp 1.33.0 → 1.34.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 (376) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +168 -168
  3. package/gates/agent-no-recursive-dispatch.md +84 -84
  4. package/kit/COMANDOS.md +138 -138
  5. package/kit/COMPATIBILITY.md +70 -70
  6. package/kit/README.md +76 -76
  7. package/kit/agents/advisor-researcher.md +109 -109
  8. package/kit/agents/ai-mutation-tester.md +289 -289
  9. package/kit/agents/assumptions-analyzer.md +110 -110
  10. package/kit/agents/audit-log-implementer.md +314 -314
  11. package/kit/agents/auditor-consistencia-isolamento.md +414 -414
  12. package/kit/agents/b2b-saas-architect.md +157 -157
  13. package/kit/agents/burn-rate-forecaster.md +153 -153
  14. package/kit/agents/cascading-failures-auditor.md +299 -299
  15. package/kit/agents/codebase-mapper.md +769 -769
  16. package/kit/agents/crm-pipeline-implementer.md +257 -257
  17. package/kit/agents/debugger.md +814 -814
  18. package/kit/agents/designer-ui.md +216 -216
  19. package/kit/agents/detector-tenant-quente.md +338 -338
  20. package/kit/agents/evolution-go-integrator.md +201 -201
  21. package/kit/agents/example-reviewer.md +22 -22
  22. package/kit/agents/executor.md +565 -565
  23. package/kit/agents/golden-signals-instrumenter.md +232 -232
  24. package/kit/agents/incident-investigator.md +238 -238
  25. package/kit/agents/integration-checker.md +203 -203
  26. package/kit/agents/invite-flow-implementer.md +190 -190
  27. package/kit/agents/legacy-characterizer.md +369 -369
  28. package/kit/agents/lgpd-compliance-auditor.md +296 -296
  29. package/kit/agents/load-shedding-instrumenter.md +290 -290
  30. package/kit/agents/multi-tenant-isolation-auditor.md +254 -254
  31. package/kit/agents/multi-tenant-rls-writer.md +341 -341
  32. package/kit/agents/nyquist-auditor.md +181 -181
  33. package/kit/agents/observability-coverage-auditor.md +316 -316
  34. package/kit/agents/observability-instrumenter.md +191 -191
  35. package/kit/agents/omm-auditor.md +291 -291
  36. package/kit/agents/org-onboarding-implementer.md +224 -224
  37. package/kit/agents/payload-capture-instrumenter.md +274 -274
  38. package/kit/agents/phase-researcher.md +697 -697
  39. package/kit/agents/plan-checker.md +275 -275
  40. package/kit/agents/planner.md +923 -923
  41. package/kit/agents/postmortem-writer.md +273 -273
  42. package/kit/agents/project-researcher.md +653 -653
  43. package/kit/agents/prr-conductor.md +287 -287
  44. package/kit/agents/refactor-safety-auditor.md +405 -405
  45. package/kit/agents/release-pipeline-auditor.md +364 -364
  46. package/kit/agents/research-synthesizer.md +246 -246
  47. package/kit/agents/roadmapper.md +678 -678
  48. package/kit/agents/schema-checker.md +160 -160
  49. package/kit/agents/seam-finder.md +360 -360
  50. package/kit/agents/shotgun-surgery-detector.md +350 -350
  51. package/kit/agents/slo-engineer.md +217 -217
  52. package/kit/agents/storytelling-analyst.md +300 -300
  53. package/kit/agents/supabase-architect.md +249 -249
  54. package/kit/agents/supabase-auth-bootstrapper.md +400 -400
  55. package/kit/agents/supabase-auth-hook-writer.md +418 -418
  56. package/kit/agents/supabase-branching-architect.md +563 -563
  57. package/kit/agents/supabase-cicd-pipeline-implementer.md +778 -778
  58. package/kit/agents/supabase-column-privileges-writer.md +400 -400
  59. package/kit/agents/supabase-edge-fn-tester.md +288 -288
  60. package/kit/agents/supabase-edge-fn-writer.md +341 -341
  61. package/kit/agents/supabase-mfa-implementer.md +439 -439
  62. package/kit/agents/supabase-migration-writer.md +386 -386
  63. package/kit/agents/supabase-oauth-server-implementer.md +507 -507
  64. package/kit/agents/supabase-rbac-implementer.md +393 -393
  65. package/kit/agents/supabase-realtime-implementer.md +364 -364
  66. package/kit/agents/supabase-rls-hardener.md +522 -522
  67. package/kit/agents/supabase-rls-writer.md +324 -324
  68. package/kit/agents/supabase-roles-implementer.md +356 -356
  69. package/kit/agents/supabase-social-auth-implementer.md +451 -451
  70. package/kit/agents/supabase-sso-saml-architect.md +549 -549
  71. package/kit/agents/supabase-storage-implementer.md +407 -407
  72. package/kit/agents/super-admin-implementer.md +282 -282
  73. package/kit/agents/toil-auditor.md +268 -268
  74. package/kit/agents/ui-auditor.md +438 -438
  75. package/kit/agents/ui-checker.md +305 -305
  76. package/kit/agents/ui-researcher.md +356 -356
  77. package/kit/agents/user-profiler.md +176 -176
  78. package/kit/agents/validador-evolucao-schema.md +336 -336
  79. package/kit/agents/verifier.md +729 -729
  80. package/kit/commands/adicionar-backlog.md +75 -75
  81. package/kit/commands/adicionar-fase.md +42 -42
  82. package/kit/commands/adicionar-tarefa.md +45 -45
  83. package/kit/commands/adicionar-testes.md +41 -41
  84. package/kit/commands/ajuda.md +21 -21
  85. package/kit/commands/atualizar.md +37 -37
  86. package/kit/commands/auditar-cascading.md +111 -111
  87. package/kit/commands/auditar-marco.md +179 -179
  88. package/kit/commands/auditar-observabilidade-cobertura-workflow.md +121 -0
  89. package/kit/commands/auditar-observabilidade-cobertura.md +183 -183
  90. package/kit/commands/auditar-refactor.md +219 -219
  91. package/kit/commands/auditar-release.md +109 -109
  92. package/kit/commands/auditar-uat.md +23 -23
  93. package/kit/commands/autonomo.md +40 -40
  94. package/kit/commands/branch-pr.md +24 -24
  95. package/kit/commands/burn-rate-status.md +408 -408
  96. package/kit/commands/capturar-payloads.md +193 -193
  97. package/kit/commands/caracterizar.md +212 -212
  98. package/kit/commands/concluir-marco.md +247 -247
  99. package/kit/commands/configuracoes.md +36 -36
  100. package/kit/commands/dados-distribuidos.md +188 -188
  101. package/kit/commands/definir-perfil.md +10 -10
  102. package/kit/commands/depurar.md +190 -190
  103. package/kit/commands/detectar-duplicacao.md +197 -197
  104. package/kit/commands/discutir-fase.md +131 -131
  105. package/kit/commands/encontrar-seams.md +136 -136
  106. package/kit/commands/entrar-discord.md +17 -17
  107. package/kit/commands/estatisticas.md +18 -18
  108. package/kit/commands/example-greeting.md +33 -33
  109. package/kit/commands/executar-fase.md +58 -58
  110. package/kit/commands/expresso.md +56 -56
  111. package/kit/commands/fase-ui.md +34 -34
  112. package/kit/commands/fazer.md +57 -57
  113. package/kit/commands/fio.md +125 -125
  114. package/kit/commands/fluxos-trabalho.md +64 -64
  115. package/kit/commands/forense.md +176 -176
  116. package/kit/commands/gerenciador.md +38 -38
  117. package/kit/commands/inserir-fase.md +31 -31
  118. package/kit/commands/legacy.md +263 -263
  119. package/kit/commands/limpeza.md +17 -17
  120. package/kit/commands/listar-hipoteses-fase.md +45 -45
  121. package/kit/commands/listar-workspaces.md +18 -18
  122. package/kit/commands/load-shedding.md +117 -117
  123. package/kit/commands/mapear-codebase.md +70 -70
  124. package/kit/commands/multi-tenant.md +163 -163
  125. package/kit/commands/nota.md +33 -33
  126. package/kit/commands/novo-marco.md +43 -43
  127. package/kit/commands/novo-projeto.md +41 -41
  128. package/kit/commands/novo-workspace.md +43 -43
  129. package/kit/commands/pausar-trabalho.md +37 -37
  130. package/kit/commands/perfil-usuario.md +45 -45
  131. package/kit/commands/pesquisar-fase.md +195 -195
  132. package/kit/commands/planejar-fase.md +67 -67
  133. package/kit/commands/planejar-lacunas.md +33 -33
  134. package/kit/commands/plantar-ideia.md +25 -25
  135. package/kit/commands/progresso.md +24 -24
  136. package/kit/commands/proximo.md +30 -30
  137. package/kit/commands/publicar.md +490 -490
  138. package/kit/commands/rapido.md +35 -35
  139. package/kit/commands/reaplicar-patches.md +124 -124
  140. package/kit/commands/refactor-seguro.md +321 -321
  141. package/kit/commands/relatorio-sessao.md +19 -19
  142. package/kit/commands/remover-fase.md +31 -31
  143. package/kit/commands/remover-workspace.md +26 -26
  144. package/kit/commands/resumo-marco.md +50 -50
  145. package/kit/commands/retomar-trabalho.md +40 -40
  146. package/kit/commands/revisar-backlog.md +60 -60
  147. package/kit/commands/revisar-ui.md +32 -32
  148. package/kit/commands/revisar.md +37 -37
  149. package/kit/commands/saude.md +21 -21
  150. package/kit/commands/setup-notion.md +93 -93
  151. package/kit/commands/storytelling.md +179 -179
  152. package/kit/commands/supabase.md +238 -238
  153. package/kit/commands/sync-main.md +68 -68
  154. package/kit/commands/validar-fase.md +35 -35
  155. package/kit/commands/verificar-tarefas.md +44 -44
  156. package/kit/commands/verificar-trabalho.md +64 -64
  157. package/kit/file-manifest.json +13 -11
  158. package/kit/framework/bin/lib/commands.cjs +959 -959
  159. package/kit/framework/bin/lib/config.cjs +442 -442
  160. package/kit/framework/bin/lib/core.cjs +1230 -1230
  161. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  162. package/kit/framework/bin/lib/init.cjs +1442 -1442
  163. package/kit/framework/bin/lib/milestone.cjs +252 -252
  164. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  165. package/kit/framework/bin/lib/phase.cjs +888 -888
  166. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  167. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  168. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  169. package/kit/framework/bin/lib/security.cjs +382 -382
  170. package/kit/framework/bin/lib/state.cjs +1031 -1031
  171. package/kit/framework/bin/lib/template.cjs +222 -222
  172. package/kit/framework/bin/lib/uat.cjs +282 -282
  173. package/kit/framework/bin/lib/verify.cjs +888 -888
  174. package/kit/framework/bin/lib/workstream.cjs +491 -491
  175. package/kit/framework/bin/tools.cjs +918 -918
  176. package/kit/framework/commands/workstreams.md +63 -63
  177. package/kit/framework/references/checkpoints.md +778 -778
  178. package/kit/framework/references/continuation-format.md +249 -249
  179. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  180. package/kit/framework/references/git-integration.md +295 -295
  181. package/kit/framework/references/git-planning-commit.md +38 -38
  182. package/kit/framework/references/model-profile-resolution.md +36 -36
  183. package/kit/framework/references/model-profiles.md +139 -139
  184. package/kit/framework/references/phase-argument-parsing.md +61 -61
  185. package/kit/framework/references/planning-config.md +202 -202
  186. package/kit/framework/references/questioning.md +162 -162
  187. package/kit/framework/references/tdd.md +263 -263
  188. package/kit/framework/references/ui-brand.md +160 -160
  189. package/kit/framework/references/user-profiling.md +657 -657
  190. package/kit/framework/references/verification-patterns.md +612 -612
  191. package/kit/framework/references/workstream-flag.md +58 -58
  192. package/kit/framework/templates/DEBUG.md +164 -164
  193. package/kit/framework/templates/UAT.md +265 -265
  194. package/kit/framework/templates/UI-SPEC.md +100 -100
  195. package/kit/framework/templates/VALIDATION.md +76 -76
  196. package/kit/framework/templates/claude-md.md +122 -122
  197. package/kit/framework/templates/codebase/architecture.md +185 -185
  198. package/kit/framework/templates/codebase/concerns.md +205 -205
  199. package/kit/framework/templates/codebase/conventions.md +204 -204
  200. package/kit/framework/templates/codebase/integrations.md +192 -192
  201. package/kit/framework/templates/codebase/stack.md +158 -158
  202. package/kit/framework/templates/codebase/structure.md +199 -199
  203. package/kit/framework/templates/codebase/testing.md +301 -301
  204. package/kit/framework/templates/config.json +44 -44
  205. package/kit/framework/templates/context.md +352 -352
  206. package/kit/framework/templates/continue-here.md +78 -78
  207. package/kit/framework/templates/copilot-instructions.md +7 -7
  208. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  209. package/kit/framework/templates/dev-preferences.md +20 -20
  210. package/kit/framework/templates/discovery.md +146 -146
  211. package/kit/framework/templates/discussion-log.md +63 -63
  212. package/kit/framework/templates/milestone-archive.md +123 -123
  213. package/kit/framework/templates/milestone.md +115 -115
  214. package/kit/framework/templates/phase-prompt.md +610 -610
  215. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  216. package/kit/framework/templates/project.md +186 -186
  217. package/kit/framework/templates/requirements.md +231 -231
  218. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  219. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  220. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  221. package/kit/framework/templates/research-project/STACK.md +120 -120
  222. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  223. package/kit/framework/templates/research.md +419 -419
  224. package/kit/framework/templates/retrospective.md +54 -54
  225. package/kit/framework/templates/roadmap.md +202 -202
  226. package/kit/framework/templates/state.md +176 -176
  227. package/kit/framework/templates/summary-complex.md +59 -59
  228. package/kit/framework/templates/summary-minimal.md +41 -41
  229. package/kit/framework/templates/summary-standard.md +48 -48
  230. package/kit/framework/templates/summary.md +209 -209
  231. package/kit/framework/templates/user-profile.md +146 -146
  232. package/kit/framework/templates/user-setup.md +256 -256
  233. package/kit/framework/templates/verification-report.md +258 -258
  234. package/kit/framework/workflows/add-phase.md +112 -112
  235. package/kit/framework/workflows/add-tests.md +351 -351
  236. package/kit/framework/workflows/add-todo.md +158 -158
  237. package/kit/framework/workflows/audit-milestone.md +340 -340
  238. package/kit/framework/workflows/audit-uat.md +109 -109
  239. package/kit/framework/workflows/autonomous.md +891 -891
  240. package/kit/framework/workflows/check-todos.md +177 -177
  241. package/kit/framework/workflows/cleanup.md +152 -152
  242. package/kit/framework/workflows/complete-milestone.md +696 -696
  243. package/kit/framework/workflows/diagnose-issues.md +231 -231
  244. package/kit/framework/workflows/discovery-phase.md +289 -289
  245. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  246. package/kit/framework/workflows/discuss-phase.md +784 -784
  247. package/kit/framework/workflows/do.md +104 -104
  248. package/kit/framework/workflows/execute-phase.md +838 -838
  249. package/kit/framework/workflows/execute-plan.md +510 -510
  250. package/kit/framework/workflows/fast.md +102 -102
  251. package/kit/framework/workflows/forensics.md +265 -265
  252. package/kit/framework/workflows/health.md +181 -181
  253. package/kit/framework/workflows/help.md +619 -619
  254. package/kit/framework/workflows/insert-phase.md +130 -130
  255. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  256. package/kit/framework/workflows/list-workspaces.md +56 -56
  257. package/kit/framework/workflows/manager.md +362 -362
  258. package/kit/framework/workflows/map-codebase.md +377 -377
  259. package/kit/framework/workflows/milestone-summary.md +223 -223
  260. package/kit/framework/workflows/new-milestone.md +486 -486
  261. package/kit/framework/workflows/new-project.md +1159 -1159
  262. package/kit/framework/workflows/new-workspace.md +237 -237
  263. package/kit/framework/workflows/next.md +97 -97
  264. package/kit/framework/workflows/node-repair.md +92 -92
  265. package/kit/framework/workflows/note.md +156 -156
  266. package/kit/framework/workflows/pause-work.md +176 -176
  267. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  268. package/kit/framework/workflows/plan-phase.md +765 -765
  269. package/kit/framework/workflows/plant-seed.md +169 -169
  270. package/kit/framework/workflows/pr-branch.md +129 -129
  271. package/kit/framework/workflows/profile-user.md +450 -450
  272. package/kit/framework/workflows/progress.md +507 -507
  273. package/kit/framework/workflows/quick.md +757 -757
  274. package/kit/framework/workflows/remove-phase.md +155 -155
  275. package/kit/framework/workflows/remove-workspace.md +90 -90
  276. package/kit/framework/workflows/research-phase.md +82 -82
  277. package/kit/framework/workflows/resume-project.md +326 -326
  278. package/kit/framework/workflows/review.md +228 -228
  279. package/kit/framework/workflows/session-report.md +146 -146
  280. package/kit/framework/workflows/settings.md +283 -283
  281. package/kit/framework/workflows/ship.md +228 -228
  282. package/kit/framework/workflows/stats.md +60 -60
  283. package/kit/framework/workflows/transition.md +671 -671
  284. package/kit/framework/workflows/ui-phase.md +302 -302
  285. package/kit/framework/workflows/ui-review.md +165 -165
  286. package/kit/framework/workflows/update.md +323 -323
  287. package/kit/framework/workflows/validate-phase.md +174 -174
  288. package/kit/framework/workflows/verify-phase.md +252 -252
  289. package/kit/framework/workflows/verify-work.md +637 -637
  290. package/kit/hooks/check-update.js +118 -118
  291. package/kit/hooks/context-monitor.js +163 -163
  292. package/kit/hooks/kit-attribution-reminder.cjs +92 -92
  293. package/kit/hooks/kit-router.cjs +137 -137
  294. package/kit/hooks/prompt-guard.js +103 -103
  295. package/kit/hooks/statusline.js +125 -125
  296. package/kit/hooks/workflow-guard.js +101 -101
  297. package/kit/settings.json +45 -45
  298. package/kit/skills/ai-prompt-characterization/SKILL.md +335 -335
  299. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -447
  300. package/kit/skills/audit-log-multi-tenant/SKILL.md +340 -340
  301. package/kit/skills/b2b-saas-architecture/SKILL.md +300 -300
  302. package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -385
  303. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +343 -343
  304. package/kit/skills/escolha-modelo-consistencia/SKILL.md +494 -494
  305. package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -448
  306. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +322 -322
  307. package/kit/skills/example-skill/SKILL.md +42 -42
  308. package/kit/skills/legacy-api-only-applications/SKILL.md +358 -358
  309. package/kit/skills/legacy-characterization-tests/SKILL.md +330 -330
  310. package/kit/skills/legacy-effect-analysis/SKILL.md +331 -331
  311. package/kit/skills/legacy-extract-class/SKILL.md +203 -203
  312. package/kit/skills/legacy-programming-by-difference/SKILL.md +252 -252
  313. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +460 -460
  314. package/kit/skills/legacy-shotgun-surgery/SKILL.md +286 -286
  315. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +434 -434
  316. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +270 -270
  317. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +340 -340
  318. package/kit/skills/member-invite-flow/SKILL.md +305 -305
  319. package/kit/skills/member-management-react-shadcn/SKILL.md +328 -328
  320. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +316 -316
  321. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +342 -342
  322. package/kit/skills/org-onboarding-flow/SKILL.md +257 -257
  323. package/kit/skills/org-switcher-react-pattern/SKILL.md +349 -349
  324. package/kit/skills/permission-gate-react-pattern/SKILL.md +271 -271
  325. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -552
  326. package/kit/skills/pre-refactor-characterization/SKILL.md +421 -421
  327. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +338 -338
  328. package/kit/skills/streams-eventos-cdc/SKILL.md +711 -711
  329. package/kit/skills/supabase-auth-hardening/SKILL.md +674 -674
  330. package/kit/skills/supabase-auth-hooks/SKILL.md +875 -875
  331. package/kit/skills/supabase-auth-methods/SKILL.md +486 -486
  332. package/kit/skills/supabase-auth-sessions/SKILL.md +579 -579
  333. package/kit/skills/supabase-auth-ssr/SKILL.md +306 -306
  334. package/kit/skills/supabase-branching-workflow/SKILL.md +544 -544
  335. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -880
  336. package/kit/skills/supabase-column-level-security/SKILL.md +426 -426
  337. package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -807
  338. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -472
  339. package/kit/skills/supabase-edge-functions/SKILL.md +330 -330
  340. package/kit/skills/supabase-edge-functions-auth/SKILL.md +309 -309
  341. package/kit/skills/supabase-edge-functions-limits/SKILL.md +302 -302
  342. package/kit/skills/supabase-edge-functions-mcp-server/SKILL.md +279 -279
  343. package/kit/skills/supabase-edge-functions-testing/SKILL.md +277 -277
  344. package/kit/skills/supabase-edge-runtime-builtins/SKILL.md +357 -357
  345. package/kit/skills/supabase-enterprise-sso-saml/SKILL.md +545 -545
  346. package/kit/skills/supabase-jwt-signing-keys/SKILL.md +399 -399
  347. package/kit/skills/supabase-mfa/SKILL.md +488 -488
  348. package/kit/skills/supabase-migration-repair/SKILL.md +823 -823
  349. package/kit/skills/supabase-migrations/SKILL.md +297 -297
  350. package/kit/skills/supabase-oauth-server/SKILL.md +537 -537
  351. package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -1053
  352. package/kit/skills/supabase-postgres-roles/SKILL.md +392 -392
  353. package/kit/skills/supabase-realtime/SKILL.md +460 -460
  354. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -418
  355. package/kit/skills/supabase-rls-policies/SKILL.md +635 -635
  356. package/kit/skills/supabase-social-oauth/SKILL.md +480 -480
  357. package/kit/skills/supabase-third-party-auth/SKILL.md +450 -450
  358. package/kit/skills/super-admin-platform-pattern/SKILL.md +326 -326
  359. package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -605
  360. package/kit/skills/ui-anti-padroes-ia/SKILL.md +261 -261
  361. package/kit/skills/ui-contexto-produto/SKILL.md +248 -248
  362. package/kit/skills/ui-cor-estrategia/SKILL.md +213 -213
  363. package/kit/skills/ui-critica-auditoria/SKILL.md +260 -260
  364. package/kit/skills/ui-motion-funcional/SKILL.md +264 -264
  365. package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -259
  366. package/kit/skills/ui-tipografia/SKILL.md +211 -211
  367. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +287 -287
  368. package/kit/workflows/auditar-observabilidade-cobertura.workflow.js +250 -0
  369. package/package.json +65 -63
  370. package/src/core/kit.js +333 -216
  371. package/src/core/reflect.js +247 -247
  372. package/src/core/registry.js +123 -112
  373. package/src/core/reverse-sync.js +448 -372
  374. package/src/core/sync.js +477 -437
  375. package/src/core/watch.js +121 -121
  376. package/src/mcp-server/index.js +794 -794
@@ -1,408 +1,408 @@
1
- ---
2
- name: burn-rate-status
3
- description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/.
4
- argument-hint: "[<slo_name>] [--fast-baseline 1h] [--slow-baseline 6h] [--format table|json]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Glob
9
- ---
10
-
11
- <objective>
12
- Snapshot de burn rate **dual-window** (1h fast + 6h slow) para 1 SLO (se especificado) ou TODOS os SLOs definidos em `.planning/slos/*.yml`. Aplica skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — fórmula canônica `burn_rate = error_rate / (1 - target)`, com lookahead/baseline obedecendo o **fator 4×** (page-tier: lookahead 1h ≤ 4× baseline 5m equivalente operacional; ticket-tier: lookahead 6h ≤ 4× baseline 30m). Status combinado segue o canonical Google SRE: PAGE quando ambas as janelas críticas, TICKET quando apenas slow erosion sustained, WARN para spike-only ou mild burn, OK quando ambas as janelas em estado saudável.
13
-
14
- **Lê:** `.planning/slos/*.yml` (definição com `alert_thresholds.page` + `.ticket`) + `.planning/metrics/snapshots/*.json` (eventos persistidos via `metrics.persistSnapshot()` — Phase 99 + Phase 102 auto-snapshot).
15
-
16
- **Cria/Atualiza:** nada — comando read-only.
17
-
18
- **Após:** o user vê tabela com colunas `fast_burn`, `slow_burn`, `combined` (status PAGE / TICKET / WARN / OK) e pode escolher invocar `/investigar-producao` se há burn ativo, ou aguardar mais snapshots se ambas janelas estão `no_data`.
19
- </objective>
20
-
21
- <context>
22
- **Argumentos:** `$ARGUMENTS` — opcional `<slo_name>` para 1 SLO; sem args = todos.
23
-
24
- **Flags (defaults dual-window — Phase 103):**
25
- - `--fast-baseline <duration>` — janela fast (page-tier). Default: `1h`.
26
- - `--slow-baseline <duration>` — janela slow (ticket-tier). Default: `6h`.
27
- - `--format <table|json>` — output format. Default: `table`.
28
-
29
- **Combinações canônicas (skill burn-rate-alerting):**
30
- - **Fast (page-tier):** lookahead 1h, baseline 5m, multiplier 14.4× — esgota ~2% do budget mensal em 1h.
31
- - **Slow (ticket-tier):** lookahead 6h, baseline 30m, multiplier 6× — esgota ~10% do budget mensal em 6h.
32
-
33
- **Fator 4×:** lookahead ≤ 4× baseline para extrapolação confiável (skill rule). 1h ≤ 4× 15m e 6h ≤ 4× 90m são ambos respeitados; defaults operacionais são page (1h baseline) + ticket (6h baseline) — a janela `lookahead` propriamente dita está embutida nos `alert_thresholds.{page,ticket}.lookahead` do YAML do SLO.
34
-
35
- **Phase 99 + 102 wiring:** este comando consome dados persistidos automaticamente pelo handler MCP `metrics-snapshot` (Phase 102 OBS-20-01 — auto-persist via `persistSnapshot()` em cada call com throttle 1s). Sem snapshots na janela, o comando emite "no_data" para o SLO em vez de inventar números.
36
-
37
- **Cross-reference:** este comando é a implementação do pattern "dashboard de burn rate" canônico documentado em [`kit/skills/burn-rate-alerting/SKILL.md`](../skills/burn-rate-alerting/SKILL.md). A skill é a SSOT da fórmula e dos thresholds; este comando é o renderer.
38
- </context>
39
-
40
- <process>
41
-
42
- ## 1. Parsear argumentos
43
-
44
- Bash:
45
- ```bash
46
- SLO_NAME=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
47
- FAST_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--fast-baseline [^ ]+' | awk '{print $2}')
48
- SLOW_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--slow-baseline [^ ]+' | awk '{print $2}')
49
- FORMAT=$(echo "$ARGUMENTS" | grep -oE -- '--format [^ ]+' | awk '{print $2}')
50
-
51
- [ -z "$FAST_BASELINE" ] && FAST_BASELINE="1h"
52
- [ -z "$SLOW_BASELINE" ] && SLOW_BASELINE="6h"
53
- [ -z "$FORMAT" ] && FORMAT="table"
54
- ```
55
-
56
- Convert duration to ms (helper):
57
- ```bash
58
- to_ms() {
59
- local d="$1"
60
- case "$d" in
61
- *h) echo $(( ${d%h} * 3600000 ));;
62
- *m) echo $(( ${d%m} * 60000 ));;
63
- *s) echo $(( ${d%s} * 1000 ));;
64
- *d) echo $(( ${d%d} * 86400000 ));;
65
- *) echo 0 ;;
66
- esac
67
- }
68
- FAST_BASELINE_MS=$(to_ms "$FAST_BASELINE")
69
- SLOW_BASELINE_MS=$(to_ms "$SLOW_BASELINE")
70
- ```
71
-
72
- ## 2. Listar SLOs (FIX Phase 99: extension `.yml`, não `.md`)
73
-
74
- ```bash
75
- if [ -n "$SLO_NAME" ]; then
76
- SLO_FILES=(".planning/slos/${SLO_NAME}.yml")
77
- else
78
- SLO_FILES=(.planning/slos/*.yml)
79
- fi
80
-
81
- # Filtra entradas inexistentes (caso o glob não tenha match).
82
- EXISTING_SLOS=()
83
- for f in "${SLO_FILES[@]}"; do
84
- [ -f "$f" ] && EXISTING_SLOS+=("$f")
85
- done
86
-
87
- if [ ${#EXISTING_SLOS[@]} -eq 0 ]; then
88
- echo "Nenhum SLO definido em .planning/slos/. Rode /definir-slo <feature> primeiro."
89
- exit 0
90
- fi
91
- ```
92
-
93
- ## 3. Para cada SLO, carregar metadata + calcular SLI dual-window
94
-
95
- Para cada `SLO_FILE` em `EXISTING_SLOS`:
96
-
97
- ### 3.1 Extrair campos canônicos do YAML via regex
98
-
99
- Os SLOs do projeto seguem schema fixo (validado por `test/unit/slo-schema.test.js`). Sem `js-yaml` — regex sobre os keys conhecidos:
100
-
101
- ```bash
102
- SLO_NAME=$(grep -oE '^\s+name:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
103
- SERVICE=$(grep -oE '^\s+service:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
104
- SLO_TYPE=$(grep -oE '^\s+type:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
105
-
106
- # Availability SLO: target = ratio decimal (e.g. 0.995)
107
- TARGET_RATIO=$(grep -oE '^target:\s*[0-9.]+' "$SLO_FILE" | awk '{print $2}')
108
- # Latency SLO: target_ms + percentile
109
- TARGET_MS=$(grep -oE '^target_ms:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
110
- PERCENTILE=$(grep -oE '^\s+percentile:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
111
- ```
112
-
113
- ### 3.2 Extrair `alert_thresholds.page` (fast) + `.ticket` (slow) do YAML
114
-
115
- Phase 103 (OBS-20-02) — leitura dos dois blocos via awk com state machine. Cada bloco tem `lookahead`, `baseline`, `burn_rate_multiplier`. Defaults canônicos aplicados se ausentes (defensive default — ver fallback abaixo).
116
-
117
- ```bash
118
- # alert_thresholds.page (fast / page-tier)
119
- FAST_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+lookahead:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
120
- FAST_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+baseline:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
121
- FAST_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+burn_rate_multiplier:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
122
-
123
- # alert_thresholds.ticket (slow / ticket-tier)
124
- SLOW_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+lookahead:/){print $2;exit}}' "$SLO_FILE")
125
- SLOW_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+baseline:/){print $2;exit}}' "$SLO_FILE")
126
- SLOW_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+burn_rate_multiplier:/){print $2;exit}}' "$SLO_FILE")
127
-
128
- # Defensive defaults — fator 4× canonical Google SRE values.
129
- # Se um SLO YAML antigo / parcial não declarar alert_thresholds, aplicamos
130
- # os defaults da skill burn-rate-alerting verbatim:
131
- # page: 14.4× / lookahead 1h / baseline 5m
132
- # ticket: 6× / lookahead 6h / baseline 30m
133
- [ -z "$FAST_MULTIPLIER" ] && FAST_MULTIPLIER="14.4"
134
- [ -z "$SLOW_MULTIPLIER" ] && SLOW_MULTIPLIER="6"
135
- [ -z "$FAST_LOOKAHEAD" ] && FAST_LOOKAHEAD="1h"
136
- [ -z "$SLOW_LOOKAHEAD" ] && SLOW_LOOKAHEAD="6h"
137
- ```
138
-
139
- ### 3.3 Carregar snapshots para AMBAS as janelas
140
-
141
- Use a API `loadSnapshots()` (Phase 99) com duas chamadas — uma para fast (1h), uma para slow (6h). Inline node script:
142
-
143
- ```bash
144
- DUAL_SNAPS=$(node --input-type=module -e "
145
- import { loadSnapshots } from './src/core/metrics.js';
146
- const fast = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
147
- const slow = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
148
- console.log(JSON.stringify({fast, slow, fastCount: fast.length, slowCount: slow.length}));
149
- ")
150
- FAST_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).fastCount)")
151
- SLOW_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).slowCount)")
152
- ```
153
-
154
- **no_data conservative semantics:** se EITHER janela tem < 2 snapshots (availability) ou < 1 (latency), o `combined_status` final é `no_data` — preferimos não inventar números a falsamente reportar OK. Isso preserva o contrato "graceful no_data" da Phase 99.
155
-
156
- ```bash
157
- # A regra exata é aplicada dentro do node script de combinação (3.5),
158
- # mas o early-out aqui evita trabalho desnecessário no caso comum.
159
- if [ "$FAST_COUNT" -lt 2 ] && [ "$SLOW_COUNT" -lt 2 ]; then
160
- echo "SLO $SLO_NAME: insufficient snapshots in BOTH windows (fast=$FAST_COUNT, slow=$SLOW_COUNT)"
161
- echo "Generate data: invocações ao MCP tool 'metrics-snapshot' agora auto-persistem (Phase 102 OBS-20-01)."
162
- COMBINED_STATUS="no_data"
163
- continue
164
- fi
165
- ```
166
-
167
- ### 3.4 Calcular SLI por tipo de SLO (fast E slow independentes)
168
-
169
- **Availability (`type: event-based`):**
170
-
171
- Inline node — primeiro vs último snapshot **dentro de cada janela**. Delta de counters dá good/bad events:
172
-
173
- ```bash
174
- DUAL_SLI=$(node --input-type=module -e "
175
- import { loadSnapshots } from './src/core/metrics.js';
176
- const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
177
- const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
178
-
179
- function sliFromSnaps(snaps) {
180
- if (snaps.length < 2) return {sli: null, errorRate: 0, good: 0, total: 0, error: 'no_data'};
181
- const first = snaps[0];
182
- const last = snaps[snaps.length - 1];
183
- let goodFirst = 0, goodLast = 0, totalFirst = 0, totalLast = 0;
184
- for (const [k,v] of Object.entries(first.counters)) {
185
- if (k.endsWith(':ok')) goodFirst += v;
186
- totalFirst += v;
187
- }
188
- for (const [k,v] of Object.entries(last.counters)) {
189
- if (k.endsWith(':ok')) goodLast += v;
190
- totalLast += v;
191
- }
192
- const good = goodLast - goodFirst;
193
- const total = totalLast - totalFirst;
194
- const sli = total > 0 ? good / total : null;
195
- const errorRate = total > 0 ? (total - good) / total : 0;
196
- return {sli, errorRate, good, total};
197
- }
198
-
199
- const fastSli = sliFromSnaps(fastSnaps);
200
- const slowSli = sliFromSnaps(slowSnaps);
201
- console.log(JSON.stringify({fast: fastSli, slow: slowSli}));
202
- ")
203
- ```
204
-
205
- **Latency (`type: percentile`):**
206
-
207
- Para latency, p95 do último snapshot em CADA janela. SLI = fração de samples NOT acima de target_ms.
208
-
209
- ```bash
210
- DUAL_SLI=$(node --input-type=module -e "
211
- import { loadSnapshots } from './src/core/metrics.js';
212
- const target = $TARGET_MS;
213
- const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
214
- const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
215
-
216
- function latencySli(snaps) {
217
- if (snaps.length < 1) return {sli: null, errorRate: 0, totalSamples: 0, slowSamples: 0, error: 'no_data'};
218
- const last = snaps[snaps.length - 1];
219
- let totalSamples = 0, slowSamples = 0;
220
- for (const lat of Object.values(last.latency)) {
221
- totalSamples += lat.count;
222
- if (lat.p95 > target) slowSamples += Math.round(lat.count * 0.05);
223
- }
224
- const sli = totalSamples > 0 ? 1 - (slowSamples / totalSamples) : null;
225
- const errorRate = totalSamples > 0 ? slowSamples / totalSamples : 0;
226
- return {sli, errorRate, totalSamples, slowSamples};
227
- }
228
-
229
- console.log(JSON.stringify({fast: latencySli(fastSnaps), slow: latencySli(slowSnaps)}));
230
- ")
231
- ```
232
-
233
- ### 3.5 Calcular burn rate + status COMBINADO (dual-window)
234
-
235
- Aplicar fórmula canônica + status enum dual-window (skill `burn-rate-alerting` — fator 4× canonical):
236
-
237
- ```bash
238
- DUAL_STATUS=$(node --input-type=module -e "
239
- const dual = $DUAL_SLI;
240
- const target = $TARGET_RATIO || (1 - 0.05); // latency: 1 - ratio_above_target (5%)
241
- const fastMult = $FAST_MULTIPLIER;
242
- const slowMult = $SLOW_MULTIPLIER;
243
-
244
- function burnFromSli(sli, target) {
245
- if (sli.error) return {burnRate: null, error: sli.error};
246
- const slack = 1 - target;
247
- const burnRate = slack > 0 ? sli.errorRate / slack : 0;
248
- return {burnRate, errorRate: sli.errorRate};
249
- }
250
-
251
- // Combined status — canonical dual-window logic per skill burn-rate-alerting (fator 4×):
252
- // PAGE = ambos críticos (fast ≥ 14.4 E slow ≥ 6) → page on-call AGORA
253
- // TICKET = slow erosion sustained (slow ≥ 6, fast OK) → ticket de investigação
254
- // WARN = fast spike isolado (fast ≥ 14.4 sozinho) — monitor, NÃO page (alarm flap risk)
255
- // WARN = mild burn em qualquer janela (≥ 1.0×) — sustained drains budget no horizonte
256
- // OK = ambos < 1.0× — saudável
257
- // no_data = qualquer janela com snapshots insuficientes (conservative)
258
- function combinedStatus(fastBurn, fastMult, slowBurn, slowMult) {
259
- if (fastBurn === null || slowBurn === null) return 'no_data';
260
- const fastTriggered = fastBurn >= fastMult;
261
- const slowTriggered = slowBurn >= slowMult;
262
- if (fastTriggered && slowTriggered) return 'PAGE';
263
- if (slowTriggered) return 'TICKET';
264
- if (fastTriggered) return 'WARN';
265
- if (fastBurn >= 1.0 || slowBurn >= 1.0) return 'WARN';
266
- return 'OK';
267
- }
268
-
269
- const fastBurn = burnFromSli(dual.fast, target);
270
- const slowBurn = burnFromSli(dual.slow, target);
271
- const combined = combinedStatus(fastBurn.burnRate, fastMult, slowBurn.burnRate, slowMult);
272
-
273
- let action;
274
- switch (combined) {
275
- case 'PAGE':
276
- action = 'Page on-call NOW — invoke /investigar-producao';
277
- break;
278
- case 'TICKET':
279
- action = 'Open ticket — slow erosion sustained, investigate before budget exhausted';
280
- break;
281
- case 'WARN':
282
- action = 'Monitor — burn rate ≥1× either window, sustained drains budget';
283
- break;
284
- case 'no_data':
285
- action = '— (await more snapshots; auto-persist via metrics-snapshot tool — Phase 102)';
286
- break;
287
- default:
288
- action = '—';
289
- }
290
-
291
- // ETA exhaustion (predictive). Use slow window (more stable signal for budget extrapolation).
292
- // For burn=0 (no errors), ETA is ∞.
293
- const slowBurnRate = slowBurn.burnRate;
294
- const baselineHours = $SLOW_BASELINE_MS / 3600000;
295
- const eta = (slowBurnRate !== null && slowBurnRate > 0)
296
- ? (1 / slowBurnRate) * 30 * 24 / baselineHours
297
- : null;
298
- const etaStr = eta === null ? '—' : (eta < 24 ? eta.toFixed(1) + 'h' : (eta/24).toFixed(1) + 'd');
299
-
300
- const fastBurnFmt = fastBurn.burnRate === null ? '—' : fastBurn.burnRate.toFixed(2) + '×';
301
- const slowBurnFmt = slowBurn.burnRate === null ? '—' : slowBurn.burnRate.toFixed(2) + '×';
302
-
303
- // fast_status / slow_status são derivados em isolation (informativo na tabela);
304
- // combined_status é o veredito operacional.
305
- function singleStatus(burn, mult) {
306
- if (burn === null) return 'no_data';
307
- if (burn >= mult) return mult === parseFloat('$FAST_MULTIPLIER') ? 'PAGE-FAST' : 'TICKET-SLOW';
308
- if (burn >= 1.0) return 'WARN';
309
- return 'OK';
310
- }
311
- const fastStatus = singleStatus(fastBurn.burnRate, fastMult);
312
- const slowStatus = singleStatus(slowBurn.burnRate, slowMult);
313
-
314
- console.log(JSON.stringify({
315
- fast_burn: fastBurnFmt,
316
- slow_burn: slowBurnFmt,
317
- fast_status: fastStatus,
318
- slow_status: slowStatus,
319
- combined_status: combined,
320
- action: action,
321
- eta: etaStr,
322
- }));
323
- ")
324
- ```
325
-
326
- ### 3.6 Acumular linha da tabela (colunas dual-window)
327
-
328
- ```bash
329
- SLO_ROWS+=("| $SLO_NAME | ${TARGET_RATIO:-${TARGET_MS}ms p$PERCENTILE} | ${FAST_BURN} | ${SLOW_BURN} | **${COMBINED_STATUS}** | $ETA | $ACTION |")
330
- ```
331
-
332
- ## 4. Renderizar tabela mestra (Phase 103 dual-window)
333
-
334
- ```text
335
- ═══════════════════════════════════════════════════════════
336
- framework ▸ BURN-RATE-STATUS (dual-window) ▸ {timestamp}
337
- fast_baseline=$FAST_BASELINE slow_baseline=$SLOW_BASELINE
338
- fast_multiplier=$FAST_MULTIPLIER (page) slow_multiplier=$SLOW_MULTIPLIER (ticket)
339
- snapshots fast=$FAST_COUNT slow=$SLOW_COUNT
340
- ═══════════════════════════════════════════════════════════
341
-
342
- | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
343
- |---|---|---|---|---|---|---|
344
- {$SLO_ROWS}
345
- ```
346
-
347
- **Exemplo concreto:**
348
-
349
- ```markdown
350
- | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
351
- |---|---|---|---|---|---|---|
352
- | mcp-tool-availability | 99.5% | 0.42× OK | 0.18× OK | **OK** | — | — |
353
- | mcp-tool-latency | 200ms p95 | 16.0× PAGE-FAST | 8.5× TICKET-SLOW | **PAGE** | 4.2h | Page on-call NOW — invoke /investigar-producao |
354
- ```
355
-
356
- ## 5. Sugerir próximas ações
357
-
358
- ```bash
359
- # Contar status counts
360
- PAGE_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*PAGE\*\*" || echo 0)
361
- TICKET_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*TICKET\*\*" || echo 0)
362
- WARN_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*WARN\*\*" || echo 0)
363
- NO_DATA_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*no_data\*\*" || echo 0)
364
- ```
365
-
366
- Output:
367
- ```text
368
- ## Próximas ações
369
-
370
- {Se PAGE_COUNT > 0:}
371
- ⚠ {PAGE_COUNT} SLO(s) em PAGE (ambas janelas críticas) — invocar /investigar-producao "<slo_name> dual-window burn"
372
-
373
- {Se TICKET_COUNT > 0:}
374
- ☐ {TICKET_COUNT} SLO(s) em TICKET (slow erosion sustained) — abrir issue, investigar antes do budget esgotar
375
-
376
- {Se WARN_COUNT > 0:}
377
- ⓘ {WARN_COUNT} SLO(s) em WARN — fast spike isolado ou mild burn ≥ 1× (não page; monitor)
378
-
379
- {Se NO_DATA_COUNT > 0:}
380
- ⊘ {NO_DATA_COUNT} SLO(s) sem dados em pelo menos uma janela — Phase 102 auto-persist deve popular .planning/metrics/snapshots/ automaticamente em chamadas ao MCP tool 'metrics-snapshot'
381
- ```
382
-
383
- ## 6. Modo `/loop` (idempotência)
384
-
385
- Se chamado dentro de `/loop`, comportamento idempotente:
386
- - Snapshot fresh em cada invocação (não acumular state).
387
- - Output curto se `combined_status` não mudou (apenas linha-resumo; sem repetir tabela completa).
388
- - Acionar AskUserQuestion APENAS quando algum SLO transiciona OK → WARN/TICKET/PAGE no `combined_status`.
389
-
390
- </process>
391
-
392
- <success_criteria>
393
- - [ ] $ARGUMENTS parseados (SLO opcional + flags --fast-baseline/--slow-baseline/--format)
394
- - [ ] SLOs descobertos via glob `.planning/slos/*.yml` (FIX Phase 99: extension `.yml`, não `.md`)
395
- - [ ] alert_thresholds.page (fast) + alert_thresholds.ticket (slow) extraídos via awk com state machine
396
- - [ ] Defensive defaults aplicados (14.4 / 6 / 1h / 6h) se YAML omitir blocos
397
- - [ ] Snapshots carregados via `loadSnapshots()` em DUAS chamadas (fast + slow)
398
- - [ ] SLI calculado por tipo (event-based ratio para availability, percentile para latency) em CADA janela
399
- - [ ] Burn rate calculado pela fórmula `error_rate / (1 - target)` (skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md)) para fast E slow independentemente
400
- - [ ] Status combinado dual-window: **PAGE** (ambos críticos) / **TICKET** (slow only) / **WARN** (fast only OR mild ≥ 1×) / **OK** (ambos < 1×) / **no_data** (qualquer janela com snapshots insuficientes)
401
- - [ ] Tabela markdown agregada com colunas Fast (1h) / Slow (6h) / Combined explícitas
402
- - [ ] ETA exhaustão computada (predictive forecast — usa slow window por estabilidade)
403
- - [ ] Sugestões de próximas ações contextualizadas pelo combined_status
404
- - [ ] Idempotente em /loop (sem acúmulo de state; transição combined_status dispara AskUserQuestion)
405
- - [ ] no_data graceful — Phase 102 auto-persist mencionado como solução
406
- - [ ] Skill burn-rate-alerting cross-referenced no objective + inline no node script + inline na tabela de fallback (3 hits ≥ 2 mínimo)
407
- - [ ] Fator 4× explícito no contexto (canonical Google SRE)
408
- </success_criteria>
1
+ ---
2
+ name: burn-rate-status
3
+ description: Tabela de burn rate dual-window por SLO consumindo .planning/slos/*.yml + .planning/metrics/snapshots/.
4
+ argument-hint: "[<slo_name>] [--fast-baseline 1h] [--slow-baseline 6h] [--format table|json]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Glob
9
+ ---
10
+
11
+ <objective>
12
+ Snapshot de burn rate **dual-window** (1h fast + 6h slow) para 1 SLO (se especificado) ou TODOS os SLOs definidos em `.planning/slos/*.yml`. Aplica skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — fórmula canônica `burn_rate = error_rate / (1 - target)`, com lookahead/baseline obedecendo o **fator 4×** (page-tier: lookahead 1h ≤ 4× baseline 5m equivalente operacional; ticket-tier: lookahead 6h ≤ 4× baseline 30m). Status combinado segue o canonical Google SRE: PAGE quando ambas as janelas críticas, TICKET quando apenas slow erosion sustained, WARN para spike-only ou mild burn, OK quando ambas as janelas em estado saudável.
13
+
14
+ **Lê:** `.planning/slos/*.yml` (definição com `alert_thresholds.page` + `.ticket`) + `.planning/metrics/snapshots/*.json` (eventos persistidos via `metrics.persistSnapshot()` — Phase 99 + Phase 102 auto-snapshot).
15
+
16
+ **Cria/Atualiza:** nada — comando read-only.
17
+
18
+ **Após:** o user vê tabela com colunas `fast_burn`, `slow_burn`, `combined` (status PAGE / TICKET / WARN / OK) e pode escolher invocar `/investigar-producao` se há burn ativo, ou aguardar mais snapshots se ambas janelas estão `no_data`.
19
+ </objective>
20
+
21
+ <context>
22
+ **Argumentos:** `$ARGUMENTS` — opcional `<slo_name>` para 1 SLO; sem args = todos.
23
+
24
+ **Flags (defaults dual-window — Phase 103):**
25
+ - `--fast-baseline <duration>` — janela fast (page-tier). Default: `1h`.
26
+ - `--slow-baseline <duration>` — janela slow (ticket-tier). Default: `6h`.
27
+ - `--format <table|json>` — output format. Default: `table`.
28
+
29
+ **Combinações canônicas (skill burn-rate-alerting):**
30
+ - **Fast (page-tier):** lookahead 1h, baseline 5m, multiplier 14.4× — esgota ~2% do budget mensal em 1h.
31
+ - **Slow (ticket-tier):** lookahead 6h, baseline 30m, multiplier 6× — esgota ~10% do budget mensal em 6h.
32
+
33
+ **Fator 4×:** lookahead ≤ 4× baseline para extrapolação confiável (skill rule). 1h ≤ 4× 15m e 6h ≤ 4× 90m são ambos respeitados; defaults operacionais são page (1h baseline) + ticket (6h baseline) — a janela `lookahead` propriamente dita está embutida nos `alert_thresholds.{page,ticket}.lookahead` do YAML do SLO.
34
+
35
+ **Phase 99 + 102 wiring:** este comando consome dados persistidos automaticamente pelo handler MCP `metrics-snapshot` (Phase 102 OBS-20-01 — auto-persist via `persistSnapshot()` em cada call com throttle 1s). Sem snapshots na janela, o comando emite "no_data" para o SLO em vez de inventar números.
36
+
37
+ **Cross-reference:** este comando é a implementação do pattern "dashboard de burn rate" canônico documentado em [`kit/skills/burn-rate-alerting/SKILL.md`](../skills/burn-rate-alerting/SKILL.md). A skill é a SSOT da fórmula e dos thresholds; este comando é o renderer.
38
+ </context>
39
+
40
+ <process>
41
+
42
+ ## 1. Parsear argumentos
43
+
44
+ Bash:
45
+ ```bash
46
+ SLO_NAME=$(echo "$ARGUMENTS" | awk '{for(i=1;i<=NF;i++) if($i !~ /^--/) {print $i; exit}}')
47
+ FAST_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--fast-baseline [^ ]+' | awk '{print $2}')
48
+ SLOW_BASELINE=$(echo "$ARGUMENTS" | grep -oE -- '--slow-baseline [^ ]+' | awk '{print $2}')
49
+ FORMAT=$(echo "$ARGUMENTS" | grep -oE -- '--format [^ ]+' | awk '{print $2}')
50
+
51
+ [ -z "$FAST_BASELINE" ] && FAST_BASELINE="1h"
52
+ [ -z "$SLOW_BASELINE" ] && SLOW_BASELINE="6h"
53
+ [ -z "$FORMAT" ] && FORMAT="table"
54
+ ```
55
+
56
+ Convert duration to ms (helper):
57
+ ```bash
58
+ to_ms() {
59
+ local d="$1"
60
+ case "$d" in
61
+ *h) echo $(( ${d%h} * 3600000 ));;
62
+ *m) echo $(( ${d%m} * 60000 ));;
63
+ *s) echo $(( ${d%s} * 1000 ));;
64
+ *d) echo $(( ${d%d} * 86400000 ));;
65
+ *) echo 0 ;;
66
+ esac
67
+ }
68
+ FAST_BASELINE_MS=$(to_ms "$FAST_BASELINE")
69
+ SLOW_BASELINE_MS=$(to_ms "$SLOW_BASELINE")
70
+ ```
71
+
72
+ ## 2. Listar SLOs (FIX Phase 99: extension `.yml`, não `.md`)
73
+
74
+ ```bash
75
+ if [ -n "$SLO_NAME" ]; then
76
+ SLO_FILES=(".planning/slos/${SLO_NAME}.yml")
77
+ else
78
+ SLO_FILES=(.planning/slos/*.yml)
79
+ fi
80
+
81
+ # Filtra entradas inexistentes (caso o glob não tenha match).
82
+ EXISTING_SLOS=()
83
+ for f in "${SLO_FILES[@]}"; do
84
+ [ -f "$f" ] && EXISTING_SLOS+=("$f")
85
+ done
86
+
87
+ if [ ${#EXISTING_SLOS[@]} -eq 0 ]; then
88
+ echo "Nenhum SLO definido em .planning/slos/. Rode /definir-slo <feature> primeiro."
89
+ exit 0
90
+ fi
91
+ ```
92
+
93
+ ## 3. Para cada SLO, carregar metadata + calcular SLI dual-window
94
+
95
+ Para cada `SLO_FILE` em `EXISTING_SLOS`:
96
+
97
+ ### 3.1 Extrair campos canônicos do YAML via regex
98
+
99
+ Os SLOs do projeto seguem schema fixo (validado por `test/unit/slo-schema.test.js`). Sem `js-yaml` — regex sobre os keys conhecidos:
100
+
101
+ ```bash
102
+ SLO_NAME=$(grep -oE '^\s+name:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
103
+ SERVICE=$(grep -oE '^\s+service:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
104
+ SLO_TYPE=$(grep -oE '^\s+type:\s*\S+' "$SLO_FILE" | head -1 | awk '{print $2}')
105
+
106
+ # Availability SLO: target = ratio decimal (e.g. 0.995)
107
+ TARGET_RATIO=$(grep -oE '^target:\s*[0-9.]+' "$SLO_FILE" | awk '{print $2}')
108
+ # Latency SLO: target_ms + percentile
109
+ TARGET_MS=$(grep -oE '^target_ms:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
110
+ PERCENTILE=$(grep -oE '^\s+percentile:\s*[0-9]+' "$SLO_FILE" | awk '{print $2}')
111
+ ```
112
+
113
+ ### 3.2 Extrair `alert_thresholds.page` (fast) + `.ticket` (slow) do YAML
114
+
115
+ Phase 103 (OBS-20-02) — leitura dos dois blocos via awk com state machine. Cada bloco tem `lookahead`, `baseline`, `burn_rate_multiplier`. Defaults canônicos aplicados se ausentes (defensive default — ver fallback abaixo).
116
+
117
+ ```bash
118
+ # alert_thresholds.page (fast / page-tier)
119
+ FAST_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+lookahead:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
120
+ FAST_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+baseline:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
121
+ FAST_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*page:/){p=1;next}else if(p && /^\s+burn_rate_multiplier:/){print $2;exit}else if(p && /^\s*ticket:/){exit}}' "$SLO_FILE")
122
+
123
+ # alert_thresholds.ticket (slow / ticket-tier)
124
+ SLOW_LOOKAHEAD=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+lookahead:/){print $2;exit}}' "$SLO_FILE")
125
+ SLOW_BASELINE_YAML=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+baseline:/){print $2;exit}}' "$SLO_FILE")
126
+ SLOW_MULTIPLIER=$(awk '/^\s*alert_thresholds:/,/^[a-zA-Z]/{if(/^\s*ticket:/){t=1;next}else if(t && /^\s+burn_rate_multiplier:/){print $2;exit}}' "$SLO_FILE")
127
+
128
+ # Defensive defaults — fator 4× canonical Google SRE values.
129
+ # Se um SLO YAML antigo / parcial não declarar alert_thresholds, aplicamos
130
+ # os defaults da skill burn-rate-alerting verbatim:
131
+ # page: 14.4× / lookahead 1h / baseline 5m
132
+ # ticket: 6× / lookahead 6h / baseline 30m
133
+ [ -z "$FAST_MULTIPLIER" ] && FAST_MULTIPLIER="14.4"
134
+ [ -z "$SLOW_MULTIPLIER" ] && SLOW_MULTIPLIER="6"
135
+ [ -z "$FAST_LOOKAHEAD" ] && FAST_LOOKAHEAD="1h"
136
+ [ -z "$SLOW_LOOKAHEAD" ] && SLOW_LOOKAHEAD="6h"
137
+ ```
138
+
139
+ ### 3.3 Carregar snapshots para AMBAS as janelas
140
+
141
+ Use a API `loadSnapshots()` (Phase 99) com duas chamadas — uma para fast (1h), uma para slow (6h). Inline node script:
142
+
143
+ ```bash
144
+ DUAL_SNAPS=$(node --input-type=module -e "
145
+ import { loadSnapshots } from './src/core/metrics.js';
146
+ const fast = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
147
+ const slow = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
148
+ console.log(JSON.stringify({fast, slow, fastCount: fast.length, slowCount: slow.length}));
149
+ ")
150
+ FAST_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).fastCount)")
151
+ SLOW_COUNT=$(echo "$DUAL_SNAPS" | node -e "console.log(JSON.parse(require('fs').readFileSync(0,'utf8')).slowCount)")
152
+ ```
153
+
154
+ **no_data conservative semantics:** se EITHER janela tem < 2 snapshots (availability) ou < 1 (latency), o `combined_status` final é `no_data` — preferimos não inventar números a falsamente reportar OK. Isso preserva o contrato "graceful no_data" da Phase 99.
155
+
156
+ ```bash
157
+ # A regra exata é aplicada dentro do node script de combinação (3.5),
158
+ # mas o early-out aqui evita trabalho desnecessário no caso comum.
159
+ if [ "$FAST_COUNT" -lt 2 ] && [ "$SLOW_COUNT" -lt 2 ]; then
160
+ echo "SLO $SLO_NAME: insufficient snapshots in BOTH windows (fast=$FAST_COUNT, slow=$SLOW_COUNT)"
161
+ echo "Generate data: invocações ao MCP tool 'metrics-snapshot' agora auto-persistem (Phase 102 OBS-20-01)."
162
+ COMBINED_STATUS="no_data"
163
+ continue
164
+ fi
165
+ ```
166
+
167
+ ### 3.4 Calcular SLI por tipo de SLO (fast E slow independentes)
168
+
169
+ **Availability (`type: event-based`):**
170
+
171
+ Inline node — primeiro vs último snapshot **dentro de cada janela**. Delta de counters dá good/bad events:
172
+
173
+ ```bash
174
+ DUAL_SLI=$(node --input-type=module -e "
175
+ import { loadSnapshots } from './src/core/metrics.js';
176
+ const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
177
+ const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
178
+
179
+ function sliFromSnaps(snaps) {
180
+ if (snaps.length < 2) return {sli: null, errorRate: 0, good: 0, total: 0, error: 'no_data'};
181
+ const first = snaps[0];
182
+ const last = snaps[snaps.length - 1];
183
+ let goodFirst = 0, goodLast = 0, totalFirst = 0, totalLast = 0;
184
+ for (const [k,v] of Object.entries(first.counters)) {
185
+ if (k.endsWith(':ok')) goodFirst += v;
186
+ totalFirst += v;
187
+ }
188
+ for (const [k,v] of Object.entries(last.counters)) {
189
+ if (k.endsWith(':ok')) goodLast += v;
190
+ totalLast += v;
191
+ }
192
+ const good = goodLast - goodFirst;
193
+ const total = totalLast - totalFirst;
194
+ const sli = total > 0 ? good / total : null;
195
+ const errorRate = total > 0 ? (total - good) / total : 0;
196
+ return {sli, errorRate, good, total};
197
+ }
198
+
199
+ const fastSli = sliFromSnaps(fastSnaps);
200
+ const slowSli = sliFromSnaps(slowSnaps);
201
+ console.log(JSON.stringify({fast: fastSli, slow: slowSli}));
202
+ ")
203
+ ```
204
+
205
+ **Latency (`type: percentile`):**
206
+
207
+ Para latency, p95 do último snapshot em CADA janela. SLI = fração de samples NOT acima de target_ms.
208
+
209
+ ```bash
210
+ DUAL_SLI=$(node --input-type=module -e "
211
+ import { loadSnapshots } from './src/core/metrics.js';
212
+ const target = $TARGET_MS;
213
+ const fastSnaps = await loadSnapshots(process.cwd(), $FAST_BASELINE_MS);
214
+ const slowSnaps = await loadSnapshots(process.cwd(), $SLOW_BASELINE_MS);
215
+
216
+ function latencySli(snaps) {
217
+ if (snaps.length < 1) return {sli: null, errorRate: 0, totalSamples: 0, slowSamples: 0, error: 'no_data'};
218
+ const last = snaps[snaps.length - 1];
219
+ let totalSamples = 0, slowSamples = 0;
220
+ for (const lat of Object.values(last.latency)) {
221
+ totalSamples += lat.count;
222
+ if (lat.p95 > target) slowSamples += Math.round(lat.count * 0.05);
223
+ }
224
+ const sli = totalSamples > 0 ? 1 - (slowSamples / totalSamples) : null;
225
+ const errorRate = totalSamples > 0 ? slowSamples / totalSamples : 0;
226
+ return {sli, errorRate, totalSamples, slowSamples};
227
+ }
228
+
229
+ console.log(JSON.stringify({fast: latencySli(fastSnaps), slow: latencySli(slowSnaps)}));
230
+ ")
231
+ ```
232
+
233
+ ### 3.5 Calcular burn rate + status COMBINADO (dual-window)
234
+
235
+ Aplicar fórmula canônica + status enum dual-window (skill `burn-rate-alerting` — fator 4× canonical):
236
+
237
+ ```bash
238
+ DUAL_STATUS=$(node --input-type=module -e "
239
+ const dual = $DUAL_SLI;
240
+ const target = $TARGET_RATIO || (1 - 0.05); // latency: 1 - ratio_above_target (5%)
241
+ const fastMult = $FAST_MULTIPLIER;
242
+ const slowMult = $SLOW_MULTIPLIER;
243
+
244
+ function burnFromSli(sli, target) {
245
+ if (sli.error) return {burnRate: null, error: sli.error};
246
+ const slack = 1 - target;
247
+ const burnRate = slack > 0 ? sli.errorRate / slack : 0;
248
+ return {burnRate, errorRate: sli.errorRate};
249
+ }
250
+
251
+ // Combined status — canonical dual-window logic per skill burn-rate-alerting (fator 4×):
252
+ // PAGE = ambos críticos (fast ≥ 14.4 E slow ≥ 6) → page on-call AGORA
253
+ // TICKET = slow erosion sustained (slow ≥ 6, fast OK) → ticket de investigação
254
+ // WARN = fast spike isolado (fast ≥ 14.4 sozinho) — monitor, NÃO page (alarm flap risk)
255
+ // WARN = mild burn em qualquer janela (≥ 1.0×) — sustained drains budget no horizonte
256
+ // OK = ambos < 1.0× — saudável
257
+ // no_data = qualquer janela com snapshots insuficientes (conservative)
258
+ function combinedStatus(fastBurn, fastMult, slowBurn, slowMult) {
259
+ if (fastBurn === null || slowBurn === null) return 'no_data';
260
+ const fastTriggered = fastBurn >= fastMult;
261
+ const slowTriggered = slowBurn >= slowMult;
262
+ if (fastTriggered && slowTriggered) return 'PAGE';
263
+ if (slowTriggered) return 'TICKET';
264
+ if (fastTriggered) return 'WARN';
265
+ if (fastBurn >= 1.0 || slowBurn >= 1.0) return 'WARN';
266
+ return 'OK';
267
+ }
268
+
269
+ const fastBurn = burnFromSli(dual.fast, target);
270
+ const slowBurn = burnFromSli(dual.slow, target);
271
+ const combined = combinedStatus(fastBurn.burnRate, fastMult, slowBurn.burnRate, slowMult);
272
+
273
+ let action;
274
+ switch (combined) {
275
+ case 'PAGE':
276
+ action = 'Page on-call NOW — invoke /investigar-producao';
277
+ break;
278
+ case 'TICKET':
279
+ action = 'Open ticket — slow erosion sustained, investigate before budget exhausted';
280
+ break;
281
+ case 'WARN':
282
+ action = 'Monitor — burn rate ≥1× either window, sustained drains budget';
283
+ break;
284
+ case 'no_data':
285
+ action = '— (await more snapshots; auto-persist via metrics-snapshot tool — Phase 102)';
286
+ break;
287
+ default:
288
+ action = '—';
289
+ }
290
+
291
+ // ETA exhaustion (predictive). Use slow window (more stable signal for budget extrapolation).
292
+ // For burn=0 (no errors), ETA is ∞.
293
+ const slowBurnRate = slowBurn.burnRate;
294
+ const baselineHours = $SLOW_BASELINE_MS / 3600000;
295
+ const eta = (slowBurnRate !== null && slowBurnRate > 0)
296
+ ? (1 / slowBurnRate) * 30 * 24 / baselineHours
297
+ : null;
298
+ const etaStr = eta === null ? '—' : (eta < 24 ? eta.toFixed(1) + 'h' : (eta/24).toFixed(1) + 'd');
299
+
300
+ const fastBurnFmt = fastBurn.burnRate === null ? '—' : fastBurn.burnRate.toFixed(2) + '×';
301
+ const slowBurnFmt = slowBurn.burnRate === null ? '—' : slowBurn.burnRate.toFixed(2) + '×';
302
+
303
+ // fast_status / slow_status são derivados em isolation (informativo na tabela);
304
+ // combined_status é o veredito operacional.
305
+ function singleStatus(burn, mult) {
306
+ if (burn === null) return 'no_data';
307
+ if (burn >= mult) return mult === parseFloat('$FAST_MULTIPLIER') ? 'PAGE-FAST' : 'TICKET-SLOW';
308
+ if (burn >= 1.0) return 'WARN';
309
+ return 'OK';
310
+ }
311
+ const fastStatus = singleStatus(fastBurn.burnRate, fastMult);
312
+ const slowStatus = singleStatus(slowBurn.burnRate, slowMult);
313
+
314
+ console.log(JSON.stringify({
315
+ fast_burn: fastBurnFmt,
316
+ slow_burn: slowBurnFmt,
317
+ fast_status: fastStatus,
318
+ slow_status: slowStatus,
319
+ combined_status: combined,
320
+ action: action,
321
+ eta: etaStr,
322
+ }));
323
+ ")
324
+ ```
325
+
326
+ ### 3.6 Acumular linha da tabela (colunas dual-window)
327
+
328
+ ```bash
329
+ SLO_ROWS+=("| $SLO_NAME | ${TARGET_RATIO:-${TARGET_MS}ms p$PERCENTILE} | ${FAST_BURN} | ${SLOW_BURN} | **${COMBINED_STATUS}** | $ETA | $ACTION |")
330
+ ```
331
+
332
+ ## 4. Renderizar tabela mestra (Phase 103 dual-window)
333
+
334
+ ```text
335
+ ═══════════════════════════════════════════════════════════
336
+ framework ▸ BURN-RATE-STATUS (dual-window) ▸ {timestamp}
337
+ fast_baseline=$FAST_BASELINE slow_baseline=$SLOW_BASELINE
338
+ fast_multiplier=$FAST_MULTIPLIER (page) slow_multiplier=$SLOW_MULTIPLIER (ticket)
339
+ snapshots fast=$FAST_COUNT slow=$SLOW_COUNT
340
+ ═══════════════════════════════════════════════════════════
341
+
342
+ | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
343
+ |---|---|---|---|---|---|---|
344
+ {$SLO_ROWS}
345
+ ```
346
+
347
+ **Exemplo concreto:**
348
+
349
+ ```markdown
350
+ | SLO | Target | Fast (1h) | Slow (6h) | Combined | ETA exhaustão | Ação |
351
+ |---|---|---|---|---|---|---|
352
+ | mcp-tool-availability | 99.5% | 0.42× OK | 0.18× OK | **OK** | — | — |
353
+ | mcp-tool-latency | 200ms p95 | 16.0× PAGE-FAST | 8.5× TICKET-SLOW | **PAGE** | 4.2h | Page on-call NOW — invoke /investigar-producao |
354
+ ```
355
+
356
+ ## 5. Sugerir próximas ações
357
+
358
+ ```bash
359
+ # Contar status counts
360
+ PAGE_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*PAGE\*\*" || echo 0)
361
+ TICKET_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*TICKET\*\*" || echo 0)
362
+ WARN_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*WARN\*\*" || echo 0)
363
+ NO_DATA_COUNT=$(echo "$SLO_ROWS" | grep -c "\*\*no_data\*\*" || echo 0)
364
+ ```
365
+
366
+ Output:
367
+ ```text
368
+ ## Próximas ações
369
+
370
+ {Se PAGE_COUNT > 0:}
371
+ ⚠ {PAGE_COUNT} SLO(s) em PAGE (ambas janelas críticas) — invocar /investigar-producao "<slo_name> dual-window burn"
372
+
373
+ {Se TICKET_COUNT > 0:}
374
+ ☐ {TICKET_COUNT} SLO(s) em TICKET (slow erosion sustained) — abrir issue, investigar antes do budget esgotar
375
+
376
+ {Se WARN_COUNT > 0:}
377
+ ⓘ {WARN_COUNT} SLO(s) em WARN — fast spike isolado ou mild burn ≥ 1× (não page; monitor)
378
+
379
+ {Se NO_DATA_COUNT > 0:}
380
+ ⊘ {NO_DATA_COUNT} SLO(s) sem dados em pelo menos uma janela — Phase 102 auto-persist deve popular .planning/metrics/snapshots/ automaticamente em chamadas ao MCP tool 'metrics-snapshot'
381
+ ```
382
+
383
+ ## 6. Modo `/loop` (idempotência)
384
+
385
+ Se chamado dentro de `/loop`, comportamento idempotente:
386
+ - Snapshot fresh em cada invocação (não acumular state).
387
+ - Output curto se `combined_status` não mudou (apenas linha-resumo; sem repetir tabela completa).
388
+ - Acionar AskUserQuestion APENAS quando algum SLO transiciona OK → WARN/TICKET/PAGE no `combined_status`.
389
+
390
+ </process>
391
+
392
+ <success_criteria>
393
+ - [ ] $ARGUMENTS parseados (SLO opcional + flags --fast-baseline/--slow-baseline/--format)
394
+ - [ ] SLOs descobertos via glob `.planning/slos/*.yml` (FIX Phase 99: extension `.yml`, não `.md`)
395
+ - [ ] alert_thresholds.page (fast) + alert_thresholds.ticket (slow) extraídos via awk com state machine
396
+ - [ ] Defensive defaults aplicados (14.4 / 6 / 1h / 6h) se YAML omitir blocos
397
+ - [ ] Snapshots carregados via `loadSnapshots()` em DUAS chamadas (fast + slow)
398
+ - [ ] SLI calculado por tipo (event-based ratio para availability, percentile para latency) em CADA janela
399
+ - [ ] Burn rate calculado pela fórmula `error_rate / (1 - target)` (skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md)) para fast E slow independentemente
400
+ - [ ] Status combinado dual-window: **PAGE** (ambos críticos) / **TICKET** (slow only) / **WARN** (fast only OR mild ≥ 1×) / **OK** (ambos < 1×) / **no_data** (qualquer janela com snapshots insuficientes)
401
+ - [ ] Tabela markdown agregada com colunas Fast (1h) / Slow (6h) / Combined explícitas
402
+ - [ ] ETA exhaustão computada (predictive forecast — usa slow window por estabilidade)
403
+ - [ ] Sugestões de próximas ações contextualizadas pelo combined_status
404
+ - [ ] Idempotente em /loop (sem acúmulo de state; transição combined_status dispara AskUserQuestion)
405
+ - [ ] no_data graceful — Phase 102 auto-persist mencionado como solução
406
+ - [ ] Skill burn-rate-alerting cross-referenced no objective + inline no node script + inline na tabela de fallback (3 hits ≥ 2 mínimo)
407
+ - [ ] Fator 4× explícito no contexto (canonical Google SRE)
408
+ </success_criteria>