@luanpdd/kit-mcp 1.26.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 (326) 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/release-pipeline-auditor.md +11 -0
  35. package/kit/agents/research-synthesizer.md +245 -245
  36. package/kit/agents/roadmapper.md +677 -677
  37. package/kit/agents/seam-finder.md +1 -1
  38. package/kit/agents/shotgun-surgery-detector.md +1 -1
  39. package/kit/agents/supabase-architect.md +14 -0
  40. package/kit/agents/supabase-branching-architect.md +562 -0
  41. package/kit/agents/supabase-cicd-pipeline-implementer.md +777 -0
  42. package/kit/agents/supabase-column-privileges-writer.md +1 -1
  43. package/kit/agents/supabase-migration-writer.md +13 -1
  44. package/kit/agents/supabase-rbac-implementer.md +1 -1
  45. package/kit/agents/supabase-rls-hardener.md +1 -1
  46. package/kit/agents/supabase-rls-writer.md +1 -1
  47. package/kit/agents/supabase-roles-implementer.md +1 -1
  48. package/kit/agents/super-admin-implementer.md +1 -1
  49. package/kit/agents/ui-auditor.md +437 -437
  50. package/kit/agents/ui-checker.md +302 -302
  51. package/kit/agents/ui-researcher.md +355 -355
  52. package/kit/agents/user-profiler.md +175 -175
  53. package/kit/agents/validador-evolucao-schema.md +1 -1
  54. package/kit/agents/verifier.md +728 -728
  55. package/kit/commands/adicionar-backlog.md +75 -75
  56. package/kit/commands/adicionar-fase.md +42 -42
  57. package/kit/commands/adicionar-tarefa.md +45 -45
  58. package/kit/commands/adicionar-testes.md +41 -41
  59. package/kit/commands/ajuda.md +21 -21
  60. package/kit/commands/atualizar.md +37 -37
  61. package/kit/commands/auditar-cascading.md +1 -1
  62. package/kit/commands/auditar-marco.md +179 -179
  63. package/kit/commands/auditar-observabilidade-cobertura.md +1 -1
  64. package/kit/commands/auditar-refactor.md +1 -1
  65. package/kit/commands/auditar-release.md +1 -1
  66. package/kit/commands/auditar-uat.md +23 -23
  67. package/kit/commands/autonomo.md +40 -40
  68. package/kit/commands/branch-pr.md +24 -24
  69. package/kit/commands/burn-rate-status.md +1 -1
  70. package/kit/commands/capturar-payloads.md +1 -1
  71. package/kit/commands/caracterizar.md +1 -1
  72. package/kit/commands/concluir-marco.md +247 -247
  73. package/kit/commands/configuracoes.md +36 -36
  74. package/kit/commands/dados-distribuidos.md +1 -1
  75. package/kit/commands/definir-perfil.md +10 -10
  76. package/kit/commands/depurar.md +190 -190
  77. package/kit/commands/detectar-duplicacao.md +1 -1
  78. package/kit/commands/discutir-fase.md +131 -131
  79. package/kit/commands/encontrar-seams.md +1 -1
  80. package/kit/commands/entrar-discord.md +17 -17
  81. package/kit/commands/estatisticas.md +18 -18
  82. package/kit/commands/example-greeting.md +33 -33
  83. package/kit/commands/executar-fase.md +58 -58
  84. package/kit/commands/expresso.md +56 -56
  85. package/kit/commands/fase-ui.md +34 -34
  86. package/kit/commands/fazer.md +57 -57
  87. package/kit/commands/fio.md +125 -125
  88. package/kit/commands/fluxos-trabalho.md +64 -64
  89. package/kit/commands/forense.md +176 -176
  90. package/kit/commands/gerenciador.md +38 -38
  91. package/kit/commands/inserir-fase.md +31 -31
  92. package/kit/commands/legacy.md +1 -1
  93. package/kit/commands/limpeza.md +17 -17
  94. package/kit/commands/listar-hipoteses-fase.md +45 -45
  95. package/kit/commands/listar-workspaces.md +18 -18
  96. package/kit/commands/load-shedding.md +1 -1
  97. package/kit/commands/mapear-codebase.md +70 -70
  98. package/kit/commands/multi-tenant.md +1 -1
  99. package/kit/commands/nota.md +33 -33
  100. package/kit/commands/novo-marco.md +43 -43
  101. package/kit/commands/novo-projeto.md +41 -41
  102. package/kit/commands/novo-workspace.md +43 -43
  103. package/kit/commands/pausar-trabalho.md +37 -37
  104. package/kit/commands/perfil-usuario.md +45 -45
  105. package/kit/commands/pesquisar-fase.md +195 -195
  106. package/kit/commands/planejar-fase.md +67 -67
  107. package/kit/commands/planejar-lacunas.md +33 -33
  108. package/kit/commands/plantar-ideia.md +25 -25
  109. package/kit/commands/progresso.md +24 -24
  110. package/kit/commands/proximo.md +30 -30
  111. package/kit/commands/publicar.md +490 -490
  112. package/kit/commands/rapido.md +35 -35
  113. package/kit/commands/reaplicar-patches.md +124 -124
  114. package/kit/commands/refactor-seguro.md +1 -1
  115. package/kit/commands/relatorio-sessao.md +19 -19
  116. package/kit/commands/remover-fase.md +31 -31
  117. package/kit/commands/remover-workspace.md +26 -26
  118. package/kit/commands/resumo-marco.md +50 -50
  119. package/kit/commands/retomar-trabalho.md +40 -40
  120. package/kit/commands/revisar-backlog.md +60 -60
  121. package/kit/commands/revisar-ui.md +32 -32
  122. package/kit/commands/revisar.md +37 -37
  123. package/kit/commands/saude.md +21 -21
  124. package/kit/commands/setup-notion.md +93 -93
  125. package/kit/commands/storytelling.md +1 -1
  126. package/kit/commands/supabase.md +1 -1
  127. package/kit/commands/sync-main.md +68 -68
  128. package/kit/commands/validar-fase.md +35 -35
  129. package/kit/commands/verificar-tarefas.md +44 -44
  130. package/kit/commands/verificar-trabalho.md +64 -64
  131. package/kit/file-manifest.json +93 -86
  132. package/kit/framework/bin/lib/commands.cjs +959 -959
  133. package/kit/framework/bin/lib/config.cjs +442 -442
  134. package/kit/framework/bin/lib/core.cjs +1230 -1230
  135. package/kit/framework/bin/lib/frontmatter.cjs +336 -336
  136. package/kit/framework/bin/lib/init.cjs +1442 -1442
  137. package/kit/framework/bin/lib/milestone.cjs +252 -252
  138. package/kit/framework/bin/lib/model-profiles.cjs +68 -68
  139. package/kit/framework/bin/lib/phase.cjs +888 -888
  140. package/kit/framework/bin/lib/profile-output.cjs +952 -952
  141. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -539
  142. package/kit/framework/bin/lib/roadmap.cjs +329 -329
  143. package/kit/framework/bin/lib/security.cjs +382 -382
  144. package/kit/framework/bin/lib/state.cjs +1031 -1031
  145. package/kit/framework/bin/lib/template.cjs +222 -222
  146. package/kit/framework/bin/lib/uat.cjs +282 -282
  147. package/kit/framework/bin/lib/verify.cjs +888 -888
  148. package/kit/framework/bin/lib/workstream.cjs +491 -491
  149. package/kit/framework/bin/tools.cjs +918 -918
  150. package/kit/framework/commands/workstreams.md +63 -63
  151. package/kit/framework/references/checkpoints.md +778 -778
  152. package/kit/framework/references/continuation-format.md +249 -249
  153. package/kit/framework/references/decimal-phase-calculation.md +64 -64
  154. package/kit/framework/references/git-integration.md +295 -295
  155. package/kit/framework/references/git-planning-commit.md +38 -38
  156. package/kit/framework/references/model-profile-resolution.md +36 -36
  157. package/kit/framework/references/model-profiles.md +139 -139
  158. package/kit/framework/references/phase-argument-parsing.md +61 -61
  159. package/kit/framework/references/planning-config.md +202 -202
  160. package/kit/framework/references/questioning.md +162 -162
  161. package/kit/framework/references/tdd.md +263 -263
  162. package/kit/framework/references/ui-brand.md +160 -160
  163. package/kit/framework/references/user-profiling.md +657 -657
  164. package/kit/framework/references/verification-patterns.md +612 -612
  165. package/kit/framework/references/workstream-flag.md +58 -58
  166. package/kit/framework/templates/DEBUG.md +164 -164
  167. package/kit/framework/templates/UAT.md +265 -265
  168. package/kit/framework/templates/UI-SPEC.md +100 -100
  169. package/kit/framework/templates/VALIDATION.md +76 -76
  170. package/kit/framework/templates/claude-md.md +122 -122
  171. package/kit/framework/templates/codebase/architecture.md +185 -185
  172. package/kit/framework/templates/codebase/concerns.md +205 -205
  173. package/kit/framework/templates/codebase/conventions.md +204 -204
  174. package/kit/framework/templates/codebase/integrations.md +192 -192
  175. package/kit/framework/templates/codebase/stack.md +158 -158
  176. package/kit/framework/templates/codebase/structure.md +199 -199
  177. package/kit/framework/templates/codebase/testing.md +301 -301
  178. package/kit/framework/templates/config.json +44 -44
  179. package/kit/framework/templates/context.md +352 -352
  180. package/kit/framework/templates/continue-here.md +78 -78
  181. package/kit/framework/templates/copilot-instructions.md +7 -7
  182. package/kit/framework/templates/debug-subagent-prompt.md +91 -91
  183. package/kit/framework/templates/dev-preferences.md +20 -20
  184. package/kit/framework/templates/discovery.md +146 -146
  185. package/kit/framework/templates/discussion-log.md +63 -63
  186. package/kit/framework/templates/milestone-archive.md +123 -123
  187. package/kit/framework/templates/milestone.md +115 -115
  188. package/kit/framework/templates/phase-prompt.md +610 -610
  189. package/kit/framework/templates/planner-subagent-prompt.md +117 -117
  190. package/kit/framework/templates/project.md +186 -186
  191. package/kit/framework/templates/requirements.md +231 -231
  192. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -204
  193. package/kit/framework/templates/research-project/FEATURES.md +147 -147
  194. package/kit/framework/templates/research-project/PITFALLS.md +200 -200
  195. package/kit/framework/templates/research-project/STACK.md +120 -120
  196. package/kit/framework/templates/research-project/SUMMARY.md +170 -170
  197. package/kit/framework/templates/research.md +419 -419
  198. package/kit/framework/templates/retrospective.md +54 -54
  199. package/kit/framework/templates/roadmap.md +202 -202
  200. package/kit/framework/templates/state.md +176 -176
  201. package/kit/framework/templates/summary-complex.md +59 -59
  202. package/kit/framework/templates/summary-minimal.md +41 -41
  203. package/kit/framework/templates/summary-standard.md +48 -48
  204. package/kit/framework/templates/summary.md +209 -209
  205. package/kit/framework/templates/user-profile.md +146 -146
  206. package/kit/framework/templates/user-setup.md +256 -256
  207. package/kit/framework/templates/verification-report.md +258 -258
  208. package/kit/framework/workflows/add-phase.md +112 -112
  209. package/kit/framework/workflows/add-tests.md +351 -351
  210. package/kit/framework/workflows/add-todo.md +158 -158
  211. package/kit/framework/workflows/audit-milestone.md +340 -340
  212. package/kit/framework/workflows/audit-uat.md +109 -109
  213. package/kit/framework/workflows/autonomous.md +891 -891
  214. package/kit/framework/workflows/check-todos.md +177 -177
  215. package/kit/framework/workflows/cleanup.md +152 -152
  216. package/kit/framework/workflows/complete-milestone.md +696 -696
  217. package/kit/framework/workflows/diagnose-issues.md +231 -231
  218. package/kit/framework/workflows/discovery-phase.md +289 -289
  219. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -653
  220. package/kit/framework/workflows/discuss-phase.md +784 -784
  221. package/kit/framework/workflows/do.md +104 -104
  222. package/kit/framework/workflows/execute-phase.md +838 -838
  223. package/kit/framework/workflows/execute-plan.md +510 -510
  224. package/kit/framework/workflows/fast.md +102 -102
  225. package/kit/framework/workflows/forensics.md +265 -265
  226. package/kit/framework/workflows/health.md +181 -181
  227. package/kit/framework/workflows/help.md +619 -619
  228. package/kit/framework/workflows/insert-phase.md +130 -130
  229. package/kit/framework/workflows/list-phase-assumptions.md +178 -178
  230. package/kit/framework/workflows/list-workspaces.md +56 -56
  231. package/kit/framework/workflows/manager.md +362 -362
  232. package/kit/framework/workflows/map-codebase.md +377 -377
  233. package/kit/framework/workflows/milestone-summary.md +223 -223
  234. package/kit/framework/workflows/new-milestone.md +486 -486
  235. package/kit/framework/workflows/new-project.md +1159 -1159
  236. package/kit/framework/workflows/new-workspace.md +237 -237
  237. package/kit/framework/workflows/next.md +97 -97
  238. package/kit/framework/workflows/node-repair.md +92 -92
  239. package/kit/framework/workflows/note.md +156 -156
  240. package/kit/framework/workflows/pause-work.md +176 -176
  241. package/kit/framework/workflows/plan-milestone-gaps.md +273 -273
  242. package/kit/framework/workflows/plan-phase.md +765 -765
  243. package/kit/framework/workflows/plant-seed.md +169 -169
  244. package/kit/framework/workflows/pr-branch.md +129 -129
  245. package/kit/framework/workflows/profile-user.md +450 -450
  246. package/kit/framework/workflows/progress.md +507 -507
  247. package/kit/framework/workflows/quick.md +757 -757
  248. package/kit/framework/workflows/remove-phase.md +155 -155
  249. package/kit/framework/workflows/remove-workspace.md +90 -90
  250. package/kit/framework/workflows/research-phase.md +82 -82
  251. package/kit/framework/workflows/resume-project.md +326 -326
  252. package/kit/framework/workflows/review.md +228 -228
  253. package/kit/framework/workflows/session-report.md +146 -146
  254. package/kit/framework/workflows/settings.md +283 -283
  255. package/kit/framework/workflows/ship.md +228 -228
  256. package/kit/framework/workflows/stats.md +60 -60
  257. package/kit/framework/workflows/transition.md +671 -671
  258. package/kit/framework/workflows/ui-phase.md +302 -302
  259. package/kit/framework/workflows/ui-review.md +165 -165
  260. package/kit/framework/workflows/update.md +323 -323
  261. package/kit/framework/workflows/validate-phase.md +174 -174
  262. package/kit/framework/workflows/verify-phase.md +252 -252
  263. package/kit/framework/workflows/verify-work.md +637 -637
  264. package/kit/hooks/check-update.js +118 -118
  265. package/kit/hooks/context-monitor.js +163 -163
  266. package/kit/hooks/prompt-guard.js +103 -103
  267. package/kit/hooks/statusline.js +125 -125
  268. package/kit/hooks/workflow-guard.js +101 -101
  269. package/kit/settings.json +45 -45
  270. package/kit/skills/_shared-supabase/glossary.md +10 -0
  271. package/kit/skills/ai-prompt-characterization/SKILL.md +1 -1
  272. package/kit/skills/armadilhas-sistemas-distribuidos/SKILL.md +1 -1
  273. package/kit/skills/audit-log-multi-tenant/SKILL.md +1 -1
  274. package/kit/skills/b2b-saas-architecture/SKILL.md +1 -1
  275. package/kit/skills/consistencia-leitura-replica/SKILL.md +1 -1
  276. package/kit/skills/crm-lead-pipeline-patterns/SKILL.md +1 -1
  277. package/kit/skills/escolha-modelo-consistencia/SKILL.md +1 -1
  278. package/kit/skills/evolucao-schema-compativel/SKILL.md +1 -1
  279. package/kit/skills/evolution-go-whatsapp-integration/SKILL.md +1 -1
  280. package/kit/skills/example-skill/SKILL.md +42 -42
  281. package/kit/skills/legacy-api-only-applications/SKILL.md +1 -1
  282. package/kit/skills/legacy-characterization-tests/SKILL.md +1 -1
  283. package/kit/skills/legacy-effect-analysis/SKILL.md +1 -1
  284. package/kit/skills/legacy-extract-class/SKILL.md +1 -1
  285. package/kit/skills/legacy-programming-by-difference/SKILL.md +1 -1
  286. package/kit/skills/legacy-seams-and-test-harness/SKILL.md +1 -1
  287. package/kit/skills/legacy-shotgun-surgery/SKILL.md +1 -1
  288. package/kit/skills/legacy-sprout-wrap-techniques/SKILL.md +1 -1
  289. package/kit/skills/legacy-storytelling-naked-crc/SKILL.md +1 -1
  290. package/kit/skills/lgpd-multi-tenant-compliance/SKILL.md +1 -1
  291. package/kit/skills/member-invite-flow/SKILL.md +1 -1
  292. package/kit/skills/member-management-react-shadcn/SKILL.md +1 -1
  293. package/kit/skills/multi-tenant-performance-scaling/SKILL.md +1 -1
  294. package/kit/skills/multi-tenant-rls-hierarchy/SKILL.md +1 -1
  295. package/kit/skills/org-onboarding-flow/SKILL.md +1 -1
  296. package/kit/skills/org-switcher-react-pattern/SKILL.md +1 -1
  297. package/kit/skills/permission-gate-react-pattern/SKILL.md +1 -1
  298. package/kit/skills/postgres-isolamento-concorrencia/SKILL.md +1 -1
  299. package/kit/skills/pre-refactor-characterization/SKILL.md +1 -1
  300. package/kit/skills/rbac-permissions-matrix-supabase/SKILL.md +1 -1
  301. package/kit/skills/streams-eventos-cdc/SKILL.md +1 -1
  302. package/kit/skills/supabase-branching-workflow/SKILL.md +544 -0
  303. package/kit/skills/supabase-ci-cd-github-actions/SKILL.md +880 -0
  304. package/kit/skills/supabase-column-level-security/SKILL.md +1 -1
  305. package/kit/skills/supabase-config-toml-remotes/SKILL.md +807 -0
  306. package/kit/skills/supabase-custom-claims-rbac/SKILL.md +1 -1
  307. package/kit/skills/supabase-migration-repair/SKILL.md +823 -0
  308. package/kit/skills/supabase-migrations/SKILL.md +1 -1
  309. package/kit/skills/supabase-pgtap-testing/SKILL.md +1053 -0
  310. package/kit/skills/supabase-postgres-roles/SKILL.md +1 -1
  311. package/kit/skills/supabase-rls-defense-in-depth/SKILL.md +1 -1
  312. package/kit/skills/supabase-rls-policies/SKILL.md +1 -1
  313. package/kit/skills/super-admin-platform-pattern/SKILL.md +1 -1
  314. package/kit/skills/tenant-quente-mitigacao/SKILL.md +1 -1
  315. package/kit/skills/whatsapp-conversation-state-machine/SKILL.md +1 -1
  316. package/package.json +63 -63
  317. package/src/cli/index.js +345 -6
  318. package/src/cli/render.js +7 -0
  319. package/src/core/kit.js +216 -216
  320. package/src/core/logger.js +170 -0
  321. package/src/core/notify.js +60 -0
  322. package/src/core/reflect.js +247 -247
  323. package/src/core/reverse-sync.js +372 -372
  324. package/src/core/sync.js +418 -418
  325. package/src/core/watch.js +121 -121
  326. package/src/mcp-server/index.js +65 -2
@@ -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>