Saltar al contenido
Playbook

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.

★ Estrella en GitHub

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
Una decisión real, como la registra Playbook

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.

  1. 01

    Wiki

    Qué tiene que hacer el producto y qué no, quién lo usa y cada pregunta abierta.

  2. 02

    Tecnología

    El stack, los límites y lo que cuesta cada elección, verificado en la documentación vigente.

  3. 03

    Skills

    Qué skills de agente necesita el trabajo y cuáles ya existen.

  4. 04

    Sistema de diseño

    Tokens, componentes y patrones, antes de construir una sola pantalla.

  5. 05

    Plan

    Unidades de trabajo, cada una con los archivos que toca y cómo se acepta.

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

  1. 01review encuentra un defecto
  2. 02classify lo guarda como evidencia
  3. 03tres casos del mismo tipo
  4. 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 y reglas aprendidas, acumuladas
  • versiones
  • reglas aprendidas
Versiones y reglas aprendidas, acumuladas: 19 versiones, 13 reglas aprendidas (20 nov 2026).0510152014 nov16 nov18 nov20 nov

19 versiones13 reglas aprendidas

Ver los datos como tabla
VersiónFechaversionesreglas aprendidas
1.0.014 nov 202610
2.0.017 nov 202620
2.1.017 nov 202630
2.2.017 nov 202640
2.2.117 nov 202650
2.2.217 nov 202660
2.3.018 nov 202670
2.4.018 nov 202680
2.5.019 nov 202690
2.6.019 nov 2026100
3.0.019 nov 2026110
3.1.019 nov 2026120
3.1.119 nov 2026130
3.2.019 nov 2026140
3.2.119 nov 2026150
3.3.020 nov 2026160
3.4.020 nov 2026174
3.5.020 nov 2026189
3.6.020 nov 20261913

Notas en inglés, como se publican en GitHub.

  1. v3.6.020 nov 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 de la versión →
  2. v3.5.020 nov 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 de la versión →
  3. v3.4.020 nov 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 de la versión →
Ver las 19 versiones ↓
  1. v3.3.020 nov 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 de la versión →
  2. v3.2.119 nov 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 de la versión →
  3. v3.2.019 nov 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 de la versión →
  4. v3.1.119 nov 2026

    A fix to the version notice of 3.1.0.

    Notas de la versión →
  5. v3.1.019 nov 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 de la versión →
  6. v3.0.019 nov 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 de la versión →
  7. v2.6.019 nov 2026

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

    Notas de la versión →
  8. v2.5.019 nov 2026

    Three commands to start and configure Playbook in Claude Code.

    Notas de la versión →
  9. v2.4.018 nov 2026

    Playbook now supports Codex CLI alongside Claude Code.

    Notas de la versión →
  10. v2.3.018 nov 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 de la versión →
  11. v2.2.217 nov 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 de la versión →
  12. v2.2.117 nov 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 de la versión →
  13. v2.2.017 nov 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 de la versión →
  14. v2.1.017 nov 2026

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

    Notas de la versión →
  15. v2.0.017 nov 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 de la versión →
  16. v1.0.014 nov 2026

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

    Notas de la versión →

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.

  1. 01

    Respaldar

    Guardá tus agentes y skills globales, no solo en tu máquina.

  2. 02

    Publicar

    Compartí un agente o una skill que funciona, para que otros la instalen.

  3. 03

    Instalar

    Explorá lo que compartieron otros y sumalo a tu setup.

Avisame cuando abra

Al enviar, aceptás que usemos tus datos para responderte. Política de privacidad