# 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](./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:

1. `.pi/skills/reviewer-runtime/pi/`
2. `~/.pi/agent/skills/reviewer-runtime/pi/`

## Verify An Existing Install

Project-local:

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

Global:

```bash
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:

```bash
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:

```bash
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
```

## Telegram

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](./TELEGRAM-NOTIFICATIONS.md).

## What This Doc Does Not Cover

- installing Obra Superpowers
- Pi package layout decisions

Those belong in [PI-SUPERPOWERS.md](./PI-SUPERPOWERS.md) and [PI.md](./PI.md).