up-cc 0.5.1 → 0.6.0

package/templates/audit-plan.md

@@ -0,0 +1,139 @@
+# AUDIT-PLAN.md Template
+
+Template para `.plano/AUDIT-PLAN.md` — relatorio do up-planning-auditor.
+Gerado ao final do planejamento, antes do PLAN-READY.md.
+
+Diferente do AUDIT-REPORT.md (do delivery-auditor) que audita execucao,
+este audita SOMENTE o planejamento.
+
+<template>
+
+```markdown
+---
+audited_at: ""
+auditor: up-planning-auditor
+planning_confidence: 0  # 0-100
+recommendation: PENDING | READY_FOR_BUILD | NEEDS_REWORK | BLOCKED
+---
+
+# Planning Audit Report
+
+**Planning Confidence Score:** {N}/100
+
+**Recomendacao:** {status}
+
+---
+
+## Completude por Estagio
+
+| Estagio | Items | Completed | Missing | Score |
+|---------|-------|-----------|---------|-------|
+| Intake (E1) | 5 | {N} | {N} | {%} |
+| Arquitetura (E2) | 7 | {N} | {N} | {%} |
+| Planejamento (E2.5) | {6 × phases} | {N} | {N} | {%} |
+| **TOTAL** | **{N}** | **{N}** | **{N}** | **{%}** |
+
+---
+
+## Validacao de Completude
+
+### Artefatos Arquiteturais
+
+- [ ] BRIEFING.md existe
+- [ ] OWNER.md existe
+- [ ] PROJECT.md existe e completo
+- [ ] ROADMAP.md existe e tem fases
+- [ ] REQUIREMENTS.md existe
+- [ ] SYSTEM-DESIGN.md existe e completo
+- [ ] DESIGN-TOKENS.md existe (se projeto com UI)
+- [ ] PENDING.md existe (mesmo se vazio)
+
+### Planos por Fase
+
+Para cada fase em ROADMAP.md:
+- [ ] Existe pasta `.plano/fases/XX-nome/`
+- [ ] Existe pelo menos 1 PLAN.md
+- [ ] Cada PLAN.md tem frontmatter valido
+- [ ] Cada PLAN.md tem 5-8 tarefas
+- [ ] Cada PLAN.md tem must_haves
+- [ ] Cada PLAN.md passou no planning-supervisor (PLAN-REVIEW.md existe)
+
+### Cobertura de Requisitos
+
+| REQ-ID | Mapeado a fase? | Coberto por plano? | Status |
+|--------|----------------|-------------------|--------|
+| AUTH-01 | Sim (Fase 1) | Sim (01-01-PLAN) | OK |
+| ... | | | |
+
+**Cobertura:** {covered}/{total} ({%})
+
+### Sonnet-readiness
+
+Para cada PLAN.md, checar nivel de detalhe:
+
+| Plan | Imports | Tipos | Endpoints | SQL | Score |
+|------|---------|-------|-----------|-----|-------|
+| 01-01-PLAN.md | ✓ | ✓ | ✓ | N/A | 100% |
+| 01-02-PLAN.md | ✓ | ✓ | ✓ | ✓ | 100% |
+
+**Score medio Sonnet-ready:** {%}
+
+### Dependency Graph
+
+- [ ] Todas dependencias entre planos resolvidas
+- [ ] Sem ciclos detectados
+- [ ] Waves atribuidas (0, 1, 2, 3)
+- [ ] Paralelismo maximizado onde possivel
+
+---
+
+## Aprovacoes Faltantes
+
+| Item | Esperado | Atual |
+|------|----------|-------|
+| [item] | [supervisor] APPROVE | pending/missing |
+
+---
+
+## Inconsistencias Detectadas
+
+### INC-001: [Titulo]
+**Tipo:** [conflito | gap | duplicacao]
+**Descricao:** [...]
+**Acao sugerida:** [...]
+
+---
+
+## Pendencias Conhecidas
+
+Da PENDING.md:
+- {N} blockers
+- {N} non-blockers
+
+Estas pendencias NAO bloqueiam o planejamento, mas serao revistas no delivery.
+
+---
+
+## Veredito
+
+**{READY_FOR_BUILD | NEEDS_REWORK | BLOCKED}**
+
+[Justificativa em 1-2 paragrafos]
+
+### Rework Plan (se NEEDS_REWORK)
+
+1. [acao 1]
+2. [acao 2]
+3. [acao 3]
+
+Apos rework, re-rodar auditor.
+
+### Pronto pra Build (se READY_FOR_BUILD)
+
+Proximos passos:
+1. Gerar PLAN-READY.md
+2. Apresentar ao dono via CEO
+3. Aguardar `/up:build` (mesmo runtime ou outro)
+```
+
+</template>

package/templates/builder-defaults.md

@@ -35,26 +35,15 @@ O usuario customiza uma vez e vale para todos os projetos criados com `/up:modo-
 - Linter: ESLint + Prettier
 - Git: branch main, commits diretos
 
-## Modelos por Papel
-
-Configurar qual modelo de IA usar para cada tipo de trabalho.
-Modelos disponiveis: opus, sonnet, haiku
-
-| Papel | Modelo | Agentes |
-|-------|--------|---------|
-| planning | opus | arquiteto, product-analyst, system-designer, planejador, roteirista |
-| execution | sonnet | executor, frontend-specialist, backend-specialist, database-specialist |
-| verification | opus | verificador, code-reviewer, blind-validator, requirements-validator |
-| detection | sonnet | visual-critic, exhaustive-tester, api-tester |
-| research | sonnet | pesquisador-projeto, pesquisador-mercado, mapeador-codigo |
-| quality | opus | qa-agent, security-reviewer, auditor-ux, auditor-performance |
-
-Notas:
-- Opus: raciocinio profundo, decisoes arquiteturais, verificacao critica. Mais lento, mais caro.
-- Sonnet: execucao rapida, seguir instrucoes, volume de codigo. Mais rapido, mais barato.
-- Haiku: tarefas simples. NAO recomendado para codigo de producao.
-- Opus e Sonnet ambos suportam 1M de contexto.
-- Se execution=sonnet, planos serao gerados com nivel extra de detalhe (Sonnet-ready).
+## Modelos
+
+**v0.6.0+: Removido.** O runtime que voce usa decide o modelo.
+
+- Em Claude Code: usa o modelo selecionado via /model (default Opus 4.6)
+- Em OpenCode: usa o modelo do opencode.json
+- Em Gemini CLI: usa o modelo do runtime
+
+Planos sao sempre gerados em nivel detalhado (Sonnet-ready) independente do modelo executor.
 
 ## Nao usar
 - (liste aqui tecnologias que voce NAO quer em nenhum projeto)

package/templates/plan-ready.md

@@ -0,0 +1,137 @@
+# PLAN-READY.md Template
+
+Template para `.plano/PLAN-READY.md` — arquivo-flag que indica que o projeto foi
+completamente planejado e esta pronto para execucao.
+
+Gerado por `/up:plan` ao final do planejamento.
+Lido por `/up:build` como gate de entrada.
+
+<template>
+
+```yaml
+---
+version: "0.6.0"
+planned_at: ""
+planned_by:
+  runtime: ""           # claude-code | opencode | gemini-cli
+  ceo_name: ""
+  user_preferred_name: ""
+intended_execution:
+  runtime: ""           # same | claude-code | opencode | gemini-cli | any
+project_name: ""
+mode: ""                # greenfield | brownfield
+total_phases: 0
+total_plans: 0
+total_requirements: 0
+estimated_tasks: 0
+status: ready_for_execution
+planning_confidence: 0  # 0-100, do AUDIT-PLAN.md
+---
+
+# Projeto Pronto Para Execucao
+
+Este projeto foi completamente planejado. Todos os artefatos arquiteturais
+foram gerados, todas as fases foram planejadas em detalhe maximo (Sonnet-ready),
+e todas as aprovacoes de supervisores/chiefs foram obtidas.
+
+## Como executar
+
+```
+/up:build
+```
+
+Pode ser executado neste mesmo runtime ou em outro. O estado esta completamente
+salvo em `.plano/`.
+
+## Resumo do Projeto
+
+**Briefing:** [resumo em 1-2 frases do BRIEFING.md]
+
+**Stack:** [stack escolhida]
+
+**Mode:** [greenfield | brownfield]
+
+## Fases Planejadas
+
+| # | Fase | Planos | Tarefas | Wave | Status |
+|---|------|--------|---------|------|--------|
+| 1 | [nome] | [N] | [M] | 0 | planejada |
+| 2 | [nome] | [N] | [M] | 1 | planejada |
+| 3 | [nome] | [N] | [M] | 1 | planejada |
+
+## Aprovacoes Obtidas
+
+Todas estas aprovacoes foram registradas em governance/approvals.log:
+
+- [x] CEO: Briefing aprovado, intake completo
+- [x] Chief-architect: Arquitetura aprovada
+- [x] Chief-product: Fit com briefing confirmado
+- [x] Architecture-supervisor: PROJECT, ROADMAP, SYSTEM-DESIGN, REQUIREMENTS aprovados
+- [x] Planning-supervisor: Todos planos aprovados
+- [x] Chief-engineer: Planejamento consistente cross-fase
+- [x] Planning-auditor: Confidence score [N]/100
+
+## Artefatos Disponiveis
+
+```
+.plano/
+├── BRIEFING.md
+├── OWNER.md
+├── PENDING.md
+├── DESIGN-TOKENS.md
+├── PRODUCT-ANALYSIS.md
+├── SYSTEM-DESIGN.md
+├── PROJECT.md
+├── ROADMAP.md
+├── REQUIREMENTS.md
+├── AUDIT-PLAN.md           ← relatorio do planning auditor
+├── CHECKLIST.md
+├── PLAN-READY.md           ← este arquivo
+└── fases/
+    ├── 01-[nome]/
+    │   ├── 01-01-PLAN.md
+    │   ├── 01-01-PLAN-REVIEW.md
+    │   └── 01-02-PLAN.md
+    ├── 02-[nome]/
+    └── ...
+```
+
+## Credenciais
+
+- [x] [credencial 1]
+- [ ] [credencial pendente] (mock ativo)
+- [ ] [credencial pendente] (mock ativo)
+
+Ver `.plano/PENDING.md` para detalhes.
+
+## Listagem Completa de Planos
+
+[lista de todos os PLANs com seus paths, para o /up:build validar que existem]
+
+| ID | Path | Wave | Tasks |
+|----|------|------|-------|
+| 01-01 | fases/01-auth/01-01-PLAN.md | 0 | 8 |
+| 01-02 | fases/01-auth/01-02-PLAN.md | 1 | 7 |
+...
+```
+
+</template>
+
+<guidelines>
+
+## Como o /up:build usa este arquivo
+
+1. Gate de entrada: arquivo deve existir
+2. Parse YAML frontmatter
+3. Para cada plano listado, verificar se arquivo existe no disco
+4. Se algum plano falta: alertar e oferecer planejamento local
+5. Se tudo OK: prosseguir com execucao
+
+## Quando este arquivo e atualizado
+
+- Criado: ao final de `/up:plan`
+- Lido: no inicio de `/up:build`
+- Atualizado: nunca (e snapshot do planejamento)
+- Deletado: ao final do `/up:build` (vira PROJECT-COMPLETE.md)
+
+</guidelines>

package/workflows/build.md

@@ -0,0 +1,373 @@
+<purpose>
+Workflow `/up:build` — Execucao de projeto previamente planejado.
+
+Requer `.plano/PLAN-READY.md` (gerado por `/up:plan`).
+
+Conduz Estagios 3 (Build) + 4 (Quality Gate) + 4.5 (Delivery Audit) + 5 (Delivery).
+
+Pode executar projeto planejado em outro runtime — confia no PLAN-READY.md.
+</purpose>
+
+<core_principle>
+Este workflow assume que o projeto foi completamente planejado por `/up:plan`.
+
+Diferenca do builder:
+- Builder: planeja + executa em sequencia, no mesmo runtime
+- Build: SO executa, le PLAN-READY.md gerado anteriormente (mesmo runtime ou outro)
+
+**Sem model routing** — runtime decide o modelo.
+
+**Re-plan local permitido (max 2):**
+Se durante execucao o execution-supervisor detectar que um plano esta inviavel,
+ele pode pedir REQUEST_REPLAN. O planejador local refaz o plano daquela fase.
+NUNCA volta pro runtime que planejou originalmente.
+</core_principle>
+
+<process>
+
+## Estagio 0: GATES OBRIGATORIOS
+
+### 0.1 Owner Profile (LOCAL)
+
+```bash
+if [ ! -f ~/.claude/up/owner-profile.md ]; then
+  echo "Owner profile nao existe NESTE runtime. Rodando /up:onboard..."
+  # Delegar pro workflow onboarding.md
+fi
+```
+
+**IMPORTANTE:** O profile e do RUNTIME ATUAL, nao do runtime que planejou. Cada runtime tem seu profile.
+
+### 0.2 PLAN-READY.md Existe?
+
+```bash
+if [ ! -f .plano/PLAN-READY.md ]; then
+  echo "ERRO: Este projeto nao foi planejado."
+  echo ""
+  echo "Use /up:plan primeiro pra planejar o projeto."
+  echo "Ou /up:modo-builder pra planejar e executar de uma vez."
+  exit 1
+fi
+```
+
+### 0.3 Crash Recovery
+
+```bash
+ls .plano/LOCK.md 2>/dev/null
+```
+
+Se LOCK.md existe e `stage: build`: retomar.
+
+## Estagio V: VALIDACAO LIGHT
+
+**Confiar no PLAN-READY.md, mas spot-check estrutura.**
+
+### V.1 Parsear PLAN-READY.md
+
+```bash
+# Extrair frontmatter
+PLANNED_RUNTIME=$(grep "runtime:" .plano/PLAN-READY.md | head -1 | awk '{print $2}')
+INTENDED_RUNTIME=$(grep -A1 "intended_execution:" .plano/PLAN-READY.md | tail -1 | awk '{print $2}')
+TOTAL_PHASES=$(grep "total_phases:" .plano/PLAN-READY.md | awk '{print $2}')
+CONFIDENCE=$(grep "planning_confidence:" .plano/PLAN-READY.md | awk '{print $2}')
+```
+
+### V.2 Validacao de Compatibilidade
+
+```bash
+CURRENT_RUNTIME="claude-code"  # detectar
+[ -d ~/.config/opencode ] && CURRENT_RUNTIME="opencode"
+[ -d ~/.gemini ] && CURRENT_RUNTIME="gemini-cli"
+
+# Se intended_execution especifica um runtime e nao e o atual, alertar
+if [ "$INTENDED_RUNTIME" != "same" ] && [ "$INTENDED_RUNTIME" != "any" ] && [ "$INTENDED_RUNTIME" != "$CURRENT_RUNTIME" ]; then
+  echo "AVISO: Plano gerado pra $INTENDED_RUNTIME, voce esta em $CURRENT_RUNTIME"
+  echo "Pode haver incompatibilidades. Continuar mesmo assim?"
+  # AskUserQuestion sim/nao
+fi
+```
+
+### V.3 Validar Artefatos Esperados
+
+```bash
+[ -f .plano/PROJECT.md ] || { echo "FALTANDO: PROJECT.md"; FAIL=1; }
+[ -f .plano/ROADMAP.md ] || { echo "FALTANDO: ROADMAP.md"; FAIL=1; }
+[ -f .plano/REQUIREMENTS.md ] || { echo "FALTANDO: REQUIREMENTS.md"; FAIL=1; }
+[ -f .plano/SYSTEM-DESIGN.md ] || { echo "FALTANDO: SYSTEM-DESIGN.md"; FAIL=1; }
+```
+
+### V.4 Validar Planos Listados
+
+Pra cada plano listado em PLAN-READY.md, checar se arquivo existe:
+
+```bash
+# Extrair lista de planos do PLAN-READY.md
+PLANS=$(grep -oE "fases/[0-9]+-[a-z-]+/[0-9]+-[0-9]+-PLAN.md" .plano/PLAN-READY.md)
+
+for plan in $PLANS; do
+  if [ ! -f ".plano/$plan" ]; then
+    echo "FALTANDO: $plan"
+    FAIL=1
+  fi
+done
+```
+
+### V.5 Decidir
+
+**Se todos arquivos OK:** prosseguir.
+
+**Se algo falta:** 
+- Alertar usuario
+- Oferecer: "Posso planejar localmente?" (re-roda /up:plan)
+- Ou abortar
+
+## Estagio C: CEO CONFIRMA
+
+Spawnar CEO local:
+
+```python
+Agent(
+  subagent_type="up-project-ceo",
+  prompt="""
+    Confirmar execucao de projeto previamente planejado.
+    
+    <files_to_read>
+    - ~/.claude/up/owner-profile.md (perfil LOCAL deste runtime)
+    - .plano/BRIEFING.md (briefing original)
+    - .plano/PLAN-READY.md (resumo do planejamento)
+    - .plano/AUDIT-PLAN.md (audit do planejamento)
+    - .plano/PENDING.md
+    </files_to_read>
+    
+    Apresentar ao dono:
+    - "Detectei projeto planejado em {runtime} por {ceo_name_anterior}"
+    - Resumo: N fases, M planos
+    - Planning confidence: X/100
+    - Pendencias conhecidas
+    - "Iniciar execucao? (enter pra continuar)"
+    
+    Se dono confirmar: prosseguir.
+    Se recusar: abortar.
+  """
+)
+```
+
+## Estagio 3: BUILD (loop por fase)
+
+**Mesmo processo do builder.md secao Estagio 3, mas SEM model routing.**
+
+Para cada fase em ROADMAP.md (em ordem):
+
+### 3.1 Carregar Plano da Fase
+
+```bash
+PHASE_DIR=$(ls -d .plano/fases/{phase_number}-* 2>/dev/null)
+PLAN=$(ls "$PHASE_DIR"/*-PLAN.md | head -1)
+```
+
+### 3.2 Detectar Tipo de Plano (Specialist Routing)
+
+Ler o frontmatter do plano pra determinar qual specialist usar:
+- Frontend tasks → up-frontend-specialist
+- Backend tasks → up-backend-specialist
+- Database tasks → up-database-specialist
+- Misto → up-executor
+
+### 3.3 Spawnar Specialist
+
+```python
+Agent(
+  subagent_type="{up-specialist}",
+  prompt=f"""
+    Executar Plano da Fase {phase_number}.
+    
+    <files_to_read>
+    - {PLAN}
+    - .plano/PROJECT.md
+    - .plano/SYSTEM-DESIGN.md
+    - $HOME/.claude/up/references/engineering-principles.md
+    - $HOME/.claude/up/references/production-requirements.md
+    </files_to_read>
+    
+    Implementar todas as tarefas. Commitar atomicamente.
+    Gerar SUMMARY.md.
+  """
+)
+```
+
+### 3.4 Execution Supervisor Revisa
+
+```python
+Agent(
+  subagent_type="up-execution-supervisor",
+  prompt=f"""
+    Revisar execucao da Fase {phase_number}.
+    
+    <files_to_read>
+    - {PLAN}
+    - {PHASE_DIR}/*-SUMMARY.md
+    - git diff
+    </files_to_read>
+    
+    Decisao: APPROVE | REQUEST_CHANGES | REQUEST_REPLAN | ESCALATE
+    
+    REQUEST_REPLAN: Se descobrir que o plano e fundamentalmente errado/inviavel.
+                    Max 2 re-plans por projeto.
+  """
+)
+```
+
+### 3.5 Processar Decisao do Supervisor
+
+**Se APPROVE:** prosseguir.
+
+**Se REQUEST_CHANGES:** re-spawn specialist com feedback (max 3 ciclos).
+
+**Se REQUEST_REPLAN:**
+
+```bash
+REPLAN_COUNT=$(cat .plano/governance/replans.log 2>/dev/null | wc -l)
+if [ "$REPLAN_COUNT" -ge 2 ]; then
+  echo "Max re-plans atingido. Escalando pro CEO."
+  # ESCALATE
+else
+  # Re-planejar fase localmente
+  echo "REQUEST_REPLAN aprovado. Re-planejando fase {phase_number} localmente..."
+  
+  # Spawnar planejador LOCAL
+  Agent(
+    subagent_type="up-planejador",
+    prompt=f"""
+      RE-PLAN da Fase {phase_number}.
+      
+      Plano original: {PLAN}
+      Razao do re-plan: {execution_supervisor_reason}
+      
+      Refaca o plano corrigindo o problema descoberto.
+    """
+  )
+  
+  # Salvar como -PLAN-v2.md
+  mv "$PLAN" "${PLAN%-PLAN.md}-PLAN-v1.md"
+  # novo plano vira PLAN principal
+  
+  # Registrar
+  echo "$(date -u) | phase-{phase_number} | execution-supervisor | REPLAN | reason: {reason}" >> .plano/governance/replans.log
+  
+  # Planning-supervisor revisa novo plano
+  Agent(subagent_type="up-planning-supervisor", ...)
+  
+  # Voltar pro 3.3 (re-spawn specialist)
+fi
+```
+
+**Se ESCALATE:** chief-engineer entra.
+
+### 3.6 Verificacao
+
+```python
+Agent(subagent_type="up-verificador", ...)
+Agent(subagent_type="up-verification-supervisor", ...)
+```
+
+### 3.7 E2E + DCRV
+
+Ver builder.md secao 3.1.5 (E2E) e 3.1.5.1 (DCRV).
+
+### 3.8 Chief-engineer Aprova Fase
+
+```python
+Agent(
+  subagent_type="up-chief-engineer",
+  prompt="Revisar Fase {phase_number} consolidada."
+)
+```
+
+### 3.9 Marcar Completa e Avancar
+
+## Estagio 4: QUALITY GATE GLOBAL
+
+Mesmo processo do builder.md secao Estagio 4. Sem model routing.
+
+## Estagio 4.5: DELIVERY AUDIT
+
+```python
+Agent(subagent_type="up-delivery-auditor", ...)
+```
+
+## Estagio 5: DELIVERY
+
+Mesmo processo. CEO local apresenta resultado.
+
+### 5.X Marcar Projeto Completo
+
+```bash
+# PLAN-READY.md → PROJECT-COMPLETE.md
+mv .plano/PLAN-READY.md .plano/PROJECT-COMPLETE.md
+```
+
+Adicionar ao frontmatter:
+```yaml
+status: complete
+completed_at: [timestamp]
+completed_by:
+  runtime: [current]
+  ceo_name: [local]
+final_confidence: [from audit]
+```
+
+</process>
+
+<replans>
+
+## Re-plans Locais (max 2)
+
+Quando: execution-supervisor descobre que o plano original esta inviavel.
+
+Como funciona:
+
+```
+Execution falha
+  ↓
+execution-supervisor analisa
+  ↓
+Decide: REQUEST_REPLAN
+  ↓
+Verifica replans.log < 2?
+  ├─ Sim: prosseguir
+  └─ Nao: ESCALATE pro CEO
+  ↓
+Spawnar planejador LOCAL no runtime atual
+  ↓
+Refaz plano daquela fase
+  ↓
+Salva como PLAN-v2.md (preserva v1 pra historico)
+  ↓
+Planning-supervisor LOCAL revisa
+  ↓
+Se APPROVE: voltar pro executor com novo plano
+Se REJECT: ESCALATE pro chief-engineer
+```
+
+Registro em `.plano/governance/replans.log`:
+```
+2026-04-11T15:30:00Z | phase-3 | execution-supervisor | REPLAN | cycle 1/2
+  reason: Library X discontinued, need to use Y instead
+  original_plan: 03-01-PLAN-v1.md
+  new_plan: 03-01-PLAN.md (was v2)
+```
+
+</replans>
+
+<success_criteria>
+- [ ] Owner profile LOCAL validado
+- [ ] PLAN-READY.md existe e parseado
+- [ ] Validacao light passou (artefatos + planos existem)
+- [ ] CEO confirmou execucao
+- [ ] Todas fases executadas com supervisao
+- [ ] Re-plans registrados (se houve)
+- [ ] Quality Gate global passou
+- [ ] Delivery audit aprovou
+- [ ] CEO apresentou resultado
+- [ ] PLAN-READY.md → PROJECT-COMPLETE.md
+</success_criteria>