Operations
Build a Low-Cognitive-Load Runbook
A short, executable runbook that reduces operator load through one purpose, a small decision tree, exact commands, verification, and a safe stop.
The process
Work it in this order.
- Define the trigger, operator outcome, system boundary, risk level, prerequisites, and the conditions under which the runbook must stop.
- Write a one-screen orientation with the symptom, likely impact, first safe check, escalation path, and links to authoritative context.
- Break the procedure into numbered actions with one purpose per action, expected output, failure branch, and a clear handoff for unfamiliar cases.
- Specify safe commands, variables, access assumptions, evidence to capture, and the exact verification that proves each step worked.
- Test the runbook in a representative non-production environment or tabletop, marking any untested command, missing permission, or ambiguous instruction.
- Assign an owner, review cadence, related dashboards and alerts, and a last-tested date, then prune stale steps without losing rollback guidance.
- Publish the runbook and return its evidence, test status, known limitations, and unresolved risks, pausing before any production action.
Bring this
Inputs the cat will ask for.
- operator trigger and desired outcome
- system and environment scope
- access and safety constraints
- available tests, dashboards, and owner
Router + one playbook
Route first. Choose one.
Cat Paw loads one playbook per task rather than merging several. Start with this router; the remaining paths are workflow-specific candidates it can inspect.
- Router:
action-first-communication-pack skills/action-first-communication-pack/low-cognitive-load-runbook/SKILL.md
Guardrails
The boundaries travel with the prompt.
- Verify the actual tools, accounts, permissions, and workspace before starting; never claim an unavailable tool, account, source, or capability.
- Use Latch/target-workspace for private code, artifacts, live probes, or non-public data; if that access is unavailable, stop at the boundary and report the blocker rather than substituting a guess.
- Pause for explicit approval before consequential external actions; return evidence and unresolved risks, assumptions, and any action still awaiting approval.
Done means
A checkable finish.
A tested, owned runbook gives an operator a short path from trigger to verified outcome or safe escalation, with commands, stop conditions, evidence, and unresolved risks documented.
Sources
Where this process came from.
- github.com/ayghri/i-have-adhd/tree/839872f9d1cd634fed642b4589ce7226199cc15f/
- sre.google/sre-book/incident-response/
- www.nngroup.com/articles/ten-usability-heuristics/
Sources establish the workflow pattern. Reddit and community posts, where present, are treated as practitioner anecdotes rather than universal facts.