Ejemplos

Un prompt por cada pieza de la guía

Cada bloque de abajo es el dicho de una fase, escrito como prompt. Los dos últimos juntan el roadmap: el mismo encargo, débil y efectivo.

Fase 01 · Anatomía

Rol, contexto, una tarea, restricciones, formato

Rol: Actúa como un arquitecto de software senior experto en AWS.
Contexto: Estamos migrando un monolito a microservicios.
Tarea: Diseña la arquitectura de red.
Restricciones: No uses bases de datos relacionales. Limita la respuesta a 500 palabras.
Formato: Devuelve una tabla Markdown y el código en bloques comentados.

Fase 02 · Técnicas

Few-shot

Dos a cinco pares de entrada y salida. El tono queda en los ejemplos, no en una descripción.

Clasifica el ticket. Responde solo con una palabra: bug, duda o pedido.

Entrada: La pantalla de pago se queda en blanco.
Salida: bug

Entrada: ¿Puedo pagar con transferencia?
Salida: duda

Entrada: Quiero dos unidades del mismo pedido.
Salida: pedido

Chain-of-Thought

La frase de razonamiento va al final. Sirve para lógica, no para una tarea común.

Tres servicios comparten una base y el pico es 2.000 req/s.
¿Cuál se parte primero?
Desglosa tu razonamiento antes de emitir el veredicto final.
Let's think step by step.

Delimitadores

La orden crítica queda al final. El texto fuente no se mezcla con la instrucción. Si inventa datos, se le corta el margen.

### Instrucciones
Responde solo basado en el texto provisto. Máximo 120 palabras.

"""
Pico: 2.000 req/s. Equipo de 6. Sin bases de datos relacionales.
"""

Let's think step by step.

Fase 03 · Patrones

Flipped interaction

Una pregunta cada vez, y espera. No un cuestionario entero.

Hazme preguntas de una en una sobre mi negocio hasta que puedas redactar un plan de marketing.
Espera mi respuesta antes de la siguiente pregunta.

Meta-prompting

El primer modelo escribe el prompt. No ejecuta el trabajo.

Escribe un prompt para otro modelo.
Debe pedir solo la arquitectura de red, con rol, contexto, una tarea, un tope de 500 palabras y una tabla Markdown.
No diseñes la arquitectura. Entrega el prompt.

Self-consistency · Tree of Thoughts

Varias rutas, una se descarta, queda la que cierra. Es para planear, no para clasificar un ticket.

Genera tres rutas para partir el monolito de pedidos.
Estima cuál tiene salida.
Descarta la que no cierra y quédate con la más sólida.

Fase 04 · Software

Desde cero

Escribe un componente React funcional
usando TypeScript y Tailwind CSS.
Usa hooks. No incluyas explicaciones,
solo el código.

Debugging

Analiza el siguiente stack trace paso a
paso, identifica la línea problemática,
explica por qué falla y luego provee
el código corregido.

Refactor

Métrica: reducir la complejidad ciclomática.
Reescribe la función sin cambiar el comportamiento.
No uses «mejóralo» como criterio.

Pruebas

Escribe tests en Jest.
Cubre el happy path y este edge case:
si items es undefined, el total es 0.

Fase 05 · Modelos

GPT-4o

Markdown, un rol definido y un solo bloque.

# Rol
Arquitecto de software senior, AWS.

# Contexto
Monolito de pedidos hacia microservicios.

# Tarea
Diseña solo la arquitectura de red.

# Salida
Una tabla Markdown. Máximo 500 palabras.

Claude 3.5 Sonnet

Las tres etiquetas separan contexto, orden y ejemplo.

<contexto>
Estamos migrando un monolito a microservicios.
</contexto>

<instrucciones>
Actúa como un arquitecto de software senior experto en AWS.
Diseña la arquitectura de red.
No uses bases de datos relacionales. Máximo 500 palabras.
</instrucciones>

<ejemplos>
Entrada: un servicio de pedidos acoplado a una sola base.
Salida: tabla de límites de red, una fila por servicio.
</ejemplos>

Gemini 1.5 Pro

Un ejemplo directo, una lista, y el manual entero cabe en el mismo prompt.

Lee el manual que va debajo de esta orden.
Devuelve una lista:
- límite
- motivo

Ejemplo:
Entrada: un servicio acoplado a una sola base.
Salida: una viñeta con el límite y el motivo.

[el manual completo va aquí]

Fase 06 · Método

Pipeline

Tres prompts. Ninguno hace el trabajo de los otros dos.

1. Clasifica
Etiqueta cada módulo: pedido, pago o inventario.

2. Extrae
Saca pico, tamaño del equipo y bases citadas.
No inventes cifras.

3. Redacta
Escribe solo la tabla de arquitectura de red.
Máximo 500 palabras.

Evaluación

La versión 2 se mide contra la 1 en un set. «Me gusta más» no cuenta.

Compara el prompt v2 con el v1 en estos 10 tickets.
Cuenta cuántos respetan las 500 palabras
y no inventan cifras.
No digas cuál te gusta más.

Los que cierran el roadmap

El mismo encargo, dos veces. La versión efectiva usa las piezas de arriba en un solo prompt, y deja fuera el trabajo que va en el siguiente.

Arquitectura, una sola tarea

Prompt débil

Hazme la arquitectura de mi app, el código, los tests y el plan de marketing. Que quede bien.
  • Cinco tareas en una frase. No hay rol, contexto, límite ni formato.
  • «Que quede bien» no es una métrica. El modelo inventa el resto.

Versión efectiva

Rol: Actúa como un arquitecto de software senior experto en AWS.

### Contexto
"""
Estamos migrando un monolito de pedidos a microservicios.
Pico: 2.000 req/s. Equipo de 6. Sin bases de datos relacionales.
"""

Tarea: Diseña solo la arquitectura de red.
No escribas código, tests ni marketing: eso va en prompts aparte.

Restricciones:
- No uses bases de datos relacionales.
- No inventes cifras que no estén en el contexto.
- Máximo 500 palabras.

Formato: una tabla Markdown (servicio, límite, motivo).

Ejemplo:
Entrada: un servicio de pedidos acoplado a una sola base.
Salida: tabla de límites de red, una fila por servicio.

Si falta un dato para decidir, hazme una sola pregunta y espera.
Genera tres rutas, descarta la que no cierra y quédate con la más sólida.
Responde solo con base en el texto provisto.
Let's think step by step.

Depuración, con estado del contexto

Prompt débil

Arregla este bug de React.
  • No hay código, ni stack trace, ni comportamiento esperado.
  • Sin stack ni framework de tests, la corrección no se puede comprobar.

Versión efectiva

Rol: revisor de TypeScript.
Stack: React 18, TypeScript 5, Jest. Componente funcional, solo hooks.

### Código
"""
function Total({ items }) {
  return items.reduce((sum, item) => sum + item.price);
}
"""

### Error exacto
"""
TypeError: Cannot read properties of undefined (reading 'reduce')
"""

Esperado: si items es undefined, devolver 0.
Métrica: cubrir happy path y ese edge case en Jest.

Analiza el stack trace paso a paso, identifica la línea,
explica por qué falla y luego entrega el código corregido y los tests.
Responde solo a partir del código y el error provistos.