← All playbooks · Raw API

guide

# wp-cms-edit guide

Edit **WordPress draft pages** on Pedestal Health via Gutenberg blocks (`pedestal/*`).

## Rules

- **Prefer new draft pages** for AI edits — `create-page` with a unique slug (`ai-edit-<topic>-<date>`).
- **Open existing drafts** with `open --page-slug` when continuing work (`list-drafts` to find them).
- Do not edit production marketing pages (`home`, `about`, solutions, …) unless explicitly asked.
- Saves are **draft only** — never publish.
- Block refs: `@b1`, `@b2`, … map to named Gutenberg blocks. `@b0` is page metadata.

## New page workflow

```
create-page --slug ai-edit-example-jul-2026 --title "..." --heading "..."
snapshot
read @b1
set @b1 heading "..."
diff
save
```

## Edit existing draft workflow

```
list-drafts
open --page-slug ai-edit-example-jul-2026
snapshot
read @b1
set @b1 heading "..."
diff
save
```

## Resources

Read `wp-cms-edit://customer/checklist` and `wp-cms-edit://customer/tasks-index` first.

- Blocks catalogue: `wp-cms-edit://customer/blocks-index`
- Routing: `wp-cms-edit://customer/routing`