Empezar con Codikel.

Qué es Codikel

Codikel es una plataforma de modernización de aplicaciones legacy: conectás el repo de tu sistema viejo (Oracle Forms, COBOL, PowerBuilder, VB6, etc.), elegís un motor de migración, y en ~10 minutos te abrimos un Pull Request en ese mismo repo con el resultado — vault de conocimiento extraído, grafo de dependencias, test reports y (según el motor) el código generado en un stack moderno.

El PR es mergeable o sirve como auditoría del análisis. Tu código nunca sale de tu repo: usamos un installation token efímero (1 hora) por sesión.

Tu primera migración paso a paso

1. Crear cuenta

Vas a app.codacle.com/signup y te registrás con email + contraseña o vía OAuth (Google, Microsoft, GitHub). Te creamos automáticamente una organización personal — la podés renombrar después.

2. Elegir un motor

En el marketplace vas a ver los motores certificados disponibles. Cada uno define un par origen → destino:

• forms-fullstack — Oracle Forms XML → Vite + React (TS) + Express (TS) con tests.
• oracle-forms-apex — Oracle Forms (.fmb + .pll + .rdf) → análisis previo a migración APEX.
• oracle-forms-angular-nestjs — Oracle Forms → análisis previo a Angular + NestJS.

Algunos kits son understand-only: te entregan análisis (vault + grafo) sin generar código nuevo. Útiles para evaluar antes de comprometerse a una migración full.

3. Conectar tu repo

El wizard te pide instalar la App de Codikel en GitHub sobre tu cuenta u organización. Cada workspace mintea un token efímero (TTL 1h) para leer tus fuentes y escribir el PR de salida — no almacenamos credenciales long-lived en nuestro lado.

4. Validar fuentes

El wizard lista los archivos del repo que matchean lo que el motor pide (.xml, .fmb, etc.). Si falta algo obligatorio, te lo decimos en el mismo paso. Si todo está OK, descargamos los archivos a nuestro Storage y disparamos la pipeline.

5. Esperar la pipeline

A grandes rasgos:

Podés seguir el progreso en vivo: la tab Pipeline muestra cada fase con estado realtime, la tab Vault se va llenando de atoms a medida que el analyzer los emite, la tab Dependencias rinde el grafo cuando el engine termina.

6. Recibir el PR

Cuando el PR se abre, te llega un email con el link directo. En la UI también aparece la card "Tu Pull Request está listo" en la página de overview del workspace.

El PR está sobre una branch dedicada codikel/migration-<workspace-id> con la siguiente estructura:

codikel/
├── README.md                              ← qué es, cómo correrlo
├── frontend/                              ← Vite + React + TS (solo en kits que generan código)
├── backend/                               ← Express + TS (solo en kits que generan código)
└── migration/
    ├── atoms.md                           ← vault en formato markdown legible
    ├── dependency-graph.json              ← grafo estructural completo
    ├── migration-graph.json               ← IR UI-ready stack-agnóstico
    └── test-reports/                      ← reports JSON (solo en kits que generan código)
        ├── e2e-01-build-and-run.json
        └── e2e-02-functional.json

Idempotencia

Si re-corrés un motor sobre el mismo workspace, la misma branch codikel/migration-* se actualiza con la nueva versión. No se acumulan branches huérfanas en tu repo.

Cuándo mergear

Mergear el PR es opcional. Hay dos formas comunes de usarlo:

1. Como entrega final — si el código generado es lo que esperabas, lo mergeás y empezás a trabajar sobre la nueva base.
2. Como auditoría — si querés revisar el análisis antes de comprometerte con la migración, dejás el PR abierto como referencia. Mergealo más tarde o cerralo si decidís otro path.

Preguntas comunes

Mirá la sección FAQ en la landing o escribinos respondiendo el email de welcome — leemos cada uno.