Modelo Cyborg

De la intención a producción, con ingeniería

2026

Esto ya está construido así

Ingenia ATS, nuestra plataforma de selección de talento: API, web, conexión con asistentes de IA, infraestructura, pipeline y documentación operativa. Todo salió del mismo proceso que vamos a recorrer.

8
features especificadas
cada una con spec, plan y tareas
262
requisitos funcionales
numerados y trazables
720
tareas
cada una ligada a una historia
1.332
tests automatizados
en 232 archivos
13
decisiones de arquitectura
ADRs que el agente no puede contradecir
12
módulos de Terraform
toda la infraestructura en código
21
jobs de CI/CD
del merge request a producción
12
runbooks
uno por cada alerta o job que puede fallar

NestJSReactPostgreSQLMCPGCP · Cloud RunTerraformGitLab CISpec Kit

El modelo Cyborg en una imagen

BaseBuilding blocks instalables · Startia Governorskills · rules por stack · templates de spec · agentes revisores · plugins
▼▼▼▼▼▼
01
Intención
Historia, criterios de aceptación y métrica de éxito
Persona
→
02
Spec
Spec Kit: spec, clarificaciones, plan y tareas
Persona + agente
→
03
Implementación
Agentes que codean en sandbox, tarea por tarea
Agentes
→
04
Verificación
Tests, checks deterministas y agentes revisores
Agentes + máquina
→
05
Entrega
Infraestructura como código y CI/CD hasta producción
Pipeline
→
06
Operación
Alertas, runbooks y detección de cambios fuera de código
Pipeline + persona
▲▲▲▲▲▲
MemoriaEl agente no arranca de ceroconstitution · ADRs · specs · runbooks · brain de decisiones y aprendizajes (Engram)

Las personas definen la intención, aprueban la spec y deciden lo que es de riesgo alto. Todo lo demás corre solo y deja evidencia.

Formas de implementar con IA

AUTONOMÍA DE LOS AGENTES → CONTROL DE INGENIERÍA → Asistente en el IDE la persona escribe, la IA sugiere Vibe coding rápido, sin spec ni verificación Agentes sin método se controla solo el resultado final Cyborg autonomía alta, gobernada

Lo que cambia en el cuadrante de arriba

  • La spec se aprueba antes de escribir código
  • Cada cambio pasa por tests, checks y agentes revisores
  • La intervención humana depende del riesgo, no del volumen
  • Todo queda trazado: requisito, tarea, test y deploy

En industrias reguladas, como banca y salud, más autonomía solo sirve si el control crece al mismo ritmo.

Paso 1 · Building blocks instalables

No arrancamos ningún proyecto de cero. Cada etapa del ciclo tiene bloques listos, versionados y aprobados, que se instalan en el repo y en el pipeline del cliente.

Descubrir

product-intent-generatoranalyze-journeywrite-product-specvalidate-product-spec

Especificar

crear-specstory-technical-refinervalidate-user-storyprd-to-backlog

Diseñar

define-solution-architecturewrite-adrapi-designerfigma-a-landing-html

Construir

work-on-taskwork-on-sprintget-governed-rulesgenerate-dev-tasks-from-us

Verificar

code-reviewapi-security-validatorqa-engineergenerate-sprint-test-plantest-api

Operar y modernizar

gcp-devops-well-architectedmodernization-strategycode-technical-analysisplugin application-modernization
▼▼▼
Startia Governor · más de 80 skills aprobadas · rules por stack · templates de Spec Kit · plugins versionadoaprobaciónchequeo de solapamientométricas de uso

Un solo catálogo, servido por MCP, para Claude Code, Cursor, Copilot y OpenCode. Se puede empezar por un bloque, por ejemplo el revisor de seguridad, sin cambiar nada más.

Paso 2 · Spec-Driven Development con Spec Kit

La spec es la fuente de verdad y el código se deriva de ella. Las compuertas encuentran los problemas cuando todavía son baratos: antes de escribir código.

una vez
constitution
principios no negociables
decide una persona
→
1
specify
spec.md: qué y por qué, sin tecnología
decide una persona
→
gate
clarify
ambigüedades resueltas de a una
decide una persona
→
2
plan
plan, modelo de datos, contratos
agente
→
gate
checklist
calidad de los requisitos
agente
→
3
tasks
tareas chicas, ordenadas y verificables
agente
→
gate
analyze
coherencia spec ↔ plan ↔ tareas
agente
→
4
implement
código y tests, tarea por tarea
agente + checks
→
gate
converge
el código cumple la spec
agente + checks
Ejemplo real · ATS

Feature 008 · Procesos de selección y pipelines

41
requisitos
8
criterios de éxito
5
clarificaciones antes de codear
80
tareas trazadas
7
artefactos versionados

El proceso se adapta al tamaño y al riesgo

Clasificación

Antes de empezar, el agente mide el cambio

  • ¿Cuánto hay que entender para hacerlo?
  • ¿Qué riesgo tiene?
  • ¿Se puede retomar si se corta?

Nunca por cantidad de archivos.

Carril rápido

Tarea acotada

bug, ajuste, cambio entendido

un solo documentoimplementverificación

Intención, alcance, checklist y evidencia en una página. Spec Kit liviano.

minutos
Carril feature

Funcionalidad nueva

negocio, datos, APIs

specifyclarifyplantasksanalyzeimplementconverge

Spec Kit completo, con todas las compuertas.

horas
Carril largo

Épica o plataforma

trabajo autónomo sostenido

spec aprobadaagentes en paralelocola de decisionesreporte

Lo que el agente no puede decidir solo queda en una cola y sigue con lo independiente. La persona responde las decisiones, no revisa cada paso.

jornadas

Si en el camino aparece riesgo alto o una contradicción con una decisión registrada, el trabajo sube de carril solo.

La constitution: reglas que algo verifica

La constitution son los principios no negociables del proyecto. El agente la lee antes de cada plan, y cada principio tiene algo que lo verifica. Esta es la de ATS.

Principio I

Un núcleo, tres adaptadores

La lógica, los permisos y la auditoría viven en un solo lugar.

lo verifica Revisión contra la constitution

Principio II

Paridad web ↔ IA

Lo que se puede hacer en la web se puede hacer desde un asistente.

lo verifica Contract test por cada tool

Principio III

Seguridad y privacidad por defecto

Nunca datos reales en el repo. Permisos decididos en el servidor.

lo verifica Check de datos reales en cada MR

Principio IV

Trazabilidad total

Cada cambio de estado deja auditoría en la misma transacción.

lo verifica Tests de auditoría obligatorios

Principio V

Contratos primero

Un schema genera la API, las tools y los tipos de la web.

lo verifica OpenAPI generado en el pipeline

Principio VI

Tests como red de seguridad

Los tests de aceptación se escriben antes y fallan primero.

lo verifica Integración contra Postgres real

Principio VII

Fronteras verificadas

Un módulo no puede leer los internals de otro.

lo verifica Análisis de dependencias en CI

Principio VIII

Operabilidad

Nada se cambia a mano en la consola de la nube.

lo verifica Detección nocturna de drift

Principio IX

Documentación operativa

Sin runbook, la feature no está terminada.

lo verifica Runbook en el mismo MR

Paso 3 · Revisión por nivel de riesgo

Los PRs son automáticos. Lo que cambia según el riesgo es cuánta verificación corre y si hace falta la decisión de una persona.

Riesgo bajo

Merge automático

Documentación, textos, ajustes acotados.

  • Checks deterministas
  • Agente revisor
Riesgo medio

Merge automático con evidencia

Funcionalidad dentro de una spec aprobada.

  • Tests de aceptación en verde
  • Agentes revisores de código, seguridad y arquitectura
  • Converge: el código cumple la spec
  • La persona recibe el resumen, no el diff
Riesgo alto

Decide una persona

Autenticación, datos sensibles, migraciones, infraestructura, pipeline.

  • Todo lo anterior
  • Plan de infraestructura visible antes del merge
  • Aprobación explícita, con nombre y apellido
● Trabajando
→
● Verificando
→
● Listo
⇄
● Necesita tu decisión

El revisor corre con otro contexto y otras instrucciones que el agente que implementó. Si después de tres rondas de corrección no converge, escala a una persona.

Paso 4 · Pruebas

Deploy, promoción y rollback los scripts del pipeline tienen sus tests Flujos completos (e2e) contra el entorno de dev después de cada deploy Interfaz: accesibilidad, teclado y capturas 116 capturas de referencia, en escritorio y teléfono Unitarios e integración contra Postgres real cada caso de uso: un permiso permitido y uno denegado Checks deterministas tipos · lint · fronteras entre módulos · tokens de diseño · migraciones
1.332
tests automatizados
escritos por agentes, exigidos por la constitution

Primero falla, después pasa

Los tests de aceptación salen de la spec y se escriben antes que el código.

Lo que una máquina puede verificar no se le pregunta al modelo

El agente recibe el resultado y corrige hasta que pasa.

Paso 5 · Sandboxes

Los agentes trabajan con autonomía porque no pueden romper nada real. Cada anillo acerca el cambio a producción solo si pasó el anterior.

Anillo 1

Agente

  • Permisos acotados al repo
  • Sin credenciales de nube
  • La CLI de la nube está simulada
→
Anillo 2

Entorno local

  • Base de datos en contenedor
  • Proveedor de identidad falso
  • Solo datos ficticios, verificado
→
Anillo 3

CI efímero

  • Postgres real descartable por corrida
  • Navegador fijo para las capturas
  • Cuenta de solo lectura para planificar infra
→
Anillo 4

Dev

  • Deploy automático al integrar
  • Pruebas de flujo completo
  • Infra aplicada por el pipeline
→
Anillo 5

Producción

  • Solo el mismo artefacto validado en dev
  • Un deploy a la vez
  • Rollback sin tocar la consola
Sin llavesEl pipeline se autentica con identidad federada: no hay claves de servicio guardadas en ningún lado. Las cuentas de planificar, aplicar y desplegar son distintas.

Paso 6 · Infraestructura como código

Personas (web) Asistentes de IA Load balancer+ firewall de aplicación API · Cloud RunREST + MCP Web estática · GCS PostgreSQL · Cloud SQLred privada Cola de eventosCloud Tasks Tareas programadas Job de migraciones TRANSVERSAL RedSecretosImágenesMonitoreo y alertasIdentidad del pipeline
12
módulos de Terraform
dos entornos, dev y prod, desde el mismo código

Nadie aplica a mano

El plan se ve en el merge request. La aplicación la hace el pipeline.

Drift nocturno

Cada noche se compara la nube real contra el código. Si alguien tocó algo por fuera, avisa.

Paso 7 · CI/CD completo, generado por IA

Del merge request a producción en cinco etapas y 21 jobs. El pipeline lo escribieron agentes a partir de los requisitos de la spec, y también tiene tests.

Etapa 1

Verificar

linttypecheckunitintegrationdepcruiseuicheck-ui-tokensmigrationsbuildtf-plandriftdocs-only

Un MR que solo cambia documentación no gasta pipeline.

→
Etapa 2

Infra

tf-apply-dev

Terraform se aplica solo.

→
Etapa 3

Construir

build-imagebuild-web

Un artefacto por commit.

→
Etapa 4

Dev

deploy-deve2e-dev

Deploy y pruebas de flujo.

→
Etapa 5

Producción

promote-checktf-apply-prodpromote-prodrollback-prod

Solo entra lo que ya corrió sano en dev.

El impacto se ve antes

Todo cambio de infraestructura muestra su plan para dev y prod en el merge request.

Promoción verificada

Un job comprueba que dev está sirviendo exactamente esa versión y que está sana.

Vuelta atrás de un clic

El rollback es un job del pipeline, con su runbook.

Trazabilidad de punta a punta

Cualquier línea se puede seguir hasta el requisito que la pidió. Un ejemplo real de ATS: "a producción solo llega lo que ya corrió sano en dev".

Requisito
Promoción explícita y verificada
spec.md · FR-026
→
Decisión
Rama por entorno
ADR-011 · research R22
→
Tareas
Test primero, script después
tasks.md · T077 → T081
→
Código
Script y su test
promote-check.ts · .test.ts
→
Pipeline
Job que bloquea la promoción
promote-check
→
Operación
Runbook de promoción
ramas-y-promocion.md
.gitlab-ci.yml · así empieza el archivo
# Pipeline de Ingenia ATS (ADR-011, FR-024 a FR-030). Una rama por entorno:
#   MR a main   -> verify (+ terraform plan si toca infra/)
#   push a main -> verify, infra, build, deploy-dev (+ e2e)
#   push a prod -> promote-prod (valida que dev sirve ese SHA sano)
promote-check:
  script:
    # Rechaza si dev no sirve este SHA o no está sano (R22).
    - pnpm exec tsx scripts/promote-check.ts

Auditable por diseño

Ante una auditoría o un incidente, la respuesta a "¿por qué existe esto?" está escrita y versionada.

Cualquiera retoma

El conocimiento está en el repo, no en la cabeza de quien lo hizo.

Memoria: el agente no arranca de cero

Un agente sin memoria inventa. Con memoria, retoma donde quedó el equipo. Trabajamos con tres capas.

Capa 1 · vive en el repo

Memoria del proyecto

  • Constitution: los principios
  • ADRs: las decisiones de arquitectura
  • Specs, planes y tareas de cada feature
  • Runbooks de operación

qué construimos y por qué

Capa 2 · Startia Governor

Memoria de la organización

  • Skills y procedimientos aprobados
  • Rules por stack
  • Templates y metodologías
  • Compartida entre proyectos y equipos

cómo trabajamos

Capa 3 · brain (Engram)

Memoria de trabajo

  • Decisiones tomadas en cada sesión
  • Bugs resueltos y su causa
  • Descubrimientos y convenciones
  • Resumen de sesión, consultado al iniciar la siguiente

qué aprendimos haciendo

Un aprendizaje se repite en el brain
→
Se promueve a rule o skill en Governor
→
Llega a todos los repos y agentes

Gobierno: mejora continua y medición

Un error se corrige una sola vez El agente se desvía Queda en el brain Se propone una rule Se revisa y se aprueba Llega a todos los repos
Entrega

DORA contra la línea base

Lead time, frecuencia de deploy, tasa de fallas y tiempo de recuperación.

Calidad

Hallazgos antes del merge

Lo que encontraron los revisores y lo que volvió por ambigüedad en la spec.

Adopción

Uso de building blocks

Qué skills usa cada equipo y el nivel cyborg de cada persona.

Costo

Tokens por feature

Medido desde el primer día, para decidir con datos.

Demo · una feature real, de punta a punta

Recorremos una feature real de ATS, de la intención a producción, sobre el repositorio.

Parada 1

Los principios

.specify/memory/constitution.md

Lo que el agente no puede romper.

Parada 2

La spec y sus clarificaciones

specs/008-…/spec.md

Qué se construye y qué se preguntó antes de codear.

Parada 3

El plan y los contratos

plan.md · data-model.md · contracts/

Cómo se construye, atado a los ADRs.

Parada 4

Las tareas

tasks.md

Chicas, ordenadas, cada una ligada a una historia.

Parada 5

Tests e infraestructura

apps/api/test · infra/terraform

La red de seguridad y la nube, en código.

Parada 6

El pipeline

GitLab · .gitlab-ci.yml

Del merge request a producción.

Preguntas frecuentes

¿Un agente puede revisar lo que escribió otro agente?

Sí, porque corre con otro contexto y otras instrucciones. Y lo que se puede verificar con una máquina (tipos, tests, fronteras, seguridad estática) no se le pregunta al modelo.

¿Qué pasa con los datos sensibles?

Los agentes trabajan con datos ficticios y sin credenciales de nube. Hay un check que impide que entren datos reales al repositorio.

¿Quedamos atados a una herramienta?

No. Spec Kit es abierto, las specs y las reglas viven en su repositorio, y el catálogo se sirve por MCP a Claude Code, Cursor, Copilot u OpenCode.

¿Funciona sobre sistemas existentes?

Sí. Se arranca derivando la constitution del código real y con un primer cambio acotado. El carril rápido existe para eso.

Modelo Cyborg

La autonomía de los agentes la da el método.

Building blocks, specs, verificación, sandboxes y memoria.

Ingenia — De la intención a producción, con ingeniería

¡Muchas gracias!

Conversemos

De la intención a producción, con ingeniería