Uma rubrica para medir se um estranho entende o seu produto em 5 segundos e chega ao valor em 2 minutos. Serve para auditar o que já está no ar e para escrever o plano do que você vai construir.
SmartView é um modelo em texto, pronto para copiar, que mede se um produto digital se explica sozinho. Serve para quem cria sistemas, apps ou sites, com ou sem agentes de IA. Você usa de dois jeitos: como diagnóstico de um sistema que já existe, ou como seção do PRD (o documento de requisitos) de um sistema que ainda vai nascer. No fim sai uma nota com número, letra e cor, e uma lista curta do que corrigir e do que remover. Não precisa instalar nada: é só ler e preencher, ou pedir para o Claude Code ou o Codex rodar a skill.
Vem aí uma enxurrada de produtos e pouquíssimos pensados. O cuidado com o que a pessoa vê é o que separa o seu.
Para sistema pronto: teste dos 5 segundos, caminho até o primeiro valor cronometrado, inventário de elementos e plano de correção de no máximo 7 itens.
Para sistema em desenvolvimento: 10 portões que dizem se vale construir e requisitos de experiência testáveis, com critério de pronto da versão 1.
Uma skill que o Claude Code ou o Codex segue para abrir o sistema, simular personas, medir os tempos e devolver o diagnóstico preenchido.
As 6 perguntas olham cada botão, campo e tela. Os 10 testes olham o produto inteiro. As duas viram uma nota única.
| # | Pergunta | Conta como "sim" quando |
|---|---|---|
| E1 | Um estranho sabe dizer o nome disso? | Descreve o elemento com as próprias palavras, sem tutorial. |
| E2 | Sabe o que acontece quando apertar? | O rótulo diz ação e resultado ("Verificar este site"), não "Enviar". |
| E3 | O padrão está certo para a maioria? | O valor que já vem serve para 8 em cada 10 pessoas. |
| E4 | Reage de forma visível em um compasso? | Algo muda na tela em até ~300 ms. |
| E5 | Cai onde prometeu? | Depois da ação, a pessoa está onde o rótulo dizia. |
| E6 | Alguém sentiria falta se sumisse? | Se tirar e ninguém reclamar, ninguém precisava. Somar subtraindo. |
Um estranho vê a primeira tela por 5 s e diz o que o produto faz. Se errar, a nota trava em D.
Colou um link de repositório? O botão vira "Verificar este repositório". A tela mostra que aguenta o que você deu.
Se a pessoa espera o botão mudar, você já explicou a piada.
Checagens nomeadas marcando ✓ uma a uma, como um antivírus. A espera vira música de elevador.
Alguns segundos de atividade e um resultado parcial que abre curiosidade. Só depois pede o e-mail.
Uma pessoa pouco técnica, sozinha, prova o valor para si mesma com o menor número de cliques.
Resultado que se lê de relance e que dá para mandar por print.
Quem já é usuário vai para o próprio espaço, nunca de volta para a página de venda.
Cada caminho de entrada traz OAuth, troca de senha, termos e cookies que têm de funcionar para sempre.
Componentes de referências que já funcionam no nicho, não o padrão médio do modelo nem invenção do zero.
Para usar no papel, nada. Para o agente rodar sozinho, a skill e um navegador.
Um editor de texto. Os modelos estão em Markdown na pasta modelo/.
git clone https://github.com/inematds/smartview
Copie a skill para a pasta de skills do usuário.
cp -r smartview/skill/smartview ~/.claude/skills/O Codex lê skills da pasta de agentes do usuário.
cp -r smartview/skill/smartview ~/.agents/skills/Os passos 1 a 4 são para sistema pronto. Se o sistema ainda é plano, vá direto ao passo 5.
Se não cabe em uma linha, o resto da rubrica vai doer. "Antivírus para apps feitos com IA" é melhor que "o Uber de X".
# no topo de modelo/diagnostico.md Promessa em uma linha: "________________"
Mostre a primeira tela por 5 s a 3 pessoas de fora e pergunte "o que isso faz?". Sem pessoas à mão, peça ao agente 3 personas: uma pessoa de 55 anos pouco técnica, um jovem impaciente que testou 100 produtos esta semana e um especialista do nicho.
# no Claude Code ou Codex, com a skill instalada diagnóstico smartview de https://meusistema.com: comece pelo teste dos 5 segundos com 3 personas
Faça o caminho como pessoa nova. Anote cada passo, o tempo até a tela reagir e quando o sistema pede e-mail, login ou cartão. Meta: reação abaixo de 300 ms e valor provado em menos de 2 minutos.
# no console do navegador: tempo entre o clique e a primeira mudança na tela const t0=performance.now(); new MutationObserver((m,o)=>{console.log(Math.round(performance.now()-t0)+' ms');o.disconnect()}).observe(document.body,{subtree:true,childList:true,characterData:true,attributes:true}) # rode a linha acima e clique no botão logo em seguida
Preencha a tabela de elementos (2 / 1 / 0 por pergunta) e os 10 testes (10 / 5 / 0). Quem tirar 0 em "faria falta?" vai para a lista de remover, não de melhorar.
SmartView = 0,6 × média dos testes de sistema + 0,4 × média dos elementos
# S1 = 0 limita a nota final a D
Copie modelo/prd-secao.md para o seu plano. A parte A (10 portões) diz se vale construir; a parte B vira requisitos testáveis; a parte C é o critério de pronto da versão 1.
cat smartview/modelo/prd-secao.md >> docs/PRD.md # ou peça ao agente: adiciona a seção smartview no docs/PRD.md; o que o plano não responder, marque como pergunta aberta
Guarde um guia de marca curto (cores, fonte, tom, 3 referências do nicho) no AGENTS.md ou CLAUDE.md, gere a tela em imagem e aprove antes de construir. Antes do lançamento, repita os testes S1 e S6 com as personas.
# critério de pronto da versão 1
SmartView ≥ 75 (B · verde-claro), com S1 = 10 e S6 = 10
Marque os 10 testes de sistema. A nota aqui considera só essa camada; no diagnóstico completo ela vale 60% e os elementos, 40%.
Marque os testes ao lado.
Versão 1 é texto e skill. O resto entra conforme o uso mostrar.