← Lumbre

Desarrollo de Software con IA El documento maestro: un archivo que dirige a la IA todo el proyecto

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

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

✦ Cada vez que abres un chat nuevo con la IA, ella no sabe nada de tu proyecto: ni su arquitectura, ni sus reglas, ni lo que ya decidiste · Desarrollo de Software con IA · en menos de 7 minutos

Roadwise Consulting

Contenido modificado tras su publicación

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

7 min Desarrollo de Software con IA 15–99 años
Modo PPTX
Más
El documento maestro: un archivo que dirige a la IA todo el proyecto

Herramientas de la lección

Sorpréndeme

Sobre este contenido

Ir a

Volver a Módulo 5 · Planos y contratos entre piezas Cursos Explorar Mi cuenta Salir del modo estudio

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

  • STACK.md
    • 1 · Qué es
      • Problema y usuario
      • Alcance MVP
    • 2 · Arquitectura
      • Piezas y conexiones
      • Tecnologías elegidas
    • 3 · Contratos
      • Entra / sale / error
    • 4 · Reglas
      • Restricciones
      • Prohibiciones
    • 5 · Criterios
      • Cómo se sabe si está bien

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

markdown
# 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.
Pega este archivo al inicio de cada sesión. Cambia el archivo, no tu memoria: así la IA siempre ve lo mismo.

Cómo se usa en la práctica

Para profundizar

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:

Marca la línea o las líneas con error y pulsa Comprobar.

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.

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

Tu texto se guarda sólo en este dispositivo.

Las respuestas y tu progreso se guardan sólo en este dispositivo. Contenido firmado por su autoría mediante Lumbre.
Más sobre esta lección

Comentarios

Inicia sesión para comentar.

Todavía no hay comentarios. Sé la primera persona en opinar.