Del todo a la migaja

Piezas y bloques de rompecabezas de madera sobre la mesa, a medio armar. — Nadie arma un rompecabezas de un solo movimiento: primero se separan las piezas. Un proyecto se vuelve construible para la IA cuando lo cortas en la jerarquía correcta.

Un software es una jerarquía de tamaños. Saber en qué escala estás pensando evita los dos extremos: pedir «toda la app» (imposible de revisar) o pedir un botón suelto sin saber dónde encaja. Estas son las cinco escalas:

De mayor a menor: el mismo sistema visto con cinco zoom

Las cinco, con ejemplo en un CRM

Cada escala contiene a la siguiente. Pedir en la escala correcta es pedir con tamaño razonable.
Escala	Qué es	Ejemplo
Proyecto	El producto completo	El CRM de la empresa
Módulo	Un área grande con su lógica y datos	El módulo de Clientes
Funcionalidad	Capacidad que logra un objetivo de usuario	Buscar y filtrar clientes
Tarea	Un paso concreto dentro de esa funcionalidad	Validar que el texto de búsqueda no esté vacío
Componente	Una pieza reutilizable por varias partes	El campo de búsqueda con su botón

La talla correcta La regla práctica: una pieza está en la talla correcta cuando puedes REVISARLA de una vez y PROBARLA de una vez. Si no, es demasiado grande; divide.

Ejemplo de mal tamaño

«Hazme el módulo de clientes completo» parece razonable, pero abarca buscar, crear, editar, borrar, importar, permisos y reportes. Es un proyecto disfrazado de funcionalidad. La versión a la medida sería:

Pedir en talla correcta

No pidas el modulo entero de golpe. Bajemos una escala a la vez:

FUNCIONALIDAD de hoy: que un usuario pueda buscar clientes por nombre.
TAREAS:
1) pantalla con un campo de busqueda
2) endpoint que devuelva clientes cuyo nombre coincida
3) mostrar resultados o «sin coincidencias»

Empieza SOLO por la tarea 2, con sus criterios de aceptacion. Te reviso antes de seguir.

Prueba

¿En qué escala está descrito «el campo de búsqueda reutilizable que aparece en varias pantallas»?

Pedir «hazme toda la aplicación» es un buen tamaño de pieza para empezar.

Detecta la escala equivocada

Un alumno organiza su proyecto. Señala el elemento que está mal clasificado (su tamaño real no corresponde a la etiqueta):

Módulo: área de Facturación con sus propias pantallas y datos.
Funcionalidad: crear una factura con sus líneas y totales.
Componente: botón «Guardar» reutilizable en varios formularios.
Tarea: todo el sistema completo con usuarios, clientes y reportes.

Identifica la linea con error.

Toma tu idea y escríbela en las cinco escalas: un proyecto, tres módulos, y para uno de ellos una funcionalidad, una tarea y un componente.

Pista

Si un «módulo» te sale enorme, probablemente sea un proyecto que necesita más divisiones.