Saltar a contenido

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—.

mi-proyecto/                 ← la raíz del repositorio (la que tiene el .git)
├── .claude/
│   └── rules/
│       └── _platform/
│           └── tai-sql/     ← esto lo escribe tai-sql
├── database/                ← el proyecto de tai-sql (.taisqlproject)
└── api/

Van a la raíz del repositorio, no a la carpeta del proyecto de tai-sql: el asistente carga al arrancar el .claude/rules/ de la raíz, y el de una subcarpeta solo cuando lee un fichero de dentro. Sin repositorio, van al proyecto.

_platform/ no se edita

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

Si las instalaste con la 0.7.11 o anterior

Estaban en database/.claude/rules/_platform/tai-sql/. tai-sql rules install las retira de allí —salvo lo que alguien haya editado, que avisa y deja— y rules check falla mientras quede algo.

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