🌱 Empieza aquí · Conexión contable de un ERP por su API (Odoo XML-RPC)

Esta semilla le enseña a tu asistente un método para tocar la contabilidad de tu ERP (sistema de gestión empresarial) por su API, no clic por clic en la pantalla, y hacerlo sin romper nada: primero lee el estado actual, luego te muestra en seco qué haría (un dry-run), y solo escribe cuando tú firmas. Después del cambio, relee y te confirma que cuadra. Carga sin duplicar y bloquea el borrado de libros contables. El ejemplo trabajado usa Odoo y su API XML-RPC.

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; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el método de conexión contable por API", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa que se ejecute solo. No lleva chmod, no lleva entrada en settings.json y no ejecuta ningún script durante la siembra. Se "siembra" colocando el método donde tú, el asistente, lo leas de forma automática al arrancar cada conversación, para aplicarlo cuando el usuario pida cargar u operar contabilidad por API.

El kernel trae dos archivos:

• kernel/conexion-contable-erp-xmlrpc.md — el método en sí (el que vas a seguir).
• kernel/caso-dry-run.ejemplo.md — un caso trabajado que usas como guía al aplicar el método (NO es una regla; no va en la carpeta de reglas).

1. Copia el método donde lo leas siempre

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/rules"
cp kernel/conexion-contable-erp-xmlrpc.md "$HOME/.claude/rules/conexion-contable-erp-xmlrpc.md"

Windows (PowerShell nativo):

New-Item -ItemType Directory -Force -Path "$HOME\.claude\rules" | Out-Null
Copy-Item "kernel\conexion-contable-erp-xmlrpc.md" "$HOME\.claude\rules\conexion-contable-erp-xmlrpc.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo el método. El caso de ejemplo NO va en esa carpeta: lo lees desde kernel/ cuando apliques el método.

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/conexion-contable-erp-xmlrpc.md). Si no, coloca el método dentro del proyecto y agrega una línea que apunte a él en el archivo de instrucciones del proyecto (el CLAUDE.md), por ejemplo: "Aplica el método de conexion-contable-erp-xmlrpc.md cuando haya que tocar contabilidad por API."

Codex: Codex lee su archivo de instrucciones AGENTS.md. Copia el contenido del método dentro de AGENTS.md (o agrégale un puntero al archivo si lo guardas aparte en el proyecto), para que se cargue con el resto de tus instrucciones.

2. Aterriza la conexión a ESTE sistema (cuando se vaya a usar de verdad)

El método NO trae credenciales (a propósito). Cuando el usuario vaya a usarlo contra su ERP, las cinco piezas de conexión se leen de variables de entorno, nunca escritas en el código:

export ERP_URL="https://<tu-instancia>"     # la URL de la instancia del usuario
export ERP_DB="<tu-base-de-datos>"          # el nombre de la base de datos
export ERP_USER="<tu-usuario>"              # el usuario del ERP
export ERP_API_KEY="<tu-llave-de-acceso>"   # una API key dedicada, NO la contraseña de login

Si el ERP no es Odoo, el método sigue aplicando: cambias los nombres de los métodos y los modelos de la API y conservas la mecánica (buscar antes de crear, dry-run, verificar releyendo). Deja los placeholders <...> si aún no hay una instancia; el método funciona igual como guía.

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 aplica de verdad.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/conexion-contable-erp-xmlrpc.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 aplica (prueba de comportamiento, en una conversación nueva): Pídele a la persona que abra una sesión nueva y te diga algo como: "quiero cargar una cuenta contable nueva a mi ERP". La conducta correcta es que NO escribas a ciegas: primero propones leer el estado actual (solo lectura), luego presentas un dry-run en lenguaje claro ("voy a crear esta cuenta si no existe") y pides la firma antes de ejecutar; además pides las credenciales por variable de entorno, no en texto plano. Si en vez de eso ofreces "crear la cuenta" de una sin leer ni simular, el método no se cargó: revisa que el archivo esté en la carpeta de reglas (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ó?

De ahora en adelante, cuando le pidas a tu asistente cargar u operar contabilidad en tu ERP, ya no va a "picarle y ver qué pasa". Va a leer primero el estado real, te va a enseñar en seco qué piensa hacer, va a esperar tu "va" y, después, va a releer para confirmarte que quedó bien.

Vas a notar tres cosas: cero duplicados (busca antes de crear), cero escritura a ciegas (siempre te muestra el dry-run antes) y cero "creo que quedó" (te confirma releyendo el estado real, no confiando en que el script no marcó error). Eso es todo. 🌱