Saltar a contenido

Reglas para asistentes de IA

Un asistente de IA que trabaja en tu proyecto no sabe lo que garantiza tai-storage: si upload_file sobrescribe, qué significa un ColumnTypeError o por qué no hace falta infer_types=False. tai-storage rules deja en tu repositorio unas reglas que se lo cuentan, escritas para la versión que el proyecto tiene instalada.

tai-storage rules install     # instalarlas o actualizarlas (--force pisa lo editado a mano)
tai-storage rules check       # ¿están al día? Código de salida 1 si no: sirve en CI
tai-storage rules diff        # en qué se diferencian de las de esta versión
# --root <carpeta> en los tres, si el repositorio no es el del .git más cercano
$ tai-storage rules install
📚 Reglas de tai-storage 0.2.2
   Destino: .claude/rules/_platform/tai-storage

   ✅ datos.md
   ✅ errores.md
   ✅ uso.md

✅ 3 ficheros escritos

Qué instala

En .claude/rules/_platform/tai-storage/ de la raíz del repositorio (la del .git más cercano, o --root):

Fichero Qué cuenta
uso.md Crear orígenes, rutas, leer y escribir, overwrite, dev_mode, coste de las operaciones
datos.md get_data(): sus garantías, formato español, tipos declarados, por qué no hace falta errors="coerce", el informe de analysis
errores.md Qué significa cada error y qué hacer; cómo depurar un servicio; los logs
_meta.json La versión instalada y la huella de cada fichero

Es la misma convención que siguen tai-sql y tai-api: cada librería de la plataforma instala sus reglas en _platform/<librería>/, y cada una lo hace con su propio instalador.

Si las editas

Las reglas son tuyas: puedes añadir lo propio del proyecto. install no pisa un fichero editado a mano (lo detecta por la huella de _meta.json) salvo con --force:

$ tai-storage rules install
📚 Reglas de tai-storage 0.2.2
   Destino: .claude/rules/_platform/tai-storage

   ⏭️  datos.md (sin cambios)
   ⏭️  errores.md (sin cambios)
   ✋ uso.md editada a mano: se conserva

⚠️  Hay ficheros que no se han tocado porque alguien los editó. Mira en qué difieren con 'tai-storage rules diff'; si quieres perder esos cambios, repite con '--force'.

ℹ️  No se ha escrito nada: lo que faltaba por actualizar está intacto.

$ tai-storage rules check
❌ Las reglas no están al día en .claude/rules/_platform/tai-storage

   ✋ uso.md: editada a mano

💡 Para volver a las de la librería: 'tai-storage rules install --force'.

tai-storage rules diff enseña el diff de cada fichero, en color.

Si quieres añadir reglas propias sin que check lo marque, ponlas en otro fichero fuera de _platform/.

En CI

- run: pip install -e .
- run: tai-storage rules check

Falla cuando se sube la versión de tai-storage y no se actualizan las reglas: el asistente seguiría trabajando con lo que decía la versión anterior.