docs: fuera el docs/ muerto y CLAUDE.md enlaza a los 13 canónicos

El docs/ de este repo era el set antiguo sin numerar: copy_scaffold lo omite desde
2026-06-11 y copia la canónica de agenticSystem/docs en cada web, así que ningún
cambio aquí llegaba a nadie (los PRs #1 y #3 lo editaban). Se sustituye por un
README que señala la fuente. CLAUDE.md apuntaba a esos 12 nombres, que no existen
en ninguna web: ahora enlaza a los 13 canónicos numerados. Nota de hooks por HTTP
(404 a propósito sin X-Hooks-Token → call_hook).

CLAUDE.md

@@ -40,7 +40,7 @@ Visual components that the site builder uses. Each module is a self-contained un
 - Each module instance gets a unique `section_id` variable for anchors/scoping
 - Use `interno` variable to detect CMS editor mode vs public view
 
-See [docs/modular-system.md](docs/modular-system.md) for detailed rules.
+See [docs/03-modules-and-sections.md](docs/03-modules-and-sections.md) for detailed rules.
 
 ### Pages
 Every record with an `enlace` field is a page. Pages are either **Builder** (modular) or **Standard**:
@@ -50,7 +50,7 @@ Every record with an `enlace` field is a page. Pages are either **Builder** (mod
 
 **Critical**: Never change `enlace` or `controlador` of existing pages unless explicitly asked.
 
-See [docs/pages-and-records.md](docs/pages-and-records.md) for full details.
+See [docs/04-pages-and-records.md](docs/04-pages-and-records.md) for full details.
 
 ### General Sections
 Database-backed templates (headers, footers, record views) that use the `thisrecord` variable to access record fields. They use the same Twig + Acai attribute engine as modules.
@@ -58,7 +58,7 @@ Database-backed templates (headers, footers, record views) that use the `thisrec
 - Upload fields return arrays: `thisrecord.image[0].urlPath`
 - Foreign keys use `_num` suffix: `category_num`
 
-See [docs/modular-system.md](docs/modular-system.md) for details.
+See [docs/03-modules-and-sections.md](docs/03-modules-and-sections.md) for details.
 
 ### Hooks (`hooks/`)
 PHP files that execute server-side logic. Triggered by:
@@ -80,8 +80,9 @@ Rule of thumb:
 - If the logic is only used by one module, prefer that module's `hook.php`
 - If the logic will be reused by several modules/pages, create a global hook in `hooks/`
 - Return arrays from hooks; do not use `echo json_encode(...)` or `exit`
+- Calling a hook over plain HTTP (`curl https://<forge-url>/hooks/x/`) returns **404 on purpose**: the endpoint requires the `X-Hooks-Token` header. From the agent use the `call_hook` MCP tool; the site's own JS (`CmsApi.hook`) already sends the token
 
-See [docs/hooks-and-api.md](docs/hooks-and-api.md) for usage.
+See [docs/06-hooks-and-cmsapi.md](docs/06-hooks-and-cmsapi.md) for usage.
 
 ## Acai Core (web-base)
 
@@ -110,25 +111,28 @@ Do NOT modify web-base files — they are shared across all projects.
 
 This project has MCP tools for managing modules, records, media, and more. **Before starting any task, consult the tools reference for the correct workflow.**
 
-See [docs/mcp-tools-reference.md](docs/mcp-tools-reference.md) for the complete list of available tools and step-by-step workflows.
+See [docs/09-mcp-tools-reference.md](docs/09-mcp-tools-reference.md) for the complete list of available tools and step-by-step workflows, and [docs/11a-decision-table.md](docs/11a-decision-table.md) to route a request to the right tool.
 
 Key workflows:
-- **Create module**: Read [docs/module-creation-guide.md](docs/module-creation-guide.md) first → create files with `acai-write` / refine with `acai-line-replace` → automatic compile on `index-base.tpl` → `add_module_to_record` (returns sectionId) → `set_module_config_vars` (returns uploadFields) → images via uploadFields. Use `compile_module` only if you need a manual recompile without editing the file.
+- **Create module**: Read [docs/03-modules-and-sections.md](docs/03-modules-and-sections.md) first → create files with `acai-write` / refine with `acai-line-replace` → automatic compile on `index-base.tpl` → `add_module_to_record` (returns sectionId) → `set_module_config_vars` (returns uploadFields) → images via uploadFields. Use `compile_module` only if you need a manual recompile without editing the file.
 - **Edit module**: `acai-view` → `acai-line-replace` (or `acai-write` for full rewrites) → automatic compile on `index-base.tpl`
 - **Add images**: use `uploadFields` from `set_module_config_vars` response → `upload_record_image`
 - **Generate images**: `generate_image` → `upload_record_image` with returned URL
 
 ## Documentation
 
-- [docs/modular-system.md](docs/modular-system.md) — Modules, general sections, global variables
-- [docs/builder-fields.md](docs/builder-fields.md) — Builder field types, Acai attributes, c-form, components
-- [docs/twig-filters.md](docs/twig-filters.md) — Twig filters reference (get, hook, module, queryDB, etc.)
-- [docs/hooks-and-api.md](docs/hooks-and-api.md) — PHP hooks, CmsApi, CocoDB, record creation
-- [docs/css-js-conventions.md](docs/css-js-conventions.md) — CSS/JS/Vue 3, Tailwind, BEM, native components
-- [docs/quick-reference.md](docs/quick-reference.md) — Cheat sheet: domain rules, field types, filters
-- [docs/production-patterns.md](docs/production-patterns.md) — Real production patterns (header, zigzag, FAQ, forms)
-- [docs/vue-builder-rules.md](docs/vue-builder-rules.md) — CMS-VUE rules (tabs, colorpicker, components)
-- [docs/vue-builder-examples.md](docs/vue-builder-examples.md) — Vue builder examples (Banner Slideshow, etc.)
-- [docs/pages-and-records.md](docs/pages-and-records.md) — Page types (Builder vs Standard), sections, visibility, critical rules
-- [docs/module-creation-guide.md](docs/module-creation-guide.md) — Module creation workflow, style reference, field types
-- [docs/mcp-tools-reference.md](docs/mcp-tools-reference.md) — MCP tools reference, available tools, workflows
+The `docs/` folder holds the 13 canonical Acai docs (numbered; the same set the Forge agent uses). They are refreshed automatically from the canonical source — do not edit them here.
+
+- [docs/01-builder-fields.md](docs/01-builder-fields.md) — Builder field types (`data-field-*`), tabs, conditional visibility, colors/colorpicker, components
+- [docs/02-twig.md](docs/02-twig.md) — Twig filters reference (get, hook, queryDB, translate, module, set…) and `{% if %}` vs `c-if`
+- [docs/03-modules-and-sections.md](docs/03-modules-and-sections.md) — Modules, `index-base.tpl`, general sections (`custom-{table}`), module creation workflow, uploads
+- [docs/04-pages-and-records.md](docs/04-pages-and-records.md) — Page types (Builder vs Standard), controller, `enlace`, records with `num`, visibility, critical rules
+- [docs/05-tables-and-fields.md](docs/05-tables-and-fields.md) — Creating and changing tables and fields with the MCP tools, `regenerate_enlaces`
+- [docs/06-hooks-and-cmsapi.md](docs/06-hooks-and-cmsapi.md) — PHP hooks (global and per module), `CmsApi`/`CocoDB`, middleware, `X-Hooks-Token`/`call_hook`, record creation
+- [docs/07-css-js-conventions.md](docs/07-css-js-conventions.md) — Tailwind, BEM scoped CSS, `data-*` for dynamic values, `CmsApi.hook` from JS, Vue 3, native components
+- [docs/08-layout-and-libraries.md](docs/08-layout-and-libraries.md) — Header/footer/global CSS/global JS via `get_layout_field`/`set_layout_field`, global libraries
+- [docs/09-mcp-tools-reference.md](docs/09-mcp-tools-reference.md) — Full MCP tools inventory by category and canonical workflows
+- [docs/10-production-patterns.md](docs/10-production-patterns.md) — Real production snippets (header with menu, FAQ, zigzag, forms, listings, structured data)
+- [docs/11a-decision-table.md](docs/11a-decision-table.md) — "User intent → MCP tool" routing table
+- [docs/11b-rules-cheat-sheet.md](docs/11b-rules-cheat-sheet.md) — Non-negotiable rules cheat sheet (`cms_`, `num`, `_num`, upload arrays, `c-if`), field types
+- [docs/12-glossary.md](docs/12-glossary.md) — Short definitions of Acai terms (sectionId, recordNum, apartados, builder_custom, enlace, controlador…)