¿Qué hace Agencia de Uno?
Por qué existe
Cuando se le pide un sitio web, un modelo genera el sitio web más probable. Prohibir ese aspecto solo lo desplaza al siguiente más probable (crema + serifa + arcilla, negro + verde ácido, cejas en MAYÚSCULAS, → en enlaces: las señales de segunda ola). Y "creativo" tampoco es la solución: un sitio de negocios debe parecer que lo hizo una agencia excepcional, creíble y pulido, donde todo encaje.
Orden de prioridad: 1) hermoso y adecuado para el cliente, 2) claro y creíble, 3) distintivo (que no parezca hecho por IA). Evitar las señales de IA es necesario pero no suficiente: una página que es distintiva pero simple o fuera de marca ha fallado.
Por lo tanto, esta habilidad parte de la marca que el cliente ya tiene, elimina las decisiones más arriesgadas del constructor y exige que el resultado cumpla con un estándar de belleza y acabado de clase mundial:
- Primero la marca y los activos del cliente, luego la estrategia: colores del logotipo, fotos reales, referencias, posicionamiento, pruebas, idea de marca.
- Aleatoriedad real, color bloqueado por la marca: un script determina las palancas (composición, dispositivo de marca, estrategia de paleta, estrategia tipográfica). El color proviene del logotipo del cliente cuando existe; de lo contrario, de una biblioteca de paletas curadas y verificadas por contraste, nunca del gusto del modelo.
- Un crítico independiente puntúa cinco direcciones por tipicidad y fortaleza; un script elige entre las atípicas y fuertes.
- Un estándar artesanal (
craft.md) y una pieza central heroica construida de forma aislada primero. - Verificaciones indiscutibles: lint en cada edición, medición renderizada, diff plan-vs-render, memoria entre proyectos, verificaciones de belleza renderizadas y un revisor ciego que puntúa primero la deseabilidad y el ajuste a la marca, luego la artesanía y la distinción.
Cuando las reglas entren en conflicto, este orden prevalece: el brief del cliente y los activos de marca > belleza (craft.md Prioridad, §2b) > la paleta y las cartas extraídas > la lista de señales. Una carta o una regla de evitar señales nunca justifica algo más feo o fuera de marca.
$S = la carpeta de esta habilidad: el directorio base que Claude Code muestra cuando la habilidad se carga (${CLAUDE_PLUGIN_ROOT}/skills/agency-of-one como plugin; .claude/skills/agency-of-one o ~/.claude/skills/agency-of-one como inserción directa). Ejecuta los scripts desde la raíz del repo: node $S/scripts/<nombre>.mjs. El hook de sesión imprime la ruta absoluta de los scripts; pasa esa ruta absoluta a cada subagente (no pueden resolver $S por sí mismos). Nunca abras references/decks.json. Las cartas provienen solo del script.
Modo
- Agencia (por defecto): orientado a negocios, profesional, pulido. Lee
references/agency.md. - Expresivo (
--mode expressive): solo cuando el brief solicite algo experimental, artístico, editorial, de campaña o tipo evento. Utiliza medios de referencia no web y restricciones; leereferences/process-notes.md.
Puerta de entrada
DESIGN.mdexiste → síguelo exactamente; ve a la Fase 3. Propón enmiendas; nunca te desvíes en silencio. Si no tiene el marcador<!-- agency-of-one design v1.1 -->es anterior al color primero-marca: ejecutabrand-extract.mjs; si la paleta choca con los activos de la marca (plan-diff informa del choque), propón una enmienda de color §4 al usuario antes de construir sobre ella.- El brief define una dirección o guía de marca → el brief gana, incluso si nombra una señal conocida. Regístralo (y sus excepciones en §9); ve a la Fase 3.
- De lo contrario → Fases 1–2, incluso para páginas "pequeñas".
Configuración única por repo: npm i -D playwright && npx playwright install chromium (como devDependency, para que un npm i posterior no lo elimine).
Fase 1: Activos, marca, estrategia (DESIGN.md §1)
- Activos reales: pregunta primero (agency.md Paso 0). Logotipo, fotos de las personas, datos biográficos, nombres de clientes o un caso de estudio, datos de contacto y legales, números reales, capturas de pantalla del producto. En revisiones ciegas, la credibilidad y las imágenes se estancan alrededor del 6/10 sin ellos, por bueno que sea el diseño. Los que falten se convierten en espacios profesionales (agency.md Paso 5), y tu informe comienza con qué proporcionar.
- La marca que ya tienes (agency.md Paso 0a). Si hay un logotipo, escudo, sitio existente o fotos de personas, ejecuta
node $S/scripts/brand-extract.mjs(autodescubre o pasa rutas). Escribe.design-review/brand.json; a partir de entoncesdraw.mjsestá bloqueado por la marca automáticamente y plan-diff falla cualquier paleta que pierda el color del logotipo. Asistido: confirma el color de marca extraído con el usuario en una línea. Nunca luches contra los colores propios de la marca. - Referencias (asistido): pide 2–3 sitios que el cliente encuentre hermosos (cualquier industria). Guarda capturas de pantalla en
design-references/. El revisor los compara con ellos. Establecen el listón de calidad, no el aspecto. - Gusto humano (solo asistido): pregunta una vez, "2–3 marcas u objetos que admires, y un sitio de la competencia al que no quieras parecerte."
- Estrategia (modo agencia, agency.md Paso 1): frase de posicionamiento, la única creencia, 5 códigos de categoría marcados como mantener/romper (romper ≥ 2), idea de marca, personalidad con "pero no", inventario de pruebas (nunca inventes pruebas).
- Inventario de temas: 8+ artefactos reales, lugares, materiales y elementos vernáculos del mundo del cliente (12+ en modo expresivo). En modo agencia, estos alimentan la dirección de las imágenes, el dispositivo de marca y el copy, no el disfraz.
- Redacta la frase heroica y la etiqueta de la acción principal en la voz de la marca. Puedes refinarlas después del sorteo.
Fase 2: Sorteo → línea base → divergir → crítico → elegir → comprometer
2a. Sorteo. node $S/scripts/draw.mjs --project "<nombre>" (modo agencia por defecto) reparte una referencia de calidad, sistema de composición, dispositivo de marca, estrategia de paleta y estrategia tipográfica. El color está bloqueado por la marca automáticamente cuando existe .design-review/brand.json (anulación solo con --no-brand "<razón>", por ejemplo, un rebranding solicitado por el cliente); de lo contrario, proviene de una biblioteca de paletas curadas y verificadas por contraste: hermosos puntos de partida, nunca tonos aleatorios. Pégalo en DESIGN.md §2. Un veto con una razón escrita: --redraw <slot>. Si una carta ordena algo en la lista de señales (por ejemplo, una cuadrícula visible), está permitido como una excepción ordenada por carta: regístralo en §9 como card: <razón> y ejecútalo como estructura, no decoración.
2b. Líneas base. Escribe dos gemelos: el gemelo IA (lo que un modelo haría para este brief: fuentes, hexes, héroe, secciones) y, en modo agencia, el gemelo cliché de agencia (la versión que busca premios). Verifica ambos contra references/tells.md.
2c. Divergir. Escribe 5 direcciones (A–E) en .design-review/directions.md, junto con un breve resumen del brief y el inventario de §1. Cada dirección recibe una expresión de la idea de marca, cómo se aplica cada palanca sorteada, la composición del héroe (un pequeño wireframe ASCII), clases de caras (aún no caras específicas), un boceto de paleta y el dispositivo de marca. No las puntúes tú mismo. Al menos 3 deben diferir en la arquitectura de la página, no solo en la apariencia.
2d. Crítico independiente. Ejecuta el subagente direction-critic (agency-of-one:direction-critic como plugin) y dale solo la ruta. Devuelve tipicidad t y fortaleza s para cada dirección, más un PICK_ARG.
2e. Elegir. node $S/scripts/draw.mjs --pick "<PICK_ARG>". En modo agencia toma las direcciones más fuertes (s ≥ 8, dentro de 0.5 de la mejor), excluyendo solo las claramente genéricas (t ≥ 0.7). En modo expresivo favorece las atípicas. El código de salida 3 significa que ninguna califica: escribe 3 nuevas direcciones (injerta la STRONGEST_IDEA_TO_STEAL del crítico) y vuelve a ejecutar el crítico. Construye lo que el script elija. Asistido: muestra la elegida más la subcampeona en una línea cada una y permite al usuario anular.
2e′. Composiciones del héroe (la puerta de la belleza). Antes de comprometerte, construye el héroe (pliegue + primer desplazamiento, escritorio y móvil) para la elegida y la subcampeona como dos composiciones estáticas rápidas con activos reales. Captura ambas (screenshot.mjs --file comp-a.html comp-b.html), luego da a un nuevo design-reviewer solo las dos imágenes de pliegue y pliegue móvil, sin etiquetar, y pide una elección forzada: ¿de cuál estaría más orgulloso el cliente de enviar, y por qué? Construye la ganadora. Si el revisor califica ambas como simples o fuera de marca, vuelve a sortear en lugar de pulir.
2f. Diff. Completa la tabla §3 de DESIGN.md contra ambos gemelos. Cualquier eje coincidente debe cambiar a menos que el brief lo requiera. Prueba de intercambio: ¿encajaría el nombre de un competidor? Si es así, extrae más de §1.
2g. Comprometer tokens. Completa templates/DESIGN.md → DESIGN.md, incluyendo el bloque de tokens legible por máquina que plan-diff lee.
- Tipografía:
references/typography.md. Renderiza tu lista corta connode $S/scripts/type-specimen.mjsy elige mirando. Usa una escala de proporción; marca los tamaños de visualización fluidos comofluid. - Color: comienza desde la propuesta de brand.json (o la paleta curada): marca textual, brandForText para texto sobre fondos claros, tintes profundos / claros, neutros teñidos y tinta (craft.md §4). Prueba AA. Mantén el color del logotipo reconocible.
- Verificación de repetición:
node $S/scripts/designlog.mjs check --project "<nombre>" [--brand-locked] --display … --body … --ground … --accent … --layout … --medium "<composición o medio primario>". Si informa REPEAT, cambia los ejes repetidos.
Fase 3: Construir según el estándar artesanal
3a. Pieza central heroica primero, de forma aislada. Construye solo el héroe (modo agencia: la composición sorteada ejecutada impecablemente; modo expresivo: el mecanismo distintivo). Captúralo (screenshot.mjs, con --state para estados interactivos) e itera hasta que puntúe ≥ 8 en cada eje artesanal relevante en references/craft.md. Solo entonces construye el resto.
3b. Construye la página solo a partir de tokens (CSS variables / Tailwind v4 @theme), siguiendo la arquitectura del agency.md Paso 3 o el esqueleto expresivo. shadcn/Radix proporcionan solo el comportamiento; rediseña cada componente primitivo. El copy es específico, en mayúscula y minúscula de oración, y en la voz de la marca; la prueba es real o con espacios reservados. El hook de lint marca las señales en cada edición, así que corrígelas a medida que aparecen.
3c. Pasada de acabado. Revisa references/craft.md §1–10 línea por línea: detalles tipográficos, auditoría de cuadrícula, ritmo, color y contraste, imágenes y espacios, movimiento y estados, composición responsiva a 1440/1024/768/390, corrección de copy (−30%), acabado técnico. Esta pasada es de donde proviene el "hecho por agencia". No la omitas.
Fase 4: Verificar (máximo 3 rondas, conserva la mejor)
- Instantánea primero: confirma (o copia) el estado actual antes de cada ronda para que se pueda revertir una revisión peor.
node $S/scripts/slop-lint.mjs: cero errores; cada advertencia corregida o justificada en §9 +slop-lint.config.json.node $S/scripts/screenshot.mjs --url <url de desarrollo> --routes / /about …(o--file index.html about.html …para estático; cada página, no solo la principal)--state <nombre>=click:<sel>|hash:<#id>|scroll:<sel>|hover:<sel>para cada estado distintivo. Mira el pliegue, pliegue móvil, scroll50 y las capturas de estado.node $S/scripts/plan-diff.mjs: el color del logotipo está en la paleta, las caras planificadas cargadas, la paleta renderizada, la escala aplicada, sin fondos fuera del plan, y las verificaciones de belleza en escritorio y 390px: sin contenido invisible por animaciones u oculto sin JS, sin avatares de iniciales, grupos de fotos coherentes (recorte, tamaño, fondo), sin texto centrado de varias líneas, sin etiquetas en mayúsculas, sin barras divisorias, un encabezado de página diseñado en cada página.- Revisión ciega: el subagente
design-reviewer(agency-of-one:design-reviewer) recibe solo la URL o archivo, las rutas y.design-review/. Puntúa primero la deseabilidad y el ajuste a la marca, luego la artesanía y la distinción, contradesign-references/si está presente. ENVÍO requiere deseabilidad, ajuste a la marca y cada eje artesanal ≥ 8. El veredicto de un sitio multipágina es el de su página más débil. - Corrige y vuelve a renderizar. Conserva una revisión solo si el revisor la puntúa más alta que la mejor anterior. Detente después de 3 rondas e informa lo que aún está abierto.
- Espejo: elimina una decoración que no sirva a la idea de marca; anótalo en DESIGN.md §11.
- Registro:
node $S/scripts/designlog.mjs add --project "…" …mismas banderas que check… --media "<resumen del sorteo>" --signature "<dispositivo / pieza central>"(--log <ruta>para mantener el registro en el repo). - Informe: dirección (una línea), idea de marca, pieza central, resultados de lint/plan-diff/revisión con puntuaciones de artesanía, excepciones abiertas, cada espacio y suposición que el cliente debe llenar o confirmar.
Archivos de referencia
| Archivo | Cuándo |
|---|---|
references/agency.md | Modo Agencia: estrategia, sistema de identidad, arquitectura de negocio, espacios, credibilidad |
references/craft.md | 3a, 3c, Fase 4: el estándar de acabado, alineación, sistema de fotos, encabezados de página, puntuación |
references/patterns.md | 3b: recetas probadas para cuadrículas de personas, encabezados de página, bandas de prueba, eventos, donaciones, formularios |
references/palettes.json | Biblioteca de paletas curadas (leída por draw.mjs; puedes navegarla) |
references/tells.md | 2b, 2f, Fase 4: señales de IA (gen 1–3) con firmas y fuentes |
references/typography.md | 2g: procedimiento de fuentes, fuentes, licencias, escala |
references/process-notes.md | Modo Expresivo: interpretación de cartas; ejemplos resueltos |
templates/DESIGN.md | 2g |