Manual Runbook to Parameterized Automation Prompt
Convert a prose manual runbook into a parameterized, automatable workflow spec — extracting inputs, decision branches, idempotent steps, and verification checks, while keeping irreversible or judgment-heavy steps as explicit human gates.
- Target user
- Platform engineers turning operational runbooks into safe automation
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior automation/platform engineer who converts runbooks into automation without blindly translating risky manual steps into unattended ones. Turn a manual runbook into a parameterized, partially-automatable workflow spec. I will provide: - The full text of a manual runbook - Where it runs and what systems it touches - How often it's run and by whom - Known sharp edges or steps people are nervous about Your job: 1. **Step extraction** — break the runbook into discrete steps and classify each as read/diagnostic, reversible mutation, irreversible mutation, or human-judgment. 2. **Parameterization** — identify the inputs hidden in the prose (targets, thresholds, environment, ticket refs) and define a clean parameter set with types, validation, and safe defaults. 3. **Branch and decision logic** — capture the if/then decisions the human currently makes and express them as explicit, testable conditions. 4. **Idempotency and verification** — for each automatable step, add a precondition check, an idempotent action form, and a post-action verification. 5. **Human gates** — keep irreversible and judgment-heavy steps as explicit approval gates rather than automating them away; state what the human must confirm. 6. **Back-out mapping** — for every mutating step, define the back-out action and how a partial run is recovered. Output as: (a) the classified step list, (b) the parameter schema with validation/defaults, (c) the decision/branch logic, (d) the per-step precondition/action/verification/back-out table, (e) the human-gate list with confirmation criteria. Default to keeping a human in the loop: when a step is irreversible, ambiguous, or relies on judgment the runbook doesn't fully specify, make it an approval gate rather than fully automating it, and never ship the workflow without tested back-out for every mutating step.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Incident Timeline to Runbook Generation Prompt
Turn the messy timeline of a just-resolved incident — chat logs, commands run, graphs, and decisions — into a clean, reusable runbook with detection signals, decision points, exact verified steps, and a clear marking of which steps are safe to later automate.
-
Runbook to Approval-Gated Workflow Design Prompt
Convert a manual, free-text operational runbook into an automated workflow that keeps humans in the loop by inserting approval gates, dry-run previews, and read-only checks at exactly the steps where judgment or blast radius demands sign-off.
-
Multi-Step Ops Workflow Checkpoint Orchestration Prompt
Orchestrate a long, multi-step operational workflow (migration, rollout, recovery) so it is restartable from durable checkpoints, compensates partial progress on failure, and never leaves the system in an unknown half-applied state when a step crashes mid-flight.
-
Toil Task Automation with Rollback Plan Prompt
Safely automate a repetitive toil task by first proving the manual steps, then wrapping them in an automation that has a dry-run, an explicit undo path, verification after each change, and a kill switch — so saving time never trades away the ability to reverse a mistake.
More Automation prompts & error guides
Browse every Automation prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.