LLM interface

Machine-readable Wire docs

The fastest path for agents is not a tutorial. It is compact JSON shape, schema, examples, recipes, and a short agent guide that all point at the canonical Wire model.

Entrypoints

These routes return raw JSON or Markdown with stable content types. They are designed for local agents, hosted Wire chat, and retrieval pipelines.

Route	Media type	Purpose
/llm/wire-docs.shape.json	application/json	Root machine-readable docs manifest.
/llm/agent-guide.md	text/markdown	Prompt-ready operating guide for coding agents.
/llm/mcp.shape.json	application/json	MCP tools, resources, and operating sequences.
/llm/cli.shape.json	application/json	CLI commands, storage rules, validation, and export workflows.
/llm/react.shape.json	application/json	React library build surface and component contracts.
/llm/cloud.shape.json	application/json	Wire Cloud auth, API key, share URL, and sync contracts.
/llm/schema/wire-diagram.json	application/schema+json	Canonical WireDiagram JSON Schema.
/llm/validation.shape.json	application/json	Validation issue codes and repair hints.
/llm/skill.shape.json	application/json	SKILL.md location, recipes, and guardrails for agent workflows.

MCP retrieval

The MCP server exposes the same content as resources and a task-aware retrieval tool. Agents should call this before guessing from human prose.

json

{
  "tool": "v1_get_docs_shape",
  "arguments": {
    "task": "Build a React workspace and sync it to Wire Cloud"
  }
}

Fast-start recipes

Recipes are small JSON task plans. Use them when the agent already knows the task type and needs the shortest path through the implemented APIs.

/llm/recipes/create-wire-diagram.json /llm/recipes/edit-with-wire-actions.json /llm/recipes/validate-and-repair.json /llm/recipes/render-for-review.json /llm/recipes/style-cards-and-edges.json /llm/recipes/branch-condition-flow.json /llm/recipes/group-nodes.json /llm/recipes/embed-react-viewer.json

Agent rules

Use WireDiagram JSON as the source of truth.
Use WireAction batches or apply_actions for coherent edits.
Use @aigentive/wire-react for React UI.
Use @aigentive/wire-cli for local validate/export workflows.
Run validate before rendering or sharing.
Use Mermaid, SVG, and PNG as exports, not primary state.

NextWire MCP server