ajustes coder

docs/mcp-tools-reference.md

@@ -35,6 +35,8 @@
 | `navigate_browser` | Navegación | Navegar el browser del frontend a una URL |
 | `save_project_styles` | Proyecto | Guardar resumen de estilos en docs/project-styles.md |
 | `rollback_git` | Git | Recuperar cambios de git remoto |
+| `get_layout_field` | Layout | Lee el source de los campos globales del layout.json: style, javascript, header, footer |
+| `set_layout_field` | Layout | Reemplaza un campo global del layout.json. **USA ESTA TOOL** para editar header/footer — NO toques los .tpl directos |
 
 ## Flujos de trabajo
 
@@ -116,3 +118,42 @@ Reglas:
 5. **recordId para imágenes** es el `num` de `builder_custom`, NO el sectionId del módulo
 6. Tras `set_module_config_vars`, TODAS las variables del módulo (incluyendo upload) reciben config-vars automáticamente
 7. Si el token expira (error 403), usar `refresh_acai_token`
+
+## Layout global (header, footer, style, javascript)
+
+Los 4 campos globales del proyecto (`style.css`, `script.js`, `header`, `footer`) viven en `cms/lib/plugins/builder_saas/layout.json`.
+
+### REGLA CRÍTICA
+
+**NUNCA uses `acai-view`, `acai-line-replace`, `acai-write` ni `acai-delete` sobre**:
+- `cms/lib/plugins/builder_saas/layout.json`
+- `template/estandar/modulos/custom-header-twig/*`
+- `template/estandar/modulos/custom-footer-twig/*`
+- `template/estandar/modulos/custom-header/*`
+- `template/estandar/modulos/custom-footer/*`
+
+Esos ficheros son **artefactos generados** a partir del `layout.json`. Editarlos directamente provoca:
+- Desincronización con `layout.json.{header,footer}ModuleCustom.htmlParsed`.
+- Sobrescritura de tus cambios cuando el usuario abre el builder visual y guarda.
+- Comportamiento inconsistente entre el render público y el builder.
+
+### Workflow correcto
+
+Para leer:
+```
+get_layout_field({ field: "header" })     // devuelve el source Twig del header
+get_layout_field({ field: "footer" })
+get_layout_field({ field: "style" })       // CSS global
+get_layout_field({ field: "javascript" })  // JS global
+```
+
+Para editar:
+```
+set_layout_field({ field: "footer", content: "<footer>...nuevo HTML/Twig...</footer>" })
+```
+
+El backend:
+1. Escribe el source en `layout.json.{field}`.
+2. Sincroniza `layout.json.{field}ModuleCustom.htmlParsed`.
+3. Regenera los `.tpl` del módulo `custom-{field}-twig/`.
+4. Compila el Twig a PHP.