@luanpdd/kit-mcp 1.27.0 → 1.29.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 (324) 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 +378 -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 +276 -10
  324. package/src/mcp-server/roots.js +124 -0
@@ -1,115 +1,115 @@
1
- # Template de Entrada de Milestone
2
-
3
- Adicione esta entrada em `.planning/MILESTONES.md` ao completar um milestone:
4
-
5
- ```markdown
6
- ## v[X.Y] [Nome] (Entregue: YYYY-MM-DD)
7
-
8
- **Entregue:** [Uma frase descrevendo o que foi lançado]
9
-
10
- **Fases concluídas:** [X-Y] ([Z] planos no total)
11
-
12
- **Principais conquistas:**
13
- - [Grande conquista 1]
14
- - [Grande conquista 2]
15
- - [Grande conquista 3]
16
- - [Grande conquista 4]
17
-
18
- **Estatísticas:**
19
- - [X] arquivos criados/modificados
20
- - [Y] linhas de código (linguagem principal)
21
- - [Z] fases, [N] planos, [M] tarefas
22
- - [D] dias do início ao lançamento (ou de milestone a milestone)
23
-
24
- **Intervalo git:** `feat(XX-XX)` → `feat(YY-YY)`
25
-
26
- **O que vem a seguir:** [Breve descrição dos objetivos do próximo milestone, ou "Projeto concluído"]
27
-
28
- ---
29
- ```
30
-
31
- <structure>
32
- Se MILESTONES.md não existir, crie-o com o cabeçalho:
33
-
34
- ```markdown
35
- # Milestones do Projeto: [Nome do Projeto]
36
-
37
- [Entradas em ordem cronológica inversa — mais recente primeiro]
38
- ```
39
- </structure>
40
-
41
- <guidelines>
42
- **Quando criar milestones:**
43
- - MVP v1.0 inicial lançado
44
- - Lançamentos de versão major (v2.0, v3.0)
45
- - Milestones de funcionalidades significativas (v1.1, v1.2)
46
- - Antes de arquivar o planejamento (capturar o que foi lançado)
47
-
48
- **Não criar milestones para:**
49
- - Conclusões de fases individuais (workflow normal)
50
- - Trabalho em andamento (aguardar até ser lançado)
51
- - Correções de bugs menores que não constituem um lançamento
52
-
53
- **Estatísticas a incluir:**
54
- - Contar arquivos modificados: `git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1`
55
- - Contar LOC: `find . -name "*.swift" -o -name "*.ts" | xargs wc -l` (ou extensão relevante)
56
- - Contagens de fase/plano/tarefa do ROADMAP
57
- - Cronograma do primeiro commit da fase ao último commit da fase
58
-
59
- **Formato do intervalo git:**
60
- - Primeiro commit do milestone → último commit do milestone
61
- - Exemplo: `feat(01-01)` → `feat(04-01)` para fases 1-4
62
- </guidelines>
63
-
64
- <example>
65
- ```markdown
66
- # Milestones do Projeto: WeatherBar
67
-
68
- ## v1.1 Segurança & Polimento (Entregue: 2025-12-10)
69
-
70
- **Entregue:** Hardening de segurança com integração ao Keychain e tratamento abrangente de erros
71
-
72
- **Fases concluídas:** 5-6 (3 planos no total)
73
-
74
- **Principais conquistas:**
75
- - Migrou armazenamento de chave API de texto plano para macOS Keychain
76
- - Implementou tratamento abrangente de erros para falhas de rede
77
- - Adicionou integração de relatório de crashes com Sentry
78
- - Corrigiu vazamento de memória no timer de auto-refresh
79
-
80
- **Estatísticas:**
81
- - 23 arquivos modificados
82
- - 650 linhas de Swift adicionadas
83
- - 2 fases, 3 planos, 12 tarefas
84
- - 8 dias do v1.0 ao v1.1
85
-
86
- **Intervalo git:** `feat(05-01)` → `feat(06-02)`
87
-
88
- **O que vem a seguir:** redesign SwiftUI v2.0 com suporte a widgets
89
-
90
- ---
91
-
92
- ## v1.0 MVP (Entregue: 2025-11-25)
93
-
94
- **Entregue:** App de clima na barra de menu com condições atuais e previsão de 3 dias
95
-
96
- **Fases concluídas:** 1-4 (7 planos no total)
97
-
98
- **Principais conquistas:**
99
- - App na barra de menu com UI popover (AppKit)
100
- - Integração com OpenWeather API com auto-refresh
101
- - Exibição do clima atual com ícone de condições
102
- - Lista de previsão de 3 dias com temperaturas máx/mín
103
- - Assinado e notarizado para distribuição
104
-
105
- **Estatísticas:**
106
- - 47 arquivos criados
107
- - 2.450 linhas de Swift
108
- - 4 fases, 7 planos, 28 tarefas
109
- - 12 dias do início ao lançamento
110
-
111
- **Intervalo git:** `feat(01-01)` → `feat(04-01)`
112
-
113
- **O que vem a seguir:** auditoria de segurança e hardening para v1.1
114
- ```
115
- </example>
1
+ # Template de Entrada de Milestone
2
+
3
+ Adicione esta entrada em `.planning/MILESTONES.md` ao completar um milestone:
4
+
5
+ ```markdown
6
+ ## v[X.Y] [Nome] (Entregue: YYYY-MM-DD)
7
+
8
+ **Entregue:** [Uma frase descrevendo o que foi lançado]
9
+
10
+ **Fases concluídas:** [X-Y] ([Z] planos no total)
11
+
12
+ **Principais conquistas:**
13
+ - [Grande conquista 1]
14
+ - [Grande conquista 2]
15
+ - [Grande conquista 3]
16
+ - [Grande conquista 4]
17
+
18
+ **Estatísticas:**
19
+ - [X] arquivos criados/modificados
20
+ - [Y] linhas de código (linguagem principal)
21
+ - [Z] fases, [N] planos, [M] tarefas
22
+ - [D] dias do início ao lançamento (ou de milestone a milestone)
23
+
24
+ **Intervalo git:** `feat(XX-XX)` → `feat(YY-YY)`
25
+
26
+ **O que vem a seguir:** [Breve descrição dos objetivos do próximo milestone, ou "Projeto concluído"]
27
+
28
+ ---
29
+ ```
30
+
31
+ <structure>
32
+ Se MILESTONES.md não existir, crie-o com o cabeçalho:
33
+
34
+ ```markdown
35
+ # Milestones do Projeto: [Nome do Projeto]
36
+
37
+ [Entradas em ordem cronológica inversa — mais recente primeiro]
38
+ ```
39
+ </structure>
40
+
41
+ <guidelines>
42
+ **Quando criar milestones:**
43
+ - MVP v1.0 inicial lançado
44
+ - Lançamentos de versão major (v2.0, v3.0)
45
+ - Milestones de funcionalidades significativas (v1.1, v1.2)
46
+ - Antes de arquivar o planejamento (capturar o que foi lançado)
47
+
48
+ **Não criar milestones para:**
49
+ - Conclusões de fases individuais (workflow normal)
50
+ - Trabalho em andamento (aguardar até ser lançado)
51
+ - Correções de bugs menores que não constituem um lançamento
52
+
53
+ **Estatísticas a incluir:**
54
+ - Contar arquivos modificados: `git diff --stat feat(XX-XX)..feat(YY-YY) | tail -1`
55
+ - Contar LOC: `find . -name "*.swift" -o -name "*.ts" | xargs wc -l` (ou extensão relevante)
56
+ - Contagens de fase/plano/tarefa do ROADMAP
57
+ - Cronograma do primeiro commit da fase ao último commit da fase
58
+
59
+ **Formato do intervalo git:**
60
+ - Primeiro commit do milestone → último commit do milestone
61
+ - Exemplo: `feat(01-01)` → `feat(04-01)` para fases 1-4
62
+ </guidelines>
63
+
64
+ <example>
65
+ ```markdown
66
+ # Milestones do Projeto: WeatherBar
67
+
68
+ ## v1.1 Segurança & Polimento (Entregue: 2025-12-10)
69
+
70
+ **Entregue:** Hardening de segurança com integração ao Keychain e tratamento abrangente de erros
71
+
72
+ **Fases concluídas:** 5-6 (3 planos no total)
73
+
74
+ **Principais conquistas:**
75
+ - Migrou armazenamento de chave API de texto plano para macOS Keychain
76
+ - Implementou tratamento abrangente de erros para falhas de rede
77
+ - Adicionou integração de relatório de crashes com Sentry
78
+ - Corrigiu vazamento de memória no timer de auto-refresh
79
+
80
+ **Estatísticas:**
81
+ - 23 arquivos modificados
82
+ - 650 linhas de Swift adicionadas
83
+ - 2 fases, 3 planos, 12 tarefas
84
+ - 8 dias do v1.0 ao v1.1
85
+
86
+ **Intervalo git:** `feat(05-01)` → `feat(06-02)`
87
+
88
+ **O que vem a seguir:** redesign SwiftUI v2.0 com suporte a widgets
89
+
90
+ ---
91
+
92
+ ## v1.0 MVP (Entregue: 2025-11-25)
93
+
94
+ **Entregue:** App de clima na barra de menu com condições atuais e previsão de 3 dias
95
+
96
+ **Fases concluídas:** 1-4 (7 planos no total)
97
+
98
+ **Principais conquistas:**
99
+ - App na barra de menu com UI popover (AppKit)
100
+ - Integração com OpenWeather API com auto-refresh
101
+ - Exibição do clima atual com ícone de condições
102
+ - Lista de previsão de 3 dias com temperaturas máx/mín
103
+ - Assinado e notarizado para distribuição
104
+
105
+ **Estatísticas:**
106
+ - 47 arquivos criados
107
+ - 2.450 linhas de Swift
108
+ - 4 fases, 7 planos, 28 tarefas
109
+ - 12 dias do início ao lançamento
110
+
111
+ **Intervalo git:** `feat(01-01)` → `feat(04-01)`
112
+
113
+ **O que vem a seguir:** auditoria de segurança e hardening para v1.1
114
+ ```
115
+ </example>