Skip to content

Operator Runbooks

This index lists every operator runbook: a focused, step-by-step procedure for a routine task in a Brain Factory project. Use it to find the right guide, run it, and record the outcome in GitHub.

New to the project? Start with How Brain Factory works for the five-minute tour, then come back here. Runbooks are the how layer: they sit below the what of docs/operating-model.md (how work flows day to day) and the why of docs/framework-continuity-and-memory.md (the durable principles the system preserves across sessions).

Runbook flow

This diagram shows how an operator picks a runbook from this index, runs it, validates the result, and writes the outcome back to a durable artifact.

flowchart LR
    A[Operator task] --> B[Open runbooks index]
    B --> C{Select runbook}
    C --> D[Execute procedure]
    D --> E[Run required validation]
    E --> F[Update linked issue or PR]

Available runbooks

Adding a new runbook

  • Keep each runbook focused on one task, end to end.
  • Use short numbered steps and checklists rather than prose.
  • Cross-link the relevant operating-model doc, ADR, or charter section.
  • Add the new runbook to the list above. CI checks that every runbook here stays linked, so do not remove or rename existing entries.