pwf-doc-runbook

pwf-doc-runbook is a command for Claude Code from J-Pster/Psters_AI_Workflow. It costs 38 tokens per session (479 once invoked), scanned A, original, MIT.

A set of instructions for creating or updating operational runbooks: short documents that tell a team how to handle service incidents. It stores them in docs/runbooks/ and keeps an index of available runbooks.

In plain words
What is it for?
Use it to document how to respond when a service or critical workflow fails, including required access, monitoring checks, commands, dependencies, and failure handling.
Why use it?
It removes the need to improvise during outages by putting diagnosis, mitigation, rollback, escalation, and follow-up steps in one consistent place.

Command for Claude Code

Written for Claude Code: disable-model-invocation in frontmatter.

Good fit Use it to document how to respond when a service or critical workflow fails, including required access, monitoring checks, commands, dependencies, and failure handling.

Compare 6 commands from other repositories ↓
Install with agentmods
npx agentmods add commands/j-pster/psters_ai_workflow/pwf-doc-runbook
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/J-Pster/Psters_AI_Workflow

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for pwf-doc-runbook

README.md
[![agentmods](https://agentmods.dev/badge/commands/j-pster/psters_ai_workflow/pwf-doc-runbook/github.svg)](https://agentmods.dev/commands/j-pster/psters_ai_workflow/pwf-doc-runbook)
Your own site
<a href="https://agentmods.dev/commands/j-pster/psters_ai_workflow/pwf-doc-runbook"><img src="https://agentmods.dev/badge/commands/j-pster/psters_ai_workflow/pwf-doc-runbook/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for pwf-doc-runbook

Your own site · 80×15
<a href="https://agentmods.dev/commands/j-pster/psters_ai_workflow/pwf-doc-runbook"><img src="https://agentmods.dev/badge/commands/j-pster/psters_ai_workflow/pwf-doc-runbook.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 38 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 479 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00038 $0.00479
Opus 5 $0.00019 $0.00239
Sonnet 5 $0.00008 $0.00096
Haiku 4.5 $0.00004 $0.00048

Measured 11d ago against content hash 303171f03c13, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

pwf-doc-runbook scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 11d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/psters-ai-workflow/commands/pwf-doc-runbook.md · 70 lines

What it actually says

Build Operational Runbooks

Use this command to create or update operational runbooks for services and critical workflows. Runbooks should be practical during incidents: short, specific, and executable.

Input

<doc_runbook_target> #$ARGUMENTS </doc_runbook_target>

If empty, ask: "Which runbook should I create or update? (example: payments-api or deploy-backend)"

Special target:

  • index -> refresh docs/runbooks/README.md

Canonical paths

  • Runbook file: docs/runbooks/<slug>.md
  • Index file: docs/runbooks/README.md

Workflow

  1. Ensure docs/runbooks/ exists.
  2. Determine whether this is create or update:
    • if runbook file exists, update it in place (anti-drift),
    • if not, create new canonical file.
  3. Read related source docs before writing:
    • docs/infrastructure.md
    • docs/architecture.md
    • docs/integrations.md
    • docs/environments.md
  4. Write/update runbook with concrete command paths, dependencies, and failure handling.
  5. Update docs/runbooks/README.md with runbook index entry.

Required runbook structure

  • Overview
  • Scope and Ownership
  • Access and Prerequisites
  • Monitoring and Alerts
  • Common Failure Scenarios
  • Diagnosis Steps
  • Mitigation and Recovery
  • Rollback Procedure
  • Escalation
  • Post-Incident Checklist

Output

Report:

  • runbook path created/updated,
  • index updates,
  • missing operational data still needed from the user.
  • /pwf-doc-foundation all when baseline docs are stale or incomplete
  • /pwf-doc update for full consistency scan
  • /pwf-review if runbook changes reflect high-risk operational changes
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 11d ago First seen · 70 lines · 38 tokens per session scan A 303171f03c13

Subscribe to this mod's changes

pwf-doc-runbook is a command published in the GitHub repository J-Pster/Psters_AI_Workflow (289 stars, last pushed 5mo ago), licensed MIT. It adds 38 tokens to every session and 479 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.