Desarrollo de Software con IA

Anatomía del prompt técnico: las ocho piezas de una instrucción profesional

Armar un prompt técnico con contexto, objetivo, arquitectura, restricciones, estructura, criterios de aceptación, pruebas y prohibiciones.

Dos formas de pedir lo mismo

Mano que escribe con lápiz una nota clara y recta sobre papel.
Un prompt no es un deseo: es una nota que se puede entregar. Si no la puedes releer como criterios de aceptación, la escribe la IA, no tú.

Mira el abismo entre estas dos instrucciones. La primera produce un juguete; la segunda, un producto:

Misma IA. La calidad del resultado es la calidad de la orden.
Instrucción amateurInstrucción profesional
Hazme una página de ventasUna landing para un curso online de fotografía, con sección de temario, tres planes de precio, testimonios y un formulario que valide el correo y guarde el lead en una tabla.

Las ocho piezas

El esqueleto de toda instrucción profesional

No necesitas las ocho piezas en cada prompt pequeño. Pero sí en todo entregable importante. Son el puente entre tu plano del módulo 2 y el código que la IA escribirá.

Un prompt completo, pieza por pieza

Un prompt de ocho piezas listo para copiar
# CONTEXTO
Soy dueño de una escuela de fotografia. Necesito captar alumnos desde Instagram.

# OBJETIVO
Una landing de una pagina que convierta visitas en registros de interes.

# ARQUITECTURA
Frontend con la landing. Backend con un endpoint guardar-lead. Base de datos con una tabla leads.

# RESTRICCIONES
Una sola pagina, sin login. Mobile-first. Carga rapida.

# ESTRUCTURA
index.html, styles.css, app.js, server con /api/leads.

# CRITERIOS DE ACEPTACION
- el correo se valida antes de enviar
- al guardar, el usuario ve un mensaje de exito
- los datos llegan a la tabla leads

# PRUEBAS
Envia un correo invalido, uno valido y un envio duplicado. Describe el resultado esperado.

# PROHIBICIONES
No uses librerias externas sin permiso. No almacenes el correo en el codigo. No inventes campos que no pedi.

Prueba

Un prompt menciona contexto, objetivo y arquitectura, pero la IA sigue entregando algo que «no era lo que quería». ¿Qué pieza clave falta casi siempre?

Las prohibiciones (decir qué NO hacer) son una pérdida de tiempo en un prompt.

Detecta el prompt débil

Un alumno escribió este prompt para su landing. Señala la línea donde FALTA una pieza real (es solo relleno):

  1. CONTEXTO: escuela de fotografía que capta alumnos desde Instagram.
  2. OBJETIVO: landing de una página que convierta visitas en registros.
  3. ARQUITECTURA: frontend, backend con endpoint y una tabla de leads.
  4. HAZLO MUY BONITO Y PROFESIONAL, GRACIAS.

Identifica la linea con error.

Reescribe, no lamente

Toma la peor instrucción que le diste a una IA esta semana y reescríbela con las ocho piezas. ¿Cuántas tenías? Casi nadie pasa de tres.

PistaLa próxima vez que un resultado te sorprenda, no culpes a la IA: revisa cuántas piezas le diste.