up-cc 0.3.3 → 0.4.0

package/references/state-persistence.md

@@ -0,0 +1,74 @@
+# Persistência de Estado entre Sessões
+
+<purpose>
+Instruções para Claude Code salvar estado do projeto automaticamente, mesmo fora de comandos /up:.
+Quando o projeto tem `.plano/STATE.md`, TODA sessão produtiva deve registrar o que foi feito.
+</purpose>
+
+## Regra Principal
+
+Se o diretório `.plano/` existe com `STATE.md`, você DEVE salvar o estado da sessão ao final de trabalho significativo — independente de ter usado comandos `/up:` ou não.
+
+**Trabalho significativo** = qualquer coisa que mude o projeto de forma relevante:
+- Correção de bugs
+- Implementação de features (parcial ou completa)
+- Refatoração
+- Decisões de arquitetura
+- Debug e investigação com conclusões
+- Configuração de infra/deploy
+
+**NÃO é significativo** (não precisa salvar):
+- Leitura exploratória sem conclusão
+- Perguntas conceituais
+- Revisão sem alterações
+
+## Como Salvar
+
+Um único comando faz tudo (atualiza timestamp, descrição, atividade, e commita):
+
+```bash
+node "$HOME/.claude/up/bin/up-tools.cjs" state save-session --summary "descrição do que foi feito"
+```
+
+**Se houve decisão importante:**
+
+```bash
+node "$HOME/.claude/up/bin/up-tools.cjs" state save-session \
+  --summary "descrição do que foi feito" \
+  --decision "decisão tomada e por quê" \
+  --phase 2
+```
+
+**Se não quer commitar automaticamente:**
+
+```bash
+node "$HOME/.claude/up/bin/up-tools.cjs" state save-session --summary "descrição" --no-commit
+```
+
+## Quando Salvar
+
+1. **Final da conversa** — quando o trabalho está concluído ou pausado
+2. **Após resolver um bug** — mesmo que veio de continuação pós-agente
+3. **Após implementar algo** — mesmo parcialmente
+4. **Antes de sugerir /clear** — salvar estado garante continuidade
+
+## O que Escrever no --summary
+
+Seja específico e útil para a próxima sessão:
+
+- BOM: "Corrigido bug de autenticação — token expirado não redirecionava para login. Alterado middleware em src/auth.ts"
+- BOM: "Implementado componente de filtro de datas. Falta integrar com API de relatórios"
+- RUIM: "Feitas correções"
+- RUIM: "Trabalhado no projeto"
+
+## Integração com CLAUDE.md do Projeto
+
+Quando `/up:novo-projeto` ou `/up:modo-builder` inicializa um projeto, adicionar ao CLAUDE.md do projeto:
+
+```markdown
+## UP: Persistência de Estado
+
+Este projeto usa o sistema UP. Se `.plano/STATE.md` existir:
+- Ao final de trabalho significativo, salvar estado: `node "$HOME/.claude/up/bin/up-tools.cjs" state save-session --summary "o que foi feito"`
+- Isso garante continuidade entre sessões mesmo sem usar comandos /up:
+```

package/templates/builder-defaults.md

@@ -0,0 +1,73 @@
+# Builder Defaults Template
+
+Template para `~/.claude/up/builder-defaults.md` -- decisoes padrao do usuario para o modo builder.
+O usuario customiza uma vez e vale para todos os projetos criados com `/up:modo-builder`.
+
+<template>
+
+```markdown
+# Builder Defaults
+
+## Stack Padrao
+- Frontend: Next.js 15 (App Router) + Tailwind CSS + shadcn/ui
+- Backend: Supabase (Auth + Database + Edge Functions)
+- Linguagem: TypeScript (strict mode)
+- Package manager: pnpm
+- Testes: Vitest + Playwright
+
+## Decisoes de Design
+- Design system: shadcn/ui (tema neutro, customizar cores por projeto)
+- Responsividade: mobile-first
+- Dark mode: sim, com toggle
+- Fonte: Inter (UI) + JetBrains Mono (code)
+
+## Decisoes de Codigo
+- API: tRPC quando Next.js, REST quando Python/FastAPI
+- Auth: Supabase Auth
+- Validacao: Zod
+- Estado client: Zustand
+- Forms: React Hook Form + Zod resolver
+- ORM/DB: Supabase client (sem ORM adicional)
+
+## Padroes
+- Estrutura: feature-based (src/features/*)
+- Commits: conventional commits
+- Linter: ESLint + Prettier
+- Git: branch main, commits diretos
+
+## Nao usar
+- (liste aqui tecnologias que voce NAO quer em nenhum projeto)
+```
+
+</template>
+
+<guidelines>
+
+**Como o builder usa este arquivo:**
+
+1. Lido no inicio do modo builder (Estagio 1 - Intake)
+2. Qualquer decisao do briefing do usuario SOBRESCREVE os defaults
+3. Se o usuario especifica "usar Vue", o default de Next.js e ignorado
+4. Se o usuario NAO especifica frontend, o default de Next.js e usado
+5. A secao "Nao usar" e SEMPRE respeitada (nunca sobrescrita)
+
+**Hierarquia de decisao:**
+```
+Briefing do usuario (maior prioridade)
+  > Respostas das perguntas criticas
+    > builder-defaults.md do usuario
+      > Inferencia inteligente do sistema (menor prioridade)
+```
+
+**Inferencia inteligente (quando nao ha default nem briefing):**
+- Dominio financeiro → sugere tabelas, graficos, exportacao
+- Dominio social → sugere real-time, notificacoes, feeds
+- Dominio e-commerce → sugere pagamentos, carrinho, inventario
+- Dominio educacao → sugere progresso, quiz, certificados
+
+**O que NAO colocar nos defaults:**
+- Credenciais ou tokens (passados no briefing)
+- Decisoes especificas de projeto (schemas, nomes de tabelas)
+- Preferencias que mudam por projeto (cores, branding)
+
+</guidelines>

package/templates/delivery.md

@@ -0,0 +1,279 @@
+# Delivery Report Template
+
+Template para `.plano/DELIVERY.md` -- relatorio de entrega final gerado pelo modo builder.
+
+<template>
+
+```markdown
+# Entrega: [Nome do Projeto]
+
+## Resumo
+
+[O que foi construido em 2-3 frases. Descrever o produto, nao o processo.]
+
+## Quality Score
+
+**Score Final: [N]/10** (apos [X] ciclos de refinamento)
+
+| Dimensao | Score | Peso |
+|----------|-------|------|
+| Funcionalidade | [N]/10 | 25% |
+| E2E | [N]/10 | 20% |
+| UX | [N]/10 | 15% |
+| Responsividade | [N]/10 | 15% |
+| Codigo | [N]/10 | 15% |
+| Completude | [N]/10 | 10% |
+
+**Ciclos de refinamento:** [N]
+**Score inicial:** [N]/10 → **Score final:** [N]/10
+
+## Stack Utilizada
+
+| Camada | Tecnologia | Versao |
+|--------|-----------|--------|
+| Frontend | [framework] | [versao] |
+| Backend | [framework/servico] | [versao] |
+| Database | [banco] | [versao] |
+| Auth | [metodo] | -- |
+| Deploy | [plataforma] | -- |
+
+## O que foi Entregue
+
+[Para cada fase completada:]
+
+### Fase [N]: [Nome]
+- [Entregavel 1]
+- [Entregavel 2]
+- [Entregavel 3]
+
+## Requisitos Atendidos
+
+**[X] de [Y] requisitos completos**
+
+### Completos
+- [x] [REQ-ID]: [Descricao]
+
+### Pendentes (se houver)
+- [ ] [REQ-ID]: [Descricao] -- [motivo]
+
+## Testes E2E (Playwright)
+
+[Resultados do teste E2E final — de .plano/e2e/E2E-REPORT.md]
+
+### Rotas Testadas
+
+| Rota | Status | Screenshot |
+|------|--------|------------|
+| / | OK | .plano/e2e/smoke/index.png |
+| /dashboard | OK | .plano/e2e/smoke/dashboard.png |
+
+**Rotas acessiveis:** [N]/[M]
+
+### Fluxos E2E
+
+| Fluxo | Passos | Resultado |
+|-------|--------|-----------|
+| [Nome do fluxo 1] | [N] | PASSOU |
+| [Nome do fluxo 2] | [N] | FALHOU no passo [X] |
+
+### Responsividade
+
+| Viewport | Screenshot | Status |
+|----------|-----------|--------|
+| Desktop (1920x1080) | .plano/e2e/responsive/desktop.png | OK |
+| Tablet (768x1024) | .plano/e2e/responsive/tablet.png | [status] |
+| Mobile (375x812) | .plano/e2e/responsive/mobile.png | [status] |
+
+### Bugs Encontrados nos Testes
+
+| # | Descricao | Severidade | Corrigido? |
+|---|-----------|-----------|-----------|
+| 1 | [bug] | [alta/media/baixa] | Sim/Nao |
+
+**Total:** [N] bugs encontrados, [M] corrigidos automaticamente
+
+### Testes Pendentes de Credenciais
+
+[Testes que o builder nao conseguiu executar por precisar de credenciais/acesso do usuario]
+
+| O que testar | Credencial necessaria | Como obter | Prioridade |
+|-------------|----------------------|-----------|-----------|
+| [ex: Integração Instagram] | [Cookie de sessão] | [Login manual no Playwright] | [Alta/Media] |
+
+**Instrucoes:** Para testar manualmente, rode `/up:ux-tester` ou `/up:verificar-trabalho` apos configurar as credenciais acima.
+
+Relatorio completo: `.plano/e2e/E2E-REPORT.md`
+Screenshots: `.plano/e2e/`
+
+## UX Review (Navegacao como Usuario Real)
+
+[Resultados do UX Tester — de .plano/ux-review/UX-REPORT.md]
+
+**Score Geral:** [N]/10
+
+| Dimensao | Score |
+|----------|-------|
+| Clareza | [N]/10 |
+| Eficiencia | [N]/10 |
+| Feedback | [N]/10 |
+| Consistencia | [N]/10 |
+| Acessibilidade | [N]/10 |
+| Performance Percebida | [N]/10 |
+
+### Melhorias UX Implementadas
+
+| ID | Melhoria | Dimensao |
+|----|----------|----------|
+| UX-001 | [descricao] | [dimensao] |
+| UX-002 | [descricao] | [dimensao] |
+
+**Implementadas:** [N] (incluindo componentes novos e ajustes de fluxo)
+**Tentativas falhas (revertidas):** [N]
+
+### Tentativas Falhas
+[Mudancas que o UX Tester tentou mas reverteu por quebrar funcionalidade]
+
+Relatorio completo: `.plano/ux-review/UX-REPORT.md`
+Screenshots: `.plano/ux-review/screenshots/`
+
+## Responsividade Mobile (Mobile First)
+
+[Resultados do Mobile First — de .plano/mobile-review/MOBILE-REPORT.md]
+
+**Score de Responsividade:** [N]/10
+
+| Viewport | Paginas OK | Problemas | Corrigidos |
+|----------|-----------|-----------|-----------|
+| Mobile (390px) | [N] | [N] | [N] |
+| Tablet (768px) | [N] | [N] | [N] |
+| Desktop (1920px) | [N] (referencia) | -- | -- |
+
+### Correcoes Implementadas
+
+| ID | Problema | Pagina | Fix |
+|----|---------|--------|-----|
+| MOB-001 | [desc] | [rota] | [o que foi feito] |
+
+**Desktop intacto:** Verificado apos cada correcao
+
+Relatorio completo: `.plano/mobile-review/MOBILE-REPORT.md`
+Screenshots: `.plano/mobile-review/screenshots/`
+
+## Insights Capturados Durante o Build
+
+[Insights descobertos pelos agentes durante a execucao — de .plano/captures/TRIAGE.md]
+
+### Criticos
+[Problemas que precisam de atencao imediata]
+
+### Alertas
+[Problemas potenciais detectados]
+
+### Oportunidades
+[Melhorias e features descobertas organicamente durante o build]
+
+### Padroes
+[Padroes identificados no codebase que podem informar futuras decisoes]
+
+**Total:** [N] insights capturados durante [M] fases
+
+Triagem completa: `.plano/captures/TRIAGE.md`
+
+## Melhorias Aplicadas
+
+[Lista das melhorias do Estagio 4 - Polish, se executado]
+
+| ID | Melhoria | Dimensao | Impacto |
+|----|----------|----------|---------|
+| MELH-001 | [descricao] | UX/Perf/Mod | [resultado] |
+
+## Proximos Passos (Ideias Geradas)
+
+[Top 5 ideias do /up:ideias, ordenadas por ICE score]
+
+1. **[Ideia 1]** -- ICE: [score] | [descricao breve]
+2. **[Ideia 2]** -- ICE: [score] | [descricao breve]
+3. **[Ideia 3]** -- ICE: [score] | [descricao breve]
+4. **[Ideia 4]** -- ICE: [score] | [descricao breve]
+5. **[Ideia 5]** -- ICE: [score] | [descricao breve]
+
+Relatorio completo: `.plano/ideias/RELATORIO.md`
+
+## Como Rodar
+
+### Pre-requisitos
+- Node.js >= [versao]
+- [Outros pre-requisitos]
+
+### Setup
+\`\`\`bash
+[comandos de instalacao]
+\`\`\`
+
+### Variaveis de Ambiente
+\`\`\`bash
+# Copiar .env.example para .env e preencher:
+[VAR_1]=          # [descricao]
+[VAR_2]=          # [descricao]
+\`\`\`
+
+### Desenvolvimento
+\`\`\`bash
+[comando para rodar em dev]
+\`\`\`
+
+### Build
+\`\`\`bash
+[comando para build de producao]
+\`\`\`
+
+## Metricas do Build
+
+| Metrica | Valor |
+|---------|-------|
+| Fases completadas | [N] |
+| Planos executados | [N] |
+| Commits | [N] |
+| Testes unitarios | [N] passando |
+| Rotas E2E testadas | [N]/[M] OK |
+| Fluxos E2E testados | [N]/[M] passaram |
+| Bugs E2E encontrados | [N] ([M] corrigidos) |
+| UX Score | [N]/10 |
+| Melhorias UX implementadas | [N] |
+| Responsividade Score | [N]/10 |
+| Problemas mobile corrigidos | [N] |
+| Insights capturados | [N] |
+| Reassessments | [N] ajustes no roadmap |
+| Melhorias codigo aplicadas | [N] |
+| Ideias geradas | [N] |
+
+---
+*Gerado automaticamente por UP modo-builder em [data]*
+```
+
+</template>
+
+<guidelines>
+
+**Preenchimento:**
+- Secoes preenchidas automaticamente pelo workflow builder.md
+- Dados extraidos de: ROADMAP.md, REQUIREMENTS.md, SUMMARYs, E2E-REPORT.md, RELATORIO.md (melhorias e ideias)
+- "Como Rodar" inferido do stack + package.json + env vars usados
+
+**Se testes E2E nao executaram:**
+- Secao "Testes E2E" mostra: "Testes E2E nao executados (projeto sem UI ou dev server falhou)"
+
+**Se UX Review nao executou:**
+- Secao "UX Review" mostra: "UX Review nao executado (projeto sem UI ou dev server falhou)"
+
+**Se nao ha captures:**
+- Secao "Insights Capturados" mostra: "Nenhum insight capturado durante o build"
+
+**Se estagio Polish nao executou:**
+- Secao "Melhorias Aplicadas" mostra: "Estagio de polimento nao executado"
+- Secao "Proximos Passos" mostra: "Ideacao nao executada"
+
+**Se requisitos pendentes:**
+- Listar com motivo (falha na verificacao, complexidade, bloqueio externo)
+
+</guidelines>