Cómo crear proyectos completos con Codex usando archivos .ia: la metodología para desarrollar software escalable con IA

Paso 2

Pedirle que construya el proyecto

Una vez creada toda la documentación, llega el verdadero prompt.

En lugar de decir:

Crea una aplicación NestJS.

Debemos decir algo como:

Lee completamente todos los archivos de la carpeta .ia.

No escribas código inmediatamente.

Primero analiza toda la documentación.

Identifica:

- Arquitectura
- Tecnologías
- Dependencias
- Dominio del negocio
- Módulos
- Relaciones entre entidades
- Servicios externos
- Convenciones de código

Luego genera un plan técnico de implementación.

Cuando el plan esté completo, comienza a construir el proyecto siguiendo exactamente la documentación.

No inventes funcionalidades.

Si existe alguna contradicción entre archivos, detente y genera un reporte indicando el conflicto antes de continuar.

Cada módulo debe ser construido de forma independiente y completamente funcional.

Después de terminar un módulo:

- ejecutar pruebas
- corregir errores
- verificar compilación
- verificar lint
- actualizar documentación

Solo cuando el módulo esté estable continúa con el siguiente.

Nunca rompas funcionalidades existentes.

Cada cambio debe ser incremental.

Mejor aún: hacerlo trabajar como un Senior Software Architect

Yo normalmente le agregaría instrucciones como estas.

Actúa como un Arquitecto de Software Senior con experiencia en sistemas SaaS de alta concurrencia.

Antes de escribir código:

1. Analiza completamente el proyecto.

2. Detecta riesgos técnicos.

3. Detecta dependencias.

4. Detecta cuellos de botella.

5. Detecta problemas de escalabilidad.

6. Detecta problemas de seguridad.

7. Propón mejoras sin modificar el negocio.

Solo después comienza la implementación.

Oblígalo a pensar antes de programar

Uno de los errores más comunes es dejar que Codex empiece a generar archivos inmediatamente.

Es mejor indicarle explícitamente:

No escribas ningún archivo hasta completar el análisis.

Tu primera respuesta debe contener únicamente:

- Resumen del proyecto
- Arquitectura detectada
- Riesgos
- Plan de trabajo
- Orden de implementación

Espera mi aprobación antes de generar código.

Esto evita que Codex tome decisiones apresuradas que luego son difíciles de corregir.

Paso 3

Construcción por fases

Una estrategia eficiente consiste en dividir el trabajo en etapas claramente definidas:

Fase 1

• estructura del proyecto
• Docker
• configuración
• CI/CD

Fase 2

• base de datos
• migraciones
• ORM

Fase 3

• autenticación
• autorización
• usuarios

Fase 4

• módulos del negocio

Fase 5

• APIs

Fase 6

• pruebas

Fase 7

• documentación

Fase 8

• optimización

Paso 4

Reglas que nunca deberían faltar

Incluye siempre reglas operativas como:

• Nunca eliminar código existente sin justificarlo.
• No duplicar lógica.
• Mantener arquitectura limpia (Clean Architecture).
• Aplicar principios SOLID.
• Seguir convenciones del proyecto.
• Escribir pruebas para cada funcionalidad nueva.
• Mantener cobertura mínima definida.
• Documentar automáticamente los cambios realizados.
• Actualizar los archivos .ia cuando la arquitectura evolucione.

El resultado

Cuando Codex trabaja con un conjunto completo de archivos .ia y un proceso disciplinado, deja de comportarse como un simple generador de código y pasa a actuar como un miembro técnico del equipo. Analiza, planifica, implementa por etapas, valida sus cambios y mantiene la coherencia de la arquitectura durante toda la vida del proyecto.

Esta metodología reduce retrabajos, mejora la calidad del código y permite construir aplicaciones SaaS complejas de forma mucho más predecible, especialmente cuando se trabaja con asistentes de IA en ciclos iterativos.