Ajusets desde codex

docs/mcp-tools-reference.md

@@ -4,10 +4,12 @@
 
 | Tool | Categoría | Acción |
 |------|-----------|--------|
-| `compile_module` | Módulos | Compila módulo tras editar index-base.tpl |
+| `compile_module` | Módulos | Recompila manualmente un módulo cuando necesitas forzar la compilación sin editar el archivo |
 | `check_module` | Módulos | Preview de cómo renderiza un módulo |
 | `check_module_usage` | Módulos | Qué páginas usan un módulo |
 | `acai-view` | Archivos | Lee un archivo del proyecto por tramos |
+| `acai-glob` | Archivos | Busca rutas de archivos por patrón |
+| `acai-grep` | Archivos | Busca texto en archivos del proyecto |
 | `acai-line-replace` | Archivos | Reemplaza un bloque concreto en un archivo existente |
 | `acai-write` | Archivos | Crea o reescribe un archivo completo |
 | `acai-delete` | Archivos | Borra un archivo del proyecto |
@@ -39,7 +41,7 @@
 ### Crear un módulo nuevo desde cero
 
 1. `acai-write` — Crea `index-base.tpl`, `style.css`, `script.js` y cualquier hook necesario con rutas relativas al proyecto
-2. `compile_module` — Compila el módulo tras editar `index-base.tpl`
+2. `acai-write` o `acai-line-replace` compilan automáticamente al tocar `index-base.tpl`
 3. `add_module_to_record` — Añade el módulo a una página (tabla padre, ej: `apartados`)
 4. `set_module_config_vars` — Rellena las variables con contenido (textos, colores, opciones). **OBLIGATORIO** — sin esto el módulo no muestra nada. Devuelve:
    - `configVars`: mapa de variables → recordNums
@@ -53,20 +55,22 @@
 1. `get_module_config_vars` — Leer el estado actual del módulo (variables, recordNums)
 2. `acai-view` — Leer solo el tramo de `index-base.tpl` que se va a modificar
 3. `acai-line-replace` — Editar el bloque concreto. Usa `acai-write` solo si el archivo es nuevo o el cambio es masivo
-4. `compile_module` — **OBLIGATORIO** tras cada edición de index-base.tpl
+4. La compilación es automática tras cada edición de `index-base.tpl`
 5. Si cambias variables: `set_module_config_vars` para actualizar valores
 
 ### Editar archivos del proyecto con bajo consumo de tokens
 
 1. `acai-view` — Leer el archivo o un rango de líneas
-2. `acai-line-replace` — Reemplazar el bloque exacto en archivos existentes
-3. `acai-write` — Crear archivos nuevos o reescribirlos por completo si es necesario
-4. `acai-delete` — Borrar archivos solo cuando sea explícitamente necesario
+2. `acai-glob` — Encontrar archivos relevantes por ruta cuando no conoces el path exacto
+3. `acai-grep` — Buscar texto o atributos concretos dentro de archivos del proyecto
+4. `acai-line-replace` — Reemplazar el bloque exacto en archivos existentes
+5. `acai-write` — Crear archivos nuevos o reescribirlos por completo si es necesario
+6. `acai-delete` — Borrar archivos solo cuando sea explícitamente necesario
 
 Reglas:
 - Usa siempre rutas relativas al proyecto
 - No edites `index.tpl`, `index-twig.tpl` ni `builder.json` — son auto-generados
-- Tras editar cualquier `index-base.tpl`, llama a `compile_module`
+- Tras editar cualquier `index-base.tpl` con las file tools, la compilación se ejecuta automáticamente
 
 ### Añadir/modificar imágenes de un módulo
 

docs/module-creation-guide.md

@@ -39,7 +39,7 @@ Each module lives in `template/estandar/modulos/<moduleId>/` with:
 
 1. **Read style reference** (steps above)
 2. **`acai-write`** — Create the module files directly (`index-base.tpl`, `style.css`, `script.js`, optional `hook.php`) using project-relative paths and complete file contents.
-3. **`compile_module`** — Compile after editing `index-base.tpl` so the CMS syncs the generated output.
+3. **Automatic compile** — Writing `index-base.tpl` automatically creates the generated template placeholders and triggers compilation. Only use `compile_module` manually if you need to re-run compilation without changing the file.
 4. **`add_module_to_record`** — Adds the module to a page. Response includes `sectionId` — use it directly in the next step.
 5. **`set_module_config_vars`** — Fill variables with content. Response includes `uploadFields` with `{ fieldName, recordNum }` for each upload variable.
 6. **Upload images** — Use `generate_image` then `upload_record_image` with the `recordNum` and `fieldName` from step 5's `uploadFields`. No need to read builder.json or call get_module_config_vars.
@@ -73,6 +73,6 @@ Modules with `MJMLModule: true` in their schema are email modules:
 - Use `section_id` variable for unique anchors/scoping
 - Use `interno` variable to detect CMS editor vs public view
 - Include other modules with: `<module_id :param1="value1"></module_id>`
-- After editing `index-base.tpl`, ALWAYS call `compile_module`
+- Editing `index-base.tpl` with `acai-write` or `acai-line-replace` compiles automatically
 - Twig uses filters (with `|`), never functions
 - Twig concatenation uses `~`: `'value=' ~ variable`

docs/pages-and-records.md

@@ -70,7 +70,7 @@ The controlador defines whether the page is Builder or Standard. Changing it bre
 1. List current modules: `list_page_modules`
 2. Get module vars: `get_module_config_vars`
 3. Update vars: `set_module_config_vars`
-4. Or edit the module template: edit `index-base.tpl` → `compile_module`
+4. Or edit the module template: edit `index-base.tpl` with `acai-line-replace` or `acai-write` → compilation runs automatically
 
 ## Working with Standard Pages