Checklist

A Checklist is a list of actionable items, each with a real done boolean, optionally grouped and owned. Humans read (and mentally tick) a runbook with a progress count; the agent gets { kind:"checklist", items:[{ text, done, owner, group }] } — done is a boolean it can count ("3 of 8 done"), not a styled strike-through it has to infer. Runbook is an alias.

When to use it

Deploy runbooks, onboarding checklists, release gates, pre-flight lists — anything where the question is "what's left to do, and who owns it?" The agent reads completion as data, so it can report progress or surface the unchecked items directly.

Props

Checklist (alias Runbook)

ChecklistItemInput

Items with the same group are rendered under one heading, in first-seen order.

What the agent sees

done is a real boolean per item, with the owner and group intact — so the agent can count progress and list what's outstanding:

{
  "kind": "checklist",
  "id": "deploy-runbook",
  "title": "Deploy runbook",
  "items": [
    {
      "id": "set-google-client-id-secret",
      "text": "Set GOOGLE_CLIENT_ID + SECRET",
      "done": true,
      "group": "Auth"
    },
    {
      "id": "restrict-the-allowed-email-domain",
      "text": "Restrict the allowed email domain",
      "done": true,
      "group": "Auth"
    },
    {
      "id": "set-the-mcp-token",
      "text": "Set the MCP token",
      "done": false,
      "owner": "Krishnan",
      "group": "MCP"
    },
    {
      "id": "deploy-to-vercel",
      "text": "Deploy to Vercel",
      "done": false,
      "group": "Ship",
      "refs": [{ "rel": "related", "target": "/docs/deploy", "label": "Deploy", "internal": true }]
    }
  ]
}