Blueprints

A recipe is prose. A blueprint applies.

Everything a tutorial tells an agent to do is something it could instead be handed as a unit. A blueprint is a content model, a folder tree, sample pages, the parameters that make it yours — and a promise about what exists when it finishes.

Read the docs The ten laws

Nothing in the format is a new serializationP10

The post types are the same bytes the CLI already writes, the content files are the same desired-state documents apply already takes, and the front-end sources are ordinary files. That is what keeps a blueprint from becoming a third contract with its own semantics to learn and its own bugs to find.

apply a package

shio blueprints                       # the catalogue and its parameters
shio apply --blueprint corporate \
  --param brand=Acme --site acme      # or --dry-run first

A package may not name its own site, and may not pruneP7

The site is the caller's, so a site key inside a package is refused at load rather than ignored — an ignored key looks like it worked. And prune's blast radius depends on what an author forgot to mention, which is an unacceptable thing to inherit from a package the user did not write.

Substitution is one form and nothing elseP5

No conditionals and no expressions, so the same parameters always produce the same site. An unknown parameter is a teaching 400 rather than a silent no-op. And a malformed package answers 409, not 400 — nothing the caller sent caused it, and an error that blames the caller for the author's mistake sends them looking in the wrong place.

The model is provisioned, never upsertedP8

An existing post type of the same name is left exactly as it is — including a field a human added — and the response names the fields it lacks instead of overwriting them. A plan writes nothing and needs no write transaction, so looking before you write works on a read-only credential.

Give your agent a CMS it can actually drive

Run it yourself, hand it to Claude Code, and keep the approve button. Open source, no hosted tier you are being funnelled towards, and the whole design argument checked into the repository.

$claude mcp add shio -- npx @viglet/shio mcp

Read the docs Read the source