up-cc 0.4.5 → 0.5.0

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>

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>