up-cc 0.16.1 → 2.0.1

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 (135) 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 +182 -19
  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 +54 -0
  32. package/up/skills/up-brainstorm/visual-companion.md +33 -0
  33. package/up/skills/up-tdd/SKILL.md +39 -0
  34. package/up/skills/up-verificar-antes-de-concluir/SKILL.md +49 -0
  35. package/up/skills/usando-up/SKILL.md +26 -0
  36. package/up/templates/audit-plan.md +3 -3
  37. package/up/templates/audit-report.md +2 -2
  38. package/up/templates/design-tokens.md +2 -2
  39. package/up/workflows/auditar.md +255 -0
  40. package/up/workflows/build.md +600 -386
  41. package/up/workflows/dcrv.md +183 -99
  42. package/up/workflows/governance.md +112 -220
  43. package/up/workflows/plan.md +169 -399
  44. package/up/workflows/rapido.md +7 -1
  45. package/up/workflows/up.md +447 -0
  46. package/up/agents/up-analista-codigo.md +0 -446
  47. package/up/agents/up-api-tester.md +0 -405
  48. package/up/agents/up-architecture-supervisor.md +0 -126
  49. package/up/agents/up-audit-supervisor.md +0 -83
  50. package/up/agents/up-auditor-modernidade.md +0 -378
  51. package/up/agents/up-auditor-performance.md +0 -426
  52. package/up/agents/up-auditor-ux.md +0 -396
  53. package/up/agents/up-backend-specialist.md +0 -175
  54. package/up/agents/up-blind-validator.md +0 -259
  55. package/up/agents/up-chief-architect.md +0 -184
  56. package/up/agents/up-chief-engineer.md +0 -202
  57. package/up/agents/up-chief-operations.md +0 -123
  58. package/up/agents/up-chief-product.md +0 -103
  59. package/up/agents/up-chief-quality.md +0 -211
  60. package/up/agents/up-clone-crawler.md +0 -234
  61. package/up/agents/up-clone-design-extractor.md +0 -227
  62. package/up/agents/up-clone-feature-mapper.md +0 -225
  63. package/up/agents/up-clone-prd-writer.md +0 -169
  64. package/up/agents/up-clone-verifier.md +0 -227
  65. package/up/agents/up-code-reviewer.md +0 -229
  66. package/up/agents/up-consolidador-ideias.md +0 -493
  67. package/up/agents/up-database-specialist.md +0 -169
  68. package/up/agents/up-delivery-auditor.md +0 -247
  69. package/up/agents/up-devops-agent.md +0 -203
  70. package/up/agents/up-execution-supervisor.md +0 -315
  71. package/up/agents/up-exhaustive-tester.md +0 -348
  72. package/up/agents/up-frontend-specialist.md +0 -152
  73. package/up/agents/up-operations-supervisor.md +0 -94
  74. package/up/agents/up-pesquisador-mercado.md +0 -350
  75. package/up/agents/up-pesquisador-projeto.md +0 -358
  76. package/up/agents/up-planning-auditor.md +0 -284
  77. package/up/agents/up-planning-supervisor.md +0 -260
  78. package/up/agents/up-product-analyst.md +0 -192
  79. package/up/agents/up-product-supervisor.md +0 -83
  80. package/up/agents/up-project-ceo.md +0 -352
  81. package/up/agents/up-qa-agent.md +0 -171
  82. package/up/agents/up-quality-supervisor.md +0 -178
  83. package/up/agents/up-requirements-validator.md +0 -230
  84. package/up/agents/up-security-reviewer.md +0 -137
  85. package/up/agents/up-sintetizador-melhorias.md +0 -407
  86. package/up/agents/up-system-designer.md +0 -332
  87. package/up/agents/up-technical-writer.md +0 -188
  88. package/up/agents/up-verification-supervisor.md +0 -111
  89. package/up/agents/up-visual-critic.md +0 -358
  90. package/up/commands/adicionar-fase.md +0 -47
  91. package/up/commands/adicionar-testes.md +0 -145
  92. package/up/commands/ajuda.md +0 -176
  93. package/up/commands/atualizar.md +0 -103
  94. package/up/commands/clone-builder.md +0 -67
  95. package/up/commands/configurar.md +0 -219
  96. package/up/commands/custos.md +0 -67
  97. package/up/commands/dashboard.md +0 -48
  98. package/up/commands/discutir-fase.md +0 -35
  99. package/up/commands/executar-fase.md +0 -40
  100. package/up/commands/ideias.md +0 -49
  101. package/up/commands/iniciar.md +0 -31
  102. package/up/commands/mapear-codigo.md +0 -63
  103. package/up/commands/melhorias.md +0 -45
  104. package/up/commands/mobile-first.md +0 -71
  105. package/up/commands/modo-builder.md +0 -186
  106. package/up/commands/novo-projeto.md +0 -40
  107. package/up/commands/onboard.md +0 -69
  108. package/up/commands/pausar.md +0 -33
  109. package/up/commands/planejar-fase.md +0 -45
  110. package/up/commands/progresso.md +0 -33
  111. package/up/commands/remover-fase.md +0 -34
  112. package/up/commands/resetar.md +0 -27
  113. package/up/commands/retomar.md +0 -35
  114. package/up/commands/saude.md +0 -103
  115. package/up/commands/ux-tester.md +0 -63
  116. package/up/commands/verificar-trabalho.md +0 -35
  117. package/up/workflows/adicionar-fase.md +0 -112
  118. package/up/workflows/builder-e2e.md +0 -501
  119. package/up/workflows/builder.md +0 -3419
  120. package/up/workflows/ceo-intake.md +0 -305
  121. package/up/workflows/ceo-updates.md +0 -183
  122. package/up/workflows/clone-builder.md +0 -320
  123. package/up/workflows/discutir-fase.md +0 -336
  124. package/up/workflows/executar-fase.md +0 -358
  125. package/up/workflows/executar-plano.md +0 -659
  126. package/up/workflows/ideias.md +0 -381
  127. package/up/workflows/iniciar.md +0 -235
  128. package/up/workflows/melhorias.md +0 -409
  129. package/up/workflows/mobile-first.md +0 -692
  130. package/up/workflows/novo-projeto.md +0 -778
  131. package/up/workflows/planejar-fase.md +0 -293
  132. package/up/workflows/progresso.md +0 -226
  133. package/up/workflows/retomar.md +0 -231
  134. package/up/workflows/ux-tester.md +0 -526
  135. 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>