up-cc 0.4.5 → 0.5.0

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):**
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

package/workflows/ceo-intake.md

@@ -0,0 +1,305 @@
+<purpose>
+Workflow de intake de projeto conduzido pelo CEO.
+
+Usado pelo `/up:modo-builder` e comandos similares quando um projeto novo comeca.
+Diferente do onboarding (que e sobre conhecer o dono), este e sobre conhecer o PROJETO.
+
+Apos intake, gera:
+- `.plano/BRIEFING.md` — briefing do projeto
+- `.plano/OWNER.md` — contexto especifico do projeto
+- `.plano/PENDING.md` — assets faltantes
+- `.plano/DESIGN-TOKENS.md` — se dono passou, senao marca pending
+</purpose>
+
+<prerequisites>
+Antes de rodar este workflow, verificar:
+1. `~/.claude/up/owner-profile.md` existe → se nao, rodar `/up:onboard` primeiro
+2. Ler owner-profile pra pegar ceo_name, preferred_name, ceo_tone, stack preferida
+</prerequisites>
+
+<process>
+
+## Passo 0: Carregar Perfil do Dono
+
+```bash
+# Obrigatorio — CEO precisa saber quem e o dono
+if [ ! -f ~/.claude/up/owner-profile.md ]; then
+  echo "Onboarding necessario. Execute /up:onboard primeiro."
+  exit 1
+fi
+
+cat ~/.claude/up/owner-profile.md
+```
+
+Extrair:
+- `$PREFERRED_NAME`
+- `$CEO_NAME`
+- `$CEO_TONE`
+- Preferencias de stack (usar como defaults)
+
+## Passo 1: Apresentacao
+
+Com base no `ceo_tone`:
+
+**Tom amigavel (default):**
+```
+Ola {PREFERRED_NAME}. Aqui e o {CEO_NAME}, pronto pra conduzir
+seu proximo projeto UP.
+
+Me conta um pouco sobre o que voce quer construir.
+```
+
+**Tom formal:**
+```
+Prezado {PREFERRED_NAME}. {CEO_NAME} falando. Estou pronto
+para iniciar seu proximo projeto.
+
+Por favor, descreva o que deseja construir.
+```
+
+**Tom direto:**
+```
+{PREFERRED_NAME}: {CEO_NAME} aqui. Projeto novo?
+Descreve o que voce quer construir.
+```
+
+## Passo 2: Bloco 1 — Briefing (obrigatorio)
+
+**Se `$ARGUMENTS` ja tem briefing**: usar direto, pular AskUserQuestion.
+
+**Se nao:**
+
+```python
+AskUserQuestion(
+  header="Briefing",
+  question="O que voce quer construir? Me conta em texto livre.",
+  followUp=None
+)
+```
+
+Salvar como `$BRIEFING`.
+
+## Passo 3: Validacao de Briefing (rejeicao possivel)
+
+Avaliar o briefing:
+- E especifico ou vago demais?
+- Escopo e viavel?
+- Ha contradicoes?
+- Falta contexto critico?
+
+**Se briefing e VAGO/INVIAVEL:**
+
+```python
+AskUserQuestion(
+  header="Precisando de mais contexto",
+  question="""{PREFERRED_NAME}, antes de comecar preciso entender melhor.
+  
+  Voce disse: "{BRIEFING}"
+  
+  Isso e {muito amplo | inviavel porque X | ambiguo em Y}.
+  
+  Preciso saber:
+  - {pergunta especifica 1}
+  - {pergunta especifica 2}
+  - {pergunta especifica 3}
+  
+  Pode detalhar?""",
+  followUp=None
+)
+```
+
+Receber resposta e atualizar `$BRIEFING`.
+
+**Se ainda esta vago apos 2 tentativas:** CEO assume responsabilidade, define escopo minimo e segue.
+
+## Passo 4: Bloco 2 — Design System (opcional)
+
+```python
+AskUserQuestion(
+  header="Design System",
+  question="""{PREFERRED_NAME}, voce tem um design system definido?
+  
+  Pode passar:
+  - Cores (primaria, secundaria, semanticas)
+  - Tipografia (fontes)
+  - Componentes base (shadcn, MUI, custom?)
+  - Ou link pro Figma / brand book
+  
+  Se nao tiver, eu crio um placeholder e marco como PENDENTE.""",
+  followUp=None
+)
+```
+
+**Se passou:**
+- Salvar em `.plano/DESIGN-TOKENS.md`
+- Marcar E1.2 como completed no CHECKLIST
+
+**Se nao passou:**
+- Gerar placeholder em `.plano/DESIGN-TOKENS.md` com defaults (shadcn neutro)
+- Adicionar entry em `.plano/PENDING.md` com severity non-blocker
+- Marcar E1.2 como completed (resolvido como pending)
+
+## Passo 5: Bloco 3 — Credenciais de API (opcional)
+
+```python
+AskUserQuestion(
+  header="Credenciais de API",
+  question="""{PREFERRED_NAME}, quais integracoes voce quer usar neste projeto?
+  
+  Pode passar credenciais de:
+  - Supabase (URL + anon key + service key)
+  - Email (Resend/SendGrid/Postmark)
+  - Pagamentos (Stripe/Asaas)
+  - WhatsApp (Evolution/UazAPI/Meta)
+  - Outras APIs que voce tem
+  
+  Se nao passar, eu uso mocks/stubs e marco como PENDENTE.""",
+  followUp=None
+)
+```
+
+**Processar cada credencial:**
+
+Para cada credencial passada:
+- Salvar em `.env.local` (sem commitar)
+- Marcar integracao como disponivel
+
+Para cada credencial NAO passada:
+- Adicionar em `.plano/PENDING.md` com severity:
+  - `blocker` se credencial e critica pra funcionalidade core
+  - `non_blocker` se pode usar stub
+
+## Passo 6: Bloco 4 — Referencias (opcional)
+
+```python
+AskUserQuestion(
+  header="Referencias",
+  question="""{PREFERRED_NAME}, tem alguma referencia que voce quer que eu siga?
+  
+  - URL de um app que voce gosta (tipo 'igual ao Linear')
+  - Screenshots de inspiracao
+  - Brand book / moodboard
+  - Ou 'parecido com X'
+  
+  Se nao tiver, eu pesquiso concorrentes do dominio.""",
+  followUp=None
+)
+```
+
+Salvar em `.plano/OWNER.md` na secao Referencias.
+
+**Se URL foi passada + flag `--clone`:** Entrar em modo clone-builder.
+
+## Passo 7: Bloco 5 — Restricoes (opcional)
+
+```python
+AskUserQuestion(
+  header="Restricoes",
+  question="""{PREFERRED_NAME}, ha algo que NAO deve estar no projeto?
+  
+  Exemplos:
+  - Features explicitamente rejeitadas
+  - Tecnologias banidas
+  - Abordagens que voce nao quer
+  
+  Ou enter pra pular.""",
+  followUp=None
+)
+```
+
+Salvar em `.plano/OWNER.md` na secao Restricoes.
+
+## Passo 8: Confirmar Intake
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ {CEO_NAME}: Intake Completo
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+Entendi. Resumo:
+
+✓ {resumo do briefing em 1 frase}
+✓ Stack: {stack detectada/definida}
+✓ Design: {custom passado | defaults com pending}
+✓ Credenciais: {quais passou}
+✓ Referencias: {o que passou}
+✓ Restricoes: {lista curta}
+
+⚠ Pendencias: {N}
+{lista curta de PENDING.md}
+
+Vou montar o time: {N} chiefs, {M} supervisores, agentes operacionais.
+Estimativa: {N} fases.
+
+Updates {verbose/normal/silent} conforme seu perfil.
+
+Comecando agora...
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Passo 9: Gerar Arquivos
+
+**`.plano/BRIEFING.md`:**
+```markdown
+---
+collected_at: [timestamp]
+collected_by: [ceo_name]
+owner: [preferred_name]
+---
+
+# Briefing
+
+## Briefing Original
+[texto completo]
+
+## Contexto Adicional (de respostas)
+[se houve rejeicao/re-perguntas]
+
+## Decisoes Iniciais
+- Stack: [...]
+- Design: [custom | defaults]
+- Modo: [greenfield | brownfield]
+```
+
+**`.plano/OWNER.md`:** usar template.
+
+**`.plano/PENDING.md`:** usar template, populado com pendencias detectadas.
+
+**`.plano/DESIGN-TOKENS.md`:** custom ou defaults.
+
+## Passo 10: Commit Inicial
+
+```bash
+git init 2>/dev/null
+node "$HOME/.claude/up/bin/up-tools.cjs" commit "docs: intake completo — {projeto}" \
+  --files .plano/BRIEFING.md .plano/OWNER.md .plano/PENDING.md .plano/DESIGN-TOKENS.md
+```
+
+## Passo 11: Atualizar Checklist
+
+Marcar items E1.1 ate E1.5 como completed em `.plano/CHECKLIST.md`.
+
+## Passo 12: Passar Controle Pros Chiefs
+
+Apos intake, CEO NAO continua executando. Ele passa controle pro pipeline do builder que spawna os chiefs.
+
+CEO so volta a agir quando:
+- Chief escala algum problema
+- Fase completa (pra mandar update)
+- Pre-delivery audit
+- Delivery final
+
+</process>
+
+<success_criteria>
+- [ ] owner-profile.md carregado
+- [ ] Briefing coletado e validado
+- [ ] 5 blocos processados (briefing, design, credenciais, referencias, restricoes)
+- [ ] BRIEFING.md gerado
+- [ ] OWNER.md gerado
+- [ ] PENDING.md gerado (com items se ha)
+- [ ] DESIGN-TOKENS.md gerado (custom ou defaults)
+- [ ] CHECKLIST E1.* marcados como completed
+- [ ] Commit inicial feito
+- [ ] Controle passado pros chiefs
+</success_criteria>