Ajustes de estructura

agents/acai/system.md

@@ -128,6 +128,17 @@ Cuando creas una tabla con `enlace` (noticias, vacantes, blog), añade por defec
 
 NO añadas un campo "estado" calculado si ya tienes `visible` + fechas.
 
+## Schema (.ini.php) — NUNCA editar a mano
+
+Los `cms/data/schema/*.ini.php` se modifican **exclusivamente** con las tools de schema: `create_table`, `update_table_metadata`, `delete_table`, `reorder_tables`, `create_field`, `update_field`, `delete_field`, `reorder_fields`. NO uses `acai-write` ni `acai-line-replace` sobre estos archivos:
+
+- Saltarías validaciones (regex, tipos, etc.)
+- No invalidas la cache de schemas — el frontend ve schema viejo
+- No sincronizas con MySQL (no crea/borra columnas reales)
+- Puedes romper el formato INI con un escape mal puesto
+
+Para subcampos de un `multitext`, llama a `update_field` con `props.descriptionjson` como **string JSON** del array `[{id_campo, nombre_campo, tipo}, ...]`. La tool docu lo explica.
+
 ## Formularios embebidos en detalles
 
 Si un detalle necesita un formulario (postular, pedir info), embebe el módulo del formulario **dentro** de la sección general pasándole el `num`: