# `_meta/integration/` — Configuraciones recomendadas por cliente MCP

Este directorio contiene configuraciones recomendadas (hooks, settings) para clientes MCP específicos que consumen el módulo Widgets del MCP server.

## Por qué son opcionales

Una decisión arquitectónica del Plan Maestro (principio **P5 — cliente-agnóstico**) es que el módulo Widgets debe funcionar end-to-end sin requerir configuración específica del cliente. Las tools `widgets-*` y el Prompt `widgets-init-project` son suficientes para generar widgets desde cero.

Lo que vive en este directorio es **adicional**: automatizaciones que mejoran la UX cuando el cliente las soporta. Si no querés configurarlas, el módulo sigue siendo plenamente funcional — sólo perdés la conveniencia de la automatización.

## Clientes cubiertos hoy

| Cliente | Archivo | Qué cubre |
|---------|---------|-----------|
| Claude Code | `modyo://docs/widgets/_meta-integration-claude-code` | `PostToolUse` (validator standalone post-edit) |

## Cómo agregar otro cliente

Si tu cliente MCP soporta hooks, lifecycle events o configuración persistente, podés contribuir con un archivo análogo a `claude-code.md`:

1. Creá `<cliente>.md` en este directorio (por ejemplo `cursor.md`).
2. Seguí el patrón de `claude-code.md`: intro corta + uno o más snippets directamente copiables + notas sobre adaptación al entorno + sección sobre deuda actual del validator.
3. Mantené los snippets directamente copiables (sin placeholders intermedios sin documentar). Las dependencias externas (rutas al validator, herramientas como `jq`) se documentan explícitamente.

Actualizá esta tabla cuando agregues un cliente nuevo.

## Relación con el validator

El validator del módulo Widgets está disponible como la tool MCP `widgets-validate` (y como fallback `npx @modyo/widget-validator`). El hook `PostToolUse` documentado en `claude-code.md` puede invocarlo tras cada edición — Opción 1 (tool MCP) u Opción 2 (`npx`). Estos snippets son opcionales: el módulo valida sin ellos invocando la tool directamente.