lo que vas a poder hacer
entregable · lo que produces
Un AGENTS.md escrito a mano en la raíz de la carpeta de proyecto, con cuatro secciones: audiencia, oferta, voz y palabras y temas que nunca tocas. Detrás, la carpeta de material original que reuniste antes y un hábito que mantiene fiel el archivo al cambiar el negocio. Cada trabajo que ejecutes pasa por este archivo.
Todo agente responde las mismas tres preguntas antes de escribir una palabra. Quién lee esto. Qué le vendo. Cómo suena esta persona. Las respondes una vez en un archivo o mal en cada prompt del resto del año.
AGENTS.md es el documento de incorporación que darías a un asistente nuevo el primer día. Mantén esa idea.
No contratarías a alguien, dirías "escríbeme un boletín" y te irías. Le darías una carpeta: perfil del cliente, lista de productos, muestras de tus textos y una lista breve de frases que nunca quieres ver. AGENTS.md es esa carpeta y el agente la lee antes de cada trabajo.
Sin él suena como cualquier otra IA de internet y luchas contra eso en cada prompt. Con él, el prompt que ayer daba resultados genéricos hoy da los tuyos.
Una advertencia sobre el orden. Si abres un AGENTS.md vacío y empiezas a escribir, saldrá el negocio que desearías tener, escrito de memoria a las once de la noche. Primero reúne, después escribe.
Por qué este devuelve más que el resto
Una regla sostiene todo el módulo: un cerebro de negocio escrito a mano supera a uno generado por IA.
Deja que lo escriba el agente y la calidad baja. Escríbelo a mano y sube. La diferencia es demasiado pequeña para detectarla en un borrador, por eso sale cara. Unos puntos porcentuales menos en cada boletín, página de destino, correo en frío y respuesta durante un año separan "suena como yo" de "edito cada borrador treinta minutos".
Tómalo como regla práctica, no como ley natural. La razón es lo transferible. Un agente que escribe el cerebro de tu negocio adivina hechos que solo tú sabes; al quedar en un archivo en el que confía para todo trabajo posterior, esa conjetura se lee igual que un hecho. No solo pierdes precisión. Conviertes una conjetura en regla.
Reúne tres cosas antes de escribir nada
El archivo es el resultado de una pequeña recopilación, no el punto de partida.
Uno. Preguntas y respuestas escritas de tu audiencia. Responde por escrito las diez preguntas que realmente te hacen los clientes. No las de la página de preguntas frecuentes. Las de una llamada, una respuesta o una solicitud de devolución, con las palabras que dirías en voz alta.
Parece tarea escolar en vez de construcción y se omite, pero es lo que más trabaja de las tres cosas. Aporta concreción que el agente no puede inventar. Puede escribir sobre "ayudar a pequeñas empresas a ahorrar tiempo". No puede saber que tus clientes dicen "ya lo probé y se rompió" como segunda frase de cada llamada de ventas.
Dos. Diez minutos hablando tú. Grábate explicando qué vendes a un amigo que nunca lo oyó, sin guion, y convierte la grabación en texto.
Nada captura tu ritmo a tan bajo costo. Al escribir te editas hacia una versión más rígida. Al hablar quedan sin filtrar los conectores, las frases espontáneas y cómo pasas de un punto a otro; esa transcripción es la materia prima de tu sección de voz.
Tres. Entre cinco y diez muestras de tus mejores textos reales. Boletines anteriores, respuestas de las que te enorgulleces, una página de destino que convirtió, como archivos reales en una carpeta junto a AGENTS.md.
Es la carpeta que darías a una nueva contratación, para que cada línea apunte a algo real en vez de medio recordado. Consérvala después: las muestras servirán más adelante.
Las cuatro secciones de un AGENTS.md de negocio
Recórrelas en orden, en lenguaje sencillo, como una nota para alguien inteligente que acabas de contratar.
1. A quién sirves. Tu cliente ideal. Su trabajo. El dolor con el que despierta. La objeción antes de comprar. Las palabras exactas con las que cuenta el problema a un amigo durante una cena. Usa aquí las preguntas y respuestas y pega las citas reales. ¿Aún no investigaste clientes? Escribe cinco nombres y qué diría cada uno, con nombres y lenguaje reales, porque el agente no puede adivinarlo ni lo inventará bien. Responde: ¿quién es el lector al otro lado?
2. Tu oferta. La escalera completa, de lo gratuito a lo más caro. Precios o, si el precio es delicado, la regla para hablar de él ("nunca indiques una cifra, di siempre 'desde cuatro cifras'"). Después las pruebas: casos de éxito, cifras respaldadas, testimonios que reutilizas. Sin ellos por escrito, inventa sustitutos insulsos y una prueba inventada se publica antes de que nadie lo note. Responde: ¿en qué ayudo a actuar a este lector?
3. Tu voz. Entre cinco y diez reglas sobre cómo escribes de verdad. Ritmo: frases breves o fluidas. Vocabulario simple o rico. Inicios con historia, dato o afirmación de una línea. Hábitos de puntuación. Palabras habituales. Metáforas favoritas. Esta sección falla en silencio: las dos siguientes explican cómo acertar. Responde: ¿cómo suena realmente esta persona?
4. Lo que nunca dices. Casi todos la omiten. Es la más importante. Enumera palabras prohibidas, frases que no son tuyas y temas vedados como cadenas exactas, no como una descripción de ambiente. Es un archivo de espacio negativo: decir qué evitar supera a decir qué hacer porque a una IA le resulta más fácil detenerse que empezar. Diez frases prohibidas superan a diez preferidas.
Si hoy solo escribes una sección, que sea esta.
Tu sección de voz es un perfil, no una sensación
Aquí falla en silencio la mayoría de los cerebros de negocio. Alguien escribe "amable pero profesional, cercano, experto", dirige ahí el agente y obtiene un texto que no es nada de eso. La sección nunca estuvo equivocada. Nunca fue comprobable.
Trátala como un perfil con cuatro partes.
Patrones medidos en tus textos reales. No cómo crees sonar, sino lo que muestran las muestras: longitud media de frases, frecuencia de inicios con afirmaciones en vez de historias, palabras que usas mucho más que el lenguaje habitual y hábitos con comas, preguntas y párrafos de una línea. Delega esto al agente: es bueno contando y tú malo describiéndote.
Ajustes de tono con dos extremos definidos. En lugar de "amable", escribe dónde te sitúas. "Cálido en un extremo, clínico en el otro; estoy cerca de cálido, pero nunca uso exclamaciones". Un ajuste se puede discutir. Un adjetivo no.
Reglas estrictas de vocabulario. Palabras que usas, que rechazas y sustituciones que siempre haces, como cadenas literales.
Una prueba con muestras reservadas. Deja fuera de la carpeta dos de tus mejores textos. Escrito el perfil, pide un borrador del mismo tipo y léelo junto a los dos reservados. Lo que falte es una línea que el perfil aún te debe. Juzgar frente a un texto que el agente ya leyó solo prueba que sabe copiar.
El perfil también supera al atajo obvio de pegar muestras en cada prompt y saltarte el archivo. Eso funciona hasta un techo; después deja de mejorar por muchas muestras que añadas y te quedas para siempre en "suena vagamente como yo". Un perfil puedes editarlo. A una pila de ejemplos solo puedes añadir más.
Envía esto a tu agente:
// shell
Lee todos los archivos de ./voice-samples/ .
Aún no escribas con mi voz. Primero describe lo que observas:
- longitud media de las frases y su rango
- cómo empiezo los textos, contando los patrones en las muestras
- palabras y frases que uso notablemente más que la media
- hábitos de puntuación, incluido lo que nunca uso
- cómo cierro los textos
Dame una lista de observaciones, cada una con una línea de ejemplo de las
muestras como prueba. Donde dudes, indica la duda en vez de adivinar.O hazlo tú. Abre tus cinco mejores textos uno junto a otro. Cuenta las palabras de diez frases al azar y anota la media. Lee el inicio de cada texto y anota el patrón. Rodea las palabras que aparecen en tres o más. Un perfil aproximado en veinte minutos.
En ambos casos, edita a mano lo que recibas antes de llevarlo a AGENTS.md. El agente produjo observaciones. Tú decides cuáles te representan y cuáles son accidentes de los cinco textos elegidos.
Escríbelo para que alguien ajeno pueda comprobarlo
Una lista de valores de marca sin ejemplos ni referencias se lee, se acepta y se ignora, porque nada puede incumplirse. Tu archivo tiene la misma trampa. Cada línea debe superar una prueba: ¿alguien que no estaba allí podría saber si se incumplió?
| Vago, inutilizable | Comprobable, utilizable |
|---|---|
| "Escribe con amabilidad" | "Segunda persona. Sin exclamaciones. Nunca empieces con un saludo." |
| "Sé breve" | "Casi nunca más de 15 palabras por frase." |
| "Suena exclusivo" | "Nunca lenguaje de descuentos. Nunca la palabra barato. Precios siempre como rango." |
| "Sé concreto" | "Usa una cifra real cuando la tenga. '$40K MRR' supera a 'MRR de cinco cifras'." |
En la izquierda, el agente decide qué significan las palabras y lo hace distinto cada vez. En la derecha, la regla permanece fija.
Tres cosas llevan una regla de izquierda a derecha. Un ejemplo correcto y uno incorrecto. La versión canónica: la expresión que quieres reutilizar. Y algo contable cuando lo encuentres, porque una regla con una cifra se comprueba sin leer todo el borrador.
Por eso "lo que nunca digo" supera a todo lo demás: cadenas exactas que fallan de forma visible. Escribe el resto como escribes naturalmente esa sección.
La regla de escribir a mano
Dilo en voz alta: AGENTS.md se escribe a mano. No se genera.
El agente puede leer muestras, contar cosas y proponer observaciones. Nunca lo crea desde cero y nunca entregas tal cual lo que produjo. Ese orden es toda la protección.
Los cinco arquetipos para una sola persona al mando
Una persona lleva varios roles. El fundador también hace marketing y quien hace marketing también atiende soporte. El "equipo" es una persona en cinco trabajos.
El patrón útil: un AGENTS.md compartido en la raíz del proyecto con el cerebro de marca (audiencia, oferta, voz, palabras prohibidas) y notas de rol en subcarpetas para cada función.
- Fundador estratega. Posicionamiento, historia de tu negocio y cómo planteas decisiones en público.
- Marketing / redacción publicitaria. Introducciones de boletines, textos de páginas de destino, titulares principales, correos en frío. La voz que impulsa clics e inscripciones.
- Creador de contenido. Artículos largos, cuerpos de boletín, publicaciones sociales. La voz que construye audiencia.
- Profesional de ventas. Páginas de venta, gestión de objeciones, seguimientos. La voz que cierra acuerdos.
- Éxito del cliente. Respuestas de soporte, devoluciones y el correo de "nos equivocamos". La voz que conserva un cliente cuando algo falla.
El archivo compartido define quién eres; el de rol, qué función desempeñas ahora. El agente lee al final el archivo más cercano al trabajo, así que ese gana en caso de conflicto.
Mantén clara la división y evitarás el fallo de la tercera semana: la misma regla escrita ligeramente distinta en dos archivos. Si los resultados se vuelven raros, no sabes cuál lo causó, editas ambos y no confías en ninguno. Una regla, un lugar. Si un archivo de rol necesita adaptar una regla compartida, la acota en vez de repetirla.
Elige el rol que más desempeñes este mes y escríbelo primero.
Un ejemplo desarrollado
El archivo de marketing de un pequeño negocio de plantillas de Notion. Las partes entre corchetes son marcadores que completarías.
// shell
# AGENTS.md - Voz de marketing
# A quién sirvo
Fundadores independientes de SaaS, 1-3 personas, con ingresos, antes de serie A.
Usan Notion a diario, pero no son "usuarios avanzados de Notion".
Su dolor: encadenan hojas de cálculo y wikis con arreglos improvisados hasta que algo falla.
La frase exacta: "Solo necesito que funcione, no quiero construirlo".
Su objeción antes de comprar: "¿No puedo pedir a una IA que lo haga por mí?"
La respuesta que quieren: "Podrías, pero dedicarías 6 horas y seguirías con una versión peor".
# Qué vendo
- Nivel gratuito: una plantilla CRM inicial, descargable a cambio de suscribirse por correo.
- $49 en un pago: paquete de plantillas para fundadores (CRM + seguimiento de financiación + tablero de sprint).
- $149 en un pago: kit completo, más 4 actualizaciones trimestrales y un canal privado de Slack.
- Nunca pongas precios en titulares. Abre con el resultado, no con el importe.
# Mi voz
Frases cortas. Casi nunca más de 15 palabras.
Escribe como un amigo que manda mensajes a otro fundador, no como una marca.
Abre con una afirmación de una línea, nunca una historia.
Cierra con una pregunta o llamada a la acción de una línea, nunca un párrafo.
Usa cifras concretas cuando las tenga. "$40K MRR" supera a "MRR de cinco cifras".
# Lo que nunca digo
- "Revolucionario". "Potente". "El mejor de su clase". "Desbloquea".
- "En el vertiginoso mundo actual".
- Rayas largas. Solo puntos, guiones y dos puntos.
- Nada que suene a presentación comercial de SaaS.
- Marcas de competidores. Los llamo "las herramientas de $99 al mes".
- Política. Religión. Las noticias del momento."Lo que nunca digo" es la sección más larga porque es lo que más rápido se desvía cuando el agente trabaja solo. Lee lo demás con la prueba de la persona ajena: cada línea nombra, cita o cuenta algo. El archivo ronda las 250 palabras. El tuyo puede ser mayor, pero el objetivo es concreción, no longitud.
Un archivo, elijas el agente que elijas
Cada uno de los cinco busca un nombre algo distinto y todos pueden usar tu único archivo portable.
Este agente lee AGENTS.md directamente: uno compartido en tu carpeta personal y otro del proyecto donde trabajas. El del proyecto gana si discrepan: pon el cerebro de marca en el compartido y las notas por rol en los de proyecto.
Uses el que uses, comprueba esto una vez: pídele que nombre los archivos leídos antes de redactar. Un agente que nunca abrió el cerebro del negocio escribe con seguridad igualmente y nada en el resultado anuncia que se saltó el archivo.
Una skill portable para una tarea de negocio
Crea una carpeta con SKILL.md. La siguiente skill revisa a propósito en vez de reescribir, para que quien controla la voz controle el cambio final.
// markdown
---
name: brand-voice-check
description: Check a draft against the business voice rules.
---
Lee `AGENTS.md`.
Lee el borrador.
Enumera cada problema de voz, citando la línea y la regla que incumple.
No reescribas el borrador.La estructura de creación es igual entre herramientas; solo cambia la ruta de instalación. Pruébala en un borrador limpio y otro con un problema de voz conocido. Debes obtener hallazgos sin ediciones. Si reescribe, añade el límite de no escritura al procedimiento o mueve la reescritura a otra skill que apruebes aparte.
La instrucción "citar la línea y nombrar la regla" hace trabajo real. Un hallazgo rastreable a una regla dice si falla el borrador o la regla; la mitad de las veces el problema era la regla. Eso se corrige en el archivo en vez de arreglar el borrador a mano.
El archivo se afina con el uso, no el primer día
Tu primer AGENTS.md será bueno, no excelente. La trampa no es el primer borrador. Es dejarlo tal cual.
La solución usa algo que ya produces. Cada vez que editas un borrador del agente, esa edición es un dato: acabas de enseñar al archivo algo que no sabía.
Lleva una nota de edición. Una línea en un archivo temporal cada vez que cambies algo del agente. No la corrección: el motivo. "Inicio demasiado formal". "Inventó un testimonio". "Usó una palabra que nunca uso". Cinco segundos, y la idea ya está en tu cabeza.
Una vez por semana, lee juntas las notas y busca motivos repetidos. Un motivo que aparece tres veces es una regla ausente, no un mal borrador. Incorpóralo al archivo en el formato comprobable anterior y anota arriba qué cambió y la fecha. Esa fecha permite revertir un cambio que empeoró las cosas. Sin ella, la calidad deriva tres semanas y nadie puede decir qué se editó.
Envía esto a tu agente:
// shell
Lee edit-notes.md y AGENTS.md.
Agrupa mis notas de edición por motivo subyacente. Para cada motivo que aparezca
tres o más veces, propón UNA regla nueva para AGENTS.md, escrita para que alguien
ajeno pueda saber si se incumplió, con un ejemplo correcto y otro incorrecto.
Solo propón las reglas. No edites AGENTS.md.O hazlo tú. Lee las notas de principio a fin y cuenta los motivos en papel. Lo que tenga tres marcas se convierte en una línea del archivo. Diez minutos por semana, sin herramientas.
Dos minutos diarios de notas y diez semanales de integración; al acabar la primera semana, el agente suena como tú al primer intento en vez del tercero.
Esto es lo que se pierde quien abandona pronto. Escribe un borrador, ejecuta dos prompts, decide que no funciona y para. El archivo se afina con el uso, igual que una persona recién contratada mejora en la segunda semana, no el primer día. Los tres primeros días son la única parte en la que se espera cierta decepción.
Qué sigue
El módulo 4 trata los atajos guardados: comandos que reutilizas una y otra vez. Todos leen el AGENTS.md que acabas de escribir. Por eso un cerebro de negocio débil sale caro dos veces: escribe peores borradores y transmite esa debilidad a cada atajo que construyes encima.
descargas
// 1 archivo · listo para usar. copia, adapta, entrega.
recursos y referencias
// documentación oficial, herramientas e hilos que merece la pena guardar