# show-me-mcp

Domain vocabulary for helping agents choose and organize explanations while ensuring the quality of display artifacts.

## Language

**Expression intent**: What the reader needs to understand, including the relationships, order, ownership, and emphasis that must be preserved.

**Display form**: The structure used to express intent: pseudocode, text trees, Mermaid, diff, or HTML.
_Avoid_: Image type, terminal mode

**Expression element**: A semantic building block that helps an agent organize content, such as an entity, step, group, relation, branch, note, comparison, or emphasis.
_Avoid_: Coordinates, drawing controls

**Expression recipe**: A reference example that combines expression elements for a particular explanation task without requiring a single display form.

**Expression library**: A collection of domain-specific expression elements, recipes, and their documentation, supplied by the project or a user.

**Component library**: A collection of visual components and style resources for a display form. It can represent expression elements but is distinct from their semantic definitions.

**Display adaptation**: Rules mapping expression elements to a display form and its components, including supported capabilities and limitations.

**Extension contract**: The shared rules expression and component libraries follow when participating in discovery, validation, display, and quality checks.

**Display artifact**: The text, diagram, or page actually presented to the reader. A single display form can be delivered in different file formats.
_Avoid_: Display form

**Display environment**: The client that presents an artifact, together with constraints such as dimensions, fonts, and rendering capabilities.

**Display defect**: A layout problem that impedes understanding, including occlusion, overlap, clipping, overflow, or ambiguous connector endpoints.

**Automatic repair**: Adjusting layout to eliminate display defects while preserving expression intent.

**Quality check**: Assessing the readability and semantic fidelity of an actual display artifact in a specified environment.

**Quality boundary**: The range of input sizes and display environments in which display quality can currently be verified and guaranteed.

**Template**: Reusable organization rules for a recurring explanation task; these may reference expression recipes and elements.

## Existing diagram primitives

**VisualSpec**: A versioned specification describing a structured diagram.

**Stack**: An arrangement expressing explicit horizontal or vertical reading order without implying relationships.

**Group**: A grouping that expresses ownership or containment.

**Card**: An addressable entity or step in a diagram.

**Note**: A non-addressable annotation expressing an explanation, risk, or constraint.

**Relation**: An explicitly declared relationship between entities.

**Legend**: An explanation of the symbols, states, or visual markings used in a diagram.