tai-sql rules

tai-sql rules install          # instala/actualiza las de la versión que tienes
tai-sql rules install --force  # sobrescribe también lo editado a mano
tai-sql rules check            # ¿coinciden? Sale con código != 0 si no (para CI)
tai-sql rules diff             # en qué se diferencian

Instala en tu proyecto la documentación que un asistente de IA necesita para trabajar con tai-sql: el modelo declarativo, el ciclo de vida de los comandos, el catálogo de errores y una parte derivada de tu schema —tus tablas, tus relaciones, tus constraints—.

tu-proyecto/
└── .claude/
    └── rules/
        └── _platform/
            └── tai-sql/     ← esto lo escribe tai-sql

_platform/ no se edita

Lo pisa la siguiente instalación. Las reglas propias de tu proyecto van fuera de esa carpeta.

Por qué existe

Un asistente que no sabe cómo funciona tai-sql comete siempre los mismos errores: declara relation() en los dos lados, edita el código generado, escribe DDL a mano para «arreglar» la base de datos. Las reglas son la respuesta escrita a eso, y viajan con el paquete, así que describen la versión que tienes instalada, no la última publicada.

Se instala siempre a mano

Ningún otro comando escribe ahí. Lo que sí hacen push y generate es avisar al terminar si se han quedado obsoletas — sobre todo la parte derivada del schema, que cambia cada vez que cambias una tabla.

El aviso solo mira el schema que ese comando cargó

Si otro schema del proyecto se quedó atrás, push no lo dice. tai-sql rules check sí los mira todos, y por eso es lo que conviene poner en CI:

- run: tai-sql rules check