absorber-aplicacion
Tomar una aplicación EXISTENTE (con o sin documentación) y absorberla al ecosistema: inventariarla y radiografiarla con scripts (endpoints, entidades, estados, pantallas, reglas candidatas, integracio
SKILL.md.claude/skills/absorber-aplicacion/SKILL.md
GitHubAbsorber una aplicación existente
El template también sirve cuando la aplicación ya existe. Esta skill la lee entera y la vuelca al Cerebro con las mismas reglas que un documento funcional (nada entra sin un "sí" por ítem). Termina ahí, con el Cerebro poblado y la matriz de cobertura: qué se hace después con la aplicación (refactor en el lugar, migración, subir de versión o nada) lo decide la persona en [[planificar-modernizacion]].
Es el mismo pipeline, con otra fuente. Un documento funcional es texto que una persona escribió; una aplicación es texto que una máquina ejecuta. Las dos se leen, se proponen como borrador en
borrador/, se validan ítem por ítem y recién entonces entran al Cerebro ([[cerebro-orquestador]] §«Flujo de curaduría»). Lo que cambia es que acá la lectura la ordena un inventario.
Lo que NO hace
- No toca la aplicación existente. Ni un archivo, ni un commit, ni una rama. En migración no la toca nunca; en refactor la tocan las Tareas del pipeline, con red de tests primero, no esta skill.
- No decide refactor ni migración. Eso es [[planificar-modernizacion]]:
DEC-004la decide la persona y la escribecerebro-curatorcon su "sí". - No infiere reglas de negocio del código sin decirlo. Una validación en el código es una
regla candidata (
⚠), no una regla: puede ser un bug. Se marca de dónde sale y se pregunta. - No escribe en el Cerebro por su cuenta: lo hace
cerebro-curatorcon lo validado.
Fase 0 — Encuadre (un turno)
Antes de leer nada, se confirma con el humano, en criollo:
- Qué aplicación (ruta local del repositorio o del clon; si no está clonada, se clona afuera de este repositorio, en una carpeta que se pregunta).
- Qué se espera: sólo documentarla (ingeniería inversa: la skill termina en la fase 2, con el Cerebro poblado y la matriz de cobertura; no hay
DEC-004), refactorizarla, migrarla, o todavía no se sabe (es lo normal). - Qué parte: entera o un módulo. Entera es lo recomendable para el inventario; la lectura fina puede ir por módulo.
- Si la aplicación todavía no existe (hay sólo documentación: un Cerebro propio, ADR,
.feature, notas): no se absorbe como app. Los documentos entran por la curaduría de [[cerebro-orquestador]] (borrador enborrador/, Consulta Interactiva por ítem), los ADR comoDEC-nnnheredadas con su fecha y su origen, los.featurecomo Escenarios de sus Historias, las reglas no negociables como candidatas; el inventario y la radiografía se corren recién cuando haya código. - Si el proyecto ya trabaja con IA (tiene
CLAUDE.md, skills, comandos,.mcp.json): se releva primero conbin/relevar-config-ia.py <repo> --nucleo <núcleo>y se sigue adoptar-proyecto-existente.md: el repo se enchufa, no se muda; lo durable va al Cerebro ítem por ítem; suCLAUDE.mdqueda corto e importaAGENTS.md. - Qué NO se puede hacer: p. ej. "no se toca producción", "no se instala nada", "no se sube código afuera".
Fase 1 — Inventario (lo cuenta un script)
Si el proyecto entró por
bin/adoptar-proyecto.py, el relevamiento, el inventario, la radiografía y los diagramas ya están enborrador/adopcion/<fecha>-<nombre>/: se leen, no se vuelven a correr (misma fecha, mismo código).
python bin/inventariar-codigo.py <ruta-de-la-app> # resumen en criollo
python bin/inventariar-codigo.py <ruta-de-la-app> --json # para el borrador
Devuelve, sin criterio: lenguajes por extensión, archivos de build, pipeline, contenedores,
contratos de API (si no hay, es lo primero que falta), migraciones de base, proporción de tests,
deuda declarada, archivos que parecen secretos (sólo nombres), datos del repositorio y el bloque
«Para DEC-004»: las filas medibles de la tabla de estrategias de [[planificar-modernizacion]], ya medidas. Se guarda tal
cual en borrador/absorcion/<fecha>/01-inventario.md y, con el «sí», es la primera versión de
<modulo>/aplicacion/mapa.md. Si el script no corrió, la fase es SIN DATOS: no se reemplaza
con una impresión.
Fase 1-bis — Radiografía (lo señala un script)
python bin/radiografiar-codigo.py <ruta-de-la-app> # resumen por secciones
python bin/radiografiar-codigo.py <ruta-de-la-app> --json > borrador/absorcion/<fecha>/01b-radiografia.json # para la matriz de cobertura y el corpus de paridad (armar-corpus.py)
python bin/radiografiar-codigo.py <ruta-de-la-app> --mermaid > borrador/absorcion/<fecha>/01c-diagramas.md # modulos y ER, en texto
Si Archify está instalado en la máquina (opcional, DEPENDENCIAS-EXTERNAS.md), el diagrama interactivo
HTML va a borrador/absorcion/<fecha>/diagramas/; lo que entra al Cerebro sigue siendo el Mermaid.
Devuelve, cada hecho con archivo:línea: endpoints implementados y rutas del contrato, entidades,
tablas, enums y campos de estado (candidatos a máquina de estados), pantallas, reglas candidatas
(validaciones, condiciones que frenan con su mensaje, constantes con nombre, cambios de estado,
funciones de cálculo), integraciones (clientes HTTP, URLs y conexiones con credenciales enmascaradas,
mensajería, tareas programadas, autenticación), permisos con sus roles, y las dependencias entre módulos
con ciclos y cruces de capa. Se guarda en borrador/absorcion/<fecha>/01b-radiografia.md. La lectura de la
fase 2 empieza por lo que la radiografía señaló, módulo por módulo, y no al revés. Lo que la radiografía
no reconoce (un stack fuera de sus tablas) se dice; no se completa de memoria. El método entero —fuentes,
marcas de confianza, evidencia, cobertura— está en
ingenieria-inversa.md.
Fase 2 — Lectura y extracción (criterio, con la Consulta Interactiva)
Se lee de afuera hacia adentro, como manda entender-codigo-ajeno.md:
README y contrato → carpetas de primer nivel → un flujo entero → los tests → el historial. Por cada
módulo o flujo se completa un borrador en borrador/absorcion/<fecha>/02-<modulo>.md con estas
secciones, y cada ítem se marca con su origen (archivo:línea, test, commit) y su confianza:
| Sección del borrador | Qué va | Cómo se detecta | Destino en el Cerebro |
|---|---|---|---|
| Entidades y estados | Los sustantivos del negocio y sus ciclos de vida | Modelos, tablas, enums, transiciones en el código y en los tests | funcional/<ficha>.md (glosario y estados) |
| Roles y permisos | Quién puede hacer qué | Anotaciones de seguridad, chequeos de rol, pantallas por perfil | funcional/<ficha>.md |
Reglas candidatas ⚠ |
Validaciones, cálculos, condiciones, límites | Validaciones, ramas condicionales, aserciones de tests | funcional/<ficha>.md como RN-<MOD>-nnn sólo si el humano la confirma |
| Flujos | Los casos de uso de punta a punta | Endpoints, pantallas, jobs, colas | funcional/<ficha>.md con su bloque ## Derivación a backlog propuesto ⚠ |
| Integraciones | Con qué sistemas habla y cómo | Clientes HTTP, colas, bases, archivos | contexto.md §Integraciones |
| Decisiones implícitas | Lo que el código decidió sin que nadie lo escribiera | Estructura, patrones, librerías, convenciones | arquitectura/decisiones.md como DEC-nnn ⚠ |
| Mapa de lo que existe | Módulos, qué expone cada uno, integraciones y ambientes reales | Inventario, contratos, pipeline, lectura de un flujo | aplicacion/mapa.md |
| Deuda y riesgos | Lo que está mal o frágil | TODO/FIXME, tests ausentes, duplicación, secretos en el repo | aplicacion/deuda.md (DT-nnn) y la tabla de [[planificar-modernizacion]] |
| Dudas | Lo que el código no contesta | Comportamientos sin test, ramas muertas, nombres ambiguos | pendientes.md |
Cada afirmación lleva su marca de confianza: CONFIRMADO (sale del código y se cita con
archivo:línea), INFERIDO (se deduce de un patrón y puede estar mal: entra sólo como ⚠) o HUECO
(el código no lo contesta: P-nnn, nunca una suposición). Una regla candidata se presenta con su
evidencia —fragmento de 10 a 20 líneas, test que la cubre o «sin test», lo que no se sabe y una
pregunta— o no se presenta. Al cerrar la fase se entrega la matriz de cobertura
(borrador/absorcion/<fecha>/04-cobertura.md): cada módulo de la radiografía con su borrador, o marcado
HUECO: no leído. Un módulo que nadie leyó no es «sin reglas».
Cada ítem detectado dispara su propia Consulta Interactiva de Decisión (Guardar / Ignorar /
Editar y Guardar), con la paráfrasis fiel y el origen a la vista ([[cerebro-orquestador]]
§«Vigilancia Semántica»). Nada entra al Cerebro en bloque. Si son muchos, se agrupan por módulo
y se cierran por tandas, como en el modo lote: una tabla por módulo y un "sí" que escribe esa tabla.
Lo validado lo persiste cerebro-curator (frontmatter, wikilinks, log.md); las fuentes se
registran en fuentes.md como [DOC-nn] Código de <app>, commit <sha>.
Sin PHI. Si en el código, los fixtures o la base hay datos reales de personas, no se copian al borrador: se describe la estructura con marcadores y se anota como riesgo.
Lo que sigue (otras skills, no ésta)
Con el Cerebro poblado y la matriz de cobertura entregada, esta skill termina. Lo que viene tiene dueño:
| Qué | Skill | Qué produce |
|---|---|---|
Comparar estrategias con la tabla medida, curar cada regla (migrar / descartar / decide el humano), escribir DEC-004, ordenar los slices |
[[planificar-modernizacion]] | DEC-004 confirmada, fichas por slice, la tabla de aplicacion/modernizacion.md |
| Ponerle la red a un slice: corpus desde la radiografía, golden grabado contra la vieja, tests de caracterización | [[caracterizar-comportamiento]] | corpus.json, golden.json firmado, commits test(caracterizacion) |
| Ejecutar un slice: contrato del código viejo, construcción, paridad, corte con barrera, apagado | [[modernizar-slice]] | el slice avanza en modernizacion.md con su evidencia |
Las filas medibles de la decisión ya las trae el inventario (bloque «Para DEC-004»); el método de cada Tarea es
refactor-y-migracion.md. Sin DEC-004 confirmada no se arma ningún plan.
Barreras
- Sólo lectura sobre la aplicación existente, siempre. Si hay que clonarla, afuera de este repositorio y en una carpeta que se pregunta.
- Nada entra al Cerebro sin la Consulta Interactiva por ítem (o la tabla por módulo con su "sí").
- Una regla sacada del código es candidata
⚠hasta que una persona la confirme. El código puede estar mal. - Sin PHI: datos reales encontrados en código, fixtures o bases se describen con marcadores y se reportan como riesgo.
- Refactor o migración lo decide el humano con la tabla a la vista (
DEC-004). La skill no arranca el plan sin esa decisión. - Un inventario o una radiografía que no corrieron son
SIN DATOS, no una descripción de memoria. - Una regla candidata sin
archivo:líneay sin fragmento no se presenta: es una impresión. - La base y los logs se consultan sólo con un "sí", por esquema, conteos y agregados; nunca filas con datos de personas.
- Todo en español (Argentina).