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.