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