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.
- package/README.md +87 -577
- package/package.json +5 -3
- package/up/CHANGELOG.md +110 -0
- package/up/agents/up-arquiteto.md +95 -39
- package/up/agents/up-auditor.md +218 -0
- package/up/agents/up-executor.md +94 -31
- package/up/agents/up-mapeador-codigo.md +63 -10
- package/up/agents/up-pesquisador.md +278 -0
- package/up/agents/up-revisor.md +249 -0
- package/up/agents/up-sintetizador.md +156 -179
- package/up/agents/up-tester.md +280 -0
- package/up/agents/up-verificador.md +95 -11
- package/up/bin/install.js +182 -19
- package/up/bin/lib/core.cjs +17 -43
- package/up/bin/lib/github.cjs +495 -0
- package/up/bin/lib/multica.cjs +424 -0
- package/up/bin/up-tools.cjs +167 -46
- package/up/commands/auditar.md +66 -0
- package/up/commands/build.md +54 -43
- package/up/commands/depurar.md +1 -1
- package/up/commands/plan.md +52 -38
- package/up/commands/rapido.md +15 -9
- package/up/commands/testar.md +81 -122
- package/up/commands/up.md +106 -0
- package/up/hooks/up-session-start.js +107 -0
- package/up/references/engineering-principles.md +1 -1
- package/up/references/governance-rules.md +5 -5
- package/up/references/production-requirements.md +1 -1
- package/up/references/severity-levels.md +2 -2
- package/up/references/tdd-evidence-types.md +81 -0
- package/up/skills/up-brainstorm/SKILL.md +54 -0
- package/up/skills/up-brainstorm/visual-companion.md +33 -0
- package/up/skills/up-tdd/SKILL.md +39 -0
- package/up/skills/up-verificar-antes-de-concluir/SKILL.md +49 -0
- package/up/skills/usando-up/SKILL.md +26 -0
- package/up/templates/audit-plan.md +3 -3
- package/up/templates/audit-report.md +2 -2
- package/up/templates/design-tokens.md +2 -2
- package/up/workflows/auditar.md +255 -0
- package/up/workflows/build.md +600 -386
- package/up/workflows/dcrv.md +183 -99
- package/up/workflows/governance.md +112 -220
- package/up/workflows/plan.md +169 -399
- package/up/workflows/rapido.md +7 -1
- package/up/workflows/up.md +447 -0
- package/up/agents/up-analista-codigo.md +0 -446
- package/up/agents/up-api-tester.md +0 -405
- package/up/agents/up-architecture-supervisor.md +0 -126
- package/up/agents/up-audit-supervisor.md +0 -83
- package/up/agents/up-auditor-modernidade.md +0 -378
- package/up/agents/up-auditor-performance.md +0 -426
- package/up/agents/up-auditor-ux.md +0 -396
- package/up/agents/up-backend-specialist.md +0 -175
- package/up/agents/up-blind-validator.md +0 -259
- package/up/agents/up-chief-architect.md +0 -184
- package/up/agents/up-chief-engineer.md +0 -202
- package/up/agents/up-chief-operations.md +0 -123
- package/up/agents/up-chief-product.md +0 -103
- package/up/agents/up-chief-quality.md +0 -211
- package/up/agents/up-clone-crawler.md +0 -234
- package/up/agents/up-clone-design-extractor.md +0 -227
- package/up/agents/up-clone-feature-mapper.md +0 -225
- package/up/agents/up-clone-prd-writer.md +0 -169
- package/up/agents/up-clone-verifier.md +0 -227
- package/up/agents/up-code-reviewer.md +0 -229
- package/up/agents/up-consolidador-ideias.md +0 -493
- package/up/agents/up-database-specialist.md +0 -169
- package/up/agents/up-delivery-auditor.md +0 -247
- package/up/agents/up-devops-agent.md +0 -203
- package/up/agents/up-execution-supervisor.md +0 -315
- package/up/agents/up-exhaustive-tester.md +0 -348
- package/up/agents/up-frontend-specialist.md +0 -152
- package/up/agents/up-operations-supervisor.md +0 -94
- package/up/agents/up-pesquisador-mercado.md +0 -350
- package/up/agents/up-pesquisador-projeto.md +0 -358
- package/up/agents/up-planning-auditor.md +0 -284
- package/up/agents/up-planning-supervisor.md +0 -260
- package/up/agents/up-product-analyst.md +0 -192
- package/up/agents/up-product-supervisor.md +0 -83
- package/up/agents/up-project-ceo.md +0 -352
- package/up/agents/up-qa-agent.md +0 -171
- package/up/agents/up-quality-supervisor.md +0 -178
- package/up/agents/up-requirements-validator.md +0 -230
- package/up/agents/up-security-reviewer.md +0 -137
- package/up/agents/up-sintetizador-melhorias.md +0 -407
- package/up/agents/up-system-designer.md +0 -332
- package/up/agents/up-technical-writer.md +0 -188
- package/up/agents/up-verification-supervisor.md +0 -111
- package/up/agents/up-visual-critic.md +0 -358
- package/up/commands/adicionar-fase.md +0 -47
- package/up/commands/adicionar-testes.md +0 -145
- package/up/commands/ajuda.md +0 -176
- package/up/commands/atualizar.md +0 -103
- package/up/commands/clone-builder.md +0 -67
- package/up/commands/configurar.md +0 -219
- package/up/commands/custos.md +0 -67
- package/up/commands/dashboard.md +0 -48
- package/up/commands/discutir-fase.md +0 -35
- package/up/commands/executar-fase.md +0 -40
- package/up/commands/ideias.md +0 -49
- package/up/commands/iniciar.md +0 -31
- package/up/commands/mapear-codigo.md +0 -63
- package/up/commands/melhorias.md +0 -45
- package/up/commands/mobile-first.md +0 -71
- package/up/commands/modo-builder.md +0 -186
- package/up/commands/novo-projeto.md +0 -40
- package/up/commands/onboard.md +0 -69
- package/up/commands/pausar.md +0 -33
- package/up/commands/planejar-fase.md +0 -45
- package/up/commands/progresso.md +0 -33
- package/up/commands/remover-fase.md +0 -34
- package/up/commands/resetar.md +0 -27
- package/up/commands/retomar.md +0 -35
- package/up/commands/saude.md +0 -103
- package/up/commands/ux-tester.md +0 -63
- package/up/commands/verificar-trabalho.md +0 -35
- package/up/workflows/adicionar-fase.md +0 -112
- package/up/workflows/builder-e2e.md +0 -501
- package/up/workflows/builder.md +0 -3419
- package/up/workflows/ceo-intake.md +0 -305
- package/up/workflows/ceo-updates.md +0 -183
- package/up/workflows/clone-builder.md +0 -320
- package/up/workflows/discutir-fase.md +0 -336
- package/up/workflows/executar-fase.md +0 -358
- package/up/workflows/executar-plano.md +0 -659
- package/up/workflows/ideias.md +0 -381
- package/up/workflows/iniciar.md +0 -235
- package/up/workflows/melhorias.md +0 -409
- package/up/workflows/mobile-first.md +0 -692
- package/up/workflows/novo-projeto.md +0 -778
- package/up/workflows/planejar-fase.md +0 -293
- package/up/workflows/progresso.md +0 -226
- package/up/workflows/retomar.md +0 -231
- package/up/workflows/ux-tester.md +0 -526
- package/up/workflows/verificar-trabalho.md +0 -308
package/up/workflows/ideias.md
DELETED
|
@@ -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>
|
package/up/workflows/iniciar.md
DELETED
|
@@ -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>
|