@luanpdd/kit-mcp 1.30.2 → 1.31.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 (347) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +168 -168
  3. package/gates/agent-no-recursive-dispatch.md +84 -82
  4. package/kit/COMANDOS.md +138 -138
  5. package/kit/README.md +76 -76
  6. package/kit/agents/advisor-researcher.md +107 -106
  7. package/kit/agents/ai-mutation-tester.md +1 -0
  8. package/kit/agents/assumptions-analyzer.md +108 -107
  9. package/kit/agents/audit-log-implementer.md +314 -313
  10. package/kit/agents/auditor-consistencia-isolamento.md +414 -413
  11. package/kit/agents/b2b-saas-architect.md +157 -156
  12. package/kit/agents/burn-rate-forecaster.md +1 -0
  13. package/kit/agents/cascading-failures-auditor.md +299 -298
  14. package/kit/agents/codebase-mapper.md +769 -768
  15. package/kit/agents/crm-pipeline-implementer.md +257 -256
  16. package/kit/agents/debugger.md +814 -813
  17. package/kit/agents/detector-tenant-quente.md +338 -337
  18. package/kit/agents/evolution-go-integrator.md +201 -200
  19. package/kit/agents/example-reviewer.md +22 -21
  20. package/kit/agents/executor.md +565 -564
  21. package/kit/agents/golden-signals-instrumenter.md +1 -0
  22. package/kit/agents/incident-investigator.md +1 -0
  23. package/kit/agents/integration-checker.md +201 -200
  24. package/kit/agents/invite-flow-implementer.md +190 -189
  25. package/kit/agents/legacy-characterizer.md +369 -368
  26. package/kit/agents/lgpd-compliance-auditor.md +296 -295
  27. package/kit/agents/load-shedding-instrumenter.md +1 -0
  28. package/kit/agents/multi-tenant-isolation-auditor.md +254 -253
  29. package/kit/agents/multi-tenant-rls-writer.md +341 -340
  30. package/kit/agents/nyquist-auditor.md +179 -178
  31. package/kit/agents/observability-coverage-auditor.md +316 -315
  32. package/kit/agents/observability-instrumenter.md +1 -0
  33. package/kit/agents/omm-auditor.md +1 -0
  34. package/kit/agents/org-onboarding-implementer.md +224 -223
  35. package/kit/agents/payload-capture-instrumenter.md +274 -273
  36. package/kit/agents/phase-researcher.md +697 -696
  37. package/kit/agents/plan-checker.md +273 -272
  38. package/kit/agents/planner.md +923 -922
  39. package/kit/agents/postmortem-writer.md +1 -0
  40. package/kit/agents/project-researcher.md +653 -652
  41. package/kit/agents/prr-conductor.md +1 -0
  42. package/kit/agents/refactor-safety-auditor.md +405 -404
  43. package/kit/agents/release-pipeline-auditor.md +1 -0
  44. package/kit/agents/research-synthesizer.md +246 -245
  45. package/kit/agents/roadmapper.md +678 -677
  46. package/kit/agents/schema-checker.md +1 -0
  47. package/kit/agents/seam-finder.md +360 -359
  48. package/kit/agents/shotgun-surgery-detector.md +350 -349
  49. package/kit/agents/slo-engineer.md +1 -0
  50. package/kit/agents/storytelling-analyst.md +1 -0
  51. package/kit/agents/supabase-architect.md +1 -0
  52. package/kit/agents/supabase-auth-bootstrapper.md +1 -0
  53. package/kit/agents/supabase-branching-architect.md +563 -562
  54. package/kit/agents/supabase-cicd-pipeline-implementer.md +778 -777
  55. package/kit/agents/supabase-column-privileges-writer.md +400 -399
  56. package/kit/agents/supabase-edge-fn-tester.md +2 -1
  57. package/kit/agents/supabase-edge-fn-writer.md +2 -1
  58. package/kit/agents/supabase-migration-writer.md +386 -385
  59. package/kit/agents/supabase-rbac-implementer.md +393 -392
  60. package/kit/agents/supabase-realtime-implementer.md +364 -363
  61. package/kit/agents/supabase-rls-hardener.md +522 -521
  62. package/kit/agents/supabase-rls-writer.md +324 -323
  63. package/kit/agents/supabase-roles-implementer.md +356 -355
  64. package/kit/agents/supabase-storage-implementer.md +1 -0
  65. package/kit/agents/super-admin-implementer.md +282 -281
  66. package/kit/agents/toil-auditor.md +1 -0
  67. package/kit/agents/ui-auditor.md +438 -437
  68. package/kit/agents/ui-checker.md +303 -302
  69. package/kit/agents/ui-researcher.md +356 -355
  70. package/kit/agents/user-profiler.md +176 -175
  71. package/kit/agents/validador-evolucao-schema.md +336 -335
  72. package/kit/agents/verifier.md +729 -728
  73. package/kit/commands/adicionar-backlog.md +75 -75
  74. package/kit/commands/adicionar-fase.md +42 -42
  75. package/kit/commands/adicionar-tarefa.md +45 -45
  76. package/kit/commands/adicionar-testes.md +41 -41
  77. package/kit/commands/ajuda.md +21 -21
  78. package/kit/commands/atualizar.md +37 -37
  79. package/kit/commands/auditar-cascading.md +111 -111
  80. package/kit/commands/auditar-marco.md +179 -179
  81. package/kit/commands/auditar-observabilidade-cobertura.md +183 -183
  82. package/kit/commands/auditar-refactor.md +219 -219
  83. package/kit/commands/auditar-release.md +109 -109
  84. package/kit/commands/auditar-uat.md +23 -23
  85. package/kit/commands/autonomo.md +40 -40
  86. package/kit/commands/branch-pr.md +24 -24
  87. package/kit/commands/burn-rate-status.md +408 -408
  88. package/kit/commands/capturar-payloads.md +193 -193
  89. package/kit/commands/caracterizar.md +212 -212
  90. package/kit/commands/concluir-marco.md +247 -247
  91. package/kit/commands/configuracoes.md +36 -36
  92. package/kit/commands/dados-distribuidos.md +188 -188
  93. package/kit/commands/definir-perfil.md +10 -10
  94. package/kit/commands/depurar.md +190 -190
  95. package/kit/commands/detectar-duplicacao.md +197 -197
  96. package/kit/commands/discutir-fase.md +131 -131
  97. package/kit/commands/encontrar-seams.md +136 -136
  98. package/kit/commands/entrar-discord.md +17 -17
  99. package/kit/commands/estatisticas.md +18 -18
  100. package/kit/commands/example-greeting.md +33 -33
  101. package/kit/commands/executar-fase.md +58 -58
  102. package/kit/commands/expresso.md +56 -56
  103. package/kit/commands/fase-ui.md +34 -34
  104. package/kit/commands/fazer.md +57 -57
  105. package/kit/commands/fio.md +125 -125
  106. package/kit/commands/fluxos-trabalho.md +64 -64
  107. package/kit/commands/forense.md +176 -176
  108. package/kit/commands/gerenciador.md +38 -38
  109. package/kit/commands/inserir-fase.md +31 -31
  110. package/kit/commands/legacy.md +263 -263
  111. package/kit/commands/limpeza.md +17 -17
  112. package/kit/commands/listar-hipoteses-fase.md +45 -45
  113. package/kit/commands/listar-workspaces.md +18 -18
  114. package/kit/commands/load-shedding.md +117 -117
  115. package/kit/commands/mapear-codebase.md +70 -70
  116. package/kit/commands/multi-tenant.md +163 -163
  117. package/kit/commands/nota.md +33 -33
  118. package/kit/commands/novo-marco.md +43 -43
  119. package/kit/commands/novo-projeto.md +41 -41
  120. package/kit/commands/novo-workspace.md +43 -43
  121. package/kit/commands/pausar-trabalho.md +37 -37
  122. package/kit/commands/perfil-usuario.md +45 -45
  123. package/kit/commands/pesquisar-fase.md +195 -195
  124. package/kit/commands/planejar-fase.md +67 -67
  125. package/kit/commands/planejar-lacunas.md +33 -33
  126. package/kit/commands/plantar-ideia.md +25 -25
  127. package/kit/commands/progresso.md +24 -24
  128. package/kit/commands/proximo.md +30 -30
  129. package/kit/commands/publicar.md +490 -490
  130. package/kit/commands/rapido.md +35 -35
  131. package/kit/commands/reaplicar-patches.md +124 -124
  132. package/kit/commands/refactor-seguro.md +321 -321
  133. package/kit/commands/relatorio-sessao.md +19 -19
  134. package/kit/commands/remover-fase.md +31 -31
  135. package/kit/commands/remover-workspace.md +26 -26
  136. package/kit/commands/resumo-marco.md +50 -50
  137. package/kit/commands/retomar-trabalho.md +40 -40
  138. package/kit/commands/revisar-backlog.md +60 -60
  139. package/kit/commands/revisar-ui.md +32 -32
  140. package/kit/commands/revisar.md +37 -37
  141. package/kit/commands/saude.md +21 -21
  142. package/kit/commands/setup-notion.md +93 -93
  143. package/kit/commands/storytelling.md +179 -179
  144. package/kit/commands/sync-main.md +68 -68
  145. package/kit/commands/validar-fase.md +35 -35
  146. package/kit/commands/verificar-tarefas.md +44 -44
  147. package/kit/commands/verificar-trabalho.md +64 -64
  148. package/kit/file-manifest.json +82 -81
  149. package/kit/framework/bin/lib/commands.cjs +959 -959
  150. package/kit/framework/bin/lib/config.cjs +442 -442
  151. package/kit/framework/bin/lib/core.cjs +1230 -1230
  152. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  153. package/kit/framework/bin/lib/init.cjs +1442 -1442
  154. package/kit/framework/bin/lib/milestone.cjs +252 -252
  155. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  156. package/kit/framework/bin/lib/phase.cjs +888 -888
  157. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  158. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  159. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  160. package/kit/framework/bin/lib/security.cjs +382 -382
  161. package/kit/framework/bin/lib/state.cjs +1031 -1031
  162. package/kit/framework/bin/lib/template.cjs +222 -222
  163. package/kit/framework/bin/lib/uat.cjs +282 -282
  164. package/kit/framework/bin/lib/verify.cjs +888 -888
  165. package/kit/framework/bin/lib/workstream.cjs +491 -491
  166. package/kit/framework/bin/tools.cjs +918 -918
  167. package/kit/framework/commands/workstreams.md +63 -63
  168. package/kit/framework/references/checkpoints.md +778 -778
  169. package/kit/framework/references/continuation-format.md +249 -249
  170. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  171. package/kit/framework/references/git-integration.md +295 -295
  172. package/kit/framework/references/git-planning-commit.md +38 -38
  173. package/kit/framework/references/model-profile-resolution.md +36 -36
  174. package/kit/framework/references/model-profiles.md +139 -139
  175. package/kit/framework/references/phase-argument-parsing.md +61 -61
  176. package/kit/framework/references/planning-config.md +202 -202
  177. package/kit/framework/references/questioning.md +162 -162
  178. package/kit/framework/references/tdd.md +263 -263
  179. package/kit/framework/references/ui-brand.md +160 -160
  180. package/kit/framework/references/user-profiling.md +657 -657
  181. package/kit/framework/references/verification-patterns.md +612 -612
  182. package/kit/framework/references/workstream-flag.md +58 -58
  183. package/kit/framework/templates/DEBUG.md +164 -164
  184. package/kit/framework/templates/UAT.md +265 -265
  185. package/kit/framework/templates/UI-SPEC.md +100 -100
  186. package/kit/framework/templates/VALIDATION.md +76 -76
  187. package/kit/framework/templates/claude-md.md +122 -122
  188. package/kit/framework/templates/codebase/architecture.md +185 -185
  189. package/kit/framework/templates/codebase/concerns.md +205 -205
  190. package/kit/framework/templates/codebase/conventions.md +204 -204
  191. package/kit/framework/templates/codebase/integrations.md +192 -192
  192. package/kit/framework/templates/codebase/stack.md +158 -158
  193. package/kit/framework/templates/codebase/structure.md +199 -199
  194. package/kit/framework/templates/codebase/testing.md +301 -301
  195. package/kit/framework/templates/config.json +44 -44
  196. package/kit/framework/templates/context.md +352 -352
  197. package/kit/framework/templates/continue-here.md +78 -78
  198. package/kit/framework/templates/copilot-instructions.md +7 -7
  199. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  200. package/kit/framework/templates/dev-preferences.md +20 -20
  201. package/kit/framework/templates/discovery.md +146 -146
  202. package/kit/framework/templates/discussion-log.md +63 -63
  203. package/kit/framework/templates/milestone-archive.md +123 -123
  204. package/kit/framework/templates/milestone.md +115 -115
  205. package/kit/framework/templates/phase-prompt.md +610 -610
  206. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  207. package/kit/framework/templates/project.md +186 -186
  208. package/kit/framework/templates/requirements.md +231 -231
  209. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  210. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  211. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  212. package/kit/framework/templates/research-project/STACK.md +120 -120
  213. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  214. package/kit/framework/templates/research.md +419 -419
  215. package/kit/framework/templates/retrospective.md +54 -54
  216. package/kit/framework/templates/roadmap.md +202 -202
  217. package/kit/framework/templates/state.md +176 -176
  218. package/kit/framework/templates/summary-complex.md +59 -59
  219. package/kit/framework/templates/summary-minimal.md +41 -41
  220. package/kit/framework/templates/summary-standard.md +48 -48
  221. package/kit/framework/templates/summary.md +209 -209
  222. package/kit/framework/templates/user-profile.md +146 -146
  223. package/kit/framework/templates/user-setup.md +256 -256
  224. package/kit/framework/templates/verification-report.md +258 -258
  225. package/kit/framework/workflows/add-phase.md +112 -112
  226. package/kit/framework/workflows/add-tests.md +351 -351
  227. package/kit/framework/workflows/add-todo.md +158 -158
  228. package/kit/framework/workflows/audit-milestone.md +340 -340
  229. package/kit/framework/workflows/audit-uat.md +109 -109
  230. package/kit/framework/workflows/autonomous.md +891 -891
  231. package/kit/framework/workflows/check-todos.md +177 -177
  232. package/kit/framework/workflows/cleanup.md +152 -152
  233. package/kit/framework/workflows/complete-milestone.md +696 -696
  234. package/kit/framework/workflows/diagnose-issues.md +231 -231
  235. package/kit/framework/workflows/discovery-phase.md +289 -289
  236. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  237. package/kit/framework/workflows/discuss-phase.md +784 -784
  238. package/kit/framework/workflows/do.md +104 -104
  239. package/kit/framework/workflows/execute-phase.md +838 -838
  240. package/kit/framework/workflows/execute-plan.md +510 -510
  241. package/kit/framework/workflows/fast.md +102 -102
  242. package/kit/framework/workflows/forensics.md +265 -265
  243. package/kit/framework/workflows/health.md +181 -181
  244. package/kit/framework/workflows/help.md +619 -619
  245. package/kit/framework/workflows/insert-phase.md +130 -130
  246. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  247. package/kit/framework/workflows/list-workspaces.md +56 -56
  248. package/kit/framework/workflows/manager.md +362 -362
  249. package/kit/framework/workflows/map-codebase.md +377 -377
  250. package/kit/framework/workflows/milestone-summary.md +223 -223
  251. package/kit/framework/workflows/new-milestone.md +486 -486
  252. package/kit/framework/workflows/new-project.md +1159 -1159
  253. package/kit/framework/workflows/new-workspace.md +237 -237
  254. package/kit/framework/workflows/next.md +97 -97
  255. package/kit/framework/workflows/node-repair.md +92 -92
  256. package/kit/framework/workflows/note.md +156 -156
  257. package/kit/framework/workflows/pause-work.md +176 -176
  258. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  259. package/kit/framework/workflows/plan-phase.md +765 -765
  260. package/kit/framework/workflows/plant-seed.md +169 -169
  261. package/kit/framework/workflows/pr-branch.md +129 -129
  262. package/kit/framework/workflows/profile-user.md +450 -450
  263. package/kit/framework/workflows/progress.md +507 -507
  264. package/kit/framework/workflows/quick.md +757 -757
  265. package/kit/framework/workflows/remove-phase.md +155 -155
  266. package/kit/framework/workflows/remove-workspace.md +90 -90
  267. package/kit/framework/workflows/research-phase.md +82 -82
  268. package/kit/framework/workflows/resume-project.md +326 -326
  269. package/kit/framework/workflows/review.md +228 -228
  270. package/kit/framework/workflows/session-report.md +146 -146
  271. package/kit/framework/workflows/settings.md +283 -283
  272. package/kit/framework/workflows/ship.md +228 -228
  273. package/kit/framework/workflows/stats.md +60 -60
  274. package/kit/framework/workflows/transition.md +671 -671
  275. package/kit/framework/workflows/ui-phase.md +302 -302
  276. package/kit/framework/workflows/ui-review.md +165 -165
  277. package/kit/framework/workflows/update.md +323 -323
  278. package/kit/framework/workflows/validate-phase.md +174 -174
  279. package/kit/framework/workflows/verify-phase.md +252 -252
  280. package/kit/framework/workflows/verify-work.md +637 -637
  281. package/kit/hooks/check-update.js +118 -118
  282. package/kit/hooks/context-monitor.js +163 -163
  283. package/kit/hooks/kit-attribution-reminder.cjs +29 -50
  284. package/kit/hooks/kit-router.cjs +137 -0
  285. package/kit/hooks/prompt-guard.js +103 -103
  286. package/kit/hooks/statusline.js +125 -125
  287. package/kit/hooks/workflow-guard.js +101 -101
  288. package/kit/settings.json +45 -45
  289. package/kit/skills/ai-prompt-characterization/SKILL.md +335 -335
  290. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +447 -447
  291. package/kit/skills/audit-log-multi-tenant/SKILL.md +340 -340
  292. package/kit/skills/b2b-saas-architecture/SKILL.md +300 -300
  293. package/kit/skills/consistencia-leitura-replica/SKILL.md +385 -385
  294. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +343 -343
  295. package/kit/skills/escolha-modelo-consistencia/SKILL.md +494 -494
  296. package/kit/skills/evolucao-schema-compativel/SKILL.md +448 -448
  297. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +322 -322
  298. package/kit/skills/example-skill/SKILL.md +42 -42
  299. package/kit/skills/legacy-api-only-applications/SKILL.md +358 -358
  300. package/kit/skills/legacy-characterization-tests/SKILL.md +330 -330
  301. package/kit/skills/legacy-effect-analysis/SKILL.md +331 -331
  302. package/kit/skills/legacy-extract-class/SKILL.md +203 -203
  303. package/kit/skills/legacy-programming-by-difference/SKILL.md +252 -252
  304. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +460 -460
  305. package/kit/skills/legacy-shotgun-surgery/SKILL.md +286 -286
  306. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +434 -434
  307. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +270 -270
  308. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +340 -340
  309. package/kit/skills/member-invite-flow/SKILL.md +305 -305
  310. package/kit/skills/member-management-react-shadcn/SKILL.md +328 -328
  311. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +316 -316
  312. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +342 -342
  313. package/kit/skills/org-onboarding-flow/SKILL.md +257 -257
  314. package/kit/skills/org-switcher-react-pattern/SKILL.md +349 -349
  315. package/kit/skills/permission-gate-react-pattern/SKILL.md +271 -271
  316. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +552 -552
  317. package/kit/skills/pre-refactor-characterization/SKILL.md +421 -421
  318. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +338 -338
  319. package/kit/skills/streams-eventos-cdc/SKILL.md +711 -711
  320. package/kit/skills/supabase-branching-workflow/SKILL.md +544 -544
  321. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -880
  322. package/kit/skills/supabase-column-level-security/SKILL.md +426 -426
  323. package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -807
  324. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +472 -472
  325. package/kit/skills/supabase-edge-functions/SKILL.md +1 -1
  326. package/kit/skills/supabase-edge-functions-auth/SKILL.md +1 -1
  327. package/kit/skills/supabase-edge-functions-limits/SKILL.md +1 -1
  328. package/kit/skills/supabase-edge-functions-mcp-server/SKILL.md +1 -1
  329. package/kit/skills/supabase-edge-functions-testing/SKILL.md +1 -1
  330. package/kit/skills/supabase-edge-runtime-builtins/SKILL.md +1 -1
  331. package/kit/skills/supabase-migration-repair/SKILL.md +823 -823
  332. package/kit/skills/supabase-migrations/SKILL.md +297 -297
  333. package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -1053
  334. package/kit/skills/supabase-postgres-roles/SKILL.md +392 -392
  335. package/kit/skills/supabase-realtime/SKILL.md +460 -460
  336. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +418 -418
  337. package/kit/skills/supabase-rls-policies/SKILL.md +635 -635
  338. package/kit/skills/super-admin-platform-pattern/SKILL.md +326 -326
  339. package/kit/skills/tenant-quente-mitigacao/SKILL.md +605 -605
  340. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +287 -287
  341. package/package.json +1 -1
  342. package/src/core/kit.js +216 -216
  343. package/src/core/reflect.js +247 -247
  344. package/src/core/reverse-sync.js +372 -372
  345. package/src/core/sync.js +437 -418
  346. package/src/core/watch.js +121 -121
  347. package/src/mcp-server/index.js +794 -746
@@ -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>