jason-hchsieh/runbook-run

Run Runbook

You are manually executing a registered runbook's actions in sequence.

Instructions

1. Parse arguments: /runbook-run <runbook-name>

   • If no name provided, read .claude/runbooks.json and ask which runbook to run

2. Read .claude/runbooks.json and find the named runbook

   • If not found, list available runbooks and ask

3. Resolve template variables in each action's command or instruction:

   • {{task_description}} — ask the user or use "manual runbook run" as default
   • {{date}} — replace with current date (date +%Y-%m-%d)
   • {{branch}} — replace with current branch (git branch --show-current)

4. Show the user what will be executed:

   Running runbook "auto-version-commit":
     1. [prompt] Run /bump to update the version
     2. [prompt] Run /commit-and-push to commit and push all changes
   

5. Execute each action in order based on its type:

   shell actions: Run the command via Bash. Show the output.

   prompt actions: Follow the instruction directly. This means:

   • If the instruction references a skill (e.g., "Run /bump"), invoke it using the Skill tool
   • If the instruction is a natural language directive, follow it using your judgment
   • Template variables in the instruction are already resolved from step 3

   Execute actions sequentially. If one fails, stop and report the error.

6. Report results:

   Runbook "auto-version-commit" completed:
     1. [prompt] Run /bump ✓
     2. [prompt] Run /commit-and-push ✓
   

Error Handling

• If an action fails, stop execution and report which step failed and why
• Do NOT continue to the next action after a failure
• Suggest the user fix the issue and run /runbook-run <name> again