auto

/punt:auto — Playbook Executor

Execute an automation playbook. Playbooks define multi-step processes as YAML files with deterministic scripts and LLM judgment steps. The executor drives each step, checks postconditions, and handles failures autonomously.

Usage

• /punt:auto <playbook> — run a playbook by name
• /punt:auto <playbook> key=value key=value — run with parameters
• /punt:auto list — list available playbooks

Argument Parsing

Parse the first argument as the playbook name. Remaining arguments are key=value parameter pairs. If list, skip to the listing behavior.

Playbook Discovery

Search for playbooks in order:

1. ./playbooks/<name>.yaml — project-local (current working directory)
2. ${CLAUDE_PLUGIN_ROOT}/playbooks/<name>.yaml — punt-kit plugin root (when invoked as a command)
3. ../punt-kit/plugin/playbooks/<name>.yaml — org-wide fallback (when run from a sibling repo)

Project-local playbooks take precedence over org-wide playbooks with the same name. When ${CLAUDE_PLUGIN_ROOT} is not set, skip path 2.

If a named playbook is not found in any applicable location, report every path that was searched and stop. Do not substitute a similarly-named playbook and do not improvise the steps — a playbook is a contract, and guessing at one is how a release runs the wrong phases.

For list, scan all applicable locations and print a table:

Name                Source      Description
───────────────────────────────────────────────────────────────────
autopilot           org         Autonomous bead-driven development loop
permissions-rollout org         Roll out permission changes to all projects
release             org         Release a Punt Labs project
standards-rollout   org         Roll out a standards change across all projects
<name>              local       <description>

Execution Protocol

Phase 0: Load and Validate

1. Read the YAML file.
2. Extract name, description, mode, parameters, preconditions, steps.
3. Validate required parameters have values (from arguments or defaults).
4. If any required parameter is missing, report which ones and stop.