🌱 Empieza aquí · Extraer los datos atrapados en tu ERP a un almacén analizable

¿Tienes un ERP o un sistema viejo lleno de datos que no puedes exportar de un jalón, que solo deja verlos de a poquito en pantalla? Esta semilla le da a tu asistente un método paso a paso para sacar todos esos datos por la API interna del sistema y aterrizarlos en un almacén que sí puedes consultar, cruzar y graficar. Sin tocar tu base de producción y sin depender de un ingeniero para cada reporte.

Lo mejor: el método viene con las trampas ya señaladas (las dos que más seguido rompen una extracción) y con una regla de oro para no cantar victoria antes de tiempo.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó. Vas a ver algunas palabras en inglés en la pantalla (upsert, snapshot, RLS); ni caso, tu asistente te las traduce cuando toque.

¿Otras formas de pedírselo? "instala esta semilla", "deja lista la receta para extraer mi ERP", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (un método de trabajo que se invoca cuando hay una tarea de extracción), no un programa ejecutable ni un hook. No lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script al instalarse. "Sembrarlo" es dejar el método donde tú, el asistente, lo puedas leer y aplicarlo cuando la persona te pida extraer datos de su ERP a un almacén.

El kernel trae dos archivos:

• kernel/extraccion-erp-a-almacen.md — el método completo (las 3 fases, las 2 trampas, los guardrails de seguridad y el criterio de aceptación).
• kernel/plantilla-extraccion.ejemplo.md — una plantilla para aterrizar el método al sistema y al almacén reales de esta persona (alcance, modelo de datos, conteos de control).

1. Coloca el método donde lo tengas a la mano

Tienes dos opciones, según qué tan seguido lo vaya a usar la persona:

Opción A · como receta bajo demanda (recomendada para la mayoría). Guarda el método dentro del proyecto, en una carpeta de recetas, y agrégale un puntero en el archivo maestro de instrucciones para saber que existe:

mkdir -p workflows
cp kernel/extraccion-erp-a-almacen.md workflows/extraccion-erp-a-almacen.md
cp kernel/plantilla-extraccion.ejemplo.md workflows/plantilla-extraccion.ejemplo.md

Luego, en el archivo de instrucciones del proyecto (CLAUDE.md en Claude Code / Cowork, o AGENTS.md en Codex), agrega una línea como: "Para extraer datos de un ERP/legacy a un almacén, sigue el método de workflows/extraccion-erp-a-almacen.md."

Opción B · siempre cargado (si la persona hace esto muy seguido). En Claude Code / Cowork puedes dejarlo como regla permanente:

mkdir -p "$HOME/.claude/rules"
cp kernel/extraccion-erp-a-almacen.md "$HOME/.claude/rules/extraccion-erp-a-almacen.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Úsalo solo si la extracción es una tarea frecuente; si es ocasional, la Opción A mantiene tu contexto más ligero.

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido de extraccion-erp-a-almacen.md dentro de AGENTS.md, o guárdalo aparte en el proyecto y agrégale un puntero, para que el método esté disponible cuando toque.

2. Aterriza el método a ESTE sistema (recomendado)

Abre kernel/plantilla-extraccion.ejemplo.md. Con la persona, llena el alcance (qué sistema, qué objetos, qué almacén, snapshot o incremental), el modelo de datos por objeto (clave natural, cabecera-detalle) y los números de control para verificar. Reemplaza los placeholders <ASI>. Guarda esa plantilla llena junto al método; será tu guion para la corrida real. Si la persona aún no sabe todo, deja lo que falte como por confirmar y pregúntalo cuando arranques; nunca lo inventes.

3. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el método se puede aplicar de verdad.

a) El archivo quedó colocado (ejemplo Opción A):

ls -la workflows/extraccion-erp-a-almacen.md; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El método se puede aplicar (prueba de comportamiento): Pregúntale a tu asistente, en una conversación nueva: "tengo un ERP con su propia API y quiero pasar el objeto de ventas a un almacén, ¿cómo lo hago sin duplicar y sin tocar la base de producción?". La respuesta correcta menciona las piezas clave del método: solo lectura sobre la fuente, upsert por clave natural (idempotente, no duplica), parar por el total de registros y no por número de páginas, seguridad por filas activa en el almacén, y verificar por conteo (el exit-code 0 no es prueba). Si no nombra esas piezas, el método no se cargó: revisa que el archivo esté en su carpeta (o dentro de AGENTS.md en Codex).

Cuando ambas partes pasen, avísale a la persona en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

La próxima vez que necesites sacar datos de tu ERP —para un reporte, un cruce, un tablero— tu asistente ya no va a improvisar ni a arriesgar tu base de producción. Va a seguir una receta probada: leer sin escribir, bajar todo (o solo lo nuevo), cargarlo sin duplicar, y comprobar contando que llegó completo antes de decirte "listo".

En corto: tus datos dejan de estar atrapados y pasan a un lugar donde por fin puedes trabajarlos, con la tranquilidad de que nada se tocó del lado del sistema que corre tu negocio. 🌱