reference / cluster / templates

cluster.yaml templates

Starter cluster.yaml files, one per cluster type. curl one into .meshkore/public/cluster.yaml, replace the {{placeholders}} with your values, and start the daemon — python3 .meshkore/scripts/daemon.py picks it up immediately. For the AI-driven install flow that does all of this for you, paste the prompt from /cluster/install.

dev

Code cluster

For repos where agents write code. Roadmap, modules with tasks, commit conventions, governance.md.

type: dev

service

Service cluster

For long-running production agents (API, deploy bot, monitor). Heavier on permissions, lighter on roadmap.

type: service

comms

Comms cluster

For agents whose primary surface is conversation (sales, support, oracle). Channels first, code second.

type: comms

links

Deployment links registry · .meshkore/public/links.yaml

Per-module local URL + production URL + provider + deployed sha/version/timestamp + repo branch. Standard §13. The daemon serves it at /links and broadcasts links.updated on the WebSocket. Update on every deploy / version bump.

protocol

Protocol scaffold · .meshkore/protocols/P<N>-<slug>.md

Reusable multi-step runbook. The operator says "apply P<N>" and the agent walks the Steps section. Standard §14. Daemon: /protocols · /protocols/<id> · /protocols/<id>/runs. Two reference protocols ship with the standard: P1 (bump standard version) and P2 (deploy project).

What's in each file

Every template has the same top-level keys: version, id, type, name, description, transport, bootstrap, plus type-specific policy and modules defaults. The full schema is in the cluster spec v1.

Copy by hand

Drop the file in place, edit the placeholders, start the daemon:

mkdir -p .meshkore/public .meshkore/scripts
curl -fsSL https://meshkore.com/reference/cluster/templates/cluster.yaml.dev \
  -o .meshkore/public/cluster.yaml
# Edit {{cluster_id}} / {{cluster_name}} / {{cluster_description}}
curl -fsSL https://meshkore.com/reference/cluster/scripts/daemon.py \
  -o .meshkore/scripts/daemon.py
python3 .meshkore/scripts/daemon.py

For the AI-driven install flow that does all of this for you, paste the prompt from /cluster/install.

Editor rules + governance

Templates for the editor side (CLAUDE.md, .cursorrules, .windsurfrules) live at /reference/cluster/editor-rules/. Governance + conventions live at /standard.