Un brief es la promesa que el artículo tiene que cumplir, escrita cuando todavía la podés cambiar. Nombra a quién le contesta la página, qué cubren y qué dejan afuera las páginas que hoy rankean, qué secciones llevan la respuesta y en qué evidencia se apoya cada afirmación. El 2026-10-03 corrimos el comando de brief de claude-seo sobre un término y nuestro propio sitio: 100 segundos, 14 turnos, cinco páginas competidoras leídas y puntuadas, seis huecos, un outline con presupuesto de palabras y un juego de meta tags. Esta clase recorre esa salida y después muestra qué le suma seodraft guardando el plan antes de que exista el cuerpo, que es lo que convierte un brief de documento en chequeo. En el camino el brief se audita con su propio estándar, y pierde un punto.
Qué tiene que contener un brief antes de que alguien escriba
Ocho cosas hacen que un brief valga la pena, y un artículo vale la pena empezarlo cuando las ocho existen. Cualquier otra cosa de una plantilla de brief es decoración.
- La intención de búsqueda y el tipo de página que implica.
- El lector, en una frase que diga qué ya sabe.
- Qué cubren y qué dejan afuera las páginas que rankean.
- El ángulo que solo vos podés tomar.
- El outline de H2, con la frase con la que abre cada sección.
- La evidencia detrás de cada afirmación.
- Los links internos de entrada y de salida.
- El título y la descripción meta.
La que más se saltea es la frase de apertura por H2, y es la que más trabaja. Un encabezado es una promesa y la primera frase debajo es el pago; decidir esa frase mientras todavía estás leyendo la SERP es lo que mantiene a una sección en tema tres horas después. También es lo que hace que el plan lo pueda chequear una máquina, de lo que depende la segunda mitad de esta clase.
Leer el brief que devolvió nuestra corrida
El brief abrió con la intención, y esa decisión le da forma a todo lo que sigue. El nuestro leyó el término como mixto, mayormente informacional con un filo comercial, y detectó el tipo de página como un post de blog que funciona de spoke bajo un pilar. Describió al lector como alguien que ya usa un asistente de código con IA y quiere delegar el trabajo de SEO, de nivel intermedio: sabe qué es un modelo de lenguaje y no tiene idea de cómo gobernar a un agente.
Después vino la tabla de competidores: cinco páginas, cada una con sus H2 principales, un largo estimado, un puntaje sobre 40 y su hueco principal. Los largos quedaron estimados en unas 3.300, 4.200, 4.000, 4.300 y 3.000 palabras, con un promedio de unas 3.750, y los puntajes fueron de 33/40 hasta 22/40. El brief también marcó que rompió su propia regla: la SERP de este término está casi toda tomada por proveedores de herramientas SEO, que su regla de exclusión manda filtrar, y los dejó porque son competidores reales de este sitio. Un brief que te dice dónde dobló su propia regla vale más que uno que se lee impecable.
Los huecos son la parte que justifica el artículo
Volvieron seis huecos, y son la única sección de un brief que puede justificar escribir algo. Tres eran huecos de tema: ninguna página competidora explicaba cómo frenar a un agente antes de que publique algo inventado, ninguna mencionaba que un escritor autónomo puede producir un segundo artículo para una keyword que el sitio ya cubre, y ninguna separaba el costo de la suscripción del agente del costo de los datos de búsqueda y de la herramienta. Dos eran huecos de profundidad, sobre cómo se conecta el agente a una herramienta y sobre dónde falla un agente. Uno era un hueco de calidad, al que esta clase vuelve más abajo.
Una lista de huecos es una afirmación que podés chequear, así que chequeala. Abrí dos de las cinco páginas, buscá adentro lo que el brief dice que falta y leé qué encontrás. Escribir una sección que la SERP ya cubre bien es cómo un borrador de 3.200 palabras se transforma en una tarde que no cambió nada, y la lectura del propio brief es el lugar más barato donde puede vivir ese error.
Un outline es un presupuesto de palabras con encabezados
El outline llegó como un H1, un slug, un objetivo de unas 3.200 palabras y ocho H2 con su presupuesto cada uno: 250 palabras para la definición, 450 para qué puede hacer, 450 para dónde falla, 500 para las barreras de control, 500 para el paso a paso, 300 para el costo, 300 para la comparación y 300 para las preguntas frecuentes, más una intro de 150 palabras y un cierre de 100. Dos secciones quedaron marcadas como objetivos de fragmento destacado, una con una caja de definición de 40 a 50 palabras y otra como pasos numerados.
El objetivo queda debajo del promedio de los competidores a propósito, con el razonamiento escrito al lado: la página gana por profundidad de evidencia en lugar de por largo. Esa es la forma correcta de un presupuesto. Los números por sección evitan que una introducción se coma el presupuesto de una sección, y un total más bajo que el de la competencia es una decisión que alguien puede discutir, lo que le gana a un número redondo que no eligió nadie.
People Also Ask es cobertura, y un outline es un argumento
Las preguntas cosechadas de una SERP te dicen con qué llega un lector, y nada más que eso. Pegarlas en orden como H2 produce una página sin ningún argumento que la atraviese, repite la redacción de un widget que cambia semana a semana y se lee como ensamblada en lugar de escrita. El propio outline del brief nunca hace eso: sus ocho H2 van definición, capacidad, falla, barreras, paso a paso, costo, comparación y preguntas frecuentes, que es un argumento con forma.
Cubrí las preguntas cosechadas adentro de las secciones que tu ángulo ya necesita, y descartá las que el ángulo no alcanza. Solo el bloque de preguntas frecuentes toma preguntas casi textuales, y el nuestro lo limitó a cuatro. La herramienta de investigación de seodraft devuelve People Also Ask, consultas relacionadas y dominios citados justamente para este uso, y sus propias instrucciones dicen lo mismo: esas preguntas son cobertura, y las que quedan fuera de tu ángulo se descartan.
seodraft guarda el plan antes del cuerpo
En seodraft el brief es un campo del borrador, escrito con upsert_post antes del cuerpo: intención, plantilla, ángulo, al menos tres piezas de evidencia de primera mano, el outline de H2 con la frase de apertura de cada sección y los slots de imagen que el cuerpo va a referenciar. Es un objeto separado de la investigación paga de la SERP, que le llega al agente como serpBrief y describe la competencia en lugar del plan.
Guardarlo primero es lo que hace posibles las reglas. run_gate lee el artículo terminado contra el plan guardado y nombra qué falló: brief-missing cuando nunca se escribió un plan, evidence-unaccepted cuando el plan se apoya en una pieza que el humano no aprobó, evidence-unused cuando una pieza que el plan nombró nunca llega al texto, answer-first en un H2 que abre con cualquier cosa que no sea su respuesta. Un plan escrito después del borrador coincidiría con el borrador por construcción, y ninguno de esos cuatro chequeos podría existir.
El banco de evidencia decide qué puede afirmar el artículo
Tres piezas aceptadas de evidencia de primera mano son el piso, y el banco es donde viven: un número medido, un caso con nombre, un error cometido, una credencial. Lo que dijo el humano y el agente solo transcribió entra como aceptado; todo lo que el agente infirió, midió o fue a buscar espera como pendiente hasta que un humano lo acepte. Un artículo cuyo brief se apoya en una pieza pendiente queda bloqueado, que es cómo una cifra que nadie respaldó deja de sostener el edificio.
Nuestro brief pidió exactamente esto en su sección de E-E-A-T: al menos tres piezas de primera mano, fuentes con fecha para las afirmaciones externas, una fecha visible de última actualización, un aviso cuando el artículo compara con el producto del propio autor y capturas reales. También sumó una línea que conviene copiar a tu propio estándar: si las cifras todavía no existen, medilas antes de escribir, y no inventes ninguna.
Un brief que señala números sin fuente puede llevar los suyos
El hueco de calidad que registró nuestro brief fue que los competidores publican cifras de ahorro de tiempo sin fuente, que un ranking no lleva fecha ni metodología y que ninguna de las cinco páginas muestra un caso con datos. El mismo documento presenta cinco largos de competidores etiquetados "Est. Words" y cinco puntajes sobre 40 de una rúbrica que aplicó él mismo. Esas son lecturas, impresas con la misma forma de tabla que una medición, y la tabla no lo aclara.
Leelo como un ejemplo trabajado más que como una falla. Todo brief generado mezcla tres clases de cifra: lo que se contó, lo que el modelo estimó y lo que leyó en una página. Preguntá cuál es cuál antes de que el brief salga de tu pantalla, como la clase 5 lo pidió para las estimaciones de volumen, y escribí la procedencia al lado de cada número. El nuestro sobrevive bien a la pregunta, porque la etiqueta "Est." está ahí a la vista; los puntajes son la parte que habría engañado a alguien apurado.
Qué llevarte al borrador
Cerrá tres cosas antes de que alguien escriba: qué H2 contesta qué pregunta con qué frase de apertura, cuáles son las tres piezas de evidencia ya aceptadas y de dónde salió cada número del brief. Guardá eso como el brief del borrador, así las reglas chequean el artículo contra el plan en lugar de contra el gusto, y así una segunda persona puede leer el plan y decir si el artículo lo cumplió.
Nuestra corrida además dejó sobre el escritorio dos hallazgos que le pertenecen a la etapa siguiente: un riesgo de canibalización entre el artículo planificado y un post que este sitio ya publicó, y un dato del producto que dos páginas enuncian distinto. Los dos son problema de un borrador ahora. Hacia ahí va el curso, a escribir con evidencia que se pueda rastrear, y la página de feature en features/content-brief muestra cómo queda el plan guardado una vez que está en su lugar.