up-cc 0.4.6 → 0.5.1

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>

package/workflows/ceo-updates.md

@@ -0,0 +1,183 @@
+<purpose>
+Workflow do CEO pra mandar updates periodicos ao dono durante execucao do projeto.
+
+Chamado pelo builder apos cada fase concluida (se updates != silent).
+</purpose>
+
+<process>
+
+## Quando rodar
+
+- Apos cada fase do build completar
+- Apos Quality Gate completar
+- Apos Delivery Auditor rodar
+- Em qualquer momento critico
+
+## Carregar contexto
+
+```bash
+cat ~/.claude/up/owner-profile.md
+cat .plano/OWNER.md
+cat .plano/STATE.md
+cat .plano/ROADMAP.md
+```
+
+Extrair:
+- `$PREFERRED_NAME`
+- `$CEO_NAME`
+- `$CEO_TONE`
+- `$UPDATES_LEVEL` (verbose | normal | silent)
+
+**Se `$UPDATES_LEVEL = silent`:** Pular updates por fase. Voltar pro builder.
+
+## Formato do Update (por fase)
+
+### Verbose (detalhado)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ {CEO_NAME}: Update — Fase {X}/{TOTAL} concluida
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Fase {X}:** {nome da fase}
+
+**O que foi feito:**
+- [bullet 1 — resumo do que foi construido]
+- [bullet 2]
+- [bullet 3]
+
+**Qualidade:**
+- Testes E2E: {passed}/{total} ({%})
+- DCRV Score: {score}/10
+  - Visual: {N}/10
+  - Interacao: {N}% pass
+  - API: {N}% pass
+- Code Review: {N} issues ({critical} critical, {high} high)
+- Supervisores: {N} aprovacoes, {M} reworks
+
+**Decisoes Tomadas:**
+- [decisao 1]
+- [decisao 2]
+
+**Proxima Fase ({X+1}):**
+- {nome}
+- {N} planos estimados
+- {M} tarefas
+
+**Progresso Total:** {%} ({phases_done}/{total_phases})
+
+Continuar? (enter pra seguir, ou digita feedback)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Normal (resumido)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ {CEO_NAME}: Fase {X}/{TOTAL} ✓
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{nome da fase} concluida.
+{testes} testes, {passed}% pass.
+
+Proxima: {nome proxima fase}
+Progresso: {%}
+
+(enter pra continuar)
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Silent (nao manda nada)
+
+Pular.
+
+## Formato Alerta Critico (qualquer modo)
+
+Se ha 🔴 CRITICO, interrompe SEMPRE:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ 🔴 {CEO_NAME}: Preciso do seu input
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{PREFERRED_NAME}, precisei parar.
+
+**Situacao:**
+[descricao clara]
+
+**Por que nao posso decidir sozinho:**
+[explicacao]
+
+**Opcoes:**
+a) [opcao 1]
+b) [opcao 2]
+c) [opcao 3]
+
+**Minha recomendacao:** {opcao} — {justificativa curta}
+
+Qual voce prefere?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Usar `AskUserQuestion` para capturar resposta.
+
+## Formato Alerta Importante (modo interactive)
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ 🟡 {CEO_NAME}: Decisao a tomar
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+{PREFERRED_NAME}, situacao:
+
+[descricao]
+
+**Opcoes viaveis:**
+a) [opcao] — {pros/contras}
+b) [opcao] — {pros/contras}
+
+**Minha recomendacao:** {opcao}
+**Por que:** {explicacao}
+
+Voce confirma? Ou prefere outra?
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+Se `$INTERACTIVE = true` ou `$UPDATES_LEVEL = verbose`: perguntar via AskUserQuestion.
+Senao: tomar decisao recomendada e registrar em OWNER.md como "Decisao delegada".
+
+## Formato FYI (nao interrompe)
+
+Registrar em `.plano/OWNER.md` na secao "Feedback Durante Execucao":
+
+```markdown
+| {timestamp} | 🟢 Decisao automatica | {decisao} |
+```
+
+Nao falar nada pro dono.
+
+## Registrar Interacao
+
+Toda vez que CEO fala com dono, registrar em `.plano/OWNER.md`:
+
+```markdown
+## Interacoes com o CEO
+
+| Timestamp | Tipo | Conteudo |
+|-----------|------|----------|
+| {timestamp} | update-verbose | Fase 3 concluida — dashboard |
+| {timestamp} | alerta-critico | Credencial Asaas expirou |
+| {timestamp} | alerta-importante | Trade-off: Redis vs in-memory |
+| {timestamp} | fyi | Adicionei loading states automaticamente |
+```
+
+</process>
+
+<success_criteria>
+- [ ] Owner-profile lido
+- [ ] Nivel de updates respeitado (verbose/normal/silent)
+- [ ] Tom correto usado
+- [ ] Severidade respeitada (critico sempre interrompe)
+- [ ] Interacao registrada em OWNER.md
+- [ ] Formato apropriado aplicado
+</success_criteria>

package/workflows/governance.md

@@ -0,0 +1,237 @@
+<purpose>
+Workflow de governanca do UP. Define o loop de aprovacao operacional → supervisor → chief → CEO.
+
+Usado por todos os comandos UP que executam trabalho.
+</purpose>
+
+<process>
+
+## Loop de Governanca (Nivel Supervisor)
+
+### Passo 1: Operacional executa trabalho
+
+Qualquer agente operacional (planejador, executor, verificador, detector, auditor, etc.) completa sua tarefa e retorna output.
+
+### Passo 2: Supervisor correspondente revisa
+
+Determinar supervisor baseado no agente operacional:
+
+| Operacional | Supervisor |
+|------------|-----------|
+| planejador, roteirista | planning-supervisor |
+| executor, frontend/backend/database-specialist | execution-supervisor |
+| verificador, blind-validator | verification-supervisor |
+| visual-critic, exhaustive-tester, api-tester, qa-agent | quality-supervisor |
+| auditor-ux/perf/modernidade, security-reviewer, sintetizador-melhorias | audit-supervisor |
+| product-analyst, pesquisadores, mapeador-codigo | product-supervisor |
+| arquiteto, system-designer, requirements-validator | architecture-supervisor |
+| devops-agent, technical-writer | operations-supervisor |
+
+Spawnar o supervisor:
+
+```python
+Agent(
+  subagent_type="up-{supervisor_name}",
+  model="opus",
+  prompt="""
+    Revisar output de {operacional_name} para {context}.
+    
+    <files_to_read>
+    - $HOME/.claude/up/references/governance-rules.md
+    - $HOME/.claude/up/references/rework-limits.md
+    - [arquivos do output do operacional]
+    - [arquivos de contexto]
+    </files_to_read>
+    
+    Avaliar contra criterios objetivos.
+    Retornar: APPROVE | REQUEST_CHANGES | ESCALATE
+  """
+)
+```
+
+### Passo 3: Processar decisao do supervisor
+
+**Se APPROVE:**
+- Marcar item como completed no CHECKLIST
+- Logar em governance/approvals.log
+- Prosseguir pro proximo passo do pipeline
+
+**Se REQUEST_CHANGES:**
+- Incrementar rework_cycle do item
+- Se cycle < 3: re-spawnar operacional com review como contexto
+- Se cycle = 3: FORCA aprovacao com debito tecnico, registrar e prosseguir
+
+```python
+# Re-spawn do operacional
+Agent(
+  subagent_type="up-{operacional_name}",
+  model="{modelo correto}",
+  prompt="""
+    REWORK — Ciclo {N}/3
+    
+    Seu output anterior foi revisado e precisa de mudancas.
+    
+    Review: .plano/{path_do_review}
+    
+    Mudancas requeridas:
+    {lista_de_mudancas}
+    
+    Refaca seu trabalho atendendo os criterios.
+  """
+)
+```
+
+**Se ESCALATE:**
+- Supervisor nao consegue resolver, passa pro chief
+- Spawnar chief correspondente
+
+```python
+Agent(
+  subagent_type="up-chief-{area}",
+  model="opus",
+  prompt="""
+    Escalation recebida do {supervisor_name}.
+    
+    Problema: {problema}
+    Contexto: {files_to_read}
+    
+    Decidir: APPROVE | REQUEST_CHANGES | ESCALATE_CEO
+  """
+)
+```
+
+## Loop de Governanca (Nivel Chief)
+
+### Quando chief age
+
+Chief age em 2 situacoes:
+
+1. **Escalacao do supervisor** — problema que supervisor nao resolveu
+2. **Aprovacao consolidada** — revisao periodica do trabalho de uma area inteira
+
+### Ciclos de Rework (Chief ← Supervisor)
+
+Max 2 ciclos:
+
+```
+Ciclo 1: Chief pede rework → Supervisor coordena com operacional
+Ciclo 2: Chief re-revisa → APPROVE ou ESCALATE_CEO
+```
+
+## Loop de Governanca (Nivel CEO)
+
+### Quando CEO age
+
+1. **Escalacao do chief** — problema que chief nao resolveu
+2. **Pre-delivery** — auditoria final antes de entregar
+3. **Decisao estrategica** — briefing ambiguo, trade-off grande
+
+### Ciclos (CEO ← Chief)
+
+Max 1 ciclo:
+
+```
+Ciclo 1: CEO pede rework → Chief coordena com supervisores
+Apos isso: CEO decide APPROVE ou ALERTA_DONO
+```
+
+### Se CEO decide ALERTA_DONO
+
+CEO usa severidade apropriada:
+- 🔴 Critico: sempre interrompe via AskUserQuestion
+- 🟡 Importante: interrompe se --interactive
+- 🟢 FYI: apenas registra
+
+## Forced Approval (Debito Tecnico)
+
+Quando max ciclos atingido sem melhoria:
+
+```bash
+# Registrar
+cat >> .plano/governance/technical-debt.log <<EOF
+$(date -u +%Y-%m-%dT%H:%M:%SZ) | {item-id} | {supervisor} | FORCED_APPROVAL
+  Reason: Max rework cycles ({N}) reached without improvement
+  Remaining issues: [lista]
+EOF
+
+# Atualizar checklist
+node "$HOME/.claude/up/bin/up-tools.cjs" checklist update \
+  --item "{item-id}" \
+  --status "completed_with_debt"
+```
+
+Items com `completed_with_debt` aparecem no AUDIT-REPORT.md como ressalva.
+
+## Aplicacao em Cada Comando UP
+
+### /up:modo-builder (Full)
+- Governanca COMPLETA em todos estagios
+- CEO conduz intake e delivery
+- Supervisores em cada passo
+- Chiefs consolidam
+- CEO aprova antes do delivery
+
+### /up:modo-builder --light
+- Governanca LIGHT
+- Supervisores ainda ativos (criticos)
+- Chiefs pulados
+- CEO so no intake e delivery
+- Max rework: 1 ciclo
+
+### /up:rapido
+- Governanca MINIMAL
+- Apenas supervisor do operacional
+- Sem chief, sem CEO
+- Max rework: 1 ciclo
+
+### /up:planejar-fase
+- planning-supervisor ativo
+- Sem chief
+- Sem CEO
+
+### /up:executar-fase
+- execution-supervisor ativo
+- chief-engineer no final da fase
+- Sem CEO
+
+### /up:testar
+- quality-supervisor ativo
+- chief-quality no final
+- Sem CEO
+
+### /up:melhorias
+- audit-supervisor ativo
+- chief-quality no final
+
+### /up:verificar-trabalho
+- verification-supervisor ativo
+- Sem chief (UAT humano ja e autoritativo)
+
+## Flag Global: --no-supervision
+
+Para casos emergenciais onde voce precisa bypassar governanca:
+
+```
+/up:modo-builder "feature urgente" --no-supervision
+```
+
+Efeito:
+- Supervisores nao rodam
+- Nenhum rework
+- Trabalho direto pro proximo estagio
+- **Tudo registrado como SKIPPED_SUPERVISION no delivery**
+
+Use APENAS em emergencia. Governanca existe por um motivo.
+
+</process>
+
+<success_criteria>
+- [ ] Supervisor correspondente identificado
+- [ ] Supervisor spawnado com contexto correto
+- [ ] Decisao processada
+- [ ] Rework cycles respeitados
+- [ ] Escalacoes corretas
+- [ ] Forced approval com debito tecnico registrado
+- [ ] Checklist atualizado em cada passo
+- [ ] Governance logs mantidos
+</success_criteria>