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