Design documents
These abilities ship in WPPilot Free and register on every install where the plugin is enabled.
At a glance
Design documents registers 7 abilities: 4 that only read, 2 that write, and 1 marked destructive. That split is the practical answer to how much of this module can run unattended. Reads cost nothing and are safe to repeat, so discovery is the part to be generous with; the writes are where review belongs, and the destructive calls stop for an explicit confirmation every single time regardless of which profile is active.
Availability on your site
The Design documents module ships in WPPilot Free, so it registers on every install where the plugin is active. No licence check and no dependency detection stand between the agent and these 7 abilities. What the connected agent can actually call is then narrowed twice more: by the safety profile active on the site, and by the WordPress capabilities of the user behind the credential. A read that succeeds for an administrator can be absent entirely for an editor.
Every write these abilities perform is recorded in the change ledger, and destructive calls can be routed through the approval queue so a person signs off before anything is applied. A successful tool result means the operation returned, not that the front end, the cache, and every dependent template are correct: that still needs a look.
Reads
Available in every safety profile, including Read Only. Inspection costs nothing and is not rate limited.
| Ability | What it does |
|---|---|
wppilot/check-designCheck Design (Pre-flight) | Pre-flight a candidate page (its HTML/CSS or visible text) against the active design's tokens and Don't rules plus universal anti-slop checks (em-dash, AI-purple, Inter, filler copy, off-palette fonts/colors). Call before finalizing any visual output and fix every "fail" before shipping. |
wppilot/get-active-designGet Active Design | Return the active site design system as raw DESIGN.md plus structured tokens, dials, guidance, provenance, and readiness. Read this before visual work and build within the returned contract. |
wppilot/get-designGet Design | Return a specific design system by slug as raw DESIGN.md plus its structured contract and readiness. Use to read, repair, or evolve a saved direction. |
wppilot/list-design-libraryList Design Library | List saved design systems, readiness, sync readiness, and which is active. |
Writes
Gated by the active profile and your WordPress capabilities. Rate limited to 120 per minute per credential.
| Ability | What it does |
|---|---|
wppilot/activate-designActivate Design | Make a ready design system (by slug) active for this site. Incomplete saved drafts are rejected until their required colors and typography are repaired. |
wppilot/save-designSave Design | Create or update a design system from raw DESIGN.md and return its structured contract. Incomplete new documents are saved as drafts but not activated; an incomplete write never overwrites the active design. |
Destructive
Marked destructive in the source, so each call needs an explicit confirmation flag, every time.
| Ability | What it does |
|---|---|
wppilot/delete-designDelete Design | Delete a saved design system by slug. If the deleted design was active, the site is left with no active design. |