@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,44 +1,44 @@
1
- ---
2
- name: novo-workspace
3
- description: Cria um workspace isolado com cópias de repos e .planning/ independente
4
- argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Write
9
- - AskUserQuestion
10
- ---
11
- <context>
12
- **Flags:**
13
- - `--name` (obrigatório) — Nome do workspace
14
- - `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
15
- - `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
16
- - `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
17
- - `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
18
- - `--auto` — Pular perguntas interativas, usar padrões
19
- </context>
20
-
21
- <objective>
22
- Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
23
-
24
- **Casos de uso:**
25
- - Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
26
- - Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
27
-
28
- **Cria:**
29
- - `<path>/WORKSPACE.md` — manifesto do workspace
30
- - `<path>/.planning/` — diretório de planejamento independente
31
- - `<path>/<repo>/` — git worktree ou clone para cada repo especificado
32
-
33
- **Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
34
- </objective>
35
-
36
- <execution_context>
37
- @./.claude/framework/workflows/new-workspace.md
38
- @./.claude/framework/references/ui-brand.md
39
- </execution_context>
40
-
41
- <process>
42
- Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
43
- Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
1
+ ---
2
+ name: novo-workspace
3
+ description: Cria um workspace isolado com cópias de repos e .planning/ independente
4
+ argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Write
9
+ - AskUserQuestion
10
+ ---
11
+ <context>
12
+ **Flags:**
13
+ - `--name` (obrigatório) — Nome do workspace
14
+ - `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
15
+ - `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
16
+ - `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
17
+ - `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
18
+ - `--auto` — Pular perguntas interativas, usar padrões
19
+ </context>
20
+
21
+ <objective>
22
+ Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
23
+
24
+ **Casos de uso:**
25
+ - Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
26
+ - Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
27
+
28
+ **Cria:**
29
+ - `<path>/WORKSPACE.md` — manifesto do workspace
30
+ - `<path>/.planning/` — diretório de planejamento independente
31
+ - `<path>/<repo>/` — git worktree ou clone para cada repo especificado
32
+
33
+ **Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
34
+ </objective>
35
+
36
+ <execution_context>
37
+ @./.claude/framework/workflows/new-workspace.md
38
+ @./.claude/framework/references/ui-brand.md
39
+ </execution_context>
40
+
41
+ <process>
42
+ Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
43
+ Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
44
44
  </process>
@@ -1,38 +1,38 @@
1
- ---
2
- name: pausar-trabalho
3
- description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Bash
8
- ---
9
-
10
- <objective>
11
- Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
12
-
13
- Encaminha para o workflow pause-work que cuida de:
14
- - Detecção da fase atual a partir de arquivos recentes
15
- - Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
16
- - Criação do arquivo de handoff com todas as seções de contexto
17
- - Commit git como WIP
18
- - Instruções de retomada
19
- </objective>
20
-
21
- <execution_context>
22
- @./.claude/framework/workflows/pause-work.md
23
- </execution_context>
24
-
25
- <context>
26
- Estado e progresso da fase são coletados no workflow com leituras específicas.
27
- </context>
28
-
29
- <process>
30
- **Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
31
-
32
- O workflow cuida de toda a lógica, incluindo:
33
- 1. Detecção do diretório de fase
34
- 2. Coleta de estado com esclarecimentos do usuário
35
- 3. Escrita do arquivo de handoff com timestamp
36
- 4. Commit git
37
- 5. Confirmação com instruções de retomada
1
+ ---
2
+ name: pausar-trabalho
3
+ description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
4
+ allowed-tools:
5
+ - Read
6
+ - Write
7
+ - Bash
8
+ ---
9
+
10
+ <objective>
11
+ Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
12
+
13
+ Encaminha para o workflow pause-work que cuida de:
14
+ - Detecção da fase atual a partir de arquivos recentes
15
+ - Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
16
+ - Criação do arquivo de handoff com todas as seções de contexto
17
+ - Commit git como WIP
18
+ - Instruções de retomada
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @./.claude/framework/workflows/pause-work.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ Estado e progresso da fase são coletados no workflow com leituras específicas.
27
+ </context>
28
+
29
+ <process>
30
+ **Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
31
+
32
+ O workflow cuida de toda a lógica, incluindo:
33
+ 1. Detecção do diretório de fase
34
+ 2. Coleta de estado com esclarecimentos do usuário
35
+ 3. Escrita do arquivo de handoff com timestamp
36
+ 4. Commit git
37
+ 5. Confirmação com instruções de retomada
38
38
  </process>
@@ -1,46 +1,46 @@
1
- ---
2
- name: perfil-usuario
3
- description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
4
- argument-hint: "[--questionnaire] [--refresh]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - AskUserQuestion
12
- - Task
13
- ---
14
-
15
- <objective>
16
- Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
17
-
18
- Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
19
- </objective>
20
-
21
- <execution_context>
22
- @./.claude/framework/workflows/profile-user.md
23
- @./.claude/framework/references/ui-brand.md
24
- </execution_context>
25
-
26
- <context>
27
- Flags de $ARGUMENTS:
28
- - `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
29
- - `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
30
- </context>
31
-
32
- <process>
33
- Execute o workflow profile-user do início ao fim.
34
-
35
- O workflow cuida de toda a lógica, incluindo:
36
- 1. Inicialização e detecção de perfil existente
37
- 2. Gate de consentimento antes da análise de sessão
38
- 3. Escaneamento de sessão e verificações de suficiência de dados
39
- 4. Análise de sessão (agente profiler) ou fallback de questionário
40
- 5. Resolução de divisão entre projetos
41
- 6. Escrita do perfil em USER-PROFILE.md
42
- 7. Exibição de resultado com card de relatório e destaques
43
- 8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
44
- 9. Geração sequencial de artefatos
45
- 10. Resumo com diff de atualização (se aplicável)
1
+ ---
2
+ name: perfil-usuario
3
+ description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
4
+ argument-hint: "[--questionnaire] [--refresh]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - AskUserQuestion
12
+ - Task
13
+ ---
14
+
15
+ <objective>
16
+ Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
17
+
18
+ Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @./.claude/framework/workflows/profile-user.md
23
+ @./.claude/framework/references/ui-brand.md
24
+ </execution_context>
25
+
26
+ <context>
27
+ Flags de $ARGUMENTS:
28
+ - `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
29
+ - `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
30
+ </context>
31
+
32
+ <process>
33
+ Execute o workflow profile-user do início ao fim.
34
+
35
+ O workflow cuida de toda a lógica, incluindo:
36
+ 1. Inicialização e detecção de perfil existente
37
+ 2. Gate de consentimento antes da análise de sessão
38
+ 3. Escaneamento de sessão e verificações de suficiência de dados
39
+ 4. Análise de sessão (agente profiler) ou fallback de questionário
40
+ 5. Resolução de divisão entre projetos
41
+ 6. Escrita do perfil em USER-PROFILE.md
42
+ 7. Exibição de resultado com card de relatório e destaques
43
+ 8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
44
+ 9. Geração sequencial de artefatos
45
+ 10. Resumo com diff de atualização (se aplicável)
46
46
  </process>
@@ -1,195 +1,195 @@
1
- ---
2
- name: pesquisar-fase
3
- description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
4
- argument-hint: "[fase]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Task
9
- ---
10
-
11
- <objective>
12
- Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
13
-
14
- **Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
15
-
16
- **Use este comando quando:**
17
- - Você quer pesquisar sem planejar ainda
18
- - Você quer re-pesquisar após o planejamento estar completo
19
- - Você precisa investigar antes de decidir se uma fase é viável
20
-
21
- **Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
22
-
23
- **Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
24
- </objective>
25
-
26
- <available_agent_types>
27
- Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
28
- - phase-researcher — Pesquisa abordagens técnicas para uma fase
29
- </available_agent_types>
30
-
31
- <context>
32
- Número da fase: $ARGUMENTS (obrigatório)
33
-
34
- Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
35
- </context>
36
-
37
- <process>
38
-
39
- ## 0. Inicializar Contexto
40
-
41
- ```bash
42
- INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
43
- if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
44
- ```
45
-
46
- Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
47
-
48
- Resolver modelo do pesquisador:
49
- ```bash
50
- RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
51
- ```
52
-
53
- ## 1. Validar Fase
54
-
55
- ```bash
56
- PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
57
- ```
58
-
59
- **Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
60
-
61
- ## 2. Verificar Pesquisa Existente
62
-
63
- ```bash
64
- ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
65
- ```
66
-
67
- **Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
68
-
69
- **Se não existir:** Continuar.
70
-
71
- ## 3. Reunir Contexto da Fase
72
-
73
- Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
74
- - `requirements_path`
75
- - `context_path`
76
- - `state_path`
77
-
78
- Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
79
-
80
- ## 4. Invocar Agente phase-researcher
81
-
82
- Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
83
-
84
- ```markdown
85
- <research_type>
86
- Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
87
- </research_type>
88
-
89
- <key_insight>
90
- A questão NÃO é "qual biblioteca devo usar?"
91
-
92
- A questão é: "O que eu não sei que não sei?"
93
-
94
- Para esta fase, descobrir:
95
- - Qual é o padrão de arquitetura estabelecido?
96
- - Quais bibliotecas formam o stack padrão?
97
- - Quais problemas as pessoas comumente encontram?
98
- - Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
99
- - O que NÃO deve ser feito manualmente?
100
- </key_insight>
101
-
102
- <objective>
103
- Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
104
- Modo: ecosystem
105
- </objective>
106
-
107
- <files_to_read>
108
- - {requirements_path} (Requisitos)
109
- - {context_path} (Contexto da fase do discutir-fase, se existir)
110
- - {state_path} (Decisões e bloqueadores anteriores do projeto)
111
- </files_to_read>
112
-
113
- <additional_context>
114
- **Descrição da fase:** {phase_description}
115
- </additional_context>
116
-
117
- <downstream_consumer>
118
- Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
119
- - `## Standard Stack` → Planos usam essas bibliotecas
120
- - `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
121
- - `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
122
- - `## Common Pitfalls` → Etapas de verificação checam por esses problemas
123
- - `## Code Examples` → Ações de tarefas referenciam esses padrões
124
-
125
- Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
126
- </downstream_consumer>
127
-
128
- <quality_gate>
129
- Antes de declarar completo, verificar:
130
- - [ ] Todos os domínios investigados (não apenas alguns)
131
- - [ ] Afirmações negativas verificadas com documentação oficial
132
- - [ ] Múltiplas fontes para afirmações críticas
133
- - [ ] Níveis de confiança atribuídos honestamente
134
- - [ ] Nomes de seções correspondem ao que o planejar-fase espera
135
- </quality_gate>
136
-
137
- <output>
138
- Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
139
- </output>
140
- ```
141
-
142
- ```
143
- Task(
144
- prompt=filled_prompt,
145
- subagent_type="phase-researcher",
146
- model="{researcher_model}",
147
- description="Pesquisar Fase {phase}"
148
- )
149
- ```
150
-
151
- ## 5. Tratar Retorno do Agente
152
-
153
- **`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
154
-
155
- **`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
156
-
157
- **`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
158
-
159
- ## 6. Invocar Agente de Continuação
160
-
161
- ```markdown
162
- <objective>
163
- Continuar pesquisa para Fase {phase_number}: {phase_name}
164
- </objective>
165
-
166
- <prior_state>
167
- <files_to_read>
168
- - .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
169
- </files_to_read>
170
- </prior_state>
171
-
172
- <checkpoint_response>
173
- **Tipo:** {checkpoint_type}
174
- **Resposta:** {user_response}
175
- </checkpoint_response>
176
- ```
177
-
178
- ```
179
- Task(
180
- prompt=continuation_prompt,
181
- subagent_type="phase-researcher",
182
- model="{researcher_model}",
183
- description="Continuar pesquisa Fase {phase}"
184
- )
185
- ```
186
-
187
- </process>
188
-
189
- <success_criteria>
190
- - [ ] Fase validada contra o roadmap
191
- - [ ] Pesquisa existente verificada
192
- - [ ] phase-researcher invocado com contexto
193
- - [ ] Checkpoints tratados corretamente
194
- - [ ] Usuário sabe os próximos passos
195
- </success_criteria>
1
+ ---
2
+ name: pesquisar-fase
3
+ description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
4
+ argument-hint: "[fase]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Task
9
+ ---
10
+
11
+ <objective>
12
+ Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
13
+
14
+ **Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
15
+
16
+ **Use este comando quando:**
17
+ - Você quer pesquisar sem planejar ainda
18
+ - Você quer re-pesquisar após o planejamento estar completo
19
+ - Você precisa investigar antes de decidir se uma fase é viável
20
+
21
+ **Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
22
+
23
+ **Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
24
+ </objective>
25
+
26
+ <available_agent_types>
27
+ Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
28
+ - phase-researcher — Pesquisa abordagens técnicas para uma fase
29
+ </available_agent_types>
30
+
31
+ <context>
32
+ Número da fase: $ARGUMENTS (obrigatório)
33
+
34
+ Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
35
+ </context>
36
+
37
+ <process>
38
+
39
+ ## 0. Inicializar Contexto
40
+
41
+ ```bash
42
+ INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
43
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
44
+ ```
45
+
46
+ Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
47
+
48
+ Resolver modelo do pesquisador:
49
+ ```bash
50
+ RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
51
+ ```
52
+
53
+ ## 1. Validar Fase
54
+
55
+ ```bash
56
+ PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
57
+ ```
58
+
59
+ **Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
60
+
61
+ ## 2. Verificar Pesquisa Existente
62
+
63
+ ```bash
64
+ ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
65
+ ```
66
+
67
+ **Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
68
+
69
+ **Se não existir:** Continuar.
70
+
71
+ ## 3. Reunir Contexto da Fase
72
+
73
+ Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
74
+ - `requirements_path`
75
+ - `context_path`
76
+ - `state_path`
77
+
78
+ Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
79
+
80
+ ## 4. Invocar Agente phase-researcher
81
+
82
+ Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
83
+
84
+ ```markdown
85
+ <research_type>
86
+ Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
87
+ </research_type>
88
+
89
+ <key_insight>
90
+ A questão NÃO é "qual biblioteca devo usar?"
91
+
92
+ A questão é: "O que eu não sei que não sei?"
93
+
94
+ Para esta fase, descobrir:
95
+ - Qual é o padrão de arquitetura estabelecido?
96
+ - Quais bibliotecas formam o stack padrão?
97
+ - Quais problemas as pessoas comumente encontram?
98
+ - Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
99
+ - O que NÃO deve ser feito manualmente?
100
+ </key_insight>
101
+
102
+ <objective>
103
+ Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
104
+ Modo: ecosystem
105
+ </objective>
106
+
107
+ <files_to_read>
108
+ - {requirements_path} (Requisitos)
109
+ - {context_path} (Contexto da fase do discutir-fase, se existir)
110
+ - {state_path} (Decisões e bloqueadores anteriores do projeto)
111
+ </files_to_read>
112
+
113
+ <additional_context>
114
+ **Descrição da fase:** {phase_description}
115
+ </additional_context>
116
+
117
+ <downstream_consumer>
118
+ Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
119
+ - `## Standard Stack` → Planos usam essas bibliotecas
120
+ - `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
121
+ - `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
122
+ - `## Common Pitfalls` → Etapas de verificação checam por esses problemas
123
+ - `## Code Examples` → Ações de tarefas referenciam esses padrões
124
+
125
+ Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
126
+ </downstream_consumer>
127
+
128
+ <quality_gate>
129
+ Antes de declarar completo, verificar:
130
+ - [ ] Todos os domínios investigados (não apenas alguns)
131
+ - [ ] Afirmações negativas verificadas com documentação oficial
132
+ - [ ] Múltiplas fontes para afirmações críticas
133
+ - [ ] Níveis de confiança atribuídos honestamente
134
+ - [ ] Nomes de seções correspondem ao que o planejar-fase espera
135
+ </quality_gate>
136
+
137
+ <output>
138
+ Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
139
+ </output>
140
+ ```
141
+
142
+ ```
143
+ Task(
144
+ prompt=filled_prompt,
145
+ subagent_type="phase-researcher",
146
+ model="{researcher_model}",
147
+ description="Pesquisar Fase {phase}"
148
+ )
149
+ ```
150
+
151
+ ## 5. Tratar Retorno do Agente
152
+
153
+ **`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
154
+
155
+ **`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
156
+
157
+ **`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
158
+
159
+ ## 6. Invocar Agente de Continuação
160
+
161
+ ```markdown
162
+ <objective>
163
+ Continuar pesquisa para Fase {phase_number}: {phase_name}
164
+ </objective>
165
+
166
+ <prior_state>
167
+ <files_to_read>
168
+ - .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
169
+ </files_to_read>
170
+ </prior_state>
171
+
172
+ <checkpoint_response>
173
+ **Tipo:** {checkpoint_type}
174
+ **Resposta:** {user_response}
175
+ </checkpoint_response>
176
+ ```
177
+
178
+ ```
179
+ Task(
180
+ prompt=continuation_prompt,
181
+ subagent_type="phase-researcher",
182
+ model="{researcher_model}",
183
+ description="Continuar pesquisa Fase {phase}"
184
+ )
185
+ ```
186
+
187
+ </process>
188
+
189
+ <success_criteria>
190
+ - [ ] Fase validada contra o roadmap
191
+ - [ ] Pesquisa existente verificada
192
+ - [ ] phase-researcher invocado com contexto
193
+ - [ ] Checkpoints tratados corretamente
194
+ - [ ] Usuário sabe os próximos passos
195
+ </success_criteria>