Manages the Multi-Persona Chat System (MPCS) lifecycle in Cowork
Five modes: INITIALIZE creates the persona session with state tracking, ROUTE dispatches tasks to the appropriate persona sub-agent, HANDOFF preserves state for session boundaries, RESUME restores context in a new session, and QUERY displays current status. Merges six former Studio recipes into a single orchestrator where the AI serves as the message bus via Task tool sub-agents.
Cowork MPCS Orchestrator
TL;DR
How To Start
STEP 1Choose Mode
-
mode
· string · required
Orchestrator operational mode: “INITIALIZE”, “ROUTE”, “HANDOFF”, “RESUME”, or “QUERY”. -
project_name
· string · required for INITIALIZE
Name of the project or initiative being worked on. -
content_type
· string · required for INITIALIZE
Type of content being produced: “recipe”, “documentation”, “persona”, “cookbook”, “specification”, “template”, or “other”. -
content_name
· string · required for INITIALIZE
Human-readable name for the deliverable. -
requirements
· string · required for INITIALIZE
Detailed creation requirements for the Creator persona (Auguste). -
task_type
· string · required for ROUTE
What kind of persona task to route: “CV_WORKFLOW” (delegates to CWK-030), “GENERAL_CREATION” (Auguste via CWK-008), “GENERAL_VALIDATION” (Fernand via CWK-008), or “CUSTOM” (any persona). -
target_persona
· string · optional · default: auto
Which persona to activate: “Auguste”, “Fernand”, “Alice”, “Julia”, or “auto” (selects based on task type). -
task_description
· string · required for GENERAL/CUSTOM
What the persona should do. Required for non-CV_WORKFLOW task types. -
state_file
· string · optional · default: .mpcs-state.json
Path to the MPCS state file. Used by RESUME if the file is in a non-default location. -
git_checkpoint
· boolean · optional · default: true
Call CWK-005 after state-changing operations for crash protection. -
tier
· string · optional · default: E
Persona expertise tier: B (beginner), A (advanced), E (expert). -
research_files
· list · optional · default: []
Paths to reference files for the Creator persona. -
specification_files
· list · optional · default: []
Paths to specs and constraints for the Validator persona.
Usage Examples
EXAMPLE 1Initializing and routing a documentation project
EXAMPLE 2Resuming across session boundary
EXAMPLE 3Querying status mid-session
How AI Reads This Recipe
- Dispatch (Step 0). Read mode parameter and branch. All modes except INITIALIZE require .mpcs-state.json to exist — error if missing.
- Initialize (Step 1). Validate required parameters. Create .mpcs-state.json with persona assignments (Auguste as Creator, Fernand as Validator at the specified tier), version tracking, embedded Q&A queues, and reference file lists. Optional git checkpoint. Recommend ROUTE with CV_WORKFLOW as next step.
- Route (Step 2). Load state. Validate task_type. Auto-select persona if not specified. Dispatch: CV_WORKFLOW executes CWK-030, GENERAL tasks execute CWK-008 with the target persona, CUSTOM executes CWK-008 with any specified persona. Update state with cycle count, version history, and latest author.
- Handoff (Step 3). Load state. Create handoff snapshot with current state, project info, and resume instructions. The .mpcs-state.json file persists in the workspace across session boundaries.
- Resume (Step 4). Load state from file. Validate integrity. Display restored context with version history and pending Q&A. Determine recommended action based on status (INITIALIZED → start creation, ROUTED → continue, REVISION_NEEDED → revise, PASSED → complete).
- Query (Step 5). Load state. Display full snapshot: project info, cycle count, status, complete version history, file locations, and pending Q&A.
When To Use This Recipe
Recipe FAQ
What is the difference between CWK-031 and CWK-030?
What personas are available?
How does state persist across sessions?
What is the embedded Q&A system?
When should I use HANDOFF vs just ending the session?
Can I route to multiple personas in parallel?
Version History
Get this recipe with CRAFT for Claude Cowork
Cowork recipes ship bundled with CRAFT for Claude Cowork — there’s no separate download. Clone the framework once, and your AI runs every recipe automatically when invoked.
Pull anytime to stay on the latest version — free to clone, no login or email required.
Then start your session
Once CRAFT is in your project folder, open a new Cowork session and ask Claude to initialize. For example:
You
Claude
Not familiar with Git? Download as a ZIP
No command line needed. Just download, move, and unzip:
- Open the CRAFT framework repo on GitHub.
- Click the green Code button, then choose Download ZIP.
- Move the downloaded ZIP into your Claude Cowork project folder.
- Unzip it: double-click on Mac, or right-click → Extract All on Windows.
