Desarrollo de Software con IA

El documento maestro: un archivo que dirige a la IA todo el proyecto

Redactar el documento maestro (STACK.md) con arquitectura, reglas, estructura y criterios que se pega en cada sesión con la IA.

La IA empieza de cero en cada chat; tu documento no

Un modelo no recuerda tu proyecto entre sesiones. Cada chat nuevo es un empleado brillante que no ha visto nunca tu casa. Si no le das el plano, reinventará la cocina cada vez. El documento maestro es ese plano vivo: un archivo (llamémoslo STACK.md) con todo lo decidido, que pegas al inicio para que la IA construya dentro de tus reglas sin preguntarte lo ya resuelto.

Las cinco secciones que convierten el archivo en tu memoria externa

El esqueleto del documento

No es un testamento técnico: es una ficha de una o dos pantallas. Este esqueleto ya dirige a la IA mejor que cualquier «hazme una app»:

Un STACK.md que ya dirige
# STACK.md — Agenda de contactos\n\n## 1. Que es\nApp para guardar y buscar contactos. Usuario: persona con clientes que pierde tiempo en hojas de calculo.\nMVP: crear, listar, buscar, editar. NO incluye: importacion, grupos, nubes.\n\n## 2. Arquitectura\nFrontend (lista + formulario) -> API -> Backend -> tabla SQLite `contactos(id, nombre, telefono, email, creado_en)`.\nTecnicas: las que la IA elija, pero una sola pagina, sin frameworks pesados.\n\n## 3. Contratos\nGET /contactos?query= -> ver ficha en contratos.md.\n\n## 4. Reglas\n- Validar email en backend, no solo en el navegador.\n- Nunca borrar sin confirmacion.\n- Prohibido: guardar contraseñas o datos sensibles sin pedir antes.\n\n## 5. Criterios\nUn contacto creado aparece en la lista al recargar; buscar por nombre devuelve solo coincidencias.

Cómo se usa en la práctica

El ritual Empieza cada prompt así: «Contexto: este es mi STACK.md, respétalo. [pega el archivo]. Hoy construyo SOLO [pieza], según su contrato. No cambies decisiones ya fijadas». Terminas cada hito actualizando el archivo con lo nuevo decidido.

Para profundizar

Contexto, restricciones y alcance: lo que la IA necesita saber
OA publicado en «IA Aplicada y Negocios Digitales» sobre dar contexto a la IA. El documento maestro es la versión persistente de esa idea para todo el proyecto.

Prueba

¿Cuál es el problema real que resuelve el documento maestro?

El documento maestro debe escribirse una vez y no tocarse nunca más.

Detecta el documento que no dirige

Un alumno muestra su STACK.md. Señala la sección que está mal y hará que la IA improvise:

  1. «2. Arquitectura»: Frontend -> API -> Backend -> base de datos, con las tablas.
  2. «4. Reglas»: validar en el backend, no borrar sin confirmar, no guardar datos sensibles.
  3. «3. Contratos»: la IA decide los formatos de datos que le parezcan mejores.
  4. «1. Qué es»: alcance MVP claro, con lo que queda fuera explícito.

Identifica la linea con error.

Escribe el STACK.md de tu proyecto con las cinco secciones. Luego inicia un chat nuevo con la IA, pégaselo y pídele una pieza: observa cómo ya no te pregunta lo que ya decidiste.

PistaLa señal de que tu documento funciona es que la IA deja de hacerte preguntas de arquitectura y pasa a preguntas de detalle.