up-cc 0.4.6 → 0.5.1

package/templates/checklist.md

@@ -0,0 +1,195 @@
+# CHECKLIST.md Template
+
+Template para `.plano/CHECKLIST.md` — rastreamento global do processo UP em tempo real.
+Atualizado por CADA agente conforme completa seu trabalho.
+Lido pelo Delivery Auditor para calcular Confidence Score.
+
+<template>
+
+```yaml
+---
+started_at: ""
+updated_at: ""
+total_items: 0
+completed: 0
+in_progress: 0
+pending: 0
+failed: 0
+confidence_score: 0
+---
+
+# Checklist Global
+
+Fonte unica da verdade sobre o que foi feito vs o que deveria ter sido feito.
+Cada item tem: status, evidencia (path), validador, timestamp.
+
+## Estagio 1: Intake
+
+- [ ] E1.1 Briefing coletado
+  - status: pending | in_progress | completed | failed
+  - validator: [agente que validou]
+  - evidence: .plano/BRIEFING.md
+  - timestamp: [ISO]
+  
+- [ ] E1.2 Design system coletado ou marcado como pending
+  - status: 
+  - validator: 
+  - evidence: .plano/DESIGN-TOKENS.md ou .plano/PENDING.md
+  - timestamp: 
+
+- [ ] E1.3 Credenciais coletadas ou marcadas como pending
+  - status: 
+  - evidence: .env.local ou .plano/PENDING.md
+  
+- [ ] E1.4 Referencias coletadas
+  - status: 
+  - evidence: .plano/OWNER.md
+  
+- [ ] E1.5 Restricoes anotadas
+  - status: 
+  - evidence: .plano/OWNER.md
+
+## Estagio 2: Arquitetura
+
+- [ ] E2.1 PRODUCT-ANALYSIS.md gerado
+  - validator: product-supervisor
+  - approved_by: chief-product
+  
+- [ ] E2.2 SYSTEM-DESIGN.md gerado
+  - validator: architecture-supervisor
+  - approved_by: chief-architect
+  
+- [ ] E2.3 PROJECT.md gerado
+  - validator: architecture-supervisor
+  
+- [ ] E2.4 ROADMAP.md gerado
+  - validator: architecture-supervisor
+  
+- [ ] E2.5 REQUIREMENTS.md gerado e validado
+  - validator: architecture-supervisor
+  
+- [ ] E2.6 DESIGN-TOKENS.md gerado (se projeto tem UI)
+  - validator: architecture-supervisor
+  
+- [ ] E2.7 Chief-architect aprovou arquitetura global
+  - validator: chief-architect
+
+## Estagio 3: Build (por fase)
+
+### Fase {N}: {nome}
+
+- [ ] E3.N.1 Plano criado
+  - validator: planning-supervisor
+  - rework_cycles: 0
+  
+- [ ] E3.N.2 Execucao concluida
+  - validator: execution-supervisor
+  - rework_cycles: 0
+  
+- [ ] E3.N.3 Verificador passou
+  - validator: verification-supervisor
+  
+- [ ] E3.N.4 E2E rodou (se tem UI)
+  - validator: quality-supervisor
+  
+- [ ] E3.N.5 DCRV rodou (3 detectores)
+  - validator: quality-supervisor
+  
+- [ ] E3.N.6 Chief-engineer aprovou fase
+  - validator: chief-engineer
+
+## Estagio 4: Quality Gate Global
+
+- [ ] E4.1 DCRV global rodou
+  - validator: quality-supervisor
+  
+- [ ] E4.2 Blind validator rodou
+  - validator: verification-supervisor
+  
+- [ ] E4.3 UX tester rodou
+  - validator: audit-supervisor
+  
+- [ ] E4.4 Mobile first rodou
+  - validator: audit-supervisor
+  
+- [ ] E4.5 Security review passou
+  - validator: audit-supervisor
+  
+- [ ] E4.6 Melhorias aplicadas
+  - validator: audit-supervisor
+  
+- [ ] E4.7 QA tests rodaram
+  - validator: quality-supervisor
+  
+- [ ] E4.8 DevOps artifacts gerados
+  - validator: operations-supervisor
+  
+- [ ] E4.9 Documentacao gerada
+  - validator: operations-supervisor
+  
+- [ ] E4.10 Chief-quality aprovou qualidade global
+  - validator: chief-quality
+
+## Estagio 4.5: Audit (NOVO)
+
+- [ ] E4.5.1 Delivery-auditor rodou
+  - validator: delivery-auditor
+  
+- [ ] E4.5.2 Confidence Score calculado
+  - threshold: 95%
+  
+- [ ] E4.5.3 Inconsistencias resolvidas
+  
+- [ ] E4.5.4 Rework loop executado (se necessario)
+  - max_cycles: 3
+
+## Estagio 5: Delivery
+
+- [ ] E5.1 E2E final rodou
+  - validator: quality-supervisor
+  
+- [ ] E5.2 DELIVERY.md gerado
+  - validator: operations-supervisor
+  
+- [ ] E5.3 PENDING.md consolidado
+  
+- [ ] E5.4 CEO aprovou delivery
+  - validator: project-ceo
+  
+- [ ] E5.5 Resumo apresentado ao dono
+  - validator: project-ceo
+```
+
+</template>
+
+<guidelines>
+
+## Como atualizar
+
+**Cada agente atualiza seus items ao completar:**
+
+```bash
+# Exemplo: execution-supervisor aprovou fase 3
+node "$HOME/.claude/up/bin/up-tools.cjs" checklist update \
+  --item "E3.3.2" \
+  --status "completed" \
+  --validator "execution-supervisor" \
+  --evidence ".plano/fases/03-dashboard/03-01-SUMMARY.md" \
+  --rework-cycles 1
+```
+
+## Como o Delivery Auditor usa
+
+1. Le CHECKLIST.md
+2. Conta: completed / total = Confidence Score (%)
+3. Identifica items pending/failed
+4. Cruza com outros relatorios pra detectar inconsistencias
+5. Gera AUDIT-REPORT.md com recomendacao
+
+## Thresholds
+
+- **Confidence >= 95%:** delivery liberado
+- **Confidence 85-94%:** delivery com ressalvas (CEO confirma com dono)
+- **Confidence < 85%:** delivery bloqueado, loop de rework obrigatorio
+
+</guidelines>

package/templates/owner-profile.md

@@ -0,0 +1,111 @@
+# Owner Profile Template
+
+Template global para `~/.claude/up/owner-profile.md`.
+Criado automaticamente pelo onboarding (`/up:onboard`).
+Lido pelo CEO antes de cada projeto pra adaptar tom e decisoes ao estilo do dono.
+
+<template>
+
+```yaml
+---
+# Identidade
+name: ""
+preferred_name: ""
+role: ""
+company: ""
+location: ""
+timezone: ""
+language: pt-BR
+
+# CEO (customizavel pelo dono)
+ceo_name: "CEO"
+ceo_tone: "amigavel"  # formal | amigavel | direto
+
+# Criacao
+created_at: ""
+updated_at: ""
+version: "1.0"
+---
+
+## Contexto Profissional
+
+[Descricao livre do que o usuario faz, area de atuacao, background]
+
+## Time
+
+- Solo ou tem time? [solo | time]
+- Tamanho do time: [N]
+- Papel no time: [lead, contribuidor, gestor]
+
+## Stack Preferida
+
+- **Frontend:** [ex: Next.js, Vite, Vue, SvelteKit]
+- **Backend:** [ex: FastAPI, Express, Rails, Supabase]
+- **Database:** [ex: Postgres, Supabase, MongoDB, SQLite]
+- **Package manager:** [ex: pnpm, npm, yarn, bun]
+- **Deploy/Infra:** [ex: Vercel, Hetzner+Coolify, AWS, Railway]
+- **Linguagens principais:** [lista]
+
+## Estilo de Trabalho
+
+- **Prioridade:** [velocidade | qualidade | balanceado]
+- **Decisoes:** [automaticas | perguntadas | hibrido]
+- **Updates:** [verbose | normal | silent]
+- **Tom do CEO:** [formal | amigavel | direto]
+
+## Restricoes Permanentes
+
+Tecnologias/patterns que NUNCA usar:
+- [lista]
+
+## Integracoes Disponiveis
+
+APIs e servicos que o usuario tem acesso (sem credenciais aqui — so nomes):
+- [lista]
+
+## Valores / Filosofia
+
+- [como o usuario pensa sobre software]
+- [preferencias arquiteturais]
+- [trade-offs preferidos]
+
+## Contexto Adicional
+
+[Qualquer contexto extra que o usuario queira compartilhar]
+
+---
+
+## Notas do CEO
+
+[Observacoes aprendidas pelo CEO durante uso — atualizado automaticamente]
+```
+
+</template>
+
+<guidelines>
+
+**Como o CEO usa este arquivo:**
+
+1. Lido no inicio de QUALQUER comando UP
+2. Informa tom, apresentacao e decisoes
+3. Override por projeto: `.plano/OWNER.md` pode refinar para contexto especifico
+4. Atualizado via `/up:onboard --update`
+
+**Hierarquia de prioridade:**
+```
+.plano/OWNER.md (projeto especifico, maior)
+  > ~/.claude/up/owner-profile.md (global)
+    > defaults do sistema (menor)
+```
+
+**O que NAO colocar:**
+- Credenciais ou tokens (ficam em .env dos projetos)
+- Informacoes sensiveis (CPF, senhas)
+- Preferencias que mudam muito rapido
+
+**Campos obrigatorios minimos:**
+- `name` ou `preferred_name`
+- `language`
+- `ceo_name` (default: "CEO")
+
+</guidelines>

package/templates/owner.md

@@ -0,0 +1,77 @@
+# OWNER.md Template (Por Projeto)
+
+Template para `.plano/OWNER.md` — memoria especifica do dono para ESTE projeto.
+Criado pelo CEO durante o intake. Atualizado durante execucao.
+
+<template>
+
+```yaml
+---
+owner_name: ""
+project_name: ""
+created_at: ""
+updated_at: ""
+ceo_name: ""  # copiado do owner-profile global
+---
+
+## Briefing Original
+
+[Texto completo que o dono passou no intake]
+
+## Preferencias Expressas
+
+Coisas que o dono mencionou durante o intake:
+- [preferencia 1]
+- [preferencia 2]
+
+## Decisoes do Dono
+
+Decisoes tomadas durante conversas (com timestamp):
+
+| Timestamp | Decisao | Contexto |
+|-----------|---------|----------|
+| [YYYY-MM-DD HH:MM] | [decisao] | [por que] |
+
+## Perguntas Pendentes
+
+Perguntas que o CEO fez mas nao foram respondidas:
+
+| Timestamp | Pergunta | Status |
+|-----------|----------|--------|
+| [YYYY-MM-DD HH:MM] | [pergunta] | aguardando |
+
+## Feedback Durante Execucao
+
+Feedback dado pelo dono durante o build:
+
+| Timestamp | Feedback | Acao tomada |
+|-----------|----------|-------------|
+| [YYYY-MM-DD HH:MM] | [feedback] | [o que foi feito] |
+
+## Assets Fornecidos
+
+Checklist do que o dono forneceu no intake:
+
+- [ ] Briefing
+- [ ] Design System
+- [ ] Credenciais API (quais)
+- [ ] Referencias visuais
+- [ ] Restricoes explicitas
+
+## Interacoes com o CEO
+
+Log de interacoes entre dono e CEO:
+
+| Timestamp | Tipo | Conteudo resumido |
+|-----------|------|-------------------|
+| [YYYY-MM-DD HH:MM] | intake | [resumo] |
+| [YYYY-MM-DD HH:MM] | update | [resumo] |
+| [YYYY-MM-DD HH:MM] | alerta | [resumo] |
+| [YYYY-MM-DD HH:MM] | delivery | [resumo] |
+
+## Contexto Adicional Coletado
+
+[Qualquer contexto extra descoberto durante a conversa]
+```
+
+</template>

package/templates/pending.md

@@ -0,0 +1,83 @@
+# PENDING.md Template
+
+Template para `.plano/PENDING.md` — assets pendentes do projeto.
+Criado pelo CEO durante o intake. Atualizado durante execucao.
+
+<template>
+
+```yaml
+---
+created_at: ""
+updated_at: ""
+total: 0
+blockers: 0
+non_blockers: 0
+resolved: 0
+---
+
+# Pending Assets
+
+Assets que o dono NAO forneceu no intake. Cada um tem impacto e categoria.
+
+## Categorias
+
+- **visual** — design tokens, brand, logos, cores, fontes
+- **integration** — credenciais de API, webhooks, OAuth
+- **data** — dados reais, seed, migracao de sistema anterior
+- **infrastructure** — dominio, SSL, deploy, monitoring
+- **content** — textos, imagens, copy, legal
+
+## Severidade
+
+- **blocker** — sistema nao funciona em producao sem isso
+- **non_blocker** — sistema funciona com stub/default, pode ser refinado depois
+
+---
+
+## Assets Pendentes
+
+### [ID]: [Titulo Curto]
+
+- **status:** pending | in_progress | resolved
+- **category:** visual | integration | data | infrastructure | content
+- **blocker:** true | false
+- **impact:** [descricao do que nao funciona sem isso]
+- **workaround:** [o que o UP fez ao inves — stub, default, mock]
+- **how_to_resolve:** [passo a passo pra resolver]
+- **created_at:** [timestamp]
+- **resolved_at:** [timestamp quando resolvido]
+
+**Exemplo:**
+
+### PEND-001: Design System Custom
+
+- **status:** pending
+- **category:** visual
+- **blocker:** false
+- **impact:** Sistema usando shadcn/ui defaults neutros
+- **workaround:** Gerado DESIGN-TOKENS.md com cores azul/cinza padrao
+- **how_to_resolve:** Passar cores e fontes do projeto pro CEO via /up:update
+- **created_at:** 2026-04-10T16:00:00Z
+
+### PEND-002: Credencial Resend
+
+- **status:** pending
+- **category:** integration
+- **blocker:** false (em dev), true (em producao)
+- **impact:** Emails transacionais nao sao enviados
+- **workaround:** Mock que loga no console ao inves de enviar
+- **how_to_resolve:** Adicionar RESEND_API_KEY no .env.production e atualizar lib/email.ts
+- **created_at:** 2026-04-10T16:00:00Z
+
+### PEND-003: Credencial Asaas
+
+- **status:** pending
+- **category:** integration
+- **blocker:** true
+- **impact:** Pagamentos nao funcionam
+- **workaround:** Mock retorna sempre success (NAO usar em producao)
+- **how_to_resolve:** Adicionar ASAAS_API_KEY + ASAAS_WALLET_ID no .env
+- **created_at:** 2026-04-10T16:00:00Z
+```
+
+</template>

package/workflows/builder.md

@@ -87,6 +87,44 @@ Task(subagent_type="up-executor", model="sonnet", prompt="...")
 3. Se a variavel nao foi definida (sem builder-defaults), usar o default da tabela
 </model_routing>
 
+<governance>
+## Camada de Governanca (v0.5.0+)
+
+**O builder usa hierarquia corporativa de agentes:**
+
+```
+CEO (up-project-ceo) — conduz intake, aprova delivery, canal com dono
+  ↓
+CHIEFS (5) — revisam consolidado de cada area
+  ↓
+SUPERVISORS (8) — revisam cada agente operacional
+  ↓
+OPERATIONAL AGENTS (36) — fazem o trabalho
+```
+
+**Referencia obrigatoria:** `@~/.claude/up/workflows/governance.md`
+
+**Regras gerais:**
+1. Todo output de agente operacional passa por supervisor
+2. Toda area tem chief que consolida
+3. CEO aprova delivery final
+4. Max 3 ciclos de rework (operacional ← supervisor)
+5. Max 2 ciclos (supervisor ← chief)
+6. Max 1 ciclo (chief ← CEO)
+
+**Pre-requisito:**
+```bash
+# Verificar owner-profile
+if [ ! -f ~/.claude/up/owner-profile.md ]; then
+  echo "Owner profile nao existe. Rodando /up:onboard primeiro..."
+  # Delegar pro onboarding workflow
+  # Referencia: @~/.claude/up/workflows/onboarding.md
+fi
+```
+
+**Sem owner-profile, o CEO nao sabe quem e o dono — impossivel conduzir intake.**
+</governance>
+
 <process>
 
 ## Estagio 1: INTAKE (Interativo)
@@ -139,7 +177,27 @@ NAO fazer intake novamente. Ler BRIEFING.md e PROJECT.md para contexto.
 Deletar LOCK.md e iniciar normalmente (sessao anterior terminou com sucesso).
 
 **Se LOCK.md NAO existe:**
-Continuar normalmente para 1.1.
+Continuar normalmente para 1.05.
+
+### 1.05 Verificar Owner Profile (GATE OBRIGATORIO)
+
+```bash
+if [ ! -f ~/.claude/up/owner-profile.md ]; then
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "  UP > PRIMEIRO USO DETECTADO"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+  echo "  Voce nunca usou o UP antes. Antes de comecar o builder,"
+  echo "  preciso te conhecer."
+  echo ""
+  echo "  Rodando /up:onboard primeiro..."
+  echo ""
+fi
+```
+
+Se owner-profile nao existe:
+1. Delegar para o workflow de onboarding (`@~/.claude/up/workflows/onboarding.md`)
+2. Apos completar onboarding, voltar para o builder
 
 ### 1.1 Carregar Defaults e Detectar Modo
 
@@ -184,17 +242,47 @@ ls .plano/ROADMAP.md .plano/PROJECT.md 2>/dev/null
 
 Definir `$MODE` = `greenfield` ou `brownfield`.
 
-### 1.2 Receber Briefing
+### 1.2 Delegar Intake ao CEO
 
-O briefing vem como $ARGUMENTS do comando. Se vazio, pedir freeform adaptado ao modo:
+**NOVO (v0.5.0):** O intake agora e conduzido pelo CEO (up-project-ceo).
 
-**GREENFIELD:**
-"Descreva o que voce quer construir. Inclua: objetivo, publico, features principais, stack (se tiver preferencia), e qualquer contexto relevante."
+Spawnar CEO com contexto:
 
-**BROWNFIELD:**
-"Codigo existente detectado. O que voce quer implementar? Descreva a feature, mudanca ou refatoracao. Inclua: o que deve fazer, como se integra com o existente, e qualquer contexto relevante."
+```python
+Agent(
+  subagent_type="up-project-ceo",
+  model="opus",
+  prompt=f"""
+    Conduza intake para novo projeto UP.
+    
+    Modo detectado: {MODE}
+    Briefing inicial: {ARGUMENTS ou "vazio, pedir ao dono"}
+    
+    <files_to_read>
+    - ~/.claude/up/owner-profile.md (OBRIGATORIO — seu perfil do dono)
+    - $HOME/.claude/up/workflows/ceo-intake.md (seu workflow de intake)
+    - $HOME/.claude/up/workflows/onboarding.md (caso owner-profile nao exista)
+    </files_to_read>
+    
+    Executar workflow de intake ate completar:
+    1. Conduzir 5 blocos de intake (briefing, design, credenciais, referencias, restricoes)
+    2. Gerar .plano/BRIEFING.md, .plano/OWNER.md, .plano/PENDING.md, .plano/DESIGN-TOKENS.md
+    3. Apresentar resumo ao dono antes de iniciar
+    
+    Retornar apos intake com: briefing consolidado, modo confirmado, credenciais coletadas, pendencias.
+  """
+)
+```
+
+**Receber retorno do CEO:**
+- BRIEFING completo
+- OWNER.md criado
+- PENDING.md criado
+- DESIGN-TOKENS.md criado (custom ou defaults)
+
+**Se CEO rejeitou briefing:** usuario ja foi alertado, retornar e esperar nova tentativa.
 
-Esperar resposta.
+**Se CEO aprovou:** continuar para 1.3.
 
 ### 1.3 Analisar e Classificar Gaps
 
@@ -1924,6 +2012,79 @@ NAO implementar ideias — apenas salvar relatorio para proximos passos.
 
 ---
 
+## Estagio 4.5: DELIVERY AUDIT (NOVO v0.5.0)
+
+Antes do Delivery, o `up-delivery-auditor` valida que o processo inteiro foi completo e consistente.
+
+### 4.5.1 Rodar Delivery Auditor
+
+```python
+Agent(
+  subagent_type="up-delivery-auditor",
+  model="opus",
+  prompt="""
+    Auditar processo de entrega do projeto.
+    
+    <files_to_read>
+    - .plano/CHECKLIST.md
+    - .plano/BRIEFING.md
+    - .plano/PENDING.md
+    - .plano/governance/approvals.log (se existe)
+    - Todos os reviews (supervisores + chiefs)
+    - Todos os relatorios (VERIFICATION, DCRV, E2E, etc.)
+    - $HOME/.claude/up/templates/audit-report.md (template)
+    </files_to_read>
+    
+    Calcular Confidence Score (0-100).
+    Detectar inconsistencias cross-report.
+    Validar aprovacoes.
+    Comparar delivery com briefing original.
+    
+    Gerar .plano/AUDIT-REPORT.md com recomendacao.
+    
+    Retornar: READY_FOR_DELIVERY | APPROVED_WITH_WARNINGS | NEEDS_REWORK | BLOCKED
+  """
+)
+```
+
+### 4.5.2 Processar Resultado do Auditor
+
+**Se READY_FOR_DELIVERY (confidence >= 95%):**
+- Prosseguir direto pro Estagio 5
+
+**Se APPROVED_WITH_WARNINGS (confidence 85-94%):**
+- Delegar pro CEO decidir
+- CEO pode perguntar ao dono se aceita entregar com warnings
+
+**Se NEEDS_REWORK (confidence 70-84%):**
+- Executar rework plan do auditor
+- Re-rodar estagios problematicos
+- Voltar pro auditor (max 3 ciclos)
+
+**Se BLOCKED (confidence < 70% ou problema critico):**
+- Escalar pro CEO
+- CEO alerta dono obrigatoriamente
+- Projeto nao pode ser entregue sem decisao do dono
+
+### 4.5.3 Loop de Rework (se necessario)
+
+```
+Ciclo 1: rodar auditor
+  Se NEEDS_REWORK:
+    Executar rework plan
+    Ciclo 2: rodar auditor
+      Se NEEDS_REWORK:
+        Executar rework plan
+        Ciclo 3: rodar auditor
+          Se NEEDS_REWORK:
+            Forca APPROVED_WITH_WARNINGS
+            CEO decide o que fazer
+```
+
+Max 3 ciclos. Depois: forcar aprovacao ou escalar CEO.
+
+---
+
 ## Estagio 5: ENTREGA (Autonomo)
 
 ### 5.1 Teste E2E Final Completo (Playwright)
@@ -2087,7 +2248,33 @@ rm -f .plano/LOCK.md
 kill $DASH_PID 2>/dev/null
 ```
 
-### 5.6 Apresentar Resultado
+### 5.6 CEO Apresenta Resultado (NOVO v0.5.0)
+
+Delegar apresentacao final ao CEO:
+
+```python
+Agent(
+  subagent_type="up-project-ceo",
+  model="opus",
+  prompt="""
+    Apresentar resultado final do projeto ao dono.
+    
+    <files_to_read>
+    - ~/.claude/up/owner-profile.md (seu perfil do dono)
+    - .plano/OWNER.md (contexto do projeto)
+    - .plano/DELIVERY.md (relatorio de entrega)
+    - .plano/AUDIT-REPORT.md (auditoria)
+    - .plano/PENDING.md (pendencias)
+    </files_to_read>
+    
+    Apresentar no tom e estilo definidos no owner-profile.
+    Incluir: resumo, scores, pendencias agrupadas por severidade.
+    Perguntar se dono quer resolver alguma pendencia agora.
+  """
+)
+```
+
+**Template antigo (fallback se CEO nao disponivel):**
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━