Diagnóstico · PRD · skill para agentes

Un buen producto no necesita ser explicado

Una rúbrica para medir si un extraño entiende tu producto en 5 segundos y llega al valor en 2 minutos. Sirve para auditar lo que ya está en línea y para escribir el plan de lo que vas a construir.

Banner SmartView: inteligencia visible, el producto que se explica solo
En resumen

SmartView es un modelo en texto, listo para copiar, que mide si un producto digital se explica solo. Sirve para quien crea sistemas, apps o sitios, con o sin agentes de IA. Lo usas de dos maneras: como diagnóstico de un sistema que ya existe, o como sección del PRD (el documento de requisitos) de un sistema que aún va a nacer. Al final sale una nota con número, letra y color, y una lista corta de lo que hay que corregir y de lo que hay que quitar. No necesitas instalar nada: basta leer y completar, o pedirle a Claude Code o a Codex que ejecute la skill.

Qué es

Acortar la distancia entre el pensamiento y el resultado

Viene una avalancha de productos y poquísimos pensados. El cuidado con lo que la persona ve es lo que separa al tuyo.

Los seis pilares de la rúbrica SmartView

🔎 Diagnóstico

Para un sistema terminado: prueba de los 5 segundos, camino hasta el primer valor cronometrado, inventario de elementos y plan de corrección de máximo 7 ítems.

📝 Sección del PRD

Para un sistema en desarrollo: 10 compuertas que dicen si vale la pena construir y requisitos de experiencia verificables, con criterio de terminado de la versión 1.

🤖 Skill para agentes

Una skill que Claude Code o Codex siguen para abrir el sistema, simular personas, medir los tiempos y devolver el diagnóstico completado.

Cómo funciona

Dos capas, una nota

Las 6 preguntas miran cada botón, campo y pantalla. Las 10 pruebas miran el producto completo. Las dos se convierten en una nota única.

Promesa en 1 línea→ Prueba de los 5 segundos→ Camino hasta el valor→ 6 preguntas por elemento→ 10 pruebas de sistema→ Número + letra + color→ Corregir y quitar

Las 6 preguntas para cada elemento

#PreguntaCuenta como "sí" cuando
E1¿Un extraño sabe decir el nombre de esto?Describe el elemento con sus propias palabras, sin tutorial.
E2¿Sabe qué pasa al presionar?La etiqueta dice acción y resultado ("Verificar este sitio"), no "Enviar".
E3¿El valor por defecto es el correcto para la mayoría?El valor que ya viene sirve para 8 de cada 10 personas.
E4¿Reacciona de forma visible en un compás?Algo cambia en la pantalla en hasta ~300 ms.
E5¿Lleva adonde prometió?Después de la acción, la persona está donde decía la etiqueta.
E6¿Alguien lo extrañaría si desapareciera?Si lo quitas y nadie reclama, nadie lo necesitaba. Sumar restando.

Las 10 pruebas de sistema

S1 · 5 segundos

Un extraño ve la primera pantalla por 5 s y dice qué hace el producto. Si falla, la nota se traba en D.

S2 · Entiende lo que recibió

¿Pegaste un enlace de repositorio? El botón pasa a "Verificar este repositorio". La pantalla demuestra que soporta lo que le diste.

S3 · Reacción < 300 ms

Si la persona espera a que el botón cambie, ya explicaste el chiste.

S4 · Espera legible

Verificaciones con nombre marcando ✓ una a una, como un antivirus. La espera deja de ser música de ascensor.

S5 · Prueba antes del pedido

Unos segundos de actividad y un resultado parcial que despierta curiosidad. Solo después pide el correo.

S6 · Valor en 2 minutos

Una persona poco técnica, sola, comprueba el valor por sí misma con el menor número de clics.

S7 · Número + nota + color

Un resultado que se lee de un vistazo y que se puede enviar en una captura.

S8 · Con sesión iniciada, al lobby

Quien ya es usuario va a su propio espacio, nunca de vuelta a la página de ventas.

S9 · El login es deuda

Cada camino de entrada trae OAuth, cambio de contraseña, términos y cookies que tienen que funcionar para siempre.

S10 · Patrón prestado

Componentes de referencias que ya funcionan en el nicho, no el patrón promedio del modelo ni una invención desde cero.

Requisitos previos

Lo que necesitas

Para usarlo en papel, nada. Para que el agente lo ejecute solo, la skill y un navegador.

📄 Uso manual

Un editor de texto. Los modelos están en Markdown en la carpeta modelo/.

git clone https://github.com/inematds/smartview

🤖 Claude Code

Copia la skill a la carpeta de skills del usuario.

cp -r smartview/skill/smartview ~/.claude/skills/

🧠 Codex

Codex lee skills de la carpeta de agentes del usuario.

cp -r smartview/skill/smartview ~/.agents/skills/
Guía de uso · paso a paso

De cero a la nota en 6 pasos

Los pasos 1 a 4 son para un sistema terminado. Si el sistema todavía es un plan, ve directo al paso 5.

1

Escribe la promesa en una línea

Si no cabe en una línea, el resto de la rúbrica va a doler. "Antivirus para apps hechas con IA" es mejor que "el Uber de X".

# al inicio de modelo/diagnostico.md
Promesa en una línea: "________________"
2

Haz la prueba de los 5 segundos

Muestra la primera pantalla por 5 s a 3 personas ajenas y pregunta "¿qué hace esto?". Si no tienes personas a mano, pídele al agente 3 personas simuladas: una persona de 55 años poco técnica, un joven impaciente que probó 100 productos esta semana y un especialista del nicho.

# en Claude Code o Codex, con la skill instalada
diagnóstico smartview de https://meusistema.com: empieza por la prueba de los 5 segundos con 3 personas
3

Cronometra el camino hasta el primer valor

Haz el recorrido como una persona nueva. Anota cada paso, el tiempo hasta que la pantalla reacciona y cuándo el sistema pide correo, login o tarjeta. Meta: reacción por debajo de 300 ms y valor comprobado en menos de 2 minutos.

# en la consola del navegador: tiempo entre el clic y el primer cambio en la pantalla
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})
# ejecuta la línea de arriba y haz clic en el botón enseguida
4

Pasa las 6 preguntas por cada elemento y suma la nota

Completa la tabla de elementos (2 / 1 / 0 por pregunta) y las 10 pruebas (10 / 5 / 0). Quien saque 0 en "¿haría falta?" va a la lista de quitar, no a la de mejorar.

SmartView = 0,6 × promedio de las pruebas de sistema + 0,4 × promedio de los elementos
# S1 = 0 limita la nota final a D
5

En un sistema nuevo: pega la sección en el PRD

Copia modelo/prd-secao.md a tu plan. La parte A (10 compuertas) dice si vale la pena construir; la parte B se convierte en requisitos verificables; la parte C es el criterio de terminado de la versión 1.

cat smartview/modelo/prd-secao.md >> docs/PRD.md
# o pídeselo al agente:
agrega la sección smartview al docs/PRD.md; lo que el plan no responda, márcalo como pregunta abierta
6

Mock antes de programar, personas antes de lanzar

Guarda una guía de marca corta (colores, fuente, tono, 3 referencias del nicho) en el AGENTS.md o CLAUDE.md, genera la pantalla como imagen y apruébala antes de construir. Antes del lanzamiento, repite las pruebas S1 y S6 con las personas.

# criterio de terminado de la versión 1
SmartView ≥ 75 (B · verde claro), con S1 = 10 y S6 = 10
Pruébalo

Ponle nota a tu producto ahora

Marca las 10 pruebas de sistema. La nota aquí considera solo esa capa; en el diagnóstico completo vale 60% y los elementos, 40%.

0
E · rojo

Marca las pruebas de al lado.

    Roadmap

    Lo que existe y lo que viene

    La versión 1 es texto y skill. Lo demás entra conforme el uso lo vaya mostrando.

    v1 · hoy
    Rúbrica, diagnóstico, sección del PRD y skillModelos en Markdown en la carpeta modelo/, ejemplo completado en exemplos/ y la skill en skill/smartview.
    v2
    Medición automática de tiempoScript de Playwright que abre el sistema, hace clic en la acción principal y mide la reacción de cada elemento.
    v3
    Panel de evoluciónComparar la nota entre versiones del mismo producto y ver qué subió después de cada corrección.