Skip to content

playbook 2.0.0

Choose a tag to compare

@andresfrei andresfrei released this 17 Nov 01:14
· 328 commits to main since this release
923d7d7

Version 2 splits the playbook into a shared core, for everyone who works on a project, and the owner's agent system, which anyone may use. It is a major version: it breaks an installation of version 1.

What changed

  • Three plugins in one marketplace:
    • playbook: only the start command, /playbook:init. Nothing else loads until you run it.
    • playbook-wiki, the core: the contract an agent follows, the format of a project's wiki and its check, a step before a git merge that shows the decisions to compare, and the skills prepare-project, write-docs, and doctor.
    • playbook-agents, the owner's agent system: 18 working rules, the agents explore, write, and review, and the skills keep-minimal, review-change, write-skill, and avoid-generic-design. It needs playbook-wiki.
  • /playbook:init asks for the wiki alone or the whole product, this repository or every project, and the language the agent talks to you in. It tells you about other plugins and a global CLAUDE.md, and about skills you have that do the same job as one it turns on.
  • Wiki format 4: each piece of work a branch carries is a work, with its own folder, decisions, and plan, so several people can work on one project. /playbook-wiki:doctor brings a wiki from an earlier format.
  • Acceptance by evidence: a plan says which units are accepted by their checks and which wait for the owner's review.
  • opencode is no longer supported.

From version 1

After the update, playbook holds only the start command, so your rules, skills, and agents are gone until you run /playbook:init once, in a new session, and choose the whole product for every project.

claude plugin marketplace update playbook
claude plugin update playbook@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.