
Paso 1: Definir qué vas a construir
Qué problema resuelve tu proyecto, quién será el usuario, qué necesita hacer ese usuario.
Ejemplo: “Quiero una aplicación web para registrar mis gastos personales, clasificarlos por categoría y consultar cuánto gasté en cada mes.”
Paso 2: Describir las funcionalidades en lenguaje natural
Explicá las funcionalidades que debe tener el proyecto y cómo debe comportarse cada una, tanto en situaciones habituales como cuando algo no sale según lo esperado.
Ejemplo: Para registrar un gasto el usuario ingresa importe, fecha, categoría y descripción. El importe acepta decimales y debe ser mayor que cero. La categoría debe existir previamente. Se permite ingresar un gasto sin descripción. Se deben rechazar gastos sin fecha, importe o categoría.
Paso 3. Identificar qué puede condicionar la implementación
- Presupuesto: ¿cuánto puedo pagar en servicios y herramientas?
- Infraestructura: ¿dónde se ejecutará cada parte?
- Datos: ¿qué guardo, dónde y por cuánto tiempo?
- Usuarios: ¿hay autenticación? ¿datos sensibles?
- Dependencias externas: ¿consumo APIs o servicios de terceros?
- Mantenimiento: ¿quién actualiza y mantiene el proyecto?
Paso 4. Usar IA para revisar la planificación antes de escribir código
Pedile que:
- Te haga preguntas sobre el proyecto.
- Detecte requisitos ambiguos o incompletos y casos límite que no contemplaste.
- Detecte conflictos con tus restricciones y riesgos de seguridad.
- Proponga alternativas técnicas con sus ventajas y desventajas.
- Sugiera una arquitectura y un plan de implementación.
El resultado de estos 4 pasos es tu guía para construir el proyecto.
Conclusiones
Es tentador escribir una idea general en Codex o Claude Code y pedirle que construya una aplicación. Pero eso deja lugar a que sea la IA quien tome las decisiones faltantes y a que después tengamos que invertir tiempo y tokens en corregir el rumbo. Sí, podemos pedirle que se detenga y nos pregunte cuando falte definir algo, pero entonces estaremos decidiendo a medida que construimos, y eso impide ver “el panorama completo” y detectar inconsistencias antes de empezar.
Si no sabés qué decisión técnica es más conveniente, podés pedirle a la IA que compare alternativas y explique sus consecuencias, pero es importante que seas vos quien decide y que tengas en claro por qué se usa cada cosa. Además, una decisión técnicamente correcta no necesariamente será la mejor para tu proyecto. Si es un proyecto que vas a “deployar” (es decir, ponerlo en funcionamiento para acceder a él, normalmente a través de internet), tendrás que tener en cuenta los costos y los límites de cada servicio (aunque uses servicios gratuitos).
El documento que construyas con el resultado de los 4 pasos de esta publicación es lo que normalmente se llama “especificación”. Pero esa especificación inicial es una guía, no un contrato inmutable. A medida que probás el proyecto, podés descubrir requisitos que no habías contemplado. En esos casos, actualizás las especificaciones y continuás trabajando.