Skip to content
PLAYBOOK.md Docs

Examples and Resources

Example Playbooks

The playbook-gallery repository contains curated example playbooks organized by category.

Linear Workflows

Sequential step-by-step playbooks with no branching.

  • Content Pipeline — Generate a polished article from a topic and audience through research, outlining, drafting, and polishing steps
  • Meeting Notes — Transform raw meeting notes into structured summaries with action items
  • Code Documentation — Generate comprehensive documentation from source code

Branching Workflows

Playbooks that use conditional logic to route execution.

  • Issue Triage — Classify incoming issues and route to bug analysis, feature specification, or question answering
  • Adaptive Review — Adjust code review depth and focus based on input parameters
  • Tone Adapter — Adapt content to different communication styles based on audience selection

Human-in-the-Loop

Playbooks that pause for human input using @elicit directives.

  • Decision Matrix — Evaluate options with human-guided weighting and feedback
  • Iterative Draft — Write and refine content with human review checkpoints

Tool Integration

Playbooks that invoke external tools using @tool directives.

  • Data Analysis — Fetch metrics from external systems and analyze trends

Browse all examples on GitHub: PLAYBOOK-MD/playbook-gallery

Playground

The PLAYBOOK.md Playground is a web-based editor where you can write, validate, and test playbooks directly in the browser.

  • Syntax highlighting for PLAYBOOK.md format
  • Real-time validation against the spec
  • Export and share playbooks

Visit: playground.playbook.style

Schema

The playbook-schema repository provides:

  • TypeScript types — Full type definitions for the parsed playbook structure
  • JSON Schema — Machine-readable schema for validation and editor tooling

Use the schema package to build your own PLAYBOOK.md tools with type safety.

Repository: PLAYBOOK-MD/playbook-schema

Specification

The canonical specification lives in the playbook-spec repository. The docs site you are reading presents and explains the spec — the repository is the authoritative source.

  • Version: v0.1.0 (Draft)
  • Spec License: CC BY 4.0
  • Code License: MIT
ResourceURL
Specification repogithub.com/PLAYBOOK-MD/playbook-spec
Example gallerygithub.com/PLAYBOOK-MD/playbook-gallery
Schema packagegithub.com/PLAYBOOK-MD/playbook-schema
Playgroundplayground.playbook.style
GitHub organizationgithub.com/PLAYBOOK-MD
Promptmark (reference impl)promptmark.ai