fix(pi): package warning-free skill mirror and docs

2026-04-23 17:32:26 -05:00
parent 0456c51291
commit 3429dac894
51 changed files with 6703 additions and 155 deletions
@@ -0,0 +1,69 @@
+# 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).