Incorporar un servicio heredado
Un recorrido ilustrativo de lo primero que hacen la mayoría de los equipos: tomar un repositorio existente y poco documentado y hacerlo pilotable por agentes — sin perturbar lo que ya funciona.
- 01 Analizar
- 02 Razonar
- 03 Incorporar
- 04 Verificar
reconciliar, nunca sobrescribir
El objetivo
“Haz que este servicio de cinco años sea AI-first.” Ya tiene un README parcial, algunos docs dispersos y ningún AGENTS.md.
La ejecución
El desarrollador le da a su agente una sola línea — lee y sigue /init.md — y el flujo de incorporación:
- Reconocimiento. Detecta el lenguaje real, el gestor de paquetes (a partir del lockfile que existe) y los comandos reales de build, test y lint — leyendo el repo, no asumiendo.
- Propone un plan y pregunta. Como ya existen artefactos, es no destructivo: lista lo que creará frente a lo que reconciliará, y espera la aprobación antes de tocar el
READMEparcial o los docs dispersos. - Genera el harness. Un
AGENTS.mdrazonado con los Comandos Rápidos reales del servicio, un árboldocs/categorizado que absorbe las notas existentes en lugar de duplicarlas, READMEs por módulo, el kit.agents/y un.dwp/ignorado por git. - Verifica.
/dwp-verifydevuelve un informe objetivo de aprobado/fallido frente a los criterios de conformidad.
Resultado
El servicio heredado se vuelve AI-first sin destruir nada: el trabajo existente se fusiona, no se sobrescribe, y el resultado es comprobable en lugar de afirmado. Desde aquí el equipo planifica y ejecuta trabajo real con /dwp-create y /dwp-execute.