v3.6.0Open source · MIT
Tu agente de código, con método.
Playbook es un conjunto de plugins gratis para Claude Code y Codex CLI. Vos decidís qué tiene que hacer el software; el agente lo registra en tu repo, construye a partir de eso, muestra cómo verificó el resultado y convierte los errores repetidos en reglas.
Funciona con Claude Code y 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
01El problema
Los agentes se olvidan. Tu repositorio no debería.
Las decisiones se pierden en el chat
Lo que acordaste con el agente vive en una sesión que se cierra. La semana que viene nadie sabe por qué el código es como es.
Cada sesión arranca de cero
Un compañero, o el mismo agente mañana, no ve qué se decidió, qué cambió ni qué pregunta sigue abierta.
Los mismos errores vuelven
Las revisiones encuentran el mismo tipo de bug una y otra vez, porque nada convierte lo aprendido en una regla que el agente siga.
02Cómo funciona
Seis etapas antes del código. Cada una la cerrás vos.
Cada funcionalidad o fase nueva es un trabajo con su carpeta en docs/wiki/. El agente propone, pregunta de a una cosa y registra tu respuesta textual.
- 01
Wiki
Qué tiene que hacer el producto y qué no, quién lo usa y cada pregunta abierta.
- 02
Tecnología
El stack, los límites y lo que cuesta cada elección, verificado en la documentación vigente.
- 03
Skills
Qué skills de agente necesita el trabajo y cuáles ya existen.
- 04
Sistema de diseño
Tokens, componentes y patrones, antes de construir una sola pantalla.
- 05
Plan
Unidades de trabajo, cada una con los archivos que toca y cómo se acepta.
- 06
Ejecución
El agente construye unidad por unidad, registra la evidencia y te pide que aceptes.
03Aprende
Los errores repetidos se vuelven reglas.
Un agente de revisión lee cada cambio riesgoso desde un contexto limpio. Cada defecto que encuentra se guarda como evidencia, bajo un tipo de error. Cuando tres revisiones caen en el mismo tipo, Playbook propone una regla, y los agentes que escriben y revisan código la reciben cada vez que arrancan.
- 01review encuentra un defecto
- 02classify lo guarda como evidencia
- 03tres casos del mismo tipo
- 04una regla que siguen todos los agentes
04Plugins
Tres plugins. Usá la wiki sola o sumá el equipo.
playbook
El asistente de instalación, /playbook:init: elegís los componentes y su alcance.
Leer la guía →playbook-wiki
Memoria del proyecto: decisiones guardadas en Git, cada trabajo preparado en seis etapas y controles sobre la wiki antes de cada commit y merge.
Leer la guía →playbook-agents
Un equipo de trabajo: explore mapea el código, write construye, review revisa y classify guarda los hallazgos como evidencia. Además, reglas de trabajo y skills.
Leer la guía →
05Instalar
Pegá un prompt. Tu agente hace el resto.
Copiá el prompt de tu cliente en una sesión. Después corré /playbook:init en tu proyecto.
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.
06Novedades
Crece construyéndose a sí mismo.
Cada versión desde la primera, leída del repositorio. Cada hallazgo de revisión que Playbook registra puede volverse una regla que viaja en la versión siguiente.
- versiones
- reglas aprendidas
19 versiones13 reglas aprendidas
Ver los datos como tabla
| Versión | Fecha | versiones | reglas aprendidas |
|---|---|---|---|
| 1.0.0 | 14 nov 2026 | 1 | 0 |
| 2.0.0 | 17 nov 2026 | 2 | 0 |
| 2.1.0 | 17 nov 2026 | 3 | 0 |
| 2.2.0 | 17 nov 2026 | 4 | 0 |
| 2.2.1 | 17 nov 2026 | 5 | 0 |
| 2.2.2 | 17 nov 2026 | 6 | 0 |
| 2.3.0 | 18 nov 2026 | 7 | 0 |
| 2.4.0 | 18 nov 2026 | 8 | 0 |
| 2.5.0 | 19 nov 2026 | 9 | 0 |
| 2.6.0 | 19 nov 2026 | 10 | 0 |
| 3.0.0 | 19 nov 2026 | 11 | 0 |
| 3.1.0 | 19 nov 2026 | 12 | 0 |
| 3.1.1 | 19 nov 2026 | 13 | 0 |
| 3.2.0 | 19 nov 2026 | 14 | 0 |
| 3.2.1 | 19 nov 2026 | 15 | 0 |
| 3.3.0 | 20 nov 2026 | 16 | 0 |
| 3.4.0 | 20 nov 2026 | 17 | 4 |
| 3.5.0 | 20 nov 2026 | 18 | 9 |
| 3.6.0 | 20 nov 2026 | 19 | 13 |
Notas en inglés, como se publican en GitHub.
v3.6.020 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 las 19 versiones ↓Ver menos ↑
v3.3.020 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →A fix to the version notice of 3.1.0.
v3.1.019 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →prepare-project now asks how a work is delivered, before any code.
v2.5.019 nov 2026
Notas de la versión →Three commands to start and configure Playbook in Claude Code.
v2.4.018 nov 2026
Notas de la versión →Playbook now supports Codex CLI alongside Claude Code.
v2.3.018 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →Version 2.1.0 adds two things to playbook-wiki and breaks nothing.
v2.0.017 nov 2026
Notas de la versión →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 nov 2026
Notas de la versión →First public release of the playbook: one person's working rules, skills, and agents for AI coding agents, shared as it is.
07Open source
Gratis, MIT y construido consigo mismo.
Playbook se desarrolla con Playbook: su propio repositorio guarda las decisiones, los planes y la evidencia detrás de cada versión. Leelos, hacé un fork, abrí un issue.
- Versión actual
- v3.6.0
- Licencia
- MIT
08Próximamente
Una tienda de agentes y skills.
Playbook ya convierte errores repetidos en reglas y crea agentes dedicados para las tareas que se repiten. Lo que sigue: un lugar para compartirlos. Todavía no está abierta.
- 01
Respaldar
Guardá tus agentes y skills globales, no solo en tu máquina.
- 02
Publicar
Compartí un agente o una skill que funciona, para que otros la instalen.
- 03
Instalar
Explorá lo que compartieron otros y sumalo a tu setup.