Serie 01 — El problema real

Una spec le da pasos a un junior, no criterio.

Entregó en un día porque el agente es rápido. Dos semanas después el trabajo volvió, porque el proyecto vivía en la cabeza de otra persona.

01 — La escena

Al final del día ya tenía la funcionalidad

Un junior entra a un equipo que lleva meses usando un agente. En un día tiene la funcionalidad. Dos semanas después hay que revertirla, los tests pasan y aun así están mal, y nadie sabe por qué.

La explicación fácil es que es demasiado junior. La cierta es que recibió una tarea, un repositorio y un modelo, y nada más. No sabía qué decisiones ya estaban tomadas, qué tablas nadie podía tocar, ni qué patrón el equipo ya había rechazado. Así que adivinó. El agente adivinó con él.

No es la historia de un junior malo. Es la historia de un proyecto que nunca se escribió. Fue rápido porque el agente es rápido. Se equivocó porque el contexto era poco.

¿Quieres ver cómo funcionaría en tu proyecto? Agenda una llamada de 30 minutos para el piloto.

02 — Por qué SDD no lo salva

Una spec guarda el trabajo. No lo decide.

Spec Driven Development es una mejora real, y no alcanza. Cambia el orden: primero la spec, después las tareas, después construir contra esa spec. Obliga a decir qué se quiere antes de que el modelo empiece a escribir.

Una spec responde una pregunta. ¿Qué estamos construyendo ahora? No responde las que deciden si el resultado pertenece a este proyecto. ¿Qué decisiones ya están tomadas, y por qué? ¿Qué está prohibido aquí, aunque funcione?

Un junior puede escribir una spec limpia y aun así tomar una decisión que un senior no tomaría. La spec es un recipiente. Lo que entra depende de lo que el junior ya sabe. SDD ordena la entrada. No entrega criterio.

Los equipos adoptan SDD y el trabajo sigue siendo impredecible. El método se ve. El contexto que falta no se ve hasta que algo se rompe.

03 — Qué es un OS de proyecto

Escribe cómo funciona este proyecto

El sistema operativo de un proyecto no es una metodología, ni una herramienta. Es el conjunto de documentos que describen cómo funciona este proyecto, escritos donde una persona y un agente puedan leerlos.

El orden es el punto. Requisitos antes que arquitectura. Arquitectura antes que estándares. Estándares antes que el plan. Es el camino que ya recorre un equipo competente, escrito en lugar de recordado. Los modelos lo leen sin entrenamiento especial, sin importar el proveedor. Ese camino escrito es la huella del proyecto.

A un empleado nuevo no le entregas una metodología la primera mañana. Le muestras dónde está la verdad: los documentos, las decisiones, la historia. Después le das trabajo con un límite y un revisor. Un modelo necesita la misma bienvenida.

OrkAI mantiene disponible este conocimiento del proyecto. Woky lo utiliza para coordinar trabajo real de ingeniería.

04 — Qué le da el OS al junior

Cuatro preguntas, respondidas antes de interrumpir a nadie

Un CTO que conozco de cerca dirige la ingeniería de una startup temprana, con un equipo en Sudamérica y cinco juniors contratados para bajar el costo. En el día a día era el arquitecto principal y el principal engineer. Escribía más código que nadie, revisaba todo, entrenaba a los juniors y trabajaba más de doce horas al día. El proyecto vivía en su cabeza. Un junior de su confianza cargaba más que el resto. No había requisitos, ni arquitectura, ni estándares que un recién llegado pudiera leer. Todas las preguntas iban a la misma persona, que ya era el cuello de botella.

En julio pusieron a trabajar el sistema del proyecto. No cambió el equipo. Tampoco el modelo ni el editor: DeepSeek a través de Cline para el día a día, GLM 5.2 y 5.3 para planear. El proyecto simplemente tenía su huella cargada, y los juniors podían leerla.

Dejaron de preguntarle por el proyecto. El junior de su confianza hoy lidera a los otros cuatro y cubre DevOps. El CTO dejó de trabajar más de doce horas al día en esa startup, y recuperó tiempo para su propia consultoría. El CEO, que no sabe que el sistema existe, describió al equipo como muy rápido, con muy buena calidad de diseño visual, y le dio el crédito a la IA. Tenía razón a medias. La IA ya estaba. El resultado cambió cuando el proyecto dejó de vivir en la cabeza del CTO.

Qué no prueba este caso: es un caso, no una muestra. No hay horas de antes y después, ni una comparación controlada. El CEO ve al equipo, no al sistema. Es evidencia de lo que percibió, no de lo que lo causó.

05 — Qué configura el líder

Dejó de ser la persona por la que tenía que pasar cada pregunta

El trabajo del líder cambia. No desaparece. Antes, el CTO era la capa por la que pasaba todo: cada pregunta, cada revisión, cada decisión. Después, arma el ciclo — requisito, arquitectura, estándares, plan, hito, tarea —, decide dónde el trabajo tiene que parar para un sí, y decide qué el sistema no va a permitir. Actualiza la huella cuando cambia algo crítico. Sigue siendo el arquitecto principal. El trabajo mecánico que se comía su día pasa al sistema y al equipo.

Un sistema sin líder es una carpeta que nadie mantiene. El líder mantiene el mapa honesto, y decide qué preguntas merecen una regla nueva.

El onboarding cambia con eso. Un junior ya no aprende el proyecto interrumpiendo a quien lo sabe. Aprende cómo se construyó cada cosa que ya existe, desde el documento que la produjo.

06 — La objeción que merece respuesta

¿Lo escrito piensa por él?

Si el sistema le dice todo al junior, nunca desarrolla criterio. Se vuelve un operador de las decisiones de otro. El riesgo es real. No lo causa el contexto. Lo causa el contexto sin motivos.

El sistema no le dice qué decidir. Le muestra qué ya se decidió, y por qué. Así aprende un junior en un buen equipo: al lado de un senior, viendo cómo se toma una decisión, oyendo el intercambio, y tomando la siguiente. El documento es el razonamiento del senior, escrito. Si lo quitas, no aparece criterio. Aparece la adivinanza.

El junior con más criterio no quedó plano. Hoy lidera a los otros cuatro y cubre DevOps. Un sistema que convierte a la gente en operadores produce una cola, no un líder.

Se rompe cuando un líder escribe una regla para todo, no aprueba nada y a eso le llama sistema operativo. Si el documento explica una decisión, construye criterio. Si solo registra un permiso, construye dependencia.

07 — La decisión

Contrata juniors con el proyecto escrito y un líder encima. No los contrates esperando que un método más estricto reemplace la experiencia que todavía no tienen.

Estás vendiendo juniors baratos en lugar de seniors.

No. El CTO sigue siendo el arquitecto principal. El sistema le quitó el trabajo mecánico, no el rol. Un junior con el sistema no es un senior. Se le puede confiar más, antes.

Con el sistema el junior se vuelve un operador que no piensa.

Un operador es lo que sale de una lista sin motivos. El sistema lleva los motivos, y un registro. El junior que hoy lidera a los otros cuatro es la prueba en contra.

En mi proyecto nada de esto está escrito.

Aquí tampoco lo estaba. Vivía en la cabeza del CTO. Escribirlo es la primera semana del piloto, no un requisito para empezar.

Explora Woky con tu flujo de ingeniería.

Comienza con una conversación de 30 minutos. Juntos identificaremos si un Sandbox Ejecutivo o un Piloto Técnico es el siguiente paso adecuado.

Agendar una llamada de 30 minutos para el piloto
Marco

Fundador de Woky. Veinticinco años en software. Operaciones para 2 millones de usuarios y 50 millones en transacciones. Arquitecto, engineering manager, consultor. LinkedIn · woky.dev

Todos los posts