Parallel Review by Independent Specialist Models
Multi-agent review protocol that eliminates confirmation bias through structured adversarial analysis. v3 adds wiki mode and creative mode โ a 5-role path for brand and motion direction reviews with Brand Creative Memory โ a targeted 3-reviewer path for documentation accuracy. v2 added memory โ the system learns from its own review history.
- ๐ Deploys 6 specialist reviewers in parallel (Security, Performance, Simplicity, Integration, Blast Radius, Devil's Advocate)
- ๐ง Remembers โ searches for prior reviews on the same topic, tracks what was fixed
- ๐ Wiki Mode โ dedicated 3-reviewer path for documentation accuracy, completeness, and framing
- ๐ฏ Surfaces disagreements as the most valuable signal
- ๐ Devil's Advocate reviews blind โ no prior findings, guaranteed independence
- ๐ Requires evidence โ every finding must cite a specific file, line, or command output
- ๐ง Findings include shell commands or file paths โ actionable, not just advisory
- โก Works with parallel subagents OR sequential single-agent review
"Disagreements are MORE valuable than consensus."
When 4/5 reviewers agree and 1 dissents, pay attention to that dissent.
"Findings without evidence are noise."
Every finding must cite a specific file. Assertions without citations are lowest priority.
"A finding flagged 3 times tells you about governance, not about the code."
PRISM tracks how many times a finding appears โ repeat findings escalate automatically.
| Feature | v2 | v3 |
|---|---|---|
| Wiki support | Standard mode only | Wiki Mode โ dedicated 3-reviewer path (Accuracy, Completeness, DA) |
| Reviewer count | 5 specialists | 6 specialists โ adds Blast Radius Reviewer |
| Blast Radius | Folded into Integration | Dedicated reviewer โ catches cross-system coupling, stale references |
| Install path | ~/.openclaw/skills/ |
~/.claude/skills/ (Claude Code native) |
| Autoresearch data | In SKILL.md | Moved to references/openclaw.md |
| Feature | v1 | v2 |
|---|---|---|
| Prior review awareness | None | Searches for prior reviews, injects open findings |
| Devil's Advocate | Receives same context as others | Structurally blind to prior findings |
| Evidence requirement | Optional | Mandatory โ cite files or it's deprioritized |
| Verdict scale | APPROVE / AWC / REJECT | + NEEDS WORK (fixable but not shippable) |
| Findings format | General observations | Must include specific fix (command or file path) |
| Synthesis | Flat list of findings | Evidence hierarchy (Tier 1/2/3) + Limitations section |
| History | No archive | Searchable archive in analysis/prism/<slug>/ |
| Governance | Manual tracking | --governance flag for Stuck Findings |
| Verification | Trust claims | Verification Auditor role (Extended mode) |
git clone https://github.com/jeremyknows/PRISM.git ~/.claude/skills/prismgit clone https://github.com/jeremyknows/PRISM.git
# Reference SKILL.md from your agent's configurationJust say it โ no configuration needed:
| Mode | Say This | Agents | Est. Cost |
|---|---|---|---|
| Wiki | "PRISM this wiki" / "wiki PRISM" | 3 specialists (Accuracy, Completeness, DA) | ~$0.40โ0.80 |
| Budget | "Budget PRISM" / "PRISM lite" | 3 specialists (Security, Performance, DA) | ~$0.40โ0.80 |
| Standard | "Run PRISM" / "PRISM review" | 6 specialists | ~$0.80โ1.50 |
| Extended | "Full PRISM audit" / "Deep audit" | 8+ agents | ~$2.00โ4.00 |
| Creative | "creative PRISM" / "PRISM this creative" | 5 specialists (Brand, Motion, Technical, Delight, Provocateur) | ~$0.80โ1.60 |
--opusโ Use Opus model (critical decisions, ~2-3x cost)--haikuโ Use Haiku model (fast sanity checks)--governanceโ Surface Stuck Findings (flagged 3+ times without resolution)
"PRISM this wiki article"
"wiki PRISM on satori-og-edge.md"
"PRISM this API change"
"Budget PRISM on the auth flow"
"Full PRISM audit --governance โ we've reviewed this area before"
"creative PRISM on the hero animation brief"
"brand review PRISM โ veefriends launch video"
1. You say "PRISM this"
2. Orchestrator derives topic slug (e.g., api-authentication-redesign)
3. Searches for prior PRISM reviews on that topic (exact + semantic)
4. Spawns Devil's Advocate immediately (blind โ no prior findings)
5. Compiles Prior Findings Brief for remaining reviewers
6. Spawns all other reviewers in parallel with brief
7. Each reviewer reads files, cites evidence, proposes specific fixes
8. Orchestrator synthesizes: Tier 1 (cross-validated) โ Tier 2 (cited) โ Tier 3 (uncited)
9. Archives the synthesis for future reviews
First run: No prior findings exist. PRISM runs cleanly โ no empty sections, no confusion.
Subsequent runs: Prior findings are injected. Reviewers verify what's fixed and hunt for what's new. DA stays blind โ their independence is the control group.
| Reviewer | Focus | Key Question |
|---|---|---|
| ๐ Security Auditor | Attack vectors, trust boundaries | "How could this be exploited?" |
| โก Performance Analyst | Metrics, benchmarks, overhead | "Show me the numbers" |
| ๐ฏ Simplicity Advocate | Complexity reduction | "What can we remove?" |
| ๐ง Integration Engineer | Compatibility, migration | "How does this fit?" |
| ๐ฅ Blast Radius Reviewer | Downstream effects on other systems | "What breaks elsewhere?" |
| ๐ Devil's Advocate | Assumptions, risks, regrets | "What are we missing?" |
| Reviewer | Focus | Key Question |
|---|---|---|
| โ Technical Accuracy | Are the facts right? | "What's the evidence for this claim?" |
| ๐ Completeness | What's missing? | "What would a developer wish was here?" |
| ๐ Devil's Advocate | Assumptions and framing | "What will readers get wrong?" |
Security Auditor + Performance Analyst + Devil's Advocate. Security is MANDATORY.
Standard 6 + Code Reviewers (batched by area) + Verification Auditor.
| Tier | Definition | Action |
|---|---|---|
| Tier 1 | 2+ reviewers found independently, citing different files | Act immediately |
| Tier 2 | Single reviewer, specific file/line citation | High confidence |
| Tier 3 | Single reviewer, no citation | Verify before acting |
| Verdict | Meaning |
|---|---|
| APPROVE | Clean โ no issues, prior issues resolved |
| APPROVE WITH CONDITIONS | New issues found, none critical |
| NEEDS WORK | Fixable but not shippable โ prior criticals still open, or significant new issues |
| REJECT | Fundamental problems โ requires rethink |
Don't:
- โ Let reviewers see each other's findings (groupthink)
- โ Give Devil's Advocate the Prior Findings Brief (breaks independence)
- โ Accept findings without file citations (noise)
- โ Skip synthesis (raw findings aren't actionable)
- โ Skip archiving (breaks memory for future reviews)
Do:
- โ Spawn DA immediately, other reviewers after brief is ready
- โ Give each reviewer narrow focus (depth > breadth)
- โ Require citations in every finding
- โ
Archive every synthesis to
analysis/prism/<slug>/ - โ Run two rounds for important decisions
| Problem | Cause | Fix |
|---|---|---|
| All reviewers find same issues | Roles not distinct enough | Sharpen role prompts |
| >100 issues found | Scope too broad | Narrow the review target |
| Vague findings | Missing evidence requirement | Enforce citation rules |
| DA has no concerns | Topic too simple or DA too soft | Re-run: "find something wrong" |
| Same finding appears 3+ times | Governance gap | Enable --governance |
| Security times out | Deep file reads take longer | Increase timeout or run Security solo first |
| Dependency | Required? |
|---|---|
| Parallel agent spawn | Required |
Archive directory (analysis/prism/<slug>/) |
Required โ created automatically |
qmd search tool |
Optional โ improves context precision |
MIT โ See LICENSE.txt
"The specialists optimize. The Devil protects you from yourself. The archive remembers what you forgot."