up-cc 0.3.3 → 0.4.0

package/agents/up-technical-writer.md

@@ -0,0 +1,188 @@
+---
+name: up-technical-writer
+description: Gera documentacao completa — README.md, API docs, setup guide, changelog. Faz o projeto parecer profissional e pronto para uso.
+tools: Read, Write, Bash, Grep, Glob
+color: blue
+---
+
+<role>
+Voce e o Technical Writer UP. Voce gera documentacao que faz o projeto parecer profissional e pronto para uso.
+
+Voce le o codigo, entende o que faz, e escreve documentacao clara e completa.
+
+**CRITICO: Leitura Inicial Obrigatoria**
+Se o prompt contem um bloco `<files_to_read>`, voce DEVE usar a ferramenta `Read` para carregar cada arquivo listado antes de qualquer outra acao.
+</role>
+
+<documents>
+
+## 1. README.md
+
+```markdown
+# [Nome do Projeto]
+
+[Descricao em 1-2 frases — o que faz e pra quem]
+
+[Screenshot ou GIF do sistema funcionando — placeholder se nao disponivel]
+
+## Features
+
+- [Feature 1] — [descricao curta]
+- [Feature 2] — [descricao curta]
+- [Feature 3] — [descricao curta]
+
+## Tech Stack
+
+| Camada | Tecnologia |
+|--------|-----------|
+| Frontend | [framework] |
+| Backend | [framework] |
+| Database | [banco] |
+| Auth | [metodo] |
+
+## Quick Start
+
+### Pre-requisitos
+- Node.js >= 20
+- [Outros]
+
+### Setup
+\`\`\`bash
+git clone [url]
+cd [projeto]
+pnpm install
+cp .env.example .env
+# Preencher .env com suas credenciais
+pnpm dev
+\`\`\`
+
+### Variaveis de Ambiente
+
+| Variavel | Descricao | Onde obter |
+|----------|-----------|-----------|
+| SUPABASE_URL | URL do projeto Supabase | supabase.com/dashboard |
+| ... | ... | ... |
+
+## Estrutura do Projeto
+
+\`\`\`
+src/
+  app/          # Rotas (Next.js App Router)
+  components/   # Componentes reutilizaveis
+  features/     # Modulos por feature
+  lib/          # Utilitarios e configs
+  types/        # Tipos TypeScript
+\`\`\`
+
+## Scripts
+
+| Script | Descricao |
+|--------|-----------|
+| `pnpm dev` | Servidor de desenvolvimento |
+| `pnpm build` | Build de producao |
+| `pnpm test` | Rodar testes |
+| `pnpm lint` | Verificar codigo |
+
+## API
+
+[Resumo dos endpoints ou link para docs completa]
+
+## Deploy
+
+[Instrucoes de deploy — Docker, Coolify, Vercel, etc.]
+
+## License
+
+MIT
+```
+
+## 2. API Documentation
+
+Se o projeto tem API routes, documentar cada endpoint:
+
+```markdown
+# API Reference
+
+## Auth
+
+### POST /api/auth/login
+**Body:** `{ email: string, password: string }`
+**Response 200:** `{ user: User, token: string }`
+**Response 401:** `{ error: "Invalid credentials" }`
+
+### POST /api/auth/signup
+...
+```
+
+## 3. CHANGELOG.md
+
+```markdown
+# Changelog
+
+## [1.0.0] - {data}
+
+### Added
+- [Feature 1]
+- [Feature 2]
+- Auth com roles (admin, user)
+- Dashboard com metricas
+- Responsive design
+
+### Security
+- Rate limiting em endpoints sensiveis
+- RLS no Supabase
+- Input validation com Zod
+```
+
+</documents>
+
+<process>
+
+## Passo 1: Entender o Projeto
+Ler: PROJECT.md, REQUIREMENTS.md, package.json, CLAUDE.md, estrutura de pastas.
+
+## Passo 2: Mapear Features
+```bash
+# Rotas/paginas
+find app -name "page.tsx" 2>/dev/null | head -20
+# API routes
+find app/api -name "route.ts" 2>/dev/null | head -20
+# Componentes
+find components -name "*.tsx" 2>/dev/null | head -30
+```
+
+## Passo 3: Mapear Env Vars
+```bash
+grep -rn "process\.env\.\|import\.meta\.env\." src/ app/ --include="*.ts" --include="*.tsx" 2>/dev/null | sort -u
+```
+
+## Passo 4: Gerar Documentos
+Criar cada documento com conteudo REAL (nao placeholders).
+
+## Passo 5: Commitar
+```bash
+node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs: adicionar documentacao completa" --files README.md CHANGELOG.md docs/
+```
+
+## Passo 6: Retornar
+```markdown
+## DOCUMENTATION COMPLETE
+
+**Documentos gerados:**
+- README.md ({N} linhas)
+- CHANGELOG.md
+- [API docs se aplicavel]
+
+Arquivo: commitados
+```
+</process>
+
+<success_criteria>
+- [ ] README.md completo (nao generico — conteudo real do projeto)
+- [ ] Setup instructions testadas (comandos reais)
+- [ ] Env vars documentadas com "onde obter"
+- [ ] Estrutura do projeto documentada
+- [ ] API endpoints documentados (se aplicavel)
+- [ ] CHANGELOG.md com features implementadas
+- [ ] Tudo commitado
+</success_criteria>

package/bin/up-tools.cjs

@@ -9,7 +9,7 @@
  *
  * Commands:
  *   init planejar-fase|executar-fase|novo-projeto|rapido|retomar|operacao-fase|progresso|verificar-trabalho|melhorias|ideias|iniciar
- *   state load|get|update|advance-plan|update-progress|add-decision|record-session|record-metric|snapshot
+ *   state load|get|update|advance-plan|update-progress|add-decision|record-session|record-metric|snapshot|save-session
  *   roadmap get-phase|analyze|update-plan-progress
  *   phase add|remove|find|complete|generate-from-report
  *   config get|set
@@ -255,8 +255,19 @@ function main() {
         }, raw);
       } else if (sub === 'snapshot') {
         cmdStateSnapshot(cwd, raw);
+      } else if (sub === 'save-session') {
+        const summaryIdx = args.indexOf('--summary');
+        const decisionIdx = args.indexOf('--decision');
+        const phaseIdx = args.indexOf('--phase');
+        const noCommitIdx = args.indexOf('--no-commit');
+        cmdStateSaveSession(cwd, {
+          summary: summaryIdx !== -1 ? args[summaryIdx + 1] : null,
+          decision: decisionIdx !== -1 ? args[decisionIdx + 1] : null,
+          phase: phaseIdx !== -1 ? args[phaseIdx + 1] : null,
+          no_commit: noCommitIdx !== -1,
+        }, raw);
       } else {
-        error('Unknown state subcommand. Available: load, get, update, advance-plan, update-progress, add-decision, record-session, record-metric, snapshot');
+        error('Unknown state subcommand. Available: load, get, update, advance-plan, update-progress, add-decision, record-session, record-metric, snapshot, save-session');
       }
       break;
     }
@@ -1150,6 +1161,77 @@ function cmdStateSnapshot(cwd, raw) {
   }, raw);
 }
 
+function cmdStateSaveSession(cwd, options, raw) {
+  const statePath = path.join(cwd, '.plano', 'STATE.md');
+  if (!fs.existsSync(statePath)) { output({ error: 'STATE.md not found — project not initialized with UP' }, raw); return; }
+
+  const { summary, decision, phase, no_commit } = options;
+  if (!summary) { output({ error: '--summary required: describe what was done in this session' }, raw); return; }
+
+  let content = fs.readFileSync(statePath, 'utf-8');
+  const now = new Date().toISOString();
+  const actions = [];
+
+  // 1. Update session timestamp (try both PT and EN field names)
+  const sessionFields = ['Ultima sessao', 'Last session', 'Last Date'];
+  for (const field of sessionFields) {
+    let result = stateReplaceField(content, field, now);
+    if (result) { content = result; if (!actions.includes('timestamp')) actions.push('timestamp'); }
+  }
+
+  // 2. Update stopped-at with summary (try both PT and EN)
+  const stoppedFields = ['Parou em', 'Stopped At', 'Stopped at'];
+  for (const field of stoppedFields) {
+    let result = stateReplaceField(content, field, summary);
+    if (result) { content = result; if (!actions.includes('stopped_at')) actions.push('stopped_at'); break; }
+  }
+
+  // 3. Update last activity (try both PT and EN)
+  const shortDate = now.split('T')[0];
+  const shortSummary = summary.length > 80 ? summary.substring(0, 77) + '...' : summary;
+  const activityFields = ['Ultima atividade', 'Last activity'];
+  for (const field of activityFields) {
+    let result = stateReplaceField(content, field, `${shortDate} -- ${shortSummary}`);
+    if (result) { content = result; if (!actions.includes('last_activity')) actions.push('last_activity'); break; }
+  }
+
+  // 4. Add decision if provided
+  if (decision) {
+    const phaseLabel = phase || '?';
+    const entry = `- [Phase ${phaseLabel}]: ${decision}`;
+    const sectionPattern = /(###?\s*(?:Decisoes|Decisions|Decisions Made|Accumulated.*Decisions)\s*\n)([\s\S]*?)(?=\n###?|\n##[^#]|$)/i;
+    const match = content.match(sectionPattern);
+    if (match) {
+      let sectionBody = match[2];
+      sectionBody = sectionBody.replace(/None yet\.?\s*\n?/gi, '').replace(/No decisions yet\.?\s*\n?/gi, '').replace(/Nenhuma ainda\.?\s*\n?/gi, '');
+      sectionBody = sectionBody.trimEnd() + '\n' + entry + '\n';
+      content = content.replace(sectionPattern, (_match, header) => `${header}${sectionBody}`);
+      actions.push('decision');
+    }
+  }
+
+  // 5. Write STATE.md
+  fs.writeFileSync(statePath, content, 'utf-8');
+
+  // 6. Auto-commit unless --no-commit
+  let committed = false;
+  if (!no_commit) {
+    try {
+      execGit(cwd, ['add', statePath]);
+      const diffResult = execGit(cwd, ['diff', '--cached', '--name-only']);
+      const hasChanges = (diffResult.stdout || '').trim();
+      if (hasChanges) {
+        execGit(cwd, ['commit', '-m', `docs(state): ${shortSummary}`]);
+        committed = true;
+      }
+    } catch (e) {
+      // commit failed — not critical, state was still saved to disk
+    }
+  }
+
+  output({ saved: true, actions, committed, summary: shortSummary }, raw, 'true');
+}
+
 // =====================================================================
 // ROADMAP COMMANDS
 // =====================================================================

package/commands/clone-builder.md

@@ -0,0 +1,67 @@
+---
+name: up:clone-builder
+description: Clonar app existente via Playwright — analisa, extrai PRD completo e recria com sua stack usando modo-builder
+argument-hint: "[url] [--exact|--improve|--inspiration]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - WebFetch
+  - WebSearch
+  - AskUserQuestion
+  - mcp__context7__*
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+Clone Builder: acessar um app real via Playwright, analisar TUDO (paginas, features, design, APIs, fluxos, data model) e recriar com sua stack usando o modo-builder.
+
+Pipeline: Crawl → Extract Design → Map Features → Write PRD → Modo Builder (completo)
+
+**5 agentes especializados** analisam o original:
+1. **Clone Crawler** — navega tudo, screenshots, intercepta APIs, extrai forms
+2. **Design Extractor** — extrai cores, fontes, espacamento, componentes, layout
+3. **Feature Mapper** — mapeia modulos, features, roles, data model, fluxos
+4. **PRD Writer** — sintetiza em PRD completo e detalhado
+5. **Clone Verifier** — verifica fidelidade (funcional + visual) no quality gate
+
+O resultado alimenta o modo-builder que SABE que e um clone e:
+- Usa screenshots como referencia visual
+- Segue design system extraido
+- Replica fluxos exatos
+- Verifica fidelidade contra o original
+
+**3 modos:**
+- `--exact` (padrao): reproduzir o mais fiel possivel
+- `--improve`: reproduzir + aplicar blueprints + melhorias UX
+- `--inspiration`: usar como referencia, builder tem liberdade
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/clone-builder.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Argumentos:**
+- URL do app (obrigatorio): https://app.exemplo.com
+- `--exact` | `--improve` | `--inspiration` (default: --exact)
+
+**Perguntas que o comando faz (interativo):**
+1. URL do app ✓ (do argumento)
+2. Credenciais de login (se o app requer auth para ver features)
+3. Stack desejada (ou usa builder-defaults.md)
+4. Credenciais do banco (Supabase URL/key, etc.)
+5. O que quer diferente do original (se --improve ou --inspiration)
+</context>
+
+<process>
+Execute the clone-builder workflow from @~/.claude/up/workflows/clone-builder.md end-to-end.
+
+**CRITICO:** Apos coletar URL e credenciais, ZERO interacao. Tudo autonomo.
+</process>

package/commands/dashboard.md

@@ -0,0 +1,48 @@
+---
+name: up:dashboard
+description: Abrir dashboard visual de monitoramento do builder em tempo real (http://localhost:4040)
+argument-hint: "[porta]"
+allowed-tools:
+  - Bash
+  - Read
+---
+<objective>
+Iniciar o dashboard de monitoramento do UP Builder. Mostra em tempo real no browser:
+- Progresso do build (% e barra visual)
+- Fases (completas, atual, pendentes)
+- Status atual (estagio, fase, passo)
+- Metricas (commits, reports gerados)
+- LOCK.md status (se builder ativo)
+
+Servidor leve em Node.js puro (zero deps). Le `.plano/` e atualiza a cada 3 segundos.
+</objective>
+
+<context>
+$ARGUMENTS
+
+**Porta:** Default 4040. Pode especificar outra: `/up:dashboard 8080`
+
+**Requer:** `.plano/` no diretorio atual (funciona com ou sem builder ativo).
+</context>
+
+<process>
+1. Verificar que `.plano/` existe
+2. Iniciar servidor em background:
+```bash
+node "$HOME/.claude/up/dashboard/server.js" ${PORT:-4040} "$(pwd)/.plano" &
+DASH_PID=$!
+echo "Dashboard rodando em http://localhost:${PORT:-4040} (PID: $DASH_PID)"
+```
+3. Informar ao usuario:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > DASHBOARD
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Dashboard: http://localhost:${PORT:-4040}
+Monitorando: .plano/
+Atualiza a cada 3 segundos.
+
+Para parar: kill $DASH_PID
+```
+</process>

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 800k 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 200k por investigacao. Contexto principal permanece enxuto para interacao com usuario.
 </objective>
 
 <context>

package/commands/mobile-first.md

@@ -0,0 +1,71 @@
+---
+name: up:mobile-first
+description: Tornar sistema responsivo para mobile/tablet sem quebrar desktop — detecta problemas via Playwright e corrige automaticamente
+argument-hint: "[--no-fix] [--page /rota] [porta]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+Mobile First: abrir o sistema no browser em multiplos viewports, detectar o que quebra no mobile/tablet e corrigir automaticamente SEM mexer na experiencia desktop.
+
+Desktop e a referencia sagrada. Cada correcao e verificada: se desktop mudou, reverte.
+
+**Standalone:** Funciona em qualquer projeto, qualquer momento. NAO requer /up:novo-projeto ou .plano/.
+**Builder:** Tambem integrado no modo builder (Estagio 4 — Polish).
+
+**Detecta problemas:** overflow horizontal, texto ilegivel, alvos de toque pequenos, grid/flex quebrado, imagens distorcidas, navegacao que nao cabe, modais que estourem, sidebar fixa, sobreposicao de elementos.
+
+**Corrige com:** classes Tailwind responsivas (sm:/md:/lg:), media queries CSS, componentes novos (hamburger menu, drawer, tabela responsiva), ajustes de layout.
+
+**Output:** `.plano/mobile-review/MOBILE-REPORT.md` com score de responsividade, problemas por pagina, screenshots antes/depois em todos viewports.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/mobile-first.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Flags:**
+- `--no-fix` — Apenas escanear e gerar relatorio, NAO corrigir
+- `--page /rota` — Testar apenas uma pagina especifica (ex: `--page /dashboard`)
+
+**Argumentos opcionais:**
+- Porta: `3000` ou `http://localhost:3000` (default: detecta automaticamente)
+
+**Exemplos:**
+```
+/up:mobile-first                          # Escanear tudo e corrigir
+/up:mobile-first --no-fix                 # Apenas relatorio
+/up:mobile-first --page /dashboard        # Apenas uma pagina
+/up:mobile-first 5173                     # Especificar porta
+/up:mobile-first --page /settings 3000    # Combinar flags
+```
+
+**Cria .plano/mobile-review/ automaticamente** (standalone, sem pre-requisitos).
+</context>
+
+<process>
+Execute the mobile-first workflow from @~/.claude/up/workflows/mobile-first.md end-to-end.
+
+Preserve all workflow gates:
+1. Setup (detectar CSS stack, subir server, descobrir paginas)
+2. Scan (capturar todas paginas em mobile/tablet/desktop, detectar problemas)
+3. Analyze (mapear problema → arquivo → estrategia de fix)
+4. Fix (corrigir cada problema, verificar desktop intacto apos cada um)
+5. Report (MOBILE-REPORT.md com screenshots comparativos)
+6. Cleanup (matar server, fechar browser)
+
+**Flag --no-fix:** Se presente, pular passo 4 (Fix). Apenas escanear e reportar.
+**Flag --page:** Se presente, filtrar para apenas a pagina especificada.
+</process>

package/commands/modo-builder.md

@@ -0,0 +1,178 @@
+---
+name: up:modo-builder
+description: Construir projeto completo de forma autonoma — greenfield (do zero) ou brownfield (feature nova em projeto existente)
+argument-hint: "[--light] [descricao do projeto ou feature]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - WebFetch
+  - WebSearch
+  - AskUserQuestion
+  - mcp__context7__*
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+Modo Builder: construir projeto completo de forma totalmente autonoma.
+
+Detecta automaticamente o modo:
+- **Greenfield** (sem codigo existente): cria projeto do zero
+- **Brownfield** (codigo existente): mapeia codebase, planeja e implementa feature/mudanca
+
+**Dois niveis de execucao:**
+- **Full (padrao):** Pipeline completo com pesquisa, polish, UX review, ideias, delivery
+- **Light (`--light`):** Pipeline enxuto — planeja, constroi, testa. Sem gordura. Ideal para features medias em projetos existentes.
+
+O usuario fornece um briefing, responde perguntas criticas (apenas sobre credenciais/APIs/ambiguidades), e o sistema faz TUDO sozinho.
+
+**Modo Full (padrao):**
+1. Detecta modo → Pesquisa/Mapeia → Estrutura → Planeja → Executa → Verifica → E2E
+2. Polish (melhorias + UX tester + ideias) → DELIVERY.md
+
+**Modo Light (`--light`):**
+1. Detecta modo → Mini-scan → Estrutura inline → Planeja → Executa → Verifica → E2E
+2. Fim. Sem polish, sem delivery, sem pesquisa pesada.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/builder.md
+@~/.claude/up/workflows/builder-e2e.md
+@~/.claude/up/workflows/ux-tester.md
+@~/.claude/up/workflows/mobile-first.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Flags:**
+- `--light` — Modo enxuto. Pula pesquisa, polish, UX tester, ideias, delivery, reassessment, captures. Mantém: planejar, executar, verificar, E2E Playwright.
+
+O restante do argumento e o briefing em texto livre. Pode incluir:
+
+**Greenfield (projeto novo):**
+- O que quer construir
+- Para quem (publico)
+- Stack desejada (ou usa builder-defaults.md)
+- Features principais
+- Credenciais/APIs que ja tem
+
+**Brownfield (projeto existente):**
+- Que feature/mudanca quer implementar
+- Como se integra com o existente
+- Novas APIs/integrações necessarias
+- Restricoes ou areas que nao devem ser tocadas
+
+Se $ARGUMENTS estiver vazio (alem de flags), o workflow pedira o briefing interativamente.
+
+**Deteccao automatica:** Se ha codigo existente no diretorio (package.json, src/, etc.) ou .plano/ existente, o builder entra em modo brownfield automaticamente.
+
+**Defaults:** Lidos de `~/.claude/up/builder-defaults.md` (se existir).
+Em brownfield, convencoes do codebase existente tem prioridade sobre defaults.
+</context>
+
+<process>
+**Parsear flags primeiro:** Extrair `--light` dos $ARGUMENTS se presente. O restante e o briefing.
+
+**Se `--light`:**
+Execute o builder workflow em modo light (ver secao `<light_mode>` no workflow).
+Estagios: 1 (Intake simplificado) → 2 (Mini-scan + estrutura inline) → 3 (Build + E2E) → Fim.
+
+**Se modo full (padrao):**
+Execute the builder workflow from @~/.claude/up/workflows/builder.md end-to-end.
+
+**CRITICO:** A partir do Estagio 2, ZERO interacao com usuario. NAO use AskUserQuestion apos coletar o briefing e respostas criticas. Toda decisao e tomada autonomamente.
+
+**Modo Full — Preserve all workflow gates:**
+- Estagio 1: Intake (detectar modo + briefing + perguntas criticas)
+- Estagio 2: Arquitetura (mapear codebase OU pesquisar ecossistema + up-arquiteto)
+- Estagio 3: Build (loop planejar → executar → verificar → E2E por fase)
+- Estagio 4: Polish (melhorias + quick wins + UX tester + ideias)
+- Estagio 5: Entrega (E2E final + captures + DELIVERY.md + resumo)
+
+Falhas sao contornadas, nunca bloqueiam. O builder SEMPRE entrega algo.
+</process>
+
+<light_mode>
+## Modo Light — Pipeline Enxuto
+
+Quando `--light` esta presente, o builder roda um pipeline minimalista:
+
+### Estagio 1 Light: Intake Rapido
+
+1. Detectar modo (greenfield/brownfield) — mesmo processo
+2. Receber briefing
+3. Perguntas criticas — SIM, mesma logica (so perguntar o essencial)
+4. **NAO carregar builder-defaults.md** — usar stack do codebase (brownfield) ou inferir (greenfield)
+
+### Estagio 2 Light: Estrutura Inline
+
+**Brownfield:**
+- Se `.plano/codebase/` existe e tem < 7 dias: reutilizar
+- Se nao existe: mini-scan inline (sem spawnar 4 agentes mapeadores):
+  ```bash
+  # Mini-scan rapido
+  ls package.json requirements.txt pyproject.toml 2>/dev/null
+  cat package.json 2>/dev/null | head -50
+  ls -d src/ app/ lib/ pages/ components/ 2>/dev/null | head -10
+  find . -name "*.ts" -o -name "*.tsx" | head -30
+  ```
+- **Estruturar inline** (sem spawnar up-arquiteto):
+  - Criar/atualizar PROJECT.md com briefing e contexto minimo
+  - Criar/atualizar REQUIREMENTS.md com requisitos da feature
+  - Criar/atualizar ROADMAP.md com 1-3 fases max
+  - config.json com `builder_mode: true, builder_type: light`
+
+**Greenfield:**
+- **Pular pesquisa** (sem 4 pesquisadores paralelos)
+- Estruturar inline com inferencia inteligente
+- 2-5 fases max
+
+### Estagio 3 Light: Build + E2E
+
+Mesmo loop do full, mas:
+- **Sem LOCK.md** (sessao curta, nao precisa de crash recovery)
+- **Sem reassessment** (poucas fases, nao vale a pena)
+- **Sem captures** (sessao curta)
+- **COM teste E2E Playwright** (se tem UI) — mesmo processo do full
+
+### Sem Estagio 4 (Polish)
+
+Nao roda melhorias, UX tester, nem ideias.
+
+### Sem Estagio 5 (Entrega)
+
+Nao gera DELIVERY.md. Apenas exibe resumo inline:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > BUILDER LIGHT — COMPLETO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Feature:** [resumo]
+**Fases:** [N] completadas
+**Commits:** [N]
+**E2E:** [N] testes, [X] passaram
+**Bugs E2E:** [N] encontrados, [M] corrigidos
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Comparacao de Tokens (estimativa)
+
+| Etapa | Full | Light |
+|-------|------|-------|
+| Pesquisa (4 agentes) | ~80k tokens | 0 |
+| Mapeamento (4 agentes) | ~60k tokens | ~5k (mini-scan) |
+| Arquiteto (agente) | ~40k tokens | ~10k (inline) |
+| Build (por fase) | ~100k tokens | ~100k tokens |
+| E2E (por fase) | ~30k tokens | ~30k tokens |
+| Polish (7+ agentes) | ~150k tokens | 0 |
+| Delivery | ~20k tokens | 0 |
+| **Total (3 fases)** | **~680k** | **~345k** (~50% menos) |
+
+</light_mode>