Skip to content

playbook 3.0.0

Choose a tag to compare

@andresfrei andresfrei released this 19 Nov 12:53
· 175 commits to main since this release
4e06501

Version 3 lets you delegate a kind of question, so the agent stops asking the ones you always answer "yes" to. It is a major version: it moves a project's wiki to format 5.

What changed

  • Delegation. You can decide a kind of question once for a project, such as closing a stage. The agent then decides it without asking, records it as agent, by <delegation>, and tells you in one line. If you answer "yes but" or "no" to one of those decisions, it proposes revoking the delegation. Four things are never delegated: a new definition of the product, a push or merge into the main branch, an action outside the repository or on your machine, and spending beyond a written ceiling.
  • Proposals come from your own answers. Each decision of a work now records its kind (such as close-stage, plan, definition) and how you answered (as recommended, changed, rejected, delegated). When a work closes, prepare-project runs check-wiki.sh --delegations. A kind qualifies with at least 10 answers, at least 80% of them as recommended, and none rejected. It is proposed once, and a "no" is recorded so the proposal is not made again.
  • Wiki format 5. A work's decisions.md has two more columns, Kind and Answer. A new shared page, 01-product/delegations.md, lists the delegations in force and those revoked.
  • The contract. R6 now reads "Only the owner decides, per case or by a recorded delegation", and R10 is shorter.

From version 2

After the update, the notice at the start of a session says your wiki is behind. In each project with a wiki, run /playbook-wiki:doctor in a new session. It adds the Kind and Answer columns to every work's decisions.md. It fills earlier rows from each decision and your words, marked (estimated), and leaves a cell empty when unsure. It shows you the totals before writing anything. docs/wiki/decisions.md, the history from before format 4, is not touched.

claude plugin marketplace update playbook
claude plugin update playbook-wiki@playbook
claude plugin update playbook-agents@playbook

Install

claude plugin marketplace add andresfrei/playbook
claude plugin install playbook@playbook --scope user

Then run /playbook:init in a new session. More in the Install section of the README.

Licence

MIT. Issues and pull requests are welcome; see CONTRIBUTING.md.