@luanpdd/kit-mcp 1.27.0 → 1.28.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 (323) hide show
  1. package/LICENSE +21 -21
  2. package/README.md +168 -914
  3. package/gates/agent-no-recursive-dispatch.md +45 -11
  4. package/kit/COMANDOS.md +138 -138
  5. package/kit/README.md +76 -76
  6. package/kit/agents/advisor-researcher.md +106 -106
  7. package/kit/agents/assumptions-analyzer.md +107 -107
  8. package/kit/agents/audit-log-implementer.md +1 -1
  9. package/kit/agents/auditor-consistencia-isolamento.md +1 -1
  10. package/kit/agents/b2b-saas-architect.md +1 -1
  11. package/kit/agents/cascading-failures-auditor.md +1 -1
  12. package/kit/agents/codebase-mapper.md +768 -768
  13. package/kit/agents/crm-pipeline-implementer.md +1 -1
  14. package/kit/agents/debugger.md +813 -813
  15. package/kit/agents/detector-tenant-quente.md +1 -1
  16. package/kit/agents/evolution-go-integrator.md +1 -1
  17. package/kit/agents/example-reviewer.md +21 -21
  18. package/kit/agents/executor.md +564 -564
  19. package/kit/agents/integration-checker.md +200 -200
  20. package/kit/agents/invite-flow-implementer.md +1 -1
  21. package/kit/agents/legacy-characterizer.md +1 -1
  22. package/kit/agents/lgpd-compliance-auditor.md +1 -1
  23. package/kit/agents/multi-tenant-isolation-auditor.md +1 -1
  24. package/kit/agents/multi-tenant-rls-writer.md +1 -1
  25. package/kit/agents/nyquist-auditor.md +178 -178
  26. package/kit/agents/observability-coverage-auditor.md +1 -1
  27. package/kit/agents/org-onboarding-implementer.md +1 -1
  28. package/kit/agents/payload-capture-instrumenter.md +1 -1
  29. package/kit/agents/phase-researcher.md +696 -696
  30. package/kit/agents/plan-checker.md +272 -272
  31. package/kit/agents/planner.md +922 -922
  32. package/kit/agents/project-researcher.md +652 -652
  33. package/kit/agents/refactor-safety-auditor.md +1 -1
  34. package/kit/agents/research-synthesizer.md +245 -245
  35. package/kit/agents/roadmapper.md +677 -677
  36. package/kit/agents/seam-finder.md +1 -1
  37. package/kit/agents/shotgun-surgery-detector.md +1 -1
  38. package/kit/agents/supabase-branching-architect.md +1 -1
  39. package/kit/agents/supabase-cicd-pipeline-implementer.md +1 -1
  40. package/kit/agents/supabase-column-privileges-writer.md +1 -1
  41. package/kit/agents/supabase-migration-writer.md +1 -1
  42. package/kit/agents/supabase-rbac-implementer.md +1 -1
  43. package/kit/agents/supabase-rls-hardener.md +1 -1
  44. package/kit/agents/supabase-rls-writer.md +1 -1
  45. package/kit/agents/supabase-roles-implementer.md +1 -1
  46. package/kit/agents/super-admin-implementer.md +1 -1
  47. package/kit/agents/ui-auditor.md +437 -437
  48. package/kit/agents/ui-checker.md +302 -302
  49. package/kit/agents/ui-researcher.md +355 -355
  50. package/kit/agents/user-profiler.md +175 -175
  51. package/kit/agents/validador-evolucao-schema.md +1 -1
  52. package/kit/agents/verifier.md +728 -728
  53. package/kit/commands/adicionar-backlog.md +75 -75
  54. package/kit/commands/adicionar-fase.md +42 -42
  55. package/kit/commands/adicionar-tarefa.md +45 -45
  56. package/kit/commands/adicionar-testes.md +41 -41
  57. package/kit/commands/ajuda.md +21 -21
  58. package/kit/commands/atualizar.md +37 -37
  59. package/kit/commands/auditar-cascading.md +1 -1
  60. package/kit/commands/auditar-marco.md +179 -179
  61. package/kit/commands/auditar-observabilidade-cobertura.md +1 -1
  62. package/kit/commands/auditar-refactor.md +1 -1
  63. package/kit/commands/auditar-release.md +1 -1
  64. package/kit/commands/auditar-uat.md +23 -23
  65. package/kit/commands/autonomo.md +40 -40
  66. package/kit/commands/branch-pr.md +24 -24
  67. package/kit/commands/burn-rate-status.md +1 -1
  68. package/kit/commands/capturar-payloads.md +1 -1
  69. package/kit/commands/caracterizar.md +1 -1
  70. package/kit/commands/concluir-marco.md +247 -247
  71. package/kit/commands/configuracoes.md +36 -36
  72. package/kit/commands/dados-distribuidos.md +1 -1
  73. package/kit/commands/definir-perfil.md +10 -10
  74. package/kit/commands/depurar.md +190 -190
  75. package/kit/commands/detectar-duplicacao.md +1 -1
  76. package/kit/commands/discutir-fase.md +131 -131
  77. package/kit/commands/encontrar-seams.md +1 -1
  78. package/kit/commands/entrar-discord.md +17 -17
  79. package/kit/commands/estatisticas.md +18 -18
  80. package/kit/commands/example-greeting.md +33 -33
  81. package/kit/commands/executar-fase.md +58 -58
  82. package/kit/commands/expresso.md +56 -56
  83. package/kit/commands/fase-ui.md +34 -34
  84. package/kit/commands/fazer.md +57 -57
  85. package/kit/commands/fio.md +125 -125
  86. package/kit/commands/fluxos-trabalho.md +64 -64
  87. package/kit/commands/forense.md +176 -176
  88. package/kit/commands/gerenciador.md +38 -38
  89. package/kit/commands/inserir-fase.md +31 -31
  90. package/kit/commands/legacy.md +1 -1
  91. package/kit/commands/limpeza.md +17 -17
  92. package/kit/commands/listar-hipoteses-fase.md +45 -45
  93. package/kit/commands/listar-workspaces.md +18 -18
  94. package/kit/commands/load-shedding.md +1 -1
  95. package/kit/commands/mapear-codebase.md +70 -70
  96. package/kit/commands/multi-tenant.md +1 -1
  97. package/kit/commands/nota.md +33 -33
  98. package/kit/commands/novo-marco.md +43 -43
  99. package/kit/commands/novo-projeto.md +41 -41
  100. package/kit/commands/novo-workspace.md +43 -43
  101. package/kit/commands/pausar-trabalho.md +37 -37
  102. package/kit/commands/perfil-usuario.md +45 -45
  103. package/kit/commands/pesquisar-fase.md +195 -195
  104. package/kit/commands/planejar-fase.md +67 -67
  105. package/kit/commands/planejar-lacunas.md +33 -33
  106. package/kit/commands/plantar-ideia.md +25 -25
  107. package/kit/commands/progresso.md +24 -24
  108. package/kit/commands/proximo.md +30 -30
  109. package/kit/commands/publicar.md +490 -490
  110. package/kit/commands/rapido.md +35 -35
  111. package/kit/commands/reaplicar-patches.md +124 -124
  112. package/kit/commands/refactor-seguro.md +1 -1
  113. package/kit/commands/relatorio-sessao.md +19 -19
  114. package/kit/commands/remover-fase.md +31 -31
  115. package/kit/commands/remover-workspace.md +26 -26
  116. package/kit/commands/resumo-marco.md +50 -50
  117. package/kit/commands/retomar-trabalho.md +40 -40
  118. package/kit/commands/revisar-backlog.md +60 -60
  119. package/kit/commands/revisar-ui.md +32 -32
  120. package/kit/commands/revisar.md +37 -37
  121. package/kit/commands/saude.md +21 -21
  122. package/kit/commands/setup-notion.md +93 -93
  123. package/kit/commands/storytelling.md +1 -1
  124. package/kit/commands/supabase.md +1 -1
  125. package/kit/commands/sync-main.md +68 -68
  126. package/kit/commands/validar-fase.md +35 -35
  127. package/kit/commands/verificar-tarefas.md +44 -44
  128. package/kit/commands/verificar-trabalho.md +64 -64
  129. package/kit/file-manifest.json +90 -90
  130. package/kit/framework/bin/lib/commands.cjs +959 -959
  131. package/kit/framework/bin/lib/config.cjs +442 -442
  132. package/kit/framework/bin/lib/core.cjs +1230 -1230
  133. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  134. package/kit/framework/bin/lib/init.cjs +1442 -1442
  135. package/kit/framework/bin/lib/milestone.cjs +252 -252
  136. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  137. package/kit/framework/bin/lib/phase.cjs +888 -888
  138. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  139. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  140. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  141. package/kit/framework/bin/lib/security.cjs +382 -382
  142. package/kit/framework/bin/lib/state.cjs +1031 -1031
  143. package/kit/framework/bin/lib/template.cjs +222 -222
  144. package/kit/framework/bin/lib/uat.cjs +282 -282
  145. package/kit/framework/bin/lib/verify.cjs +888 -888
  146. package/kit/framework/bin/lib/workstream.cjs +491 -491
  147. package/kit/framework/bin/tools.cjs +918 -918
  148. package/kit/framework/commands/workstreams.md +63 -63
  149. package/kit/framework/references/checkpoints.md +778 -778
  150. package/kit/framework/references/continuation-format.md +249 -249
  151. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  152. package/kit/framework/references/git-integration.md +295 -295
  153. package/kit/framework/references/git-planning-commit.md +38 -38
  154. package/kit/framework/references/model-profile-resolution.md +36 -36
  155. package/kit/framework/references/model-profiles.md +139 -139
  156. package/kit/framework/references/phase-argument-parsing.md +61 -61
  157. package/kit/framework/references/planning-config.md +202 -202
  158. package/kit/framework/references/questioning.md +162 -162
  159. package/kit/framework/references/tdd.md +263 -263
  160. package/kit/framework/references/ui-brand.md +160 -160
  161. package/kit/framework/references/user-profiling.md +657 -657
  162. package/kit/framework/references/verification-patterns.md +612 -612
  163. package/kit/framework/references/workstream-flag.md +58 -58
  164. package/kit/framework/templates/DEBUG.md +164 -164
  165. package/kit/framework/templates/UAT.md +265 -265
  166. package/kit/framework/templates/UI-SPEC.md +100 -100
  167. package/kit/framework/templates/VALIDATION.md +76 -76
  168. package/kit/framework/templates/claude-md.md +122 -122
  169. package/kit/framework/templates/codebase/architecture.md +185 -185
  170. package/kit/framework/templates/codebase/concerns.md +205 -205
  171. package/kit/framework/templates/codebase/conventions.md +204 -204
  172. package/kit/framework/templates/codebase/integrations.md +192 -192
  173. package/kit/framework/templates/codebase/stack.md +158 -158
  174. package/kit/framework/templates/codebase/structure.md +199 -199
  175. package/kit/framework/templates/codebase/testing.md +301 -301
  176. package/kit/framework/templates/config.json +44 -44
  177. package/kit/framework/templates/context.md +352 -352
  178. package/kit/framework/templates/continue-here.md +78 -78
  179. package/kit/framework/templates/copilot-instructions.md +7 -7
  180. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  181. package/kit/framework/templates/dev-preferences.md +20 -20
  182. package/kit/framework/templates/discovery.md +146 -146
  183. package/kit/framework/templates/discussion-log.md +63 -63
  184. package/kit/framework/templates/milestone-archive.md +123 -123
  185. package/kit/framework/templates/milestone.md +115 -115
  186. package/kit/framework/templates/phase-prompt.md +610 -610
  187. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  188. package/kit/framework/templates/project.md +186 -186
  189. package/kit/framework/templates/requirements.md +231 -231
  190. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  191. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  192. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  193. package/kit/framework/templates/research-project/STACK.md +120 -120
  194. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  195. package/kit/framework/templates/research.md +419 -419
  196. package/kit/framework/templates/retrospective.md +54 -54
  197. package/kit/framework/templates/roadmap.md +202 -202
  198. package/kit/framework/templates/state.md +176 -176
  199. package/kit/framework/templates/summary-complex.md +59 -59
  200. package/kit/framework/templates/summary-minimal.md +41 -41
  201. package/kit/framework/templates/summary-standard.md +48 -48
  202. package/kit/framework/templates/summary.md +209 -209
  203. package/kit/framework/templates/user-profile.md +146 -146
  204. package/kit/framework/templates/user-setup.md +256 -256
  205. package/kit/framework/templates/verification-report.md +258 -258
  206. package/kit/framework/workflows/add-phase.md +112 -112
  207. package/kit/framework/workflows/add-tests.md +351 -351
  208. package/kit/framework/workflows/add-todo.md +158 -158
  209. package/kit/framework/workflows/audit-milestone.md +340 -340
  210. package/kit/framework/workflows/audit-uat.md +109 -109
  211. package/kit/framework/workflows/autonomous.md +891 -891
  212. package/kit/framework/workflows/check-todos.md +177 -177
  213. package/kit/framework/workflows/cleanup.md +152 -152
  214. package/kit/framework/workflows/complete-milestone.md +696 -696
  215. package/kit/framework/workflows/diagnose-issues.md +231 -231
  216. package/kit/framework/workflows/discovery-phase.md +289 -289
  217. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  218. package/kit/framework/workflows/discuss-phase.md +784 -784
  219. package/kit/framework/workflows/do.md +104 -104
  220. package/kit/framework/workflows/execute-phase.md +838 -838
  221. package/kit/framework/workflows/execute-plan.md +510 -510
  222. package/kit/framework/workflows/fast.md +102 -102
  223. package/kit/framework/workflows/forensics.md +265 -265
  224. package/kit/framework/workflows/health.md +181 -181
  225. package/kit/framework/workflows/help.md +619 -619
  226. package/kit/framework/workflows/insert-phase.md +130 -130
  227. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  228. package/kit/framework/workflows/list-workspaces.md +56 -56
  229. package/kit/framework/workflows/manager.md +362 -362
  230. package/kit/framework/workflows/map-codebase.md +377 -377
  231. package/kit/framework/workflows/milestone-summary.md +223 -223
  232. package/kit/framework/workflows/new-milestone.md +486 -486
  233. package/kit/framework/workflows/new-project.md +1159 -1159
  234. package/kit/framework/workflows/new-workspace.md +237 -237
  235. package/kit/framework/workflows/next.md +97 -97
  236. package/kit/framework/workflows/node-repair.md +92 -92
  237. package/kit/framework/workflows/note.md +156 -156
  238. package/kit/framework/workflows/pause-work.md +176 -176
  239. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  240. package/kit/framework/workflows/plan-phase.md +765 -765
  241. package/kit/framework/workflows/plant-seed.md +169 -169
  242. package/kit/framework/workflows/pr-branch.md +129 -129
  243. package/kit/framework/workflows/profile-user.md +450 -450
  244. package/kit/framework/workflows/progress.md +507 -507
  245. package/kit/framework/workflows/quick.md +757 -757
  246. package/kit/framework/workflows/remove-phase.md +155 -155
  247. package/kit/framework/workflows/remove-workspace.md +90 -90
  248. package/kit/framework/workflows/research-phase.md +82 -82
  249. package/kit/framework/workflows/resume-project.md +326 -326
  250. package/kit/framework/workflows/review.md +228 -228
  251. package/kit/framework/workflows/session-report.md +146 -146
  252. package/kit/framework/workflows/settings.md +283 -283
  253. package/kit/framework/workflows/ship.md +228 -228
  254. package/kit/framework/workflows/stats.md +60 -60
  255. package/kit/framework/workflows/transition.md +671 -671
  256. package/kit/framework/workflows/ui-phase.md +302 -302
  257. package/kit/framework/workflows/ui-review.md +165 -165
  258. package/kit/framework/workflows/update.md +323 -323
  259. package/kit/framework/workflows/validate-phase.md +174 -174
  260. package/kit/framework/workflows/verify-phase.md +252 -252
  261. package/kit/framework/workflows/verify-work.md +637 -637
  262. package/kit/hooks/check-update.js +118 -118
  263. package/kit/hooks/context-monitor.js +163 -163
  264. package/kit/hooks/prompt-guard.js +103 -103
  265. package/kit/hooks/statusline.js +125 -125
  266. package/kit/hooks/workflow-guard.js +101 -101
  267. package/kit/settings.json +45 -45
  268. package/kit/skills/ai-prompt-characterization/SKILL.md +1 -1
  269. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +1 -1
  270. package/kit/skills/audit-log-multi-tenant/SKILL.md +1 -1
  271. package/kit/skills/b2b-saas-architecture/SKILL.md +1 -1
  272. package/kit/skills/consistencia-leitura-replica/SKILL.md +1 -1
  273. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +1 -1
  274. package/kit/skills/escolha-modelo-consistencia/SKILL.md +1 -1
  275. package/kit/skills/evolucao-schema-compativel/SKILL.md +1 -1
  276. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +1 -1
  277. package/kit/skills/example-skill/SKILL.md +42 -42
  278. package/kit/skills/legacy-api-only-applications/SKILL.md +1 -1
  279. package/kit/skills/legacy-characterization-tests/SKILL.md +1 -1
  280. package/kit/skills/legacy-effect-analysis/SKILL.md +1 -1
  281. package/kit/skills/legacy-extract-class/SKILL.md +1 -1
  282. package/kit/skills/legacy-programming-by-difference/SKILL.md +1 -1
  283. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +1 -1
  284. package/kit/skills/legacy-shotgun-surgery/SKILL.md +1 -1
  285. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +1 -1
  286. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +1 -1
  287. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +1 -1
  288. package/kit/skills/member-invite-flow/SKILL.md +1 -1
  289. package/kit/skills/member-management-react-shadcn/SKILL.md +1 -1
  290. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +1 -1
  291. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +1 -1
  292. package/kit/skills/org-onboarding-flow/SKILL.md +1 -1
  293. package/kit/skills/org-switcher-react-pattern/SKILL.md +1 -1
  294. package/kit/skills/permission-gate-react-pattern/SKILL.md +1 -1
  295. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +1 -1
  296. package/kit/skills/pre-refactor-characterization/SKILL.md +1 -1
  297. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +1 -1
  298. package/kit/skills/streams-eventos-cdc/SKILL.md +1 -1
  299. package/kit/skills/supabase-branching-workflow/SKILL.md +1 -1
  300. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +1 -1
  301. package/kit/skills/supabase-column-level-security/SKILL.md +1 -1
  302. package/kit/skills/supabase-config-toml-remotes/SKILL.md +1 -1
  303. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +1 -1
  304. package/kit/skills/supabase-migration-repair/SKILL.md +1 -1
  305. package/kit/skills/supabase-migrations/SKILL.md +1 -1
  306. package/kit/skills/supabase-pgtap-testing/SKILL.md +1 -1
  307. package/kit/skills/supabase-postgres-roles/SKILL.md +1 -1
  308. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +1 -1
  309. package/kit/skills/supabase-rls-policies/SKILL.md +1 -1
  310. package/kit/skills/super-admin-platform-pattern/SKILL.md +1 -1
  311. package/kit/skills/tenant-quente-mitigacao/SKILL.md +1 -1
  312. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +1 -1
  313. package/package.json +63 -63
  314. package/src/cli/index.js +345 -6
  315. package/src/cli/render.js +7 -0
  316. package/src/core/kit.js +216 -216
  317. package/src/core/logger.js +170 -0
  318. package/src/core/notify.js +60 -0
  319. package/src/core/reflect.js +247 -247
  320. package/src/core/reverse-sync.js +372 -372
  321. package/src/core/sync.js +418 -418
  322. package/src/core/watch.js +121 -121
  323. package/src/mcp-server/index.js +65 -2
@@ -1,126 +1,126 @@
1
- ---
2
- name: fio
3
- description: Gerencia threads de contexto persistentes para trabalho entre sessões
1
+ ---
2
+ name: fio
3
+ description: Gerencia threads de contexto persistentes para trabalho entre sessões
4
4
  argument-hint: "[nome | descrição]"
5
- allowed-tools:
6
- - Read
7
- - Write
8
- - Bash
9
- ---
10
-
11
- <objective>
12
- Criar, listar ou retomar threads de contexto persistentes. Threads são armazenamentos leves
13
- de conhecimento entre sessões para trabalho que abrange múltiplas sessões mas
14
- não pertence a nenhuma fase específica.
15
- </objective>
16
-
17
- <process>
18
-
19
- **Analisar $ARGUMENTS para determinar o modo:**
20
-
21
- <mode_list>
22
- **Se sem argumentos ou $ARGUMENTS estiver vazio:**
23
-
24
- Listar todos os threads:
25
- ```bash
26
- ls .planning/threads/*.md 2>/dev/null
27
- ```
28
-
29
- Para cada thread, ler as primeiras linhas para mostrar título e status:
30
- ```
31
- ## Threads Ativos
32
-
33
- | Thread | Status | Última Atualização |
34
- |--------|--------|--------------------|
35
- | fix-deploy-key-auth | ABERTO | 2026-03-15 |
36
- | pasta-tcp-timeout | RESOLVIDO | 2026-03-12 |
37
- | perf-investigation | EM ANDAMENTO | 2026-03-17 |
38
- ```
39
-
40
- Se não existirem threads, mostrar:
41
- ```
42
- Nenhum thread encontrado. Crie um com: /fio <descrição>
43
- ```
44
- </mode_list>
45
-
46
- <mode_resume>
47
- **Se $ARGUMENTS corresponder a um nome de thread existente (arquivo existe):**
48
-
49
- Retomar o thread — carregar seu contexto na sessão atual:
50
- ```bash
51
- cat ".planning/threads/${THREAD_NAME}.md"
52
- ```
53
-
54
- Exibir o conteúdo do thread e perguntar ao usuário o que deseja trabalhar a seguir.
55
- Atualizar o status do thread para `IN PROGRESS` se estava `OPEN`.
56
- </mode_resume>
57
-
58
- <mode_create>
59
- **Se $ARGUMENTS for uma nova descrição (nenhum arquivo de thread correspondente):**
60
-
61
- Criar um novo thread:
62
-
63
- 1. Gerar slug a partir da descrição:
64
- ```bash
65
- SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
66
- ```
67
-
68
- 2. Criar o diretório de threads se necessário:
69
- ```bash
70
- mkdir -p .planning/threads
71
- ```
72
-
73
- 3. Escrever o arquivo do thread:
74
- ```bash
75
- cat > ".planning/threads/${SLUG}.md" << 'EOF'
76
- # Thread: {descrição}
77
-
78
- ## Status: OPEN
79
-
80
- ## Objetivo
81
-
82
- {descrição}
83
-
84
- ## Contexto
85
-
86
- *Criado a partir de conversa em {data de hoje}.*
87
-
88
- ## Referências
89
-
90
- - *(adicionar links, caminhos de arquivo ou números de issue)*
91
-
92
- ## Próximos Passos
93
-
94
- - *(o que a próxima sessão deve fazer primeiro)*
95
- EOF
96
- ```
97
-
98
- 4. Se houver contexto relevante na conversa atual (trechos de código,
99
- mensagens de erro, resultados de investigação), extrair e adicionar à seção Contexto.
100
-
101
- 5. Commitar:
102
- ```bash
103
- node "./.claude/framework/bin/tools.cjs" commit "docs: criar thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
104
- ```
105
-
106
- 6. Reportar:
107
- ```
108
- ## Thread Criado
109
-
110
- Thread: {slug}
111
- Arquivo: .planning/threads/{slug}.md
112
-
113
- Retome a qualquer momento com: /fio {slug}
114
- ```
115
- </mode_create>
116
-
117
- </process>
118
-
119
- <notes>
120
- - Threads NÃO têm escopo de fase — existem independentemente do roadmap
121
- - Mais leve que /pausar-trabalho — sem estado de fase, sem contexto de plano
122
- - O valor está em Contexto e Próximos Passos — uma sessão fria pode começar imediatamente
123
- - Threads podem ser promovidos para fases ou itens de backlog quando amadurecem:
124
- /adicionar-fase ou /adicionar-backlog com contexto do thread
125
- - Arquivos de thread ficam em .planning/threads/ — sem colisão com fases ou outras estruturas framework
126
- </notes>
5
+ allowed-tools:
6
+ - Read
7
+ - Write
8
+ - Bash
9
+ ---
10
+
11
+ <objective>
12
+ Criar, listar ou retomar threads de contexto persistentes. Threads são armazenamentos leves
13
+ de conhecimento entre sessões para trabalho que abrange múltiplas sessões mas
14
+ não pertence a nenhuma fase específica.
15
+ </objective>
16
+
17
+ <process>
18
+
19
+ **Analisar $ARGUMENTS para determinar o modo:**
20
+
21
+ <mode_list>
22
+ **Se sem argumentos ou $ARGUMENTS estiver vazio:**
23
+
24
+ Listar todos os threads:
25
+ ```bash
26
+ ls .planning/threads/*.md 2>/dev/null
27
+ ```
28
+
29
+ Para cada thread, ler as primeiras linhas para mostrar título e status:
30
+ ```
31
+ ## Threads Ativos
32
+
33
+ | Thread | Status | Última Atualização |
34
+ |--------|--------|--------------------|
35
+ | fix-deploy-key-auth | ABERTO | 2026-03-15 |
36
+ | pasta-tcp-timeout | RESOLVIDO | 2026-03-12 |
37
+ | perf-investigation | EM ANDAMENTO | 2026-03-17 |
38
+ ```
39
+
40
+ Se não existirem threads, mostrar:
41
+ ```
42
+ Nenhum thread encontrado. Crie um com: /fio <descrição>
43
+ ```
44
+ </mode_list>
45
+
46
+ <mode_resume>
47
+ **Se $ARGUMENTS corresponder a um nome de thread existente (arquivo existe):**
48
+
49
+ Retomar o thread — carregar seu contexto na sessão atual:
50
+ ```bash
51
+ cat ".planning/threads/${THREAD_NAME}.md"
52
+ ```
53
+
54
+ Exibir o conteúdo do thread e perguntar ao usuário o que deseja trabalhar a seguir.
55
+ Atualizar o status do thread para `IN PROGRESS` se estava `OPEN`.
56
+ </mode_resume>
57
+
58
+ <mode_create>
59
+ **Se $ARGUMENTS for uma nova descrição (nenhum arquivo de thread correspondente):**
60
+
61
+ Criar um novo thread:
62
+
63
+ 1. Gerar slug a partir da descrição:
64
+ ```bash
65
+ SLUG=$(node "./.claude/framework/bin/tools.cjs" generate-slug "$ARGUMENTS")
66
+ ```
67
+
68
+ 2. Criar o diretório de threads se necessário:
69
+ ```bash
70
+ mkdir -p .planning/threads
71
+ ```
72
+
73
+ 3. Escrever o arquivo do thread:
74
+ ```bash
75
+ cat > ".planning/threads/${SLUG}.md" << 'EOF'
76
+ # Thread: {descrição}
77
+
78
+ ## Status: OPEN
79
+
80
+ ## Objetivo
81
+
82
+ {descrição}
83
+
84
+ ## Contexto
85
+
86
+ *Criado a partir de conversa em {data de hoje}.*
87
+
88
+ ## Referências
89
+
90
+ - *(adicionar links, caminhos de arquivo ou números de issue)*
91
+
92
+ ## Próximos Passos
93
+
94
+ - *(o que a próxima sessão deve fazer primeiro)*
95
+ EOF
96
+ ```
97
+
98
+ 4. Se houver contexto relevante na conversa atual (trechos de código,
99
+ mensagens de erro, resultados de investigação), extrair e adicionar à seção Contexto.
100
+
101
+ 5. Commitar:
102
+ ```bash
103
+ node "./.claude/framework/bin/tools.cjs" commit "docs: criar thread — ${ARGUMENTS}" --files ".planning/threads/${SLUG}.md"
104
+ ```
105
+
106
+ 6. Reportar:
107
+ ```
108
+ ## Thread Criado
109
+
110
+ Thread: {slug}
111
+ Arquivo: .planning/threads/{slug}.md
112
+
113
+ Retome a qualquer momento com: /fio {slug}
114
+ ```
115
+ </mode_create>
116
+
117
+ </process>
118
+
119
+ <notes>
120
+ - Threads NÃO têm escopo de fase — existem independentemente do roadmap
121
+ - Mais leve que /pausar-trabalho — sem estado de fase, sem contexto de plano
122
+ - O valor está em Contexto e Próximos Passos — uma sessão fria pode começar imediatamente
123
+ - Threads podem ser promovidos para fases ou itens de backlog quando amadurecem:
124
+ /adicionar-fase ou /adicionar-backlog com contexto do thread
125
+ - Arquivos de thread ficam em .planning/threads/ — sem colisão com fases ou outras estruturas framework
126
+ </notes>
@@ -1,64 +1,64 @@
1
- ---
2
- name: fluxos-trabalho
3
- description: Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, progresso, concluir e retomar
4
- ---
5
-
6
- # /fluxos-trabalho
7
-
8
- Gerencia fluxos de trabalho paralelos para trabalho concurrent em milestones.
9
-
10
- ## Uso
11
-
12
- `/fluxos-trabalho [subcomando] [argumentos]`
13
-
14
- ### Subcomandos
15
-
16
- | Comando | Descrição |
17
- |---------|-----------|
18
- | `list` | Listar todos os fluxos com status |
19
- | `create <nome>` | Criar um novo fluxo de trabalho |
20
- | `status <nome>` | Status detalhado de um fluxo |
21
- | `switch <nome>` | Definir fluxo ativo |
22
- | `progress` | Resumo de progresso de todos os fluxos |
23
- | `complete <nome>` | Arquivar um fluxo concluído |
24
- | `resume <nome>` | Retomar trabalho em um fluxo |
25
-
26
- ## Passo 1: Analisar Subcomando
27
-
28
- Analisar a entrada do usuário para determinar qual operação de fluxo executar.
29
- Se nenhum subcomando for fornecido, padrão é `list`.
30
-
31
- ## Passo 2: Executar Operação
32
-
33
- ### list
34
- Executar: `node "$TOOLS" workstream list --raw --cwd "$CWD"`
35
- Exibir os fluxos em formato de tabela mostrando nome, status, fase atual e progresso.
36
-
37
- ### create
38
- Executar: `node "$TOOLS" workstream create <nome> --raw --cwd "$CWD"`
39
- Após criação, exibir o caminho do novo fluxo e sugerir próximos passos:
40
- - `/novo-marco --ws <nome>` para configurar o milestone
41
-
42
- ### status
43
- Executar: `node "$TOOLS" workstream status <nome> --raw --cwd "$CWD"`
44
- Exibir detalhamento de fases e informações de estado.
45
-
46
- ### switch
47
- Executar: `node "$TOOLS" workstream set <nome> --raw --cwd "$CWD"`
48
- Também definir variável de ambiente `WORKSTREAM` para a sessão atual.
49
-
50
- ### progress
51
- Executar: `node "$TOOLS" workstream progress --raw --cwd "$CWD"`
52
- Exibir visão geral de progresso de todos os fluxos.
53
-
54
- ### complete
55
- Executar: `node "$TOOLS" workstream complete <nome> --raw --cwd "$CWD"`
56
- Arquivar o fluxo em milestones/.
57
-
58
- ### resume
59
- Definir o fluxo como ativo e sugerir `/retomar-trabalho --ws <nome>`.
60
-
61
- ## Passo 3: Exibir Resultados
62
-
63
- Formatar a saída JSON do tools em exibição legível por humanos.
64
- Incluir a flag `${WS}` em qualquer sugestão de roteamento.
1
+ ---
2
+ name: fluxos-trabalho
3
+ description: Gerencia fluxos de trabalho paralelos — listar, criar, alternar, status, progresso, concluir e retomar
4
+ ---
5
+
6
+ # /fluxos-trabalho
7
+
8
+ Gerencia fluxos de trabalho paralelos para trabalho concurrent em milestones.
9
+
10
+ ## Uso
11
+
12
+ `/fluxos-trabalho [subcomando] [argumentos]`
13
+
14
+ ### Subcomandos
15
+
16
+ | Comando | Descrição |
17
+ |---------|-----------|
18
+ | `list` | Listar todos os fluxos com status |
19
+ | `create <nome>` | Criar um novo fluxo de trabalho |
20
+ | `status <nome>` | Status detalhado de um fluxo |
21
+ | `switch <nome>` | Definir fluxo ativo |
22
+ | `progress` | Resumo de progresso de todos os fluxos |
23
+ | `complete <nome>` | Arquivar um fluxo concluído |
24
+ | `resume <nome>` | Retomar trabalho em um fluxo |
25
+
26
+ ## Passo 1: Analisar Subcomando
27
+
28
+ Analisar a entrada do usuário para determinar qual operação de fluxo executar.
29
+ Se nenhum subcomando for fornecido, padrão é `list`.
30
+
31
+ ## Passo 2: Executar Operação
32
+
33
+ ### list
34
+ Executar: `node "$TOOLS" workstream list --raw --cwd "$CWD"`
35
+ Exibir os fluxos em formato de tabela mostrando nome, status, fase atual e progresso.
36
+
37
+ ### create
38
+ Executar: `node "$TOOLS" workstream create <nome> --raw --cwd "$CWD"`
39
+ Após criação, exibir o caminho do novo fluxo e sugerir próximos passos:
40
+ - `/novo-marco --ws <nome>` para configurar o milestone
41
+
42
+ ### status
43
+ Executar: `node "$TOOLS" workstream status <nome> --raw --cwd "$CWD"`
44
+ Exibir detalhamento de fases e informações de estado.
45
+
46
+ ### switch
47
+ Executar: `node "$TOOLS" workstream set <nome> --raw --cwd "$CWD"`
48
+ Também definir variável de ambiente `WORKSTREAM` para a sessão atual.
49
+
50
+ ### progress
51
+ Executar: `node "$TOOLS" workstream progress --raw --cwd "$CWD"`
52
+ Exibir visão geral de progresso de todos os fluxos.
53
+
54
+ ### complete
55
+ Executar: `node "$TOOLS" workstream complete <nome> --raw --cwd "$CWD"`
56
+ Arquivar o fluxo em milestones/.
57
+
58
+ ### resume
59
+ Definir o fluxo como ativo e sugerir `/retomar-trabalho --ws <nome>`.
60
+
61
+ ## Passo 3: Exibir Resultados
62
+
63
+ Formatar a saída JSON do tools em exibição legível por humanos.
64
+ Incluir a flag `${WS}` em qualquer sugestão de roteamento.