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