# Clone the repo
git clone https://github.com/andreolf/claude-playbooks.git
cd claude-playbooks

# Install
./install.sh

# List available playbooks
playbook list

# Run your first playbook
playbook run audit_contract \
  --vars project="MyDeFi" \
  --vars chain="Ethereum" \
  --vars scope="Staking contract" \
  --vars threat_model="Reentrancy, access control" \
  --vars risk="High" \
  --input contracts/Staking.sol

# Pipe git diff directly into a PR review prompt
git diff HEAD~1 | playbook run review_pr --stdin --vars repo="my-app" --vars title="Latest changes" --vars risk="medium"

# List playbooks in a pack
playbook list --pack examples

# Run playbook from pack
playbook run hello_world --pack examples --vars name="World" --vars language="English"

# Pack requires license? Set environment variable:
export YOUR_PACK_LICENSE="your-license-key"

# Initialize new pack structure
playbook init my-pack --with-pack my-pack

# Creates:
# packs/my-pack/meta/manifest.json
# packs/my-pack/playbooks/example.md

playbook run <name> [options]

Options:
  --input <file>       Inject file content as {{input}}
  --stdin              Read from stdin as {{input}}
  --vars key=value     Set template variable (repeatable)
  --pack <name>        Load playbook from pack
  --print-only         Print only, don't save to out/
  --copy               Copy output to clipboard (macOS/Linux)

Examples:
  # Basic usage
  playbook run review_pr --input changes.diff

  # Multiple variables
  playbook run audit_contract \
    --vars project="DeFi" \
    --vars chain="Base" \
    --vars scope="Staking changes" \
    --vars threat_model="Economic attacks" \
    --vars risk="High" \
    --input contracts/

  # Read from stdin
  git diff | playbook run review_pr --stdin --vars repo="my-app" --vars title="Add auth"

  # Use pack
  playbook run hello_world --pack examples \
    --vars name="Alice" \
    --vars language="Spanish"

  # Copy to clipboard
  playbook run ship_blog \
    --vars topic="Web3 Security" \
    --vars audience="Developers" \
    --copy

playbook list [--pack <name>]

Options:
  --pack <name>        List playbooks in specific pack

Examples:
  # List core playbooks
  playbook list

  # List pack playbooks
  playbook list --pack examples

playbook init <path> [--with-pack <name>]

Options:
  --with-pack <name>   Create pack structure instead of single playbook

Examples:
  # Create new playbook
  playbook init playbooks/my_playbook.md

  # Create new pack
  playbook init my-custom-pack --with-pack my-custom-pack

playbook run audit_contract \
  --vars project="DeFi Protocol" \
  --vars chain="Base" \
  --vars scope="Staking contract changes" \
  --vars threat_model="Economic attacks, reentrancy" \
  --vars risk="High - mainnet launch" \
  --input contracts/Staking.sol

playbook run review_pr \
  --vars repo="my-webapp" \
  --vars title="Add payment processing" \
  --vars risk="medium" \
  --input changes.diff

playbook run release_notes \
  --vars product="MyApp" \
  --vars version="2.0.0" \
  --input git-log.txt

playbook run token_launch_checklist \
  --vars project="MyToken" \
  --vars token="MTK" \
  --vars chain="Ethereum" \
  --vars launch_date="2026-02-01" \
  --vars distribution="80% liquidity, 20% team vesting" \
  --vars constraints="24h launch window"

playbook run panel_questions_web3 \
  --vars event="EthDenver" \
  --vars session="DeFi Security" \
  --vars audience="Builders" \
  --vars panelists="Alice (Auditor), Bob (Protocol Dev)" \
  --vars goal="Actionable security practices" \
  --vars avoid="Marketing fluff"

playbook run ship_blog \
  --vars topic="Smart Contract Optimization" \
  --vars audience="Solidity developers" \
  --vars angle="Gas optimization patterns" \
  --vars constraints="800-1200 words" \
  --input notes.txt

--vars project="My DApp"
--vars chain="Polygon"
--vars risk="Medium"

playbook run my_playbook \
  --vars project="..." \
  --vars goal="..." \
  --input data.txt

#!/usr/bin/env bash
set -e
echo "[pre] running for $PLAYBOOK_NAME"

# Example: ensure git repo is clean before audit
if [ "$PLAYBOOK_NAME" = "audit_contract" ]; then
  git diff --quiet || {
    echo "Error: uncommitted changes detected"
    exit 1
  }
fi

#!/usr/bin/env bash
set -e
echo "[post] saved prompt to $OUT_FILE"

# Copy to clipboard (macOS)
cat "$OUT_FILE" | pbcopy
echo "[post] ✓ copied to clipboard"

# Or send to Claude API
# curl -X POST https://api.anthropic.com/v1/messages ...

# In post.sh
if [ "$PLAYBOOK_NAME" = "audit_contract" ]; then
  # Generate remediation tasks from audit output
  playbook run create_tasks --input "$OUT_FILE"
fi

# config.env
export PROJECT="MyDApp"
export CHAIN="Ethereum"
export RISK_LEVEL="High"

# Load and use
source config.env
playbook run audit_contract \
  --vars project="$PROJECT" \
  --vars chain="$CHAIN" \
  --vars risk="$RISK_LEVEL"

./playbook.py audit_contract --vars project="X"

playbook run audit_contract --vars project="X"

python3 test_playbook.py