← All playbooks · Raw API

task-create-from-document

# Capability: Create from a document

## Intent phrases

- create from Google Doc
- import from document
- build page from a brief

## Requires capabilities

`pages` or `articles`

## Prerequisites

- Fetch document content (Google Drive MCP, paste, or `site-workflows-copy-doc-snapshot` in dev repos)
- Read `cms-edit://customer/components-index`, `routing`, `articles` (if article)

## Steps

1. Read `cms-edit://customer/tasks-index` and relevant playbooks
2. **Infer structure** — map sections to component types from `components-index`
3. **Propose plan** in plain English: slug, title, template/article type, component list — **ask user to confirm**
4. For pages: `list --type template` — pick template
5. Build `create from-json` payload
6. `cms_edit ["create", "from-json", "--json", "<compact-json>", "--dry-run", "--strict"]` (or `--json-base64` for large payloads)
7. On approval, create and `save`
8. `cms_edit ["preview", "urls", "<slug>"]` — open **site live preview** or staging URL in browser MCP; offer production and Contentful entry URLs
9. Remind user to publish in Contentful UI

Use MCP prompts `cms_edit_create_from_doc` or `cms_edit_create_article_from_doc` when available.

## Confirmation gates

1. Plain-English plan — mandatory user confirmation before create
2. `--dry-run --strict`
3. `diff` before `save`

## Out of scope

- Publish
- Asset upload without reuse check (see **Media** capability)

## Related resources

- `cms-edit://customer/components-index`
- `task-media-reuse-and-upload`
- `task-preview-verify`