up-cc 0.3.1 → 0.3.3

package/README.md

@@ -63,40 +63,56 @@ Apos instalar, reinicie o Claude Code e digite `/up:ajuda` para ver todos os com
 
 ### 1. Inicializando um projeto
 
-O UP funciona tanto para projetos novos (greenfield) quanto para codebases existentes (brownfield). A deteccao e automatica.
+O UP tem duas formas de comecar, dependendo do que voce precisa.
 
-#### Projeto novo (do zero)
+#### Adocao leve — `/up:iniciar` (recomendado para projetos existentes)
+
+```
+/up:iniciar
+```
+
+O UP vai:
+1. Detectar automaticamente a stack, estrutura e features do seu projeto
+2. Criar `PROJECT.md` documentando o que existe — **sem fazer perguntas**
+3. Criar `config.json` com valores padrao
+4. Parar
+
+Sem questionario, sem requisitos, sem roadmap. Voce vai construindo incrementalmente conforme precisa:
+
+```
+/up:iniciar                    # Registra projeto, cria PROJECT.md
+/up:mapear-codigo              # Analise profunda do codebase (opcional)
+/up:melhorias                  # Descobre o que melhorar
+/up:planejar-fase 1            # Quando tiver algo para implementar
+```
+
+Ideal quando voce quer adotar o UP num projeto existente sem definir tudo de cara.
+
+#### Pipeline completo — `/up:novo-projeto`
 
 ```
 /up:novo-projeto
 ```
 
 O UP vai:
-1. Perguntar "O que voce quer construir?"
+1. Perguntar "O que voce quer construir?" (greenfield) ou "O que voce quer fazer com esse codigo?" (brownfield)
 2. Fazer perguntas de acompanhamento para entender o projeto
 3. Opcionalmente pesquisar o ecossistema do dominio (stack, features, armadilhas)
 4. Definir requisitos interativamente, agrupados por categoria
 5. Gerar ROADMAP.md com fases, criterios de sucesso e rastreabilidade
 6. Criar PROJECT.md, STATE.md e config.json
 
-Ao final voce tera um `.plano/` completo pronto para o pipeline de fases.
+Ideal quando voce ja sabe o que quer fazer e quer o pipeline completo de cara. Funciona tanto para projetos novos (greenfield) quanto existentes (brownfield) — a deteccao e automatica.
 
-#### Projeto existente (brownfield)
+#### Mapeamento de codebase
+
+Ambos os caminhos se beneficiam do mapeamento profundo do codebase:
 
 ```
-/up:mapear-codigo         # Opcional, mas recomendado
-/up:novo-projeto          # Detecta brownfield automaticamente
+/up:mapear-codigo
 ```
 
-Se voce tem codigo no diretorio, o UP detecta e adapta:
-- Carrega o mapeamento do codebase (se `/up:mapear-codigo` ja rodou)
-- Pergunta "O que voce quer **fazer** com esse codigo?" em vez de "O que voce quer construir?"
-- Infere requisitos **validados** do codebase existente (features que ja funcionam)
-- Separa seus novos objetivos como requisitos **ativos**
-- Pesquisa foca em tecnologias **novas**, nao nas que voce ja usa
-- Todo o pipeline downstream (discutir, planejar, executar) recebe contexto do codebase
-
-O `/up:mapear-codigo` produz 7 documentos em `.plano/codebase/`:
+Produz 7 documentos em `.plano/codebase/`:
 
 | Documento | Conteudo |
 |-----------|----------|
@@ -108,14 +124,7 @@ O `/up:mapear-codigo` produz 7 documentos em `.plano/codebase/`:
 | TESTING.md | Infraestrutura de testes, cobertura |
 | CONCERNS.md | Divida tecnica, areas frageis, seguranca |
 
-Esses documentos alimentam automaticamente o restante do pipeline.
-
-#### Reinicializando um projeto
-
-Se voce ja tem um `.plano/PROJECT.md` e roda `/up:novo-projeto` novamente, o UP oferece:
-- **Revisar e atualizar** — Atualizar com novos objetivos
-- **Recomecar do zero** — Recriar tudo
-- **Cancelar** — Manter como esta
+Esses documentos alimentam automaticamente o restante do pipeline (discutir, planejar, executar).
 
 ### 2. O pipeline de fases
 
@@ -300,7 +309,8 @@ O UP:
 
 | Comando | Descricao |
 |---------|-----------|
-| `/up:novo-projeto` | Inicializar projeto (detecta greenfield/brownfield) |
+| `/up:iniciar` | Registrar projeto existente (leve, sem questionario) |
+| `/up:novo-projeto` | Inicializar projeto completo (questionario + requisitos + roadmap) |
 | `/up:mapear-codigo` | Analisar codebase existente com agentes paralelos |
 | `/up:retomar` | Restaurar contexto da sessao anterior |
 | `/up:discutir-fase N` | Coletar contexto por questionamento estruturado |
@@ -312,6 +322,8 @@ O UP:
 | `/up:adicionar-fase "desc"` | Adicionar fase ao final do roadmap |
 | `/up:remover-fase N` | Remover fase futura e renumerar |
 | `/up:adicionar-testes N` | Gerar testes para fase completa |
+| `/up:melhorias` | Auditoria completa (UX, performance, modernidade) |
+| `/up:ideias` | Sugestoes de features com pesquisa de mercado |
 | `/up:rapido "tarefa"` | Tarefa rapida com commits atomicos |
 | `/up:depurar` | Depuracao sistematica com metodo cientifico |
 | `/up:configurar` | Configurar opcoes do workflow |
@@ -332,14 +344,17 @@ O UP:
 --gaps-only       Executar apenas planos de fechamento de gaps
 ```
 
-### Pipeline
+### Pipelines
 
 ```
+Leve (recomendado para projetos existentes):
+/up:iniciar → /up:planejar-fase N → /up:executar-fase N → /up:verificar-trabalho N
+
+Completo:
 /up:novo-projeto → /up:discutir-fase N → /up:planejar-fase N → /up:executar-fase N → /up:verificar-trabalho N
-                                                                                              │
-                                                                                       Gaps? ─┤
-                                                                                       Sim  → /up:planejar-fase N --gaps
-                                                                                       Nao  → Proxima fase
+
+Ciclo de gaps:
+/up:verificar-trabalho N → Gaps? → /up:planejar-fase N --gaps → /up:executar-fase N --gaps-only → Re-verificar
 ```
 
 ## Estrutura do `.plano/`

package/agents/up-executor.md

@@ -23,7 +23,7 @@ Antes de executar, descubra o contexto do projeto:
 1. Liste skills disponiveis (subdiretorios)
 2. Leia `SKILL.md` de cada skill
 3. Carregue `rules/*.md` conforme necessario durante implementacao
-4. NAO carregue `AGENTS.md` completos (100KB+)
+4. Carregue `AGENTS.md` quando necessario (com 1M de contexto, 100KB e aceitavel)
 5. Siga regras das skills relevantes a sua tarefa atual
 </project_context>
 
@@ -144,13 +144,13 @@ So auto-corrija issues DIRETAMENTE causados pelas mudancas da tarefa atual. Warn
 - NAO re-execute builds esperando que se resolvam
 
 **LIMITE DE TENTATIVAS:**
-Registre tentativas de auto-correcao por tarefa. Apos 3 tentativas em uma unica tarefa:
+Registre tentativas de auto-correcao por tarefa. Apos 7 tentativas em uma unica tarefa:
 - PARE de corrigir — documente issues restantes em SUMMARY.md sob "Issues Adiados"
 - Continue para a proxima tarefa
 </deviation_rules>
 
 <analysis_paralysis_guard>
-**Durante execucao de tarefa, se voce fizer 5+ chamadas Read/Grep/Glob consecutivas sem nenhuma acao Edit/Write/Bash:**
+**Durante execucao de tarefa, se voce fizer 12+ chamadas Read/Grep/Glob consecutivas sem nenhuma acao Edit/Write/Bash:**
 
 PARE. Declare em uma frase por que nao escreveu nada ainda. Entao:
 1. Escreva codigo (voce tem contexto suficiente), ou

package/agents/up-planejador.md

@@ -15,7 +15,7 @@ Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read
 
 **Responsabilidades principais:**
 - **PRIMEIRO: Analisar e honrar decisoes do usuario de CONTEXT.md** (decisoes travadas sao INEGOCIAVEIS)
-- Decompor fases em planos otimizados para paralelismo com 2-3 tarefas cada
+- Decompor fases em planos otimizados para paralelismo com 5-8 tarefas cada
 - Construir grafos de dependencia e atribuir ondas de execucao
 - Derivar must-haves usando metodologia goal-backward
 - Lidar com planejamento padrao e modo de fechamento de gaps
@@ -32,7 +32,7 @@ Antes de planejar, descubra o contexto do projeto:
 1. Liste skills disponiveis (subdiretorios)
 2. Leia `SKILL.md` de cada skill (indice leve ~130 linhas)
 3. Carregue arquivos `rules/*.md` especificos conforme necessario durante o planejamento
-4. NAO carregue arquivos `AGENTS.md` completos (custo de 100KB+ de contexto)
+4. Carregue `AGENTS.md` quando necessario para entender padroes do projeto (com 1M de contexto, 100KB e aceitavel)
 5. Garanta que planos considerem padroes e convencoes das skills do projeto
 </project_context>
 
@@ -82,12 +82,12 @@ PLAN.md E o prompt (nao um documento que vira prompt). Contem:
 
 | Uso de Contexto | Qualidade | Estado do Claude |
 |-----------------|-----------|------------------|
-| 0-30% | PICO | Minucioso, abrangente |
-| 30-50% | BOM | Confiante, trabalho solido |
-| 50-70% | DEGRADANDO | Modo eficiencia comeca |
-| 70%+ | RUIM | Apressado, minimo |
+| 0-40% | PICO | Minucioso, abrangente |
+| 40-60% | BOM | Confiante, trabalho solido |
+| 60-80% | DEGRADANDO | Modo eficiencia comeca |
+| 80%+ | RUIM | Apressado, minimo |
 
-**Regra:** Planos devem completar dentro de ~50% do contexto. Mais planos, escopo menor, qualidade consistente. Cada plano: 2-3 tarefas max.
+**Regra:** Planos devem completar dentro de ~70% do contexto. Mais planos, escopo menor, qualidade consistente. Cada plano: 5-8 tarefas max.
 
 ## Envie Rapido
 
@@ -168,10 +168,10 @@ Cada tarefa tem quatro campos obrigatorios:
 
 ## Dimensionamento de Tarefa
 
-Cada tarefa: **15-60 minutos** tempo de execucao do Claude.
-- Se > 60 min: Divida em subtarefas
-- Se < 15 min: Combine com tarefa adjacente
-- 2-3 tarefas por plano (max)
+Cada tarefa: **5-180 minutos** tempo de execucao do Claude.
+- Se > 180 min: Divida em subtarefas
+- Se < 5 min: Combine com tarefa adjacente
+- 5-8 tarefas por plano (max)
 </task_breakdown>
 
 <wave_assignment>
@@ -268,7 +268,7 @@ Se o dominio envolver bibliotecas/APIs desconhecidas:
 
 ### Passo 4: Decompor em Tarefas
 
-- Crie 2-3 tarefas por plano
+- Crie 5-8 tarefas por plano
 - Atribua ondas de execucao
 - Defina depends_on entre planos
 - Derive must-haves (goal-backward)
@@ -377,7 +377,7 @@ Plano esta completo quando:
 - [ ] Contexto do projeto descoberto (CLAUDE.md, skills)
 - [ ] Decisoes do usuario honradas (context_fidelity)
 - [ ] Research inline executada (se necessario)
-- [ ] Fase decomposta em planos com 2-3 tarefas cada
+- [ ] Fase decomposta em planos com 5-8 tarefas cada
 - [ ] Ondas de execucao atribuidas
 - [ ] Dependencias entre planos definidas
 - [ ] Must-haves derivados (goal-backward)

package/bin/lib/core.cjs

@@ -20,7 +20,7 @@ function output(result, raw, rawValue) {
     process.stdout.write(String(rawValue));
   } else {
     const json = JSON.stringify(result, null, 2);
-    if (json.length > 50000) {
+    if (json.length > 200000) {
       const tmpPath = path.join(require('os').tmpdir(), `up-${Date.now()}.json`);
       fs.writeFileSync(tmpPath, json, 'utf-8');
       process.stdout.write('@file:' + tmpPath);

package/commands/depurar.md

@@ -14,7 +14,7 @@ Depurar problemas usando metodo cientifico com isolamento em subagente.
 
 **Papel do orquestrador:** Coletar sintomas, spawnar agente up-depurador, lidar com checkpoints, spawnar continuacoes.
 
-**Por que subagente:** Investigacao consome contexto rapidamente (lendo arquivos, formando hipoteses, testando). Contexto fresco de 200k por investigacao. Contexto principal permanece enxuto para interacao com usuario.
+**Por que subagente:** Investigacao consome contexto rapidamente (lendo arquivos, formando hipoteses, testando). Contexto fresco de 800k por investigacao. Contexto principal permanece enxuto para interacao com usuario.
 </objective>
 
 <context>

package/hooks/up-context-monitor.js

@@ -7,8 +7,8 @@ const fs = require('fs');
 const os = require('os');
 const path = require('path');
 
-const WARNING_THRESHOLD = 35;
-const CRITICAL_THRESHOLD = 25;
+const WARNING_THRESHOLD = 15;
+const CRITICAL_THRESHOLD = 8;
 const STALE_SECONDS = 60;
 const DEBOUNCE_CALLS = 5;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"

package/templates/state.md

@@ -119,10 +119,10 @@ Enables instant resumption:
 
 <size_constraint>
 
-Keep STATE.md under 60 lines.
+Keep STATE.md under 150 lines.
 
 It's a DIGEST, not an archive. If accumulated context grows too large:
-- Keep only 3-5 recent decisions in summary (full log in PROJECT.md)
+- Keep only 10-15 recent decisions in summary (full log in PROJECT.md)
 - Keep only active blockers, remove resolved ones
 
 The goal is "read once, know where we are" -- if it's too long, that fails.

package/workflows/executar-fase.md

@@ -76,7 +76,7 @@ Executar cada wave em sequencia. Dentro de uma wave: paralelo se `PARALLELIZATIO
 
 2. **Spawn agentes executores:**
 
-   Passar apenas caminhos -- executores leem arquivos eles mesmos com contexto limpo de 200k.
+   Passar apenas caminhos -- executores leem arquivos eles mesmos com contexto limpo de 800k.
 
    ```
    Task(
@@ -263,7 +263,7 @@ node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs(fase-{X}): completar execu
 </process>
 
 <context_efficiency>
-Orquestrador: ~10-15% contexto. Subagentes: 200k limpo cada. Sem polling (Task bloqueia). Sem vazamento de contexto.
+Orquestrador: ~10-15% contexto. Subagentes: 800k limpo cada. Sem polling (Task bloqueia). Sem vazamento de contexto.
 </context_efficiency>
 
 <failure_handling>

package/workflows/rapido.md

@@ -81,7 +81,7 @@ Task(
 - Criar UM UNICO plano com 1-3 tarefas focadas
 - Tarefas rapidas devem ser atomicas e autocontidas
 - Sem fase de pesquisa
-- Alvo ~30% uso de contexto (simples, focado)
+- Alvo ~10% uso de contexto (simples, focado)
 </constraints>
 
 <output>