Pular para o conteúdo
Playbook

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.

★ Estrela no GitHub

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
Uma decisão real, como o Playbook registra

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.

  1. 01

    Wiki

    O que o produto deve e não deve fazer, quem o usa e cada pergunta aberta.

  2. 02

    Tecnologia

    A stack, os limites e o custo de cada escolha, verificados na documentação atual.

  3. 03

    Skills

    Quais skills de agente o trabalho precisa e quais já existem.

  4. 04

    Design system

    Tokens, componentes e padrões, antes de construir uma única tela.

  5. 05

    Plano

    Unidades de trabalho, cada uma com os arquivos que toca e como será aceita.

  6. 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.

  1. 01review encontra um defeito
  2. 02classify guarda como evidência
  3. 03três casos do mesmo tipo
  4. 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 e regras aprendidas, acumuladas
  • versões
  • regras aprendidas
Versões e regras aprendidas, acumuladas: 19 versões, 13 regras aprendidas (20 de nov. de 2026).0510152014 de nov.16 de nov.18 de nov.20 de nov.

19 versões13 regras aprendidas

Ver os dados como tabela
VersãoDataversõesregras aprendidas
1.0.014 de nov. de 202610
2.0.017 de nov. de 202620
2.1.017 de nov. de 202630
2.2.017 de nov. de 202640
2.2.117 de nov. de 202650
2.2.217 de nov. de 202660
2.3.018 de nov. de 202670
2.4.018 de nov. de 202680
2.5.019 de nov. de 202690
2.6.019 de nov. de 2026100
3.0.019 de nov. de 2026110
3.1.019 de nov. de 2026120
3.1.119 de nov. de 2026130
3.2.019 de nov. de 2026140
3.2.119 de nov. de 2026150
3.3.020 de nov. de 2026160
3.4.020 de nov. de 2026174
3.5.020 de nov. de 2026189
3.6.020 de nov. de 20261913

Notas em inglês, como publicadas no GitHub.

  1. v3.6.020 de nov. de 2026

    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).

    Notas da versão →
  2. v3.5.020 de nov. de 2026

    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).

    Notas da versão →
  3. v3.4.020 de nov. de 2026

    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).

    Notas da versão →
Ver as 19 versões ↓
  1. v3.3.020 de nov. de 2026

    Evidence seeded from past reviews

    A repository can now start its evidence page from the reviews it already had (work seed-evidence, #38).

    Notas da versão →
  2. v3.2.119 de nov. de 2026

    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).

    Notas da versão →
  3. v3.2.019 de nov. de 2026

    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).

    Notas da versão →
  4. v3.1.119 de nov. de 2026

    A fix to the version notice of 3.1.0.

    Notas da versão →
  5. v3.1.019 de nov. de 2026

    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.

    Notas da versão →
  6. v3.0.019 de nov. de 2026

    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.

    Notas da versão →
  7. v2.6.019 de nov. de 2026

    prepare-project now asks how a work is delivered, before any code.

    Notas da versão →
  8. v2.5.019 de nov. de 2026

    Three commands to start and configure Playbook in Claude Code.

    Notas da versão →
  9. v2.4.018 de nov. de 2026

    Playbook now supports Codex CLI alongside Claude Code.

    Notas da versão →
  10. v2.3.018 de nov. de 2026

    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.

    Notas da versão →
  11. v2.2.217 de nov. de 2026

    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.

    Notas da versão →
  12. v2.2.117 de nov. de 2026

    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.

    Notas da versão →
  13. v2.2.017 de nov. de 2026

    Version 2.2.0 brings the skills in line with the best practices for skills that Anthropic and agentskills.io publish, and breaks nothing.

    Notas da versão →
  14. v2.1.017 de nov. de 2026

    Version 2.1.0 adds two things to playbook-wiki and breaks nothing.

    Notas da versão →
  15. v2.0.017 de nov. de 2026

    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.

    Notas da versão →
  16. v1.0.014 de nov. de 2026

    First public release of the playbook: one person's working rules, skills, and agents for AI coding agents, shared as it is.

    Notas da versão →

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.

  1. 01

    Fazer backup

    Guarde seus agentes e skills globais, não só na sua máquina.

  2. 02

    Publicar

    Compartilhe um agente ou uma skill que funciona, para que outros instalem.

  3. 03

    Instalar

    Explore o que outros compartilharam e adicione ao seu setup.

Me avise quando abrir

Ao enviar, você concorda que usemos seus dados para responder. Política de privacidade