Working as a developer
Ordinary web development with one difference: you do not upload to the live site. You stage, preview, publish — the same cycle and checks as everyone else: Drafts and going live.
Your key
Your key may read and write templates, and usually read content and files so you can see what you design for. The owner mints it, with or without the right to publish; an agency often stages and lets the site’s communications lead publish. See Keys and the MCP.
With it your agent — Claude Code, Cursor, any assistant that speaks MCP — fetches a template, edits it, stages it, hands you the preview link. A tool you run yourself can hold the same key; the MCP is a protocol, not a person.
Templates in the cycle
A staged template shows in the preview across the whole site: the new shell on every page of its type, real content, every language. Includes are draft-aware, so a section that exists only as a draft is picked up too — stage a shell and its sections in one round.
Publishing parses templates, verifies references and confirms required fields. A shell that does not parse does not go live; the message names file and line.
What you can read
These docs are read through the MCP — search { in: "docs", query } finds a page, fetch "docs/<path>.md" reads it — and the theme listing points at this section (docs/theme). Start with Work rules for agents and Data conventions; where a page and the code disagree, the code is leading. The site’s /admin page explains the site to an agent, ready to copy into any assistant’s setup.
The site is data first
Ask whether a change is data or form. A new page is an entity, not a template. A new kind of page is a type shell. A different look for one page is presentation.shell on that entity, not a route. A list on an overview page is an ItemList you curate, not a query. The machine views read the data; what you keep in a template is invisible to them.
What you do not do
No editing the engine. No PHP or HTML in assets/. No fallback in a template for missing data — a missing field is a finding for the audit. No unescaped echo outside body(). No local build, bundler or package manager: a PHP-capable server and the folder are the whole stack.