prism-forge
v2.0.5
Published
Deterministic persona routing for AI coding assistants. Many minds. No menu.
Maintainers
Readme
PRISM Forge is a deterministic persona routing system for Claude Code. It installs 23 expert personas that activate automatically based on what you say -- no slash commands, no manual switching. Write naturally and the right expert responds.
Why PRISM Forge?
The problem: AI coding assistants default to one voice. You manually switch between "be a code reviewer" and "be an architect" prompts. Context is lost between switches. You spend more time managing the AI than doing the work.
The solution: PRISM Forge installs a signal-based routing engine that reads your intent from every message and activates the right persona automatically. Say "I'm stuck on this bug" and a hypothesis-driven problem solver activates. Say "let's plan the sprint" and a scrum master + product manager activate together. No configuration required.
- 23 expert personas covering analysis, architecture, development, QA, design, strategy, and more
- Zero-config activation -- install once, works immediately in every Claude Code session
- Signal-based routing -- personas activate based on what you say, not what you ask for
- Dynamic orchestration -- Susie (Chief of Staff) assembles the right persona team per context
- Works with any Claude Code project -- no per-project setup needed
Quick Start
npx prism-forge installThat's it. Start a new Claude Code session and PRISM Forge is active.
Verify your installation:
npx prism-forge verifyClean removal:
npx prism-forge uninstallHow It Works
A single beam of light enters a prism and splits into a spectrum of expert perspectives. PRISM Forge does this automatically on every turn of your conversation.
The routing flow:
- You send a message
- Susie (the dynamic orchestrator) evaluates your intent
- She classifies the domain and detects signal phrases
- She assembles a persona team -- a primary expert plus relevant supporting perspectives
- The response comes through the activated persona's lens
Examples:
You: "I'm stuck on this auth bug -- tokens keep expiring early"
Dr. Quinn (Creative Problem Solver) activates -- hypothesis-driven debugging, root cause analysis, structured problem-solving.
You: "Let's plan the next sprint"
Bob (Scrum Master) + John (Product Manager) activate together -- John challenges scope and business value first, then Bob structures the tasks.
You: "Simplify this -- too many abstractions"
Jobs (Combinatorial Genius) + Musk (Radical Reductionist) activate -- ruthless reduction from two angles: combinatorial synthesis and first-principles engineering.
Shared signals activate multiple personas simultaneously. The word "refactor" activates Amelia (Developer Agent) + Jobs (Combinatorial Genius) + Musk (Radical Reductionist) together. The word "audit" brings Mary (Business Analyst) + Quinn (QA Engineer) + Boris (Type System Auditor).
War room: Say "war room" and ALL personas activate for full-team analysis. Susie moderates the discussion, surfaces disagreements, and ensures every relevant perspective is heard.
For deeper technical details, see the Architecture Guide.
Runtime enforcement (v2.0+)
prism v2.0 ships hooks that enforce persona routing at runtime. On install, three hooks are added to ~/.claude/hooks/ and registered in ~/.claude/settings.json:
| Hook | Event | Purpose |
|------|-------|---------|
| prism_session_start.sh | SessionStart | Inject Turn 1 routing contract |
| prism_inject_routing.sh | UserPromptSubmit | Activate persona based on signals (war room, names, intent keywords) |
| prism_check_attribution.py | Stop | Log drift events to ~/.claude/hooks/prism_routing_events.jsonl |
Drift telemetry
Measure attribution rate before and after install:
npx prism-forge drift --since=7
# or JSON output for scripts:
npx prism-forge drift --since=7 --jsonTarget: less than 20% drift on substantive turns (turns longer than 200 chars or containing recommendations / options / judgment calls).
What Gets Installed
npx prism-forge install writes files to ~/.claude/rules/prism/ and injects a delimited block into ~/.claude/CLAUDE.md:
- 23 persona files -- markdown configuration for each expert
- Routing engine -- Susie's orchestration manual for signal-based team assembly
- Audit checklist -- structural integrity validator
- Create-persona skill -- template and guide for creating custom personas
- Manifest --
prism-manifest.jsontracking installed files for clean uninstall
All files are markdown configuration -- no executable code runs after installation. The CLAUDE.md block is delimited with <!-- PRISM:START --> / <!-- PRISM:END --> markers for clean removal via npx prism-forge uninstall.
During upgrades, user-modified files are backed up to .prism-backup/ before overwriting. The installer also reads ~/.claude/rules/personas/ (read-only) to detect existing non-PRISM persona files and notify you.
Personas
Core Personas
Activate on first relevant signal -- no manual invocation needed:
| Name | Role | |------|------| | Mary | Business Analyst | | Amelia | Developer Agent | | Bob | Scrum Master | | Quinn | QA Engineer |
Dynamic Orchestrator
| Name | Role | |------|------| | Susie | Chief of Staff / Dynamic Orchestrator |
Specialists
Activate on signal -- loaded on-demand by Susie when needed:
| Name | Role | |------|------| | Winston | Architect | | John | Product Manager | | Paige | Technical Writer | | Carson | Brainstorming Coach | | Dr. Quinn | Creative Problem Solver | | Maya | Design Thinking Coach | | Victor | Innovation Strategist | | Spike | Presentation Master | | Sophia | Storyteller | | Sally | UX Designer | | Leonardo | Renaissance Polymath | | Dali | Surrealist Provocateur | | de Bono | Lateral Thinker | | Campbell | Mythic Storyteller | | Jobs | Combinatorial Genius | | Barry | Quick Flow Solo Dev | | Boris | Type System Auditor | | Musk | Radical Reductionist |
Documentation
- Architecture Guide -- How the routing engine and persona system work
- Signal Reference -- Complete signal tables and routing behavior
- Customization Guide -- Creating your own personas
- Contributing -- How to contribute personas and code
- Changelog -- Version history
Community and Support
- GitHub Issues -- Bug reports and feature requests
- GitHub Discussions -- Questions and community conversation
- Bluesky -- Follow for updates and dev community discussion
- Twitter/X -- Threads and announcements
- LinkedIn -- Professional updates from the creator
Contributing
PRISM Forge welcomes contributions -- especially new personas that fill domain gaps in the routing engine. If you see a work type that currently falls through to a mode default, that's an opportunity for a new expert perspective. See CONTRIBUTING.md for the full contribution guide, including the persona creation process and PR checklist.
License
MIT License -- see LICENSE for details.
Copyright (c) 2025 BMad Code, LLC / Copyright (c) 2026 Anthony Hipp
Credits
PRISM Forge is derived from BMAD-METHOD, originally created by BMad Code, LLC and licensed under the MIT License. PRISM Forge is an independent project -- not affiliated with, endorsed by, or sponsored by BMad Code, LLC.
"BMad", "BMad Method", and "BMad Core" are trademarks of BMad Code, LLC. PRISM Forge does not use these trademarks in its name, branding, or marketing.
