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