Runbooks Master Index Hub

This hub indexes all operational runbooks in workspace/docs/ — step-by-step procedures for recurring operational tasks, protocol definitions, and system configuration guides. Check this hub before writing a new procedure; if a runbook already exists for a task, link to it rather than re-documenting inline. 20 files live in workspace/docs/ (16 runbooks + 4 archived/HTML). Curator: claude. Review cadence: on-demand when runbooks are added or superseded.


Quick reference

FieldValue
Source doc_index
Source doc last updatedvaries per runbook (see table below)
Canonical path/home/opsadmin/.openclaw/workspace/docs/
Curatorclaude
Review cadenceon-demand
Staleness risklow — individual runbooks may drift, but index is current as of 2026-05-04
Applies to agents_summary, _summary, _summary, _summary, _summary
Governance gates enforcedn/a

Runbook catalog

All files live at /home/opsadmin/.openclaw/workspace/docs/. Subdirectory _archived/ contains superseded runbooks.

Protocol and Gate Runbooks

FilePurposeDomainStatus
NO-SEND-GATE-v1.mdPre-send gate checklist — 11 no-send conditions enforced before any SMS dispatchcompliance / smsactive
ROLLBACK-TRIGGERS-v1.mdDefines rollback trigger conditions and recovery procedures for service failuresinfra / opsactive
SPLIT-TEST-PROTOCOL-v1.mdProtocol for A/B split testing across SMS vendors and message variantssms / testingactive
VENDOR-SCORECARD-v1.mdScoring rubric for evaluating SMS and voice vendorsvendor / opsactive
VENDOR-TESTABILITY-AUDIT.mdAudit framework for assessing vendor API testability before integrationvendor / infraactive

SOP and Process Runbooks

FilePurposeDomainStatus
auction-commission-sop.mdStandard operating procedure for auction commission calculations and CDA generationbetterfiles / reactive
blast-scheduler-audit.mdAudit guide for reviewing blast scheduler performance and deduplicationacquisitions / smsactive
new-inventory-deal-review-architecture.mdArchitecture review for new inventory deal ingestion pipeline (NIDR system)acquisitions / infraactive
nidr-system-config.mdConfiguration guide for the New Inventory Deal Review (NIDR) systemacquisitions / infraactive
tag-automation-system.mdTag automation system setup and configuration for HubSpot deal tagginghubspot / crmactive
w4-5-rce-migration-pattern.mdMigration pattern for W4/W5 real estate deal routing and conversionacquisitions / infraactive

Integration and Deployment Runbooks

FilePurposeDomainStatus
SLACK-INTERACTIVE-DEPLOYMENT.mdDeployment guide for Slack interactive message buttons and workflowsslack / infraactive
dispo-send-library-contract.mdContract/interface spec for the dispo send library — input/output shapesdispo / smsactive
obsidian-vault-setup.mdSetup guide for Obsidian vault sync — Obsidian Git + vault-sync timervault / infraactive
slack-app-interactive-setup.mdSlack app configuration for interactive message capabilitiesslack / infraactive
slack-button-workflow-guide.mdWorkflow guide for Slack button interactions and response handlersslack / opsactive

HTML Reference Docs (non-runbook, informational)

FilePurposeDomain
dispo-llm-system-guide.htmlVisual guide to the dispo LLM decision systemdispo
sms-pipeline-flow.htmlVisual flow diagram for the SMS processing pipelinesms
slack-user-guide.htmlUser-facing Slack integration guideslack

Archived Runbooks

Location: workspace/docs/_archived/ — superseded runbooks kept per feedback_archive_not_delete.md.


How it’s used

  • Before documenting a new procedure — search this index; if a runbook exists, link to it
  • NO-SEND-GATE-v1.md — invoked by messaging-compliance-gate skill before every SMS dispatch; also referenced by compliance-gates
  • ROLLBACK-TRIGGERS-v1.md — referenced during VPS crash-loop remediation (WF-12) and any service restart
  • SPLIT-TEST-PROTOCOL-v1.md — invoked by bulk-sms-split-test skill and messaging-vendor-sandbox-tester skill
  • auction-commission-sop.md — referenced by betterfiles-cda skill for CDA generation
  • obsidian-vault-setup.md — setup reference for openclaw-vault-sync.timer and openclaw-vault-pull.timer
  • Failure mode: re-documenting a procedure that already has a runbook; always check this index first

Agents that touch this

  • _summary — uses NO-SEND-GATE-v1, blast-scheduler-audit, NIDR runbooks
  • _summary — uses dispo-send-library-contract, dispo-llm-system-guide
  • _summary — uses new-inventory-deal-review-architecture, NIDR-system-config
  • _summary — uses SLACK-INTERACTIVE-DEPLOYMENT, slack-button-workflow-guide
  • _summary — uses obsidian-vault-setup, tag-automation-system

Skills that invoke this

Plans that govern this

System hubs (Wave 2)

Process hubs (Wave 1)

Feedback rules

Resource hubs (knowledge curation cluster)

  • henry-preferences — §3 Search Before Building (check runbooks before creating new procedures)
  • workflow-patterns — higher-level workflows that runbooks implement step-by-step
  • kb-directory — KB docs that underpin many runbook procedures
  • templates-library — templates used within runbooks for new file creation

Knowledge curation cluster

This hub is a member of the Knowledge curation cluster anchored at kb-directory.

HubRole in cluster
kb-directoryAnchor — 165 KB platform docs Claude must check first
henry-preferencesFounder operating standards — rules for HOW Claude works
workflow-patternsRecurring patterns — canonical procedures
runbooks-masterTactical runbooks — step-by-step procedures
templates-libraryTemplates — structured scaffolds for new files

Open issues / TODOs

  • workspace/docs/_index.md should be updated to cross-reference this hub
  • Several runbooks (NIDR, w4-5-rce, tag-automation) have no corresponding Wave 1-2 hub entries — may need process hub coverage in Wave 4+
  • dispo-send-library-contract.md should be cross-linked from the dispo-lifecycle process hub once Wave 2 ships
  • Verify _archived/ contents and document superseded runbook titles here

Recent activity

  • 2026-05-04: hub created (W3-S1, Wave 3 resource hubs batch)