@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,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>