Skip to content

jeremyknows/PRISM

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

11 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PRISM v3 ๐Ÿ”ฎ

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.

What It Does

  • ๐Ÿ”’ 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

The Core Insights

"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.

What's New in v3

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

What's New in v2

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)

Install

Claude Code

git clone https://github.com/jeremyknows/PRISM.git ~/.claude/skills/prism

Other Agents (Cursor, Windsurf, Cowork, etc.)

git clone https://github.com/jeremyknows/PRISM.git
# Reference SKILL.md from your agent's configuration

Usage

Just 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

Options

  • --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)

Examples

"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"

How It Works

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.

Reviewers

Standard Mode (6 specialists)

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?"

Wiki Mode (3 specialists)

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?"

Budget Mode

Security Auditor + Performance Analyst + Devil's Advocate. Security is MANDATORY.

Extended Mode

Standard 6 + Code Reviewers (batched by area) + Verification Auditor.

Evidence Hierarchy

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 Scale

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

Anti-Patterns

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

Troubleshooting

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

Dependencies

Dependency Required?
Parallel agent spawn Required
Archive directory (analysis/prism/<slug>/) Required โ€” created automatically
qmd search tool Optional โ€” improves context precision

License

MIT โ€” See LICENSE.txt


"The specialists optimize. The Devil protects you from yourself. The archive remembers what you forgot."

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors