plugin nifdi

El plugin de diagramas nifdi: el servidor de diagramas @nifdi/mcp empaquetado con las habilidades que lo enseñan — el modelo en profundidad, la gramática de colocación, recetas prácticas y el bucle de construcción que mantiene lo que construyes con el aspecto que querías.

El servidor es la superficie verbal. Las habilidades son el oficio. Se instalan como una sola cosa.

Instalación

claude plugin marketplace add nifdi-app/nifdi-plugin

claude plugin install nifdi@nifdi-plugin

Eso registra este repositorio como un marketplace e instala el plugin: el servidor MCP nifdi-diagram (lanzado con npx -y @nifdi/mcp@<pinned>) más las habilidades, cargadas progresivamente por tu cliente a medida que una tarea las solicita.

Bajo Claude Code no se necesita configuración de directorio: inyecta la raíz del proyecto, y los diagramas se colocan como archivos .nifdi.svg en el repositorio en el que estás trabajando. En un cliente que no lo haga, establece NIFDI_ROOT en la carpeta donde los quieras.

El servidor solo, sin la capa de enseñanza, sigue siendo instalable exactamente como antes:

claude mcp add nifdi-diagram -s project -- npx -y @nifdi/mcp@latest

Qué hay aquí

.claude-plugin/plugin.json       the plugin: pins the server version, ships the skills
.claude-plugin/marketplace.json  the single-plugin marketplace
skills/nifdi/                    the core skill: the model, placement, styling, connectors, workflow
test/                            contract CI — every fenced example, through the pinned server

El SKILL.md de la habilidad principal es un índice a la misma altura que las instrucciones del propio servidor; la profundidad reside en skills/nifdi/references/, que un cliente carga solo cuando la ruta que tomó lo necesita.

El servidor desnudo sigue siendo independiente

Las habilidades son contexto opcional: un cliente MCP puro nunca las ve. Por lo tanto, nada que un agente necesite para el uso correcto de las herramientas vive solo en una habilidad. Lo que vive aquí es la capa ilimitada: inmersiones profundas en el modelo, recetas, juicio de estilo, convenciones de proveedores. El contrato (qué hace cada herramienta, qué acepta y rechaza) permanece en el servidor, entregado a cada cliente.

El corolario es más importante: un defecto de comportamiento se corrige en el servidor, nunca se encubre en una habilidad. Una habilidad que enseña a los agentes a sortear una herramienta rota oculta el defecto a cualquier cliente MCP desnudo. Consulta CONTRIBUTING.md.

Las habilidades también son contratos

Cada ejemplo entrecomillado en cada habilidad es ejecutado por CI a través del @nifdi/mcp publicado — la misma disciplina de ida y vuelta que el servidor aplica a sus propios ejemplos citados, aplicada desde el exterior. Una receta cuyo XML ya no se analiza, o cuyo resultado afirmado ya no coincide con lo que informa la herramienta, falla la compilación.

Las habilidades fijan la versión del servidor con la que fueron probadas y el manifiesto fija ambas juntas, por lo que una instalación es un par coherente. Una ejecución programada prueba las habilidades contra @nifdi/mcp@latest también, de modo que una versión del servidor que invalide una receta se detecta aquí en lugar de ser descubierta por un agente a mitad de un diagrama.

npm install && npm test

Para ejecutar el contrato contra una compilación del servidor que no está en npm (un checkout local, un tarball, un candidato de lanzamiento), apunta NIFDI_MCP_SPEC a ella:

NIFDI_MCP_SPEC=../nifdi-app/mcp npm run test:examples

Estado. @nifdi/mcp@0.1.1 — la versión que este repositorio fija — aún no está publicada en npm. Hasta que lo esté, los comandos de instalación anteriores y el trabajo de CI fijado no pueden resolver el servidor, y el contrato se ejecuta solo mediante NIFDI_MCP_SPEC.

Contribuir

Las convenciones de proveedores — cómo se ve un diagrama bueno de AWS, Azure o GCP, y qué vocabulario de nifdi lo produce — son la superficie de contribución principal: valiosa, acotada y que no necesita acceso a los internos de nifdi. CONTRIBUTING.md tiene el estándar y cómo ejecutar las comprobaciones localmente.

Licencia

Apache-2.0. La aplicación nifdi en sí es cerrada; esta capa de enseñanza es abierta.