jq/engineering

AI Engineering Transformation Sprint

Tus ingenieros ya usan IA.
Tu proceso de ingeniería no.

Dos semanas. Un workflow de ingeniería de alto valor. Lo rediseño como un sistema delegable a agentes —contexto, especificación, ejecución y verificación— manteniendo bajo control humano las decisiones que importan.

Terminas el sprint con el workflow corriendo en tu repositorio, medido contra una línea base y documentado para que tu equipo lo opere sin mí.

  • Alcance fijo
  • Dos puntos de aprobación
  • Antes/después medido
  • Sin permanencia

El diagnóstico

Los copilots aceleran el tecleo. El proceso alrededor sigue intacto.

Por eso la ganancia se estanca: el cuello de botella no era escribir código.

  1. 01

    El contexto se redescubre en cada tarea

    Estructura del repo, dependencias, restricciones no escritas. Cada ingeniero —y cada sesión de IA— empieza de cero.

  2. 02

    Los tickets expresan intención, no especificación

    Lo que no es ejecutable de forma determinista se convierte en handoff, y cada handoff es demora más pérdida de hilo.

  3. 03

    La verificación llega al final, donde cuesta más

    Pruebas y revisión ocurren después del trabajo caro: los errores se encuentran en el punto de mayor costo de corrección.

Generar más código no corrige ninguno de los tres. Rediseñar el workflow sí.

El sistema, completo

Qué corre, quién decide, qué queda escrito

Tres carriles. El agente ejecuta, el repositorio guarda contexto y evidencia, y tú decides en dos puntos. Nada se implementa antes de una especificación aprobada.

Carril1 · Solicitud2 · Contexto3 · Especificación4 · Implementación5 · Verificación6 · Merge
Humano
Define la intención y el criterio de negocio
Gate 1Aprueba la especificación antes de que se escriba código
Gate 2Aprueba el merge con la evidencia adjunta
Agente
Carga el mapa del repo y las reglas de arquitectura
Redacta la spec ejecutable: archivos, contratos, pruebas, riesgos
Implementa contra la spec, dentro de tus convenciones
Corre los checks y reporta qué pasó y qué no pudo resolver
Repositorio
context/ rules.md
specs/ NNN.spec.md
branch + diff
checks + evidencia
PR con spec y evidencia
  • decisión humana
  • ejecución
  • artefacto versionado

Un caso end-to-end

"Añadir un endpoint a un servicio existente"

Un workflow habitual, recorrido paso a paso. El tuyo lo elegimos en el discovery; la forma de la intervención es la misma.

Hoy

  1. 2 hUn ingeniero relee el servicio, sus dependencias y cómo se autentica
  2. 1 díaIda y vuelta en Slack para cerrar contrato, validaciones y errores esperados
  3. 1–2 dImplementación asistida por copilot, con decisiones tomadas al vuelo
  4. 1 díaPruebas escritas después; el revisor reconstruye la intención desde el diff
  5. + ?Retrabajo cuando aparece una restricción que nadie había escrito

Después del sprint

  1. minEl agente carga el mapa del servicio y las reglas ya escritas en el repo
  2. minPropone la spec: contrato, validaciones, errores, pruebas y riesgos detectados
  3. Gate 1Tú revisas la spec en una pantalla y la apruebas, corriges o descartas
  4. horasImplementación y pruebas contra la spec aprobada; los checks corren solos
  5. Gate 2El PR llega con spec, evidencia y lo no resuelto declarado. Apruebas el merge

Los tiempos de la columna izquierda son ilustrativos; en el sprint se miden los de tu equipo antes de tocar nada.

Etapa por etapa

Qué cambia, en concreto

EtapaHoyDespués
EntenderUn ingeniero lee el repo y pregunta por ahí.Mapa del repositorio y reglas de arquitectura como contexto legible por máquina, cargado en cada ejecución.
EspecificarUn ticket con intención, completado por chat.Spec ejecutable versionada: archivos, contratos, pruebas y riesgos. Aprobada por un humano.
ImplementarManual, con asistencia, y decisiones improvisadas.Ejecutado contra la spec aprobada, dentro de tus convenciones y tu toolchain.
VerificarPruebas al final; la revisión atrapa lo que alcanza.Los checks definidos en la spec corren automáticamente y el agente declara lo que no pudo resolver.
IntegrarCola de revisión, ida y vuelta, merge.Un cambio revisable con su spec y su evidencia adjuntas. Aprobado por un humano.

El engagement, de punta a punta

Forma fija, para que el riesgo sea visible

Dos checkpoints donde puedes redirigir o detener el trabajo. No se construye nada antes de que la especificación esté aprobada.

  1. Primera etapa01

    Mapear

    Recorro el repositorio, el toolchain y el workflow elegido. Cronometro el ciclo actual y cuento los handoffs: esa es tu línea base.

  2. Gate intermedio02

    Diseñar

    Defino el workflow objetivo: formato de especificación, responsabilidades del agente, fuentes de contexto, checks y gates humanos.

    Gate 1 — apruebas el diseño

  3. Segunda etapa03

    Construir

    Lo implemento en tu entorno: archivos de contexto, instrucciones de agente, automatización y capa de verificación. Se corre sobre trabajo real.

  4. Cierre y handoff04

    Medir y entregar

    Repito la medición, la comparo con la línea base y hago la sesión de handoff para que tu equipo lo opere y lo extienda.

    Gate 2 — aceptas el resultado

Cómo sabremos si funcionó

Medido sobre tu workflow, no sobre una promesa

Tomo la línea base en la primera etapa, antes de cambiar nada, y vuelvo a medir lo mismo al cerrar. Si los números no se mueven, también lo vas a ver.

No traigo benchmarks de otras empresas: las celdas se llenan con tus datos.

MétricaLínea baseAl cerrar
Tiempo de cicloDe la solicitud al cambio integradoSin medirSin medir
Esfuerzo humanoHoras-ingeniero y handoffs por cambioSin medirSin medir
CalidadRetrabajo, hallazgos en revisión, defectos escapadosSin medirSin medir

Las tres preguntas difíciles

Respondidas antes de que las tengas que hacer

  • "USD 5.000 en dos semanas: ¿qué garantiza el resultado?"

    El gate intermedio. Al cerrar la primera etapa ya tienes el diseño del workflow, la línea base medida y el alcance escrito: si no te convence, no seguimos a construcción y pagas solo el 50%.

    El criterio de aceptación del cierre se escribe en el gate intermedio, no al final: la decisión se toma sobre la evidencia producida, no sobre el calendario.

  • "No podemos darte acceso a nuestro repositorio."

    No hace falta acceso amplio. Tres opciones, de menor a mayor apertura: trabajo sobre un repo espejo o un servicio no crítico; trabajo en tu entorno con tus credenciales y tus modelos; o hago pair con un ingeniero tuyo que ejecuta y yo diseño.

    NDA, retención de datos y qué sale del perímetro se acuerdan antes de empezar.

  • "¿Y después del sprint, qué?"

    Tu equipo lo opera. Por eso la documentación de operación y la sesión de handoff son entregables, no un extra: el workflow tiene que sobrevivir sin mí.

    Si quieres extenderlo a un segundo workflow, es otro sprint con el mismo formato. No hay retainer ni dependencia.

Qué te queda, qué no es esto, qué cuesta

Alcance fijo

USD 5.000

fijo por engagement · ~2 semanas · 2 gates

Te queda

  • El workflow rediseñado, operando en tu repositorio
  • Instrucciones de agente, skills y archivos de contexto
  • Tus reglas de arquitectura escritas como restricciones legibles por máquina
  • El formato de especificación y los checks automáticos detrás
  • Medición de línea base y de cierre
  • Documentación de operación y sesión de handoff con tu equipo

No es esto

  • Rediseñar más de un workflow por sprint
  • Ejecutar tu backlog de producto
  • Reemplazar a tus ingenieros o a tus proveedores de tooling
  • Operación continua después del handoff, salvo acuerdo aparte
  • Una presentación de estrategia sin sistema corriendo detrás
  • Dedicación full-time, staff augmentation o una bolsa de horas

Cómo se trabaja

Es una intervención especializada con dedicación parcial y no exclusiva: el trabajo avanza principalmente de forma asincrónica, y las reuniones y checkpoints se coordinan de antemano. No incluye disponibilidad continua ni dedicación full-time a tu equipo: el compromiso es con el resultado acordado y con las fechas de los checkpoints, no con ocupar una agenda.

El precio es fijo por el alcance acordado: un workflow adicional, una integración nueva o un cambio significativo de alcance es otro engagement, cotizado aparte. La ventana de ~2 semanas se sostiene mientras los accesos, la información y las decisiones lleguen cuando se acordaron.

Empieza aquí

La primera pregunta no es cómo. Es cuál workflow.

Treinta minutos alcanzan para saber si tienes un workflow que valga la pena intervenir. Si no lo tienes, te lo digo y ahí paramos.

La conversación es técnica desde el primer minuto: no hay llamada de calificación previa.

Escríbeme por LinkedIn

Qué hacemos en esos 30 minutos

  1. Me describes dos o tres workflows que le cuesten más tiempo a tu equipo.
  2. Miramos dónde se va el tiempo de verdad y qué tan repetible es cada uno.
  3. Te digo cuál es el mejor candidato, o que todavía ninguno lo es.

Práctica independiente. Arquitectura de software, plataformas de ingeniería y adopción de IA. Un sprint a la vez.