@luanpdd/kit-mcp 1.18.0 → 1.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (232) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +648 -648
  3. package/kit/COMANDOS.md +138 -138
  4. package/kit/README.md +52 -52
  5. package/kit/agents/advisor-researcher.md +106 -106
  6. package/kit/agents/assumptions-analyzer.md +107 -107
  7. package/kit/agents/codebase-mapper.md +768 -768
  8. package/kit/agents/debugger.md +772 -772
  9. package/kit/agents/example-reviewer.md +21 -21
  10. package/kit/agents/executor.md +523 -523
  11. package/kit/agents/integration-checker.md +200 -200
  12. package/kit/agents/nyquist-auditor.md +178 -178
  13. package/kit/agents/phase-researcher.md +696 -696
  14. package/kit/agents/plan-checker.md +272 -272
  15. package/kit/agents/planner.md +891 -891
  16. package/kit/agents/project-researcher.md +652 -652
  17. package/kit/agents/research-synthesizer.md +245 -245
  18. package/kit/agents/roadmapper.md +677 -677
  19. package/kit/agents/ui-auditor.md +437 -437
  20. package/kit/agents/ui-checker.md +302 -302
  21. package/kit/agents/ui-researcher.md +355 -355
  22. package/kit/agents/user-profiler.md +175 -175
  23. package/kit/agents/verifier.md +728 -728
  24. package/kit/commands/adicionar-backlog.md +75 -75
  25. package/kit/commands/adicionar-fase.md +42 -42
  26. package/kit/commands/adicionar-tarefa.md +45 -45
  27. package/kit/commands/adicionar-testes.md +41 -41
  28. package/kit/commands/ajuda.md +21 -21
  29. package/kit/commands/atualizar.md +37 -37
  30. package/kit/commands/auditar-marco.md +179 -179
  31. package/kit/commands/auditar-uat.md +23 -23
  32. package/kit/commands/autonomo.md +40 -40
  33. package/kit/commands/branch-pr.md +24 -24
  34. package/kit/commands/burn-rate-status.md +338 -70
  35. package/kit/commands/concluir-marco.md +247 -247
  36. package/kit/commands/configuracoes.md +36 -36
  37. package/kit/commands/definir-perfil.md +10 -10
  38. package/kit/commands/depurar.md +190 -190
  39. package/kit/commands/discutir-fase.md +131 -131
  40. package/kit/commands/entrar-discord.md +17 -17
  41. package/kit/commands/estatisticas.md +18 -18
  42. package/kit/commands/example-greeting.md +33 -33
  43. package/kit/commands/executar-fase.md +58 -58
  44. package/kit/commands/expresso.md +56 -56
  45. package/kit/commands/fase-ui.md +34 -34
  46. package/kit/commands/fazer.md +57 -57
  47. package/kit/commands/fio.md +125 -125
  48. package/kit/commands/fluxos-trabalho.md +64 -64
  49. package/kit/commands/forense.md +176 -176
  50. package/kit/commands/gerenciador.md +38 -38
  51. package/kit/commands/inserir-fase.md +31 -31
  52. package/kit/commands/limpeza.md +17 -17
  53. package/kit/commands/listar-hipoteses-fase.md +45 -45
  54. package/kit/commands/listar-workspaces.md +18 -18
  55. package/kit/commands/mapear-codebase.md +70 -70
  56. package/kit/commands/nota.md +33 -33
  57. package/kit/commands/novo-marco.md +43 -43
  58. package/kit/commands/novo-projeto.md +41 -41
  59. package/kit/commands/novo-workspace.md +43 -43
  60. package/kit/commands/pausar-trabalho.md +37 -37
  61. package/kit/commands/perfil-usuario.md +45 -45
  62. package/kit/commands/pesquisar-fase.md +195 -195
  63. package/kit/commands/planejar-fase.md +67 -67
  64. package/kit/commands/planejar-lacunas.md +33 -33
  65. package/kit/commands/plantar-ideia.md +25 -25
  66. package/kit/commands/progresso.md +24 -24
  67. package/kit/commands/proximo.md +30 -30
  68. package/kit/commands/publicar.md +490 -490
  69. package/kit/commands/rapido.md +35 -35
  70. package/kit/commands/reaplicar-patches.md +124 -124
  71. package/kit/commands/relatorio-sessao.md +19 -19
  72. package/kit/commands/remover-fase.md +31 -31
  73. package/kit/commands/remover-workspace.md +26 -26
  74. package/kit/commands/resumo-marco.md +50 -50
  75. package/kit/commands/retomar-trabalho.md +40 -40
  76. package/kit/commands/revisar-backlog.md +60 -60
  77. package/kit/commands/revisar-ui.md +32 -32
  78. package/kit/commands/revisar.md +37 -37
  79. package/kit/commands/saude.md +21 -21
  80. package/kit/commands/setup-notion.md +93 -93
  81. package/kit/commands/sync-main.md +68 -68
  82. package/kit/commands/validar-fase.md +35 -35
  83. package/kit/commands/verificar-tarefas.md +44 -44
  84. package/kit/commands/verificar-trabalho.md +64 -64
  85. package/kit/file-manifest.json +3 -3
  86. package/kit/framework/bin/lib/commands.cjs +959 -959
  87. package/kit/framework/bin/lib/config.cjs +442 -442
  88. package/kit/framework/bin/lib/core.cjs +1230 -1230
  89. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  90. package/kit/framework/bin/lib/init.cjs +1442 -1442
  91. package/kit/framework/bin/lib/milestone.cjs +252 -252
  92. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  93. package/kit/framework/bin/lib/phase.cjs +888 -888
  94. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  95. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  96. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  97. package/kit/framework/bin/lib/security.cjs +382 -382
  98. package/kit/framework/bin/lib/state.cjs +1031 -1031
  99. package/kit/framework/bin/lib/template.cjs +222 -222
  100. package/kit/framework/bin/lib/uat.cjs +282 -282
  101. package/kit/framework/bin/lib/verify.cjs +888 -888
  102. package/kit/framework/bin/lib/workstream.cjs +491 -491
  103. package/kit/framework/bin/tools.cjs +918 -918
  104. package/kit/framework/commands/workstreams.md +63 -63
  105. package/kit/framework/references/checkpoints.md +778 -778
  106. package/kit/framework/references/continuation-format.md +249 -249
  107. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  108. package/kit/framework/references/git-integration.md +295 -295
  109. package/kit/framework/references/git-planning-commit.md +38 -38
  110. package/kit/framework/references/model-profile-resolution.md +36 -36
  111. package/kit/framework/references/model-profiles.md +139 -139
  112. package/kit/framework/references/phase-argument-parsing.md +61 -61
  113. package/kit/framework/references/planning-config.md +202 -202
  114. package/kit/framework/references/questioning.md +162 -162
  115. package/kit/framework/references/tdd.md +263 -263
  116. package/kit/framework/references/ui-brand.md +160 -160
  117. package/kit/framework/references/user-profiling.md +657 -657
  118. package/kit/framework/references/verification-patterns.md +612 -612
  119. package/kit/framework/references/workstream-flag.md +58 -58
  120. package/kit/framework/templates/DEBUG.md +164 -164
  121. package/kit/framework/templates/UAT.md +265 -265
  122. package/kit/framework/templates/UI-SPEC.md +100 -100
  123. package/kit/framework/templates/VALIDATION.md +76 -76
  124. package/kit/framework/templates/claude-md.md +122 -122
  125. package/kit/framework/templates/codebase/architecture.md +185 -185
  126. package/kit/framework/templates/codebase/concerns.md +205 -205
  127. package/kit/framework/templates/codebase/conventions.md +204 -204
  128. package/kit/framework/templates/codebase/integrations.md +192 -192
  129. package/kit/framework/templates/codebase/stack.md +158 -158
  130. package/kit/framework/templates/codebase/structure.md +199 -199
  131. package/kit/framework/templates/codebase/testing.md +301 -301
  132. package/kit/framework/templates/config.json +44 -44
  133. package/kit/framework/templates/context.md +352 -352
  134. package/kit/framework/templates/continue-here.md +78 -78
  135. package/kit/framework/templates/copilot-instructions.md +7 -7
  136. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  137. package/kit/framework/templates/dev-preferences.md +20 -20
  138. package/kit/framework/templates/discovery.md +146 -146
  139. package/kit/framework/templates/discussion-log.md +63 -63
  140. package/kit/framework/templates/milestone-archive.md +123 -123
  141. package/kit/framework/templates/milestone.md +115 -115
  142. package/kit/framework/templates/phase-prompt.md +610 -610
  143. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  144. package/kit/framework/templates/project.md +186 -186
  145. package/kit/framework/templates/requirements.md +231 -231
  146. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  147. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  148. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  149. package/kit/framework/templates/research-project/STACK.md +120 -120
  150. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  151. package/kit/framework/templates/research.md +419 -419
  152. package/kit/framework/templates/retrospective.md +54 -54
  153. package/kit/framework/templates/roadmap.md +202 -202
  154. package/kit/framework/templates/state.md +176 -176
  155. package/kit/framework/templates/summary-complex.md +59 -59
  156. package/kit/framework/templates/summary-minimal.md +41 -41
  157. package/kit/framework/templates/summary-standard.md +48 -48
  158. package/kit/framework/templates/summary.md +209 -209
  159. package/kit/framework/templates/user-profile.md +146 -146
  160. package/kit/framework/templates/user-setup.md +256 -256
  161. package/kit/framework/templates/verification-report.md +258 -258
  162. package/kit/framework/workflows/add-phase.md +112 -112
  163. package/kit/framework/workflows/add-tests.md +351 -351
  164. package/kit/framework/workflows/add-todo.md +158 -158
  165. package/kit/framework/workflows/audit-milestone.md +340 -340
  166. package/kit/framework/workflows/audit-uat.md +109 -109
  167. package/kit/framework/workflows/autonomous.md +891 -891
  168. package/kit/framework/workflows/check-todos.md +177 -177
  169. package/kit/framework/workflows/cleanup.md +152 -152
  170. package/kit/framework/workflows/complete-milestone.md +696 -696
  171. package/kit/framework/workflows/diagnose-issues.md +231 -231
  172. package/kit/framework/workflows/discovery-phase.md +289 -289
  173. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  174. package/kit/framework/workflows/discuss-phase.md +784 -784
  175. package/kit/framework/workflows/do.md +104 -104
  176. package/kit/framework/workflows/execute-phase.md +838 -838
  177. package/kit/framework/workflows/execute-plan.md +510 -510
  178. package/kit/framework/workflows/fast.md +102 -102
  179. package/kit/framework/workflows/forensics.md +265 -265
  180. package/kit/framework/workflows/health.md +181 -181
  181. package/kit/framework/workflows/help.md +619 -619
  182. package/kit/framework/workflows/insert-phase.md +130 -130
  183. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  184. package/kit/framework/workflows/list-workspaces.md +56 -56
  185. package/kit/framework/workflows/manager.md +362 -362
  186. package/kit/framework/workflows/map-codebase.md +377 -377
  187. package/kit/framework/workflows/milestone-summary.md +223 -223
  188. package/kit/framework/workflows/new-milestone.md +486 -486
  189. package/kit/framework/workflows/new-project.md +1159 -1159
  190. package/kit/framework/workflows/new-workspace.md +237 -237
  191. package/kit/framework/workflows/next.md +97 -97
  192. package/kit/framework/workflows/node-repair.md +92 -92
  193. package/kit/framework/workflows/note.md +156 -156
  194. package/kit/framework/workflows/pause-work.md +176 -176
  195. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  196. package/kit/framework/workflows/plan-phase.md +765 -765
  197. package/kit/framework/workflows/plant-seed.md +169 -169
  198. package/kit/framework/workflows/pr-branch.md +129 -129
  199. package/kit/framework/workflows/profile-user.md +450 -450
  200. package/kit/framework/workflows/progress.md +507 -507
  201. package/kit/framework/workflows/quick.md +757 -757
  202. package/kit/framework/workflows/remove-phase.md +155 -155
  203. package/kit/framework/workflows/remove-workspace.md +90 -90
  204. package/kit/framework/workflows/research-phase.md +82 -82
  205. package/kit/framework/workflows/resume-project.md +326 -326
  206. package/kit/framework/workflows/review.md +228 -228
  207. package/kit/framework/workflows/session-report.md +146 -146
  208. package/kit/framework/workflows/settings.md +283 -283
  209. package/kit/framework/workflows/ship.md +228 -228
  210. package/kit/framework/workflows/stats.md +60 -60
  211. package/kit/framework/workflows/transition.md +671 -671
  212. package/kit/framework/workflows/ui-phase.md +302 -302
  213. package/kit/framework/workflows/ui-review.md +165 -165
  214. package/kit/framework/workflows/update.md +323 -323
  215. package/kit/framework/workflows/validate-phase.md +174 -174
  216. package/kit/framework/workflows/verify-phase.md +252 -252
  217. package/kit/framework/workflows/verify-work.md +637 -637
  218. package/kit/hooks/check-update.js +118 -118
  219. package/kit/hooks/context-monitor.js +163 -163
  220. package/kit/hooks/prompt-guard.js +103 -103
  221. package/kit/hooks/statusline.js +125 -125
  222. package/kit/hooks/workflow-guard.js +101 -101
  223. package/kit/settings.json +45 -45
  224. package/kit/skills/example-skill/SKILL.md +42 -42
  225. package/package.json +63 -59
  226. package/src/core/kit.js +216 -216
  227. package/src/core/metrics.js +135 -10
  228. package/src/core/reflect.js +247 -247
  229. package/src/core/reverse-sync.js +372 -372
  230. package/src/core/sync.js +418 -418
  231. package/src/core/watch.js +121 -121
  232. package/src/mcp-server/index.js +34 -3
@@ -1,18 +1,18 @@
1
- ---
2
- name: entrar-discord
3
- description: Entrar na comunidade framework no Discord
4
- ---
5
-
6
- <objective>
7
- Exibir o link de convite para o servidor da comunidade framework no Discord.
8
- </objective>
9
-
10
- <output>
11
- # Entre no Discord do framework
12
-
13
- Conecte-se com outros usuários do framework, obtenha ajuda, compartilhe o que está criando e fique atualizado.
14
-
15
- **Link de convite:** https://discord.gg/framework
16
-
17
- Clique no link ou cole-o no seu navegador para entrar.
1
+ ---
2
+ name: entrar-discord
3
+ description: Entrar na comunidade framework no Discord
4
+ ---
5
+
6
+ <objective>
7
+ Exibir o link de convite para o servidor da comunidade framework no Discord.
8
+ </objective>
9
+
10
+ <output>
11
+ # Entre no Discord do framework
12
+
13
+ Conecte-se com outros usuários do framework, obtenha ajuda, compartilhe o que está criando e fique atualizado.
14
+
15
+ **Link de convite:** https://discord.gg/framework
16
+
17
+ Clique no link ou cole-o no seu navegador para entrar.
18
18
  </output>
@@ -1,18 +1,18 @@
1
- ---
2
- name: estatisticas
3
- description: Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo
4
- allowed-tools:
5
- - Read
6
- - Bash
7
- ---
8
- <objective>
9
- Exibe estatísticas abrangentes do projeto incluindo progresso de fases, métricas de execução de planos, conclusão de requisitos, estatísticas de histórico git e linha do tempo do projeto.
10
- </objective>
11
-
12
- <execution_context>
13
- @./.claude/framework/workflows/stats.md
14
- </execution_context>
15
-
16
- <process>
17
- Execute o workflow stats de @./.claude/framework/workflows/stats.md do início ao fim.
18
- </process>
1
+ ---
2
+ name: estatisticas
3
+ description: Exibe estatísticas do projeto — fases, planos, requisitos, métricas git e linha do tempo
4
+ allowed-tools:
5
+ - Read
6
+ - Bash
7
+ ---
8
+ <objective>
9
+ Exibe estatísticas abrangentes do projeto incluindo progresso de fases, métricas de execução de planos, conclusão de requisitos, estatísticas de histórico git e linha do tempo do projeto.
10
+ </objective>
11
+
12
+ <execution_context>
13
+ @./.claude/framework/workflows/stats.md
14
+ </execution_context>
15
+
16
+ <process>
17
+ Execute o workflow stats de @./.claude/framework/workflows/stats.md do início ao fim.
18
+ </process>
@@ -1,33 +1,33 @@
1
- ---
2
- name: example-greeting
3
- description: Example slash-command template. Replace with your own. Greets the user and shows what kit-mcp can do.
4
- argument-hint: "[name]"
5
- allowed-tools:
6
- - Bash
7
- ---
8
-
9
- # /example-greeting
10
-
11
- Greet the user (by name if provided) and print a one-line summary of what
12
- kit-mcp does.
13
-
14
- ## Process
15
-
16
- 1. Parse `$ARGUMENTS` for an optional name.
17
- 2. Print:
18
- ```
19
- Hello <name>! kit-mcp is ready.
20
- <one-line summary of the kit's purpose>
21
- ```
22
- 3. Optionally, run `kit kit list-agents | head -3` so the user sees what's
23
- available.
24
-
25
- ## Notes
26
-
27
- This is a minimal template. Real commands typically:
28
- - Read STATE.md or other artifacts
29
- - Spawn sub-agents via `Task(subagent_type=...)`
30
- - Update files and commit
31
- - Route to a downstream command
32
-
33
- See the kit-mcp README for command authoring patterns.
1
+ ---
2
+ name: example-greeting
3
+ description: Example slash-command template. Replace with your own. Greets the user and shows what kit-mcp can do.
4
+ argument-hint: "[name]"
5
+ allowed-tools:
6
+ - Bash
7
+ ---
8
+
9
+ # /example-greeting
10
+
11
+ Greet the user (by name if provided) and print a one-line summary of what
12
+ kit-mcp does.
13
+
14
+ ## Process
15
+
16
+ 1. Parse `$ARGUMENTS` for an optional name.
17
+ 2. Print:
18
+ ```
19
+ Hello <name>! kit-mcp is ready.
20
+ <one-line summary of the kit's purpose>
21
+ ```
22
+ 3. Optionally, run `kit kit list-agents | head -3` so the user sees what's
23
+ available.
24
+
25
+ ## Notes
26
+
27
+ This is a minimal template. Real commands typically:
28
+ - Read STATE.md or other artifacts
29
+ - Spawn sub-agents via `Task(subagent_type=...)`
30
+ - Update files and commit
31
+ - Route to a downstream command
32
+
33
+ See the kit-mcp README for command authoring patterns.
@@ -1,59 +1,59 @@
1
- ---
2
- name: executar-fase
3
- description: Executa todos os planos de uma fase com paralelização por ondas
4
- argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Glob
10
- - Grep
11
- - Bash
12
- - Task
13
- - TodoWrite
14
- - AskUserQuestion
15
- ---
16
- <objective>
17
- Executa todos os planos de uma fase usando execução paralela por ondas.
18
-
19
- O orquestrador se mantém enxuto: descobrir planos, analisar dependências, agrupar em ondas, invocar subagentes, coletar resultados. Cada subagente carrega o contexto completo de execute-plan e cuida do seu próprio plano.
20
-
21
- Filtro de onda opcional:
22
- - `--wave N` executa apenas a Onda `N` para controle de ritmo, gestão de cota ou lançamento em etapas
23
- - verificação/conclusão da fase ainda ocorre apenas quando não há planos incompletos restantes após a onda selecionada terminar
24
-
25
- Regra de tratamento de flags:
26
- - As flags opcionais documentadas abaixo são comportamentos disponíveis, não comportamentos ativos implícitos
27
- - Uma flag está ativa apenas quando seu token literal aparece em `$ARGUMENTS`
28
- - Se uma flag documentada estiver ausente de `$ARGUMENTS`, trate-a como inativa
29
-
30
- Orçamento de contexto: ~15% orquestrador, 100% fresco por subagente.
31
- </objective>
32
-
33
- <execution_context>
34
- @./.claude/framework/workflows/execute-phase.md
35
- @./.claude/framework/references/ui-brand.md
36
- </execution_context>
37
-
38
- <context>
39
- Fase: $ARGUMENTS
40
-
41
- **Flags opcionais disponíveis (somente documentação — não automaticamente ativas):**
42
- - `--wave N` — Executar apenas a Onda `N` na fase. Use quando quiser controlar o ritmo da execução ou ficar dentro dos limites de uso.
43
- - `--gaps-only` — Executar apenas planos de fechamento de lacunas (planos com `gap_closure: true` no frontmatter). Use após verify-work criar planos de correção.
44
- - `--interactive` — Executar planos sequencialmente inline (sem subagentes) com checkpoints de usuário entre tarefas. Menor uso de tokens, estilo programação em par. Melhor para fases pequenas, correções de bugs e lacunas de verificação.
45
-
46
- **Flags ativas devem ser derivadas de `$ARGUMENTS`:**
47
- - `--wave N` está ativa somente se o token literal `--wave` estiver presente em `$ARGUMENTS`
48
- - `--gaps-only` está ativa somente se o token literal `--gaps-only` estiver presente em `$ARGUMENTS`
49
- - `--interactive` está ativa somente se o token literal `--interactive` estiver presente em `$ARGUMENTS`
50
- - Se nenhum desses tokens aparecer, executar o fluxo padrão de execução completa da fase sem filtragem específica de flag
51
- - Não inferir que uma flag está ativa apenas porque está documentada neste prompt
52
-
53
- Arquivos de contexto são resolvidos dentro do workflow via `tools init execute-phase` e blocos `<files_to_read>` por subagente.
54
- </context>
55
-
56
- <process>
57
- Execute o workflow execute-phase de @./.claude/framework/workflows/execute-phase.md do início ao fim.
58
- Preserve todos os checkpoints do workflow (execução de ondas, tratamento de checkpoints, verificação, atualizações de estado, roteamento).
1
+ ---
2
+ name: executar-fase
3
+ description: Executa todos os planos de uma fase com paralelização por ondas
4
+ argument-hint: "<phase-number> [--wave N] [--gaps-only] [--interactive]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Glob
10
+ - Grep
11
+ - Bash
12
+ - Task
13
+ - TodoWrite
14
+ - AskUserQuestion
15
+ ---
16
+ <objective>
17
+ Executa todos os planos de uma fase usando execução paralela por ondas.
18
+
19
+ O orquestrador se mantém enxuto: descobrir planos, analisar dependências, agrupar em ondas, invocar subagentes, coletar resultados. Cada subagente carrega o contexto completo de execute-plan e cuida do seu próprio plano.
20
+
21
+ Filtro de onda opcional:
22
+ - `--wave N` executa apenas a Onda `N` para controle de ritmo, gestão de cota ou lançamento em etapas
23
+ - verificação/conclusão da fase ainda ocorre apenas quando não há planos incompletos restantes após a onda selecionada terminar
24
+
25
+ Regra de tratamento de flags:
26
+ - As flags opcionais documentadas abaixo são comportamentos disponíveis, não comportamentos ativos implícitos
27
+ - Uma flag está ativa apenas quando seu token literal aparece em `$ARGUMENTS`
28
+ - Se uma flag documentada estiver ausente de `$ARGUMENTS`, trate-a como inativa
29
+
30
+ Orçamento de contexto: ~15% orquestrador, 100% fresco por subagente.
31
+ </objective>
32
+
33
+ <execution_context>
34
+ @./.claude/framework/workflows/execute-phase.md
35
+ @./.claude/framework/references/ui-brand.md
36
+ </execution_context>
37
+
38
+ <context>
39
+ Fase: $ARGUMENTS
40
+
41
+ **Flags opcionais disponíveis (somente documentação — não automaticamente ativas):**
42
+ - `--wave N` — Executar apenas a Onda `N` na fase. Use quando quiser controlar o ritmo da execução ou ficar dentro dos limites de uso.
43
+ - `--gaps-only` — Executar apenas planos de fechamento de lacunas (planos com `gap_closure: true` no frontmatter). Use após verify-work criar planos de correção.
44
+ - `--interactive` — Executar planos sequencialmente inline (sem subagentes) com checkpoints de usuário entre tarefas. Menor uso de tokens, estilo programação em par. Melhor para fases pequenas, correções de bugs e lacunas de verificação.
45
+
46
+ **Flags ativas devem ser derivadas de `$ARGUMENTS`:**
47
+ - `--wave N` está ativa somente se o token literal `--wave` estiver presente em `$ARGUMENTS`
48
+ - `--gaps-only` está ativa somente se o token literal `--gaps-only` estiver presente em `$ARGUMENTS`
49
+ - `--interactive` está ativa somente se o token literal `--interactive` estiver presente em `$ARGUMENTS`
50
+ - Se nenhum desses tokens aparecer, executar o fluxo padrão de execução completa da fase sem filtragem específica de flag
51
+ - Não inferir que uma flag está ativa apenas porque está documentada neste prompt
52
+
53
+ Arquivos de contexto são resolvidos dentro do workflow via `tools init execute-phase` e blocos `<files_to_read>` por subagente.
54
+ </context>
55
+
56
+ <process>
57
+ Execute o workflow execute-phase de @./.claude/framework/workflows/execute-phase.md do início ao fim.
58
+ Preserve todos os checkpoints do workflow (execução de ondas, tratamento de checkpoints, verificação, atualizações de estado, roteamento).
59
59
  </process>
@@ -1,56 +1,56 @@
1
- ---
2
- name: expresso
3
- description: Executa uma tarefa rápida com garantias framework (commits atômicos, rastreamento de estado) mas pula agentes opcionais
4
- argument-hint: "[--full] [--discuss] [--research]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Edit
9
- - Glob
10
- - Grep
11
- - Bash
12
- - Task
13
- - AskUserQuestion
14
- ---
15
- <objective>
16
- Executar tarefas pequenas e ad-hoc com garantias framework (commits atômicos, rastreamento no STATE.md).
17
-
18
- Modo expresso é o mesmo sistema com um caminho mais curto:
19
- - Invoca planner (modo rápido) + executor(s)
20
- - Tarefas expressas ficam em `.planning/quick/` separado das fases planejadas
21
- - Atualiza tabela "Quick Tasks Completed" do STATE.md (NÃO ROADMAP.md)
22
-
23
- **Padrão:** Pula pesquisa, discussão, plan-checker, verificador. Use quando você sabe exatamente o que fazer.
24
-
25
- **Flag `--discuss`:** Fase de discussão leve antes do planejamento. Apresenta hipóteses, esclarece áreas cinzentas, captura decisões em CONTEXT.md. Use quando a tarefa tem ambiguidade que vale a pena resolver antecipadamente.
26
-
27
- **Flag `--full`:** Habilita verificação de plano (máximo 2 iterações) e verificação pós-execução. Use quando você quer garantias de qualidade sem a cerimônia completa de milestone.
28
-
29
- **Flag `--research`:** Invoca um agente de pesquisa focado antes do planejamento. Investiga abordagens de implementação, opções de biblioteca e armadilhas para a tarefa. Use quando não tem certeza da melhor abordagem.
30
-
31
- Flags são combináveis: `--discuss --research --full` dá discussão + pesquisa + verificação de plano + verificação.
32
-
33
- ## Quando usar
34
-
35
- - ✅ Tarefa concreta de 5-30 min com necessidade de commit limpo + state tracking
36
- - ✅ Hotfix com ambiguidade (use `--discuss`)
37
- - ✅ Decisão técnica pequena com opções (use `--research`)
38
- - ❌ Trivialidade de 1 minuto — use `/rapido`
39
- - ❌ Trabalho que requer fases formais e verificação — use `/planejar-fase`
40
- - 🤔 Em dúvida? → **`/fazer "descrição"`** roteia automaticamente
41
- </objective>
42
-
43
- <execution_context>
44
- @./.claude/framework/workflows/quick.md
45
- </execution_context>
46
-
47
- <context>
48
- $ARGUMENTS
49
-
50
- Arquivos de contexto são resolvidos dentro do workflow (`init quick`) e delegados via blocos `<files_to_read>`.
51
- </context>
52
-
53
- <process>
54
- Execute o workflow quick de @./.claude/framework/workflows/quick.md do início ao fim.
55
- Preserve todos os checkpoints do workflow (validação, descrição de tarefa, planejamento, execução, atualizações de estado, commits).
56
- </process>
1
+ ---
2
+ name: expresso
3
+ description: Executa uma tarefa rápida com garantias framework (commits atômicos, rastreamento de estado) mas pula agentes opcionais
4
+ argument-hint: "[--full] [--discuss] [--research]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Edit
9
+ - Glob
10
+ - Grep
11
+ - Bash
12
+ - Task
13
+ - AskUserQuestion
14
+ ---
15
+ <objective>
16
+ Executar tarefas pequenas e ad-hoc com garantias framework (commits atômicos, rastreamento no STATE.md).
17
+
18
+ Modo expresso é o mesmo sistema com um caminho mais curto:
19
+ - Invoca planner (modo rápido) + executor(s)
20
+ - Tarefas expressas ficam em `.planning/quick/` separado das fases planejadas
21
+ - Atualiza tabela "Quick Tasks Completed" do STATE.md (NÃO ROADMAP.md)
22
+
23
+ **Padrão:** Pula pesquisa, discussão, plan-checker, verificador. Use quando você sabe exatamente o que fazer.
24
+
25
+ **Flag `--discuss`:** Fase de discussão leve antes do planejamento. Apresenta hipóteses, esclarece áreas cinzentas, captura decisões em CONTEXT.md. Use quando a tarefa tem ambiguidade que vale a pena resolver antecipadamente.
26
+
27
+ **Flag `--full`:** Habilita verificação de plano (máximo 2 iterações) e verificação pós-execução. Use quando você quer garantias de qualidade sem a cerimônia completa de milestone.
28
+
29
+ **Flag `--research`:** Invoca um agente de pesquisa focado antes do planejamento. Investiga abordagens de implementação, opções de biblioteca e armadilhas para a tarefa. Use quando não tem certeza da melhor abordagem.
30
+
31
+ Flags são combináveis: `--discuss --research --full` dá discussão + pesquisa + verificação de plano + verificação.
32
+
33
+ ## Quando usar
34
+
35
+ - ✅ Tarefa concreta de 5-30 min com necessidade de commit limpo + state tracking
36
+ - ✅ Hotfix com ambiguidade (use `--discuss`)
37
+ - ✅ Decisão técnica pequena com opções (use `--research`)
38
+ - ❌ Trivialidade de 1 minuto — use `/rapido`
39
+ - ❌ Trabalho que requer fases formais e verificação — use `/planejar-fase`
40
+ - 🤔 Em dúvida? → **`/fazer "descrição"`** roteia automaticamente
41
+ </objective>
42
+
43
+ <execution_context>
44
+ @./.claude/framework/workflows/quick.md
45
+ </execution_context>
46
+
47
+ <context>
48
+ $ARGUMENTS
49
+
50
+ Arquivos de contexto são resolvidos dentro do workflow (`init quick`) e delegados via blocos `<files_to_read>`.
51
+ </context>
52
+
53
+ <process>
54
+ Execute o workflow quick de @./.claude/framework/workflows/quick.md do início ao fim.
55
+ Preserve todos os checkpoints do workflow (validação, descrição de tarefa, planejamento, execução, atualizações de estado, commits).
56
+ </process>
@@ -1,34 +1,34 @@
1
- ---
2
- name: fase-ui
3
- description: Gera contrato de design UI (UI-SPEC.md) para fases de frontend
4
- argument-hint: "[fase]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - Task
12
- - WebFetch
13
- - AskUserQuestion
14
- - mcp__context7__*
15
- ---
16
- <objective>
17
- Cria um contrato de design UI (UI-SPEC.md) para uma fase de frontend.
18
- Orquestra os agentes ui-researcher e ui-checker.
19
- Fluxo: Validar → Pesquisar UI → Verificar UI-SPEC → Concluído
20
- </objective>
21
-
22
- <execution_context>
23
- @./.claude/framework/workflows/ui-phase.md
24
- @./.claude/framework/references/ui-brand.md
25
- </execution_context>
26
-
27
- <context>
28
- Número da fase: $ARGUMENTS — opcional, auto-detecta a próxima fase não planejada se omitido.
29
- </context>
30
-
31
- <process>
32
- Execute @./.claude/framework/workflows/ui-phase.md do início ao fim.
33
- Preserve todos os gates do workflow.
34
- </process>
1
+ ---
2
+ name: fase-ui
3
+ description: Gera contrato de design UI (UI-SPEC.md) para fases de frontend
4
+ argument-hint: "[fase]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - Task
12
+ - WebFetch
13
+ - AskUserQuestion
14
+ - mcp__context7__*
15
+ ---
16
+ <objective>
17
+ Cria um contrato de design UI (UI-SPEC.md) para uma fase de frontend.
18
+ Orquestra os agentes ui-researcher e ui-checker.
19
+ Fluxo: Validar → Pesquisar UI → Verificar UI-SPEC → Concluído
20
+ </objective>
21
+
22
+ <execution_context>
23
+ @./.claude/framework/workflows/ui-phase.md
24
+ @./.claude/framework/references/ui-brand.md
25
+ </execution_context>
26
+
27
+ <context>
28
+ Número da fase: $ARGUMENTS — opcional, auto-detecta a próxima fase não planejada se omitido.
29
+ </context>
30
+
31
+ <process>
32
+ Execute @./.claude/framework/workflows/ui-phase.md do início ao fim.
33
+ Preserve todos os gates do workflow.
34
+ </process>
@@ -1,58 +1,58 @@
1
- ---
2
- name: fazer
3
- description: Entrypoint canônico — roteia texto livre para o comando do framework correto. Use este quando estiver na dúvida.
4
- argument-hint: "<descrição do que você quer fazer>"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - AskUserQuestion
9
- ---
10
- <objective>
11
- **Entrypoint canônico do framework.** Quando você sabe o que quer mas não sabe qual `/*` executar, use `/fazer "descrição"`.
12
-
13
- `/fazer` é um despachante inteligente — nunca faz o trabalho diretamente; combina a intenção com o melhor comando e transfere com confirmação.
14
-
15
- ## Árvore de decisão
16
-
17
- | Sua intenção | Comando recomendado | Quando usar |
18
- |---|---|---|
19
- | Tarefa **trivial** (rename, ajuste pontual) | **`/rapido`** | Sem necessidade de plano formal; commit atômico, sem subagentes |
20
- | Tarefa **rápida com garantias** (commit limpo, rastreamento de estado) | **`/expresso`** | Algo concreto mas pequeno; pula agentes opcionais mas mantém disciplina |
21
- | Trabalho **estruturado** (multi-arquivo, requer planejamento) | **`/discutir-fase` → `/planejar-fase` → `/executar-fase`** | Fase real de milestone; usa agentes completos |
22
- | **Tarefa Supabase** (DB/Auth/Realtime/Edge/Storage/RLS/migration) | **`/supabase <subcomando>`** | Roteia para agent especializado: arquiteto / migration / rls / edge / realtime / auth / storage / rag / cron / check |
23
- | **Próximo passo** ambíguo no fluxo atual | **`/proximo`** | Avança no roadmap automaticamente |
24
- | **Capturar ideia** sem agir agora | **`/nota`** ou **`/adicionar-tarefa`** | Salva pra depois sem interromper o foco |
25
- | **Investigar bug** com método científico | **`/depurar`** | Hipótese → teste → fix com checkpoints |
26
-
27
- ## Detecção de intenção Supabase
28
-
29
- Se a descrição do user menciona qualquer destes termos, considere rotear para `/supabase` em vez de `/discutir-fase` ou `/expresso`:
30
-
31
- - **DB:** "migration", "RLS", "policy", "schema", "tabela Postgres", "supabase/migrations", "supabase/schemas"
32
- - **Auth:** "Supabase auth", "Next.js auth", "@supabase/ssr", "magic link", "OAuth", "MFA TOTP"
33
- - **Realtime:** "broadcast Supabase", "presence", "postgres_changes", "channel"
34
- - **Edge Functions:** "Edge Function", "Deno + Supabase", "supabase/functions"
35
- - **Storage:** "bucket", "signed URL", "upload Supabase"
36
- - **AI/RAG:** "pgvector", "embeddings + Supabase", "RAG with permissions"
37
- - **Background:** "pg_cron", "pgmq", "scheduled job Supabase"
38
-
39
- Para contexto sobre o que cada subcomando faz, leia [`/supabase`](./supabase.md) ou as 11 skills em `kit/skills/supabase-*/`.
40
-
41
- ## Aliases (continuam funcionando)
42
-
43
- `/rapido`, `/expresso`, `/proximo`, `/depurar`, `/discutir-fase`, `/planejar-fase`, `/executar-fase` — todos continuam executando direto, sem passar pelo `/fazer`. Use `/fazer` quando estiver em dúvida sobre qual escolher.
44
- </objective>
45
-
46
- <execution_context>
47
- @./.claude/framework/workflows/do.md
48
- @./.claude/framework/references/ui-brand.md
49
- </execution_context>
50
-
51
- <context>
52
- $ARGUMENTS
53
- </context>
54
-
55
- <process>
56
- Execute o workflow do de @./.claude/framework/workflows/do.md do início ao fim.
57
- Rotear a intenção do usuário para o melhor comando do framework e invocá-lo.
1
+ ---
2
+ name: fazer
3
+ description: Entrypoint canônico — roteia texto livre para o comando do framework correto. Use este quando estiver na dúvida.
4
+ argument-hint: "<descrição do que você quer fazer>"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - AskUserQuestion
9
+ ---
10
+ <objective>
11
+ **Entrypoint canônico do framework.** Quando você sabe o que quer mas não sabe qual `/*` executar, use `/fazer "descrição"`.
12
+
13
+ `/fazer` é um despachante inteligente — nunca faz o trabalho diretamente; combina a intenção com o melhor comando e transfere com confirmação.
14
+
15
+ ## Árvore de decisão
16
+
17
+ | Sua intenção | Comando recomendado | Quando usar |
18
+ |---|---|---|
19
+ | Tarefa **trivial** (rename, ajuste pontual) | **`/rapido`** | Sem necessidade de plano formal; commit atômico, sem subagentes |
20
+ | Tarefa **rápida com garantias** (commit limpo, rastreamento de estado) | **`/expresso`** | Algo concreto mas pequeno; pula agentes opcionais mas mantém disciplina |
21
+ | Trabalho **estruturado** (multi-arquivo, requer planejamento) | **`/discutir-fase` → `/planejar-fase` → `/executar-fase`** | Fase real de milestone; usa agentes completos |
22
+ | **Tarefa Supabase** (DB/Auth/Realtime/Edge/Storage/RLS/migration) | **`/supabase <subcomando>`** | Roteia para agent especializado: arquiteto / migration / rls / edge / realtime / auth / storage / rag / cron / check |
23
+ | **Próximo passo** ambíguo no fluxo atual | **`/proximo`** | Avança no roadmap automaticamente |
24
+ | **Capturar ideia** sem agir agora | **`/nota`** ou **`/adicionar-tarefa`** | Salva pra depois sem interromper o foco |
25
+ | **Investigar bug** com método científico | **`/depurar`** | Hipótese → teste → fix com checkpoints |
26
+
27
+ ## Detecção de intenção Supabase
28
+
29
+ Se a descrição do user menciona qualquer destes termos, considere rotear para `/supabase` em vez de `/discutir-fase` ou `/expresso`:
30
+
31
+ - **DB:** "migration", "RLS", "policy", "schema", "tabela Postgres", "supabase/migrations", "supabase/schemas"
32
+ - **Auth:** "Supabase auth", "Next.js auth", "@supabase/ssr", "magic link", "OAuth", "MFA TOTP"
33
+ - **Realtime:** "broadcast Supabase", "presence", "postgres_changes", "channel"
34
+ - **Edge Functions:** "Edge Function", "Deno + Supabase", "supabase/functions"
35
+ - **Storage:** "bucket", "signed URL", "upload Supabase"
36
+ - **AI/RAG:** "pgvector", "embeddings + Supabase", "RAG with permissions"
37
+ - **Background:** "pg_cron", "pgmq", "scheduled job Supabase"
38
+
39
+ Para contexto sobre o que cada subcomando faz, leia [`/supabase`](./supabase.md) ou as 11 skills em `kit/skills/supabase-*/`.
40
+
41
+ ## Aliases (continuam funcionando)
42
+
43
+ `/rapido`, `/expresso`, `/proximo`, `/depurar`, `/discutir-fase`, `/planejar-fase`, `/executar-fase` — todos continuam executando direto, sem passar pelo `/fazer`. Use `/fazer` quando estiver em dúvida sobre qual escolher.
44
+ </objective>
45
+
46
+ <execution_context>
47
+ @./.claude/framework/workflows/do.md
48
+ @./.claude/framework/references/ui-brand.md
49
+ </execution_context>
50
+
51
+ <context>
52
+ $ARGUMENTS
53
+ </context>
54
+
55
+ <process>
56
+ Execute o workflow do de @./.claude/framework/workflows/do.md do início ao fim.
57
+ Rotear a intenção do usuário para o melhor comando do framework e invocá-lo.
58
58
  </process>