up-cc 0.4.6 → 0.5.1

package/commands/onboard.md

@@ -0,0 +1,69 @@
+---
+name: up:onboard
+description: Entrevista inicial pro CEO te conhecer e criar seu perfil (~/.claude/up/owner-profile.md)
+argument-hint: "[--update]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+<objective>
+Onboarding do UP: entrevista conduzida pelo CEO que cria seu perfil pessoal.
+
+O perfil e lido por todos os agentes UP antes de cada projeto pra adaptar:
+- Tom de comunicacao
+- Stack padrao
+- Estilo de decisao
+- Nome do seu CEO
+- Restricoes permanentes
+
+Rodado automaticamente no primeiro uso de qualquer comando UP.
+Rodado manualmente via `/up:onboard` ou `/up:onboard --update` pra refazer.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/onboarding.md
+@~/.claude/up/templates/owner-profile.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Flags:**
+- `--update` — Refaz o onboarding, sobrescreve perfil existente
+
+Sem argumentos: roda se nao existe, pula se ja existe.
+</context>
+
+<process>
+Execute the onboarding workflow from @~/.claude/up/workflows/onboarding.md end-to-end.
+
+**Passo 0 obrigatorio:**
+Verificar se `~/.claude/up/owner-profile.md` ja existe.
+
+```bash
+if [ -f ~/.claude/up/owner-profile.md ]; then
+  if [[ "$ARGUMENTS" == *"--update"* ]]; then
+    echo "Atualizando perfil existente..."
+    # Prosseguir
+  else
+    echo "Perfil ja existe. Use /up:onboard --update pra refazer."
+    cat ~/.claude/up/owner-profile.md | head -20
+    exit 0
+  fi
+fi
+```
+
+Seguir workflow completo:
+1. Apresentacao
+2. Bloco 1: Identidade (nome, papel, localizacao, idioma)
+3. Bloco 2: Nome do CEO (como voce me chama) + tom
+4. Bloco 3: Contexto profissional
+5. Bloco 4: Stack preferida
+6. Bloco 5: Estilo de trabalho
+7. Bloco 6: Restricoes permanentes
+8. Bloco 7: Integracoes disponiveis
+9. Gerar owner-profile.md
+10. Confirmar resumo
+</process>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "up-cc",
-  "version": "0.4.6",
+  "version": "0.5.1",
   "description": "Simplified spec-driven development for Claude Code, Gemini and OpenCode.",
   "bin": {
     "up-cc": "bin/install.js"

package/references/governance-rules.md

@@ -0,0 +1,157 @@
+# Governance Rules
+
+Regras de governanca aplicadas a TODOS os comandos UP.
+Carregado por supervisores, chiefs e CEO.
+
+---
+
+## Hierarquia
+
+```
+DONO (humano)
+  ↓
+CEO (up-project-ceo)
+  ↓
+CHIEFS (5 — architecture, product, engineer, quality, operations)
+  ↓
+SUPERVISORES (8 — area especifica)
+  ↓
+OPERACIONAIS (36 — agentes existentes)
+```
+
+## Fluxo de Aprovacao
+
+### Nivel 1: Supervisor revisa operacional
+
+Apos cada agente operacional completar trabalho:
+
+1. Supervisor da area le o output
+2. Supervisor avalia contra criterios objetivos
+3. Decisao:
+   - **APPROVE** — trabalho bom, segue
+   - **REQUEST_CHANGES** — volta pro operacional com lista especifica
+   - **ESCALATE** — problema serio, chama chief
+
+**Max rework cycles:** 3 (operacional → supervisor)
+
+### Nivel 2: Chief revisa consolidado
+
+Apos TODOS os agentes de uma area completarem:
+
+1. Chief le outputs consolidados da area
+2. Valida coerencia entre agentes
+3. Detecta drift de visao
+4. Decisao:
+   - **APPROVE** — area consistente, segue
+   - **REQUEST_CHANGES** — volta pro supervisor com feedback
+   - **ESCALATE** — problema de visao, chama CEO
+
+**Max rework cycles:** 2 (chief → supervisor → operacional)
+
+### Nivel 3: CEO revisa antes do delivery
+
+Antes do Estagio 5 (Delivery):
+
+1. CEO le briefing original + delivery report
+2. Valida que projeto atende ao pedido do dono
+3. Decisao:
+   - **APPROVE_DELIVERY** — pronto pra entregar
+   - **ALERTA_DONO** — algo critico, pergunta ao dono
+   - **REWORK** — volta pro chief responsavel
+
+**Max rework cycles:** 1 (CEO → chief)
+
+---
+
+## Criterios de Decisao
+
+### APPROVE
+- Todos criterios objetivos atendidos
+- Sem issues criticas
+- Sem inconsistencias
+- Evidencia clara
+
+### REQUEST_CHANGES
+- 1+ criterio nao atendido
+- Issues menores/medias que podem ser corrigidas
+- Feedback especifico e acionavel
+
+### ESCALATE
+- Problema fora do escopo do supervisor
+- Decisao arquitetural necessaria
+- Conflito entre outros agentes
+
+---
+
+## Poderes do Supervisor
+
+- ✅ Aprovar ou rejeitar trabalho do operacional
+- ✅ Pedir rework com feedback especifico
+- ✅ Mudar decisoes taticas (ex: "use zod ao inves de yup")
+- ✅ Escalar pra chief se necessario
+- ❌ NAO pode mudar decisoes arquiteturais fundamentais (isso e do chief)
+- ❌ NAO pode rejeitar o briefing (isso e do CEO)
+
+## Poderes do Chief
+
+- ✅ Tudo que supervisor pode
+- ✅ Mudar decisoes arquiteturais da area
+- ✅ Coordenar entre multiplos supervisores
+- ✅ Detectar drift de visao
+- ✅ Escalar pra CEO em casos extremos
+- ❌ NAO pode rejeitar o briefing original
+- ❌ NAO pode decidir entregar com score baixo (isso e do CEO + dono)
+
+## Poderes do CEO
+
+- ✅ Tudo que chief pode
+- ✅ Rejeitar briefing inviavel
+- ✅ Interromper dono quando necessario (3 niveis de severidade)
+- ✅ Aprovar delivery final
+- ✅ Negociar com dono sobre trade-offs
+- ✅ Veto final em qualquer decisao
+
+---
+
+## Accountability
+
+Cada aprovacao fica registrada em `.plano/governance/approvals.log`:
+
+```
+2026-04-10T16:30:00Z | E3.3.2 | execution-supervisor | APPROVE | SUMMARY verified
+2026-04-10T16:45:00Z | E3.3.6 | chief-engineer | APPROVE | Phase 3 integrated
+2026-04-10T17:00:00Z | E4.10 | chief-quality | REQUEST_CHANGES | Security issues pending
+2026-04-10T17:15:00Z | E5.4 | project-ceo | APPROVE_DELIVERY | Confidence 96%
+```
+
+Cada rework fica em `.plano/governance/reworks.log`:
+
+```
+2026-04-10T16:20:00Z | E3.3.1 | planning-supervisor | REQUEST_CHANGES | cycle 1/3
+  → reason: Plan lacks imports and type definitions (Sonnet-ready)
+  → action: Re-spawned up-planejador with enrichment instructions
+```
+
+Cada escalacao fica em `.plano/governance/escalations.log`:
+
+```
+2026-04-10T17:30:00Z | E4.5 | audit-supervisor → chief-quality
+  → reason: Security review found 3 critical vulnerabilities
+  → decision: chief-quality approved rework with priority
+```
+
+---
+
+## Anti-Patterns
+
+**NAO APROVAR SE:**
+- Trabalho nao foi de fato verificado (so "parece que ta ok")
+- Evidencia esta faltando ou ambigua
+- Ha claim sem backing (SUMMARY diz X mas codigo nao tem)
+- Rework cycle ja atingiu max sem melhoria
+
+**REJEITAR SEMPRE SE:**
+- Violacao de engineering-principles.md
+- Stub/placeholder onde deveria ter implementacao real
+- Inconsistencia com fases anteriores
+- Falta de wiring (componente criado mas nao conectado)

package/references/rework-limits.md

@@ -0,0 +1,162 @@
+# Rework Limits
+
+Limites de ciclos de rework antes de forcar aprovacao com debito tecnico.
+
+---
+
+## Limites por Nivel
+
+| Nivel | Max Ciclos | Acao apos limite |
+|-------|-----------|------------------|
+| Operacional ← Supervisor | **3** | Forca aprovacao, registra como debito tecnico |
+| Supervisor ← Chief | **2** | Escalacao pro CEO |
+| Chief ← CEO | **1** | CEO decide: aceitar como esta ou alertar dono |
+
+---
+
+## Ciclo Operacional ← Supervisor
+
+### Ciclo 1: Primeira rejeicao
+```
+Operacional entrega trabalho
+  ↓
+Supervisor revisa
+  ↓
+REQUEST_CHANGES
+  ↓
+Supervisor manda feedback especifico
+  ↓
+Operacional refaz
+```
+
+### Ciclo 2: Segunda tentativa
+```
+Operacional entrega trabalho (v2)
+  ↓
+Supervisor revisa
+  ↓
+Se APPROVE: prossegue
+Se REQUEST_CHANGES: ciclo 3
+```
+
+### Ciclo 3: Ultima tentativa
+```
+Operacional entrega trabalho (v3)
+  ↓
+Supervisor revisa
+  ↓
+Se APPROVE: prossegue
+Se REQUEST_CHANGES: FORCA aprovacao com ressalva
+```
+
+### Apos Max Ciclos
+
+```
+Supervisor registra em governance/technical-debt.log:
+  - Item: [item-id]
+  - Ciclos esgotados: 3
+  - Issues restantes: [lista]
+  - Decisao: FORCED_APPROVAL
+  - Razao: Max rework cycles reached
+  
+Item marcado no CHECKLIST como:
+  status: completed_with_debt
+  
+Trabalho prossegue, mas aparece no AUDIT-REPORT como ressalva.
+```
+
+---
+
+## Ciclo Supervisor ← Chief
+
+### Ciclo 1
+```
+Supervisor aprovou trabalho
+  ↓
+Chief revisa consolidado da area
+  ↓
+Se APPROVE: prossegue
+Se REQUEST_CHANGES: volta pro supervisor com feedback
+Se ESCALATE: pula pro CEO
+```
+
+### Ciclo 2
+```
+Supervisor coordena rework
+  ↓
+Chief re-revisa
+  ↓
+Se APPROVE: prossegue
+Se REQUEST_CHANGES: ESCALATE pro CEO automaticamente
+```
+
+---
+
+## Ciclo Chief ← CEO
+
+### Ciclo 1 (unico)
+```
+Chief aprovou
+  ↓
+CEO revisa (antes do delivery)
+  ↓
+Se APPROVE_DELIVERY: prossegue
+Se REWORK: volta pro chief responsavel
+Se ALERTA_DONO: CEO pergunta ao dono o que fazer
+```
+
+### Apos rework unico
+```
+Chief refaz
+  ↓
+CEO re-revisa
+  ↓
+Se APPROVE_DELIVERY: prossegue
+Se ainda NEEDS_REWORK: CEO alerta dono obrigatoriamente
+```
+
+---
+
+## Quando forcar aprovacao
+
+**Criterios:**
+- Max ciclos atingido
+- Melhoria entre ciclos < 10% (diminishing returns)
+- Issue nao pode ser resolvida sem info externa
+
+**Acao:**
+1. Registrar como debito tecnico
+2. Documentar no AUDIT-REPORT
+3. Adicionar ao PENDING.md se virou pendencia
+4. Alertar CEO (que decide se alerta dono)
+
+---
+
+## Anti-Patterns
+
+**NAO FAZER:**
+- Loops infinitos esperando perfeicao
+- Aprovar sem rework quando claramente ha problema
+- Rejeitar sem feedback especifico e acionavel
+- Escalar sem tentar resolver no proprio nivel
+
+**FAZER:**
+- Feedback especifico: "Mude X para Y porque Z"
+- Ciclos com melhoria mensuravel
+- Aceitar debito tecnico documentado
+- Comunicar trade-offs claramente
+
+---
+
+## Metrica: Rework Rate
+
+Agentes com rework rate alto (>40%) sao candidatos a ajuste:
+- Prompt pode estar vago
+- Criterios muito rigidos
+- Supervisor mal calibrado
+
+Agentes com rework rate muito baixo (<5%) podem estar:
+- Aprovando sem criterio
+- Supervisor nao esta sendo critico o suficiente
+
+**Target saudavel:** 15-30% de rework rate

package/references/severity-levels.md

@@ -0,0 +1,189 @@
+# Severity Levels
+
+Niveis de severidade usados pelo CEO para decidir quando interromper o dono.
+Carregado pelo up-project-ceo.
+
+---
+
+## 🔴 CRITICO — Sempre Interrompe
+
+Situacoes que SEMPRE requerem input do dono, independente de configuracao.
+
+### Exemplos
+
+- **Credencial expirada durante build**
+  - API key Supabase expirou
+  - Token GitHub invalido
+  - OAuth precisa renovar
+
+- **Erro irrecuperavel em dependencia externa**
+  - API externa retorna 500 consistentemente
+  - Package no npm foi descontinuado
+  - Servico crashed e nao volta
+
+- **Conflito arquitetural irreversivel**
+  - Mudanca que afeta decisoes previas
+  - Quebra de compatibilidade significativa
+  - Escolha de stack que muda rumo do projeto
+
+- **Custo de tokens excedeu limite**
+  - Projeto consumiu mais que o budget configurado
+  - Risco de continuar sem aprovacao
+
+- **Build falhando apos 5 tentativas**
+  - Specialist nao consegue corrigir
+  - Specialist escalou pro chief
+  - Chief nao conseguiu resolver
+
+- **Ambiguidade de negocio que muda direcao**
+  - Briefing contradiz premissas
+  - Descoberta durante execucao revela que o projeto e outra coisa
+  - Duvida fundamental sobre o que construir
+
+### Formato da Interrupcao
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ 🔴 CRITICO — {nome_ceo} precisa do seu input
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{nome_dono}, precisei parar. Situacao:
+
+**O que aconteceu:**
+[descricao clara]
+
+**Por que nao posso decidir sozinho:**
+[explicacao]
+
+**Opcoes:**
+a) [opcao 1]
+b) [opcao 2]
+c) [opcao 3]
+
+**Minha recomendacao:** [opcao + porque]
+
+Qual voce prefere?
+```
+
+---
+
+## 🟡 IMPORTANTE — Interrompe em modo interactive
+
+Situacoes que perguntam ao dono APENAS se a flag `--interactive` estiver ativa.
+Senao, o CEO decide sozinho e registra como decisao delegada.
+
+### Exemplos
+
+- **Feature inferida que pode ser equivocada**
+  - Briefing menciona "sistema de notificacoes" mas nao diz email/push/in-app
+  - CEO infere "in-app" mas dono pode querer email
+
+- **Trade-off arquitetural significativo**
+  - Escolha entre 2 bibliotecas validas (ex: Zustand vs Redux)
+  - Performance vs simplicidade
+
+- **Escolha de biblioteca com impacto de longo prazo**
+  - ORM especifico
+  - Framework de teste
+  - Design system base
+
+- **Pendente que vai virar bloqueador em producao**
+  - Ex: "Credencial Resend nao foi passada. Em dev funciona com mock, mas em producao vai falhar."
+
+### Formato da Interrupcao
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ 🟡 IMPORTANTE — {nome_ceo} tem uma decisao pra tomar
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{nome_dono}, situacao:
+
+[descricao]
+
+**Opcoes viáveis:**
+a) [opcao 1] — [pros/contras]
+b) [opcao 2] — [pros/contras]
+
+**Minha recomendacao:** [opcao]
+**Por que:** [explicacao]
+
+Voce confirma? Ou prefere outra opcao?
+```
+
+---
+
+## 🟢 FYI — So Registra, Nao Interrompe
+
+Decisoes que o CEO toma sozinho e apenas registra em `.plano/OWNER.md`.
+Nao interrompe o dono em nenhum modo.
+
+### Exemplos
+
+- **Decisao tomada com base em defaults**
+  - Stack ja definida no owner-profile
+  - Padrao da industria obvio
+
+- **Pequenos ajustes de escopo dentro do briefing**
+  - Reorganizacao de fases
+  - Ordem de implementacao
+
+- **Feature inferida obvia**
+  - CRUD basico em todo modulo
+  - Loading states
+  - Error handling
+  - Responsive
+
+### Formato de Registro
+
+```markdown
+## Feedback Durante Execucao (em OWNER.md)
+
+| Timestamp | Feedback | Acao tomada |
+|-----------|----------|-------------|
+| [YYYY-MM-DD HH:MM] | 🟢 Inferencia automatica | Adicionei loading state em todas paginas |
+```
+
+---
+
+## Configuracao por Usuario
+
+O dono pode customizar quais niveis interrompem via `owner-profile.md`:
+
+```yaml
+interruption_preferences:
+  critical: always       # sempre interrompe
+  important: interactive # so em modo --interactive
+  fyi: never            # nunca interrompe
+```
+
+Defaults:
+- Se `updates: verbose` → important interrompe
+- Se `updates: normal` → so critical interrompe
+- Se `updates: silent` → so critical interrompe (e mesmo assim, pergunta breve)
+
+---
+
+## Escalacao
+
+Se a interrupcao tem timeout (usuario nao responde):
+
+- **Critico:** espera indefinidamente (nao prossegue sem resposta)
+- **Importante:** default 10min, depois decide sozinho com recomendacao
+- **FYI:** nunca espera
+
+---
+
+## Anti-Patterns
+
+**NAO INTERROMPER POR:**
+- Coisas que voce pode decidir com base em defaults
+- Decisoes que ja foram tomadas implicitamente no briefing
+- Detalhes de implementacao (escolha de nome de variavel, estrutura de pasta)
+- Erros que voce mesmo pode resolver
+
+**SEMPRE INTERROMPER POR:**
+- Coisas que mudam o rumo do projeto
+- Decisoes irreversiveis
+- Situacoes sem boa opcao default
+- Descobertas que o dono provavelmente nao sabia

package/templates/audit-report.md

@@ -0,0 +1,118 @@
+# AUDIT-REPORT.md Template
+
+Template para `.plano/AUDIT-REPORT.md` — relatorio do Delivery Auditor.
+Gerado no Estagio 4.5, antes do Delivery.
+
+<template>
+
+```markdown
+---
+audited_at: ""
+auditor: up-delivery-auditor
+confidence_score: 0
+quality_score: 0
+recommendation: PENDING | READY_FOR_DELIVERY | NEEDS_REWORK | BLOCKED
+rework_cycle: 0
+max_cycles: 3
+---
+
+# Audit Report
+
+**Scores:**
+- **Confidence Score:** {N}/100 — completude do processo
+- **Quality Score:** {N}/10 — qualidade do codigo (do Quality Gate)
+
+**Recomendacao:** {status}
+
+---
+
+## Completude por Estagio
+
+| Estagio | Items | Completed | Missing | Score |
+|---------|-------|-----------|---------|-------|
+| Intake | {N} | {N} | {N} | {%} |
+| Arquitetura | {N} | {N} | {N} | {%} |
+| Build | {N} | {N} | {N} | {%} |
+| Quality Gate | {N} | {N} | {N} | {%} |
+| Audit | {N} | {N} | {N} | {%} |
+| Delivery | {N} | {N} | {N} | {%} |
+| **TOTAL** | **{N}** | **{N}** | **{N}** | **{%}** |
+
+---
+
+## Items Pendentes
+
+### Criticos (blockers)
+- [item-id] [descricao] — [por que bloqueia]
+
+### Importantes
+- [item-id] [descricao]
+
+### Menores
+- [item-id] [descricao]
+
+---
+
+## Inconsistencias Detectadas
+
+Cruzamento entre relatorios revelou:
+
+### INC-001: [Titulo]
+- **Tipo:** [inconsistencia-entre-agentes | score-divergente | claim-sem-evidencia]
+- **Agentes envolvidos:** [lista]
+- **Descricao:** [o que foi encontrado]
+- **Evidencia:** [paths dos relatorios conflitantes]
+- **Resolucao sugerida:** [como resolver]
+
+---
+
+## Aprovacoes Faltantes
+
+Items que nao receberam aprovacao de supervisor/chief:
+
+| Item | Esperado | Atual |
+|------|----------|-------|
+| [item-id] | chief-engineer APPROVE | pending |
+
+---
+
+## Rework Plan (se NEEDS_REWORK)
+
+Acoes ordenadas por prioridade:
+
+1. **[acao 1]** — [por que] → [agente responsavel]
+2. **[acao 2]** — [por que] → [agente responsavel]
+3. **[acao 3]** — [por que] → [agente responsavel]
+
+Apos rework, re-rodar auditor. Max ciclos: {max_cycles}. Ciclo atual: {rework_cycle}.
+
+---
+
+## Delivery Readiness
+
+### Checklist Final
+
+- [ ] Confidence Score >= 95%
+- [ ] Zero inconsistencias nao-resolvidas
+- [ ] Todas aprovacoes obtidas
+- [ ] Pending assets documentados
+- [ ] DELIVERY.md pronto pra ser gerado
+
+### Veredito
+
+**{READY_FOR_DELIVERY | NEEDS_REWORK | BLOCKED}**
+
+[Justificativa em 1-2 paragrafos]
+
+---
+
+## Historico de Ciclos
+
+| Ciclo | Confidence | Issues | Resolvidas | Status |
+|-------|-----------|--------|-----------|--------|
+| 1 | {N}% | {N} | {N} | [status] |
+| 2 | {N}% | {N} | {N} | [status] |
+| 3 | {N}% | {N} | {N} | [status] |
+```
+
+</template>