v3.6.0Open source · MIT
Seu agente de código, com método.
Playbook é um conjunto de plugins gratuitos para Claude Code e Codex CLI. Você decide o que o software deve fazer; o agente registra isso no seu repositório, constrói a partir daí, mostra como verificou o resultado e transforma erros repetidos em regras.
Funciona com Claude Code e Codex CLI
docs/wiki/works/playbook-product/decisions.md
- ID
- playbook-product-26
- Decision
- English at /, Spanish at /es/, Portuguese at /pt/, with automatic detection.
- Who decided
- owner
- Their words
- "si, ingles raiz, pero que detecte automaticamente"
- Kind
- definition
01O problema
Agentes esquecem. Seu repositório não deveria.
As decisões somem no chat
O que você combinou com o agente vive em uma sessão que termina. Na semana seguinte ninguém sabe por que o código é assim.
Cada sessão começa do zero
Um colega, ou o próprio agente amanhã, não vê o que foi decidido, o que mudou nem qual pergunta continua aberta.
Os mesmos erros voltam
As revisões encontram o mesmo tipo de bug várias vezes, porque nada transforma o aprendizado em uma regra que o agente siga.
02Como funciona
Seis etapas antes do código. Você fecha cada uma.
Cada funcionalidade ou fase nova é um trabalho com sua pasta em docs/wiki/. O agente propõe, faz uma pergunta por vez e registra sua resposta literal.
- 01
Wiki
O que o produto deve e não deve fazer, quem o usa e cada pergunta aberta.
- 02
Tecnologia
A stack, os limites e o custo de cada escolha, verificados na documentação atual.
- 03
Skills
Quais skills de agente o trabalho precisa e quais já existem.
- 04
Design system
Tokens, componentes e padrões, antes de construir uma única tela.
- 05
Plano
Unidades de trabalho, cada uma com os arquivos que toca e como será aceita.
- 06
Execução
O agente constrói unidade por unidade, registra a evidência e pede seu aceite.
03Aprende
Erros repetidos viram regras.
Um agente de revisão lê cada mudança arriscada a partir de um contexto limpo. Cada defeito encontrado é guardado como evidência, sob um tipo de erro. Quando três revisões caem no mesmo tipo, o Playbook propõe uma regra, e os agentes que escrevem e revisam código a recebem sempre que começam.
- 01review encontra um defeito
- 02classify guarda como evidência
- 03três casos do mesmo tipo
- 04uma regra que todos os agentes seguem
04Plugins
Três plugins. Use a wiki sozinha ou adicione o time.
playbook
O assistente de instalação, /playbook:init: escolha os componentes e o escopo.
Ler o guia →playbook-wiki
Memória do projeto: decisões guardadas no Git, cada trabalho preparado em seis etapas e verificações na wiki antes de cada commit e merge.
Ler o guia →playbook-agents
Um time de trabalho: explore mapeia o código, write constrói, review revisa e classify guarda os achados como evidência. Além disso, regras de trabalho e skills.
Ler o guia →
05Instalar
Cole um prompt. Seu agente faz o resto.
Copie o prompt do seu cliente em uma sessão. Depois rode /playbook:init no seu projeto.
Claude Code
Install Playbook for Claude Code from https://github.com/andresfrei/playbook. Add its marketplace with `claude plugin marketplace add andresfrei/playbook` if it is missing. Run `claude plugin install playbook@playbook --scope user`. Use `claude plugin list` to confirm the plugin is enabled and tell me its version. Then tell me how to start a fresh Claude Code session in my project and run /playbook:init so I can choose the components and scope.
Codex CLI
Install Playbook for Codex CLI from https://github.com/andresfrei/playbook. Ask me which setup I want: 1 for the wiki only, or 2 for the wiki and agents. Use my local Playbook checkout if it contains codex/install.py. Otherwise, clone the repository into a fresh directory. From the checkout root, run `python3 codex/install.py` and supply my choice when it prompts. Report what was installed and any existing profiles the installer kept. Show me which hooks to review in /hooks, then how to start a fresh Codex session in my project.
06Novidades
Cresce construindo a si mesmo.
Cada versão desde a primeira, lida do repositório. Cada achado de revisão que o Playbook registra pode virar uma regra que vai na próxima versão.
- versões
- regras aprendidas
19 versões13 regras aprendidas
Ver os dados como tabela
| Versão | Data | versões | regras aprendidas |
|---|---|---|---|
| 1.0.0 | 14 de nov. de 2026 | 1 | 0 |
| 2.0.0 | 17 de nov. de 2026 | 2 | 0 |
| 2.1.0 | 17 de nov. de 2026 | 3 | 0 |
| 2.2.0 | 17 de nov. de 2026 | 4 | 0 |
| 2.2.1 | 17 de nov. de 2026 | 5 | 0 |
| 2.2.2 | 17 de nov. de 2026 | 6 | 0 |
| 2.3.0 | 18 de nov. de 2026 | 7 | 0 |
| 2.4.0 | 18 de nov. de 2026 | 8 | 0 |
| 2.5.0 | 19 de nov. de 2026 | 9 | 0 |
| 2.6.0 | 19 de nov. de 2026 | 10 | 0 |
| 3.0.0 | 19 de nov. de 2026 | 11 | 0 |
| 3.1.0 | 19 de nov. de 2026 | 12 | 0 |
| 3.1.1 | 19 de nov. de 2026 | 13 | 0 |
| 3.2.0 | 19 de nov. de 2026 | 14 | 0 |
| 3.2.1 | 19 de nov. de 2026 | 15 | 0 |
| 3.3.0 | 20 de nov. de 2026 | 16 | 0 |
| 3.4.0 | 20 de nov. de 2026 | 17 | 4 |
| 3.5.0 | 20 de nov. de 2026 | 18 | 9 |
| 3.6.0 | 20 de nov. de 2026 | 19 | 13 |
Notas em inglês, como publicadas no GitHub.
v3.6.020 de nov. de 2026
Notas da versão →Dedicated agents for repeated tasks
At the close of each work, Playbook now records the tasks the agent carried out, and proposes a dedicated agent, on a model that fits the task, for a task that repeats (work task-agents, #44).
v3.5.020 de nov. de 2026
Notas da versão →Units built in parallel
A work's plan now says which units can be built at the same time, and stage 6 builds them in parallel (work parallel-units, #42).
v3.4.020 de nov. de 2026
Notas da versão →Ask before what cannot be undone
Claude Code now asks you before the actions you cannot take back, and a new command protects a repository's secrets (work ask-before-irreversible, #40).
Ver as 19 versões ↓Ver menos ↑
v3.3.020 de nov. de 2026
Notas da versão →Evidence seeded from past reviews
A repository can now start its evidence page from the reviews it already had (work seed-evidence, #38).
v3.2.119 de nov. de 2026
Notas da versão →playbook-agents: when a review ends with findings and starts no classify, the hook now stops it once per subagent.
Before, stop_hook_active was not set on the repeated stops of one review, so a review that could not start the classifier was stopped again and again (repeated-corrections-31, #36).
v3.2.019 de nov. de 2026
Notas da versão →Learned rules from repeated review findings
When review keeps finding the same kind of mistake, the agent now learns from it (work repeated-corrections, #34).
v3.1.119 de nov. de 2026
Notas da versão →A fix to the version notice of 3.1.0.
v3.1.019 de nov. de 2026
Notas da versão →Claude Code does not tell you when a plugin from this marketplace has a new version.
From 3.1.0, the playbook tells you itself, at the start of a session, and the notice about your wiki's format now reaches you, not only the agent.
v3.0.019 de nov. de 2026
Notas da versão →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.
v2.6.019 de nov. de 2026
Notas da versão →prepare-project now asks how a work is delivered, before any code.
v2.5.019 de nov. de 2026
Notas da versão →Three commands to start and configure Playbook in Claude Code.
v2.4.018 de nov. de 2026
Notas da versão →Playbook now supports Codex CLI alongside Claude Code.
v2.3.018 de nov. de 2026
Notas da versão →Version 2.3.0 makes the agent review read a risky change before it is committed, instead of relying on the agent to remember rule R20.
It adds two hooks to playbook-agents and breaks nothing.
v2.2.217 de nov. de 2026
Notas da versão →Version 2.2.2 makes the report of review-change and the questions of prepare-project closer to what each skill says, and makes their evaluation cases read the meaning of an answer.
It breaks nothing.
v2.2.117 de nov. de 2026
Notas da versão →Version 2.2.1 fixes skills that did not load when a request called for them, and a script that failed in a sandbox.
It breaks nothing.
v2.2.017 de nov. de 2026
Notas da versão →Version 2.2.0 brings the skills in line with the best practices for skills that Anthropic and agentskills.io publish, and breaks nothing.
v2.1.017 de nov. de 2026
Notas da versão →Version 2.1.0 adds two things to playbook-wiki and breaks nothing.
v2.0.017 de nov. de 2026
Notas da versão →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.
v1.0.014 de nov. de 2026
Notas da versão →First public release of the playbook: one person's working rules, skills, and agents for AI coding agents, shared as it is.
07Open source
Gratuito, MIT e construído com ele mesmo.
O Playbook é desenvolvido com o Playbook: seu próprio repositório guarda as decisões, os planos e a evidência por trás de cada versão. Leia, faça um fork, abra uma issue.
- Versão atual
- v3.6.0
- Licença
- MIT
08Em breve
Uma loja de agentes e skills.
O Playbook já transforma erros repetidos em regras e cria agentes dedicados para tarefas que se repetem. O próximo passo: um lugar para compartilhá-los. Ainda não está aberta.
- 01
Fazer backup
Guarde seus agentes e skills globais, não só na sua máquina.
- 02
Publicar
Compartilhe um agente ou uma skill que funciona, para que outros instalem.
- 03
Instalar
Explore o que outros compartilharam e adicione ao seu setup.