---
name: diagram-plantuml
description: Create a PlantUML diagram and a Confluence storage-format macro for a reviewed page. Use when a user needs a diagram embedded in a supported Confluence page.
---

# diagram-plantuml

## Inputs
The relationship to explain, target page context, and any approved diagram conventions.

## Workflow
1. Choose a diagram type with `references/diagram-types.md`.
2. Build a small local `.puml` source with a caption and only approved includes.
3. Run a local syntax check when the configured renderer is available.
4. Return the storage macro and state whether syntax and target rendering were independently verified.

## Rules
- Keep macro markup at the required storage-body level.
- Never load remote or untrusted `!include` sources.
- Do not claim a rendered result without a target-environment preview.

## Output
Return the diagram source, storage macro, validation result, and any target-environment prerequisite.