playbook-review

Walk the playbook-inbox.md proposal queue and promote heuristics into per-node playbooks.

4|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/leocosta/octopus --skill playbook-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: playbook-review
Source: https://github.com/leocosta/octopus/tree/main/skills/playbook-review
Command: npx skills add https://github.com/leocosta/octopus --skill playbook-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates governance of per-node playbooks by bridging agent proposals with concrete updates to contexts, projects, and people, reducing manual curation and drift.

Core Features & Use Cases

  • Walk the playbook-inbox.md proposal queue and present each item to the manager for action.
  • Promote, edit, or discard heuristics, writing changes to contexts/<ctx>/playbook.md, projects/<proj>/playbook.md, or people/<person>.md.
  • Seed mode (--seed) allows managers to insert heuristics directly into the target playbook.
  • Enforce workspace guards via consigliere.workspace and write-guards to ensure changes stay within scope.

Quick Start

Run the review process to walk the proposal queue and promote validated heuristics into the appropriate per-node playbooks.

Frequently Asked Questions about playbook-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate governance for per-node playbook updates?

You can promote, edit, or discard proposed heuristics during the review process, writing validated changes to contexts, projects, or people node files to reduce manual curation and drift.

How do I manage heuristic proposals in a governance workflow?

You can promote, edit, or discard proposed heuristics during the review process, writing validated changes to contexts, projects, or people node files to reduce manual curation and drift.

Can I seed heuristics directly into a target playbook without reviewing proposals?

Yes, you can use seed mode to insert heuristics directly into the target playbook file, bypassing the proposal queue for immediate updates to contexts, projects, or people nodes.

Does playbook review require a specific workspace configuration?

Yes, the process requires a configured consigliere.workspace setting with strict write-guards to ensure all heuristic updates and file changes remain self-contained within the workspace scope.

What are the limitations of automated playbook governance?

The system confines all writes to the configured consigliere workspace using strict guards, meaning it cannot modify files outside that scope and relies on manual manager review to validate proposals.