@luanpdd/kit-mcp 1.19.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 (231) 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 +237 -121
  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/reflect.js +247 -247
  228. package/src/core/reverse-sync.js +372 -372
  229. package/src/core/sync.js +418 -418
  230. package/src/core/watch.js +121 -121
  231. package/src/mcp-server/index.js +34 -3
@@ -1,36 +1,36 @@
1
- ---
2
- name: rapido
3
- description: Executa uma tarefa trivial inline — sem subagentes, sem overhead de planejamento
4
- argument-hint: "[descrição da tarefa]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Bash
10
- - Grep
11
- - Glob
12
- ---
13
-
14
- <objective>
15
- Executa uma tarefa trivial diretamente no contexto atual sem invocar subagentes
16
- ou gerar arquivos PLAN.md. Para tarefas pequenas demais para justificar overhead de planejamento:
17
- correções de typo, mudanças de configuração, pequenas refatorações, commits esquecidos, adições simples.
18
-
19
- Este NÃO é um substituto para /expresso — use /expresso para qualquer coisa que
20
- precise de pesquisa, planejamento multi-etapas ou verificação. /rapido é para tarefas
21
- que você poderia descrever em uma frase e executar em menos de 2 minutos.
22
-
23
- ## Quando usar
24
-
25
- - ✅ "renomear variável X pra Y", "ajustar copy do botão", "adicionar log", "fix de typo"
26
- - ❌ Multi-arquivo, multi-passo, requer pesquisa — use `/expresso` ou `/planejar-fase`
27
- - 🤔 Em dúvida sobre qual comando? → **`/fazer "descrição"`** roteia automaticamente
28
- </objective>
29
-
30
- <execution_context>
31
- @./.claude/framework/workflows/fast.md
32
- </execution_context>
33
-
34
- <process>
35
- Execute o workflow fast de @./.claude/framework/workflows/fast.md do início ao fim.
1
+ ---
2
+ name: rapido
3
+ description: Executa uma tarefa trivial inline — sem subagentes, sem overhead de planejamento
4
+ argument-hint: "[descrição da tarefa]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Bash
10
+ - Grep
11
+ - Glob
12
+ ---
13
+
14
+ <objective>
15
+ Executa uma tarefa trivial diretamente no contexto atual sem invocar subagentes
16
+ ou gerar arquivos PLAN.md. Para tarefas pequenas demais para justificar overhead de planejamento:
17
+ correções de typo, mudanças de configuração, pequenas refatorações, commits esquecidos, adições simples.
18
+
19
+ Este NÃO é um substituto para /expresso — use /expresso para qualquer coisa que
20
+ precise de pesquisa, planejamento multi-etapas ou verificação. /rapido é para tarefas
21
+ que você poderia descrever em uma frase e executar em menos de 2 minutos.
22
+
23
+ ## Quando usar
24
+
25
+ - ✅ "renomear variável X pra Y", "ajustar copy do botão", "adicionar log", "fix de typo"
26
+ - ❌ Multi-arquivo, multi-passo, requer pesquisa — use `/expresso` ou `/planejar-fase`
27
+ - 🤔 Em dúvida sobre qual comando? → **`/fazer "descrição"`** roteia automaticamente
28
+ </objective>
29
+
30
+ <execution_context>
31
+ @./.claude/framework/workflows/fast.md
32
+ </execution_context>
33
+
34
+ <process>
35
+ Execute o workflow fast de @./.claude/framework/workflows/fast.md do início ao fim.
36
36
  </process>
@@ -1,124 +1,124 @@
1
- ---
2
- name: reaplicar-patches
3
- description: Reaplicar modificações locais após uma atualização do framework
4
- allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
5
- ---
6
-
7
- <purpose>
8
- Após uma atualização do framework limpar e reinstalar arquivos, este comando mescla as modificações locais salvas anteriormente pelo usuário de volta para a nova versão. Usa comparação inteligente para tratar casos onde o arquivo upstream também foi alterado.
9
- </purpose>
10
-
11
- <process>
12
-
13
- ## Passo 1: Detectar patches com backup
14
-
15
- Verificar diretório de patches locais:
16
-
17
- ```bash
18
- # Instalação global — detectar diretório de config do runtime
19
- if [ -d "$HOME/.config/opencode/local-patches" ]; then
20
- PATCHES_DIR="$HOME/.config/opencode/local-patches"
21
- elif [ -d "$HOME/.opencode/local-patches" ]; then
22
- PATCHES_DIR="$HOME/.opencode/local-patches"
23
- elif [ -d "$HOME/.gemini/local-patches" ]; then
24
- PATCHES_DIR="$HOME/.gemini/local-patches"
25
- else
26
- PATCHES_DIR="./.claude/local-patches"
27
- fi
28
- # Fallback para instalação local — verificar todos os diretórios de runtime
29
- if [ ! -d "$PATCHES_DIR" ]; then
30
- for dir in .config/opencode .opencode .gemini .claude; do
31
- if [ -d "./$dir/local-patches" ]; then
32
- PATCHES_DIR="./$dir/local-patches"
33
- break
34
- fi
35
- done
36
- fi
37
- ```
38
-
39
- Ler `backup-meta.json` do diretório de patches.
40
-
41
- **Se nenhum patch encontrado:**
42
- ```
43
- Nenhum patch local encontrado. Nada a reaplicar.
44
-
45
- Patches locais são salvos automaticamente quando você executa /atualizar
46
- após modificar qualquer workflow, comando ou arquivo de agente do framework.
47
- ```
48
- Sair.
49
-
50
- ## Passo 2: Mostrar resumo de patches
51
-
52
- ```
53
- ## Patches Locais para Reaplicar
54
-
55
- **Backup de:** v{from_version}
56
- **Versão atual:** {ler arquivo VERSION}
57
- **Arquivos modificados:** {contagem}
58
-
59
- | # | Arquivo | Status |
60
- |---|---------|--------|
61
- | 1 | {file_path} | Pendente |
62
- | 2 | {file_path} | Pendente |
63
- ```
64
-
65
- ## Passo 3: Mesclar cada arquivo
66
-
67
- Para cada arquivo em `backup-meta.json`:
68
-
69
- 1. **Ler a versão com backup** (cópia modificada pelo usuário de `local-patches/`)
70
- 2. **Ler a versão recém-instalada** (arquivo atual após atualização)
71
- 3. **Comparar e mesclar:**
72
-
73
- - Se o novo arquivo for idêntico ao arquivo com backup: pular (modificação foi incorporada upstream)
74
- - Se o novo arquivo diferir: identificar as modificações do usuário e aplicá-las à nova versão
75
-
76
- **Estratégia de mesclagem:**
77
- - Ler ambas as versões completamente
78
- - Identificar seções que o usuário adicionou ou modificou (procurar por adições, não apenas diferenças de substituição de caminho)
79
- - Aplicar adições/modificações do usuário à nova versão
80
- - Se uma seção que o usuário modificou também foi alterada upstream: sinalizar como conflito, mostrar ambas as versões, perguntar ao usuário qual manter
81
-
82
- 4. **Escrever resultado mesclado** no local instalado
83
- 5. **Reportar status:**
84
- - `Mesclado` — modificações do usuário aplicadas corretamente
85
- - `Pulado` — modificação já está upstream
86
- - `Conflito` — usuário escolheu resolução
87
-
88
- ## Passo 4: Atualizar manifesto
89
-
90
- Após reaplicar, regenerar o manifesto de arquivo para que futuras atualizações detectem corretamente estes como modificações do usuário:
91
-
92
- ```bash
93
- # O manifesto será regenerado no próximo /atualizar
94
- # Por agora, apenas registrar quais arquivos foram modificados
95
- ```
96
-
97
- ## Passo 5: Opção de limpeza
98
-
99
- Perguntar ao usuário:
100
- - "Manter backups de patch para referência?" → preservar `local-patches/`
101
- - "Limpar backups de patch?" → remover diretório `local-patches/`
102
-
103
- ## Passo 6: Relatório
104
-
105
- ```
106
- ## Patches Reaplicados
107
-
108
- | # | Arquivo | Status |
109
- |---|---------|--------|
110
- | 1 | {file_path} | ✓ Mesclado |
111
- | 2 | {file_path} | ○ Pulado (já está upstream) |
112
- | 3 | {file_path} | ⚠ Conflito resolvido |
113
-
114
- {contagem} arquivo(s) atualizado(s). Suas modificações locais estão ativas novamente.
115
- ```
116
-
117
- </process>
118
-
119
- <success_criteria>
120
- - [ ] Todos os patches com backup processados
121
- - [ ] Modificações do usuário mescladas na nova versão
122
- - [ ] Conflitos resolvidos com entrada do usuário
123
- - [ ] Status reportado para cada arquivo
124
- </success_criteria>
1
+ ---
2
+ name: reaplicar-patches
3
+ description: Reaplicar modificações locais após uma atualização do framework
4
+ allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
5
+ ---
6
+
7
+ <purpose>
8
+ Após uma atualização do framework limpar e reinstalar arquivos, este comando mescla as modificações locais salvas anteriormente pelo usuário de volta para a nova versão. Usa comparação inteligente para tratar casos onde o arquivo upstream também foi alterado.
9
+ </purpose>
10
+
11
+ <process>
12
+
13
+ ## Passo 1: Detectar patches com backup
14
+
15
+ Verificar diretório de patches locais:
16
+
17
+ ```bash
18
+ # Instalação global — detectar diretório de config do runtime
19
+ if [ -d "$HOME/.config/opencode/local-patches" ]; then
20
+ PATCHES_DIR="$HOME/.config/opencode/local-patches"
21
+ elif [ -d "$HOME/.opencode/local-patches" ]; then
22
+ PATCHES_DIR="$HOME/.opencode/local-patches"
23
+ elif [ -d "$HOME/.gemini/local-patches" ]; then
24
+ PATCHES_DIR="$HOME/.gemini/local-patches"
25
+ else
26
+ PATCHES_DIR="./.claude/local-patches"
27
+ fi
28
+ # Fallback para instalação local — verificar todos os diretórios de runtime
29
+ if [ ! -d "$PATCHES_DIR" ]; then
30
+ for dir in .config/opencode .opencode .gemini .claude; do
31
+ if [ -d "./$dir/local-patches" ]; then
32
+ PATCHES_DIR="./$dir/local-patches"
33
+ break
34
+ fi
35
+ done
36
+ fi
37
+ ```
38
+
39
+ Ler `backup-meta.json` do diretório de patches.
40
+
41
+ **Se nenhum patch encontrado:**
42
+ ```
43
+ Nenhum patch local encontrado. Nada a reaplicar.
44
+
45
+ Patches locais são salvos automaticamente quando você executa /atualizar
46
+ após modificar qualquer workflow, comando ou arquivo de agente do framework.
47
+ ```
48
+ Sair.
49
+
50
+ ## Passo 2: Mostrar resumo de patches
51
+
52
+ ```
53
+ ## Patches Locais para Reaplicar
54
+
55
+ **Backup de:** v{from_version}
56
+ **Versão atual:** {ler arquivo VERSION}
57
+ **Arquivos modificados:** {contagem}
58
+
59
+ | # | Arquivo | Status |
60
+ |---|---------|--------|
61
+ | 1 | {file_path} | Pendente |
62
+ | 2 | {file_path} | Pendente |
63
+ ```
64
+
65
+ ## Passo 3: Mesclar cada arquivo
66
+
67
+ Para cada arquivo em `backup-meta.json`:
68
+
69
+ 1. **Ler a versão com backup** (cópia modificada pelo usuário de `local-patches/`)
70
+ 2. **Ler a versão recém-instalada** (arquivo atual após atualização)
71
+ 3. **Comparar e mesclar:**
72
+
73
+ - Se o novo arquivo for idêntico ao arquivo com backup: pular (modificação foi incorporada upstream)
74
+ - Se o novo arquivo diferir: identificar as modificações do usuário e aplicá-las à nova versão
75
+
76
+ **Estratégia de mesclagem:**
77
+ - Ler ambas as versões completamente
78
+ - Identificar seções que o usuário adicionou ou modificou (procurar por adições, não apenas diferenças de substituição de caminho)
79
+ - Aplicar adições/modificações do usuário à nova versão
80
+ - Se uma seção que o usuário modificou também foi alterada upstream: sinalizar como conflito, mostrar ambas as versões, perguntar ao usuário qual manter
81
+
82
+ 4. **Escrever resultado mesclado** no local instalado
83
+ 5. **Reportar status:**
84
+ - `Mesclado` — modificações do usuário aplicadas corretamente
85
+ - `Pulado` — modificação já está upstream
86
+ - `Conflito` — usuário escolheu resolução
87
+
88
+ ## Passo 4: Atualizar manifesto
89
+
90
+ Após reaplicar, regenerar o manifesto de arquivo para que futuras atualizações detectem corretamente estes como modificações do usuário:
91
+
92
+ ```bash
93
+ # O manifesto será regenerado no próximo /atualizar
94
+ # Por agora, apenas registrar quais arquivos foram modificados
95
+ ```
96
+
97
+ ## Passo 5: Opção de limpeza
98
+
99
+ Perguntar ao usuário:
100
+ - "Manter backups de patch para referência?" → preservar `local-patches/`
101
+ - "Limpar backups de patch?" → remover diretório `local-patches/`
102
+
103
+ ## Passo 6: Relatório
104
+
105
+ ```
106
+ ## Patches Reaplicados
107
+
108
+ | # | Arquivo | Status |
109
+ |---|---------|--------|
110
+ | 1 | {file_path} | ✓ Mesclado |
111
+ | 2 | {file_path} | ○ Pulado (já está upstream) |
112
+ | 3 | {file_path} | ⚠ Conflito resolvido |
113
+
114
+ {contagem} arquivo(s) atualizado(s). Suas modificações locais estão ativas novamente.
115
+ ```
116
+
117
+ </process>
118
+
119
+ <success_criteria>
120
+ - [ ] Todos os patches com backup processados
121
+ - [ ] Modificações do usuário mescladas na nova versão
122
+ - [ ] Conflitos resolvidos com entrada do usuário
123
+ - [ ] Status reportado para cada arquivo
124
+ </success_criteria>
@@ -1,19 +1,19 @@
1
- ---
2
- name: relatorio-sessao
3
- description: Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- - Write
8
- ---
9
- <objective>
10
- Gera um documento SESSION_REPORT.md estruturado capturando resultados da sessão, trabalho realizado e uso estimado de recursos. Fornece um artefato compartilhável para revisão pós-sessão.
11
- </objective>
12
-
13
- <execution_context>
14
- @./.claude/framework/workflows/session-report.md
15
- </execution_context>
16
-
17
- <process>
18
- Execute o workflow session-report de @./.claude/framework/workflows/session-report.md do início ao fim.
19
- </process>
1
+ ---
2
+ name: relatorio-sessao
3
+ description: Gera relatório da sessão com estimativas de uso de tokens, resumo de trabalho e resultados
4
+ allowed-tools:
5
+ - Read
6
+ - Bash
7
+ - Write
8
+ ---
9
+ <objective>
10
+ Gera um documento SESSION_REPORT.md estruturado capturando resultados da sessão, trabalho realizado e uso estimado de recursos. Fornece um artefato compartilhável para revisão pós-sessão.
11
+ </objective>
12
+
13
+ <execution_context>
14
+ @./.claude/framework/workflows/session-report.md
15
+ </execution_context>
16
+
17
+ <process>
18
+ Execute o workflow session-report de @./.claude/framework/workflows/session-report.md do início ao fim.
19
+ </process>
@@ -1,31 +1,31 @@
1
- ---
2
- name: remover-fase
3
- description: Remove uma fase futura do roadmap e renumera as fases subsequentes
4
- argument-hint: <phase-number>
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- ---
11
- <objective>
12
- Remover uma fase futura não iniciada do roadmap e renumerar todas as fases subsequentes para manter uma sequência limpa e linear.
13
-
14
- Propósito: Remoção limpa de trabalho que você decidiu não fazer, sem poluir o contexto com marcadores cancelados/adiados.
15
- Saída: Fase deletada, todas as fases subsequentes renumeradas, commit git como registro histórico.
16
- </objective>
17
-
18
- <execution_context>
19
- @./.claude/framework/workflows/remove-phase.md
20
- </execution_context>
21
-
22
- <context>
23
- Fase: $ARGUMENTS
24
-
25
- Roadmap e estado são resolvidos no workflow via `init phase-op` e leituras específicas.
26
- </context>
27
-
28
- <process>
29
- Execute o workflow remove-phase de @./.claude/framework/workflows/remove-phase.md do início ao fim.
30
- Preserve todos os checkpoints de validação (verificação de fase futura, verificação de trabalho), lógica de renumeração e commit.
31
- </process>
1
+ ---
2
+ name: remover-fase
3
+ description: Remove uma fase futura do roadmap e renumera as fases subsequentes
4
+ argument-hint: <phase-number>
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ ---
11
+ <objective>
12
+ Remover uma fase futura não iniciada do roadmap e renumerar todas as fases subsequentes para manter uma sequência limpa e linear.
13
+
14
+ Propósito: Remoção limpa de trabalho que você decidiu não fazer, sem poluir o contexto com marcadores cancelados/adiados.
15
+ Saída: Fase deletada, todas as fases subsequentes renumeradas, commit git como registro histórico.
16
+ </objective>
17
+
18
+ <execution_context>
19
+ @./.claude/framework/workflows/remove-phase.md
20
+ </execution_context>
21
+
22
+ <context>
23
+ Fase: $ARGUMENTS
24
+
25
+ Roadmap e estado são resolvidos no workflow via `init phase-op` e leituras específicas.
26
+ </context>
27
+
28
+ <process>
29
+ Execute o workflow remove-phase de @./.claude/framework/workflows/remove-phase.md do início ao fim.
30
+ Preserve todos os checkpoints de validação (verificação de fase futura, verificação de trabalho), lógica de renumeração e commit.
31
+ </process>
@@ -1,26 +1,26 @@
1
- ---
2
- name: remover-workspace
3
- description: Remove um workspace framework e limpa as worktrees
4
- argument-hint: "<nome-do-workspace>"
5
- allowed-tools:
6
- - Bash
7
- - Read
8
- - AskUserQuestion
9
- ---
10
- <context>
11
- **Argumentos:**
12
- - `<nome-do-workspace>` (obrigatório) — Nome do workspace a remover
13
- </context>
14
-
15
- <objective>
16
- Remove um diretório de workspace após confirmação. Para estratégia de worktree, executa `git worktree remove` para cada repositório membro primeiro. Recusa se algum repositório tiver alterações não commitadas.
17
- </objective>
18
-
19
- <execution_context>
20
- @./.claude/framework/workflows/remove-workspace.md
21
- @./.claude/framework/references/ui-brand.md
22
- </execution_context>
23
-
24
- <process>
25
- Execute o workflow remove-workspace de @./.claude/framework/workflows/remove-workspace.md do início ao fim.
26
- </process>
1
+ ---
2
+ name: remover-workspace
3
+ description: Remove um workspace framework e limpa as worktrees
4
+ argument-hint: "<nome-do-workspace>"
5
+ allowed-tools:
6
+ - Bash
7
+ - Read
8
+ - AskUserQuestion
9
+ ---
10
+ <context>
11
+ **Argumentos:**
12
+ - `<nome-do-workspace>` (obrigatório) — Nome do workspace a remover
13
+ </context>
14
+
15
+ <objective>
16
+ Remove um diretório de workspace após confirmação. Para estratégia de worktree, executa `git worktree remove` para cada repositório membro primeiro. Recusa se algum repositório tiver alterações não commitadas.
17
+ </objective>
18
+
19
+ <execution_context>
20
+ @./.claude/framework/workflows/remove-workspace.md
21
+ @./.claude/framework/references/ui-brand.md
22
+ </execution_context>
23
+
24
+ <process>
25
+ Execute o workflow remove-workspace de @./.claude/framework/workflows/remove-workspace.md do início ao fim.
26
+ </process>
@@ -1,51 +1,51 @@
1
- ---
2
- type: prompt
3
- name: resumo-marco
4
- description: Gera um resumo abrangente do projeto a partir dos artefatos do milestone para onboarding e revisão da equipe
5
- argument-hint: "[version]"
6
- allowed-tools:
7
- - Read
8
- - Write
9
- - Bash
10
- - Grep
11
- - Glob
12
- ---
13
-
14
- <objective>
15
- Gerar um resumo estruturado do milestone para onboarding da equipe e revisão do projeto. Lê artefatos do milestone concluído (arquivos ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) e produz uma visão geral amigável do que foi construído, como e por quê.
16
-
17
- Propósito: Permitir que novos membros da equipe entendam um projeto concluído lendo um documento e fazendo perguntas de acompanhamento.
18
- Saída: MILESTONE_SUMMARY escrito em `.planning/reports/`, apresentado inline, Q&A interativo opcional.
19
- </objective>
20
-
21
- <execution_context>
22
- @./.claude/framework/workflows/milestone-summary.md
23
- </execution_context>
24
-
25
- <context>
26
- **Arquivos do projeto:**
27
- - `.planning/ROADMAP.md`
28
- - `.planning/PROJECT.md`
29
- - `.planning/STATE.md`
30
- - `.planning/RETROSPECTIVE.md`
31
- - `.planning/milestones/v{version}-ROADMAP.md` (se arquivado)
32
- - `.planning/milestones/v{version}-REQUIREMENTS.md` (se arquivado)
33
- - `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
34
-
35
- **Entrada do usuário:**
36
- - Versão: $ARGUMENTS (opcional — padrão para milestone atual/mais recente)
37
- </context>
38
-
39
- <process>
40
- Ler e executar o workflow milestone-summary de @./.claude/framework/workflows/milestone-summary.md do início ao fim.
41
- </process>
42
-
43
- <success_criteria>
44
- - Versão do milestone resolvida (de argumentos, STATE.md ou scan de arquivo)
45
- - Todos os artefatos disponíveis lidos (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
46
- - Documento de resumo escrito em `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
47
- - Todas as 7 seções geradas (Visão Geral, Arquitetura, Fases, Decisões, Requisitos, Dívida Técnica, Começando)
48
- - Resumo apresentado inline ao usuário
49
- - Q&A interativo oferecido
50
- - STATE.md atualizado
1
+ ---
2
+ type: prompt
3
+ name: resumo-marco
4
+ description: Gera um resumo abrangente do projeto a partir dos artefatos do milestone para onboarding e revisão da equipe
5
+ argument-hint: "[version]"
6
+ allowed-tools:
7
+ - Read
8
+ - Write
9
+ - Bash
10
+ - Grep
11
+ - Glob
12
+ ---
13
+
14
+ <objective>
15
+ Gerar um resumo estruturado do milestone para onboarding da equipe e revisão do projeto. Lê artefatos do milestone concluído (arquivos ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION) e produz uma visão geral amigável do que foi construído, como e por quê.
16
+
17
+ Propósito: Permitir que novos membros da equipe entendam um projeto concluído lendo um documento e fazendo perguntas de acompanhamento.
18
+ Saída: MILESTONE_SUMMARY escrito em `.planning/reports/`, apresentado inline, Q&A interativo opcional.
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @./.claude/framework/workflows/milestone-summary.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ **Arquivos do projeto:**
27
+ - `.planning/ROADMAP.md`
28
+ - `.planning/PROJECT.md`
29
+ - `.planning/STATE.md`
30
+ - `.planning/RETROSPECTIVE.md`
31
+ - `.planning/milestones/v{version}-ROADMAP.md` (se arquivado)
32
+ - `.planning/milestones/v{version}-REQUIREMENTS.md` (se arquivado)
33
+ - `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
34
+
35
+ **Entrada do usuário:**
36
+ - Versão: $ARGUMENTS (opcional — padrão para milestone atual/mais recente)
37
+ </context>
38
+
39
+ <process>
40
+ Ler e executar o workflow milestone-summary de @./.claude/framework/workflows/milestone-summary.md do início ao fim.
41
+ </process>
42
+
43
+ <success_criteria>
44
+ - Versão do milestone resolvida (de argumentos, STATE.md ou scan de arquivo)
45
+ - Todos os artefatos disponíveis lidos (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
46
+ - Documento de resumo escrito em `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
47
+ - Todas as 7 seções geradas (Visão Geral, Arquitetura, Fases, Decisões, Requisitos, Dívida Técnica, Começando)
48
+ - Resumo apresentado inline ao usuário
49
+ - Q&A interativo oferecido
50
+ - STATE.md atualizado
51
51
  </success_criteria>
@@ -1,40 +1,40 @@
1
- ---
2
- name: retomar-trabalho
3
- description: Retoma o trabalho da sessão anterior com restauração completa de contexto
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- - Write
8
- - AskUserQuestion
9
- - SlashCommand
10
- ---
11
-
12
- <objective>
13
- Restaura o contexto completo do projeto e retoma o trabalho de forma contínua a partir da sessão anterior.
14
-
15
- Roteia para o workflow resume-project que trata:
16
-
17
- - Carregamento do STATE.md (ou reconstrução se ausente)
18
- - Detecção de checkpoints (arquivos .continue-here)
19
- - Detecção de trabalho incompleto (PLAN sem SUMMARY)
20
- - Apresentação de status
21
- - Roteamento de próxima ação com consciência de contexto
22
- </objective>
23
-
24
- <execution_context>
25
- @./.claude/framework/workflows/resume-project.md
26
- </execution_context>
27
-
28
- <process>
29
- **Seguir o workflow resume-project** de `@./.claude/framework/workflows/resume-project.md`.
30
-
31
- O workflow trata toda a lógica de retomada incluindo:
32
-
33
- 1. Verificação de existência do projeto
34
- 2. Carregamento ou reconstrução do STATE.md
35
- 3. Detecção de checkpoints e trabalho incompleto
36
- 4. Apresentação visual de status
37
- 5. Oferta de opções com consciência de contexto (verifica CONTEXT.md antes de sugerir planejar vs discutir)
38
- 6. Roteamento para próximo comando apropriado
39
- 7. Atualizações de continuidade da sessão
40
- </process>
1
+ ---
2
+ name: retomar-trabalho
3
+ description: Retoma o trabalho da sessão anterior com restauração completa de contexto
4
+ allowed-tools:
5
+ - Read
6
+ - Bash
7
+ - Write
8
+ - AskUserQuestion
9
+ - SlashCommand
10
+ ---
11
+
12
+ <objective>
13
+ Restaura o contexto completo do projeto e retoma o trabalho de forma contínua a partir da sessão anterior.
14
+
15
+ Roteia para o workflow resume-project que trata:
16
+
17
+ - Carregamento do STATE.md (ou reconstrução se ausente)
18
+ - Detecção de checkpoints (arquivos .continue-here)
19
+ - Detecção de trabalho incompleto (PLAN sem SUMMARY)
20
+ - Apresentação de status
21
+ - Roteamento de próxima ação com consciência de contexto
22
+ </objective>
23
+
24
+ <execution_context>
25
+ @./.claude/framework/workflows/resume-project.md
26
+ </execution_context>
27
+
28
+ <process>
29
+ **Seguir o workflow resume-project** de `@./.claude/framework/workflows/resume-project.md`.
30
+
31
+ O workflow trata toda a lógica de retomada incluindo:
32
+
33
+ 1. Verificação de existência do projeto
34
+ 2. Carregamento ou reconstrução do STATE.md
35
+ 3. Detecção de checkpoints e trabalho incompleto
36
+ 4. Apresentação visual de status
37
+ 5. Oferta de opções com consciência de contexto (verifica CONTEXT.md antes de sugerir planejar vs discutir)
38
+ 6. Roteamento para próximo comando apropriado
39
+ 7. Atualizações de continuidade da sessão
40
+ </process>