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