Plumb · design (build)
plumb_designCompile and validate a high-level design DSL, then build it into a Figma file as native nodes with brand tokens, pages, sections, and blocks.
Instructions
Author a design from a high-level Plumb Design DSL document and BUILD it into the paired Figma file. This is the write direction: the DSL (semantic pages → sections → blocks + brand tokens) is validated, compiled DOWN to the PDS IR, lowered to a Figma-native emit plan, and executed by the plugin (auto-layout frames, text, images, icons). Returns the created node ids keyed by authored element handle — the join key you then feed to plumb_review / motion. Pass a brief to record intent (audience, tone, brand) alongside the build. Use dryRun: true to compile + validate without touching Figma.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "plumb_design"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doc | No | A Plumb Design DSL document (version "1": brand + pages of semantic sections). Validated against DesignDocSchema. | |
| mode | No | `create` (default) — fresh nodes. `sync` — idempotent re-apply keyed on stable plumbKey (authored element handle); pair with `prune` to delete stale nodes. | |
| brief | No | Optional design-brief intake — records author intent alongside the build. | |
| prune | No | sync only — delete built nodes no longer in the design. | |
| dryRun | No | Compile + lower only; do NOT touch Figma. Returns plan stats + warnings so you can sanity-check before building. | |
| reveal | No | Scroll + select the built root in Figma when done. | |
| target | No | Where to build. Defaults to a new top-level frame on the current page. | |
| pageWidth | No | Layout width hint for pages that don't set their own. |