playbook-authoring-pattern

What problem does it solve?

It solves the problem of creating operational playbooks that both humans and Claude Code can run end-to-end without getting stuck, silently failing, or requiring rework.

Core Features & Use Cases

• 4-tuple step structure (with verification): Forces every step to include purpose, commands, expected output, and an external verification signal, plus failure recovery branches.
• Pre-flight + idempotent guards: Ensures prerequisites are checked upfront and repeated execution is safe via markers, state checks, and conditional installs/config updates.
• Operational readiness output: Includes branching options (A/B), a troubleshooting table for common failures, and a final end-to-end validation section.

Quick Start

Ask Claude Code to generate a deployment runbook for your target environment using the required 4-tuple step format, including pre-flight checks and an idempotent restart/validation plan.