@luanpdd/kit-mcp 0.2.1 → 0.4.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 (221) hide show
  1. package/CHANGELOG.md +43 -1
  2. package/README.md +35 -18
  3. package/kit/COMANDOS.md +123 -0
  4. package/kit/agents/advisor-researcher.md +121 -0
  5. package/kit/agents/assumptions-analyzer.md +122 -0
  6. package/kit/agents/codebase-mapper.md +787 -0
  7. package/kit/agents/debugger.md +796 -0
  8. package/kit/agents/executor.md +516 -0
  9. package/kit/agents/integration-checker.md +217 -0
  10. package/kit/agents/nyquist-auditor.md +195 -0
  11. package/kit/agents/phase-researcher.md +715 -0
  12. package/kit/agents/plan-checker.md +289 -0
  13. package/kit/agents/planner.md +1373 -0
  14. package/kit/agents/project-researcher.md +671 -0
  15. package/kit/agents/research-synthesizer.md +259 -0
  16. package/kit/agents/roadmapper.md +696 -0
  17. package/kit/agents/ui-auditor.md +458 -0
  18. package/kit/agents/ui-checker.md +319 -0
  19. package/kit/agents/ui-researcher.md +374 -0
  20. package/kit/agents/user-profiler.md +183 -0
  21. package/kit/agents/verifier.md +719 -0
  22. package/kit/commands/adicionar-backlog.md +76 -0
  23. package/kit/commands/adicionar-fase.md +43 -0
  24. package/kit/commands/adicionar-tarefa.md +47 -0
  25. package/kit/commands/adicionar-testes.md +41 -0
  26. package/kit/commands/ajuda.md +22 -0
  27. package/kit/commands/atualizar.md +37 -0
  28. package/kit/commands/auditar-marco.md +36 -0
  29. package/kit/commands/auditar-uat.md +24 -0
  30. package/kit/commands/autonomo.md +41 -0
  31. package/kit/commands/branch-pr.md +25 -0
  32. package/kit/commands/concluir-marco.md +136 -0
  33. package/kit/commands/configuracoes.md +36 -0
  34. package/kit/commands/definir-perfil.md +12 -0
  35. package/kit/commands/depurar.md +173 -0
  36. package/kit/commands/discutir-fase.md +64 -0
  37. package/kit/commands/entrar-discord.md +18 -0
  38. package/kit/commands/estatisticas.md +18 -0
  39. package/kit/commands/executar-fase.md +59 -0
  40. package/kit/commands/expresso.md +47 -0
  41. package/kit/commands/fase-ui.md +34 -0
  42. package/kit/commands/fazer.md +30 -0
  43. package/kit/commands/fio.md +126 -0
  44. package/kit/commands/fluxos-trabalho.md +64 -0
  45. package/kit/commands/forense.md +56 -0
  46. package/kit/commands/gerenciador.md +39 -0
  47. package/kit/commands/inserir-fase.md +32 -0
  48. package/kit/commands/limpeza.md +18 -0
  49. package/kit/commands/listar-hipoteses-fase.md +46 -0
  50. package/kit/commands/listar-workspaces.md +19 -0
  51. package/kit/commands/mapear-codebase.md +71 -0
  52. package/kit/commands/nota.md +34 -0
  53. package/kit/commands/novo-marco.md +44 -0
  54. package/kit/commands/novo-projeto.md +42 -0
  55. package/kit/commands/novo-workspace.md +44 -0
  56. package/kit/commands/pausar-trabalho.md +38 -0
  57. package/kit/commands/perfil-usuario.md +46 -0
  58. package/kit/commands/pesquisar-fase.md +195 -0
  59. package/kit/commands/planejar-fase.md +47 -0
  60. package/kit/commands/planejar-lacunas.md +34 -0
  61. package/kit/commands/plantar-ideia.md +26 -0
  62. package/kit/commands/progresso.md +24 -0
  63. package/kit/commands/proximo.md +24 -0
  64. package/kit/commands/publicar.md +370 -0
  65. package/kit/commands/rapido.md +30 -0
  66. package/kit/commands/reaplicar-patches.md +124 -0
  67. package/kit/commands/relatorio-sessao.md +19 -0
  68. package/kit/commands/remover-fase.md +31 -0
  69. package/kit/commands/remover-workspace.md +26 -0
  70. package/kit/commands/resumo-marco.md +51 -0
  71. package/kit/commands/retomar-trabalho.md +40 -0
  72. package/kit/commands/revisar-backlog.md +60 -0
  73. package/kit/commands/revisar-ui.md +32 -0
  74. package/kit/commands/revisar.md +37 -0
  75. package/kit/commands/saude.md +22 -0
  76. package/kit/commands/setup-notion.md +93 -0
  77. package/kit/commands/sync-main.md +68 -0
  78. package/kit/commands/validar-fase.md +35 -0
  79. package/kit/commands/verificar-tarefas.md +45 -0
  80. package/kit/commands/verificar-trabalho.md +38 -0
  81. package/kit/file-manifest.json +219 -0
  82. package/kit/framework/VERSION +1 -0
  83. package/kit/framework/bin/lib/commands.cjs +959 -0
  84. package/kit/framework/bin/lib/config.cjs +442 -0
  85. package/kit/framework/bin/lib/core.cjs +1230 -0
  86. package/kit/framework/bin/lib/frontmatter.cjs +336 -0
  87. package/kit/framework/bin/lib/init.cjs +1442 -0
  88. package/kit/framework/bin/lib/milestone.cjs +252 -0
  89. package/kit/framework/bin/lib/model-profiles.cjs +68 -0
  90. package/kit/framework/bin/lib/phase.cjs +888 -0
  91. package/kit/framework/bin/lib/profile-output.cjs +952 -0
  92. package/kit/framework/bin/lib/profile-pipeline.cjs +539 -0
  93. package/kit/framework/bin/lib/roadmap.cjs +329 -0
  94. package/kit/framework/bin/lib/security.cjs +382 -0
  95. package/kit/framework/bin/lib/state.cjs +1031 -0
  96. package/kit/framework/bin/lib/template.cjs +222 -0
  97. package/kit/framework/bin/lib/uat.cjs +282 -0
  98. package/kit/framework/bin/lib/verify.cjs +888 -0
  99. package/kit/framework/bin/lib/workstream.cjs +491 -0
  100. package/kit/framework/bin/tools.cjs +918 -0
  101. package/kit/framework/commands/workstreams.md +63 -0
  102. package/kit/framework/references/checkpoints.md +778 -0
  103. package/kit/framework/references/continuation-format.md +249 -0
  104. package/kit/framework/references/decimal-phase-calculation.md +64 -0
  105. package/kit/framework/references/git-integration.md +295 -0
  106. package/kit/framework/references/git-planning-commit.md +38 -0
  107. package/kit/framework/references/model-profile-resolution.md +36 -0
  108. package/kit/framework/references/model-profiles.md +139 -0
  109. package/kit/framework/references/phase-argument-parsing.md +61 -0
  110. package/kit/framework/references/planning-config.md +202 -0
  111. package/kit/framework/references/questioning.md +162 -0
  112. package/kit/framework/references/tdd.md +263 -0
  113. package/kit/framework/references/ui-brand.md +160 -0
  114. package/kit/framework/references/user-profiling.md +657 -0
  115. package/kit/framework/references/verification-patterns.md +612 -0
  116. package/kit/framework/references/workstream-flag.md +58 -0
  117. package/kit/framework/templates/DEBUG.md +164 -0
  118. package/kit/framework/templates/UAT.md +265 -0
  119. package/kit/framework/templates/UI-SPEC.md +100 -0
  120. package/kit/framework/templates/VALIDATION.md +76 -0
  121. package/kit/framework/templates/claude-md.md +122 -0
  122. package/kit/framework/templates/codebase/architecture.md +185 -0
  123. package/kit/framework/templates/codebase/concerns.md +205 -0
  124. package/kit/framework/templates/codebase/conventions.md +204 -0
  125. package/kit/framework/templates/codebase/integrations.md +192 -0
  126. package/kit/framework/templates/codebase/stack.md +158 -0
  127. package/kit/framework/templates/codebase/structure.md +199 -0
  128. package/kit/framework/templates/codebase/testing.md +301 -0
  129. package/kit/framework/templates/config.json +44 -0
  130. package/kit/framework/templates/context.md +352 -0
  131. package/kit/framework/templates/continue-here.md +78 -0
  132. package/kit/framework/templates/copilot-instructions.md +7 -0
  133. package/kit/framework/templates/debug-subagent-prompt.md +91 -0
  134. package/kit/framework/templates/dev-preferences.md +20 -0
  135. package/kit/framework/templates/discovery.md +146 -0
  136. package/kit/framework/templates/discussion-log.md +63 -0
  137. package/kit/framework/templates/milestone-archive.md +123 -0
  138. package/kit/framework/templates/milestone.md +115 -0
  139. package/kit/framework/templates/phase-prompt.md +610 -0
  140. package/kit/framework/templates/planner-subagent-prompt.md +117 -0
  141. package/kit/framework/templates/project.md +186 -0
  142. package/kit/framework/templates/requirements.md +231 -0
  143. package/kit/framework/templates/research-project/ARCHITECTURE.md +204 -0
  144. package/kit/framework/templates/research-project/FEATURES.md +147 -0
  145. package/kit/framework/templates/research-project/PITFALLS.md +200 -0
  146. package/kit/framework/templates/research-project/STACK.md +120 -0
  147. package/kit/framework/templates/research-project/SUMMARY.md +170 -0
  148. package/kit/framework/templates/research.md +419 -0
  149. package/kit/framework/templates/retrospective.md +54 -0
  150. package/kit/framework/templates/roadmap.md +202 -0
  151. package/kit/framework/templates/state.md +176 -0
  152. package/kit/framework/templates/summary-complex.md +59 -0
  153. package/kit/framework/templates/summary-minimal.md +41 -0
  154. package/kit/framework/templates/summary-standard.md +48 -0
  155. package/kit/framework/templates/summary.md +209 -0
  156. package/kit/framework/templates/user-profile.md +146 -0
  157. package/kit/framework/templates/user-setup.md +256 -0
  158. package/kit/framework/templates/verification-report.md +258 -0
  159. package/kit/framework/workflows/add-phase.md +112 -0
  160. package/kit/framework/workflows/add-tests.md +351 -0
  161. package/kit/framework/workflows/add-todo.md +158 -0
  162. package/kit/framework/workflows/audit-milestone.md +340 -0
  163. package/kit/framework/workflows/audit-uat.md +109 -0
  164. package/kit/framework/workflows/autonomous.md +891 -0
  165. package/kit/framework/workflows/check-todos.md +177 -0
  166. package/kit/framework/workflows/cleanup.md +152 -0
  167. package/kit/framework/workflows/complete-milestone.md +696 -0
  168. package/kit/framework/workflows/diagnose-issues.md +231 -0
  169. package/kit/framework/workflows/discovery-phase.md +289 -0
  170. package/kit/framework/workflows/discuss-phase-assumptions.md +653 -0
  171. package/kit/framework/workflows/discuss-phase.md +1049 -0
  172. package/kit/framework/workflows/do.md +104 -0
  173. package/kit/framework/workflows/execute-phase.md +838 -0
  174. package/kit/framework/workflows/execute-plan.md +510 -0
  175. package/kit/framework/workflows/fast.md +102 -0
  176. package/kit/framework/workflows/forensics.md +265 -0
  177. package/kit/framework/workflows/health.md +181 -0
  178. package/kit/framework/workflows/help.md +606 -0
  179. package/kit/framework/workflows/insert-phase.md +130 -0
  180. package/kit/framework/workflows/list-phase-assumptions.md +178 -0
  181. package/kit/framework/workflows/list-workspaces.md +56 -0
  182. package/kit/framework/workflows/manager.md +362 -0
  183. package/kit/framework/workflows/map-codebase.md +377 -0
  184. package/kit/framework/workflows/milestone-summary.md +223 -0
  185. package/kit/framework/workflows/new-milestone.md +486 -0
  186. package/kit/framework/workflows/new-project.md +1250 -0
  187. package/kit/framework/workflows/new-workspace.md +237 -0
  188. package/kit/framework/workflows/next.md +97 -0
  189. package/kit/framework/workflows/node-repair.md +92 -0
  190. package/kit/framework/workflows/note.md +156 -0
  191. package/kit/framework/workflows/pause-work.md +176 -0
  192. package/kit/framework/workflows/plan-milestone-gaps.md +273 -0
  193. package/kit/framework/workflows/plan-phase.md +859 -0
  194. package/kit/framework/workflows/plant-seed.md +169 -0
  195. package/kit/framework/workflows/pr-branch.md +129 -0
  196. package/kit/framework/workflows/profile-user.md +450 -0
  197. package/kit/framework/workflows/progress.md +507 -0
  198. package/kit/framework/workflows/quick.md +757 -0
  199. package/kit/framework/workflows/remove-phase.md +155 -0
  200. package/kit/framework/workflows/remove-workspace.md +90 -0
  201. package/kit/framework/workflows/research-phase.md +82 -0
  202. package/kit/framework/workflows/resume-project.md +326 -0
  203. package/kit/framework/workflows/review.md +228 -0
  204. package/kit/framework/workflows/session-report.md +146 -0
  205. package/kit/framework/workflows/settings.md +283 -0
  206. package/kit/framework/workflows/ship.md +228 -0
  207. package/kit/framework/workflows/stats.md +60 -0
  208. package/kit/framework/workflows/transition.md +671 -0
  209. package/kit/framework/workflows/ui-phase.md +302 -0
  210. package/kit/framework/workflows/ui-review.md +165 -0
  211. package/kit/framework/workflows/update.md +323 -0
  212. package/kit/framework/workflows/validate-phase.md +174 -0
  213. package/kit/framework/workflows/verify-phase.md +252 -0
  214. package/kit/framework/workflows/verify-work.md +637 -0
  215. package/kit/hooks/check-update.js +114 -0
  216. package/kit/hooks/context-monitor.js +156 -0
  217. package/kit/hooks/prompt-guard.js +96 -0
  218. package/kit/hooks/statusline.js +119 -0
  219. package/kit/hooks/workflow-guard.js +94 -0
  220. package/kit/settings.json +45 -0
  221. package/package.json +1 -1
@@ -0,0 +1,228 @@
1
+ <purpose>
2
+ Revisão cruzada entre IAs — invoca CLIs externas de IA para revisar planos de fase de forma independente.
3
+ Cada CLI recebe o mesmo prompt (contexto de PROJECT.md, planos de fase, requisitos) e
4
+ produz feedback estruturado. Os resultados são combinados em REVIEWS.md para o planejador
5
+ incorporar via flag --reviews.
6
+
7
+ Implementa revisão adversarial: diferentes modelos de IA captam diferentes pontos cegos.
8
+ Um plano que sobrevive à revisão de 2-3 sistemas de IA independentes é mais robusto.
9
+ </purpose>
10
+
11
+ <process>
12
+
13
+ <step name="detect_clis">
14
+ Verifique quais CLIs de IA estão disponíveis no sistema:
15
+
16
+ ```bash
17
+ # Verificar cada CLI
18
+ command -v gemini >/dev/null 2>&1 && echo "gemini:available" || echo "gemini:missing"
19
+ command -v claude >/dev/null 2>&1 && echo "claude:available" || echo "claude:missing"
20
+ command -v codex >/dev/null 2>&1 && echo "codex:available" || echo "codex:missing"
21
+ ```
22
+
23
+ Analise as flags de `$ARGUMENTS`:
24
+ - `--gemini` → incluir Gemini
25
+ - `--claude` → incluir Claude
26
+ - `--codex` → incluir Codex
27
+ - `--all` → incluir todos disponíveis
28
+ - Sem flags → incluir todos disponíveis
29
+
30
+ Se nenhuma CLI disponível:
31
+ ```
32
+ Nenhuma CLI de IA externa encontrada. Instale pelo menos uma:
33
+ - gemini: https://github.com/google-gemini/gemini-cli
34
+ - codex: https://github.com/openai/codex
35
+ - claude: https://github.com/anthropics/claude-code
36
+
37
+ Depois execute /revisar novamente.
38
+ ```
39
+ Encerre.
40
+
41
+ Se apenas uma CLI é o runtime atual (ex.: executando dentro do Claude), pule-a para a revisão
42
+ para garantir independência. Pelo menos uma CLI DIFERENTE deve estar disponível.
43
+ </step>
44
+
45
+ <step name="gather_context">
46
+ Colete os artefatos da fase para o prompt de revisão:
47
+
48
+ ```bash
49
+ INIT=$(node "./.claude/framework/bin/tools.cjs" init phase-op "${PHASE_ARG}")
50
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
51
+ ```
52
+
53
+ Leia do init: `phase_dir`, `phase_number`, `padded_phase`.
54
+
55
+ Depois leia:
56
+ 1. `.planning/PROJECT.md` (primeiras 80 linhas — contexto do projeto)
57
+ 2. Seção da fase em `.planning/ROADMAP.md`
58
+ 3. Todos os arquivos `*-PLAN.md` no diretório da fase
59
+ 4. `*-CONTEXT.md` se presente (decisões do usuário)
60
+ 5. `*-RESEARCH.md` se presente (pesquisa de domínio)
61
+ 6. `.planning/REQUIREMENTS.md` (requisitos que esta fase endereça)
62
+ </step>
63
+
64
+ <step name="build_prompt">
65
+ Construa um prompt de revisão estruturado:
66
+
67
+ ```markdown
68
+ # Cross-AI Plan Review Request
69
+
70
+ You are reviewing implementation plans for a software project phase.
71
+ Provide structured feedback on plan quality, completeness, and risks.
72
+
73
+ ## Project Context
74
+ {first 80 lines of PROJECT.md}
75
+
76
+ ## Phase {N}: {phase name}
77
+ ### Roadmap Section
78
+ {roadmap phase section}
79
+
80
+ ### Requirements Addressed
81
+ {requirements for this phase}
82
+
83
+ ### User Decisions (CONTEXT.md)
84
+ {context if present}
85
+
86
+ ### Research Findings
87
+ {research if present}
88
+
89
+ ### Plans to Review
90
+ {all PLAN.md contents}
91
+
92
+ ## Review Instructions
93
+
94
+ Analyze each plan and provide:
95
+
96
+ 1. **Summary** — One-paragraph assessment
97
+ 2. **Strengths** — What's well-designed (bullet points)
98
+ 3. **Concerns** — Potential issues, gaps, risks (bullet points with severity: HIGH/MEDIUM/LOW)
99
+ 4. **Suggestions** — Specific improvements (bullet points)
100
+ 5. **Risk Assessment** — Overall risk level (LOW/MEDIUM/HIGH) with justification
101
+
102
+ Focus on:
103
+ - Missing edge cases or error handling
104
+ - Dependency ordering issues
105
+ - Scope creep or over-engineering
106
+ - Security considerations
107
+ - Performance implications
108
+ - Whether the plans actually achieve the phase goals
109
+
110
+ Output your review in markdown format.
111
+ ```
112
+
113
+ Escreva em um arquivo temporário: `/tmp/review-prompt-{phase}.md`
114
+ </step>
115
+
116
+ <step name="invoke_reviewers">
117
+ Para cada CLI selecionada, invoque em sequência (não em paralelo — evitar limites de taxa):
118
+
119
+ **Gemini:**
120
+ ```bash
121
+ gemini -p "$(cat /tmp/review-prompt-{phase}.md)" 2>/dev/null > /tmp/review-gemini-{phase}.md
122
+ ```
123
+
124
+ **Claude (sessão separada):**
125
+ ```bash
126
+ claude -p "$(cat /tmp/review-prompt-{phase}.md)" --no-input 2>/dev/null > /tmp/review-claude-{phase}.md
127
+ ```
128
+
129
+ **Codex:**
130
+ ```bash
131
+ codex exec --skip-git-repo-check "$(cat /tmp/review-prompt-{phase}.md)" 2>/dev/null > /tmp/review-codex-{phase}.md
132
+ ```
133
+
134
+ Se uma CLI falhar, registre o erro e continue com as CLIs restantes.
135
+
136
+ Exiba o progresso:
137
+ ```
138
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
139
+ framework ► REVISÃO CRUZADA ENTRE IAs — Fase {N}
140
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
141
+
142
+ ◆ Revisando com {CLI}... concluído ✓
143
+ ◆ Revisando com {CLI}... concluído ✓
144
+ ```
145
+ </step>
146
+
147
+ <step name="write_reviews">
148
+ Combine todas as respostas de revisão em `{phase_dir}/{padded_phase}-REVIEWS.md`:
149
+
150
+ ```markdown
151
+ ---
152
+ phase: {N}
153
+ reviewers: [gemini, claude, codex]
154
+ reviewed_at: {timestamp ISO}
155
+ plans_reviewed: [{lista de arquivos PLAN.md}]
156
+ ---
157
+
158
+ # Revisão Cruzada Entre IAs — Fase {N}
159
+
160
+ ## Revisão Gemini
161
+
162
+ {conteúdo da revisão gemini}
163
+
164
+ ---
165
+
166
+ ## Revisão Claude
167
+
168
+ {conteúdo da revisão claude}
169
+
170
+ ---
171
+
172
+ ## Revisão Codex
173
+
174
+ {conteúdo da revisão codex}
175
+
176
+ ---
177
+
178
+ ## Resumo de Consenso
179
+
180
+ {sintetize preocupações comuns entre todos os revisores}
181
+
182
+ ### Pontos Fortes Consensuais
183
+ {pontos fortes mencionados por 2+ revisores}
184
+
185
+ ### Preocupações Consensuais
186
+ {preocupações levantadas por 2+ revisores — prioridade mais alta}
187
+
188
+ ### Visões Divergentes
189
+ {onde os revisores discordaram — vale investigar}
190
+ ```
191
+
192
+ Commit:
193
+ ```bash
194
+ node "./.claude/framework/bin/tools.cjs" commit "docs: revisão cruzada entre IAs para fase {N}" --files {phase_dir}/{padded_phase}-REVIEWS.md
195
+ ```
196
+ </step>
197
+
198
+ <step name="present_results">
199
+ Exiba o resumo:
200
+
201
+ ```
202
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
203
+ framework ► REVISÃO CONCLUÍDA
204
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
205
+
206
+ Fase {N} revisada por {contagem} sistemas de IA.
207
+
208
+ Preocupações consensuais:
209
+ {top 3 preocupações compartilhadas}
210
+
211
+ Revisão completa: {padded_phase}-REVIEWS.md
212
+
213
+ Para incorporar o feedback no planejamento:
214
+ /planejar-fase {N} --reviews
215
+ ```
216
+
217
+ Limpe os arquivos temporários.
218
+ </step>
219
+
220
+ </process>
221
+
222
+ <success_criteria>
223
+ - [ ] Pelo menos uma CLI externa invocada com sucesso
224
+ - [ ] REVIEWS.md escrito com feedback estruturado
225
+ - [ ] Resumo de consenso sintetizado de múltiplos revisores
226
+ - [ ] Arquivos temporários limpos
227
+ - [ ] Usuário sabe como usar o feedback (/planejar-fase --reviews)
228
+ </success_criteria>
@@ -0,0 +1,146 @@
1
+ <purpose>
2
+ Gerar um documento de resumo pós-sessão capturando o trabalho realizado, resultados alcançados e uso estimado de recursos. Escreve SESSION_REPORT.md em .planning/reports/ para revisão humana e compartilhamento com stakeholders.
3
+ </purpose>
4
+
5
+ <required_reading>
6
+ Ler todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
7
+ </required_reading>
8
+
9
+ <process>
10
+
11
+ <step name="gather_session_data">
12
+ Coletar dados da sessão das fontes disponíveis:
13
+
14
+ 1. **STATE.md** — fase atual, milestone, progresso, bloqueadores, decisões
15
+ 2. **Log do Git** — commits feitos durante esta sessão (últimas 24h ou desde o último relatório)
16
+ 3. **Arquivos de Plano/Summary** — planos executados, summaries escritos
17
+ 4. **ROADMAP.md** — contexto do milestone e objetivos de fase
18
+
19
+ ```bash
20
+ # Obter commits recentes (últimas 24 horas)
21
+ git log --oneline --since="24 hours ago" --no-merges 2>/dev/null || echo "Sem commits recentes"
22
+
23
+ # Contar arquivos alterados
24
+ git diff --stat HEAD~10 HEAD 2>/dev/null | tail -1 || echo "Nenhum diff disponível"
25
+ ```
26
+
27
+ Ler `.planning/STATE.md` para obter:
28
+ - Milestone e fase atuais
29
+ - Percentual de progresso
30
+ - Bloqueadores ativos
31
+ - Decisões recentes
32
+
33
+ Ler `.planning/ROADMAP.md` para obter nome e objetivos do milestone.
34
+
35
+ Verificar relatórios existentes:
36
+ ```bash
37
+ ls -la .planning/reports/SESSION_REPORT*.md 2>/dev/null || echo "Sem relatórios anteriores"
38
+ ```
39
+ </step>
40
+
41
+ <step name="estimate_usage">
42
+ Estimar uso de tokens a partir de sinais observáveis:
43
+
44
+ - A contagem de chamadas de ferramenta não está diretamente disponível, então estimar a partir de atividade do git e operações de arquivo
45
+ - Nota: Esta é uma **estimativa** — contagens exatas de tokens requerem instrumentação em nível de API não disponível para hooks
46
+
47
+ Heurísticas de estimativa:
48
+ - Cada commit ≈ 1 ciclo de plano (pesquisa + plano + execução + verificação)
49
+ - Cada arquivo de plano ≈ 2.000-5.000 tokens de contexto do agente
50
+ - Cada arquivo de summary ≈ 1.000-2.000 tokens gerados
51
+ - Criações de subagente multiplicam por ~1,5x por tipo de agente usado
52
+ </step>
53
+
54
+ <step name="generate_report">
55
+ Criar o diretório e arquivo do relatório:
56
+
57
+ ```bash
58
+ mkdir -p .planning/reports
59
+ ```
60
+
61
+ Escrever `.planning/reports/SESSION_REPORT.md` (ou `.planning/reports/AAAAMMDD-session-report.md` se relatórios anteriores existirem):
62
+
63
+ ```markdown
64
+ # Relatório de Sessão framework
65
+
66
+ **Gerado:** [timestamp]
67
+ **Projeto:** [do título do PROJECT.md ou nome do diretório]
68
+ **Milestone:** [N] — [nome do milestone do ROADMAP.md]
69
+
70
+ ---
71
+
72
+ ## Resumo da Sessão
73
+
74
+ **Duração:** [estimada do primeiro ao último timestamp de commit, ou "Sessão única"]
75
+ **Progresso da Fase:** [do STATE.md]
76
+ **Planos Executados:** [contagem de summaries escritos nesta sessão]
77
+ **Commits Feitos:** [contagem do git log]
78
+
79
+ ## Trabalho Realizado
80
+
81
+ ### Fases Tocadas
82
+ [Listar fases trabalhadas com breve descrição do que foi feito]
83
+
84
+ ### Resultados-Chave
85
+ [Lista de entregáveis concretos: arquivos criados, funcionalidades implementadas, bugs corrigidos]
86
+
87
+ ### Decisões Tomadas
88
+ [Da tabela de decisões do STATE.md, se alguma foi adicionada nesta sessão]
89
+
90
+ ## Arquivos Alterados
91
+
92
+ [Resumo de arquivos modificados, criados, deletados — do git diff stat]
93
+
94
+ ## Bloqueadores e Itens em Aberto
95
+
96
+ [Bloqueadores ativos do STATE.md]
97
+ [Quaisquer itens TODO criados durante a sessão]
98
+
99
+ ## Uso Estimado de Recursos
100
+
101
+ | Métrica | Estimativa |
102
+ |---------|------------|
103
+ | Commits | [N] |
104
+ | Arquivos alterados | [N] |
105
+ | Planos executados | [N] |
106
+ | Subagentes criados | [estimado] |
107
+
108
+ > **Nota:** Estimativas de tokens e custo requerem instrumentação em nível de API.
109
+ > Essas métricas refletem apenas a atividade de sessão observável.
110
+
111
+ ---
112
+
113
+ *Gerado por `/relatorio-sessao`*
114
+ ```
115
+ </step>
116
+
117
+ <step name="display_result">
118
+ Mostrar ao usuário:
119
+
120
+ ```
121
+ ## Relatório de Sessão Gerado
122
+
123
+ 📄 `.planning/reports/[nome-do-arquivo].md`
124
+
125
+ ### Destaques
126
+ - **Commits:** [N]
127
+ - **Arquivos alterados:** [N]
128
+ - **Progresso da fase:** [X]%
129
+ - **Planos executados:** [N]
130
+ ```
131
+
132
+ Se este for o primeiro relatório, mencionar:
133
+ ```
134
+ 💡 Execute `/relatorio-sessao` no final de cada sessão para construir um histórico de atividade do projeto.
135
+ ```
136
+ </step>
137
+
138
+ </process>
139
+
140
+ <success_criteria>
141
+ - [ ] Dados da sessão coletados do STATE.md, git log e arquivos de plano
142
+ - [ ] Relatório escrito em .planning/reports/
143
+ - [ ] Relatório inclui resumo do trabalho, resultados e alterações de arquivos
144
+ - [ ] Nome do arquivo inclui data para evitar sobrescritas
145
+ - [ ] Resumo do resultado exibido ao usuário
146
+ </success_criteria>
@@ -0,0 +1,283 @@
1
+ <purpose>
2
+ Configuração interativa dos agentes de workflow framework (research, plan_check, verifier) e seleção de perfil de modelo via prompt de múltiplas perguntas. Atualiza .planning/config.json com as preferências do usuário. Opcionalmente salva as configurações como padrões globais (~/.framework/defaults.json) para projetos futuros.
3
+ </purpose>
4
+
5
+ <required_reading>
6
+ Leia todos os arquivos referenciados pelo execution_context do prompt invocador antes de começar.
7
+ </required_reading>
8
+
9
+ <process>
10
+
11
+ <step name="ensure_and_load_config">
12
+ Garanta que o config existe e carregue o estado atual:
13
+
14
+ ```bash
15
+ node "./.claude/framework/bin/tools.cjs" config-ensure-section
16
+ INIT=$(node "./.claude/framework/bin/tools.cjs" state load)
17
+ if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
18
+ ```
19
+
20
+ Cria `.planning/config.json` com valores padrão se ausente e carrega os valores de config atuais.
21
+ </step>
22
+
23
+ <step name="read_current">
24
+ ```bash
25
+ cat .planning/config.json
26
+ ```
27
+
28
+ Analise os valores atuais (padrão para `true` se não presente):
29
+ - `workflow.research` — spawnar pesquisador durante plan-phase
30
+ - `workflow.plan_check` — spawnar verificador de plano durante plan-phase
31
+ - `workflow.verifier` — spawnar verificador durante execute-phase
32
+ - `workflow.nyquist_validation` — pesquisa de arquitetura de validação durante plan-phase (padrão: true se ausente)
33
+ - `workflow.ui_phase` — gerar contratos de design UI-SPEC.md para fases frontend (padrão: true se ausente)
34
+ - `workflow.ui_safety_gate` — solicitar execução de /fase-ui antes de planejar fases frontend (padrão: true se ausente)
35
+ - `model_profile` — qual modelo cada agente usa (padrão: `balanced`)
36
+ - `git.branching_strategy` — abordagem de branching (padrão: `"none"`)
37
+ </step>
38
+
39
+ <step name="present_settings">
40
+ Use AskUserQuestion com os valores atuais pré-selecionados:
41
+
42
+ ```
43
+ AskUserQuestion([
44
+ {
45
+ question: "Qual perfil de modelo para os agentes?",
46
+ header: "Modelo",
47
+ multiSelect: false,
48
+ options: [
49
+ { label: "Qualidade", description: "Opus em todo lugar exceto verificação (maior custo)" },
50
+ { label: "Balanceado (Recomendado)", description: "Opus para planejamento, Sonnet para pesquisa/execução/verificação" },
51
+ { label: "Econômico", description: "Sonnet para escrita, Haiku para pesquisa/verificação (menor custo)" },
52
+ { label: "Herdar", description: "Usar o modelo da sessão atual para todos os agentes (melhor para OpenRouter, modelos locais, ou troca de modelo em runtime)" }
53
+ ]
54
+ },
55
+ {
56
+ question: "Spawnar Pesquisador de Plano? (pesquisa o domínio antes do planejamento)",
57
+ header: "Pesquisa",
58
+ multiSelect: false,
59
+ options: [
60
+ { label: "Sim", description: "Pesquisar objetivos da fase antes do planejamento" },
61
+ { label: "Não", description: "Pular pesquisa, planejar diretamente" }
62
+ ]
63
+ },
64
+ {
65
+ question: "Spawnar Verificador de Plano? (verifica os planos antes da execução)",
66
+ header: "Verificar Plano",
67
+ multiSelect: false,
68
+ options: [
69
+ { label: "Sim", description: "Verificar se os planos atendem os objetivos da fase" },
70
+ { label: "Não", description: "Pular verificação de plano" }
71
+ ]
72
+ },
73
+ {
74
+ question: "Spawnar Verificador de Execução? (verifica a conclusão da fase)",
75
+ header: "Verificador",
76
+ multiSelect: false,
77
+ options: [
78
+ { label: "Sim", description: "Verificar must-haves após a execução" },
79
+ { label: "Não", description: "Pular verificação pós-execução" }
80
+ ]
81
+ },
82
+ {
83
+ question: "Avanço automático do pipeline? (discutir → planejar → executar automaticamente)",
84
+ header: "Auto",
85
+ multiSelect: false,
86
+ options: [
87
+ { label: "Não (Recomendado)", description: "/clear manual + colar entre estágios" },
88
+ { label: "Sim", description: "Encadear estágios via subagentes Task() (mesma isolação)" }
89
+ ]
90
+ },
91
+ {
92
+ question: "Habilitar Validação Nyquist? (pesquisa cobertura de testes durante o planejamento)",
93
+ header: "Nyquist",
94
+ multiSelect: false,
95
+ options: [
96
+ { label: "Sim (Recomendado)", description: "Pesquisar cobertura de testes automatizados durante plan-phase. Adiciona requisitos de validação aos planos. Bloqueia aprovação se tarefas não tiverem verificação automatizada." },
97
+ { label: "Não", description: "Pular pesquisa de validação. Bom para prototipagem rápida ou fases sem testes." }
98
+ ]
99
+ },
100
+ // Nota: A validação Nyquist depende da saída da pesquisa. Se a pesquisa estiver desabilitada,
101
+ // o plan-phase pula automaticamente as etapas Nyquist (sem RESEARCH.md para extrair).
102
+ {
103
+ question: "Habilitar Fase UI? (gera contratos de design UI-SPEC.md para fases frontend)",
104
+ header: "Fase UI",
105
+ multiSelect: false,
106
+ options: [
107
+ { label: "Sim (Recomendado)", description: "Gerar contratos de design UI antes de planejar fases frontend. Bloqueia espaçamento, tipografia, cores e copywriting." },
108
+ { label: "Não", description: "Pular geração de UI-SPEC. Bom para projetos somente backend ou fases de API." }
109
+ ]
110
+ },
111
+ {
112
+ question: "Habilitar Gate de Segurança UI? (solicita executar /fase-ui antes de planejar fases frontend)",
113
+ header: "Gate UI",
114
+ multiSelect: false,
115
+ options: [
116
+ { label: "Sim (Recomendado)", description: "plan-phase pergunta para executar /fase-ui primeiro quando indicadores frontend detectados." },
117
+ { label: "Não", description: "Sem prompt — plan-phase prossegue sem verificação de UI-SPEC." }
118
+ ]
119
+ },
120
+ {
121
+ question: "Estratégia de branching no git?",
122
+ header: "Branching",
123
+ multiSelect: false,
124
+ options: [
125
+ { label: "Nenhuma (Recomendado)", description: "Commitar diretamente na branch atual" },
126
+ { label: "Por Fase", description: "Criar branch para cada fase (framework/phase-{N}-{name})" },
127
+ { label: "Por Marco", description: "Criar branch para o marco completo (framework/{versão}-{nome})" }
128
+ ]
129
+ },
130
+ {
131
+ question: "Habilitar avisos de janela de contexto? (injeta mensagens de aviso quando o contexto está ficando cheio)",
132
+ header: "Avisos de Ctx",
133
+ multiSelect: false,
134
+ options: [
135
+ { label: "Sim (Recomendado)", description: "Avisar quando o uso de contexto exceder 65%. Ajuda a evitar perda de trabalho." },
136
+ { label: "Não", description: "Desabilitar avisos. Permite que o Claude atinja o auto-compact naturalmente. Bom para execuções longas sem supervisão." }
137
+ ]
138
+ },
139
+ {
140
+ question: "Pesquisar melhores práticas antes de fazer perguntas? (busca na web durante new-project e discuss-phase)",
141
+ header: "Pesquisa Perguntas",
142
+ multiSelect: false,
143
+ options: [
144
+ { label: "Não (Recomendado)", description: "Fazer perguntas diretamente. Mais rápido, usa menos tokens." },
145
+ { label: "Sim", description: "Buscar melhores práticas na web antes de cada grupo de perguntas. Perguntas mais embasadas mas usa mais tokens." }
146
+ ]
147
+ },
148
+ {
149
+ question: "Pular discuss-phase no modo autônomo? (usar objetivos do ROADMAP como spec)",
150
+ header: "Pular Discuss",
151
+ multiSelect: false,
152
+ options: [
153
+ { label: "Não (Recomendado)", description: "Executar discuss inteligente antes de cada fase — apresenta áreas cinzentas e captura decisões." },
154
+ { label: "Sim", description: "Pular discuss no /autonomo — encadear diretamente para plan. Melhor para trabalho backend/pipeline onde as descrições de fase são a spec." }
155
+ ]
156
+ }
157
+ ])
158
+ ```
159
+ </step>
160
+
161
+ <step name="update_config">
162
+ Mescle as novas configurações no config.json existente:
163
+
164
+ ```json
165
+ {
166
+ ...existing_config,
167
+ "model_profile": "quality" | "balanced" | "budget" | "inherit",
168
+ "workflow": {
169
+ "research": true/false,
170
+ "plan_check": true/false,
171
+ "verifier": true/false,
172
+ "auto_advance": true/false,
173
+ "nyquist_validation": true/false,
174
+ "ui_phase": true/false,
175
+ "ui_safety_gate": true/false,
176
+ "text_mode": true/false,
177
+ "research_before_questions": true/false,
178
+ "discuss_mode": "discuss" | "assumptions",
179
+ "skip_discuss": true/false
180
+ },
181
+ "git": {
182
+ "branching_strategy": "none" | "phase" | "milestone",
183
+ "quick_branch_template": <string|null>
184
+ },
185
+ "hooks": {
186
+ "context_warnings": true/false,
187
+ "workflow_guard": true/false
188
+ }
189
+ }
190
+ ```
191
+
192
+ Escreva o config atualizado em `.planning/config.json`.
193
+ </step>
194
+
195
+ <step name="save_as_defaults">
196
+ Pergunte se deseja salvar estas configurações como padrões globais para projetos futuros:
197
+
198
+ ```
199
+ AskUserQuestion([
200
+ {
201
+ question: "Salvar como configurações padrão para todos os novos projetos?",
202
+ header: "Padrões",
203
+ multiSelect: false,
204
+ options: [
205
+ { label: "Sim", description: "Novos projetos começam com estas configurações (salvo em ~/.framework/defaults.json)" },
206
+ { label: "Não", description: "Aplicar apenas a este projeto" }
207
+ ]
208
+ }
209
+ ])
210
+ ```
211
+
212
+ Se "Sim": escreva o mesmo objeto de config (menos campos específicos do projeto como `brave_search`) em `~/.framework/defaults.json`:
213
+
214
+ ```bash
215
+ mkdir -p ~/.framework
216
+ ```
217
+
218
+ Escreva `~/.framework/defaults.json` com:
219
+ ```json
220
+ {
221
+ "mode": <atual>,
222
+ "granularity": <atual>,
223
+ "model_profile": <atual>,
224
+ "commit_docs": <atual>,
225
+ "parallelization": <atual>,
226
+ "branching_strategy": <atual>,
227
+ "quick_branch_template": <atual>,
228
+ "workflow": {
229
+ "research": <atual>,
230
+ "plan_check": <atual>,
231
+ "verifier": <atual>,
232
+ "auto_advance": <atual>,
233
+ "nyquist_validation": <atual>,
234
+ "ui_phase": <atual>,
235
+ "ui_safety_gate": <atual>,
236
+ "skip_discuss": <atual>
237
+ }
238
+ }
239
+ ```
240
+ </step>
241
+
242
+ <step name="confirm">
243
+ Exiba:
244
+
245
+ ```
246
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
247
+ framework ► CONFIGURAÇÕES ATUALIZADAS
248
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
249
+
250
+ | Configuração | Valor |
251
+ |---------------------------|-------|
252
+ | Perfil de Modelo | {quality/balanced/budget/inherit} |
253
+ | Pesquisador de Plano | {Ativo/Inativo} |
254
+ | Verificador de Plano | {Ativo/Inativo} |
255
+ | Verificador de Execução | {Ativo/Inativo} |
256
+ | Avanço Automático | {Ativo/Inativo} |
257
+ | Validação Nyquist | {Ativo/Inativo} |
258
+ | Fase UI | {Ativo/Inativo} |
259
+ | Gate UI | {Ativo/Inativo} |
260
+ | Branching Git | {Nenhuma/Por Fase/Por Marco} |
261
+ | Pular Discuss | {Ativo/Inativo} |
262
+ | Avisos de Contexto | {Ativo/Inativo} |
263
+ | Salvo como Padrões | {Sim/Não} |
264
+
265
+ Estas configurações se aplicam às futuras execuções de /planejar-fase e /executar-fase.
266
+
267
+ Comandos rápidos:
268
+ - /definir-perfil <perfil> — trocar perfil de modelo
269
+ - /planejar-fase --research — forçar pesquisa
270
+ - /planejar-fase --skip-research — pular pesquisa
271
+ - /planejar-fase --skip-verify — pular verificação de plano
272
+ ```
273
+ </step>
274
+
275
+ </process>
276
+
277
+ <success_criteria>
278
+ - [ ] Config atual lido
279
+ - [ ] Usuário apresentado com 10 configurações (perfil + 8 toggles de workflow + branching git)
280
+ - [ ] Config atualizado com seções model_profile, workflow e git
281
+ - [ ] Usuário ofereceu salvar como padrões globais (~/.framework/defaults.json)
282
+ - [ ] Mudanças confirmadas ao usuário
283
+ </success_criteria>