up-cc 0.3.3 → 0.4.1

package/commands/modo-builder.md

@@ -0,0 +1,178 @@
+---
+name: up:modo-builder
+description: Construir projeto completo de forma autonoma — greenfield (do zero) ou brownfield (feature nova em projeto existente)
+argument-hint: "[--light] [descricao do projeto ou feature]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - WebFetch
+  - WebSearch
+  - AskUserQuestion
+  - mcp__context7__*
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+Modo Builder: construir projeto completo de forma totalmente autonoma.
+
+Detecta automaticamente o modo:
+- **Greenfield** (sem codigo existente): cria projeto do zero
+- **Brownfield** (codigo existente): mapeia codebase, planeja e implementa feature/mudanca
+
+**Dois niveis de execucao:**
+- **Full (padrao):** Pipeline completo com pesquisa, polish, UX review, ideias, delivery
+- **Light (`--light`):** Pipeline enxuto — planeja, constroi, testa. Sem gordura. Ideal para features medias em projetos existentes.
+
+O usuario fornece um briefing, responde perguntas criticas (apenas sobre credenciais/APIs/ambiguidades), e o sistema faz TUDO sozinho.
+
+**Modo Full (padrao):**
+1. Detecta modo → Pesquisa/Mapeia → Estrutura → Planeja → Executa → Verifica → E2E
+2. Polish (melhorias + UX tester + ideias) → DELIVERY.md
+
+**Modo Light (`--light`):**
+1. Detecta modo → Mini-scan → Estrutura inline → Planeja → Executa → Verifica → E2E
+2. Fim. Sem polish, sem delivery, sem pesquisa pesada.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/builder.md
+@~/.claude/up/workflows/builder-e2e.md
+@~/.claude/up/workflows/ux-tester.md
+@~/.claude/up/workflows/mobile-first.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Flags:**
+- `--light` — Modo enxuto. Pula pesquisa, polish, UX tester, ideias, delivery, reassessment, captures. Mantém: planejar, executar, verificar, E2E Playwright.
+
+O restante do argumento e o briefing em texto livre. Pode incluir:
+
+**Greenfield (projeto novo):**
+- O que quer construir
+- Para quem (publico)
+- Stack desejada (ou usa builder-defaults.md)
+- Features principais
+- Credenciais/APIs que ja tem
+
+**Brownfield (projeto existente):**
+- Que feature/mudanca quer implementar
+- Como se integra com o existente
+- Novas APIs/integrações necessarias
+- Restricoes ou areas que nao devem ser tocadas
+
+Se $ARGUMENTS estiver vazio (alem de flags), o workflow pedira o briefing interativamente.
+
+**Deteccao automatica:** Se ha codigo existente no diretorio (package.json, src/, etc.) ou .plano/ existente, o builder entra em modo brownfield automaticamente.
+
+**Defaults:** Lidos de `~/.claude/up/builder-defaults.md` (se existir).
+Em brownfield, convencoes do codebase existente tem prioridade sobre defaults.
+</context>
+
+<process>
+**Parsear flags primeiro:** Extrair `--light` dos $ARGUMENTS se presente. O restante e o briefing.
+
+**Se `--light`:**
+Execute o builder workflow em modo light (ver secao `<light_mode>` no workflow).
+Estagios: 1 (Intake simplificado) → 2 (Mini-scan + estrutura inline) → 3 (Build + E2E) → Fim.
+
+**Se modo full (padrao):**
+Execute the builder workflow from @~/.claude/up/workflows/builder.md end-to-end.
+
+**CRITICO:** A partir do Estagio 2, ZERO interacao com usuario. NAO use AskUserQuestion apos coletar o briefing e respostas criticas. Toda decisao e tomada autonomamente.
+
+**Modo Full — Preserve all workflow gates:**
+- Estagio 1: Intake (detectar modo + briefing + perguntas criticas)
+- Estagio 2: Arquitetura (mapear codebase OU pesquisar ecossistema + up-arquiteto)
+- Estagio 3: Build (loop planejar → executar → verificar → E2E por fase)
+- Estagio 4: Polish (melhorias + quick wins + UX tester + ideias)
+- Estagio 5: Entrega (E2E final + captures + DELIVERY.md + resumo)
+
+Falhas sao contornadas, nunca bloqueiam. O builder SEMPRE entrega algo.
+</process>
+
+<light_mode>
+## Modo Light — Pipeline Enxuto
+
+Quando `--light` esta presente, o builder roda um pipeline minimalista:
+
+### Estagio 1 Light: Intake Rapido
+
+1. Detectar modo (greenfield/brownfield) — mesmo processo
+2. Receber briefing
+3. Perguntas criticas — SIM, mesma logica (so perguntar o essencial)
+4. **NAO carregar builder-defaults.md** — usar stack do codebase (brownfield) ou inferir (greenfield)
+
+### Estagio 2 Light: Estrutura Inline
+
+**Brownfield:**
+- Se `.plano/codebase/` existe e tem < 7 dias: reutilizar
+- Se nao existe: mini-scan inline (sem spawnar 4 agentes mapeadores):
+  ```bash
+  # Mini-scan rapido
+  ls package.json requirements.txt pyproject.toml 2>/dev/null
+  cat package.json 2>/dev/null | head -50
+  ls -d src/ app/ lib/ pages/ components/ 2>/dev/null | head -10
+  find . -name "*.ts" -o -name "*.tsx" | head -30
+  ```
+- **Estruturar inline** (sem spawnar up-arquiteto):
+  - Criar/atualizar PROJECT.md com briefing e contexto minimo
+  - Criar/atualizar REQUIREMENTS.md com requisitos da feature
+  - Criar/atualizar ROADMAP.md com 1-3 fases max
+  - config.json com `builder_mode: true, builder_type: light`
+
+**Greenfield:**
+- **Pular pesquisa** (sem 4 pesquisadores paralelos)
+- Estruturar inline com inferencia inteligente
+- 2-5 fases max
+
+### Estagio 3 Light: Build + E2E
+
+Mesmo loop do full, mas:
+- **Sem LOCK.md** (sessao curta, nao precisa de crash recovery)
+- **Sem reassessment** (poucas fases, nao vale a pena)
+- **Sem captures** (sessao curta)
+- **COM teste E2E Playwright** (se tem UI) — mesmo processo do full
+
+### Sem Estagio 4 (Polish)
+
+Nao roda melhorias, UX tester, nem ideias.
+
+### Sem Estagio 5 (Entrega)
+
+Nao gera DELIVERY.md. Apenas exibe resumo inline:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ UP > BUILDER LIGHT — COMPLETO
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+**Feature:** [resumo]
+**Fases:** [N] completadas
+**Commits:** [N]
+**E2E:** [N] testes, [X] passaram
+**Bugs E2E:** [N] encontrados, [M] corrigidos
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+### Comparacao de Tokens (estimativa)
+
+| Etapa | Full | Light |
+|-------|------|-------|
+| Pesquisa (4 agentes) | ~80k tokens | 0 |
+| Mapeamento (4 agentes) | ~60k tokens | ~5k (mini-scan) |
+| Arquiteto (agente) | ~40k tokens | ~10k (inline) |
+| Build (por fase) | ~100k tokens | ~100k tokens |
+| E2E (por fase) | ~30k tokens | ~30k tokens |
+| Polish (7+ agentes) | ~150k tokens | 0 |
+| Delivery | ~20k tokens | 0 |
+| **Total (3 fases)** | **~680k** | **~345k** (~50% menos) |
+
+</light_mode>

package/commands/ux-tester.md

@@ -0,0 +1,63 @@
+---
+name: up:ux-tester
+description: Navegar o sistema como usuario real, avaliar experiencia em 6 dimensoes e implementar melhorias automaticamente
+argument-hint: "[url ou porta] [--no-fix]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+  - mcp__plugin_playwright_playwright__*
+---
+<objective>
+UX Tester: abrir o sistema no browser, navegar como usuario real, avaliar a experiencia em 6 dimensoes (clareza, eficiencia, feedback, consistencia, acessibilidade, performance percebida) e implementar melhorias automaticamente.
+
+NAO e teste funcional. E um auditor de experiencia que USA o sistema e pensa como pessoa real:
+- "Esse botao ta no lugar errado"
+- "Pra fazer X preciso de 5 cliques, deveria ser 2"
+- "Cadê o feedback quando eu submeto?"
+- "Essa tela ta confusa, nao sei o que fazer"
+- "O loading ta lento aqui"
+
+**Standalone:** Funciona em qualquer projeto, qualquer momento. NAO requer /up:novo-projeto ou .plano/.
+**Builder:** Tambem integrado no modo builder (Estagio 4 — Polish).
+
+**Output:** `.plano/ux-review/UX-REPORT.md` com issues priorizadas + melhorias implementadas com commits atomicos + screenshots antes/depois.
+</objective>
+
+<execution_context>
+@~/.claude/up/workflows/ux-tester.md
+@~/.claude/up/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+**Argumentos opcionais:**
+- URL ou porta: `http://localhost:3000` ou `3000` (default: detecta automaticamente)
+- `--no-fix`: Apenas gerar relatorio, NAO implementar melhorias
+
+**Se sem argumentos:** Detecta stack, sobe dev server automaticamente, usa porta padrao.
+
+**Se .plano/ existe:** Usa PROJECT.md e REQUIREMENTS.md para entender fluxos.
+**Se .plano/ NAO existe:** Descobre fluxos explorando codigo e navegando.
+
+**Cria .plano/ux-review/ automaticamente** (standalone, sem pre-requisitos).
+</context>
+
+<process>
+Execute the ux-tester workflow from @~/.claude/up/workflows/ux-tester.md end-to-end.
+
+Preserve all workflow gates:
+1. Setup (detectar stack, subir server, descobrir fluxos, definir personas)
+2. Navegacao como usuario (avaliar 6 dimensoes com screenshots)
+3. Gerar UX-REPORT.md com issues priorizadas
+4. Implementar melhorias (a menos que --no-fix)
+5. Cleanup (matar server, fechar browser)
+
+**Flag --no-fix:** Se presente, pular Passo 4 (implementacao). Apenas gerar relatorio.
+</process>

package/package.json

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

package/references/blueprints/audit.md

@@ -0,0 +1,29 @@
+# Blueprint: Audit & Activity Logs
+
+Aplicar quando: sistema tem roles/permissoes, dados sensiveis, ou necessidade de rastreabilidade.
+Recomendado para TODO sistema com multiplos usuarios.
+
+---
+
+## Logs de Atividade (LOG)
+
+- LOG-01: Registrar acoes importantes: criar, editar, deletar, alterar status, alterar permissao
+- LOG-02: Cada log contem: quem, o que, quando, detalhes da mudanca
+- LOG-03: Pagina de logs acessivel para admin
+- LOG-04: Filtro por usuario, tipo de acao, data
+- LOG-05: Busca por texto
+- LOG-06: Paginacao (server-side, logs podem ser muitos)
+- LOG-07: Retencao: definir periodo (ex: 90 dias)
+- LOG-08: Nao editavel/deletavel (append-only)
+
+## Auditoria de Dados (AUDIT)
+
+- AUDIT-01: Historico de alteracoes por registro (quem mudou o que, quando)
+- AUDIT-02: Diff visual (valor anterior → novo valor)
+- AUDIT-03: Acessivel na pagina de detalhes do registro
+
+## Sessoes (SESSION)
+
+- SESSION-01: Listar sessoes ativas do usuario (dispositivo, IP, ultimo acesso)
+- SESSION-02: Revogar sessao especifica
+- SESSION-03: Revogar todas as sessoes (exceto atual)

package/references/blueprints/booking.md

@@ -0,0 +1,49 @@
+# Blueprint: Booking & Scheduling
+
+Aplicar quando: "agendar", "reservar", "barbearia", "clinica", "salao", "consultorio", "horario", "calendario".
+
+---
+
+## Calendario (CAL)
+
+- CAL-01: Visualizacao de calendario (dia, semana, mes)
+- CAL-02: Slots de horario visiveis com disponibilidade
+- CAL-03: Cores por status (disponivel, ocupado, bloqueado)
+- CAL-04: Navegacao entre datas (setas, date picker)
+- CAL-05: Visualizacao por profissional/recurso
+- CAL-06: Drag & drop para remarcar (desktop)
+- CAL-07: Responsivo (lista no mobile, grid no desktop)
+
+## Agendamento (BOOKING)
+
+- BOOKING-01: Fluxo de criacao: servico → profissional → data/hora → confirmar
+- BOOKING-02: Mostrar apenas horarios disponiveis
+- BOOKING-03: Duracao automatica baseada no servico
+- BOOKING-04: Conflito detectado antes de confirmar
+- BOOKING-05: Confirmacao com resumo (servico, data, hora, profissional, preco)
+- BOOKING-06: Cancelamento com motivo (pelo cliente ou pelo negocio)
+- BOOKING-07: Remarcacao (mover para outro horario)
+- BOOKING-08: Status do agendamento: confirmado, em andamento, concluido, cancelado, no-show
+
+## Disponibilidade (AVAIL)
+
+- AVAIL-01: Horario de funcionamento configuravel por dia da semana
+- AVAIL-02: Bloqueio de horarios especificos (ferias, folga, almoco)
+- AVAIL-03: Disponibilidade por profissional individual
+- AVAIL-04: Tempo de intervalo entre agendamentos (buffer)
+- AVAIL-05: Feriados (bloquear dias)
+
+## Lembretes (REMIND)
+
+- REMIND-01: Lembrete 24h antes (email ou WhatsApp)
+- REMIND-02: Confirmacao automatica apos agendamento (email)
+- REMIND-03: Notificacao de cancelamento
+- REMIND-04: Preferencias de notificacao por cliente
+
+## Servicos (SERVICE)
+
+- SERVICE-01: CRUD de servicos (nome, descricao, duracao, preco)
+- SERVICE-02: Categorias de servicos
+- SERVICE-03: Ativar/desativar servico (sem deletar)
+- SERVICE-04: Imagem do servico (opcional)
+- SERVICE-05: Preco variavel por profissional (opcional)

package/references/blueprints/community.md

@@ -0,0 +1,48 @@
+# Blueprint: Community & Courses
+
+Aplicar quando: "comunidade", "membros", "curso", "aulas", "assinatura", "conteudo pago", "area de membros".
+
+---
+
+## Planos & Acesso (PLAN)
+
+- PLAN-01: Planos com niveis de acesso (gratis, basico, premium)
+- PLAN-02: Conteudo gated por plano (cadeado visual no bloqueado)
+- PLAN-03: Upgrade/downgrade de plano
+- PLAN-04: Trial period (opcional)
+- PLAN-05: Billing integration (Stripe, Asaas)
+- PLAN-06: Pagina de precos com comparacao de planos
+
+## Conteudo (CONTENT)
+
+- CONTENT-01: Modulos/secoes hierarquicas (curso → modulo → aula)
+- CONTENT-02: Tipos de conteudo: video, texto, quiz, arquivo
+- CONTENT-03: Progresso por usuario (% concluido, aula atual)
+- CONTENT-04: Marcar como concluido (checkbox ou auto-apos-video)
+- CONTENT-05: Barra de progresso visual
+- CONTENT-06: Sequencia (liberar aulas em ordem ou todas abertas)
+- CONTENT-07: Admin: CRUD de conteudo (criar, editar, reordenar)
+
+## Comunidade (COMM)
+
+- COMM-01: Feed de posts/discussoes
+- COMM-02: Comentarios em conteudo
+- COMM-03: Perfil de membro (foto, bio, plano)
+- COMM-04: Likes/reacoes
+- COMM-05: Mencoes (@usuario)
+- COMM-06: Moderacao (aprovar, remover, banir)
+- COMM-07: Topicos/categorias
+
+## Certificados (CERT)
+
+- CERT-01: Certificado de conclusao (PDF gerado)
+- CERT-02: Template customizavel (logo, nome do curso, data)
+- CERT-03: URL publica de verificacao
+- CERT-04: Gerado automaticamente ao completar 100%
+
+## Gamificacao (GAME)
+
+- GAME-01: Pontos/XP por atividade (assistir aula, completar quiz)
+- GAME-02: Badges/conquistas
+- GAME-03: Ranking/leaderboard (opcional)
+- GAME-04: Streak de dias consecutivos

package/references/blueprints/crm.md

@@ -0,0 +1,40 @@
+# Blueprint: CRM & Sales
+
+Aplicar quando: "CRM", "clientes", "pipeline", "vendas", "leads", "funil", "contatos".
+
+---
+
+## Contatos (CONTACT)
+
+- CONTACT-01: Cadastro de contato (nome, email, telefone, empresa)
+- CONTACT-02: Campos customizaveis (tags, segmento, origem)
+- CONTACT-03: Busca e filtro avancado
+- CONTACT-04: Import CSV de contatos
+- CONTACT-05: Export de contatos
+- CONTACT-06: Merge de contatos duplicados
+- CONTACT-07: Historico de interacoes por contato
+
+## Pipeline (PIPELINE)
+
+- PIPELINE-01: Kanban visual de pipeline (arrastar entre estagios)
+- PIPELINE-02: Estagios customizaveis (nome, cor, ordem)
+- PIPELINE-03: Card de deal (valor, contato, etapa, responsavel)
+- PIPELINE-04: Filtros por responsavel, valor, data
+- PIPELINE-05: Valor total por estagio
+- PIPELINE-06: Conversao entre estagios (metricas de funil)
+
+## Atividades (ACTIVITY)
+
+- ACTIVITY-01: Registrar atividades (ligacao, email, reuniao, nota)
+- ACTIVITY-02: Tarefas com data de vencimento e responsavel
+- ACTIVITY-03: Lembretes de follow-up
+- ACTIVITY-04: Timeline de atividades por contato/deal
+- ACTIVITY-05: Atividades pendentes na dashboard
+
+## Relatorios (REPORT)
+
+- REPORT-01: Receita por periodo
+- REPORT-02: Conversao por estagio do funil
+- REPORT-03: Performance por vendedor
+- REPORT-04: Tempo medio por estagio
+- REPORT-05: Previsao de receita (pipeline value × probabilidade)

package/references/blueprints/dashboard.md

@@ -0,0 +1,48 @@
+# Blueprint: Dashboard & Analytics
+
+Aplicar quando: "dashboard", "painel", "metricas", "KPIs", "relatorios", "analytics", "gestor".
+
+---
+
+## KPIs & Cards (KPI)
+
+- KPI-01: Cards de metricas principais no topo (3-6 KPIs)
+- KPI-02: Cada card mostra: valor atual, variacao vs periodo anterior (% e seta)
+- KPI-03: Cores semanticas: verde=crescimento, vermelho=queda, cinza=neutro
+- KPI-04: Skeleton loading individual por card
+- KPI-05: Tooltip com detalhes ao hover
+
+## Graficos (CHART)
+
+- CHART-01: Pelo menos 1 grafico de linha/area (tendencia temporal)
+- CHART-02: Pelo menos 1 grafico de barra ou pizza (distribuicao)
+- CHART-03: Graficos responsivos (redimensionam com o container)
+- CHART-04: Tooltip interativo ao hover nos pontos
+- CHART-05: Legenda clicavel (toggle series)
+- CHART-06: Empty state quando sem dados
+- CHART-07: Loading skeleton para graficos
+
+## Filtros (FILTER)
+
+- FILTER-01: Date range picker (hoje, 7d, 30d, 90d, custom)
+- FILTER-02: Filtros persistem na URL (compartilhavel)
+- FILTER-03: Filtros persistem entre sessoes (localStorage)
+- FILTER-04: Botao "limpar filtros"
+- FILTER-05: Filtros por categoria/segmento relevante ao dominio
+
+## Tabelas de Dados (TABLE)
+
+- TABLE-01: Tabela com sort por coluna (click no header)
+- TABLE-02: Busca/filtro inline
+- TABLE-03: Paginacao (server-side para datasets grandes)
+- TABLE-04: Export CSV/PDF
+- TABLE-05: Selecao multipla com bulk actions
+- TABLE-06: Responsiva (scroll horizontal ou card layout em mobile)
+- TABLE-07: Loading skeleton rows
+
+## Refresh & Realtime (REFRESH)
+
+- REFRESH-01: Botao de refresh manual
+- REFRESH-02: Indicador de "ultima atualizacao: X min atras"
+- REFRESH-03: Auto-refresh configuravel (a cada 5min, desligavel)
+- REFRESH-04: Realtime updates se stack suporta (Supabase Realtime, WebSocket)

package/references/blueprints/data-management.md

@@ -0,0 +1,42 @@
+# Blueprint: Data Management
+
+Aplicar quando: sistema tem listas de dados, tabelas, registros que o usuario precisa gerenciar.
+Praticamente TODO sistema com CRUD precisa deste blueprint.
+
+---
+
+## CRUD Avancado (CRUD)
+
+- CRUD-01: Listagem com busca por texto
+- CRUD-02: Filtros por campo (status, categoria, data, responsavel)
+- CRUD-03: Ordenacao por coluna (click no header)
+- CRUD-04: Paginacao (server-side para > 100 registros)
+- CRUD-05: Selecao multipla (checkboxes)
+- CRUD-06: Bulk actions (deletar selecionados, alterar status, exportar)
+- CRUD-07: Criar registro (modal ou pagina dedicada)
+- CRUD-08: Editar registro (inline ou modal ou pagina)
+- CRUD-09: Deletar com confirmacao
+- CRUD-10: Soft delete (desativar, nao deletar permanentemente)
+
+## Import/Export (IO)
+
+- IO-01: Export CSV (filtros aplicados)
+- IO-02: Export PDF (relatorio formatado)
+- IO-03: Import CSV (com preview e validacao antes de importar)
+- IO-04: Template de CSV para download (formato esperado)
+- IO-05: Feedback de progresso durante import
+
+## Busca Avancada (SEARCH)
+
+- SEARCH-01: Busca global (barra de busca no header, cmd+k)
+- SEARCH-02: Resultados agrupados por tipo (clientes, pedidos, etc.)
+- SEARCH-03: Busca com debounce (300ms)
+- SEARCH-04: Historico de buscas recentes
+- SEARCH-05: Atalho de teclado (Cmd+K / Ctrl+K)
+
+## Filtros Persistentes (FILT)
+
+- FILT-01: Filtros salvos na URL (compartilhavel)
+- FILT-02: Filtros salvos pelo usuario (favoritos)
+- FILT-03: Botao "limpar filtros"
+- FILT-04: Contador de resultados apos filtrar

package/references/blueprints/ecommerce.md

@@ -0,0 +1,51 @@
+# Blueprint: E-commerce
+
+Aplicar quando: "loja", "produtos", "carrinho", "checkout", "pedidos", "inventario", "vender online".
+
+---
+
+## Catalogo (CATALOG)
+
+- CATALOG-01: Listagem de produtos com grid/lista toggle
+- CATALOG-02: Busca por nome/descricao
+- CATALOG-03: Filtros por categoria, preco, disponibilidade
+- CATALOG-04: Ordenacao (preco, nome, mais vendidos, mais recentes)
+- CATALOG-05: Pagina de detalhes do produto (imagens, descricao, preco, variacoes)
+- CATALOG-06: Galeria de imagens com zoom/carousel
+- CATALOG-07: Produtos relacionados
+- CATALOG-08: Badge de estoque (em estoque, ultimas unidades, esgotado)
+
+## Carrinho (CART)
+
+- CART-01: Adicionar ao carrinho com feedback visual
+- CART-02: Mini-cart (dropdown ou sidebar)
+- CART-03: Pagina do carrinho (itens, quantidades, subtotais)
+- CART-04: Alterar quantidade e remover item
+- CART-05: Carrinho persistente (localStorage ou banco)
+- CART-06: Resumo com subtotal, frete, desconto, total
+- CART-07: Cupom de desconto
+
+## Checkout (CHECKOUT)
+
+- CHECKOUT-01: Checkout em steps (dados → endereco → pagamento → confirmacao)
+- CHECKOUT-02: Dados do cliente (nome, email, telefone)
+- CHECKOUT-03: Endereco de entrega (com CEP e auto-complete)
+- CHECKOUT-04: Metodos de pagamento (cartao, pix, boleto)
+- CHECKOUT-05: Resumo final antes de confirmar
+- CHECKOUT-06: Pagina de confirmacao com numero do pedido
+- CHECKOUT-07: Email de confirmacao automatico
+
+## Pedidos (ORDER)
+
+- ORDER-01: Meus pedidos (historico do cliente)
+- ORDER-02: Detalhes do pedido (itens, status, rastreamento)
+- ORDER-03: Status do pedido (pendente, pago, enviado, entregue, cancelado)
+- ORDER-04: Admin: gestao de pedidos (listar, filtrar por status, atualizar)
+- ORDER-05: Notificacao de mudanca de status
+
+## Inventario (STOCK)
+
+- STOCK-01: Controle de estoque por produto/variacao
+- STOCK-02: Alerta de estoque baixo
+- STOCK-03: Nao permitir venda de produto sem estoque
+- STOCK-04: Historico de movimentacao

package/references/blueprints/marketplace.md

@@ -0,0 +1,48 @@
+# Blueprint: Marketplace
+
+Aplicar quando: "marketplace", "plataforma", "dois lados", "compradores e vendedores", "freelancers", "servicos".
+
+---
+
+## Dois Lados (SIDES)
+
+- SIDES-01: Registro diferenciado (comprador vs vendedor/prestador)
+- SIDES-02: Dashboard diferente por tipo de usuario
+- SIDES-03: Perfil publico do vendedor (portfolio, avaliacoes, servicos)
+- SIDES-04: Perfil do comprador (historico, avaliacoes dadas)
+
+## Listagem & Busca (SEARCH)
+
+- SEARCH-01: Busca com autocomplete
+- SEARCH-02: Filtros avancados (categoria, preco, localizacao, avaliacao)
+- SEARCH-03: Ordenacao (relevancia, preco, avaliacao, distancia)
+- SEARCH-04: Mapa (se localizacao relevante)
+- SEARCH-05: Resultados paginados com skeleton loading
+- SEARCH-06: Busca salva / alertas
+
+## Avaliacoes (REVIEW)
+
+- REVIEW-01: Rating por estrelas (1-5)
+- REVIEW-02: Review em texto
+- REVIEW-03: Apenas quem comprou pode avaliar
+- REVIEW-04: Resposta do vendedor
+- REVIEW-05: Media de avaliacoes no perfil/listagem
+- REVIEW-06: Denunciar review falsa
+
+## Messaging (MSG)
+
+- MSG-01: Chat entre comprador e vendedor
+- MSG-02: Inbox com lista de conversas
+- MSG-03: Notificacao de nova mensagem
+- MSG-04: Historico de mensagens persistente
+- MSG-05: Anexos (imagens, documentos)
+
+## Transacoes (TX)
+
+- TX-01: Proposta/orcamento
+- TX-02: Aceitar/recusar proposta
+- TX-03: Pagamento via plataforma (escrow)
+- TX-04: Liberacao do pagamento apos conclusao
+- TX-05: Disputa/mediacao
+- TX-06: Historico de transacoes
+- TX-07: Comissao da plataforma (configuravel)

package/references/blueprints/notifications.md

@@ -0,0 +1,32 @@
+# Blueprint: Notifications
+
+Aplicar quando: sistema tem usuarios ativos que precisam ser informados de eventos.
+Praticamente TODO sistema com auth precisa deste blueprint.
+
+---
+
+## In-App (NOTIF)
+
+- NOTIF-01: Sino de notificacao com badge de contagem (nao lidas)
+- NOTIF-02: Dropdown/painel de notificacoes
+- NOTIF-03: Marcar como lida (individual e "marcar todas")
+- NOTIF-04: Tipos visiveis: info, sucesso, alerta, erro
+- NOTIF-05: Link para a acao/pagina relevante
+- NOTIF-06: Timestamp relativo ("5 min atras", "ontem")
+- NOTIF-07: Paginacao (carregar mais antigas)
+- NOTIF-08: Realtime (nova notificacao aparece sem refresh)
+
+## Email (EMAIL)
+
+- EMAIL-01: Template de email transacional (branding consistente)
+- EMAIL-02: Email de boas-vindas apos signup
+- EMAIL-03: Email de confirmacao para acoes criticas
+- EMAIL-04: Email de reset de senha
+- EMAIL-05: Opcao de unsubscribe em cada email
+
+## Preferencias (PREF)
+
+- PREF-01: Pagina de preferencias de notificacao
+- PREF-02: Toggle por tipo de notificacao (on/off)
+- PREF-03: Toggle por canal (in-app, email, push)
+- PREF-04: Defaults razoaveis (tudo ligado, ajusta se quiser)