up-cc 0.16.1 → 2.0.0

package/up/commands/auditar.md

@@ -0,0 +1,66 @@
+---
+name: up:auditar
+description: Use quando o usuario quer auditar o produto pronto. Passe unico UX/performance/modernidade priorizado. Flag --features ativa pesquisa de mercado pra sugerir features novas.
+argument-hint: "[--features]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - WebSearch
+  - WebFetch
+  - AskUserQuestion
+---
+<objective>
+Auditoria priorizada de produto pronto, num passe unico. Funde o que antes eram `/up:melhorias` (auditoria UX/performance/modernidade) e `/up:ideias` (sugestao de features com pesquisa de mercado).
+
+**Default:** `up-auditor` faz um passe unico cobrindo UX + performance + modernidade (substitui os 3 auditores separados). `up-sintetizador` consolida tudo num relatorio priorizado por ICE (Impacto x Confianca x Facilidade) com matriz esforco x impacto e secao de anti-features.
+
+**Com `--features`:** alem da auditoria, ativa `up-pesquisador` em modo mercado (concorrentes/tendencias) pra sugerir features novas. O `up-sintetizador` cruza auditoria + mercado.
+
+**Standalone:** funciona em qualquer projeto, sem `/up` previo nem `.plano/`. Cria `.plano/auditoria/` automaticamente. Detecta stack e dominio pra contextualizar.
+
+**Output:** `.plano/auditoria/RELATORIO.md` com sugestoes priorizadas. Opcionalmente o usuario pode converter sugestoes selecionadas em fases do ROADMAP.md.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/auditar.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Flag:**
+- `--features` — ativa pesquisa de mercado (`up-pesquisador` modo mercado) pra sugerir features novas, alem da auditoria de produto.
+
+**Sem flag:** apenas auditoria UX/performance/modernidade priorizada.
+
+**Se `.plano/auditoria/` ja existe:** pergunta se sobrescreve a auditoria anterior ou cancela.
+
+**Integracao com roadmap:** apos a auditoria, o usuario pode selecionar sugestoes pra converter em fases. Usa o subcomando `phase generate-from-report` do up-tools.cjs.
+</context>
+
+<process>
+Execute the auditar workflow from @~/.claude/up/workflows/auditar.md end-to-end.
+
+Pipeline:
+1. Init + deteccao de stack/dominio. Cria `.plano/auditoria/`.
+2. Spawn `up-auditor` (1x, passe unico: UX + performance + modernidade com mapa de cobertura).
+3. Se `--features`: spawn `up-pesquisador` modo mercado (concorrentes/tendencias) em paralelo.
+4. Spawn `up-sintetizador` pra consolidar tudo num RELATORIO.md priorizado por ICE com anti-features.
+5. Apresentar relatorio. Oferecer conversao de sugestoes em fases do roadmap.
+
+Preserve all workflow gates (init, stack detection, agent spawn, synthesis, report presentation).
+</process>
+
+<success_criteria>
+- [ ] Flag --features parseada
+- [ ] up-auditor rodou num passe unico (UX + perf + modernidade)
+- [ ] Com --features: up-pesquisador modo mercado rodou
+- [ ] up-sintetizador consolidou em RELATORIO.md priorizado (ICE + anti-features)
+- [ ] Relatorio apresentado e conversao em fases oferecida
+</success_criteria>

package/up/commands/build.md

@@ -1,7 +1,7 @@
 ---
 name: up:build
-description: Executar projeto previamente planejado por /up:plan. Requer PLAN-READY.md. Pode rodar em runtime diferente do que planejou.
-argument-hint: ""
+description: Use quando o usuario quer EXECUTAR um projeto ja planejado (existe .plano/PLAN-READY.md). Default GitHub-nativo por fase (worktree, issue, PR, merge). Flag --solo pula a cerimonia (commit atomico na branch atual); --board espelha no Multica; --auto pula o menu de fim de fase.
+argument-hint: "[--solo] [--board] [--auto]"
 allowed-tools:
   - Read
   - Write
@@ -14,86 +14,97 @@ allowed-tools:
   - mcp__plugin_playwright_playwright__*
 ---
 <objective>
-Executar projeto que foi previamente planejado.
+Executar projeto que foi previamente planejado. Requer `.plano/PLAN-READY.md` no diretorio atual.
 
-Requer `.plano/PLAN-READY.md` no diretorio atual.
+Absorve `/up:executar-fase`, `/up:executar-plano` e a parte de EXECUCAO do antigo `/up:modo-builder`. O `/up:build` e o motor unico de execucao: roda o PROJETO INTEIRO (todas as fases), nao so uma fase.
 
-Conduz:
+Conduz, por fase:
 1. Validacao light do plano (artefatos existem, planos OK)
-2. CEO local confirma execucao
-3. Build de todas as fases (com supervisao completa)
-4. Quality Gate global
-5. Delivery Audit
-6. CEO apresenta resultado
+2. Execucao em WAVES PARALELAS (varios `up-executor` por wave; planejador local se precisar replan -> verificador)
+3. **GATE deterministico** via `approvals.log` (sem supervisor LLM; exige evidencia TDD por tipo)
+4. Review consolidado via `up-revisor` (two-stage: spec-compliance cetico + code-quality)
+5. Teste visual antes do merge (fase de UI) + menu de fim de fase
 
-**Caso de uso principal:** executar projeto planejado em outro runtime.
+**Caso de uso principal:** executar projeto planejado, possivelmente em runtime diferente do que planejou.
 Exemplo: planejou em Claude Code (`/up:plan "X"`), agora roda em OpenCode (`/up-build`).
 
-**Re-plan local permitido (max 2):** se durante execucao o supervisor descobrir
-que o plano esta inviavel, o planejador LOCAL refaz a fase. Nao volta pro runtime
-que planejou originalmente.
-
-Diferenca de /up:modo-builder:
-- modo-builder: planeja + executa em sequencia
-- build: SO executa, le PLAN-READY.md
-
-Diferenca de /up:executar-fase:
-- executar-fase: executa UMA fase
-- build: executa o PROJETO INTEIRO ate delivery
+**Re-plan local permitido (max 1 round):** se durante a execucao ficar claro que o plano esta inviavel, o `up-planejador` LOCAL refaz a fase (self-check). Nao volta pro runtime que planejou originalmente. Registrar em `.plano/governance/replans.log`.
 </objective>
 
 <execution_context>
 @~/.claude/up/workflows/build.md
-@~/.claude/up/workflows/governance.md
 @~/.claude/up/workflows/dcrv.md
-@~/.claude/up/workflows/builder-e2e.md
+@~/.claude/up/workflows/governance.md
 </execution_context>
 
 <context>
 $ARGUMENTS
 
-Sem argumentos. O comando le tudo de `.plano/PLAN-READY.md`.
+**Flags:**
+- (sem flag) = **GitHub-nativo, o DEFAULT** (`config.github_native=true`): cada fase abre worktree + branch `up/fase-NN-slug` + issue, executa, sobe o dev server pra teste visual (se houver UI) e oferece o menu de fim de fase.
+- `--solo` - **ESCAPE HATCH**. Forca `github_native=false` so nesta execucao: commit atomico na branch ATUAL, zero worktree/issue/PR/board.
+- `--board` - espelha o progresso das fases no Multica (board opt-in, batched, fail-open).
+- `--auto` - pula o menu de fim de fase (merge automatico). O teste visual ainda roda se `require_visual_test=true`.
+
+O comando le o resto de `.plano/PLAN-READY.md`.
 </context>
 
 <process>
-**GATE 1 — Owner Profile LOCAL:**
+**GATE 1 - Owner Profile LOCAL:**
 Verificar se `~/.claude/up/owner-profile.md` existe NESTE runtime.
-Se nao: rodar `/up:onboard` primeiro.
+Se nao: rodar o subverbo config do `/up` primeiro (workflow onboarding.md).
 
-**GATE 2 — PLAN-READY.md:**
+**GATE 2 - PLAN-READY.md:**
 ```bash
 if [ ! -f .plano/PLAN-READY.md ]; then
   echo "ERRO: Este projeto nao foi planejado."
   echo "Use /up:plan primeiro pra planejar."
-  echo "Ou /up:modo-builder pra planejar e executar de uma vez."
+  echo "Ou /up \"<descricao>\" pra brainstorm + plan + build de uma vez."
   exit 1
 fi
 ```
 
-**GATE 3 — Validacao Light:**
+**GATE 3 - Validacao Light:**
 Spot-check estrutura:
 - Artefatos arquiteturais existem (PROJECT, ROADMAP, REQUIREMENTS, SYSTEM-DESIGN)?
 - Todos planos listados em PLAN-READY.md existem no disco?
 - Frontmatter dos planos e valido?
 
-**Confiar no PLAN-READY.md.** NAO re-rodar planning-supervisor em tudo.
-
+**Confiar no PLAN-READY.md.** NAO re-rodar planning em tudo.
 Se algo falta: alertar e oferecer planejamento local OU abortar.
 
 **Sem model routing:** O runtime decide o modelo.
 
-**Execute the build workflow from @~/.claude/up/workflows/build.md end-to-end.**
+**Parsear flags primeiro:** extrair `--solo`/`--board`/`--auto`. Sem flag = GitHub-nativo (default).
 
-Estagios:
-1. Validacao light + CEO confirma
-2. Build (loop por fase com supervisao + DCRV + E2E + chief-engineer)
-3. Quality Gate global
-4. Delivery Audit
-5. Delivery (CEO apresenta)
+**Modo de orquestracao (resolver antes de comecar):**
+- DEFAULT (sem `--solo`): GitHub-nativo. Por fase: `up-tools.cjs github start-phase` (worktree + branch + issue, fail-open) -> executa as waves -> gate -> teste visual pre-merge (se UI) -> `github finish-phase` (PR -> merge squash -> cleanup) conforme o menu. `--board` adiciona `multica init/sync` (batched). `--auto` pula o menu.
+- `--solo`: executa local, commits atomicos na branch atual. Sem worktree/issue/PR/board.
 
-**Re-plan local permitido (max 2 por projeto):**
-Se execution-supervisor pedir REQUEST_REPLAN, o planejador LOCAL refaz a fase.
-Registrar em `.plano/governance/replans.log`.
+**Execute the build workflow from @~/.claude/up/workflows/build.md end-to-end.**
 
-**A partir do CEO confirmar, ZERO interacao com usuario** (exceto alertas criticos).
+Pipeline por fase:
+1. Validacao light
+2. `github start-phase` (worktree + issue; pulado em `--solo`)
+3. Execucao em WAVES PARALELAS: os planos da mesma wave rodam ao mesmo tempo (varios `up-executor`); waves em sequencia. Re-plan local se algum plano ficar inviavel.
+4. up-verificador emite VERIFICATION.md com evidencia fresca por tipo (TDD-por-tipo: red-green / visual / smoke)
+5. **GATE deterministico** `approvals.log` (governance.md, gate-only; exige `evidence=`)
+6. up-revisor (two-stage: spec-compliance cetico + code-quality) alimenta o gate
+7. **Teste visual pre-merge** (fase de UI e `require_visual_test=true`): sobe o dev server na worktree, "testar primeiro ou pode mergear?", loop de ajuste ate aprovar
+8. **Menu de fim de fase** (GitHub-nativo, fora `--auto`): merge local / abrir PR / deixa a branch / descarta. Em `--solo`, ja committou na branch atual
+9. Reassessment do roadmap antes da proxima fase
+
+**Re-plan local permitido (max 1 round por fase):**
+Se ficar inviavel, o up-planejador LOCAL refaz a fase. Registrar em `.plano/governance/replans.log`.
+
+**A partir do inicio do build, ZERO interacao com usuario** (exceto alertas criticos e o menu de fim de fase).
 </process>
+
+<success_criteria>
+- [ ] PLAN-READY.md validado
+- [ ] Flags parseadas (default = GitHub-nativo; --solo = escape)
+- [ ] Build rodou todas as fases; planos da mesma wave em paralelo
+- [ ] GATE approvals.log respeitado (deterministico, com evidence= por tipo)
+- [ ] Teste visual pre-merge em fase de UI (require_visual_test)
+- [ ] Fechamento por fase: menu (GitHub-nativo) ou commit na branch (--solo)
+</success_criteria>

package/up/commands/depurar.md

@@ -101,7 +101,7 @@ Agent(
 - Exibir causa raiz e resumo de evidencias
 - Oferecer opcoes:
   - "Corrigir agora" - spawnar subagente de correcao
-  - "Planejar correcao" - sugerir /up:planejar-fase
+  - "Planejar correcao" - sugerir /up:plan (modo fase)
   - "Correcao manual" - encerrar
 
 **Se `## CHECKPOINT REACHED`:**

package/up/commands/plan.md

@@ -1,7 +1,7 @@
 ---
 name: up:plan
-description: Planejamento completo de projeto. Gera PLAN-READY.md pronto pra ser executado por /up:build (mesmo runtime ou outro)
-argument-hint: "[descricao do projeto] [--execution-runtime=runtime] [--no-audit]"
+description: Use quando o usuario quer PLANEJAR antes de executar: gera .plano/PLAN-READY.md sem tocar em codigo, pronto pra /up:build rodar (mesmo runtime ou outro). Detecta automaticamente projeto vs fase.
+argument-hint: "[descricao | numero da fase] [--execution-runtime=runtime] [--no-audit] [--gaps]"
 allowed-tools:
   - Read
   - Write
@@ -16,33 +16,26 @@ allowed-tools:
   - mcp__context7__*
 ---
 <objective>
-Planejar projeto completo. NAO executa nada, so planeja.
+Planejar projeto OU fase. NAO executa nada, so planeja. Gera `.plano/PLAN-READY.md` executavel por `/up:build` (mesmo runtime ou outro).
 
-Conduz:
-1. Intake (CEO entrevista o dono)
-2. Arquitetura completa (Product Analyst → System Designer → Arquiteto)
-3. Planejamento exaustivo de TODAS as fases (Sonnet-ready)
-4. Planning Audit (calcula confidence score)
-5. Gera PLAN-READY.md (arquivo-flag pra /up:build)
-
-Resultado: projeto pronto pra execucao em qualquer runtime via `/up:build`.
+Absorve `/up:discutir-fase`, `/up:planejar-fase` e `/up:adicionar-fase`. **Deteccao automatica projeto vs fase:**
+- Argumento e numero de fase (ou vazio com projeto ja inicializado) -> planeja UMA fase (research inline + self-check), absorvendo discutir-fase (coleta de contexto -> CONTEXT.md) e planejar-fase.
+- Argumento e descricao de projeto novo (sem `.plano/`) -> planeja o PROJETO INTEIRO (arquitetura + todas as fases).
+- Descricao de fase que nao existe no roadmap -> oferece criar a fase e ja planeja (absorve adicionar-fase).
 
-**Caso de uso principal:** planejar em Claude Code (modelo capaz pra arquitetura)
-e executar em OpenCode/Gemini (mais barato pra rodar volume).
-
-Diferenca de /up:modo-builder:
-- modo-builder: planeja + executa em sequencia, mesmo runtime
-- plan: SO planeja, para apos PLAN-READY.md
+Conduz (projeto):
+1. Intake (inline no orquestrador, sem CEO) — entrada = BRIEFING.md do brainstorm de `/up`
+2. Arquitetura completa (`up-pesquisador` -> `up-arquiteto` que absorveu o system-designer -> `up-sintetizador` valida requisitos)
+3. Planejamento exaustivo de TODAS as fases (Sonnet-ready)
+4. GATE + `up-revisor` (Confidence Score de planejamento)
+5. Gera PLAN-READY.md (arquivo-flag pra `/up:build`)
 
-Diferenca de /up:planejar-fase:
-- planejar-fase: planeja UMA fase (em projeto ja inicializado)
-- plan: planeja TODO o projeto do zero (incluindo intake e arquitetura)
+**Caso de uso principal:** planejar em Claude Code (modelo capaz pra arquitetura) e executar em OpenCode/Gemini (mais barato pra rodar volume).
 </objective>
 
 <execution_context>
 @~/.claude/up/workflows/plan.md
 @~/.claude/up/workflows/onboarding.md
-@~/.claude/up/workflows/ceo-intake.md
 @~/.claude/up/templates/plan-ready.md
 @~/.claude/up/templates/audit-plan.md
 </execution_context>
@@ -52,40 +45,61 @@ $ARGUMENTS
 
 **Flags:**
 - `--execution-runtime=<runtime>` — Informa qual runtime sera usado pra executar.
-  Valores: same | claude-code | opencode | gemini-cli | any
-  Default: same
-- `--no-audit` — Pula Planning Audit (nao recomendado em producao)
+  Valores: same | claude-code | opencode | gemini-cli | any. Default: same.
+- `--no-audit` — Pula o review de planejamento (nao recomendado em producao).
+- `--gaps` — Modo fechamento de gaps de uma fase (le VERIFICATION.md, pula research). Absorve `planejar-fase --gaps`.
 
-O restante e o briefing em texto livre.
+O restante e o briefing/descricao em texto livre, ou um numero de fase.
 
-Se briefing vazio: CEO pergunta interativamente.
+**Entrada preferida:** BRIEFING.md aprovado pelo brainstorm de `/up`. Se ausente e o briefing vier vazio, o orquestrador pergunta interativamente (intake inline, sem CEO).
 
 **Deteccao automatica de modo:**
-- Codigo existente → BROWNFIELD
-- Sem codigo → GREENFIELD
+- Argumento numerico (ou fase ja existente) -> PLANEJAR FASE.
+- Descricao + codigo existente -> BROWNFIELD (projeto).
+- Descricao + sem codigo -> GREENFIELD (projeto).
+- Descricao de fase inexistente -> criar fase + planejar (ex-adicionar-fase).
 </context>
 
 <process>
 **GATE OBRIGATORIO — Owner Profile:**
 Antes de qualquer coisa, verificar se `~/.claude/up/owner-profile.md` existe.
-Se NAO existir: rodar `/up:onboard` primeiro (workflow onboarding.md).
-Sem profile, o CEO nao pode conduzir intake.
+Se NAO existir: rodar onboarding primeiro (workflow onboarding.md). Sem profile, o intake fica generico.
 
 **Sem model routing:** O runtime decide o modelo. NAO especificar `model=` em nenhum spawn.
 
 **Sonnet-ready obrigatorio:** Todos planos devem ser gerados em nivel maximo de detalhe.
 
+**Passo 0 — Detectar projeto vs fase:**
+- Argumento e numero/decimal/sufixo-letra de fase -> rota FASE.
+- `.plano/` existe e argumento vazio -> rota FASE (proxima nao planejada).
+- Argumento e descricao e nao ha `.plano/` -> rota PROJETO.
+- Descricao casa com fase inexistente -> oferecer criar a fase, depois rota FASE.
+
 **Execute the plan workflow from @~/.claude/up/workflows/plan.md end-to-end.**
 
-Estagios:
-1. Intake (CEO entrevista o dono) — interativo
-2. Arquitetura (greenfield: pesquisa + product/system/architect | brownfield: mapear + product/system/architect)
-3. Planejamento exaustivo (TODAS as fases, planning-supervisor revisa cada uma)
-4. Planning Audit (planning-auditor calcula confidence score)
+Estagios (PROJETO):
+1. Intake inline (orquestrador le BRIEFING.md OU pergunta) — interativo
+2. Arquitetura: greenfield (up-pesquisador -> up-arquiteto -> up-sintetizador valida reqs) | brownfield (mapear -> up-arquiteto -> up-sintetizador)
+3. Planejamento exaustivo (TODAS as fases, self-check do planejador)
+4. GATE + up-revisor (Confidence Score de planejamento; salvo no template audit-plan.md)
 5. PLAN-READY.md gerado
-6. CEO apresenta resumo
+6. Orquestrador apresenta o resumo direto (sem CEO)
+
+Estagios (FASE):
+1. Coleta de contexto inline (ex-discutir-fase) -> CONTEXT.md
+2. Research inline (a menos que `--gaps` ou `--sem-pesquisa`)
+3. Planos PLAN-NNN.md + self-check (ex-planejar-fase)
 
-**A partir do estagio 2, ZERO interacao com usuario.** Toda decisao e tomada autonomamente pelo CEO/chiefs/supervisores.
+**A partir do estagio 2 do projeto, ZERO interacao com usuario.** Toda decisao e tomada autonomamente pelo orquestrador.
 
-**NAO executar nada.** Para apos gerar PLAN-READY.md.
+**NAO executar nada.** Para apos gerar PLAN-READY.md (projeto) ou os PLAN-NNN.md (fase).
 </process>
+
+<success_criteria>
+- [ ] Owner profile garantido
+- [ ] Projeto vs fase detectado automaticamente
+- [ ] Sem ceo-intake: intake inline no orquestrador
+- [ ] PROJETO: pesquisa + arquiteto (absorve system-designer) + sintetizador valida reqs + revisor
+- [ ] FASE: contexto (ex-discutir) + research inline + planos + self-check
+- [ ] PLAN-READY.md (projeto) ou PLAN-NNN.md (fase) gerados, nada executado
+</success_criteria>

package/up/commands/rapido.md

@@ -1,6 +1,6 @@
 ---
 name: up:rapido
-description: Tarefa rapida com garantias UP (commits atomicos, rastreamento)
+description: Use quando o usuario quer uma tarefa pontual rapida, sem roadmap nem cerimonia GitHub: commit atomico na branch atual com rastreamento em STATE.md. O escape hatch nomeado pra pular o /up:build.
 argument-hint: "[descricao]"
 allowed-tools:
   - Read
@@ -13,14 +13,18 @@ allowed-tools:
   - AskUserQuestion
 ---
 <objective>
-Execute small, ad-hoc tasks with UP guarantees (atomic commits, STATE.md tracking).
+Executar tarefas pontuais com as garantias minimas do UP, pulando o roadmap inteiro.
 
-Quick mode is the same system with a shorter path:
-- Plans and executes in a streamlined flow
-- Quick tasks live in `.plano/rapido/` separate from planned phases
-- Updates STATE.md "Tarefas Rapidas" table (NOT ROADMAP.md)
+**O escape hatch nomeado.** E o caminho mais curto do sistema: commit atomico na branch ATUAL, rastreamento em STATE.md, e nada mais. **Sem worktree, sem issue, sem PR, sem Multica, sem roadmap, sem rede.** Cobre a maior parte do trabalho do dia a dia (fix, config, glue, ajuste).
 
-**Default:** Skips research, discussion, plan-checker, verifier. Use when you know exactly what to do.
+O mesmo sistema do UP num caminho enxuto:
+- Planeja e executa num fluxo direto.
+- Tarefas rapidas vivem em `.plano/rapido/`, separadas das fases planejadas.
+- Atualiza a tabela "Tarefas Rapidas" do STATE.md (NAO o ROADMAP.md).
+
+**Default:** pula pesquisa, discussao, plan-checker e verificador pesado. Use quando voce sabe exatamente o que fazer.
+
+Diferenca de `/up:build`: o build executa um projeto planejado (PLAN-READY.md) com gate e revisor, e expoe as flags GitHub-nativas (`--pr`/`--board`/`--auto`). O `/up:rapido` ignora tudo isso de proposito. Se quiser cerimonia GitHub, use `/up:build`.
 </objective>
 
 <execution_context>
@@ -31,10 +35,12 @@ Quick mode is the same system with a shorter path:
 <context>
 $ARGUMENTS
 
-Quick tasks get UP guarantees without full phase ceremony.
+A descricao da tarefa em texto livre. As garantias UP minimas (commit atomico + rastreamento) sem a cerimonia de fase.
 </context>
 
 <process>
 Execute the rapido workflow from @~/.claude/up/workflows/rapido.md end-to-end.
-Preserve all workflow gates (validation, task description, planning, execution, state updates, commits).
+Preserve todos os gates do workflow (validacao, descricao da tarefa, planejamento, execucao, atualizacao de estado, commits atomicos).
+
+**Sempre na branch atual.** Nunca cria worktree, nunca abre PR, nunca toca no ROADMAP. Esse e o ponto do comando.
 </process>