up-cc 0.16.0 → 2.0.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 (134) hide show
  1. package/README.md +87 -577
  2. package/package.json +5 -3
  3. package/up/CHANGELOG.md +110 -0
  4. package/up/agents/up-arquiteto.md +95 -39
  5. package/up/agents/up-auditor.md +218 -0
  6. package/up/agents/up-executor.md +94 -31
  7. package/up/agents/up-mapeador-codigo.md +63 -10
  8. package/up/agents/up-pesquisador.md +278 -0
  9. package/up/agents/up-revisor.md +249 -0
  10. package/up/agents/up-sintetizador.md +156 -179
  11. package/up/agents/up-tester.md +280 -0
  12. package/up/agents/up-verificador.md +95 -11
  13. package/up/bin/install.js +190 -21
  14. package/up/bin/lib/core.cjs +17 -43
  15. package/up/bin/lib/github.cjs +495 -0
  16. package/up/bin/lib/multica.cjs +424 -0
  17. package/up/bin/up-tools.cjs +167 -46
  18. package/up/commands/auditar.md +66 -0
  19. package/up/commands/build.md +54 -43
  20. package/up/commands/depurar.md +1 -1
  21. package/up/commands/plan.md +52 -38
  22. package/up/commands/rapido.md +15 -9
  23. package/up/commands/testar.md +81 -122
  24. package/up/commands/up.md +106 -0
  25. package/up/hooks/up-session-start.js +107 -0
  26. package/up/references/engineering-principles.md +1 -1
  27. package/up/references/governance-rules.md +5 -5
  28. package/up/references/production-requirements.md +1 -1
  29. package/up/references/severity-levels.md +2 -2
  30. package/up/references/tdd-evidence-types.md +81 -0
  31. package/up/skills/up-brainstorm/SKILL.md +39 -0
  32. package/up/skills/up-tdd/SKILL.md +39 -0
  33. package/up/skills/up-verificar-antes-de-concluir/SKILL.md +49 -0
  34. package/up/skills/usando-up/SKILL.md +26 -0
  35. package/up/templates/audit-plan.md +3 -3
  36. package/up/templates/audit-report.md +2 -2
  37. package/up/templates/design-tokens.md +2 -2
  38. package/up/workflows/auditar.md +255 -0
  39. package/up/workflows/build.md +600 -386
  40. package/up/workflows/dcrv.md +183 -99
  41. package/up/workflows/governance.md +112 -220
  42. package/up/workflows/plan.md +169 -399
  43. package/up/workflows/rapido.md +7 -1
  44. package/up/workflows/up.md +447 -0
  45. package/up/agents/up-analista-codigo.md +0 -446
  46. package/up/agents/up-api-tester.md +0 -405
  47. package/up/agents/up-architecture-supervisor.md +0 -126
  48. package/up/agents/up-audit-supervisor.md +0 -83
  49. package/up/agents/up-auditor-modernidade.md +0 -378
  50. package/up/agents/up-auditor-performance.md +0 -426
  51. package/up/agents/up-auditor-ux.md +0 -396
  52. package/up/agents/up-backend-specialist.md +0 -175
  53. package/up/agents/up-blind-validator.md +0 -259
  54. package/up/agents/up-chief-architect.md +0 -184
  55. package/up/agents/up-chief-engineer.md +0 -202
  56. package/up/agents/up-chief-operations.md +0 -123
  57. package/up/agents/up-chief-product.md +0 -103
  58. package/up/agents/up-chief-quality.md +0 -211
  59. package/up/agents/up-clone-crawler.md +0 -234
  60. package/up/agents/up-clone-design-extractor.md +0 -227
  61. package/up/agents/up-clone-feature-mapper.md +0 -225
  62. package/up/agents/up-clone-prd-writer.md +0 -169
  63. package/up/agents/up-clone-verifier.md +0 -227
  64. package/up/agents/up-code-reviewer.md +0 -229
  65. package/up/agents/up-consolidador-ideias.md +0 -493
  66. package/up/agents/up-database-specialist.md +0 -169
  67. package/up/agents/up-delivery-auditor.md +0 -247
  68. package/up/agents/up-devops-agent.md +0 -203
  69. package/up/agents/up-execution-supervisor.md +0 -315
  70. package/up/agents/up-exhaustive-tester.md +0 -348
  71. package/up/agents/up-frontend-specialist.md +0 -152
  72. package/up/agents/up-operations-supervisor.md +0 -94
  73. package/up/agents/up-pesquisador-mercado.md +0 -350
  74. package/up/agents/up-pesquisador-projeto.md +0 -358
  75. package/up/agents/up-planning-auditor.md +0 -284
  76. package/up/agents/up-planning-supervisor.md +0 -260
  77. package/up/agents/up-product-analyst.md +0 -192
  78. package/up/agents/up-product-supervisor.md +0 -83
  79. package/up/agents/up-project-ceo.md +0 -352
  80. package/up/agents/up-qa-agent.md +0 -171
  81. package/up/agents/up-quality-supervisor.md +0 -178
  82. package/up/agents/up-requirements-validator.md +0 -230
  83. package/up/agents/up-security-reviewer.md +0 -137
  84. package/up/agents/up-sintetizador-melhorias.md +0 -407
  85. package/up/agents/up-system-designer.md +0 -332
  86. package/up/agents/up-technical-writer.md +0 -188
  87. package/up/agents/up-verification-supervisor.md +0 -111
  88. package/up/agents/up-visual-critic.md +0 -358
  89. package/up/commands/adicionar-fase.md +0 -47
  90. package/up/commands/adicionar-testes.md +0 -145
  91. package/up/commands/ajuda.md +0 -176
  92. package/up/commands/atualizar.md +0 -103
  93. package/up/commands/clone-builder.md +0 -67
  94. package/up/commands/configurar.md +0 -219
  95. package/up/commands/custos.md +0 -67
  96. package/up/commands/dashboard.md +0 -48
  97. package/up/commands/discutir-fase.md +0 -35
  98. package/up/commands/executar-fase.md +0 -40
  99. package/up/commands/ideias.md +0 -49
  100. package/up/commands/iniciar.md +0 -31
  101. package/up/commands/mapear-codigo.md +0 -63
  102. package/up/commands/melhorias.md +0 -45
  103. package/up/commands/mobile-first.md +0 -71
  104. package/up/commands/modo-builder.md +0 -186
  105. package/up/commands/novo-projeto.md +0 -40
  106. package/up/commands/onboard.md +0 -69
  107. package/up/commands/pausar.md +0 -33
  108. package/up/commands/planejar-fase.md +0 -45
  109. package/up/commands/progresso.md +0 -33
  110. package/up/commands/remover-fase.md +0 -34
  111. package/up/commands/resetar.md +0 -27
  112. package/up/commands/retomar.md +0 -35
  113. package/up/commands/saude.md +0 -103
  114. package/up/commands/ux-tester.md +0 -63
  115. package/up/commands/verificar-trabalho.md +0 -35
  116. package/up/workflows/adicionar-fase.md +0 -112
  117. package/up/workflows/builder-e2e.md +0 -501
  118. package/up/workflows/builder.md +0 -3419
  119. package/up/workflows/ceo-intake.md +0 -305
  120. package/up/workflows/ceo-updates.md +0 -183
  121. package/up/workflows/clone-builder.md +0 -320
  122. package/up/workflows/discutir-fase.md +0 -336
  123. package/up/workflows/executar-fase.md +0 -358
  124. package/up/workflows/executar-plano.md +0 -659
  125. package/up/workflows/ideias.md +0 -381
  126. package/up/workflows/iniciar.md +0 -235
  127. package/up/workflows/melhorias.md +0 -409
  128. package/up/workflows/mobile-first.md +0 -692
  129. package/up/workflows/novo-projeto.md +0 -778
  130. package/up/workflows/planejar-fase.md +0 -293
  131. package/up/workflows/progresso.md +0 -226
  132. package/up/workflows/retomar.md +0 -231
  133. package/up/workflows/ux-tester.md +0 -526
  134. package/up/workflows/verificar-trabalho.md +0 -308
@@ -1,381 +0,0 @@
1
- <purpose>
2
- Executar ideacao de features com 2 agentes paralelos (analise de codigo + pesquisa de mercado) e consolidar resultados em relatorio com ICE scoring e anti-features. Funciona standalone -- nao requer /up:novo-projeto.
3
- </purpose>
4
-
5
- <process>
6
-
7
- **Passo 1: Inicializar e carregar contexto**
8
-
9
- ```bash
10
- INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init ideias)
11
- if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
12
- ```
13
-
14
- Parse JSON: `planning_exists`, `ideias_dir`, `ideias_exists`, `has_claude_md`, `has_package_json`, `date`, `timestamp`, `commit_docs`, `stack_hints`.
15
-
16
- Exibir banner:
17
- ```
18
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
19
- UP > IDEACAO DE FEATURES
20
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
21
- ```
22
-
23
- ---
24
-
25
- **Passo 2: Setup standalone (INFRA-04)**
26
-
27
- Se `ideias_exists` = true: perguntar ao usuario se quer sobrescrever a ideacao anterior ou cancelar.
28
-
29
- ```
30
- AskUserQuestion(
31
- header: "Ideacao Anterior Encontrada",
32
- question: "Ja existe uma ideacao em .plano/ideias/. Deseja sobrescrever?",
33
- followUp: null
34
- )
35
- ```
36
-
37
- Se usuario diz nao/cancelar, sair com mensagem: "Ideacao cancelada. Relatorio anterior permanece em .plano/ideias/RELATORIO.md"
38
-
39
- Se `ideias_exists` = false:
40
- ```bash
41
- mkdir -p .plano/ideias
42
- ```
43
-
44
- Se `planning_exists` = false (nao tem .plano/ de nenhum tipo):
45
- ```bash
46
- mkdir -p .plano/ideias
47
- ```
48
- (O mkdir -p cria ambos diretorios).
49
-
50
- Reportar:
51
- ```
52
- Diretorio de ideacao: .plano/ideias/
53
- Modo: Standalone (sem pre-requisitos)
54
- ```
55
-
56
- ---
57
-
58
- **Passo 3: Reportar deteccao de stack**
59
-
60
- Usar `stack_hints` do init JSON para reportar ao usuario o que foi detectado:
61
-
62
- ```
63
- ## Stack Detectada
64
-
65
- [Listar: framework frontend, meta-framework, CSS, ORM, TypeScript -- baseado nos booleans de stack_hints]
66
-
67
- Agentes farao deteccao granular durante a analise.
68
- ```
69
-
70
- Se `has_package_json` = false:
71
- ```
72
- Nenhum package.json encontrado. Agentes tentarao detectar stack por outros sinais.
73
- ```
74
-
75
- ---
76
-
77
- **Passo 4: Spawn 2 agentes de ideias em PARALELO**
78
-
79
- Spawnar os 2 agentes na MESMA mensagem (paralelo via Task). Cada agente recebe contexto minimo -- eles leem seus proprios templates e fazem sua propria deteccao de stack internamente.
80
-
81
- **Agente 1: Analista de Codigo**
82
- ```
83
- Task(
84
- subagent_type="up-analista-codigo",
85
- prompt="
86
- <objective>
87
- Analisar o codebase deste projeto para identificar gaps funcionais e oportunidades de features novas.
88
- Salvar resultado em .plano/ideias/codigo-sugestoes.md
89
- </objective>
90
-
91
- <files_to_read>
92
- - ./CLAUDE.md (se existir -- instrucoes do projeto)
93
- </files_to_read>
94
-
95
- <constraints>
96
- - Carregar template: $HOME/.claude/up/templates/suggestion.md
97
- - Detectar stack do projeto (step 1 do agente)
98
- - Mapear features existentes (step 2)
99
- - Analisar gaps nas 4 categorias: funcionalidade incompleta, feature adjacente, integracao ausente, DX
100
- - Produzir sugestoes IDEA-NNN no formato do template com Dimensao=Ideias
101
- - Incluir mapa de cobertura obrigatorio (INFRA-03)
102
- - Limitar a 10-15 sugestoes (qualidade sobre quantidade)
103
- - Salvar resultado em .plano/ideias/codigo-sugestoes.md
104
- - Retornar resumo no formato: ## ANALISE DE CODIGO COMPLETA
105
- </constraints>
106
- ",
107
- description="Analise de codigo para identificar gaps e oportunidades de features"
108
- )
109
- ```
110
-
111
- **Agente 2: Pesquisador de Mercado**
112
- ```
113
- Task(
114
- subagent_type="up-pesquisador-mercado",
115
- prompt="
116
- <objective>
117
- Pesquisar concorrentes e tendencias de mercado para sugerir features novas para este projeto.
118
- Salvar resultado em .plano/ideias/mercado-sugestoes.md
119
- </objective>
120
-
121
- <files_to_read>
122
- - ./CLAUDE.md (se existir -- instrucoes do projeto)
123
- - ./README.md (se existir -- descricao do projeto)
124
- - ./package.json (se existir -- dominio e dependencias)
125
- </files_to_read>
126
-
127
- <constraints>
128
- - Carregar template: $HOME/.claude/up/templates/suggestion.md
129
- - Entender dominio do projeto (step 1)
130
- - Pesquisar concorrentes via WebSearch (step 2)
131
- - Analisar tendencias de mercado via WebSearch (step 3)
132
- - Produzir sugestoes IDEA-NNN no formato do template com Dimensao=Ideias
133
- - Cada sugestao DEVE ter evidencia de mercado (concorrente ou tendencia)
134
- - Sinalizar LOW confidence quando baseado em dados de treinamento
135
- - Limitar a 10-15 sugestoes (qualidade sobre quantidade)
136
- - Salvar resultado em .plano/ideias/mercado-sugestoes.md
137
- - Retornar resumo no formato: ## PESQUISA DE MERCADO COMPLETA
138
- </constraints>
139
- ",
140
- description="Pesquisa de mercado e concorrentes para sugestoes de features"
141
- )
142
- ```
143
-
144
- **IMPORTANTE:** Os 2 Task DEVEM ser spawnados na MESMA mensagem para execucao paralela. NAO spawnar sequencialmente.
145
-
146
- ---
147
-
148
- **Passo 5: Coletar e verificar resultados dos agentes**
149
-
150
- Apos os 2 agentes retornarem:
151
-
152
- 1. Verificar existencia dos 2 arquivos:
153
- - `.plano/ideias/codigo-sugestoes.md`
154
- - `.plano/ideias/mercado-sugestoes.md`
155
-
156
- 2. Reportar resultado de cada agente extraindo do retorno:
157
- ```
158
- ## Resultados dos Agentes
159
-
160
- | Agente | Sugestoes | Cobertura/Confianca | Status |
161
- |--------|-----------|---------------------|--------|
162
- | Analista de Codigo | N | X/Y (Z%) | Completo |
163
- | Pesquisador de Mercado | N | HIGH/MIXED/LOW | Completo |
164
- ```
165
-
166
- 3. Se algum arquivo faltando: reportar qual agente falhou, mas continuar com o disponivel (consolidador aceita 1-2 fontes, minimo 1 obrigatoria).
167
-
168
- ---
169
-
170
- **Passo 6: Spawn consolidador**
171
-
172
- Spawnar o consolidador SEQUENCIALMENTE (apos passo 5 confirmar que arquivos existem).
173
-
174
- ```
175
- Task(
176
- subagent_type="up-consolidador-ideias",
177
- prompt="
178
- <objective>
179
- Consolidar sugestoes dos 2 agentes idealizadores em relatorio final.
180
- Deduplicar cross-fonte, aplicar ICE scoring, gerar anti-features.
181
- Salvar em .plano/ideias/RELATORIO.md
182
- </objective>
183
-
184
- <files_to_read>
185
- - .plano/ideias/codigo-sugestoes.md (sugestoes do analista de codigo)
186
- - .plano/ideias/mercado-sugestoes.md (sugestoes do pesquisador de mercado)
187
- - ./CLAUDE.md (se existir -- contexto do projeto)
188
- </files_to_read>
189
-
190
- <constraints>
191
- - Carregar template: $HOME/.claude/up/templates/report.md
192
- - Carregar template: $HOME/.claude/up/templates/suggestion.md
193
- - Deduplicar findings cross-fonte (2 criterios: mesma feature proposta, sobreposicao de escopo)
194
- - Aplicar ICE scoring a cada sugestao (Impact x Confidence x Ease, 1-10 cada)
195
- - Gerar anti-features na proporcao ceil(positivas/3)
196
- - Ranking por ICE score decrescente (maior primeiro)
197
- - Sumario executivo OPINATIVO (recomendar top 3 features e por onde comecar)
198
- - IDs mantidos como IDEA-NNN (namespace de ideias)
199
- - Salvar em .plano/ideias/RELATORIO.md
200
- - Retornar resumo no formato: ## CONSOLIDACAO DE IDEIAS COMPLETA
201
- </constraints>
202
- ",
203
- description="Consolidar sugestoes e criar relatorio final com ICE scoring"
204
- )
205
- ```
206
-
207
- Apos consolidador retornar:
208
- 1. Verificar existencia de `.plano/ideias/RELATORIO.md`
209
- 2. Se nao existe: erro -- "Consolidador falhou ao criar RELATORIO.md"
210
-
211
- ---
212
-
213
- **Passo 7: Apresentar relatorio e concluir**
214
-
215
- 1. Ler `.plano/ideias/RELATORIO.md`
216
- 2. Extrair: sumario executivo, tabela de visao geral, top 3 ICE, contagem de anti-features, proximos passos
217
-
218
- 3. Exibir output final:
219
- ```
220
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
221
- UP > IDEACAO COMPLETA
222
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
223
-
224
- [Sumario Executivo do relatorio -- 2-3 paragrafos opinativos]
225
-
226
- ## Visao Geral
227
-
228
- [Tabela de Visao Geral do relatorio com contagens por faixa ICE]
229
-
230
- ## Top Features por ICE Score
231
-
232
- | # | Feature | ICE Score | Categoria |
233
- |---|---------|-----------|-----------|
234
- | 1 | IDEA-NNN: [titulo] | NNN | must-have/performance/delighter |
235
- | 2 | IDEA-NNN: [titulo] | NNN | must-have/performance/delighter |
236
- | 3 | IDEA-NNN: [titulo] | NNN | must-have/performance/delighter |
237
-
238
- ## Anti-Features
239
-
240
- [Total] features que NAO devem ser implementadas (ver relatorio completo)
241
-
242
- ## Proximos Passos
243
-
244
- [Secao Proximos Passos do relatorio]
245
-
246
- ───────────────────────────────────────────────────────────────
247
-
248
- Relatorio completo: .plano/ideias/RELATORIO.md
249
- Sugestoes (codigo): .plano/ideias/codigo-sugestoes.md
250
- Sugestoes (mercado): .plano/ideias/mercado-sugestoes.md
251
-
252
- ───────────────────────────────────────────────────────────────
253
- ```
254
-
255
- **NAO committar automaticamente.** O relatorio e informativo -- o usuario decide o que fazer com ele. Se o projeto tem .plano/ com STATE.md, NAO atualizar STATE.md (ideias e standalone, nao parte do ciclo de fases).
256
-
257
- ---
258
-
259
- **Passo 8: Aprovacao interativa e integracao com roadmap (opcional)**
260
-
261
- Este passo permite converter ideias aprovadas em fases executaveis no ROADMAP.md.
262
-
263
- 1. Perguntar ao usuario se quer integrar ideias ao roadmap:
264
-
265
- ```
266
- AskUserQuestion(
267
- header: "Integrar ao Roadmap",
268
- question: "Deseja converter ideias aprovadas em fases no ROADMAP.md?",
269
- multiSelect: false,
270
- options: [
271
- { label: "Sim, selecionar ideias", description: "Escolher quais ideias viram fases executaveis" },
272
- { label: "Nao, apenas o relatorio", description: "Manter apenas o relatorio como referencia" }
273
- ]
274
- )
275
- ```
276
-
277
- Se usuario escolher "Nao": sair com mensagem "Relatorio salvo em .plano/ideias/RELATORIO.md. Use /up:ideias novamente para integrar ao roadmap quando quiser."
278
-
279
- 2. Se sim, ler `.plano/ideias/RELATORIO.md` e extrair todas as ideias (ID + titulo + ICE score + categoria).
280
-
281
- Para extrair ideias do RELATORIO.md: usar regex `### (IDEA-\d+): (.+)` para capturar ID e titulo. Extrair ICE score da tabela de campos ou da secao de ranking. Extrair categoria (must-have, performance, delighter) da mesma tabela. Detectar Anti-Features pela secao "## Anti-Features" no RELATORIO e excluir da lista.
282
-
283
- 3. Apresentar ideias ordenadas por ICE score decrescente para selecao:
284
-
285
- ```
286
- AskUserQuestion(
287
- header: "Selecionar Ideias",
288
- question: "Quais ideias devem virar fases no roadmap? (Maior ICE score = maior retorno)",
289
- multiSelect: true,
290
- options: [
291
- // Ordenadas por ICE decrescente
292
- { label: "IDEA-001: [titulo]", description: "ICE: 648 | must-have | I:9 C:9 E:8" },
293
- { label: "IDEA-003: [titulo]", description: "ICE: 480 | performance | I:8 C:8 E:7.5" },
294
- { label: "IDEA-007: [titulo]", description: "ICE: 280 | delighter | I:7 C:5 E:8" },
295
- ]
296
- )
297
- ```
298
-
299
- **IMPORTANTE:** NAO incluir ideias da secao "Anti-Features" na lista de opcoes. Se o usuario perguntar, explicar que anti-features sao features que NAO devem ser implementadas.
300
-
301
- Labels no multiSelect devem ser curtos: "IDEA-001: Titulo curto" (max ~60 chars). Description complementa: "ICE: 648 | must-have | I:9 C:9 E:8".
302
-
303
- 4. Verificar se existe `.plano/ROADMAP.md`:
304
- - Se existe: usar diretamente
305
- - Se NAO existe: perguntar ao usuario:
306
- ```
307
- AskUserQuestion(
308
- header: "Criar Roadmap",
309
- question: "Nao existe ROADMAP.md. Deseja criar um para adicionar as fases?",
310
- multiSelect: false,
311
- options: [
312
- { label: "Sim, criar roadmap", description: "Cria .plano/ROADMAP.md com as fases selecionadas" },
313
- { label: "Nao, cancelar", description: "Manter apenas o relatorio" }
314
- ]
315
- )
316
- ```
317
- Se sim, criar ROADMAP.md minimo:
318
- ```bash
319
- mkdir -p .plano
320
- ```
321
- Escrever `.plano/ROADMAP.md` com:
322
- ```markdown
323
- # Roadmap: [nome do projeto de package.json ou diretorio]
324
-
325
- ## Fases
326
-
327
- ## Detalhes das Fases
328
-
329
- ## Tabela de Progresso
330
-
331
- | Fase | Planos Completos | Status | Completado |
332
- |------|-----------------|--------|------------|
333
- ```
334
-
335
- 5. Chamar CLI para gerar fases:
336
-
337
- ```bash
338
- echo '{"source":"ideias","report_path":".plano/ideias/RELATORIO.md","approved_ids":["IDEA-001","IDEA-003","IDEA-007"],"grouping":"auto"}' | node "$HOME/.claude/up/bin/up-tools.cjs" phase generate-from-report
339
- ```
340
-
341
- Substituir approved_ids pela lista real selecionada pelo usuario.
342
-
343
- 6. Parsear resultado JSON e apresentar resumo:
344
-
345
- ```
346
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
347
- UP > FASES GERADAS NO ROADMAP
348
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
349
-
350
- [Para cada fase criada:]
351
- Fase [N]: [Nome]
352
- Sugestoes: [IDs listados]
353
- Diretorio: [caminho]
354
-
355
- Total: [N] fases criadas com [M] sugestoes
356
-
357
- ───────────────────────────────────────────────────────────────
358
-
359
- ## Proximos Passos
360
-
361
- Para cada fase gerada:
362
- 1. `/up:discutir-fase [N]` -- Refinar escopo e decisoes
363
- 2. `/up:planejar-fase [N]` -- Criar planos de execucao
364
- 3. `/up:executar-fase [N]` -- Implementar
365
-
366
- <sub>/clear primeiro -- janela de contexto limpa</sub>
367
-
368
- ───────────────────────────────────────────────────────────────
369
- ```
370
-
371
- </process>
372
-
373
- <success_criteria>
374
- - [ ] Init ideias retornou JSON valido
375
- - [ ] Diretorio .plano/ideias/ criado (standalone)
376
- - [ ] Stack detectada e reportada ao usuario
377
- - [ ] 2 agentes idealizadores spawnados em paralelo
378
- - [ ] Pelo menos 1 arquivo de sugestoes gerado
379
- - [ ] Consolidador gerou RELATORIO.md com ICE scoring e anti-features
380
- - [ ] Relatorio apresentado ao usuario com sumario, top features e anti-features
381
- </success_criteria>
@@ -1,235 +0,0 @@
1
- <purpose>
2
- Registrar projeto no UP de forma leve. Sem questionario, sem requisitos, sem roadmap.
3
- Detecta o que existe, gera PROJECT.md automaticamente, cria config padrao, para.
4
-
5
- O PROJECT.md vai crescer conforme o usuario planeja fases com /up:planejar-fase e /up:discutir-fase.
6
- </purpose>
7
-
8
- <process>
9
-
10
- ## 1. Setup
11
-
12
- **PRIMEIRO PASSO OBRIGATORIO -- Execute antes de qualquer interacao:**
13
-
14
- ```bash
15
- INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init iniciar)
16
- if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
17
- ```
18
-
19
- Parse JSON: `commit_docs`, `project_exists`, `planning_exists`, `has_existing_code`, `has_codebase_map`, `codebase_files`, `has_git`, `has_package_json`, `has_readme`, `stack_hints`.
20
-
21
- **Se `project_exists` = true:**
22
-
23
- Use AskUserQuestion:
24
- - header: "PROJECT.md existente"
25
- - question: "Ja existe um PROJECT.md. O que fazer?"
26
- - options:
27
- - "Sobrescrever" -- Gerar novamente a partir do codebase
28
- - "Cancelar" -- Manter como esta
29
-
30
- Se "Cancelar": Sair. Sugerir `/up:progresso`.
31
-
32
- **Se `has_git` = false:** Inicializar git:
33
- ```bash
34
- git init
35
- ```
36
-
37
- ## 2. Coletar informacoes do projeto (AUTOMATICO, sem perguntar)
38
-
39
- ```
40
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
41
- UP > REGISTRANDO PROJETO
42
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
43
- ```
44
-
45
- ### Fontes de informacao (ler em paralelo, o que existir):
46
-
47
- **Sempre ler:**
48
- ```bash
49
- # package.json (nome, descricao, dependencias)
50
- cat package.json 2>/dev/null
51
-
52
- # README (descricao do projeto)
53
- cat README.md 2>/dev/null || cat readme.md 2>/dev/null
54
-
55
- # CLAUDE.md do projeto (instrucoes existentes)
56
- cat CLAUDE.md 2>/dev/null
57
-
58
- # Estrutura de diretorios (top-level)
59
- ls -d */ 2>/dev/null | head -20
60
- ```
61
-
62
- **Se `has_codebase_map` = true (mapeamento completo existe):**
63
- ```bash
64
- cat .plano/codebase/STACK.md 2>/dev/null
65
- cat .plano/codebase/ARCHITECTURE.md 2>/dev/null
66
- cat .plano/codebase/CONCERNS.md 2>/dev/null
67
- cat .plano/codebase/CONVENTIONS.md 2>/dev/null
68
- ```
69
-
70
- **Se `has_codebase_map` = false E `has_existing_code` = true (mini-scan):**
71
- ```bash
72
- # Detectar stack pelos arquivos de config
73
- ls package.json go.mod Cargo.toml requirements.txt pyproject.toml pom.xml build.gradle composer.json Gemfile mix.exs 2>/dev/null
74
-
75
- # Detectar estrutura
76
- ls -d src/ app/ lib/ cmd/ internal/ pages/ components/ public/ api/ server/ 2>/dev/null | head -15
77
-
78
- # Detectar frameworks (package.json deps)
79
- node -e "try{const p=require('./package.json');console.log(JSON.stringify({deps:Object.keys(p.dependencies||{}),devDeps:Object.keys(p.devDependencies||{})}))}catch{}" 2>/dev/null
80
- ```
81
-
82
- ### Sintetizar informacoes coletadas:
83
-
84
- A partir das fontes lidas, extrair:
85
- - **Nome do projeto**: de package.json name, ou nome do diretorio
86
- - **Descricao**: de package.json description, ou primeiro paragrafo do README, ou inferir do codigo
87
- - **Stack**: frameworks, linguagens, dependencias principais
88
- - **Estrutura**: organizacao de diretorios, entry points
89
- - **Contexto adicional**: do CLAUDE.md, README, ou codebase map
90
-
91
- ## 3. Gerar PROJECT.md (AUTOMATICO)
92
-
93
- Escrever `.plano/PROJECT.md` sintetizando tudo que foi coletado:
94
-
95
- ```markdown
96
- # [Nome do Projeto]
97
-
98
- ## O que e Isso
99
-
100
- [Descricao gerada automaticamente a partir de package.json, README, e/ou analise do codigo.
101
- 2-3 frases descrevendo o que o produto faz e para quem.]
102
-
103
- ## Valor Central
104
-
105
- [Inferido do codigo/README. Se nao for possivel inferir com confianca, usar:]
106
- [A definir -- sera refinado conforme o projeto evolui]
107
-
108
- ## Requisitos
109
-
110
- ### Validados
111
-
112
- <!-- Inferidos do codebase existente -->
113
-
114
- - [x] [Feature existente 1 detectada no codigo]
115
- - [x] [Feature existente 2 detectada no codigo]
116
- - [x] [Feature existente 3 detectada no codigo]
117
-
118
- ### Ativos
119
-
120
- <!-- Adicione objetivos com /up:planejar-fase ou /up:discutir-fase -->
121
-
122
- (Nenhum ainda)
123
-
124
- ### Fora do Escopo
125
-
126
- (A definir)
127
-
128
- ## Contexto
129
-
130
- **Stack:** [linguagens, frameworks, dependencias principais]
131
- **Estrutura:** [organizacao do projeto]
132
- [Se codebase map existe:]
133
- **Mapeamento detalhado:** .plano/codebase/
134
- [Se README existe:]
135
- **Documentacao:** README.md
136
- [Se CLAUDE.md existe:]
137
- **Instrucoes de desenvolvimento:** CLAUDE.md
138
-
139
- ## Restricoes
140
-
141
- - **Stack**: [stack detectada] -- projeto existente
142
- [Outras restricoes inferidas, ex: se tem TypeScript strict, se tem ESLint, etc.]
143
-
144
- ## Decisoes-Chave
145
-
146
- | Decisao | Justificativa | Resultado |
147
- |---------|---------------|-----------|
148
- | Registrado via /up:iniciar | Adocao incremental do UP | -- |
149
-
150
- ---
151
- *Ultima atualizacao: [data] apos registro inicial*
152
- ```
153
-
154
- **IMPORTANTE:** Preencher Requisitos Validados com features REAIS detectadas no codigo. Se tem codebase map, usar ARCHITECTURE.md como fonte. Se nao, inferir das dependencias e estrutura (ex: "Sistema de autenticacao com NextAuth", "API REST com Express", "Interface com React e Tailwind").
155
-
156
- Nao inventar features. So listar o que e evidente no codigo.
157
-
158
- **Commit PROJECT.md:**
159
-
160
- ```bash
161
- mkdir -p .plano
162
- node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs: registrar projeto via /up:iniciar" --files .plano/PROJECT.md
163
- ```
164
-
165
- ## 4. Criar config.json padrao
166
-
167
- Criar `.plano/config.json` com valores padrao (sem perguntar):
168
-
169
- ```json
170
- {
171
- "mode": "yolo",
172
- "granularity": "standard",
173
- "parallelization": true,
174
- "commit_docs": true
175
- }
176
- ```
177
-
178
- **Commit config.json:**
179
-
180
- ```bash
181
- node "$HOME/.claude/up/bin/up-tools.cjs" commit "chore: config padrao do projeto" --files .plano/config.json
182
- ```
183
-
184
- ## 5. Finalizar
185
-
186
- ```
187
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
188
- UP > PROJETO REGISTRADO
189
- ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
190
-
191
- **[Nome do Projeto]**
192
-
193
- [Descricao curta -- 1 linha do "O que e Isso"]
194
-
195
- | Artefato | Localizacao |
196
- |-----------|----------------------|
197
- | Projeto | `.plano/PROJECT.md` |
198
- | Config | `.plano/config.json` |
199
- [Se codebase map existe:]
200
- | Codebase | `.plano/codebase/` |
201
-
202
- **[N] features existentes documentadas**
203
-
204
- ───────────────────────────────────────────────────────────────
205
-
206
- ## Proximos Passos
207
-
208
- O UP esta pronto. Use conforme precisar:
209
-
210
- - `/up:mapear-codigo` -- Analise profunda do codebase (se ainda nao mapeou)
211
- - `/up:melhorias` -- Auditoria de UX, performance, modernidade
212
- - `/up:ideias` -- Sugestoes de features novas
213
- - `/up:planejar-fase` -- Quando tiver algo especifico para implementar
214
- - `/up:rapido` -- Tarefa rapida sem fase formal
215
-
216
- PROJECT.md e um documento vivo -- sera atualizado conforme voce planeja e executa fases.
217
-
218
- <sub>/clear antes do proximo comando -- janela de contexto limpa</sub>
219
-
220
- ───────────────────────────────────────────────────────────────
221
- ```
222
-
223
- </process>
224
-
225
- <success_criteria>
226
-
227
- - [ ] .plano/ diretorio criado
228
- - [ ] Git repo inicializado (se nao existia)
229
- - [ ] Informacoes coletadas automaticamente (sem perguntas ao usuario)
230
- - [ ] PROJECT.md gerado com features existentes documentadas -> **committed**
231
- - [ ] config.json criado com valores padrao -> **committed**
232
- - [ ] NENHUM questionario, NENHUM REQUIREMENTS.md, NENHUM ROADMAP.md
233
- - [ ] Proximos passos apresentados
234
-
235
- </success_criteria>