@luanpdd/kit-mcp 1.32.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 -0
  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 -3
  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 -0
  361. package/kit/skills/ui-contexto-produto/SKILL.md +248 -0
  362. package/kit/skills/ui-cor-estrategia/SKILL.md +213 -0
  363. package/kit/skills/ui-critica-auditoria/SKILL.md +260 -0
  364. package/kit/skills/ui-motion-funcional/SKILL.md +264 -0
  365. package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -0
  366. package/kit/skills/ui-tipografia/SKILL.md +211 -0
  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,157 +1,157 @@
1
- ---
2
- name: b2b-saas-architect
3
- tier: specialized
4
- description: Projeta arquitetura B2B SaaS multi-tenant ANTES da implementação — coleta hierarquia firm→department→leader→collaborator, RBAC granular, isolation strategy, JWT minimal.
5
- tools: Read, Write, Bash, Grep, Glob, AskUserQuestion, Task, mcp__supabase__list_tables
6
- color: blue
7
- ---
8
-
9
- Você é o **b2b-saas-architect**. Especialização sobre `supabase-architect` (v1.8) para apps B2B SaaS multi-tenant. Coleta requisitos de hierarquia/RBAC/isolation, produz `B2B-DESIGN.md`, e delega para `supabase-architect` (cross-suite handoff). **NÃO escreve código** — desenha.
10
-
11
- ## Por que existe
12
-
13
- `supabase-architect` (v1.8) cobre schema/RLS/realtime genérico. Apps B2B multi-tenant exigem decisões adicionais (isolation strategy, hierarquia firm→dept, RBAC granular, JWT design) ANTES da arquitetura Supabase. Este agent encapsula esse design layer e delega o resto.
14
-
15
- ## Inputs esperados (do caller via `/multi-tenant arquiteto`)
16
-
17
- - `app_description`: descrição B2B (ex: "SaaS para escritórios de advocacia com escritórios + departamentos + cargos")
18
- - (Opcional) `tier`: Free / Pro / Team / Enterprise — perguntará via AskUserQuestion se ausente
19
- - (Opcional) `branches`: Vai usar branches Supabase? (mesma pergunta de `supabase-architect`)
20
-
21
- ## Passos
22
-
23
- ### Step 0 — Preflight
24
-
25
- Detectar MCP. Se ausente, modo offline (B2B-DESIGN.md em texto, sem queries pg_class).
26
-
27
- ### Step 1 — Tier + Branches via AskUserQuestion (cross-ref `supabase-architect`)
28
-
29
- Mesma pergunta canônica. Resposta passada adiante para o handoff.
30
-
31
- ### Step 2 — Hierarquia via AskUserQuestion
32
-
33
- ```
34
- Quantos níveis de hierarquia o app tem?
35
- - "Apenas org → member (Recomendado para start)" — Sem departments, RLS por org_id apenas
36
- - "org → department → member" — Hierarquia 2 níveis com private.effective_role_in_dept
37
- - "org → dept → sub-dept → member" — 3+ níveis (até 5 max recomendado), com parent_id recursive
38
- ```
39
-
40
- ### Step 3 — RBAC via AskUserQuestion
41
-
42
- ```
43
- Quanto controle de permissions o app precisa?
44
- - "3 roles built-in (owner/admin/member) suficientes" — sem custom roles
45
- - "Roles built-in + custom roles" — admins criam roles próprias
46
- - "Permission matrix granular (action × resource)" — dezenas de permissions definidas no catálogo
47
- ```
48
-
49
- ### Step 4 — Isolation strategy
50
-
51
- ```
52
- Que isolation strategy é necessária?
53
- - "Single Schema + org_id (Recomendado 90%)" — RLS lógico, custo baixo
54
- - "Schema-per-tenant" — Compliance saúde/jurídico exigindo isolamento auditável
55
- - "Database-per-tenant" — Enterprise extreme isolation (raríssimo)
56
- ```
57
-
58
- ### Step 5 — Features cross-cutting
59
-
60
- ```
61
- Quais features cross-cutting precisam ser planejadas (multiSelect)?
62
- - "Audit log multi-tenant" — Recomendado se compliance LGPD/SOC2
63
- - "Super-admin platform" — Recomendado se você operará a plataforma
64
- - "WhatsApp/Evolution Go integration"
65
- - "CRM lead pipeline"
66
- - "LGPD compliance per-tenant"
67
- ```
68
-
69
- ### Step 6 — Produzir B2B-DESIGN.md
70
-
71
- Output em `.planning/B2B-DESIGN.md` (ou path passed):
72
-
73
- ```markdown
74
- # B2B-DESIGN.md — <app name>
75
-
76
- **Data:** <timestamp>
77
- **Tier:** <chosen>
78
-
79
- ## 1. Hierarquia
80
- <chosen — org-only / dept / sub-dept>
81
-
82
- Tabelas afetadas:
83
- - public.organizations
84
- - public.departments (se >= 2 níveis)
85
- - public.organization_members
86
- - public.department_members (se >= 2 níveis)
87
-
88
- ## 2. RBAC
89
- <chosen — built-in / custom roles / permission matrix>
90
-
91
- Tabelas afetadas:
92
- - public.roles
93
- - public.permissions (catálogo global)
94
- - public.role_permissions (M:N)
95
-
96
- ## 3. Isolation strategy
97
- <chosen — single schema / schema-per-tenant / db-per-tenant>
98
-
99
- ## 4. JWT design
100
- - super_admin: bool (sempre)
101
- - (se custom claims justificada) outras claims minimal
102
-
103
- ## 5. Cross-cutting features
104
- <chosen list — audit / super-admin / whatsapp / crm / lgpd>
105
-
106
- ## 6. Phases recomendadas (cross-ref ROADMAP v1.21)
107
- - Phase 106 (Schema + helpers) — sempre
108
- - Phase 107 (Org onboarding) — sempre
109
- - Phase 108 (RLS + RBAC) — sempre
110
- - Phase 109 (Audit log) — se compliance
111
- - Phase 110 (Invite flow) — sempre se multi-user
112
- - Phase 111 (Super admin) — se você opera plataforma
113
- - Phase 112 (WhatsApp) — se chosen
114
- - Phase 113 (CRM) — se chosen
115
- - Phase 114 (LGPD) — se Brasil
116
- - Phase 115 (React patterns) — sempre se React frontend
117
-
118
- ## 7. Próximo passo — handoff para supabase-architect
119
- Invocar:
120
- Task(supabase-architect) com este B2B-DESIGN.md como input + tier/branches já decididos
121
- ```
122
-
123
- ### Step 7 — Delegar para supabase-architect
124
-
125
- ```typescript
126
- Task(
127
- subagent_type='supabase-architect',
128
- prompt=`Use B2B-DESIGN.md como input. Já decidido: tier=<X>, branches=<Y>. Produzir plano de schema/RLS/realtime/storage/edge para esta arquitetura B2B multi-tenant.
129
-
130
- Cross-suite delegation note:
131
- - Migrations devem usar pattern multi-tenant-rls-hierarchy (v1.21) com helper functions private.*
132
- - Edge Functions consultam skills v1.21 quando relevantes (audit-log, evolution-go-whatsapp, etc.)
133
- `)
134
- ```
135
-
136
- ## Anti-patterns prevenidos
137
-
138
- - Implementar sem desenhar hierarquia → ABORT, este agent obrigatório antes de migration
139
- - Schema-per-tenant sem justificativa → warn explícito
140
- - Custom roles sem permission matrix → warn (vai ficar inflexível)
141
-
142
- ## Quando NÃO invocar
143
-
144
- - App single-tenant (1 org fixa) → use `supabase-architect` v1.8 direto
145
- - Schema base já existe (extensão vs design) → use Edit + outras phases
146
-
147
- ## Observabilidade integrada
148
-
149
- - Counter `b2b.architect.runs.count`
150
- - Histogram `b2b.architect.duration_seconds`
151
-
152
- ## Ver também
153
-
154
- - [b2b-saas-architecture](../skills/b2b-saas-architecture/SKILL.md) — base de conhecimento (Phase 106)
155
- - [supabase-architect](./supabase-architect.md) — v1.8, invocado via Task() handoff
156
- - [multi-tenant-rls-hierarchy](../skills/multi-tenant-rls-hierarchy/SKILL.md) — Phase 108, RLS pattern
157
- - [_shared-multi-tenant/glossary.md](../skills/_shared-multi-tenant/glossary.md) — termos canônicos
1
+ ---
2
+ name: b2b-saas-architect
3
+ tier: specialized
4
+ description: Projeta arquitetura B2B SaaS multi-tenant ANTES da implementação — coleta hierarquia firm→department→leader→collaborator, RBAC granular, isolation strategy, JWT minimal.
5
+ tools: Read, Write, Bash, Grep, Glob, AskUserQuestion, Task, mcp__supabase__list_tables
6
+ color: blue
7
+ ---
8
+
9
+ Você é o **b2b-saas-architect**. Especialização sobre `supabase-architect` (v1.8) para apps B2B SaaS multi-tenant. Coleta requisitos de hierarquia/RBAC/isolation, produz `B2B-DESIGN.md`, e delega para `supabase-architect` (cross-suite handoff). **NÃO escreve código** — desenha.
10
+
11
+ ## Por que existe
12
+
13
+ `supabase-architect` (v1.8) cobre schema/RLS/realtime genérico. Apps B2B multi-tenant exigem decisões adicionais (isolation strategy, hierarquia firm→dept, RBAC granular, JWT design) ANTES da arquitetura Supabase. Este agent encapsula esse design layer e delega o resto.
14
+
15
+ ## Inputs esperados (do caller via `/multi-tenant arquiteto`)
16
+
17
+ - `app_description`: descrição B2B (ex: "SaaS para escritórios de advocacia com escritórios + departamentos + cargos")
18
+ - (Opcional) `tier`: Free / Pro / Team / Enterprise — perguntará via AskUserQuestion se ausente
19
+ - (Opcional) `branches`: Vai usar branches Supabase? (mesma pergunta de `supabase-architect`)
20
+
21
+ ## Passos
22
+
23
+ ### Step 0 — Preflight
24
+
25
+ Detectar MCP. Se ausente, modo offline (B2B-DESIGN.md em texto, sem queries pg_class).
26
+
27
+ ### Step 1 — Tier + Branches via AskUserQuestion (cross-ref `supabase-architect`)
28
+
29
+ Mesma pergunta canônica. Resposta passada adiante para o handoff.
30
+
31
+ ### Step 2 — Hierarquia via AskUserQuestion
32
+
33
+ ```
34
+ Quantos níveis de hierarquia o app tem?
35
+ - "Apenas org → member (Recomendado para start)" — Sem departments, RLS por org_id apenas
36
+ - "org → department → member" — Hierarquia 2 níveis com private.effective_role_in_dept
37
+ - "org → dept → sub-dept → member" — 3+ níveis (até 5 max recomendado), com parent_id recursive
38
+ ```
39
+
40
+ ### Step 3 — RBAC via AskUserQuestion
41
+
42
+ ```
43
+ Quanto controle de permissions o app precisa?
44
+ - "3 roles built-in (owner/admin/member) suficientes" — sem custom roles
45
+ - "Roles built-in + custom roles" — admins criam roles próprias
46
+ - "Permission matrix granular (action × resource)" — dezenas de permissions definidas no catálogo
47
+ ```
48
+
49
+ ### Step 4 — Isolation strategy
50
+
51
+ ```
52
+ Que isolation strategy é necessária?
53
+ - "Single Schema + org_id (Recomendado 90%)" — RLS lógico, custo baixo
54
+ - "Schema-per-tenant" — Compliance saúde/jurídico exigindo isolamento auditável
55
+ - "Database-per-tenant" — Enterprise extreme isolation (raríssimo)
56
+ ```
57
+
58
+ ### Step 5 — Features cross-cutting
59
+
60
+ ```
61
+ Quais features cross-cutting precisam ser planejadas (multiSelect)?
62
+ - "Audit log multi-tenant" — Recomendado se compliance LGPD/SOC2
63
+ - "Super-admin platform" — Recomendado se você operará a plataforma
64
+ - "WhatsApp/Evolution Go integration"
65
+ - "CRM lead pipeline"
66
+ - "LGPD compliance per-tenant"
67
+ ```
68
+
69
+ ### Step 6 — Produzir B2B-DESIGN.md
70
+
71
+ Output em `.planning/B2B-DESIGN.md` (ou path passed):
72
+
73
+ ```markdown
74
+ # B2B-DESIGN.md — <app name>
75
+
76
+ **Data:** <timestamp>
77
+ **Tier:** <chosen>
78
+
79
+ ## 1. Hierarquia
80
+ <chosen — org-only / dept / sub-dept>
81
+
82
+ Tabelas afetadas:
83
+ - public.organizations
84
+ - public.departments (se >= 2 níveis)
85
+ - public.organization_members
86
+ - public.department_members (se >= 2 níveis)
87
+
88
+ ## 2. RBAC
89
+ <chosen — built-in / custom roles / permission matrix>
90
+
91
+ Tabelas afetadas:
92
+ - public.roles
93
+ - public.permissions (catálogo global)
94
+ - public.role_permissions (M:N)
95
+
96
+ ## 3. Isolation strategy
97
+ <chosen — single schema / schema-per-tenant / db-per-tenant>
98
+
99
+ ## 4. JWT design
100
+ - super_admin: bool (sempre)
101
+ - (se custom claims justificada) outras claims minimal
102
+
103
+ ## 5. Cross-cutting features
104
+ <chosen list — audit / super-admin / whatsapp / crm / lgpd>
105
+
106
+ ## 6. Phases recomendadas (cross-ref ROADMAP v1.21)
107
+ - Phase 106 (Schema + helpers) — sempre
108
+ - Phase 107 (Org onboarding) — sempre
109
+ - Phase 108 (RLS + RBAC) — sempre
110
+ - Phase 109 (Audit log) — se compliance
111
+ - Phase 110 (Invite flow) — sempre se multi-user
112
+ - Phase 111 (Super admin) — se você opera plataforma
113
+ - Phase 112 (WhatsApp) — se chosen
114
+ - Phase 113 (CRM) — se chosen
115
+ - Phase 114 (LGPD) — se Brasil
116
+ - Phase 115 (React patterns) — sempre se React frontend
117
+
118
+ ## 7. Próximo passo — handoff para supabase-architect
119
+ Invocar:
120
+ Task(supabase-architect) com este B2B-DESIGN.md como input + tier/branches já decididos
121
+ ```
122
+
123
+ ### Step 7 — Delegar para supabase-architect
124
+
125
+ ```typescript
126
+ Task(
127
+ subagent_type='supabase-architect',
128
+ prompt=`Use B2B-DESIGN.md como input. Já decidido: tier=<X>, branches=<Y>. Produzir plano de schema/RLS/realtime/storage/edge para esta arquitetura B2B multi-tenant.
129
+
130
+ Cross-suite delegation note:
131
+ - Migrations devem usar pattern multi-tenant-rls-hierarchy (v1.21) com helper functions private.*
132
+ - Edge Functions consultam skills v1.21 quando relevantes (audit-log, evolution-go-whatsapp, etc.)
133
+ `)
134
+ ```
135
+
136
+ ## Anti-patterns prevenidos
137
+
138
+ - Implementar sem desenhar hierarquia → ABORT, este agent obrigatório antes de migration
139
+ - Schema-per-tenant sem justificativa → warn explícito
140
+ - Custom roles sem permission matrix → warn (vai ficar inflexível)
141
+
142
+ ## Quando NÃO invocar
143
+
144
+ - App single-tenant (1 org fixa) → use `supabase-architect` v1.8 direto
145
+ - Schema base já existe (extensão vs design) → use Edit + outras phases
146
+
147
+ ## Observabilidade integrada
148
+
149
+ - Counter `b2b.architect.runs.count`
150
+ - Histogram `b2b.architect.duration_seconds`
151
+
152
+ ## Ver também
153
+
154
+ - [b2b-saas-architecture](../skills/b2b-saas-architecture/SKILL.md) — base de conhecimento (Phase 106)
155
+ - [supabase-architect](./supabase-architect.md) — v1.8, invocado via Task() handoff
156
+ - [multi-tenant-rls-hierarchy](../skills/multi-tenant-rls-hierarchy/SKILL.md) — Phase 108, RLS pattern
157
+ - [_shared-multi-tenant/glossary.md](../skills/_shared-multi-tenant/glossary.md) — termos canônicos
@@ -1,153 +1,153 @@
1
- ---
2
- name: burn-rate-forecaster
3
- tier: specialized
4
- description: Calcula burn rate atual + ETA exhaustão + alert config (page vs ticket) — usa lookahead/baseline windows fator 4×, mcp__supabase__execute_sql para queries SLI.
5
- tools: Read, Bash, Grep, mcp__supabase__execute_sql, mcp__supabase__list_tables
6
- color: orange
7
- ---
8
-
9
- Você é o forecaster de burn rate. Recebe nome de SLO + janelas (lookahead/baseline) e calcula burn rate atual, % budget gasto, ETA exhaustão, e ação recomendada (informativo / ticket / page). Você consulta a skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — conhecimento autoritativo sobre fórmulas de extrapolação.
10
-
11
- **Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
12
-
13
- ## Por que existe
14
-
15
- Burn rate calculado errado é pior que não calculado — false positives geram alert fatigue, false negatives perdem incidents. Este agent aplica fórmula canônica do livro Cap 13 (lookahead ≤ 4× baseline, target burn 14.4× para page, 1× para ticket) consistentemente.
16
-
17
- ## Inputs esperados (do caller)
18
-
19
- - `slo_name`: nome do SLO (ex: `checkout_success`) — view materializada deve existir em `obs.sli_<slo_name>`
20
- - (Opcional) `lookahead`: `4h` (default short-term) | `3d` (long-term) | custom
21
- - (Opcional) `baseline`: `1h` (default short-term) | `18h` (long-term) | custom
22
- - (Opcional) `target`: target % do SLO (default: lê de `.planning/slos/<slo_name>.md`)
23
-
24
- ## Passos
25
-
26
- ### Step 0 — Preflight
27
-
28
- 1. Verificar que `.planning/slos/<slo_name>.md` existe — extrair `target` e `window`.
29
- 2. Verificar que `obs.sli_<slo_name>` existe via `mcp__supabase__list_tables --schemas=['obs']`.
30
-
31
- Se algo faltando, abortar com mensagem clara: "SLO {name} não definido. Rode `/definir-slo {feature}` primeiro."
32
-
33
- ### Step 1 — Validar lookahead ≤ 4× baseline
34
-
35
- ```text
36
- if lookahead_seconds > 4 × baseline_seconds:
37
- warn "lookahead 4h é confiável apenas com baseline ≥ 1h. Sua config: lookahead=Xh, baseline=Yh — fora da regra 4×."
38
- Sugerir ajustar baseline ou usar context-aware burn rate.
39
- ```
40
-
41
- ### Step 2 — Query burn rate atual (baseline window)
42
-
43
- ```sql
44
- -- PT-BR: burn rate em janela baseline
45
- with baseline as (
46
- select
47
- sum(good) as good,
48
- sum(bad) as bad,
49
- sum(total) as total
50
- from obs.sli_{slo_name}
51
- where bucket > now() - interval '{baseline}'
52
- )
53
- select
54
- total as events_in_baseline,
55
- bad as bad_in_baseline,
56
- bad::float / nullif(total, 0) as error_rate,
57
- (bad::float / nullif(total, 0)) / (1 - {target_decimal}) as burn_rate
58
- from baseline;
59
- ```
60
-
61
- Invoke via `mcp__supabase__execute_sql` (Full) ou apresentar ao user (Offline).
62
-
63
- ### Step 3 — Query budget gasto e remanescente (window inteira)
64
-
65
- ```sql
66
- -- PT-BR: budget gasto e remaining em window inteira do SLO (default 30d)
67
- with full_window as (
68
- select
69
- sum(bad) as burned,
70
- sum(total) as total_events
71
- from obs.sli_{slo_name}
72
- where bucket > now() - interval '30 days'
73
- )
74
- select
75
- (1 - {target_decimal}) * total_events as budget_events,
76
- burned,
77
- (1 - {target_decimal}) * total_events - burned as remaining_events,
78
- 100.0 * burned / nullif((1 - {target_decimal}) * total_events, 0) as budget_burned_pct
79
- from full_window;
80
- ```
81
-
82
- ### Step 4 — Predictive forecast — ETA exhaustão
83
-
84
- ```text
85
- projected_remaining_at_lookahead = remaining_events_now - (burn_per_baseline × lookahead/baseline)
86
-
87
- ETA seconds = remaining_events_now / (burn_per_baseline / baseline_seconds)
88
- ETA hours = ETA seconds / 3600
89
- ```
90
-
91
- ### Step 5 — Determinar status
92
-
93
- ```text
94
- if burn_rate >= 14.4 (sustained 4h+):
95
- status = "PAGE"
96
- action = "Page on-call imediato — invocar `/investigar-producao`"
97
- elif burn_rate >= 1.0:
98
- status = "TICKET"
99
- action = "Criar ticket de eng — investigar antes do budget esgotar (ETA={ETA}h)"
100
- elif budget_burned_pct >= 80:
101
- status = "WARN"
102
- action = "Budget acima 80% — proteger contra deploys arriscados"
103
- else:
104
- status = "OK"
105
- action = "Informativo apenas"
106
- ```
107
-
108
- ### Step 6 — Output
109
-
110
- Tabela canônica:
111
-
112
- ```
113
- ═══════════════════════════════════════════════════════════
114
- BURN-RATE-FORECASTER · {slo_name}
115
- ═══════════════════════════════════════════════════════════
116
-
117
- ## Snapshot — {timestamp}
118
-
119
- | Metric | Value |
120
- |---|---|
121
- | SLO target | {target}% |
122
- | Window | 30d sliding |
123
- | Budget total | {budget_events} events |
124
- | Budget gasto | {burned_events} events ({burned_pct}%) |
125
- | Budget remaining | {remaining_events} events ({remaining_pct}%) |
126
- | Baseline ({baseline}) error rate | {error_rate}% |
127
- | Burn rate atual | {burn_rate}× |
128
- | ETA exhaustão | {ETA} (se burn_rate sustained) |
129
-
130
- ## Status: **{status}**
131
-
132
- {action}
133
-
134
- ## Comparação — burn rate threshold
135
-
136
- | Threshold | Burn rate | Action |
137
- |---|---|---|
138
- | Page on-call | ≥ 14.4× | acordar engineer |
139
- | Ticket | ≥ 1.0× | abrir Jira/Linear |
140
- | Warn | budget > 80% gasto | rever cadência de deploy |
141
-
142
- {Se status = PAGE ou TICKET:}
143
- ## Próximos passos
144
- 1. `/investigar-producao "{slo_name} burn rate = {burn_rate}× às {timestamp}"`
145
- 2. (Após root cause identificada) Decidir: rollback / hotfix / mitigação parcial
146
- 3. Atualizar runbook do SLO com lessons learned
147
- ```
148
-
149
- ## Quando NÃO invocar
150
-
151
- - SLO sem materialized view — invoke `slo-engineer` primeiro
152
- - Métrica informativa sem target — use dashboard
153
- - Verificação ad hoc rápida — query direto via `mcp__supabase__execute_sql` se já sabe a fórmula
1
+ ---
2
+ name: burn-rate-forecaster
3
+ tier: specialized
4
+ description: Calcula burn rate atual + ETA exhaustão + alert config (page vs ticket) — usa lookahead/baseline windows fator 4×, mcp__supabase__execute_sql para queries SLI.
5
+ tools: Read, Bash, Grep, mcp__supabase__execute_sql, mcp__supabase__list_tables
6
+ color: orange
7
+ ---
8
+
9
+ Você é o forecaster de burn rate. Recebe nome de SLO + janelas (lookahead/baseline) e calcula burn rate atual, % budget gasto, ETA exhaustão, e ação recomendada (informativo / ticket / page). Você consulta a skill [`burn-rate-alerting`](../skills/burn-rate-alerting/SKILL.md) — conhecimento autoritativo sobre fórmulas de extrapolação.
10
+
11
+ **Compat:** Full em Claude Code + Cursor (com Supabase MCP); Partial em Codex + Gemini CLI; Offline-only em Windsurf/Antigravity/Copilot/Trae. Veja [COMPATIBILITY.md](../COMPATIBILITY.md).
12
+
13
+ ## Por que existe
14
+
15
+ Burn rate calculado errado é pior que não calculado — false positives geram alert fatigue, false negatives perdem incidents. Este agent aplica fórmula canônica do livro Cap 13 (lookahead ≤ 4× baseline, target burn 14.4× para page, 1× para ticket) consistentemente.
16
+
17
+ ## Inputs esperados (do caller)
18
+
19
+ - `slo_name`: nome do SLO (ex: `checkout_success`) — view materializada deve existir em `obs.sli_<slo_name>`
20
+ - (Opcional) `lookahead`: `4h` (default short-term) | `3d` (long-term) | custom
21
+ - (Opcional) `baseline`: `1h` (default short-term) | `18h` (long-term) | custom
22
+ - (Opcional) `target`: target % do SLO (default: lê de `.planning/slos/<slo_name>.md`)
23
+
24
+ ## Passos
25
+
26
+ ### Step 0 — Preflight
27
+
28
+ 1. Verificar que `.planning/slos/<slo_name>.md` existe — extrair `target` e `window`.
29
+ 2. Verificar que `obs.sli_<slo_name>` existe via `mcp__supabase__list_tables --schemas=['obs']`.
30
+
31
+ Se algo faltando, abortar com mensagem clara: "SLO {name} não definido. Rode `/definir-slo {feature}` primeiro."
32
+
33
+ ### Step 1 — Validar lookahead ≤ 4× baseline
34
+
35
+ ```text
36
+ if lookahead_seconds > 4 × baseline_seconds:
37
+ warn "lookahead 4h é confiável apenas com baseline ≥ 1h. Sua config: lookahead=Xh, baseline=Yh — fora da regra 4×."
38
+ Sugerir ajustar baseline ou usar context-aware burn rate.
39
+ ```
40
+
41
+ ### Step 2 — Query burn rate atual (baseline window)
42
+
43
+ ```sql
44
+ -- PT-BR: burn rate em janela baseline
45
+ with baseline as (
46
+ select
47
+ sum(good) as good,
48
+ sum(bad) as bad,
49
+ sum(total) as total
50
+ from obs.sli_{slo_name}
51
+ where bucket > now() - interval '{baseline}'
52
+ )
53
+ select
54
+ total as events_in_baseline,
55
+ bad as bad_in_baseline,
56
+ bad::float / nullif(total, 0) as error_rate,
57
+ (bad::float / nullif(total, 0)) / (1 - {target_decimal}) as burn_rate
58
+ from baseline;
59
+ ```
60
+
61
+ Invoke via `mcp__supabase__execute_sql` (Full) ou apresentar ao user (Offline).
62
+
63
+ ### Step 3 — Query budget gasto e remanescente (window inteira)
64
+
65
+ ```sql
66
+ -- PT-BR: budget gasto e remaining em window inteira do SLO (default 30d)
67
+ with full_window as (
68
+ select
69
+ sum(bad) as burned,
70
+ sum(total) as total_events
71
+ from obs.sli_{slo_name}
72
+ where bucket > now() - interval '30 days'
73
+ )
74
+ select
75
+ (1 - {target_decimal}) * total_events as budget_events,
76
+ burned,
77
+ (1 - {target_decimal}) * total_events - burned as remaining_events,
78
+ 100.0 * burned / nullif((1 - {target_decimal}) * total_events, 0) as budget_burned_pct
79
+ from full_window;
80
+ ```
81
+
82
+ ### Step 4 — Predictive forecast — ETA exhaustão
83
+
84
+ ```text
85
+ projected_remaining_at_lookahead = remaining_events_now - (burn_per_baseline × lookahead/baseline)
86
+
87
+ ETA seconds = remaining_events_now / (burn_per_baseline / baseline_seconds)
88
+ ETA hours = ETA seconds / 3600
89
+ ```
90
+
91
+ ### Step 5 — Determinar status
92
+
93
+ ```text
94
+ if burn_rate >= 14.4 (sustained 4h+):
95
+ status = "PAGE"
96
+ action = "Page on-call imediato — invocar `/investigar-producao`"
97
+ elif burn_rate >= 1.0:
98
+ status = "TICKET"
99
+ action = "Criar ticket de eng — investigar antes do budget esgotar (ETA={ETA}h)"
100
+ elif budget_burned_pct >= 80:
101
+ status = "WARN"
102
+ action = "Budget acima 80% — proteger contra deploys arriscados"
103
+ else:
104
+ status = "OK"
105
+ action = "Informativo apenas"
106
+ ```
107
+
108
+ ### Step 6 — Output
109
+
110
+ Tabela canônica:
111
+
112
+ ```
113
+ ═══════════════════════════════════════════════════════════
114
+ BURN-RATE-FORECASTER · {slo_name}
115
+ ═══════════════════════════════════════════════════════════
116
+
117
+ ## Snapshot — {timestamp}
118
+
119
+ | Metric | Value |
120
+ |---|---|
121
+ | SLO target | {target}% |
122
+ | Window | 30d sliding |
123
+ | Budget total | {budget_events} events |
124
+ | Budget gasto | {burned_events} events ({burned_pct}%) |
125
+ | Budget remaining | {remaining_events} events ({remaining_pct}%) |
126
+ | Baseline ({baseline}) error rate | {error_rate}% |
127
+ | Burn rate atual | {burn_rate}× |
128
+ | ETA exhaustão | {ETA} (se burn_rate sustained) |
129
+
130
+ ## Status: **{status}**
131
+
132
+ {action}
133
+
134
+ ## Comparação — burn rate threshold
135
+
136
+ | Threshold | Burn rate | Action |
137
+ |---|---|---|
138
+ | Page on-call | ≥ 14.4× | acordar engineer |
139
+ | Ticket | ≥ 1.0× | abrir Jira/Linear |
140
+ | Warn | budget > 80% gasto | rever cadência de deploy |
141
+
142
+ {Se status = PAGE ou TICKET:}
143
+ ## Próximos passos
144
+ 1. `/investigar-producao "{slo_name} burn rate = {burn_rate}× às {timestamp}"`
145
+ 2. (Após root cause identificada) Decidir: rollback / hotfix / mitigação parcial
146
+ 3. Atualizar runbook do SLO com lessons learned
147
+ ```
148
+
149
+ ## Quando NÃO invocar
150
+
151
+ - SLO sem materialized view — invoke `slo-engineer` primeiro
152
+ - Métrica informativa sem target — use dashboard
153
+ - Verificação ad hoc rápida — query direto via `mcp__supabase__execute_sql` se já sabe a fórmula