mvilrokx / runegard
runegard
Autonomous runbook executor for Kubernetes operations. Reads markdown runbooks, parses them into executable decision trees, and follows them step-by-step against a live K8s cluster. Requests human approval before any mutating action. Includes an CL-powered improvement loop that learns from execution failures.
When to Use This Skill
Use this skill when:
- You have a runbook document describing an operational procedure
- You need to diagnose or remediate a Kubernetes issue
- You want to follow a step-by-step troubleshooting guide against a live cluster
Workflow
Phase 1: Parse the Runbook
- Accept a runbook file path from the user
- Run:
uv run python -m runegard parse <runbook_path> - Present the parsed structure to the user for confirmation:
- Number of steps detected - Decision points identified - Commands that will be executed
- If the user wants changes, adjust and re-parse
Phase 2: Execute the Runbook
skill.md