@luanpdd/kit-mcp 1.18.0 → 1.20.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 (232) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +648 -648
  3. package/kit/COMANDOS.md +138 -138
  4. package/kit/README.md +52 -52
  5. package/kit/agents/advisor-researcher.md +106 -106
  6. package/kit/agents/assumptions-analyzer.md +107 -107
  7. package/kit/agents/codebase-mapper.md +768 -768
  8. package/kit/agents/debugger.md +772 -772
  9. package/kit/agents/example-reviewer.md +21 -21
  10. package/kit/agents/executor.md +523 -523
  11. package/kit/agents/integration-checker.md +200 -200
  12. package/kit/agents/nyquist-auditor.md +178 -178
  13. package/kit/agents/phase-researcher.md +696 -696
  14. package/kit/agents/plan-checker.md +272 -272
  15. package/kit/agents/planner.md +891 -891
  16. package/kit/agents/project-researcher.md +652 -652
  17. package/kit/agents/research-synthesizer.md +245 -245
  18. package/kit/agents/roadmapper.md +677 -677
  19. package/kit/agents/ui-auditor.md +437 -437
  20. package/kit/agents/ui-checker.md +302 -302
  21. package/kit/agents/ui-researcher.md +355 -355
  22. package/kit/agents/user-profiler.md +175 -175
  23. package/kit/agents/verifier.md +728 -728
  24. package/kit/commands/adicionar-backlog.md +75 -75
  25. package/kit/commands/adicionar-fase.md +42 -42
  26. package/kit/commands/adicionar-tarefa.md +45 -45
  27. package/kit/commands/adicionar-testes.md +41 -41
  28. package/kit/commands/ajuda.md +21 -21
  29. package/kit/commands/atualizar.md +37 -37
  30. package/kit/commands/auditar-marco.md +179 -179
  31. package/kit/commands/auditar-uat.md +23 -23
  32. package/kit/commands/autonomo.md +40 -40
  33. package/kit/commands/branch-pr.md +24 -24
  34. package/kit/commands/burn-rate-status.md +338 -70
  35. package/kit/commands/concluir-marco.md +247 -247
  36. package/kit/commands/configuracoes.md +36 -36
  37. package/kit/commands/definir-perfil.md +10 -10
  38. package/kit/commands/depurar.md +190 -190
  39. package/kit/commands/discutir-fase.md +131 -131
  40. package/kit/commands/entrar-discord.md +17 -17
  41. package/kit/commands/estatisticas.md +18 -18
  42. package/kit/commands/example-greeting.md +33 -33
  43. package/kit/commands/executar-fase.md +58 -58
  44. package/kit/commands/expresso.md +56 -56
  45. package/kit/commands/fase-ui.md +34 -34
  46. package/kit/commands/fazer.md +57 -57
  47. package/kit/commands/fio.md +125 -125
  48. package/kit/commands/fluxos-trabalho.md +64 -64
  49. package/kit/commands/forense.md +176 -176
  50. package/kit/commands/gerenciador.md +38 -38
  51. package/kit/commands/inserir-fase.md +31 -31
  52. package/kit/commands/limpeza.md +17 -17
  53. package/kit/commands/listar-hipoteses-fase.md +45 -45
  54. package/kit/commands/listar-workspaces.md +18 -18
  55. package/kit/commands/mapear-codebase.md +70 -70
  56. package/kit/commands/nota.md +33 -33
  57. package/kit/commands/novo-marco.md +43 -43
  58. package/kit/commands/novo-projeto.md +41 -41
  59. package/kit/commands/novo-workspace.md +43 -43
  60. package/kit/commands/pausar-trabalho.md +37 -37
  61. package/kit/commands/perfil-usuario.md +45 -45
  62. package/kit/commands/pesquisar-fase.md +195 -195
  63. package/kit/commands/planejar-fase.md +67 -67
  64. package/kit/commands/planejar-lacunas.md +33 -33
  65. package/kit/commands/plantar-ideia.md +25 -25
  66. package/kit/commands/progresso.md +24 -24
  67. package/kit/commands/proximo.md +30 -30
  68. package/kit/commands/publicar.md +490 -490
  69. package/kit/commands/rapido.md +35 -35
  70. package/kit/commands/reaplicar-patches.md +124 -124
  71. package/kit/commands/relatorio-sessao.md +19 -19
  72. package/kit/commands/remover-fase.md +31 -31
  73. package/kit/commands/remover-workspace.md +26 -26
  74. package/kit/commands/resumo-marco.md +50 -50
  75. package/kit/commands/retomar-trabalho.md +40 -40
  76. package/kit/commands/revisar-backlog.md +60 -60
  77. package/kit/commands/revisar-ui.md +32 -32
  78. package/kit/commands/revisar.md +37 -37
  79. package/kit/commands/saude.md +21 -21
  80. package/kit/commands/setup-notion.md +93 -93
  81. package/kit/commands/sync-main.md +68 -68
  82. package/kit/commands/validar-fase.md +35 -35
  83. package/kit/commands/verificar-tarefas.md +44 -44
  84. package/kit/commands/verificar-trabalho.md +64 -64
  85. package/kit/file-manifest.json +3 -3
  86. package/kit/framework/bin/lib/commands.cjs +959 -959
  87. package/kit/framework/bin/lib/config.cjs +442 -442
  88. package/kit/framework/bin/lib/core.cjs +1230 -1230
  89. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  90. package/kit/framework/bin/lib/init.cjs +1442 -1442
  91. package/kit/framework/bin/lib/milestone.cjs +252 -252
  92. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  93. package/kit/framework/bin/lib/phase.cjs +888 -888
  94. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  95. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  96. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  97. package/kit/framework/bin/lib/security.cjs +382 -382
  98. package/kit/framework/bin/lib/state.cjs +1031 -1031
  99. package/kit/framework/bin/lib/template.cjs +222 -222
  100. package/kit/framework/bin/lib/uat.cjs +282 -282
  101. package/kit/framework/bin/lib/verify.cjs +888 -888
  102. package/kit/framework/bin/lib/workstream.cjs +491 -491
  103. package/kit/framework/bin/tools.cjs +918 -918
  104. package/kit/framework/commands/workstreams.md +63 -63
  105. package/kit/framework/references/checkpoints.md +778 -778
  106. package/kit/framework/references/continuation-format.md +249 -249
  107. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  108. package/kit/framework/references/git-integration.md +295 -295
  109. package/kit/framework/references/git-planning-commit.md +38 -38
  110. package/kit/framework/references/model-profile-resolution.md +36 -36
  111. package/kit/framework/references/model-profiles.md +139 -139
  112. package/kit/framework/references/phase-argument-parsing.md +61 -61
  113. package/kit/framework/references/planning-config.md +202 -202
  114. package/kit/framework/references/questioning.md +162 -162
  115. package/kit/framework/references/tdd.md +263 -263
  116. package/kit/framework/references/ui-brand.md +160 -160
  117. package/kit/framework/references/user-profiling.md +657 -657
  118. package/kit/framework/references/verification-patterns.md +612 -612
  119. package/kit/framework/references/workstream-flag.md +58 -58
  120. package/kit/framework/templates/DEBUG.md +164 -164
  121. package/kit/framework/templates/UAT.md +265 -265
  122. package/kit/framework/templates/UI-SPEC.md +100 -100
  123. package/kit/framework/templates/VALIDATION.md +76 -76
  124. package/kit/framework/templates/claude-md.md +122 -122
  125. package/kit/framework/templates/codebase/architecture.md +185 -185
  126. package/kit/framework/templates/codebase/concerns.md +205 -205
  127. package/kit/framework/templates/codebase/conventions.md +204 -204
  128. package/kit/framework/templates/codebase/integrations.md +192 -192
  129. package/kit/framework/templates/codebase/stack.md +158 -158
  130. package/kit/framework/templates/codebase/structure.md +199 -199
  131. package/kit/framework/templates/codebase/testing.md +301 -301
  132. package/kit/framework/templates/config.json +44 -44
  133. package/kit/framework/templates/context.md +352 -352
  134. package/kit/framework/templates/continue-here.md +78 -78
  135. package/kit/framework/templates/copilot-instructions.md +7 -7
  136. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  137. package/kit/framework/templates/dev-preferences.md +20 -20
  138. package/kit/framework/templates/discovery.md +146 -146
  139. package/kit/framework/templates/discussion-log.md +63 -63
  140. package/kit/framework/templates/milestone-archive.md +123 -123
  141. package/kit/framework/templates/milestone.md +115 -115
  142. package/kit/framework/templates/phase-prompt.md +610 -610
  143. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  144. package/kit/framework/templates/project.md +186 -186
  145. package/kit/framework/templates/requirements.md +231 -231
  146. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  147. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  148. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  149. package/kit/framework/templates/research-project/STACK.md +120 -120
  150. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  151. package/kit/framework/templates/research.md +419 -419
  152. package/kit/framework/templates/retrospective.md +54 -54
  153. package/kit/framework/templates/roadmap.md +202 -202
  154. package/kit/framework/templates/state.md +176 -176
  155. package/kit/framework/templates/summary-complex.md +59 -59
  156. package/kit/framework/templates/summary-minimal.md +41 -41
  157. package/kit/framework/templates/summary-standard.md +48 -48
  158. package/kit/framework/templates/summary.md +209 -209
  159. package/kit/framework/templates/user-profile.md +146 -146
  160. package/kit/framework/templates/user-setup.md +256 -256
  161. package/kit/framework/templates/verification-report.md +258 -258
  162. package/kit/framework/workflows/add-phase.md +112 -112
  163. package/kit/framework/workflows/add-tests.md +351 -351
  164. package/kit/framework/workflows/add-todo.md +158 -158
  165. package/kit/framework/workflows/audit-milestone.md +340 -340
  166. package/kit/framework/workflows/audit-uat.md +109 -109
  167. package/kit/framework/workflows/autonomous.md +891 -891
  168. package/kit/framework/workflows/check-todos.md +177 -177
  169. package/kit/framework/workflows/cleanup.md +152 -152
  170. package/kit/framework/workflows/complete-milestone.md +696 -696
  171. package/kit/framework/workflows/diagnose-issues.md +231 -231
  172. package/kit/framework/workflows/discovery-phase.md +289 -289
  173. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  174. package/kit/framework/workflows/discuss-phase.md +784 -784
  175. package/kit/framework/workflows/do.md +104 -104
  176. package/kit/framework/workflows/execute-phase.md +838 -838
  177. package/kit/framework/workflows/execute-plan.md +510 -510
  178. package/kit/framework/workflows/fast.md +102 -102
  179. package/kit/framework/workflows/forensics.md +265 -265
  180. package/kit/framework/workflows/health.md +181 -181
  181. package/kit/framework/workflows/help.md +619 -619
  182. package/kit/framework/workflows/insert-phase.md +130 -130
  183. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  184. package/kit/framework/workflows/list-workspaces.md +56 -56
  185. package/kit/framework/workflows/manager.md +362 -362
  186. package/kit/framework/workflows/map-codebase.md +377 -377
  187. package/kit/framework/workflows/milestone-summary.md +223 -223
  188. package/kit/framework/workflows/new-milestone.md +486 -486
  189. package/kit/framework/workflows/new-project.md +1159 -1159
  190. package/kit/framework/workflows/new-workspace.md +237 -237
  191. package/kit/framework/workflows/next.md +97 -97
  192. package/kit/framework/workflows/node-repair.md +92 -92
  193. package/kit/framework/workflows/note.md +156 -156
  194. package/kit/framework/workflows/pause-work.md +176 -176
  195. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  196. package/kit/framework/workflows/plan-phase.md +765 -765
  197. package/kit/framework/workflows/plant-seed.md +169 -169
  198. package/kit/framework/workflows/pr-branch.md +129 -129
  199. package/kit/framework/workflows/profile-user.md +450 -450
  200. package/kit/framework/workflows/progress.md +507 -507
  201. package/kit/framework/workflows/quick.md +757 -757
  202. package/kit/framework/workflows/remove-phase.md +155 -155
  203. package/kit/framework/workflows/remove-workspace.md +90 -90
  204. package/kit/framework/workflows/research-phase.md +82 -82
  205. package/kit/framework/workflows/resume-project.md +326 -326
  206. package/kit/framework/workflows/review.md +228 -228
  207. package/kit/framework/workflows/session-report.md +146 -146
  208. package/kit/framework/workflows/settings.md +283 -283
  209. package/kit/framework/workflows/ship.md +228 -228
  210. package/kit/framework/workflows/stats.md +60 -60
  211. package/kit/framework/workflows/transition.md +671 -671
  212. package/kit/framework/workflows/ui-phase.md +302 -302
  213. package/kit/framework/workflows/ui-review.md +165 -165
  214. package/kit/framework/workflows/update.md +323 -323
  215. package/kit/framework/workflows/validate-phase.md +174 -174
  216. package/kit/framework/workflows/verify-phase.md +252 -252
  217. package/kit/framework/workflows/verify-work.md +637 -637
  218. package/kit/hooks/check-update.js +118 -118
  219. package/kit/hooks/context-monitor.js +163 -163
  220. package/kit/hooks/prompt-guard.js +103 -103
  221. package/kit/hooks/statusline.js +125 -125
  222. package/kit/hooks/workflow-guard.js +101 -101
  223. package/kit/settings.json +45 -45
  224. package/kit/skills/example-skill/SKILL.md +42 -42
  225. package/package.json +63 -59
  226. package/src/core/kit.js +216 -216
  227. package/src/core/metrics.js +135 -10
  228. package/src/core/reflect.js +247 -247
  229. package/src/core/reverse-sync.js +372 -372
  230. package/src/core/sync.js +418 -418
  231. package/src/core/watch.js +121 -121
  232. package/src/mcp-server/index.js +34 -3
@@ -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}}