PI COMMON REVIEWER

Purpose

This document covers the shared reviewer-runtime helpers used by the Pi workflow skills.

It is intentionally separate from PI-SUPERPOWERS.md. Superpowers are skill dependencies; reviewer-runtime is helper-script setup.

Required Files

The workflow-heavy Pi skills expect these helper files from skills/reviewer-runtime/pi/:

run-review.sh
notify-telegram.sh

Supported install locations:

.pi/skills/reviewer-runtime/pi/
~/.pi/agent/skills/reviewer-runtime/pi/

Verify An Existing Install

Project-local:

test -x .pi/skills/reviewer-runtime/pi/run-review.sh
test -x .pi/skills/reviewer-runtime/pi/notify-telegram.sh

Global:

test -x ~/.pi/agent/skills/reviewer-runtime/pi/run-review.sh
test -x ~/.pi/agent/skills/reviewer-runtime/pi/notify-telegram.sh

Install The Common Reviewer Helpers

Global install:

mkdir -p ~/.pi/agent/skills/reviewer-runtime/pi
cp -R skills/reviewer-runtime/pi/* ~/.pi/agent/skills/reviewer-runtime/pi/
chmod +x ~/.pi/agent/skills/reviewer-runtime/pi/*.sh

Project-local install:

mkdir -p .pi/skills/reviewer-runtime/pi
cp -R skills/reviewer-runtime/pi/* .pi/skills/reviewer-runtime/pi/
chmod +x .pi/skills/reviewer-runtime/pi/*.sh

If you want the workflow skills to send completion messages, configure:

TELEGRAM_BOT_TOKEN
TELEGRAM_CHAT_ID

The Pi helper uses the same notification behavior documented in TELEGRAM-NOTIFICATIONS.md.

What This Doc Does Not Cover

installing Obra Superpowers
Pi package layout decisions

Those belong in PI-SUPERPOWERS.md and PI.md.

1.7 KiB Raw Blame History