@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,44 +1,44 @@
1
- ---
2
- name: novo-workspace
3
- description: Cria um workspace isolado com cópias de repos e .planning/ independente
4
- argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Write
9
- - AskUserQuestion
10
- ---
11
- <context>
12
- **Flags:**
13
- - `--name` (obrigatório) — Nome do workspace
14
- - `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
15
- - `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
16
- - `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
17
- - `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
18
- - `--auto` — Pular perguntas interativas, usar padrões
19
- </context>
20
-
21
- <objective>
22
- Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
23
-
24
- **Casos de uso:**
25
- - Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
26
- - Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
27
-
28
- **Cria:**
29
- - `<path>/WORKSPACE.md` — manifesto do workspace
30
- - `<path>/.planning/` — diretório de planejamento independente
31
- - `<path>/<repo>/` — git worktree ou clone para cada repo especificado
32
-
33
- **Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
34
- </objective>
35
-
36
- <execution_context>
37
- @./.claude/framework/workflows/new-workspace.md
38
- @./.claude/framework/references/ui-brand.md
39
- </execution_context>
40
-
41
- <process>
42
- Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
43
- Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
1
+ ---
2
+ name: novo-workspace
3
+ description: Cria um workspace isolado com cópias de repos e .planning/ independente
4
+ argument-hint: "--name <name> [--repos repo1,repo2] [--path /target] [--strategy worktree|clone] [--branch name] [--auto]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Write
9
+ - AskUserQuestion
10
+ ---
11
+ <context>
12
+ **Flags:**
13
+ - `--name` (obrigatório) — Nome do workspace
14
+ - `--repos` — Caminhos ou nomes de repos separados por vírgula. Se omitido, seleção interativa dos repos git filhos no cwd
15
+ - `--path` — Diretório de destino. Padrão: `~/workspaces/<name>`
16
+ - `--strategy` — `worktree` (padrão, leve) ou `clone` (totalmente independente)
17
+ - `--branch` — Branch para fazer checkout. Padrão: `workspace/<name>`
18
+ - `--auto` — Pular perguntas interativas, usar padrões
19
+ </context>
20
+
21
+ <objective>
22
+ Criar um diretório de workspace físico contendo cópias dos repos git especificados (como worktrees ou clones) com um diretório `.planning/` independente para sessões framework isoladas.
23
+
24
+ **Casos de uso:**
25
+ - Orquestração multi-repo: trabalhar em um subconjunto de repos em paralelo com estado framework isolado
26
+ - Isolamento de feature branch: criar um worktree do repo atual com seu próprio `.planning/`
27
+
28
+ **Cria:**
29
+ - `<path>/WORKSPACE.md` — manifesto do workspace
30
+ - `<path>/.planning/` — diretório de planejamento independente
31
+ - `<path>/<repo>/` — git worktree ou clone para cada repo especificado
32
+
33
+ **Após este comando:** `cd` no workspace e execute `/novo-projeto` para inicializar o framework.
34
+ </objective>
35
+
36
+ <execution_context>
37
+ @./.claude/framework/workflows/new-workspace.md
38
+ @./.claude/framework/references/ui-brand.md
39
+ </execution_context>
40
+
41
+ <process>
42
+ Execute o workflow new-workspace de @./.claude/framework/workflows/new-workspace.md do início ao fim.
43
+ Preserve todos os checkpoints do workflow (validação, aprovações, commits, roteamento).
44
44
  </process>
@@ -1,38 +1,38 @@
1
- ---
2
- name: pausar-trabalho
3
- description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
4
- allowed-tools:
5
- - Read
6
- - Write
7
- - Bash
8
- ---
9
-
10
- <objective>
11
- Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
12
-
13
- Encaminha para o workflow pause-work que cuida de:
14
- - Detecção da fase atual a partir de arquivos recentes
15
- - Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
16
- - Criação do arquivo de handoff com todas as seções de contexto
17
- - Commit git como WIP
18
- - Instruções de retomada
19
- </objective>
20
-
21
- <execution_context>
22
- @./.claude/framework/workflows/pause-work.md
23
- </execution_context>
24
-
25
- <context>
26
- Estado e progresso da fase são coletados no workflow com leituras específicas.
27
- </context>
28
-
29
- <process>
30
- **Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
31
-
32
- O workflow cuida de toda a lógica, incluindo:
33
- 1. Detecção do diretório de fase
34
- 2. Coleta de estado com esclarecimentos do usuário
35
- 3. Escrita do arquivo de handoff com timestamp
36
- 4. Commit git
37
- 5. Confirmação com instruções de retomada
1
+ ---
2
+ name: pausar-trabalho
3
+ description: Cria handoff de contexto ao pausar trabalho no meio de uma fase
4
+ allowed-tools:
5
+ - Read
6
+ - Write
7
+ - Bash
8
+ ---
9
+
10
+ <objective>
11
+ Criar arquivo de handoff `.continue-here.md` para preservar o estado completo do trabalho entre sessões.
12
+
13
+ Encaminha para o workflow pause-work que cuida de:
14
+ - Detecção da fase atual a partir de arquivos recentes
15
+ - Coleta completa de estado (posição, trabalho concluído, trabalho restante, decisões, bloqueadores)
16
+ - Criação do arquivo de handoff com todas as seções de contexto
17
+ - Commit git como WIP
18
+ - Instruções de retomada
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @./.claude/framework/workflows/pause-work.md
23
+ </execution_context>
24
+
25
+ <context>
26
+ Estado e progresso da fase são coletados no workflow com leituras específicas.
27
+ </context>
28
+
29
+ <process>
30
+ **Seguir o workflow pause-work** de `@./.claude/framework/workflows/pause-work.md`.
31
+
32
+ O workflow cuida de toda a lógica, incluindo:
33
+ 1. Detecção do diretório de fase
34
+ 2. Coleta de estado com esclarecimentos do usuário
35
+ 3. Escrita do arquivo de handoff com timestamp
36
+ 4. Commit git
37
+ 5. Confirmação com instruções de retomada
38
38
  </process>
@@ -1,46 +1,46 @@
1
- ---
2
- name: perfil-usuario
3
- description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
4
- argument-hint: "[--questionnaire] [--refresh]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- - Glob
10
- - Grep
11
- - AskUserQuestion
12
- - Task
13
- ---
14
-
15
- <objective>
16
- Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
17
-
18
- Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
19
- </objective>
20
-
21
- <execution_context>
22
- @./.claude/framework/workflows/profile-user.md
23
- @./.claude/framework/references/ui-brand.md
24
- </execution_context>
25
-
26
- <context>
27
- Flags de $ARGUMENTS:
28
- - `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
29
- - `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
30
- </context>
31
-
32
- <process>
33
- Execute o workflow profile-user do início ao fim.
34
-
35
- O workflow cuida de toda a lógica, incluindo:
36
- 1. Inicialização e detecção de perfil existente
37
- 2. Gate de consentimento antes da análise de sessão
38
- 3. Escaneamento de sessão e verificações de suficiência de dados
39
- 4. Análise de sessão (agente profiler) ou fallback de questionário
40
- 5. Resolução de divisão entre projetos
41
- 6. Escrita do perfil em USER-PROFILE.md
42
- 7. Exibição de resultado com card de relatório e destaques
43
- 8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
44
- 9. Geração sequencial de artefatos
45
- 10. Resumo com diff de atualização (se aplicável)
1
+ ---
2
+ name: perfil-usuario
3
+ description: Gera perfil comportamental do desenvolvedor e cria artefatos descobríveis pelo Claude
4
+ argument-hint: "[--questionnaire] [--refresh]"
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ - Glob
10
+ - Grep
11
+ - AskUserQuestion
12
+ - Task
13
+ ---
14
+
15
+ <objective>
16
+ Gerar um perfil comportamental do desenvolvedor a partir de análise de sessão (ou questionário) e produzir artefatos (USER-PROFILE.md, /preferencias-dev, seção CLAUDE.md) que personalizam as respostas do Claude.
17
+
18
+ Encaminha para o workflow profile-user que orquestra o fluxo completo: gate de consentimento, análise de sessão ou fallback de questionário, geração de perfil, exibição de resultados e seleção de artefatos.
19
+ </objective>
20
+
21
+ <execution_context>
22
+ @./.claude/framework/workflows/profile-user.md
23
+ @./.claude/framework/references/ui-brand.md
24
+ </execution_context>
25
+
26
+ <context>
27
+ Flags de $ARGUMENTS:
28
+ - `--questionnaire` -- Pular análise de sessão completamente, usar apenas questionário
29
+ - `--refresh` -- Reconstruir perfil mesmo quando existe, fazer backup do perfil antigo, mostrar diff de dimensão
30
+ </context>
31
+
32
+ <process>
33
+ Execute o workflow profile-user do início ao fim.
34
+
35
+ O workflow cuida de toda a lógica, incluindo:
36
+ 1. Inicialização e detecção de perfil existente
37
+ 2. Gate de consentimento antes da análise de sessão
38
+ 3. Escaneamento de sessão e verificações de suficiência de dados
39
+ 4. Análise de sessão (agente profiler) ou fallback de questionário
40
+ 5. Resolução de divisão entre projetos
41
+ 6. Escrita do perfil em USER-PROFILE.md
42
+ 7. Exibição de resultado com card de relatório e destaques
43
+ 8. Seleção de artefato (preferencias-dev, seções CLAUDE.md)
44
+ 9. Geração sequencial de artefatos
45
+ 10. Resumo com diff de atualização (se aplicável)
46
46
  </process>
@@ -1,195 +1,195 @@
1
- ---
2
- name: pesquisar-fase
3
- description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
4
- argument-hint: "[fase]"
5
- allowed-tools:
6
- - Read
7
- - Bash
8
- - Task
9
- ---
10
-
11
- <objective>
12
- Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
13
-
14
- **Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
15
-
16
- **Use este comando quando:**
17
- - Você quer pesquisar sem planejar ainda
18
- - Você quer re-pesquisar após o planejamento estar completo
19
- - Você precisa investigar antes de decidir se uma fase é viável
20
-
21
- **Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
22
-
23
- **Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
24
- </objective>
25
-
26
- <available_agent_types>
27
- Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
28
- - phase-researcher — Pesquisa abordagens técnicas para uma fase
29
- </available_agent_types>
30
-
31
- <context>
32
- Número da fase: $ARGUMENTS (obrigatório)
33
-
34
- Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
35
- </context>
36
-
37
- <process>
38
-
39
- ## 0. Inicializar Contexto
40
-
41
- ```bash
42
- INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
43
- if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
44
- ```
45
-
46
- Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
47
-
48
- Resolver modelo do pesquisador:
49
- ```bash
50
- RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
51
- ```
52
-
53
- ## 1. Validar Fase
54
-
55
- ```bash
56
- PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
57
- ```
58
-
59
- **Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
60
-
61
- ## 2. Verificar Pesquisa Existente
62
-
63
- ```bash
64
- ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
65
- ```
66
-
67
- **Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
68
-
69
- **Se não existir:** Continuar.
70
-
71
- ## 3. Reunir Contexto da Fase
72
-
73
- Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
74
- - `requirements_path`
75
- - `context_path`
76
- - `state_path`
77
-
78
- Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
79
-
80
- ## 4. Invocar Agente phase-researcher
81
-
82
- Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
83
-
84
- ```markdown
85
- <research_type>
86
- Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
87
- </research_type>
88
-
89
- <key_insight>
90
- A questão NÃO é "qual biblioteca devo usar?"
91
-
92
- A questão é: "O que eu não sei que não sei?"
93
-
94
- Para esta fase, descobrir:
95
- - Qual é o padrão de arquitetura estabelecido?
96
- - Quais bibliotecas formam o stack padrão?
97
- - Quais problemas as pessoas comumente encontram?
98
- - Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
99
- - O que NÃO deve ser feito manualmente?
100
- </key_insight>
101
-
102
- <objective>
103
- Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
104
- Modo: ecosystem
105
- </objective>
106
-
107
- <files_to_read>
108
- - {requirements_path} (Requisitos)
109
- - {context_path} (Contexto da fase do discutir-fase, se existir)
110
- - {state_path} (Decisões e bloqueadores anteriores do projeto)
111
- </files_to_read>
112
-
113
- <additional_context>
114
- **Descrição da fase:** {phase_description}
115
- </additional_context>
116
-
117
- <downstream_consumer>
118
- Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
119
- - `## Standard Stack` → Planos usam essas bibliotecas
120
- - `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
121
- - `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
122
- - `## Common Pitfalls` → Etapas de verificação checam por esses problemas
123
- - `## Code Examples` → Ações de tarefas referenciam esses padrões
124
-
125
- Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
126
- </downstream_consumer>
127
-
128
- <quality_gate>
129
- Antes de declarar completo, verificar:
130
- - [ ] Todos os domínios investigados (não apenas alguns)
131
- - [ ] Afirmações negativas verificadas com documentação oficial
132
- - [ ] Múltiplas fontes para afirmações críticas
133
- - [ ] Níveis de confiança atribuídos honestamente
134
- - [ ] Nomes de seções correspondem ao que o planejar-fase espera
135
- </quality_gate>
136
-
137
- <output>
138
- Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
139
- </output>
140
- ```
141
-
142
- ```
143
- Task(
144
- prompt=filled_prompt,
145
- subagent_type="phase-researcher",
146
- model="{researcher_model}",
147
- description="Pesquisar Fase {phase}"
148
- )
149
- ```
150
-
151
- ## 5. Tratar Retorno do Agente
152
-
153
- **`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
154
-
155
- **`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
156
-
157
- **`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
158
-
159
- ## 6. Invocar Agente de Continuação
160
-
161
- ```markdown
162
- <objective>
163
- Continuar pesquisa para Fase {phase_number}: {phase_name}
164
- </objective>
165
-
166
- <prior_state>
167
- <files_to_read>
168
- - .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
169
- </files_to_read>
170
- </prior_state>
171
-
172
- <checkpoint_response>
173
- **Tipo:** {checkpoint_type}
174
- **Resposta:** {user_response}
175
- </checkpoint_response>
176
- ```
177
-
178
- ```
179
- Task(
180
- prompt=continuation_prompt,
181
- subagent_type="phase-researcher",
182
- model="{researcher_model}",
183
- description="Continuar pesquisa Fase {phase}"
184
- )
185
- ```
186
-
187
- </process>
188
-
189
- <success_criteria>
190
- - [ ] Fase validada contra o roadmap
191
- - [ ] Pesquisa existente verificada
192
- - [ ] phase-researcher invocado com contexto
193
- - [ ] Checkpoints tratados corretamente
194
- - [ ] Usuário sabe os próximos passos
195
- </success_criteria>
1
+ ---
2
+ name: pesquisar-fase
3
+ description: Pesquisa como implementar uma fase (standalone — geralmente use /planejar-fase)
4
+ argument-hint: "[fase]"
5
+ allowed-tools:
6
+ - Read
7
+ - Bash
8
+ - Task
9
+ ---
10
+
11
+ <objective>
12
+ Pesquisa como implementar uma fase. Invoca o agente phase-researcher com o contexto da fase.
13
+
14
+ **Nota:** Este é um comando de pesquisa standalone. Para a maioria dos fluxos, use `/planejar-fase` que integra a pesquisa automaticamente.
15
+
16
+ **Use este comando quando:**
17
+ - Você quer pesquisar sem planejar ainda
18
+ - Você quer re-pesquisar após o planejamento estar completo
19
+ - Você precisa investigar antes de decidir se uma fase é viável
20
+
21
+ **Papel do orquestrador:** Analisar fase, validar contra o roadmap, verificar pesquisa existente, reunir contexto, invocar agente pesquisador, apresentar resultados.
22
+
23
+ **Por que subagente:** Pesquisa consome contexto rapidamente (WebSearch, consultas Context7, verificação de fontes). Contexto fresco de 200k para investigação. Contexto principal fica enxuto para interação com o usuário.
24
+ </objective>
25
+
26
+ <available_agent_types>
27
+ Tipos de subagentes framework válidos (use nomes exatos — não use 'general-purpose' como fallback):
28
+ - phase-researcher — Pesquisa abordagens técnicas para uma fase
29
+ </available_agent_types>
30
+
31
+ <context>
32
+ Número da fase: $ARGUMENTS (obrigatório)
33
+
34
+ Normalizar entrada da fase no passo 1 antes de qualquer busca de diretório.
35
+ </context>
36
+
37
+ <process>
38
+
39
+ ## 0. Inicializar Contexto
40
+
41
+ ```bash
42
+ INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "$ARGUMENTS")
43
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
44
+ ```
45
+
46
+ Extrair do JSON de init: `phase_dir`, `phase_number`, `phase_name`, `phase_found`, `commit_docs`, `has_research`, `state_path`, `requirements_path`, `context_path`, `research_path`.
47
+
48
+ Resolver modelo do pesquisador:
49
+ ```bash
50
+ RESEARCHER_MODEL=$(node "./.claude/framework/bin/tools.cjs" resolve-model phase-researcher --raw)
51
+ ```
52
+
53
+ ## 1. Validar Fase
54
+
55
+ ```bash
56
+ PHASE_INFO=$(node "./.claude/framework/bin/tools.cjs" roadmap get-phase "${phase_number}")
57
+ ```
58
+
59
+ **Se `found` for false:** Erro e sair. **Se `found` for true:** Extrair `phase_number`, `phase_name`, `goal` do JSON.
60
+
61
+ ## 2. Verificar Pesquisa Existente
62
+
63
+ ```bash
64
+ ls .planning/phases/${PHASE}-*/RESEARCH.md 2>/dev/null
65
+ ```
66
+
67
+ **Se existir:** Oferecer: 1) Atualizar pesquisa, 2) Ver existente, 3) Pular. Aguardar resposta.
68
+
69
+ **Se não existir:** Continuar.
70
+
71
+ ## 3. Reunir Contexto da Fase
72
+
73
+ Usar caminhos do INIT (não colocar conteúdo de arquivos inline no contexto do orquestrador):
74
+ - `requirements_path`
75
+ - `context_path`
76
+ - `state_path`
77
+
78
+ Apresentar resumo com descrição da fase e quais arquivos o pesquisador vai carregar.
79
+
80
+ ## 4. Invocar Agente phase-researcher
81
+
82
+ Modos de pesquisa: ecosystem (padrão), feasibility, implementation, comparison.
83
+
84
+ ```markdown
85
+ <research_type>
86
+ Pesquisa de Fase — investigando COMO implementar uma fase específica bem.
87
+ </research_type>
88
+
89
+ <key_insight>
90
+ A questão NÃO é "qual biblioteca devo usar?"
91
+
92
+ A questão é: "O que eu não sei que não sei?"
93
+
94
+ Para esta fase, descobrir:
95
+ - Qual é o padrão de arquitetura estabelecido?
96
+ - Quais bibliotecas formam o stack padrão?
97
+ - Quais problemas as pessoas comumente encontram?
98
+ - Qual é o SOTA vs o que o treinamento do Claude acha que é SOTA?
99
+ - O que NÃO deve ser feito manualmente?
100
+ </key_insight>
101
+
102
+ <objective>
103
+ Pesquisar abordagem de implementação para Fase {phase_number}: {phase_name}
104
+ Modo: ecosystem
105
+ </objective>
106
+
107
+ <files_to_read>
108
+ - {requirements_path} (Requisitos)
109
+ - {context_path} (Contexto da fase do discutir-fase, se existir)
110
+ - {state_path} (Decisões e bloqueadores anteriores do projeto)
111
+ </files_to_read>
112
+
113
+ <additional_context>
114
+ **Descrição da fase:** {phase_description}
115
+ </additional_context>
116
+
117
+ <downstream_consumer>
118
+ Seu RESEARCH.md será carregado pelo `/planejar-fase` que usa seções específicas:
119
+ - `## Standard Stack` → Planos usam essas bibliotecas
120
+ - `## Architecture Patterns` → Estrutura de tarefas segue esses padrões
121
+ - `## Don't Hand-Roll` → Tarefas NUNCA constroem soluções customizadas para problemas listados
122
+ - `## Common Pitfalls` → Etapas de verificação checam por esses problemas
123
+ - `## Code Examples` → Ações de tarefas referenciam esses padrões
124
+
125
+ Seja prescritivo, não exploratório. "Use X" não "Considere X ou Y."
126
+ </downstream_consumer>
127
+
128
+ <quality_gate>
129
+ Antes de declarar completo, verificar:
130
+ - [ ] Todos os domínios investigados (não apenas alguns)
131
+ - [ ] Afirmações negativas verificadas com documentação oficial
132
+ - [ ] Múltiplas fontes para afirmações críticas
133
+ - [ ] Níveis de confiança atribuídos honestamente
134
+ - [ ] Nomes de seções correspondem ao que o planejar-fase espera
135
+ </quality_gate>
136
+
137
+ <output>
138
+ Escrever em: .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md
139
+ </output>
140
+ ```
141
+
142
+ ```
143
+ Task(
144
+ prompt=filled_prompt,
145
+ subagent_type="phase-researcher",
146
+ model="{researcher_model}",
147
+ description="Pesquisar Fase {phase}"
148
+ )
149
+ ```
150
+
151
+ ## 5. Tratar Retorno do Agente
152
+
153
+ **`## RESEARCH COMPLETE`:** Exibir resumo, oferecer: Planejar fase, Aprofundar, Revisar completo, Concluído.
154
+
155
+ **`## CHECKPOINT REACHED`:** Apresentar ao usuário, obter resposta, invocar continuação.
156
+
157
+ **`## RESEARCH INCONCLUSIVE`:** Mostrar o que foi tentado, oferecer: Adicionar contexto, Tentar modo diferente, Manual.
158
+
159
+ ## 6. Invocar Agente de Continuação
160
+
161
+ ```markdown
162
+ <objective>
163
+ Continuar pesquisa para Fase {phase_number}: {phase_name}
164
+ </objective>
165
+
166
+ <prior_state>
167
+ <files_to_read>
168
+ - .planning/phases/${PHASE}-{slug}/${PHASE}-RESEARCH.md (Pesquisa existente)
169
+ </files_to_read>
170
+ </prior_state>
171
+
172
+ <checkpoint_response>
173
+ **Tipo:** {checkpoint_type}
174
+ **Resposta:** {user_response}
175
+ </checkpoint_response>
176
+ ```
177
+
178
+ ```
179
+ Task(
180
+ prompt=continuation_prompt,
181
+ subagent_type="phase-researcher",
182
+ model="{researcher_model}",
183
+ description="Continuar pesquisa Fase {phase}"
184
+ )
185
+ ```
186
+
187
+ </process>
188
+
189
+ <success_criteria>
190
+ - [ ] Fase validada contra o roadmap
191
+ - [ ] Pesquisa existente verificada
192
+ - [ ] phase-researcher invocado com contexto
193
+ - [ ] Checkpoints tratados corretamente
194
+ - [ ] Usuário sabe os próximos passos
195
+ </success_criteria>