@luanpdd/kit-mcp 1.26.0 → 1.28.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 (326) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +168 -914
  3. package/gates/agent-no-recursive-dispatch.md +45 -11
  4. package/kit/COMANDOS.md +138 -138
  5. package/kit/README.md +76 -76
  6. package/kit/agents/advisor-researcher.md +106 -106
  7. package/kit/agents/assumptions-analyzer.md +107 -107
  8. package/kit/agents/audit-log-implementer.md +1 -1
  9. package/kit/agents/auditor-consistencia-isolamento.md +1 -1
  10. package/kit/agents/b2b-saas-architect.md +1 -1
  11. package/kit/agents/cascading-failures-auditor.md +1 -1
  12. package/kit/agents/codebase-mapper.md +768 -768
  13. package/kit/agents/crm-pipeline-implementer.md +1 -1
  14. package/kit/agents/debugger.md +813 -813
  15. package/kit/agents/detector-tenant-quente.md +1 -1
  16. package/kit/agents/evolution-go-integrator.md +1 -1
  17. package/kit/agents/example-reviewer.md +21 -21
  18. package/kit/agents/executor.md +564 -564
  19. package/kit/agents/integration-checker.md +200 -200
  20. package/kit/agents/invite-flow-implementer.md +1 -1
  21. package/kit/agents/legacy-characterizer.md +1 -1
  22. package/kit/agents/lgpd-compliance-auditor.md +1 -1
  23. package/kit/agents/multi-tenant-isolation-auditor.md +1 -1
  24. package/kit/agents/multi-tenant-rls-writer.md +1 -1
  25. package/kit/agents/nyquist-auditor.md +178 -178
  26. package/kit/agents/observability-coverage-auditor.md +1 -1
  27. package/kit/agents/org-onboarding-implementer.md +1 -1
  28. package/kit/agents/payload-capture-instrumenter.md +1 -1
  29. package/kit/agents/phase-researcher.md +696 -696
  30. package/kit/agents/plan-checker.md +272 -272
  31. package/kit/agents/planner.md +922 -922
  32. package/kit/agents/project-researcher.md +652 -652
  33. package/kit/agents/refactor-safety-auditor.md +1 -1
  34. package/kit/agents/release-pipeline-auditor.md +11 -0
  35. package/kit/agents/research-synthesizer.md +245 -245
  36. package/kit/agents/roadmapper.md +677 -677
  37. package/kit/agents/seam-finder.md +1 -1
  38. package/kit/agents/shotgun-surgery-detector.md +1 -1
  39. package/kit/agents/supabase-architect.md +14 -0
  40. package/kit/agents/supabase-branching-architect.md +562 -0
  41. package/kit/agents/supabase-cicd-pipeline-implementer.md +777 -0
  42. package/kit/agents/supabase-column-privileges-writer.md +1 -1
  43. package/kit/agents/supabase-migration-writer.md +13 -1
  44. package/kit/agents/supabase-rbac-implementer.md +1 -1
  45. package/kit/agents/supabase-rls-hardener.md +1 -1
  46. package/kit/agents/supabase-rls-writer.md +1 -1
  47. package/kit/agents/supabase-roles-implementer.md +1 -1
  48. package/kit/agents/super-admin-implementer.md +1 -1
  49. package/kit/agents/ui-auditor.md +437 -437
  50. package/kit/agents/ui-checker.md +302 -302
  51. package/kit/agents/ui-researcher.md +355 -355
  52. package/kit/agents/user-profiler.md +175 -175
  53. package/kit/agents/validador-evolucao-schema.md +1 -1
  54. package/kit/agents/verifier.md +728 -728
  55. package/kit/commands/adicionar-backlog.md +75 -75
  56. package/kit/commands/adicionar-fase.md +42 -42
  57. package/kit/commands/adicionar-tarefa.md +45 -45
  58. package/kit/commands/adicionar-testes.md +41 -41
  59. package/kit/commands/ajuda.md +21 -21
  60. package/kit/commands/atualizar.md +37 -37
  61. package/kit/commands/auditar-cascading.md +1 -1
  62. package/kit/commands/auditar-marco.md +179 -179
  63. package/kit/commands/auditar-observabilidade-cobertura.md +1 -1
  64. package/kit/commands/auditar-refactor.md +1 -1
  65. package/kit/commands/auditar-release.md +1 -1
  66. package/kit/commands/auditar-uat.md +23 -23
  67. package/kit/commands/autonomo.md +40 -40
  68. package/kit/commands/branch-pr.md +24 -24
  69. package/kit/commands/burn-rate-status.md +1 -1
  70. package/kit/commands/capturar-payloads.md +1 -1
  71. package/kit/commands/caracterizar.md +1 -1
  72. package/kit/commands/concluir-marco.md +247 -247
  73. package/kit/commands/configuracoes.md +36 -36
  74. package/kit/commands/dados-distribuidos.md +1 -1
  75. package/kit/commands/definir-perfil.md +10 -10
  76. package/kit/commands/depurar.md +190 -190
  77. package/kit/commands/detectar-duplicacao.md +1 -1
  78. package/kit/commands/discutir-fase.md +131 -131
  79. package/kit/commands/encontrar-seams.md +1 -1
  80. package/kit/commands/entrar-discord.md +17 -17
  81. package/kit/commands/estatisticas.md +18 -18
  82. package/kit/commands/example-greeting.md +33 -33
  83. package/kit/commands/executar-fase.md +58 -58
  84. package/kit/commands/expresso.md +56 -56
  85. package/kit/commands/fase-ui.md +34 -34
  86. package/kit/commands/fazer.md +57 -57
  87. package/kit/commands/fio.md +125 -125
  88. package/kit/commands/fluxos-trabalho.md +64 -64
  89. package/kit/commands/forense.md +176 -176
  90. package/kit/commands/gerenciador.md +38 -38
  91. package/kit/commands/inserir-fase.md +31 -31
  92. package/kit/commands/legacy.md +1 -1
  93. package/kit/commands/limpeza.md +17 -17
  94. package/kit/commands/listar-hipoteses-fase.md +45 -45
  95. package/kit/commands/listar-workspaces.md +18 -18
  96. package/kit/commands/load-shedding.md +1 -1
  97. package/kit/commands/mapear-codebase.md +70 -70
  98. package/kit/commands/multi-tenant.md +1 -1
  99. package/kit/commands/nota.md +33 -33
  100. package/kit/commands/novo-marco.md +43 -43
  101. package/kit/commands/novo-projeto.md +41 -41
  102. package/kit/commands/novo-workspace.md +43 -43
  103. package/kit/commands/pausar-trabalho.md +37 -37
  104. package/kit/commands/perfil-usuario.md +45 -45
  105. package/kit/commands/pesquisar-fase.md +195 -195
  106. package/kit/commands/planejar-fase.md +67 -67
  107. package/kit/commands/planejar-lacunas.md +33 -33
  108. package/kit/commands/plantar-ideia.md +25 -25
  109. package/kit/commands/progresso.md +24 -24
  110. package/kit/commands/proximo.md +30 -30
  111. package/kit/commands/publicar.md +490 -490
  112. package/kit/commands/rapido.md +35 -35
  113. package/kit/commands/reaplicar-patches.md +124 -124
  114. package/kit/commands/refactor-seguro.md +1 -1
  115. package/kit/commands/relatorio-sessao.md +19 -19
  116. package/kit/commands/remover-fase.md +31 -31
  117. package/kit/commands/remover-workspace.md +26 -26
  118. package/kit/commands/resumo-marco.md +50 -50
  119. package/kit/commands/retomar-trabalho.md +40 -40
  120. package/kit/commands/revisar-backlog.md +60 -60
  121. package/kit/commands/revisar-ui.md +32 -32
  122. package/kit/commands/revisar.md +37 -37
  123. package/kit/commands/saude.md +21 -21
  124. package/kit/commands/setup-notion.md +93 -93
  125. package/kit/commands/storytelling.md +1 -1
  126. package/kit/commands/supabase.md +1 -1
  127. package/kit/commands/sync-main.md +68 -68
  128. package/kit/commands/validar-fase.md +35 -35
  129. package/kit/commands/verificar-tarefas.md +44 -44
  130. package/kit/commands/verificar-trabalho.md +64 -64
  131. package/kit/file-manifest.json +93 -86
  132. package/kit/framework/bin/lib/commands.cjs +959 -959
  133. package/kit/framework/bin/lib/config.cjs +442 -442
  134. package/kit/framework/bin/lib/core.cjs +1230 -1230
  135. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  136. package/kit/framework/bin/lib/init.cjs +1442 -1442
  137. package/kit/framework/bin/lib/milestone.cjs +252 -252
  138. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  139. package/kit/framework/bin/lib/phase.cjs +888 -888
  140. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  141. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  142. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  143. package/kit/framework/bin/lib/security.cjs +382 -382
  144. package/kit/framework/bin/lib/state.cjs +1031 -1031
  145. package/kit/framework/bin/lib/template.cjs +222 -222
  146. package/kit/framework/bin/lib/uat.cjs +282 -282
  147. package/kit/framework/bin/lib/verify.cjs +888 -888
  148. package/kit/framework/bin/lib/workstream.cjs +491 -491
  149. package/kit/framework/bin/tools.cjs +918 -918
  150. package/kit/framework/commands/workstreams.md +63 -63
  151. package/kit/framework/references/checkpoints.md +778 -778
  152. package/kit/framework/references/continuation-format.md +249 -249
  153. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  154. package/kit/framework/references/git-integration.md +295 -295
  155. package/kit/framework/references/git-planning-commit.md +38 -38
  156. package/kit/framework/references/model-profile-resolution.md +36 -36
  157. package/kit/framework/references/model-profiles.md +139 -139
  158. package/kit/framework/references/phase-argument-parsing.md +61 -61
  159. package/kit/framework/references/planning-config.md +202 -202
  160. package/kit/framework/references/questioning.md +162 -162
  161. package/kit/framework/references/tdd.md +263 -263
  162. package/kit/framework/references/ui-brand.md +160 -160
  163. package/kit/framework/references/user-profiling.md +657 -657
  164. package/kit/framework/references/verification-patterns.md +612 -612
  165. package/kit/framework/references/workstream-flag.md +58 -58
  166. package/kit/framework/templates/DEBUG.md +164 -164
  167. package/kit/framework/templates/UAT.md +265 -265
  168. package/kit/framework/templates/UI-SPEC.md +100 -100
  169. package/kit/framework/templates/VALIDATION.md +76 -76
  170. package/kit/framework/templates/claude-md.md +122 -122
  171. package/kit/framework/templates/codebase/architecture.md +185 -185
  172. package/kit/framework/templates/codebase/concerns.md +205 -205
  173. package/kit/framework/templates/codebase/conventions.md +204 -204
  174. package/kit/framework/templates/codebase/integrations.md +192 -192
  175. package/kit/framework/templates/codebase/stack.md +158 -158
  176. package/kit/framework/templates/codebase/structure.md +199 -199
  177. package/kit/framework/templates/codebase/testing.md +301 -301
  178. package/kit/framework/templates/config.json +44 -44
  179. package/kit/framework/templates/context.md +352 -352
  180. package/kit/framework/templates/continue-here.md +78 -78
  181. package/kit/framework/templates/copilot-instructions.md +7 -7
  182. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  183. package/kit/framework/templates/dev-preferences.md +20 -20
  184. package/kit/framework/templates/discovery.md +146 -146
  185. package/kit/framework/templates/discussion-log.md +63 -63
  186. package/kit/framework/templates/milestone-archive.md +123 -123
  187. package/kit/framework/templates/milestone.md +115 -115
  188. package/kit/framework/templates/phase-prompt.md +610 -610
  189. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  190. package/kit/framework/templates/project.md +186 -186
  191. package/kit/framework/templates/requirements.md +231 -231
  192. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  193. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  194. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  195. package/kit/framework/templates/research-project/STACK.md +120 -120
  196. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  197. package/kit/framework/templates/research.md +419 -419
  198. package/kit/framework/templates/retrospective.md +54 -54
  199. package/kit/framework/templates/roadmap.md +202 -202
  200. package/kit/framework/templates/state.md +176 -176
  201. package/kit/framework/templates/summary-complex.md +59 -59
  202. package/kit/framework/templates/summary-minimal.md +41 -41
  203. package/kit/framework/templates/summary-standard.md +48 -48
  204. package/kit/framework/templates/summary.md +209 -209
  205. package/kit/framework/templates/user-profile.md +146 -146
  206. package/kit/framework/templates/user-setup.md +256 -256
  207. package/kit/framework/templates/verification-report.md +258 -258
  208. package/kit/framework/workflows/add-phase.md +112 -112
  209. package/kit/framework/workflows/add-tests.md +351 -351
  210. package/kit/framework/workflows/add-todo.md +158 -158
  211. package/kit/framework/workflows/audit-milestone.md +340 -340
  212. package/kit/framework/workflows/audit-uat.md +109 -109
  213. package/kit/framework/workflows/autonomous.md +891 -891
  214. package/kit/framework/workflows/check-todos.md +177 -177
  215. package/kit/framework/workflows/cleanup.md +152 -152
  216. package/kit/framework/workflows/complete-milestone.md +696 -696
  217. package/kit/framework/workflows/diagnose-issues.md +231 -231
  218. package/kit/framework/workflows/discovery-phase.md +289 -289
  219. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  220. package/kit/framework/workflows/discuss-phase.md +784 -784
  221. package/kit/framework/workflows/do.md +104 -104
  222. package/kit/framework/workflows/execute-phase.md +838 -838
  223. package/kit/framework/workflows/execute-plan.md +510 -510
  224. package/kit/framework/workflows/fast.md +102 -102
  225. package/kit/framework/workflows/forensics.md +265 -265
  226. package/kit/framework/workflows/health.md +181 -181
  227. package/kit/framework/workflows/help.md +619 -619
  228. package/kit/framework/workflows/insert-phase.md +130 -130
  229. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  230. package/kit/framework/workflows/list-workspaces.md +56 -56
  231. package/kit/framework/workflows/manager.md +362 -362
  232. package/kit/framework/workflows/map-codebase.md +377 -377
  233. package/kit/framework/workflows/milestone-summary.md +223 -223
  234. package/kit/framework/workflows/new-milestone.md +486 -486
  235. package/kit/framework/workflows/new-project.md +1159 -1159
  236. package/kit/framework/workflows/new-workspace.md +237 -237
  237. package/kit/framework/workflows/next.md +97 -97
  238. package/kit/framework/workflows/node-repair.md +92 -92
  239. package/kit/framework/workflows/note.md +156 -156
  240. package/kit/framework/workflows/pause-work.md +176 -176
  241. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  242. package/kit/framework/workflows/plan-phase.md +765 -765
  243. package/kit/framework/workflows/plant-seed.md +169 -169
  244. package/kit/framework/workflows/pr-branch.md +129 -129
  245. package/kit/framework/workflows/profile-user.md +450 -450
  246. package/kit/framework/workflows/progress.md +507 -507
  247. package/kit/framework/workflows/quick.md +757 -757
  248. package/kit/framework/workflows/remove-phase.md +155 -155
  249. package/kit/framework/workflows/remove-workspace.md +90 -90
  250. package/kit/framework/workflows/research-phase.md +82 -82
  251. package/kit/framework/workflows/resume-project.md +326 -326
  252. package/kit/framework/workflows/review.md +228 -228
  253. package/kit/framework/workflows/session-report.md +146 -146
  254. package/kit/framework/workflows/settings.md +283 -283
  255. package/kit/framework/workflows/ship.md +228 -228
  256. package/kit/framework/workflows/stats.md +60 -60
  257. package/kit/framework/workflows/transition.md +671 -671
  258. package/kit/framework/workflows/ui-phase.md +302 -302
  259. package/kit/framework/workflows/ui-review.md +165 -165
  260. package/kit/framework/workflows/update.md +323 -323
  261. package/kit/framework/workflows/validate-phase.md +174 -174
  262. package/kit/framework/workflows/verify-phase.md +252 -252
  263. package/kit/framework/workflows/verify-work.md +637 -637
  264. package/kit/hooks/check-update.js +118 -118
  265. package/kit/hooks/context-monitor.js +163 -163
  266. package/kit/hooks/prompt-guard.js +103 -103
  267. package/kit/hooks/statusline.js +125 -125
  268. package/kit/hooks/workflow-guard.js +101 -101
  269. package/kit/settings.json +45 -45
  270. package/kit/skills/_shared-supabase/glossary.md +10 -0
  271. package/kit/skills/ai-prompt-characterization/SKILL.md +1 -1
  272. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +1 -1
  273. package/kit/skills/audit-log-multi-tenant/SKILL.md +1 -1
  274. package/kit/skills/b2b-saas-architecture/SKILL.md +1 -1
  275. package/kit/skills/consistencia-leitura-replica/SKILL.md +1 -1
  276. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +1 -1
  277. package/kit/skills/escolha-modelo-consistencia/SKILL.md +1 -1
  278. package/kit/skills/evolucao-schema-compativel/SKILL.md +1 -1
  279. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +1 -1
  280. package/kit/skills/example-skill/SKILL.md +42 -42
  281. package/kit/skills/legacy-api-only-applications/SKILL.md +1 -1
  282. package/kit/skills/legacy-characterization-tests/SKILL.md +1 -1
  283. package/kit/skills/legacy-effect-analysis/SKILL.md +1 -1
  284. package/kit/skills/legacy-extract-class/SKILL.md +1 -1
  285. package/kit/skills/legacy-programming-by-difference/SKILL.md +1 -1
  286. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +1 -1
  287. package/kit/skills/legacy-shotgun-surgery/SKILL.md +1 -1
  288. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +1 -1
  289. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +1 -1
  290. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +1 -1
  291. package/kit/skills/member-invite-flow/SKILL.md +1 -1
  292. package/kit/skills/member-management-react-shadcn/SKILL.md +1 -1
  293. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +1 -1
  294. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +1 -1
  295. package/kit/skills/org-onboarding-flow/SKILL.md +1 -1
  296. package/kit/skills/org-switcher-react-pattern/SKILL.md +1 -1
  297. package/kit/skills/permission-gate-react-pattern/SKILL.md +1 -1
  298. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +1 -1
  299. package/kit/skills/pre-refactor-characterization/SKILL.md +1 -1
  300. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +1 -1
  301. package/kit/skills/streams-eventos-cdc/SKILL.md +1 -1
  302. package/kit/skills/supabase-branching-workflow/SKILL.md +544 -0
  303. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -0
  304. package/kit/skills/supabase-column-level-security/SKILL.md +1 -1
  305. package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -0
  306. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +1 -1
  307. package/kit/skills/supabase-migration-repair/SKILL.md +823 -0
  308. package/kit/skills/supabase-migrations/SKILL.md +1 -1
  309. package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -0
  310. package/kit/skills/supabase-postgres-roles/SKILL.md +1 -1
  311. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +1 -1
  312. package/kit/skills/supabase-rls-policies/SKILL.md +1 -1
  313. package/kit/skills/super-admin-platform-pattern/SKILL.md +1 -1
  314. package/kit/skills/tenant-quente-mitigacao/SKILL.md +1 -1
  315. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +1 -1
  316. package/package.json +63 -63
  317. package/src/cli/index.js +345 -6
  318. package/src/cli/render.js +7 -0
  319. package/src/core/kit.js +216 -216
  320. package/src/core/logger.js +170 -0
  321. package/src/core/notify.js +60 -0
  322. package/src/core/reflect.js +247 -247
  323. package/src/core/reverse-sync.js +372 -372
  324. package/src/core/sync.js +418 -418
  325. package/src/core/watch.js +121 -121
  326. package/src/mcp-server/index.js +65 -2
@@ -1,78 +1,78 @@
1
- # Template Continue-Here
2
-
3
- Copie e preencha esta estrutura para `.planning/phases/XX-name/.continue-here.md`:
4
-
5
- ```yaml
6
- ---
7
- phase: XX-name
8
- task: 3
9
- total_tasks: 7
10
- status: in_progress
11
- last_updated: 2025-01-15T14:30:00Z
12
- ---
13
- ```
14
-
15
- ```markdown
16
- <current_state>
17
- [Onde exatamente estamos? Qual é o contexto imediato?]
18
- </current_state>
19
-
20
- <completed_work>
21
- [O que foi feito nesta sessão - seja específico]
22
-
23
- - Tarefa 1: [nome] - Concluída
24
- - Tarefa 2: [nome] - Concluída
25
- - Tarefa 3: [nome] - Em andamento, [o que foi feito nela]
26
- </completed_work>
27
-
28
- <remaining_work>
29
- [O que falta nesta fase]
30
-
31
- - Tarefa 3: [nome] - [o que falta fazer]
32
- - Tarefa 4: [nome] - Não iniciada
33
- - Tarefa 5: [nome] - Não iniciada
34
- </remaining_work>
35
-
36
- <decisions_made>
37
- [Decisões chave e por que — para que a próxima sessão não reabra o debate]
38
-
39
- - Decidiu usar [X] porque [motivo]
40
- - Escolheu [abordagem] em vez de [alternativa] porque [motivo]
41
- </decisions_made>
42
-
43
- <blockers>
44
- [Qualquer coisa travada ou aguardando fatores externos]
45
-
46
- - [Bloqueio 1]: [status/contorno]
47
- </blockers>
48
-
49
- <context>
50
- [Estado mental, "vibe", qualquer coisa que ajude a retomar suavemente]
51
-
52
- [O que você estava pensando? Qual era o plano?
53
- Este é o contexto "retomar exatamente de onde parou".]
54
- </context>
55
-
56
- <next_action>
57
- [A primeira coisa a fazer ao retomar]
58
-
59
- Começar com: [ação específica]
60
- </next_action>
61
- ```
62
-
63
- <yaml_fields>
64
- Frontmatter YAML obrigatório:
65
-
66
- - `phase`: Nome do diretório (ex.: `02-authentication`)
67
- - `task`: Número da tarefa atual
68
- - `total_tasks`: Quantas tarefas na fase
69
- - `status`: `in_progress`, `blocked`, `almost_done`
70
- - `last_updated`: Timestamp ISO
71
- </yaml_fields>
72
-
73
- <guidelines>
74
- - Seja específico o suficiente para que uma instância fresca do Claude entenda imediatamente
75
- - Inclua POR QUE as decisões foram tomadas, não apenas o quê
76
- - O `<next_action>` deve ser acionável sem ler mais nada
77
- - Este arquivo é DELETADO após o retorno — não é armazenamento permanente
78
- </guidelines>
1
+ # Template Continue-Here
2
+
3
+ Copie e preencha esta estrutura para `.planning/phases/XX-name/.continue-here.md`:
4
+
5
+ ```yaml
6
+ ---
7
+ phase: XX-name
8
+ task: 3
9
+ total_tasks: 7
10
+ status: in_progress
11
+ last_updated: 2025-01-15T14:30:00Z
12
+ ---
13
+ ```
14
+
15
+ ```markdown
16
+ <current_state>
17
+ [Onde exatamente estamos? Qual é o contexto imediato?]
18
+ </current_state>
19
+
20
+ <completed_work>
21
+ [O que foi feito nesta sessão - seja específico]
22
+
23
+ - Tarefa 1: [nome] - Concluída
24
+ - Tarefa 2: [nome] - Concluída
25
+ - Tarefa 3: [nome] - Em andamento, [o que foi feito nela]
26
+ </completed_work>
27
+
28
+ <remaining_work>
29
+ [O que falta nesta fase]
30
+
31
+ - Tarefa 3: [nome] - [o que falta fazer]
32
+ - Tarefa 4: [nome] - Não iniciada
33
+ - Tarefa 5: [nome] - Não iniciada
34
+ </remaining_work>
35
+
36
+ <decisions_made>
37
+ [Decisões chave e por que — para que a próxima sessão não reabra o debate]
38
+
39
+ - Decidiu usar [X] porque [motivo]
40
+ - Escolheu [abordagem] em vez de [alternativa] porque [motivo]
41
+ </decisions_made>
42
+
43
+ <blockers>
44
+ [Qualquer coisa travada ou aguardando fatores externos]
45
+
46
+ - [Bloqueio 1]: [status/contorno]
47
+ </blockers>
48
+
49
+ <context>
50
+ [Estado mental, "vibe", qualquer coisa que ajude a retomar suavemente]
51
+
52
+ [O que você estava pensando? Qual era o plano?
53
+ Este é o contexto "retomar exatamente de onde parou".]
54
+ </context>
55
+
56
+ <next_action>
57
+ [A primeira coisa a fazer ao retomar]
58
+
59
+ Começar com: [ação específica]
60
+ </next_action>
61
+ ```
62
+
63
+ <yaml_fields>
64
+ Frontmatter YAML obrigatório:
65
+
66
+ - `phase`: Nome do diretório (ex.: `02-authentication`)
67
+ - `task`: Número da tarefa atual
68
+ - `total_tasks`: Quantas tarefas na fase
69
+ - `status`: `in_progress`, `blocked`, `almost_done`
70
+ - `last_updated`: Timestamp ISO
71
+ </yaml_fields>
72
+
73
+ <guidelines>
74
+ - Seja específico o suficiente para que uma instância fresca do Claude entenda imediatamente
75
+ - Inclua POR QUE as decisões foram tomadas, não apenas o quê
76
+ - O `<next_action>` deve ser acionável sem ler mais nada
77
+ - Este arquivo é DELETADO após o retorno — não é armazenamento permanente
78
+ </guidelines>
@@ -1,7 +1,7 @@
1
- # Instruções para framework
2
-
3
- - Use a skill framework quando o usuário pedir framework ou usar um comando `framework-*`.
4
- - Trate `/framework-...` ou `framework-...` como invocações de comando e carregue o arquivo correspondente de `.github/skills/framework-*`.
5
- - Quando um comando disser para spawnar um subagente, prefira um agente customizado correspondente de `.github/agents`.
6
- - Não aplique workflows framework a menos que o usuário peça explicitamente.
7
- - Após concluir qualquer comando `framework-*` (ou qualquer entregável que ele acione: feature, bug fix, testes, docs, etc.), SEMPRE: (1) ofereça ao usuário o próximo passo via `ask_user`; repita esse ciclo de feedback até o usuário indicar explicitamente que terminou.
1
+ # Instruções para framework
2
+
3
+ - Use a skill framework quando o usuário pedir framework ou usar um comando `framework-*`.
4
+ - Trate `/framework-...` ou `framework-...` como invocações de comando e carregue o arquivo correspondente de `.github/skills/framework-*`.
5
+ - Quando um comando disser para spawnar um subagente, prefira um agente customizado correspondente de `.github/agents`.
6
+ - Não aplique workflows framework a menos que o usuário peça explicitamente.
7
+ - Após concluir qualquer comando `framework-*` (ou qualquer entregável que ele acione: feature, bug fix, testes, docs, etc.), SEMPRE: (1) ofereça ao usuário o próximo passo via `ask_user`; repita esse ciclo de feedback até o usuário indicar explicitamente que terminou.
@@ -1,91 +1,91 @@
1
- # Template de Prompt do Subagente de Debug
2
-
3
- Template para spawnar o agente debugger. O agente contém toda a expertise de debug — este template fornece apenas o contexto do problema.
4
-
5
- ---
6
-
7
- ## Template
8
-
9
- ```markdown
10
- <objective>
11
- Investigate issue: {issue_id}
12
-
13
- **Summary:** {issue_summary}
14
- </objective>
15
-
16
- <symptoms>
17
- expected: {expected}
18
- actual: {actual}
19
- errors: {errors}
20
- reproduction: {reproduction}
21
- timeline: {timeline}
22
- </symptoms>
23
-
24
- <mode>
25
- symptoms_prefilled: {true_or_false}
26
- goal: {find_root_cause_only | find_and_fix}
27
- </mode>
28
-
29
- <debug_file>
30
- Create: .planning/debug/{slug}.md
31
- </debug_file>
32
- ```
33
-
34
- ---
35
-
36
- ## Placeholders
37
-
38
- | Placeholder | Fonte | Exemplo |
39
- |-------------|-------|---------|
40
- | `{issue_id}` | Atribuído pelo orquestrador | `auth-screen-dark` |
41
- | `{issue_summary}` | Descrição do usuário | `Auth screen is too dark` |
42
- | `{expected}` | Dos sintomas | `See logo clearly` |
43
- | `{actual}` | Dos sintomas | `Screen is dark` |
44
- | `{errors}` | Dos sintomas | `None in console` |
45
- | `{reproduction}` | Dos sintomas | `Open /auth page` |
46
- | `{timeline}` | Dos sintomas | `After recent deploy` |
47
- | `{goal}` | Orquestrador define | `find_and_fix` |
48
- | `{slug}` | Gerado | `auth-screen-dark` |
49
-
50
- ---
51
-
52
- ## Uso
53
-
54
- **A partir de /debug:**
55
- ```python
56
- Task(
57
- prompt=filled_template,
58
- subagent_type="debugger",
59
- description="Debug {slug}"
60
- )
61
- ```
62
-
63
- **A partir de diagnose-issues (UAT):**
64
- ```python
65
- Task(prompt=template, subagent_type="debugger", description="Debug UAT-001")
66
- ```
67
-
68
- ---
69
-
70
- ## Continuação
71
-
72
- Para checkpoints, spawnar novo agente com:
73
-
74
- ```markdown
75
- <objective>
76
- Continue debugging {slug}. Evidence is in the debug file.
77
- </objective>
78
-
79
- <prior_state>
80
- Debug file: @.planning/debug/{slug}.md
81
- </prior_state>
82
-
83
- <checkpoint_response>
84
- **Type:** {checkpoint_type}
85
- **Response:** {user_response}
86
- </checkpoint_response>
87
-
88
- <mode>
89
- goal: {goal}
90
- </mode>
91
- ```
1
+ # Template de Prompt do Subagente de Debug
2
+
3
+ Template para spawnar o agente debugger. O agente contém toda a expertise de debug — este template fornece apenas o contexto do problema.
4
+
5
+ ---
6
+
7
+ ## Template
8
+
9
+ ```markdown
10
+ <objective>
11
+ Investigate issue: {issue_id}
12
+
13
+ **Summary:** {issue_summary}
14
+ </objective>
15
+
16
+ <symptoms>
17
+ expected: {expected}
18
+ actual: {actual}
19
+ errors: {errors}
20
+ reproduction: {reproduction}
21
+ timeline: {timeline}
22
+ </symptoms>
23
+
24
+ <mode>
25
+ symptoms_prefilled: {true_or_false}
26
+ goal: {find_root_cause_only | find_and_fix}
27
+ </mode>
28
+
29
+ <debug_file>
30
+ Create: .planning/debug/{slug}.md
31
+ </debug_file>
32
+ ```
33
+
34
+ ---
35
+
36
+ ## Placeholders
37
+
38
+ | Placeholder | Fonte | Exemplo |
39
+ |-------------|-------|---------|
40
+ | `{issue_id}` | Atribuído pelo orquestrador | `auth-screen-dark` |
41
+ | `{issue_summary}` | Descrição do usuário | `Auth screen is too dark` |
42
+ | `{expected}` | Dos sintomas | `See logo clearly` |
43
+ | `{actual}` | Dos sintomas | `Screen is dark` |
44
+ | `{errors}` | Dos sintomas | `None in console` |
45
+ | `{reproduction}` | Dos sintomas | `Open /auth page` |
46
+ | `{timeline}` | Dos sintomas | `After recent deploy` |
47
+ | `{goal}` | Orquestrador define | `find_and_fix` |
48
+ | `{slug}` | Gerado | `auth-screen-dark` |
49
+
50
+ ---
51
+
52
+ ## Uso
53
+
54
+ **A partir de /debug:**
55
+ ```python
56
+ Task(
57
+ prompt=filled_template,
58
+ subagent_type="debugger",
59
+ description="Debug {slug}"
60
+ )
61
+ ```
62
+
63
+ **A partir de diagnose-issues (UAT):**
64
+ ```python
65
+ Task(prompt=template, subagent_type="debugger", description="Debug UAT-001")
66
+ ```
67
+
68
+ ---
69
+
70
+ ## Continuação
71
+
72
+ Para checkpoints, spawnar novo agente com:
73
+
74
+ ```markdown
75
+ <objective>
76
+ Continue debugging {slug}. Evidence is in the debug file.
77
+ </objective>
78
+
79
+ <prior_state>
80
+ Debug file: @.planning/debug/{slug}.md
81
+ </prior_state>
82
+
83
+ <checkpoint_response>
84
+ **Type:** {checkpoint_type}
85
+ **Response:** {user_response}
86
+ </checkpoint_response>
87
+
88
+ <mode>
89
+ goal: {goal}
90
+ </mode>
91
+ ```
@@ -1,20 +1,20 @@
1
- ---
2
- description: Carregar preferências do desenvolvedor nesta sessão
3
- ---
4
-
5
- # Preferências do Desenvolvedor
6
-
7
- > Gerado pelo framework em {{generated_at}} a partir de {{data_source}}.
8
- > Execute `/profile-user --refresh` para regenerar.
9
-
10
- ## Diretivas Comportamentais
11
-
12
- Siga estas diretivas ao trabalhar com este desenvolvedor. Diretivas de maior confiança
13
- devem ser aplicadas diretamente. Diretivas de menor confiança devem ser tentadas
14
- com ressalva ("Com base no seu perfil, vou tentar X — me diga se estiver errado").
15
-
16
- {{behavioral_directives}}
17
-
18
- ## Preferências de Stack
19
-
20
- {{stack_preferences}}
1
+ ---
2
+ description: Carregar preferências do desenvolvedor nesta sessão
3
+ ---
4
+
5
+ # Preferências do Desenvolvedor
6
+
7
+ > Gerado pelo framework em {{generated_at}} a partir de {{data_source}}.
8
+ > Execute `/profile-user --refresh` para regenerar.
9
+
10
+ ## Diretivas Comportamentais
11
+
12
+ Siga estas diretivas ao trabalhar com este desenvolvedor. Diretivas de maior confiança
13
+ devem ser aplicadas diretamente. Diretivas de menor confiança devem ser tentadas
14
+ com ressalva ("Com base no seu perfil, vou tentar X — me diga se estiver errado").
15
+
16
+ {{behavioral_directives}}
17
+
18
+ ## Preferências de Stack
19
+
20
+ {{stack_preferences}}