Mapa de la ruta
🧬 Anatomía de un System Prompt
Las 6 secciones universales
🧱 Patrones estructurales
El esqueleto en 5 patrones
🗣️ Patrones de comportamiento
Cómo actúa y habla el modelo
⚠️ Antipatrones
Qué NO hacer
📖 Glosario esencial
Portugués claro: aclara los términos
Contenido detallado
🧬 Anatomía de un System Prompt
Las 6 secciones universales que estructuran cualquier system prompt eficaz —desde la identidad hasta el contexto dinámico— analizadas en prompts reales.
La capa de instrucciones persistentes que define el comportamiento del modelo antes de cualquier mensaje del usuario — el harness la compone con partes estables y dinámicas.
Distinguir el system prompt del mensaje del usuario, RAG, el contexto de la herramienta y system-reminder es el requisito previo para leer cualquier prompt sin confundir las capas.
Prompt estable · mensajes turno a turno · harness · contexto inyectado dinámicamente.
El ancla del prompt: persona + producto, modelo base y knowledge cutoff, declarados en la primera línea.
Sin ancla, el modelo se desvía: se convierte en otra persona, inventa capacidades o habla de eventos posteriores a su fecha de corte como si los conociera.
Persona · modelo base · knowledge cutoff · alcance de la misión ("your job is…").
Lista estructurada de herramientas con alcance y condiciones de uso; no un párrafo vago.
Una declaración débil genera promesas excesivas (ofrece lo que no puede) y uso insuficiente (ignora lo que existe). La especificación estructurada resuelve ambos problemas.
Alcance de la herramienta · condición de uso · firma de función · anti-over-promise.
La sección que declara rechazos y principios, ubicada al principio para señalar precedencia: la seguridad antes que la utilidad.
Una prohibición tajante se puede eludir; una regla con un porqué y la descripción de un patrón (no de una mecánica) se generaliza a situaciones nuevas.
Rechazo fundamentado · jerarquía seguridad > utilidad · patrón vs. mecánica · postura temprana.
Presupuesto de concisión, listas vs. prosa, uso de markdown y tono conversacional vs. técnico — la sección tone_and_style.
Evita dos antipatrones opuestos: una respuesta demasiado larga y una respuesta fragmentada en viñetas sin prosa coherente.
Presupuesto de concisión · prosa vs. lista · markdown contextual · tono calibrado al producto.
La capa que el harness inyecta en cada turno mediante <system-reminder>: fecha, usuario, avisos — separada del prompt estable.
Confundir lo que es estable con lo que se inyecta lleva a conclusiones equivocadas al leer un prompt filtrado y al comparar versiones con diff.
Harness · system-reminder · fecha actual inyectada · separación estable/dinámico.
🧱 Patrones estructurales
Los 5 patrones que dan FORMA al prompt — el esqueleto que aparece antes de cualquier regla de comportamiento, sin importar el dominio.
La distinción entre patrones que dan forma (esqueleto) y los que dan comportamiento (voz), con los 5 estructurales de este módulo.
La estructura es lo que puedes comparar con diff entre versiones y proveedores: hace que los prompts sean legibles y versionables.
Esqueleto · independiente del dominio · 5 patrones · con diff.
"You are X" + modelo + fecha de corte: el primer patrón y el único visto en el 100% de los prompts.
La identidad es un ancla, no una biografía — reconocer el patrón evita el antipatrón de una persona enterrada o inflada.
Persona · knowledge cutoff · alcance de la misión · 100% universal.
Lista estructurada en la que cada capacidad indica "qué hace", "cuándo usarla" y "límites", incluso como firma de función.
Visto en xAI, Google, Microsoft, Notion, Cursor y Claude Code; más elaborado en agentes que en chatbots puros.
Alcance · condición ("if the user…") · firma (params + defaults) · anti-over-promise.
Cada bloque lógico está envuelto en una etiqueta XML con nombre (<policy>, <tone_and_formatting>), plana y modular.
Es lo que hace que un prompt de miles de líneas sea fácil de mantener y que el diff entre versiones sea legible; en código, los encabezados Markdown cumplen esa función.
Bloque con nombre · plano (≤ 2 niveles) · fácil de comparar con diff · también Markdown.
El bloque <system-reminder> inyectado por el harness, separado del comportamiento estable del prompt.
Reconocer la capa dinámica evita atribuir al "prompt del modelo" lo que en realidad es contexto de runtime.
system-reminder · inyección por el harness · capa separada · contexto de runtime.
La precedencia declarada que resuelve conflictos: core policy > system > user > default.
Sin una jerarquía explícita, las instrucciones en conflicto dejan el comportamiento indefinido: el prompt debe indicar cuál prevalece.
Precedencia declarada · core policy · resolución de conflictos · combinación con <policy>.
🗣️ Patrones de comportamiento
Los patrones que dan VOZ al modelo — cómo actúa, decide y habla: reglas con porqué, contrastes ALWAYS/NEVER, contratos de herramientas y principios consolidados.
El paso del esqueleto (forma) a los patrones que rigen cómo el agente actúa, decide y se expresa.
Es donde residen la personalidad y la confiabilidad del agente: la diferencia entre un prompt que «obedece» y uno que «entiende».
Voz · comportamiento × estructura · gobernanza de decisiones · expresión.
Toda regla acompañada del motivo que la sustenta, en lugar de una orden seca.
La justificación permite que el modelo generalice a casos no previstos, en vez de obedecer mecánicamente y fallar en los límites.
Razón explícita · generalización · robustez en los bordes · intención por encima de la letra.
Par de instrucciones que fija el comportamiento deseado y el prohibido, uno junto al otro y en mayúsculas para darles peso.
El contraste elimina la ambigüedad del punto medio: el modelo sabe exactamente qué polo seguir y cuál evitar.
ALWAYS/NEVER · énfasis en mayúsculas · par deseado/prohibido · eliminación de ambigüedad.
Demostración concreta del comportamiento esperado (entrada → salida) vinculada a la regla abstracta.
Un ejemplo bien elegido fija mejor el comportamiento que tres párrafos de descripción: el modelo aprende por imitación.
Demostración · entrada → salida · aprendizaje por imitación · regla + ejemplo.
Instrucción explícita sobre la longitud ideal de la respuesta y cuándo ampliarla o recortarla.
Sin presupuesto, el modelo "rellena"; con él, calibra la densidad según el canal (terminal, chat, API).
Longitud objetivo · expandir/recortar · densidad por canal · antiverbosidad.
Las reglas de comportamiento sobre las herramientas: cuándo llamarlas, en qué orden, cómo encadenarlas y cuándo detenerse.
Declarar la herramienta no basta: el contrato de uso es lo que evita llamadas redundantes, fuera de orden o innecesarias.
Cuándo llamar · orden · encadenamiento · paralelismo vs. secuencia.
La regla de preservar literalmente los fragmentos que transmiten un significado exacto — citas, código, valores determinantes.
Resumir o parafrasear lo que es exacto introduce errores sutiles; el patrón enseña al modelo qué NO debe reescribir.
Verbatim · esencial · cita fiel · no parafrasear.
Un principio general que absorbe varias reglas puntuales en una sola instrucción de alto nivel.
Es la forma madura de un prompt: en vez de enumerar cada caso, declara el principio que los abarca todos; es más robusto y más breve.
Principio general · consolidación · alto nivel · robustez mediante abstracción.
⚠️ Antipatrones
Qué NO hacer: los errores recurrentes que sabotean un system prompt, desde el prompt cebolla hasta la inflación del énfasis, con el síntoma y la corrección de cada uno.
La lógica de estudiar lo que sale mal: cada antipatrón tiene un síntoma observable y una corrección conocida.
Saber el nombre del error acelera el diagnóstico: pasas de «el prompt está raro» a «esto es prompt-cebolla».
Síntoma · corrección · diagnóstico con nombre · catálogo de errores.
Prompt que crece por acumulación: cada incidente se convierte en una regla nueva, y nunca se elimina ni consolida nada.
Las capas se contradicen e inflan el contexto; la solución es consolidarlas en principios (ver módulo 1.3) y podar.
Crecimiento por adición · contradicción interna · inflación del contexto · poda.
"Never X" sin explicar la intención: lo opuesto a la Regla con Motivo.
Sin la razón, el modelo obedece literalmente, pero falla ante variaciones cercanas que infringen el espíritu de la regla.
Orden directo · falla en el límite · letra vs. espíritu · agregar el porqué.
Seguridad formulada enumerando términos/técnicas prohibidos, en vez de describir el patrón que se debe detectar.
La lista se puede eludir con sinónimos y, además, enseña qué evitar; describir el principio permite generalizar y es más seguro.
Lista de términos · eludible · patrón sobre mecánica · principio robusto.
Dos antipatrones hermanos: forzar listas/encabezados/emojis en todo y poner políticas, tono y herramientas en texto corrido.
Uno vacía la prosa hasta dejarla en un esqueleto; el otro hace que sea imposible versionar el prompt: ambos están depurados por el Compartimento XML.
Formato forzado · esquema sin prosa · bloques mezclados · compartimentar.
Abusar de CAPS, "CRITICAL", "ALWAYS" y la negrita — hasta que el énfasis pierda su valor como señal.
Si todo es urgente, nada lo es: el modelo no puede priorizar. El énfasis es un recurso escaso y debe usarse con criterio.
Exceso de CAPS · pérdida de señal · poco énfasis · priorización.
📖 Glosario esencial
¿Te trabaste con un término? Aquí tienes todo el lenguaje del curso en portugués claro, con una analogía de la vida diaria para cada palabra. No necesitas memorizarlo: es una chuleta para consultar siempre que la necesites.