La IA no sabe para quién estás construyendo (y ese es el problema)
AUDIENCE.md: el estándar que define para quién construyes (y por qué cambia cómo trabaja la IA en tu proyecto)
Puedes tener el mejor código, la mejor arquitectura y la mejor IA.
Y aun así construir algo completamente equivocado.
Porque hay una pregunta que casi nunca aparece en los repositorios:
¿Para quién existe este proyecto?
No qué hace.
No cómo se instala.
No qué framework usa.
Para quién.
Y cuando trabajas con agentes de IA, esa diferencia importa mucho más de lo que parece.
El problema real
Un agente puede leer tu código.
Puede entender tu README.
Puede ejecutar tests.
Puede revisar issues.
Puede generar componentes.
Puede escribir documentación.
Puede proponer features.
Pero si no entiende a quién va dirigido el producto, va a optimizar en abstracto.
Y optimizar en abstracto produce siempre lo mismo:
interfaces genéricas
copys genéricos
documentación genérica
features genéricas
El problema no es que la IA no sepa escribir.
El problema es que no sabe para quién está escribiendo.
La IA no falla escribiendo. Falla porque no sabe para quién escribe.
El contexto que falta
Un repo moderno puede tener muchas capas de contexto:
README.mdpara explicar qué es el proyectoAGENTS.mdpara definir cómo trabaja un agenteSECURITY.mdpara vulnerabilidadesCONTRIBUTING.mdpara contribucionesOpenAPIpara APIsADRs para decisiones técnicas
Todo eso ayuda.
Pero sigue faltando una pieza clave.
Puedes saber perfectamente cómo funciona un sistema y aun así no saber cómo debería evolucionar.
Puedes tener instrucciones impecables y aun así escribir una landing equivocada.
Puedes tener un diseño bonito y aun así hablarle al público incorrecto.
Porque falta la audiencia.
Y cuando falta la audiencia, la IA rellena huecos.
A veces lo hace bien.
Muchas veces lo hace con clichés.
Qué es AUDIENCE.md
📄 Documentación: https://audiencemd.ai/
Por eso empecé a usar (y formalizar) un archivo:
AUDIENCE.mdAUDIENCE.md es un archivo Markdown pensado para definir la audiencia de un proyecto de forma legible para humanos y agentes de IA.
La idea es simple:
Si una IA va a ayudarte a construir, escribir, diseñar o priorizar, necesita saber para quién está trabajando.
Puede vivir en la raíz:
AUDIENCE.mdO en estructuras más completas:
AUDIENCE.md
audiences/
developers.md
buyers.md
newsletter-readers.mdEl objetivo no es crear otra plantilla de marketing.
El objetivo es tener una fuente de verdad sobre audiencia.
versionable
revisable
reutilizable
legible por agentes
El problema que resuelve
Imagina que le pides a una IA:
Mejora esta landingPuede mejorar muchas cosas:
claridad
estructura
titulares
llamadas a la acción
jerarquía visual
Pero hay una pregunta previa:
¿Mejor para quién?No es lo mismo una landing para:
developers senior
founders no técnicos
equipos enterprise
creadores de contenido
Sin ese contexto, la IA cae en lo genérico:
Ahorra tiempo
Aumenta tu productividad
Escala tu negocio
Todo en una sola plataformaTexto correcto.
Y completamente olvidable.
No es una buyer persona clásica
AUDIENCE.md no es esto:
María, 34 años, vive en Madrid y toma caféEso no ayuda a un agente.
Lo que sí ayuda es contexto accionable:
Desarrolladores indie con poco tiempo, alta tolerancia técnica y baja paciencia para contenido genérico sobre IAEso cambia decisiones.
cómo escribes
qué explicas
qué das por sabido
qué tono usas
qué evitas
La audiencia no es demografía.
Es contexto para tomar decisiones.
Qué debería contener
Una versión mínima:
# AUDIENCE.md
## Summary
## Primary audiences
## Jobs to be done
## Pains and constraints
## Motivations
## Decision criteria
## Language and tone
## Anti-goals
## Evidence
## Assumptions
## Open questionsNo tiene que ser largo.
Tiene que ser útil.
Ejemplo rápido
## Audience
Product teams trying to understand why users do not reach activation
## Jobs
- Find drop-offs
- Prioritize fixes
## Constraints
- Too many dashboards
- Low trust in generic AI
## Tone
Avoid vague growth languageEsto da más contexto que:
Startups SaaSCómo lo usa un agente
Con AUDIENCE.md, cambian los prompts:
Antes:
Escribe una landingDespués:
Escribe una landing alineada con AUDIENCE.mdAntes:
Propón featuresDespués:
Propón features para la audiencia principal y descarta las que optimicen para audiencias excluidasLa diferencia parece pequeña.
Pero cambia completamente el resultado.
Dónde encaja
README.md → qué es
AGENTS.md → cómo trabajar
DESIGN.md → cómo se siente
SECURITY.md → límites
AUDIENCE.md → para quiénCada archivo responde una pregunta distinta.
No solo para código
También sirve para:
newsletters
cursos
contenido
productos físicos
marcas personales
Cualquier sistema donde la audiencia importe.
La pieza más infravalorada: anti-audiencia
Una de las partes más valiosas:
Para quién NO es esto
Ejemplos:
No estamos construyendo para enterprise
No estamos escribiendo para principiantes absolutos
No queremos usuarios que buscan automatización totalSin límites, la IA optimiza hacia lo más amplio.
Y eso diluye el resultado.
Evidencia vs suposiciones
Un buen AUDIENCE.md separa:
evidencia
suposiciones
preguntas abiertas
Porque los modelos suenan seguros incluso cuando no lo están.
Y necesitas ver dónde hay incertidumbre.
Cómo empezar
No necesitas complicarlo.
Responde a esto:
¿Quién es la audiencia?
¿Qué quiere?
¿Qué sabe?
¿Qué le frustra?
¿Qué objeciones tiene?
¿Para quién NO es esto?
¿Qué sabemos con evidencia?
¿Qué asumimos?Y ya estás por delante de la mayoría.
💥 La idea clave
Sin audiencia, la IA optimiza hacia lo genérico.
El patrón que viene
Los repos están evolucionando.
No hacia más código.
Sino hacia más contexto.
Contexto que:
vive en el repo
se versiona
se revisa
lo entienden humanos y máquinas
AUDIENCE.md cubre una pieza crítica:
la audiencia.
Herramientas alrededor de AUDIENCE.md
📄 Más info: https://audiencemd.ai/
Puedes usar AUDIENCE.md solo como un archivo Markdown.
Y ya aporta muchísimo valor.
Pero si quieres ir un paso más allá, hay herramientas alrededor del estándar que facilitan su uso:
CLI
Puedes inicializar y validar tu archivo directamente desde terminal:
npx @audiencemd/cli init ./my-project
npx @audiencemd/cli validate ./my-projectO con pnpm:
pnpm --package=@audiencemd/cli dlx audience init ./my-project
pnpm --package=@audiencemd/cli dlx audience validate ./my-projectEsto te permite:
generar una estructura base
validar que el archivo tiene sentido
mantener consistencia en distintos proyectos
Playground
También puedes trabajar sobre tu audiencia directamente en el navegador:
https://audiencemd.ai/playgroundÚtil para:
crear un
AUDIENCE.mddesde ceroiterar rápido
probar ideas sin tocar el repo
La herramienta no es lo importante.
Lo importante es la convención.
Pero tener tooling alrededor hace que sea mucho más fácil adoptarlo.
Cierre
Si una IA no sabe para quién trabaja, no está ayudando a construir.
Está rellenando huecos.
Antes de pedirle más a la IA,
asegúrate de que sabe para quién lo hace.
Si quieres profundizar o empezar a usarlo en tus proyectos:
