@luanpdd/kit-mcp 1.33.0 → 1.35.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.
- package/LICENSE +21 -21
- package/README.md +168 -168
- package/gates/agent-no-recursive-dispatch.md +84 -84
- package/kit/COMANDOS.md +138 -138
- package/kit/COMPATIBILITY.md +70 -70
- package/kit/README.md +76 -76
- package/kit/agents/advisor-researcher.md +109 -109
- package/kit/agents/ai-mutation-tester.md +289 -289
- package/kit/agents/assumptions-analyzer.md +110 -110
- package/kit/agents/audit-log-implementer.md +314 -314
- package/kit/agents/auditor-consistencia-isolamento.md +414 -414
- package/kit/agents/b2b-saas-architect.md +157 -157
- package/kit/agents/burn-rate-forecaster.md +153 -153
- package/kit/agents/cascading-failures-auditor.md +299 -299
- package/kit/agents/codebase-mapper.md +769 -769
- package/kit/agents/crm-pipeline-implementer.md +257 -257
- package/kit/agents/debugger.md +814 -814
- package/kit/agents/designer-ui.md +216 -216
- package/kit/agents/detector-tenant-quente.md +338 -338
- package/kit/agents/evolution-go-integrator.md +201 -201
- package/kit/agents/example-reviewer.md +22 -22
- package/kit/agents/executor.md +565 -565
- package/kit/agents/golden-signals-instrumenter.md +232 -232
- package/kit/agents/incident-investigator.md +238 -238
- package/kit/agents/integration-checker.md +203 -203
- package/kit/agents/invite-flow-implementer.md +190 -190
- package/kit/agents/legacy-characterizer.md +369 -369
- package/kit/agents/lgpd-compliance-auditor.md +296 -296
- package/kit/agents/load-shedding-instrumenter.md +290 -290
- package/kit/agents/multi-tenant-isolation-auditor.md +254 -254
- package/kit/agents/multi-tenant-rls-writer.md +341 -341
- package/kit/agents/nyquist-auditor.md +181 -181
- package/kit/agents/observability-coverage-auditor.md +316 -316
- package/kit/agents/observability-instrumenter.md +191 -191
- package/kit/agents/omm-auditor.md +291 -291
- package/kit/agents/org-onboarding-implementer.md +224 -224
- package/kit/agents/payload-capture-instrumenter.md +274 -274
- package/kit/agents/phase-researcher.md +697 -697
- package/kit/agents/plan-checker.md +275 -275
- package/kit/agents/planner.md +923 -923
- package/kit/agents/postmortem-writer.md +273 -273
- package/kit/agents/project-researcher.md +653 -653
- package/kit/agents/prr-conductor.md +287 -287
- package/kit/agents/refactor-safety-auditor.md +405 -405
- package/kit/agents/release-pipeline-auditor.md +364 -364
- package/kit/agents/research-synthesizer.md +246 -246
- package/kit/agents/roadmapper.md +678 -678
- package/kit/agents/schema-checker.md +160 -160
- package/kit/agents/seam-finder.md +360 -360
- package/kit/agents/shotgun-surgery-detector.md +350 -350
- package/kit/agents/slo-engineer.md +217 -217
- package/kit/agents/storytelling-analyst.md +300 -300
- package/kit/agents/supabase-architect.md +249 -249
- package/kit/agents/supabase-auth-bootstrapper.md +400 -400
- package/kit/agents/supabase-auth-hook-writer.md +418 -418
- package/kit/agents/supabase-branching-architect.md +563 -563
- package/kit/agents/supabase-cicd-pipeline-implementer.md +778 -778
- package/kit/agents/supabase-column-privileges-writer.md +400 -400
- package/kit/agents/supabase-edge-fn-tester.md +288 -288
- package/kit/agents/supabase-edge-fn-writer.md +341 -341
- package/kit/agents/supabase-mfa-implementer.md +439 -439
- package/kit/agents/supabase-migration-writer.md +386 -386
- package/kit/agents/supabase-oauth-server-implementer.md +507 -507
- package/kit/agents/supabase-rbac-implementer.md +393 -393
- package/kit/agents/supabase-realtime-implementer.md +364 -364
- package/kit/agents/supabase-rls-hardener.md +522 -522
- package/kit/agents/supabase-rls-writer.md +324 -324
- package/kit/agents/supabase-roles-implementer.md +356 -356
- package/kit/agents/supabase-social-auth-implementer.md +451 -451
- package/kit/agents/supabase-sso-saml-architect.md +549 -549
- package/kit/agents/supabase-storage-implementer.md +407 -407
- package/kit/agents/super-admin-implementer.md +282 -282
- package/kit/agents/toil-auditor.md +268 -268
- package/kit/agents/ui-auditor.md +438 -438
- package/kit/agents/ui-checker.md +305 -305
- package/kit/agents/ui-researcher.md +356 -356
- package/kit/agents/user-profiler.md +176 -176
- package/kit/agents/validador-evolucao-schema.md +336 -336
- package/kit/agents/verifier.md +729 -729
- package/kit/agents/workflow-generator.md +167 -0
- package/kit/commands/adicionar-backlog.md +75 -75
- package/kit/commands/adicionar-fase.md +42 -42
- package/kit/commands/adicionar-tarefa.md +45 -45
- package/kit/commands/adicionar-testes.md +41 -41
- package/kit/commands/ajuda.md +21 -21
- package/kit/commands/atualizar.md +37 -37
- package/kit/commands/auditar-cascading.md +111 -111
- package/kit/commands/auditar-marco.md +179 -179
- package/kit/commands/auditar-observabilidade-cobertura-workflow.md +121 -0
- package/kit/commands/auditar-observabilidade-cobertura.md +183 -183
- package/kit/commands/auditar-refactor.md +219 -219
- package/kit/commands/auditar-release.md +109 -109
- package/kit/commands/auditar-uat.md +23 -23
- package/kit/commands/autonomo.md +40 -40
- package/kit/commands/branch-pr.md +24 -24
- package/kit/commands/burn-rate-status.md +408 -408
- package/kit/commands/capturar-payloads.md +193 -193
- package/kit/commands/caracterizar.md +212 -212
- package/kit/commands/concluir-marco.md +247 -247
- package/kit/commands/configuracoes.md +36 -36
- package/kit/commands/criar-workflow.md +158 -0
- package/kit/commands/dados-distribuidos.md +188 -188
- package/kit/commands/definir-perfil.md +10 -10
- package/kit/commands/depurar.md +190 -190
- package/kit/commands/detectar-duplicacao.md +197 -197
- package/kit/commands/discutir-fase.md +131 -131
- package/kit/commands/encontrar-seams.md +136 -136
- package/kit/commands/entrar-discord.md +17 -17
- package/kit/commands/estatisticas.md +18 -18
- package/kit/commands/example-greeting.md +33 -33
- package/kit/commands/executar-fase.md +58 -58
- package/kit/commands/expresso.md +56 -56
- package/kit/commands/fase-ui.md +34 -34
- package/kit/commands/fazer.md +57 -57
- package/kit/commands/fio.md +125 -125
- package/kit/commands/fluxos-trabalho.md +64 -64
- package/kit/commands/forense.md +176 -176
- package/kit/commands/gerenciador.md +38 -38
- package/kit/commands/inserir-fase.md +31 -31
- package/kit/commands/legacy.md +263 -263
- package/kit/commands/limpeza.md +17 -17
- package/kit/commands/listar-hipoteses-fase.md +45 -45
- package/kit/commands/listar-workspaces.md +18 -18
- package/kit/commands/load-shedding.md +117 -117
- package/kit/commands/mapear-codebase.md +70 -70
- package/kit/commands/multi-tenant.md +163 -163
- package/kit/commands/nota.md +33 -33
- package/kit/commands/novo-marco.md +43 -43
- package/kit/commands/novo-projeto.md +41 -41
- package/kit/commands/novo-workspace.md +43 -43
- package/kit/commands/pausar-trabalho.md +37 -37
- package/kit/commands/perfil-usuario.md +45 -45
- package/kit/commands/pesquisar-fase.md +195 -195
- package/kit/commands/planejar-fase.md +67 -67
- package/kit/commands/planejar-lacunas.md +33 -33
- package/kit/commands/plantar-ideia.md +25 -25
- package/kit/commands/progresso.md +24 -24
- package/kit/commands/proximo.md +30 -30
- package/kit/commands/publicar.md +490 -490
- package/kit/commands/rapido.md +35 -35
- package/kit/commands/reaplicar-patches.md +124 -124
- package/kit/commands/refactor-seguro.md +321 -321
- package/kit/commands/relatorio-sessao.md +19 -19
- package/kit/commands/remover-fase.md +31 -31
- package/kit/commands/remover-workspace.md +26 -26
- package/kit/commands/resumo-marco.md +50 -50
- package/kit/commands/retomar-trabalho.md +40 -40
- package/kit/commands/revisar-backlog.md +60 -60
- package/kit/commands/revisar-ui.md +32 -32
- package/kit/commands/revisar.md +37 -37
- package/kit/commands/saude.md +21 -21
- package/kit/commands/setup-notion.md +93 -93
- package/kit/commands/storytelling.md +179 -179
- package/kit/commands/supabase.md +238 -238
- package/kit/commands/sync-main.md +68 -68
- package/kit/commands/validar-fase.md +35 -35
- package/kit/commands/verificar-tarefas.md +44 -44
- package/kit/commands/verificar-trabalho.md +64 -64
- package/kit/file-manifest.json +424 -419
- package/kit/framework/bin/lib/commands.cjs +959 -959
- package/kit/framework/bin/lib/config.cjs +442 -442
- package/kit/framework/bin/lib/core.cjs +1230 -1230
- package/kit/framework/bin/lib/frontmatter.cjs +336 -336
- package/kit/framework/bin/lib/init.cjs +1442 -1442
- package/kit/framework/bin/lib/milestone.cjs +252 -252
- package/kit/framework/bin/lib/model-profiles.cjs +68 -68
- package/kit/framework/bin/lib/phase.cjs +888 -888
- package/kit/framework/bin/lib/profile-output.cjs +952 -952
- package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
- package/kit/framework/bin/lib/roadmap.cjs +329 -329
- package/kit/framework/bin/lib/security.cjs +382 -382
- package/kit/framework/bin/lib/state.cjs +1031 -1031
- package/kit/framework/bin/lib/template.cjs +222 -222
- package/kit/framework/bin/lib/uat.cjs +282 -282
- package/kit/framework/bin/lib/verify.cjs +888 -888
- package/kit/framework/bin/lib/workstream.cjs +491 -491
- package/kit/framework/bin/tools.cjs +918 -918
- package/kit/framework/commands/workstreams.md +63 -63
- package/kit/framework/references/checkpoints.md +778 -778
- package/kit/framework/references/continuation-format.md +249 -249
- package/kit/framework/references/decimal-phase-calculation.md +64 -64
- package/kit/framework/references/git-integration.md +295 -295
- package/kit/framework/references/git-planning-commit.md +38 -38
- package/kit/framework/references/model-profile-resolution.md +36 -36
- package/kit/framework/references/model-profiles.md +139 -139
- package/kit/framework/references/phase-argument-parsing.md +61 -61
- package/kit/framework/references/planning-config.md +202 -202
- package/kit/framework/references/questioning.md +162 -162
- package/kit/framework/references/tdd.md +263 -263
- package/kit/framework/references/ui-brand.md +160 -160
- package/kit/framework/references/user-profiling.md +657 -657
- package/kit/framework/references/verification-patterns.md +612 -612
- package/kit/framework/references/workstream-flag.md +58 -58
- package/kit/framework/templates/DEBUG.md +164 -164
- package/kit/framework/templates/UAT.md +265 -265
- package/kit/framework/templates/UI-SPEC.md +100 -100
- package/kit/framework/templates/VALIDATION.md +76 -76
- package/kit/framework/templates/claude-md.md +122 -122
- package/kit/framework/templates/codebase/architecture.md +185 -185
- package/kit/framework/templates/codebase/concerns.md +205 -205
- package/kit/framework/templates/codebase/conventions.md +204 -204
- package/kit/framework/templates/codebase/integrations.md +192 -192
- package/kit/framework/templates/codebase/stack.md +158 -158
- package/kit/framework/templates/codebase/structure.md +199 -199
- package/kit/framework/templates/codebase/testing.md +301 -301
- package/kit/framework/templates/config.json +44 -44
- package/kit/framework/templates/context.md +352 -352
- package/kit/framework/templates/continue-here.md +78 -78
- package/kit/framework/templates/copilot-instructions.md +7 -7
- package/kit/framework/templates/debug-subagent-prompt.md +91 -91
- package/kit/framework/templates/dev-preferences.md +20 -20
- package/kit/framework/templates/discovery.md +146 -146
- package/kit/framework/templates/discussion-log.md +63 -63
- package/kit/framework/templates/milestone-archive.md +123 -123
- package/kit/framework/templates/milestone.md +115 -115
- package/kit/framework/templates/phase-prompt.md +610 -610
- package/kit/framework/templates/planner-subagent-prompt.md +117 -117
- package/kit/framework/templates/project.md +186 -186
- package/kit/framework/templates/requirements.md +231 -231
- package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
- package/kit/framework/templates/research-project/FEATURES.md +147 -147
- package/kit/framework/templates/research-project/PITFALLS.md +200 -200
- package/kit/framework/templates/research-project/STACK.md +120 -120
- package/kit/framework/templates/research-project/SUMMARY.md +170 -170
- package/kit/framework/templates/research.md +419 -419
- package/kit/framework/templates/retrospective.md +54 -54
- package/kit/framework/templates/roadmap.md +202 -202
- package/kit/framework/templates/state.md +176 -176
- package/kit/framework/templates/summary-complex.md +59 -59
- package/kit/framework/templates/summary-minimal.md +41 -41
- package/kit/framework/templates/summary-standard.md +48 -48
- package/kit/framework/templates/summary.md +209 -209
- package/kit/framework/templates/user-profile.md +146 -146
- package/kit/framework/templates/user-setup.md +256 -256
- package/kit/framework/templates/verification-report.md +258 -258
- package/kit/framework/workflows/add-phase.md +112 -112
- package/kit/framework/workflows/add-tests.md +351 -351
- package/kit/framework/workflows/add-todo.md +158 -158
- package/kit/framework/workflows/audit-milestone.md +340 -340
- package/kit/framework/workflows/audit-uat.md +109 -109
- package/kit/framework/workflows/autonomous.md +891 -891
- package/kit/framework/workflows/check-todos.md +177 -177
- package/kit/framework/workflows/cleanup.md +152 -152
- package/kit/framework/workflows/complete-milestone.md +696 -696
- package/kit/framework/workflows/diagnose-issues.md +231 -231
- package/kit/framework/workflows/discovery-phase.md +289 -289
- package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
- package/kit/framework/workflows/discuss-phase.md +784 -784
- package/kit/framework/workflows/do.md +104 -104
- package/kit/framework/workflows/execute-phase.md +838 -838
- package/kit/framework/workflows/execute-plan.md +510 -510
- package/kit/framework/workflows/fast.md +102 -102
- package/kit/framework/workflows/forensics.md +265 -265
- package/kit/framework/workflows/health.md +181 -181
- package/kit/framework/workflows/help.md +619 -619
- package/kit/framework/workflows/insert-phase.md +130 -130
- package/kit/framework/workflows/list-phase-assumptions.md +178 -178
- package/kit/framework/workflows/list-workspaces.md +56 -56
- package/kit/framework/workflows/manager.md +362 -362
- package/kit/framework/workflows/map-codebase.md +377 -377
- package/kit/framework/workflows/milestone-summary.md +223 -223
- package/kit/framework/workflows/new-milestone.md +486 -486
- package/kit/framework/workflows/new-project.md +1159 -1159
- package/kit/framework/workflows/new-workspace.md +237 -237
- package/kit/framework/workflows/next.md +97 -97
- package/kit/framework/workflows/node-repair.md +92 -92
- package/kit/framework/workflows/note.md +156 -156
- package/kit/framework/workflows/pause-work.md +176 -176
- package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
- package/kit/framework/workflows/plan-phase.md +765 -765
- package/kit/framework/workflows/plant-seed.md +169 -169
- package/kit/framework/workflows/pr-branch.md +129 -129
- package/kit/framework/workflows/profile-user.md +450 -450
- package/kit/framework/workflows/progress.md +507 -507
- package/kit/framework/workflows/quick.md +757 -757
- package/kit/framework/workflows/remove-phase.md +155 -155
- package/kit/framework/workflows/remove-workspace.md +90 -90
- package/kit/framework/workflows/research-phase.md +82 -82
- package/kit/framework/workflows/resume-project.md +326 -326
- package/kit/framework/workflows/review.md +228 -228
- package/kit/framework/workflows/session-report.md +146 -146
- package/kit/framework/workflows/settings.md +283 -283
- package/kit/framework/workflows/ship.md +228 -228
- package/kit/framework/workflows/stats.md +60 -60
- package/kit/framework/workflows/transition.md +671 -671
- package/kit/framework/workflows/ui-phase.md +302 -302
- package/kit/framework/workflows/ui-review.md +165 -165
- package/kit/framework/workflows/update.md +323 -323
- package/kit/framework/workflows/validate-phase.md +174 -174
- package/kit/framework/workflows/verify-phase.md +252 -252
- package/kit/framework/workflows/verify-work.md +637 -637
- package/kit/hooks/check-update.js +118 -118
- package/kit/hooks/context-monitor.js +163 -163
- package/kit/hooks/kit-attribution-reminder.cjs +92 -92
- package/kit/hooks/kit-router.cjs +137 -137
- package/kit/hooks/prompt-guard.js +103 -103
- package/kit/hooks/statusline.js +125 -125
- package/kit/hooks/workflow-guard.js +101 -101
- package/kit/settings.json +45 -45
- package/kit/skills/ai-prompt-characterization/SKILL.md +335 -335
- package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -447
- package/kit/skills/audit-log-multi-tenant/SKILL.md +340 -340
- package/kit/skills/b2b-saas-architecture/SKILL.md +300 -300
- package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -385
- package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +343 -343
- package/kit/skills/dynamic-workflow-authoring/SKILL.md +223 -0
- package/kit/skills/escolha-modelo-consistencia/SKILL.md +494 -494
- package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -448
- package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +322 -322
- package/kit/skills/example-skill/SKILL.md +42 -42
- package/kit/skills/legacy-api-only-applications/SKILL.md +358 -358
- package/kit/skills/legacy-characterization-tests/SKILL.md +330 -330
- package/kit/skills/legacy-effect-analysis/SKILL.md +331 -331
- package/kit/skills/legacy-extract-class/SKILL.md +203 -203
- package/kit/skills/legacy-programming-by-difference/SKILL.md +252 -252
- package/kit/skills/legacy-seams-and-test-harness/SKILL.md +460 -460
- package/kit/skills/legacy-shotgun-surgery/SKILL.md +286 -286
- package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +434 -434
- package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +270 -270
- package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +340 -340
- package/kit/skills/member-invite-flow/SKILL.md +305 -305
- package/kit/skills/member-management-react-shadcn/SKILL.md +328 -328
- package/kit/skills/multi-tenant-performance-scaling/SKILL.md +316 -316
- package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +342 -342
- package/kit/skills/org-onboarding-flow/SKILL.md +257 -257
- package/kit/skills/org-switcher-react-pattern/SKILL.md +349 -349
- package/kit/skills/permission-gate-react-pattern/SKILL.md +271 -271
- package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -552
- package/kit/skills/pre-refactor-characterization/SKILL.md +421 -421
- package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +338 -338
- package/kit/skills/streams-eventos-cdc/SKILL.md +711 -711
- package/kit/skills/supabase-auth-hardening/SKILL.md +674 -674
- package/kit/skills/supabase-auth-hooks/SKILL.md +875 -875
- package/kit/skills/supabase-auth-methods/SKILL.md +486 -486
- package/kit/skills/supabase-auth-sessions/SKILL.md +579 -579
- package/kit/skills/supabase-auth-ssr/SKILL.md +306 -306
- package/kit/skills/supabase-branching-workflow/SKILL.md +544 -544
- package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -880
- package/kit/skills/supabase-column-level-security/SKILL.md +426 -426
- package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -807
- package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -472
- package/kit/skills/supabase-edge-functions/SKILL.md +330 -330
- package/kit/skills/supabase-edge-functions-auth/SKILL.md +309 -309
- package/kit/skills/supabase-edge-functions-limits/SKILL.md +302 -302
- package/kit/skills/supabase-edge-functions-mcp-server/SKILL.md +279 -279
- package/kit/skills/supabase-edge-functions-testing/SKILL.md +277 -277
- package/kit/skills/supabase-edge-runtime-builtins/SKILL.md +357 -357
- package/kit/skills/supabase-enterprise-sso-saml/SKILL.md +545 -545
- package/kit/skills/supabase-jwt-signing-keys/SKILL.md +399 -399
- package/kit/skills/supabase-mfa/SKILL.md +488 -488
- package/kit/skills/supabase-migration-repair/SKILL.md +823 -823
- package/kit/skills/supabase-migrations/SKILL.md +297 -297
- package/kit/skills/supabase-oauth-server/SKILL.md +537 -537
- package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -1053
- package/kit/skills/supabase-postgres-roles/SKILL.md +392 -392
- package/kit/skills/supabase-realtime/SKILL.md +460 -460
- package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -418
- package/kit/skills/supabase-rls-policies/SKILL.md +635 -635
- package/kit/skills/supabase-social-oauth/SKILL.md +480 -480
- package/kit/skills/supabase-third-party-auth/SKILL.md +450 -450
- package/kit/skills/super-admin-platform-pattern/SKILL.md +326 -326
- package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -605
- package/kit/skills/ui-anti-padroes-ia/SKILL.md +261 -261
- package/kit/skills/ui-contexto-produto/SKILL.md +248 -248
- package/kit/skills/ui-cor-estrategia/SKILL.md +213 -213
- package/kit/skills/ui-critica-auditoria/SKILL.md +260 -260
- package/kit/skills/ui-motion-funcional/SKILL.md +264 -264
- package/kit/skills/ui-ritmo-espacial/SKILL.md +259 -259
- package/kit/skills/ui-tipografia/SKILL.md +211 -211
- package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +287 -287
- package/kit/workflows/auditar-observabilidade-cobertura.workflow.js +250 -0
- package/package.json +65 -63
- package/src/core/kit.js +333 -216
- package/src/core/reflect.js +247 -247
- package/src/core/registry.js +123 -112
- package/src/core/reverse-sync.js +448 -372
- package/src/core/sync.js +477 -437
- package/src/core/watch.js +121 -121
- package/src/mcp-server/index.js +794 -794
|
@@ -1,180 +1,180 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: auditar-marco
|
|
3
|
-
description: Audita a conclusão do milestone contra a intenção original antes de arquivar
|
|
4
|
-
argument-hint: "[version]"
|
|
5
|
-
allowed-tools:
|
|
6
|
-
- Read
|
|
7
|
-
- Glob
|
|
8
|
-
- Grep
|
|
9
|
-
- Bash
|
|
10
|
-
- Task
|
|
11
|
-
- Write
|
|
12
|
-
---
|
|
13
|
-
<objective>
|
|
14
|
-
Verificar se o milestone alcançou sua definição de pronto. Checar cobertura de requisitos, integração entre fases e fluxos de ponta a ponta.
|
|
15
|
-
|
|
16
|
-
**Este comando É o orquestrador.** Lê os arquivos VERIFICATION.md existentes (fases já verificadas durante o executar-fase), agrega dívidas técnicas e lacunas adiadas, então invoca o verificador de integração para a fiação entre fases.
|
|
17
|
-
</objective>
|
|
18
|
-
|
|
19
|
-
<execution_context>
|
|
20
|
-
@./.claude/framework/workflows/audit-milestone.md
|
|
21
|
-
</execution_context>
|
|
22
|
-
|
|
23
|
-
<context>
|
|
24
|
-
Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
|
|
25
|
-
|
|
26
|
-
Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
|
|
27
|
-
|
|
28
|
-
**Trabalho Concluído:**
|
|
29
|
-
Glob: .planning/phases/*/*-SUMMARY.md
|
|
30
|
-
Glob: .planning/phases/*/*-VERIFICATION.md
|
|
31
|
-
</context>
|
|
32
|
-
|
|
33
|
-
<process>
|
|
34
|
-
Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
|
|
35
|
-
Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
|
|
36
|
-
</process>
|
|
37
|
-
|
|
38
|
-
<observability_integration>
|
|
39
|
-
**OMM scoring (v1.9 — INT-FW-04):**
|
|
40
|
-
|
|
41
|
-
Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
|
|
42
|
-
|
|
43
|
-
```text
|
|
44
|
-
Skill(skill="framework:auditar-observabilidade")
|
|
45
|
-
```
|
|
46
|
-
|
|
47
|
-
O comando `/auditar-observabilidade` invoca o agente [`omm-auditor`](../agents/omm-auditor.md) que pontua as 5 capacidades (resiliência, qualidade, complexidade, cadência, comportamento) contra o marco anterior. O OMM-REPORT.md gerado é incluído como anexo no MILESTONE-AUDIT.md.
|
|
48
|
-
|
|
49
|
-
Resultado de regression OMM:
|
|
50
|
-
- **0 regressions:** audit aprovado
|
|
51
|
-
- **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
|
|
52
|
-
- **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
|
|
53
|
-
|
|
54
|
-
Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
|
|
55
|
-
|
|
56
|
-
**REQ:** INT-FW-04.
|
|
57
|
-
</observability_integration>
|
|
58
|
-
|
|
59
|
-
<sre_integration>
|
|
60
|
-
**Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
|
|
61
|
-
|
|
62
|
-
Quando `workflow.audit_milestone_toil = true` (default), o workflow inclui passo Toil audit auto-invocação **antes** do passo de OMM scoring (que já existe via `<observability_integration>` v1.9 — INT-FW-04):
|
|
63
|
-
|
|
64
|
-
```text
|
|
65
|
-
Skill(skill="framework:auditar-toil")
|
|
66
|
-
```
|
|
67
|
-
|
|
68
|
-
O comando `/auditar-toil` invoca o agente [toil-auditor](../agents/toil-auditor.md) que analisa `git log` recente (≤ 90 dias) + scripts shell em `scripts/` + comandos manuais documentados em README/runbooks/`.planning/runbooks/` + tarefas repetitivas em `.planning/phases/*/SUMMARY.md`. O agent classifica candidatos a automação (P0/P1/P2 por esforço × frequência) e produz `.planning/TOIL-AUDIT.md` na raiz do `.planning/`. Cap 5 do livro Google SRE (*Eliminating Toil*) define toil canonicamente: **manual + repetitivo + automatizável + tático + sem valor durável + escala linear com tráfego/team**.
|
|
69
|
-
|
|
70
|
-
**Loop fechado canônico:**
|
|
71
|
-
|
|
72
|
-
```text
|
|
73
|
-
/auditar-marco
|
|
74
|
-
↓
|
|
75
|
-
Step A: invoca /auditar-toil ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
|
|
76
|
-
↓
|
|
77
|
-
Step B: invoca /auditar-observabilidade ← OMM scoring v1.9 (INT-FW-04)
|
|
78
|
-
↓
|
|
79
|
-
omm-auditor consulta .planning/TOIL-AUDIT.md ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
|
|
80
|
-
↓
|
|
81
|
-
OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
|
|
82
|
-
↓
|
|
83
|
-
MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
|
|
84
|
-
```
|
|
85
|
-
|
|
86
|
-
**Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
|
|
87
|
-
|
|
88
|
-
O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
|
|
89
|
-
|
|
90
|
-
> "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
|
|
91
|
-
|
|
92
|
-
Se TOIL-AUDIT.md ausente ou stale (> 30d), `omm-auditor` delega geração via `Task(subagent_type=toil-auditor)` ad-hoc — duplicação. Auto-invocar `/auditar-toil` em `/auditar-marco` evita essa duplicação ao garantir que `omm-auditor` encontre TOIL-AUDIT.md fresco.
|
|
93
|
-
|
|
94
|
-
**Tabela de score Capacidade 3 (consumida por omm-auditor):**
|
|
95
|
-
|
|
96
|
-
| % toil pelo time | OMM Capacidade 3 score | Implicação |
|
|
97
|
-
|---|---|---|
|
|
98
|
-
| < 15% | 5 | Excelente — automação madura |
|
|
99
|
-
| 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
|
|
100
|
-
| 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
|
|
101
|
-
| 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
|
|
102
|
-
| > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
|
|
103
|
-
|
|
104
|
-
Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
|
|
105
|
-
|
|
106
|
-
**Output esperado:**
|
|
107
|
-
|
|
108
|
-
`.planning/TOIL-AUDIT.md` contém:
|
|
109
|
-
|
|
110
|
-
1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
|
|
111
|
-
2. Lista de candidatos a automação P0/P1/P2 com:
|
|
112
|
-
- Comando/processo manual identificado
|
|
113
|
-
- Frequência (× por sprint/mês)
|
|
114
|
-
- Esforço estimado de automação (S/M/L)
|
|
115
|
-
- ROI = Frequência × Tempo Manual / Esforço Automação
|
|
116
|
-
3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
|
|
117
|
-
4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
|
|
118
|
-
|
|
119
|
-
**Quando desligar gate:**
|
|
120
|
-
|
|
121
|
-
- Solo developer side project (toil = você mesmo, audit é overhead)
|
|
122
|
-
- Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
|
|
123
|
-
- Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
|
|
124
|
-
|
|
125
|
-
Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
|
|
126
|
-
|
|
127
|
-
**Skill consultada:** [eliminating-toil](../skills/eliminating-toil/SKILL.md) (cap 5 livro Google SRE — *Eliminating Toil* — define toil canonicamente, regra ≤ 50%, padrões de automação, distinção toil vs overhead vs grungy work).
|
|
128
|
-
|
|
129
|
-
**Anti-patterns prevenidos:**
|
|
130
|
-
|
|
131
|
-
- "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
|
|
132
|
-
- "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
|
|
133
|
-
- "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
|
|
134
|
-
- "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
|
|
135
|
-
|
|
136
|
-
**REQ:** INT-FW-V2-03.
|
|
137
|
-
</sre_integration>
|
|
138
|
-
|
|
139
|
-
<legacy_refactor_integration>
|
|
140
|
-
**Legacy refactor safety audit (opt-in):**
|
|
141
|
-
|
|
142
|
-
Quando `workflow.audit_milestone_legacy_refactor = true` (default: false em projetos < 50% OMM maturity, true acima), o workflow inclui passo de auditoria de refactor safety:
|
|
143
|
-
|
|
144
|
-
```text
|
|
145
|
-
Para cada arquivo modificado por tasks com kind=refactor no milestone:
|
|
146
|
-
Task(
|
|
147
|
-
subagent_type="refactor-safety-auditor",
|
|
148
|
-
prompt="
|
|
149
|
-
target_file: <file>
|
|
150
|
-
change_kind: refactor
|
|
151
|
-
mode: blocking
|
|
152
|
-
output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
|
|
153
|
-
|
|
154
|
-
Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
|
|
155
|
-
"
|
|
156
|
-
)
|
|
157
|
-
```
|
|
158
|
-
|
|
159
|
-
**Critérios de aprovação:**
|
|
160
|
-
- Cada refactor de risco no milestone tem characterization tests linkados E pass verde
|
|
161
|
-
- Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
|
|
162
|
-
- Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
|
|
163
|
-
|
|
164
|
-
**Resultado de regression:**
|
|
165
|
-
- 0 refactors sem char → audit aprovado
|
|
166
|
-
- 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
|
|
167
|
-
- 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
|
|
168
|
-
|
|
169
|
-
Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
|
|
170
|
-
Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
|
|
171
|
-
|
|
172
|
-
**Quando desligar gate:**
|
|
173
|
-
- Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
|
|
174
|
-
- Solo dev side project sem stakes de produção (audit é overhead)
|
|
175
|
-
- Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
|
|
176
|
-
|
|
177
|
-
Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
|
|
178
|
-
|
|
179
|
-
**REQ:** INT-LEGACY-FW-01.
|
|
1
|
+
---
|
|
2
|
+
name: auditar-marco
|
|
3
|
+
description: Audita a conclusão do milestone contra a intenção original antes de arquivar
|
|
4
|
+
argument-hint: "[version]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Glob
|
|
8
|
+
- Grep
|
|
9
|
+
- Bash
|
|
10
|
+
- Task
|
|
11
|
+
- Write
|
|
12
|
+
---
|
|
13
|
+
<objective>
|
|
14
|
+
Verificar se o milestone alcançou sua definição de pronto. Checar cobertura de requisitos, integração entre fases e fluxos de ponta a ponta.
|
|
15
|
+
|
|
16
|
+
**Este comando É o orquestrador.** Lê os arquivos VERIFICATION.md existentes (fases já verificadas durante o executar-fase), agrega dívidas técnicas e lacunas adiadas, então invoca o verificador de integração para a fiação entre fases.
|
|
17
|
+
</objective>
|
|
18
|
+
|
|
19
|
+
<execution_context>
|
|
20
|
+
@./.claude/framework/workflows/audit-milestone.md
|
|
21
|
+
</execution_context>
|
|
22
|
+
|
|
23
|
+
<context>
|
|
24
|
+
Versão: $ARGUMENTS (opcional — padrão para o milestone atual)
|
|
25
|
+
|
|
26
|
+
Arquivos principais de planejamento são resolvidos no workflow (`init milestone-op`) e carregados apenas quando necessário.
|
|
27
|
+
|
|
28
|
+
**Trabalho Concluído:**
|
|
29
|
+
Glob: .planning/phases/*/*-SUMMARY.md
|
|
30
|
+
Glob: .planning/phases/*/*-VERIFICATION.md
|
|
31
|
+
</context>
|
|
32
|
+
|
|
33
|
+
<process>
|
|
34
|
+
Execute o workflow audit-milestone de @./.claude/framework/workflows/audit-milestone.md do início ao fim.
|
|
35
|
+
Preserve todos os checkpoints do workflow (determinação de escopo, leitura de verificações, checagem de integração, cobertura de requisitos, roteamento).
|
|
36
|
+
</process>
|
|
37
|
+
|
|
38
|
+
<observability_integration>
|
|
39
|
+
**OMM scoring (v1.9 — INT-FW-04):**
|
|
40
|
+
|
|
41
|
+
Quando `workflow.audit_milestone_omm = true` (default), o workflow inclui passo OMM scoring:
|
|
42
|
+
|
|
43
|
+
```text
|
|
44
|
+
Skill(skill="framework:auditar-observabilidade")
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
O comando `/auditar-observabilidade` invoca o agente [`omm-auditor`](../agents/omm-auditor.md) que pontua as 5 capacidades (resiliência, qualidade, complexidade, cadência, comportamento) contra o marco anterior. O OMM-REPORT.md gerado é incluído como anexo no MILESTONE-AUDIT.md.
|
|
48
|
+
|
|
49
|
+
Resultado de regression OMM:
|
|
50
|
+
- **0 regressions:** audit aprovado
|
|
51
|
+
- **1+ regressions, blocking=false:** warn explícito; audit aprovado com nota
|
|
52
|
+
- **1+ regressions, blocking=true (`workflow.omm_no_regression=true`):** audit fail → user escolha entre fix lacunas ou aceitar
|
|
53
|
+
|
|
54
|
+
Skill consultada: [`observability-maturity-model`](../skills/observability-maturity-model/SKILL.md).
|
|
55
|
+
|
|
56
|
+
**REQ:** INT-FW-04.
|
|
57
|
+
</observability_integration>
|
|
58
|
+
|
|
59
|
+
<sre_integration>
|
|
60
|
+
**Toil scoring auto-invocação (v1.10 — INT-FW-V2-03):**
|
|
61
|
+
|
|
62
|
+
Quando `workflow.audit_milestone_toil = true` (default), o workflow inclui passo Toil audit auto-invocação **antes** do passo de OMM scoring (que já existe via `<observability_integration>` v1.9 — INT-FW-04):
|
|
63
|
+
|
|
64
|
+
```text
|
|
65
|
+
Skill(skill="framework:auditar-toil")
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
O comando `/auditar-toil` invoca o agente [toil-auditor](../agents/toil-auditor.md) que analisa `git log` recente (≤ 90 dias) + scripts shell em `scripts/` + comandos manuais documentados em README/runbooks/`.planning/runbooks/` + tarefas repetitivas em `.planning/phases/*/SUMMARY.md`. O agent classifica candidatos a automação (P0/P1/P2 por esforço × frequência) e produz `.planning/TOIL-AUDIT.md` na raiz do `.planning/`. Cap 5 do livro Google SRE (*Eliminating Toil*) define toil canonicamente: **manual + repetitivo + automatizável + tático + sem valor durável + escala linear com tráfego/team**.
|
|
69
|
+
|
|
70
|
+
**Loop fechado canônico:**
|
|
71
|
+
|
|
72
|
+
```text
|
|
73
|
+
/auditar-marco
|
|
74
|
+
↓
|
|
75
|
+
Step A: invoca /auditar-toil ← gera .planning/TOIL-AUDIT.md (este patch — INT-FW-V2-03)
|
|
76
|
+
↓
|
|
77
|
+
Step B: invoca /auditar-observabilidade ← OMM scoring v1.9 (INT-FW-04)
|
|
78
|
+
↓
|
|
79
|
+
omm-auditor consulta .planning/TOIL-AUDIT.md ← Capacidade 3 — Complexidade / Tech Debt (Phase 39 INT-OBS-02)
|
|
80
|
+
↓
|
|
81
|
+
OMM-REPORT.md inclui Capacidade 3 score derivado de % toil pelo time
|
|
82
|
+
↓
|
|
83
|
+
MILESTONE-AUDIT.md inclui OMM-REPORT.md + TOIL-AUDIT.md como anexos
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
**Por que rodar `/auditar-toil` ANTES de `/auditar-observabilidade`:**
|
|
87
|
+
|
|
88
|
+
O agent `omm-auditor` (Capacidade 3 patcheada em Phase 39 / INT-OBS-02) tem regra absoluta:
|
|
89
|
+
|
|
90
|
+
> "score Capacidade 3 > 3 exige TOIL-AUDIT.md fresco ≤ 30 dias com `% toil < 30%`"
|
|
91
|
+
|
|
92
|
+
Se TOIL-AUDIT.md ausente ou stale (> 30d), `omm-auditor` delega geração via `Task(subagent_type=toil-auditor)` ad-hoc — duplicação. Auto-invocar `/auditar-toil` em `/auditar-marco` evita essa duplicação ao garantir que `omm-auditor` encontre TOIL-AUDIT.md fresco.
|
|
93
|
+
|
|
94
|
+
**Tabela de score Capacidade 3 (consumida por omm-auditor):**
|
|
95
|
+
|
|
96
|
+
| % toil pelo time | OMM Capacidade 3 score | Implicação |
|
|
97
|
+
|---|---|---|
|
|
98
|
+
| < 15% | 5 | Excelente — automação madura |
|
|
99
|
+
| 15-30% | 4 | Bom — abaixo regra ≤ 50% cap 5 com folga |
|
|
100
|
+
| 30-50% | 3 | Aceitável — no limite (regra ≤ 50%) |
|
|
101
|
+
| 50-60% | 2 | Risco — acima limite cap 5; team queimando ciclos em toil |
|
|
102
|
+
| > 60% | 1 | Crítico — toil-driven team; scaling linear vai quebrar |
|
|
103
|
+
|
|
104
|
+
Cross-ref ativo: tabela acima é replicada em [omm-auditor](../agents/omm-auditor.md) (Step 1 — patcheado em Phase 39 / INT-OBS-02).
|
|
105
|
+
|
|
106
|
+
**Output esperado:**
|
|
107
|
+
|
|
108
|
+
`.planning/TOIL-AUDIT.md` contém:
|
|
109
|
+
|
|
110
|
+
1. % toil pelo time (estimado a partir de git log + scripts shell + runbooks manuais documentados)
|
|
111
|
+
2. Lista de candidatos a automação P0/P1/P2 com:
|
|
112
|
+
- Comando/processo manual identificado
|
|
113
|
+
- Frequência (× por sprint/mês)
|
|
114
|
+
- Esforço estimado de automação (S/M/L)
|
|
115
|
+
- ROI = Frequência × Tempo Manual / Esforço Automação
|
|
116
|
+
3. Sugestões de automação concretas (pg_cron job, hook PostToolUse, kit-mcp command, GitHub Action)
|
|
117
|
+
4. Anti-toil-by-design: action items para `/discutir-fase` capturar toil prevenção upfront em fases futuras
|
|
118
|
+
|
|
119
|
+
**Quando desligar gate:**
|
|
120
|
+
|
|
121
|
+
- Solo developer side project (toil = você mesmo, audit é overhead)
|
|
122
|
+
- Projeto ≤ 30 dias (sem volume git suficiente para detectar padrões repetitivos)
|
|
123
|
+
- Repo somente bibliotecário sem ops (kit-mcp content-only sem deploy)
|
|
124
|
+
|
|
125
|
+
Para esses casos: `workflow.audit_milestone_toil = false`. Para projetos team-based com ops/deploy, **manter `true`**.
|
|
126
|
+
|
|
127
|
+
**Skill consultada:** [eliminating-toil](../skills/eliminating-toil/SKILL.md) (cap 5 livro Google SRE — *Eliminating Toil* — define toil canonicamente, regra ≤ 50%, padrões de automação, distinção toil vs overhead vs grungy work).
|
|
128
|
+
|
|
129
|
+
**Anti-patterns prevenidos:**
|
|
130
|
+
|
|
131
|
+
- "Skipar audit toil porque está OK há tempo" → trabalho cresce, toil cresce com ele; audit obrigatório por milestone
|
|
132
|
+
- "TOIL-AUDIT.md gerado mas ignorado" → omm-auditor Capacidade 3 consome o arquivo; ignorar o relatório = score Cap 3 deteriora visivelmente
|
|
133
|
+
- "Toil = features pequenas" → toil é manual + repetitivo + automatizável (ortogonal a tamanho); 5min × 50× por sprint = 4h por sprint
|
|
134
|
+
- "Toil ≠ overhead" → overhead inclui meetings, planning, code review (necessário, não automatizável); toil é só o automatizable
|
|
135
|
+
|
|
136
|
+
**REQ:** INT-FW-V2-03.
|
|
137
|
+
</sre_integration>
|
|
138
|
+
|
|
139
|
+
<legacy_refactor_integration>
|
|
140
|
+
**Legacy refactor safety audit (opt-in):**
|
|
141
|
+
|
|
142
|
+
Quando `workflow.audit_milestone_legacy_refactor = true` (default: false em projetos < 50% OMM maturity, true acima), o workflow inclui passo de auditoria de refactor safety:
|
|
143
|
+
|
|
144
|
+
```text
|
|
145
|
+
Para cada arquivo modificado por tasks com kind=refactor no milestone:
|
|
146
|
+
Task(
|
|
147
|
+
subagent_type="refactor-safety-auditor",
|
|
148
|
+
prompt="
|
|
149
|
+
target_file: <file>
|
|
150
|
+
change_kind: refactor
|
|
151
|
+
mode: blocking
|
|
152
|
+
output_path: .planning/REFACTOR-SAFETY-<file_stem>.md
|
|
153
|
+
|
|
154
|
+
Aplicar skill pre-refactor-characterization. Validar retroativamente que safety net foi aplicado.
|
|
155
|
+
"
|
|
156
|
+
)
|
|
157
|
+
```
|
|
158
|
+
|
|
159
|
+
**Critérios de aprovação:**
|
|
160
|
+
- Cada refactor de risco no milestone tem characterization tests linkados E pass verde
|
|
161
|
+
- Cada `--mode=override` tem ticket linkado válido (ainda aberto OR resolvido com follow-up)
|
|
162
|
+
- Mutation kill score ≥ 70% nos arquivos refatorados (warning se line cov OK mas mutation baixo)
|
|
163
|
+
|
|
164
|
+
**Resultado de regression:**
|
|
165
|
+
- 0 refactors sem char → audit aprovado
|
|
166
|
+
- 1+ refactors sem char e sem override → audit fail; bloqueia close de milestone até resolução
|
|
167
|
+
- 1+ overrides com tickets ainda abertos > 90 dias → warning explícito (débito técnico envelhecido)
|
|
168
|
+
|
|
169
|
+
Skill canônica: [`pre-refactor-characterization`](../skills/pre-refactor-characterization/SKILL.md)
|
|
170
|
+
Cross-ref ativo: `omm-auditor` Capacidade 1 (Resilience) score consulta REFACTOR-SAFETY summaries para fator "% refactors com safety net"; baixa adequação reduz score.
|
|
171
|
+
|
|
172
|
+
**Quando desligar gate:**
|
|
173
|
+
- Projeto greenfield com < 3 meses de idade (legacy code não existe ainda)
|
|
174
|
+
- Solo dev side project sem stakes de produção (audit é overhead)
|
|
175
|
+
- Toda codebase é < 50% código não-trivial (a maior parte é config/markdown/tests)
|
|
176
|
+
|
|
177
|
+
Para esses casos: `workflow.audit_milestone_legacy_refactor = false`. Para projetos com stakes de produção e equipe ≥ 2 pessoas, **manter `true`**.
|
|
178
|
+
|
|
179
|
+
**REQ:** INT-LEGACY-FW-01.
|
|
180
180
|
</legacy_refactor_integration>
|
|
@@ -0,0 +1,121 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: auditar-observabilidade-cobertura-workflow
|
|
3
|
+
description: Variante Dynamic Workflows do audit de cobertura — 1 agent por Edge Function em paralelo + verify adversarial por gap. PoC para comparar contra /auditar-observabilidade-cobertura.
|
|
4
|
+
argument-hint: "[--traffic-window 30d] [--top-n 5] [--dimensions signals,slo,burn-alert,characterization] [--output PATH]"
|
|
5
|
+
allowed-tools:
|
|
6
|
+
- Read
|
|
7
|
+
- Bash
|
|
8
|
+
- Grep
|
|
9
|
+
- Glob
|
|
10
|
+
- Write
|
|
11
|
+
- Workflow
|
|
12
|
+
- mcp__supabase__list_edge_functions
|
|
13
|
+
- mcp__supabase__get_logs
|
|
14
|
+
- mcp__supabase__execute_sql
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
# auditar-observabilidade-cobertura-workflow
|
|
18
|
+
|
|
19
|
+
> **PoC — Dynamic Workflows (Opus 4.8+).** Mesma intenção do [`/auditar-observabilidade-cobertura`](./auditar-observabilidade-cobertura.md) mas executa em paralelo via `Workflow()`: 1 agent por Edge Function auditando as 4 dimensões + verify adversarial só nos gaps reportados + synthesizer final.
|
|
20
|
+
|
|
21
|
+
> Use este comando para **comparar** wall-clock e qualidade do report contra a versão serial.
|
|
22
|
+
|
|
23
|
+
<objective>
|
|
24
|
+
Roda o script `auditar-observabilidade-cobertura.workflow.js` registrado em `.claude/workflows/`, que faz fan-out por função e remove a barreira do agent monolítico.
|
|
25
|
+
|
|
26
|
+
**Por que existe (PoC):**
|
|
27
|
+
- A versão serial encadeia N funções × 4 dimensões em UM agent — context grows linearly, foco se perde a partir de ~30 funções.
|
|
28
|
+
- Esta versão tem 1 contexto por função (audit pequeno, foco preservado) + verify só onde houve gap (cost-controlled).
|
|
29
|
+
- Cross-suite (v1.9 + v1.10 + v1.12) intacto — só a topologia muda.
|
|
30
|
+
|
|
31
|
+
**Output:** mesmo `.planning/OBSERVABILITY-COVERAGE.md` da versão serial (mesma estrutura), permitindo `diff` direto.
|
|
32
|
+
</objective>
|
|
33
|
+
|
|
34
|
+
<context>
|
|
35
|
+
**Argumentos (idênticos ao command original):**
|
|
36
|
+
- `--traffic-window 30d` (default `30d`)
|
|
37
|
+
- `--top-n 5` (default `5`)
|
|
38
|
+
- `--dimensions signals,slo,burn-alert,characterization` (default todos)
|
|
39
|
+
- `--output PATH` (default `.planning/OBSERVABILITY-COVERAGE.md` — use `.planning/OBSERVABILITY-COVERAGE-WORKFLOW.md` para A/B)
|
|
40
|
+
|
|
41
|
+
**Pré-requisitos:**
|
|
42
|
+
- Claude Code Max / Team / Enterprise (Dynamic Workflows em research preview)
|
|
43
|
+
- `Workflow` tool habilitada na sessão
|
|
44
|
+
- Resto idêntico ao command original (projeto Supabase + MCP recomendado)
|
|
45
|
+
|
|
46
|
+
**Quando usar PoC ao invés do original:**
|
|
47
|
+
- Você tem ≥ 10 Edge Functions e quer medir ganho real
|
|
48
|
+
- Você está validando se Dynamic Workflows cabe no kit-mcp antes de migrar outros orquestradores
|
|
49
|
+
- Auditoria pesada que hoje toma > 10min na versão serial
|
|
50
|
+
</context>
|
|
51
|
+
|
|
52
|
+
<process>
|
|
53
|
+
|
|
54
|
+
## 1. Parsear argumentos
|
|
55
|
+
|
|
56
|
+
```bash
|
|
57
|
+
TRAFFIC_WINDOW=$(echo "$ARGUMENTS" | grep -oE -- '--traffic-window [^ ]+' | awk '{print $2}')
|
|
58
|
+
TOP_N=$(echo "$ARGUMENTS" | grep -oE -- '--top-n [0-9]+' | awk '{print $2}')
|
|
59
|
+
DIMENSIONS=$(echo "$ARGUMENTS" | grep -oE -- '--dimensions [^ ]+' | awk '{print $2}')
|
|
60
|
+
OUTPUT_PATH=$(echo "$ARGUMENTS" | grep -oE -- '--output [^ ]+' | awk '{print $2}')
|
|
61
|
+
|
|
62
|
+
[ -z "$TRAFFIC_WINDOW" ] && TRAFFIC_WINDOW="30d"
|
|
63
|
+
[ -z "$TOP_N" ] && TOP_N=5
|
|
64
|
+
[ -z "$DIMENSIONS" ] && DIMENSIONS="signals,slo,burn-alert,characterization"
|
|
65
|
+
[ -z "$OUTPUT_PATH" ] && OUTPUT_PATH=".planning/OBSERVABILITY-COVERAGE.md"
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
## 2. Disparar o Workflow
|
|
69
|
+
|
|
70
|
+
```text
|
|
71
|
+
Workflow(
|
|
72
|
+
name: "auditar-observabilidade-cobertura",
|
|
73
|
+
args: {
|
|
74
|
+
projectRoot: ".",
|
|
75
|
+
trafficWindow: "${TRAFFIC_WINDOW}",
|
|
76
|
+
topN: ${TOP_N},
|
|
77
|
+
dimensions: ["${DIMENSIONS//,/\",\"}"],
|
|
78
|
+
outputPath: "${OUTPUT_PATH}"
|
|
79
|
+
}
|
|
80
|
+
)
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
Acompanhe o progresso ao vivo em `/workflows` (CLI/Desktop/VS Code). Cada Edge Function aparece como um chip no phase `Audit`; gaps reais entram em `Verify`.
|
|
84
|
+
|
|
85
|
+
## 3. Pós-output
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
═══════════════════════════════════════════════════════════
|
|
89
|
+
framework ► AUDITAR-OBSERVABILIDADE-COBERTURA-WORKFLOW
|
|
90
|
+
═══════════════════════════════════════════════════════════
|
|
91
|
+
|
|
92
|
+
Status: <GREEN|YELLOW|RED>
|
|
93
|
+
Total functions: <N>
|
|
94
|
+
Tier: <full|partial>
|
|
95
|
+
Output: ${OUTPUT_PATH}
|
|
96
|
+
|
|
97
|
+
Cobertura por dimensão:
|
|
98
|
+
4 Signals: <X>/<N>
|
|
99
|
+
SLO: <Y>/<N>
|
|
100
|
+
Burn alert: <Z>/<N>
|
|
101
|
+
Char tests: <W>/<N>
|
|
102
|
+
|
|
103
|
+
Top ${TOP_N} críticas: [resumo do workflow]
|
|
104
|
+
|
|
105
|
+
──────────────────────────────────────────────────────────
|
|
106
|
+
A/B vs versão serial:
|
|
107
|
+
- Para comparar, rode também /auditar-observabilidade-cobertura --output .planning/OBSERVABILITY-COVERAGE-SERIAL.md
|
|
108
|
+
- Diff: diff .planning/OBSERVABILITY-COVERAGE.md .planning/OBSERVABILITY-COVERAGE-SERIAL.md
|
|
109
|
+
- Wall-clock: /workflows mostra duração total; cronometre a serial manualmente
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
</process>
|
|
113
|
+
|
|
114
|
+
<success_criteria>
|
|
115
|
+
- [ ] $ARGUMENTS parseados (defaults idênticos ao command original)
|
|
116
|
+
- [ ] `Workflow(name: "auditar-observabilidade-cobertura", args: ...)` invocado
|
|
117
|
+
- [ ] Output em `${OUTPUT_PATH}` com mesma estrutura do command original
|
|
118
|
+
- [ ] Tabela X/N + top-N críticas + recomendações priorizadas
|
|
119
|
+
- [ ] Verify adversarial reportado (quantos gaps confirmados vs refutados)
|
|
120
|
+
- [ ] Instruções de A/B contra versão serial inclusas no pós-output
|
|
121
|
+
</success_criteria>
|