up-cc 0.16.0 → 2.0.0

package/up/workflows/planejar-fase.md

@@ -1,293 +0,0 @@
-<purpose>
-Criar prompts executaveis (PLAN.md) para uma fase do roteiro. Fluxo simplificado: um unico up-planejador faz pesquisa inline (se necessario), cria planos e auto-verifica. Sem loop planner-checker separado.
-
-Flags: --pesquisar (pesquisa profunda), --sem-pesquisa (pular), --auto (encadear executar+verificar), --gaps (replanejar a partir de lacunas).
-</purpose>
-
-<process>
-
-## 1. Inicializar
-
-```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init planejar-fase "$PHASE")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Parse JSON: `commit_docs`, `phase_found`, `phase_dir`, `phase_number`, `phase_name`, `phase_slug`, `padded_phase`, `has_research`, `has_context`, `has_plans`, `plan_count`, `planning_exists`, `roadmap_exists`, `phase_req_ids`.
-
-**Caminhos de arquivo:** `state_path`, `roadmap_path`, `requirements_path`, `context_path`, `research_path`, `verification_path`.
-
-**Se `planning_exists` = false:** Erro -- executar `/up:novo-projeto` primeiro.
-
-## 2. Parsear Argumentos
-
-Extrair do $ARGUMENTS: fase (numero OU descricao), flags (`--pesquisar`, `--sem-pesquisa`, `--gaps`, `--auto`).
-
-**Deteccao numero vs descricao:**
-- Se o argumento (sem flags) e um numero inteiro (ex: "3", "12"): tratar como numero de fase
-- Se o argumento contem letras (ex: "sistema de auth", "Adicionar pagamentos"): tratar como descricao de fase nova
-- Se vazio: detectar proxima fase nao planejada do roteiro
-
-**Se sem numero/descricao:** Detectar proxima fase nao planejada do roteiro.
-
-**Se `phase_found` = false E argumento e numero:** Validar fase existe no ROADMAP.md. Se valida, criar diretorio:
-```bash
-mkdir -p ".plano/fases/${padded_phase}-${phase_slug}"
-```
-
-**Se argumento e descricao:** Prosseguir para passo 3 (que tratara a criacao se necessario).
-
-## 3. Validar Fase
-
-```bash
-PHASE_INFO=$(node "$HOME/.claude/up/bin/up-tools.cjs" roadmap get-phase "${PHASE}")
-```
-
-**Se `found` = true:** Extrair `phase_number`, `phase_name`, `goal`. Prosseguir para passo 4.
-
-**Se `found` = false:** A fase nao existe no ROADMAP. Duas situacoes:
-
-**3a. O argumento e um NUMERO (ex: `/up:planejar-fase 5`):**
-
-Erro --- fase numerica que nao existe no roadmap indica engano do usuario.
-
-```
-ERRO: Fase {N} nao existe no roadmap.
-Fases disponiveis: [listar]
-Para adicionar fase nova: /up:planejar-fase "descricao da fase"
-```
-
-**3b. O argumento e uma DESCRICAO (ex: `/up:planejar-fase "sistema de notificacoes"`):**
-
-Perguntar se quer adicionar ao roadmap:
-
-```
-AskUserQuestion(
-  header: "Fase nao existe no roadmap",
-  question: "A fase \"{descricao}\" nao existe no roadmap. Quer adicionar e ja planejar?",
-  options: [
-    { label: "Sim, adicionar e planejar", description: "Cria a fase no ROADMAP.md e ja gera os planos" },
-    { label: "Nao", description: "Cancelar" }
-  ]
-)
-```
-
-Se "Sim": criar a fase via up-tools e continuar:
-
-```bash
-RESULT=$(node "$HOME/.claude/up/bin/up-tools.cjs" phase add "${descricao}")
-```
-
-Extrair `phase_number`, `phase_name`, `slug`, `directory` do resultado.
-Atualizar STATE.md (mesma logica do antigo adicionar-fase):
-
-```
-Em "## Contexto Acumulado" → "### Evolucao do Roadmap" adicionar:
-- Fase {N} adicionada: {descricao}
-```
-
-Re-rodar init para obter paths corretos:
-
-```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init planejar-fase "${phase_number}")
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Prosseguir para passo 4 com a fase recem-criada.
-
-Se "Nao": sair.
-
-## 4. Carregar CONTEXT.md
-
-Verificar `context_path` do init JSON.
-
-Se `context_path` nao e null, exibir: `Usando contexto da fase: ${context_path}`
-
-**Se `context_path` e null (sem CONTEXT.md):**
-
-Use AskUserQuestion:
-- header: "Sem contexto"
-- question: "Sem CONTEXT.md para Fase {X}. Planos usarao pesquisa e requisitos apenas. Continuar ou capturar contexto primeiro?"
-- options:
-  - "Continuar sem contexto" -- Planejar usando pesquisa + requisitos apenas
-  - "Executar discutir-fase primeiro" -- Capturar decisoes de design antes de planejar
-
-Se "Continuar sem contexto": Prosseguir para passo 5.
-Se "Executar discutir-fase primeiro": Exibir `/up:discutir-fase {X}` e sair.
-
-## 5. Tratar Pesquisa
-
-**Pular se:** flag `--gaps`, flag `--sem-pesquisa`.
-
-**Se `has_research` = true (do init) E sem flag `--pesquisar`:** Usar existente, pular para passo 6.
-
-**Se RESEARCH.md faltando OU flag `--pesquisar`:**
-
-O up-planejador fara a pesquisa inline como parte do planejamento. Definir `RESEARCH_INLINE=true`.
-
-## 6. Verificar Planos Existentes
-
-```bash
-ls "${PHASE_DIR}"/*-PLAN.md 2>/dev/null
-```
-
-**Se existem:** Oferecer: 1) Adicionar mais planos, 2) Ver existentes, 3) Replanejar do zero.
-
-## 7. Spawn up-planejador
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- UP > PLANEJANDO FASE {X}
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Spawning planejador...
-```
-
-```
-Task(
-  prompt="
-<planning_context>
-**Fase:** {phase_number}
-**Modo:** {standard | gap_closure}
-**Pesquisa inline:** {RESEARCH_INLINE}
-
-<files_to_read>
-TIER 1 — Sempre obrigatorio:
-- {state_path} (Estado do Projeto, ~2k tokens)
-- .plano/fases/{phase_number}/PHASE.md (slice do ROADMAP da fase atual, ~500 tokens — v0.7.0+)
-- .plano/fases/{phase_number}/REQUIREMENTS-SLICE.md (REQs APENAS desta fase, ~1.5k tokens — v0.7.0+)
-
-TIER 2 — Condicional:
-- {context_path} (DECISOES DO USUARIO de /up:discutir-fase, se existir)
-- {research_path} (Pesquisa Tecnica, se existir)
-- {verification_path} (Lacunas de Verificacao, se --gaps)
-- .plano/codebase/CONVENTIONS.md (BROWNFIELD apenas)
-- .plano/codebase/CONCERNS.md (BROWNFIELD apenas)
-- .plano/codebase/ARCHITECTURE.md (BROWNFIELD apenas)
-
-TIER 3 — Sob demanda (NAO carregue por padrao):
-- {roadmap_path} (ROADMAP completo) — so se precisar entender fases adjacentes
-- {requirements_path} (REQUIREMENTS completo) — so se a slice nao tiver info suficiente
-- {project_path} (PROJECT.md) — so se precisar visao geral
-
-**FALLBACK:** Se as slices `.plano/fases/{phase_number}/` nao existem (projeto pre-v0.7.0), carregue {roadmap_path} e {requirements_path} completos como antes.
-</files_to_read>
-
-**Engineering Principles (compressed) — sempre injetado:**
-1. Implementacao real, nao simulacao (zero placeholder)
-2. Correto, nao rapido (sem `any`, validacao com lib)
-3. Conectado ponta a ponta (componente → API → DB funcionando)
-4. Consistencia sobre criatividade (grep antes de inventar)
-5. Dados reais desde o primeiro momento (sem hardcode)
-6. Cada decisao tem custo futuro (escolher solucao escalavel)
-
-**IDs de requisitos da fase (cada ID DEVE aparecer no campo `requirements` de um plano):** {phase_req_ids}
-
-**Instrucoes do projeto:** Ler ./CLAUDE.md se existir
-
-Se RESEARCH_INLINE=true:
-- Pesquisar o dominio antes de planejar
-- Usar Context7/docs oficiais para verificar versoes e APIs
-- Documentar achados de pesquisa no inicio de cada PLAN.md
-
-**Se arquivos de codebase existem (brownfield):**
-- Respeitar padroes e convencoes de CONVENTIONS.md nos planos
-- Considerar divida tecnica de CONCERNS.md ao definir tarefas
-- Alinhar planos com arquitetura existente de ARCHITECTURE.md
-- NAO recriar infraestrutura que ja existe
-</planning_context>
-
-<self_check>
-Apos criar os planos, auto-verificar:
-- [ ] Cada requisito da fase mapeado a um plano
-- [ ] Frontmatter valido (wave, depends_on, files_modified, autonomous)
-- [ ] Tarefas sao especificas e acionaveis
-- [ ] Dependencias corretamente identificadas
-- [ ] Waves atribuidas para execucao paralela
-- [ ] must_haves derivados do objetivo da fase
-Se algo falhar na verificacao, corrija antes de retornar.
-</self_check>
-
-<output>
-Escrever PLAN.md em: {phase_dir}/
-Retornar: ## PLANNING COMPLETE com resumo dos planos
-</output>
-",
-  subagent_type="up-planejador",
-  description="Planejar Fase {phase}"
-)
-```
-
-## 8. Tratar Retorno do Planejador
-
-- **`## PLANNING COMPLETE`:** Exibir contagem de planos. Prosseguir para passo 9.
-- **`## CHECKPOINT REACHED`:** Apresentar ao usuario, obter resposta, spawn continuacao.
-- **`## PLANNING INCONCLUSIVE`:** Mostrar tentativas, oferecer: Adicionar contexto / Tentar novamente / Manual.
-
-## 9. Apresentar Status Final
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- UP > FASE {X} PLANEJADA
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-**Fase {X}: {Nome}** -- {N} plano(s) em {M} wave(s)
-
-| Wave | Planos | O que constroi |
-|------|--------|----------------|
-| 1    | 01, 02 | [objetivos] |
-| 2    | 03     | [objetivo]  |
-
-Pesquisa: {Completa | Usou existente | Pulada | Inline}
-
-───────────────────────────────────────────────────────────────
-
-## Proximo
-
-**Executar Fase {X}** -- rodar todos {N} planos
-
-/up:executar-fase {X}
-
-<sub>/clear primeiro -> janela de contexto limpa</sub>
-
-───────────────────────────────────────────────────────────────
-
-**Tambem disponivel:**
-- cat .plano/fases/{fase-dir}/*-PLAN.md -- revisar planos
-- /up:planejar-fase {X} --pesquisar -- re-pesquisar primeiro
-
-───────────────────────────────────────────────────────────────
-```
-
-## 10. Auto-Advance (se --auto)
-
-**Se flag `--auto` presente:**
-
-```
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
- UP > AUTO-AVANCANDO PARA EXECUTAR
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-
-Planos prontos. Lancando executar-fase...
-```
-
-Lancar executar-fase:
-```
-Skill(skill="up:executar-fase", args="${PHASE}")
-```
-
-</process>
-
-<success_criteria>
-- [ ] .plano/ diretorio validado
-- [ ] Fase validada contra roteiro
-- [ ] Diretorio da fase criado se necessario
-- [ ] CONTEXT.md carregado e passado ao planejador
-- [ ] Pesquisa tratada (inline, existente ou pulada)
-- [ ] Planos existentes verificados
-- [ ] up-planejador spawned com contexto completo
-- [ ] Planejador auto-verificou os planos
-- [ ] Planos criados (PLANNING COMPLETE ou CHECKPOINT tratado)
-- [ ] Usuario ve status entre spawns de agentes
-- [ ] Usuario sabe proximos passos
-</success_criteria>

package/up/workflows/progresso.md

@@ -1,226 +0,0 @@
-<purpose>
-Verificar progresso do projeto, resumir trabalho recente e o que vem a seguir, entao rotear inteligentemente para a proxima acao -- seja executar um plano existente ou criar o proximo.
-</purpose>
-
-<process>
-
-<step name="init_context">
-**Carregar contexto de progresso:**
-
-```bash
-INIT=$(node "$HOME/.claude/up/bin/up-tools.cjs" init progresso)
-if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi
-```
-
-Extrair do init JSON: `project_exists`, `roadmap_exists`, `state_exists`, `phases`, `current_phase`, `next_phase`, `completed_count`, `phase_count`, `paused_at`, `state_path`, `roadmap_path`, `project_path`, `config_path`.
-
-Se `project_exists` = false (sem diretorio `.plano/`):
-
-```
-Sem estrutura de planejamento encontrada.
-
-Execute /up:novo-projeto para iniciar um novo projeto.
-```
-
-Sair.
-
-Se STATE.md faltando: sugerir `/up:novo-projeto`.
-Se ROADMAP.md faltando mas PROJECT.md existe: sugerir `/up:novo-projeto`.
-</step>
-
-<step name="load">
-**Usar extracao estruturada:**
-
-```bash
-ROADMAP=$(node "$HOME/.claude/up/bin/up-tools.cjs" roadmap analyze)
-STATE=$(node "$HOME/.claude/up/bin/up-tools.cjs" state-snapshot)
-```
-</step>
-
-<step name="recent">
-**Reunir contexto de trabalho recente:**
-
-Encontrar os 2-3 SUMMARY.md mais recentes:
-```bash
-node "$HOME/.claude/up/bin/up-tools.cjs" summary-extract <caminho> --fields one_liner
-```
-</step>
-
-<step name="report">
-**Gerar barra de progresso e apresentar relatorio:**
-
-```bash
-PROGRESS_BAR=$(node "$HOME/.claude/up/bin/up-tools.cjs" progress bar --raw)
-```
-
-```
-# [Nome do Projeto]
-
-**Progresso:** {PROGRESS_BAR}
-
-## Trabalho Recente
-- [Fase X, Plano Y]: [o que foi realizado - 1 linha]
-- [Fase X, Plano Z]: [o que foi realizado - 1 linha]
-
-## Posicao Atual
-Fase [N] de [total]: [nome-da-fase]
-Plano [M] de [total-fase]: [status]
-CONTEXTO: [ok se has_context | - se nao]
-
-## Decisoes-Chave Tomadas
-- [extrair de $STATE.decisions[]]
-
-## Bloqueios/Preocupacoes
-- [extrair de $STATE.blockers[]]
-
-## Proximo
-[Proximo objetivo fase/plano do roadmap analyze]
-```
-</step>
-
-<step name="route">
-**Determinar proxima acao baseada em contagens verificadas.**
-
-**Passo 1: Contar planos e summaries na fase atual**
-
-```bash
-ls -1 .plano/fases/[dir-fase-atual]/*-PLAN.md 2>/dev/null | wc -l
-ls -1 .plano/fases/[dir-fase-atual]/*-SUMMARY.md 2>/dev/null | wc -l
-```
-
-**Passo 2: Rotear baseado em contagens**
-
-| Condicao | Significado | Acao |
-|----------|-------------|------|
-| summaries < plans | Planos nao executados existem | Ir para **Rota A** |
-| summaries = plans E plans > 0 | Fase completa | Ir para Passo 3 |
-| plans = 0 | Fase ainda nao planejada | Ir para **Rota B** |
-
----
-
-**Rota A: Plano nao executado existe**
-
-Encontrar primeiro PLAN.md sem SUMMARY.md correspondente.
-
-```
----
-
-## Proximo
-
-**{fase}-{plano}: [Nome do Plano]** -- [resumo do objetivo]
-
-`/up:executar-fase {fase}`
-
-<sub>`/clear` primeiro -> janela de contexto limpa</sub>
-
----
-```
-
----
-
-**Rota B: Fase precisa planejamento**
-
-Verificar se `{fase_num}-CONTEXT.md` existe no diretorio da fase.
-
-**Se CONTEXT.md existe:**
-
-```
----
-
-## Proximo
-
-**Fase {N}: {Nome}** -- {Objetivo do ROADMAP.md}
-<sub>Contexto reunido, pronto para planejar</sub>
-
-`/up:planejar-fase {numero-fase}`
-
-<sub>`/clear` primeiro -> janela de contexto limpa</sub>
-
----
-```
-
-**Se CONTEXT.md NAO existe:**
-
-```
----
-
-## Proximo
-
-**Fase {N}: {Nome}** -- {Objetivo do ROADMAP.md}
-
-`/up:discutir-fase {fase}` -- reunir contexto e esclarecer abordagem
-
-<sub>`/clear` primeiro -> janela de contexto limpa</sub>
-
----
-
-**Tambem disponivel:**
-- `/up:planejar-fase {fase}` -- pular discussao, planejar diretamente
-
----
-```
-
----
-
-**Passo 3: Verificar status do projeto (apenas quando fase completa)**
-
-| Condicao | Significado | Acao |
-|----------|-------------|------|
-| fase atual < maior fase | Mais fases restam | **Rota C** |
-| fase atual = maior fase | Projeto completo | **Rota D** |
-
----
-
-**Rota C: Fase completa, mais fases restam**
-
-```
----
-
-## Fase {Z} Completa
-
-## Proximo
-
-**Fase {Z+1}: {Nome}** -- {Objetivo do ROADMAP.md}
-
-`/up:discutir-fase {Z+1}` -- reunir contexto e esclarecer abordagem
-
-<sub>`/clear` primeiro -> janela de contexto limpa</sub>
-
----
-
-**Tambem disponivel:**
-- `/up:planejar-fase {Z+1}` -- pular discussao, planejar diretamente
-- `/up:verificar-trabalho {Z}` -- teste de aceitacao antes de continuar
-
----
-```
-
----
-
-**Rota D: Projeto completo**
-
-```
----
-
-## Projeto Completo!
-
-Todas {N} fases finalizadas!
-
----
-
-**Tambem disponivel:**
-- `/up:verificar-trabalho` -- teste de aceitacao antes de encerrar
-
----
-```
-</step>
-
-</process>
-
-<success_criteria>
-- [ ] Contexto rico fornecido (trabalho recente, decisoes, problemas)
-- [ ] Posicao atual clara com progresso visual
-- [ ] Proximo passo claramente explicado
-- [ ] Roteamento inteligente: /up:executar-fase se planos existem, /up:planejar-fase se nao
-- [ ] Handoff seamless para comando up apropriado
-</success_criteria>