# Modyo MCP Server — Documentation Index

> Entry point para toda la documentación del proyecto.
> Referenciado desde `CLAUDE.md` (raíz del repo).

## Platform — Dominio Modyo

Arquitectura y conceptos de la plataforma Modyo.

| Documento | Descripción |
|-----------|-------------|
| [platform/architecture.md](platform/architecture.md) | Arquitectura general de la plataforma |
| [platform/content.md](platform/content.md) | Módulo Content (spaces, types, entries) |
| [platform/channels.md](platform/channels.md) | Módulo Channels (sites, pages, widgets) |
| [platform/customers.md](platform/customers.md) | Módulo Customers (realms, users, forms) |
| [platform/core.md](platform/core.md) | Módulo Core (team, groups, roles) |
| [platform/api-quirks.md](platform/api-quirks.md) | Quirks y particularidades de la API |

## Channels — Sites, Liquid, Templates

Documentación detallada del módulo Channels.

| Documento | Descripción |
|-----------|-------------|
| [channels/site-architecture.md](channels/site-architecture.md) | Arquitectura de sitios |
| [channels/page-types.md](channels/page-types.md) | Tipos de página |
| [channels/snippets/](channels/snippets/) | Sistema de snippets |
| [channels/liquid/](channels/liquid/) | Liquid: referencia, drops, filtros |
| [channels/templates/](channels/templates/) | Templates: estados, workflows |
| [channels/css-js/](channels/css-js/) | CSS y JavaScript en sitios |
| [channels/publishing-workflow.md](channels/publishing-workflow.md) | Workflow de publicación |
| [channels/versioning-system.md](channels/versioning-system.md) | Sistema de versionamiento |
| [channels/best-practices.md](channels/best-practices.md) | Best practices de Channels |
| [channels/site-setup-checklist.md](channels/site-setup-checklist.md) | Checklist post-creación de sitios |

## Widgets — Desarrollo en plataforma Modyo

Generación de widgets transaccionales (React + Dynamic UI 2.x). El catálogo de componentes se federa vía facade Storybook (tools `widgets-*`); los patterns, reglas arquitectónicas y workflows viven como documentación textual migrada desde `dynamic-context`.

- **Entry point del módulo:** [`widgets/INDEX.md`](widgets/INDEX.md)
- **Tools:** `widgets-list-components`, `widgets-get-component-props`, `widgets-list-patterns`, `widgets-scaffold`, `widgets-validate`. El deploy NO es una operación del MCP: va por CI desde el repo del widget, o `modyo-cli push` manual explícito del dev.
- **Prompt:** `widgets-init-project` — arranque user-controlled del init: instruye al agente a invocar la Tool `widgets-scaffold`, que clona el repo canonical `dynamic-framework/dynamic-react-vite-base-template` al tag pineado por la compatibility matrix (`git clone --depth 1 --branch`, sin `gh`). Flujo de dos pasos: scaffold → descripción funcional del operador.
- **Integración opcional con Claude Code:** [`widgets/_meta/integration/claude-code.md`](widgets/_meta/integration/claude-code.md) — hook `PostToolUse` (validator standalone post-edit). Opt-in.
- **Dependencia externa:** las tools consumen el Storybook deployado de Dynamic UI (`DYNAMIC_UI_STORYBOOK_URL`, default `https://react.dynamicframework.dev/latest`). El contrato del JSON consumido evoluciona junto al epic upstream #1040 (Dynamic UI 2.4.1+).

| Documento | Descripción |
|-----------|-------------|
| [widgets/INDEX.md](widgets/INDEX.md) | Guía completa de generación: stack, reglas críticas, catálogo, workflow, validator |
| [widgets/components/](widgets/components/) | Catálogo textual de componentes Dynamic UI por categoría (17 archivos) |
| [widgets/patterns/](widgets/patterns/) | Patterns de arquitectura (repository, TanStack Query, Zustand, i18n, testing, data-states) |
| [widgets/reference/](widgets/reference/) | Convenciones, arquitectura, validator rules, troubleshooting, theming |
| [widgets/_meta/](widgets/_meta/) | Guías meta (token-budget, production-ready, component-docs) + integración por cliente |
| [widgets/platform/development.md](widgets/platform/development.md) | Best practices de desarrollo en sites Modyo |
| [widgets/platform/workflows.md](widgets/platform/workflows.md) | Workflows de widgets en Modyo |
| [widgets/platform/editing-published.md](widgets/platform/editing-published.md) | Edición de widgets publicados |

## Development — Patrones del MCP Server

Guías para contribuir al MCP server.

| Documento | Descripción |
|-----------|-------------|
| [development/tool-patterns.md](development/tool-patterns.md) | Patrones de desarrollo de tools |
| [development/test-utilities.md](development/test-utilities.md) | Utilidades de testing |
| [development/e2e-test-guide.md](development/e2e-test-guide.md) | Guía de tests E2E |
| [development/mcp-overview.md](development/mcp-overview.md) | Overview del protocolo MCP |
| [development/schema-policy.md](development/schema-policy.md) | Política del schema publicado (uniones de ramas estructuradas, `.transform()` en la raíz) |

## Tools — Documentación de las 68 herramientas

| Documento | Descripción |
|-----------|-------------|
| [tools/TOOLS_SUMMARY.md](tools/TOOLS_SUMMARY.md) | Resumen de todas las tools |
| [tools/PAGE_WIDGET_TOOLS.md](tools/PAGE_WIDGET_TOOLS.md) | Tools de páginas y widgets |
| [tools/WIDGET_TOOLS.md](tools/WIDGET_TOOLS.md) | Tools de widget definitions |
| [tools/RELEASE_TOOLS.md](tools/RELEASE_TOOLS.md) | Tools de releases |
| [tools/PAGE_PARAMETERS_EXPLAINED.md](tools/PAGE_PARAMETERS_EXPLAINED.md) | Parámetros de páginas |
| [tools/channels/](tools/channels/) | Docs específicos por tool |

## Workflows

| Documento | Descripción |
|-----------|-------------|
| [workflows/published-page-deletion.md](workflows/published-page-deletion.md) | Eliminación de páginas publicadas |