no revealing # of traitors

.gitignore

@@ -1,2 +1,9 @@
 workspace/
 inbox/
+runtime/
+results/
+package-lock.json
+node_modules
+*.pyc
+__pycache__
+.DS_Store

PlanPyminimalist.md

@@ -0,0 +1,245 @@
+# Plan: pyminimalist
+
+## Context
+
+`minimalist/` runs a round-robin council of 3 AI personas (architect → implementer → reviewer) working on a shared task. But it cheats: the TypeScript script does ALL the orchestration — building prompts, managing turn order, parsing `@mentions` and `DONE` tokens from stdout, routing messages to inbox JSONL files — and `opencode run` is just a thin subprocess wrapper, equivalent to `curl https://api.anthropic.com/v1/messages`.
+
+The goal is to invert this: **opencode's native agent system** should do the orchestration. Python should just define the topology and kick things off.
+
+## What opencode's agent system actually is
+
+From the `opencode.ai/config.json` schema, the opencode CLI (`opencode agent list`), and the `oh-my-openagent` plugin config:
+
+- **`opencode.json`** at project root has an **`agent`** field — an object mapping agent names to `AgentConfig` objects
+- Each `AgentConfig` has:
+  - `mode`: `"primary"` | `"subagent"` | `"all"` — controls who can spawn whom
+  - `description`: when to use this agent (used by the `Agent` tool to decide routing)
+  - `prompt`: system prompt override — **this is where the persona lives**
+  - `model`: provider/model string
+  - `permission`: scoped tool permissions per agent
+  - `steps`: max agentic iterations
+- **Primary agents** can spawn **subagents** via the `Agent` tool — that's the delegation topology
+- `default_agent` in opencode.json sets which primary agent `opencode run` invokes by default
+- `opencode run --agent <name>` invokes a specific agent
+
+There is no "CLAUDE.md" mechanism — that's a Claude Code concept. In opencode, agent personas are defined inline in `opencode.json` via the `prompt` and `description` fields.
+
+## Architecture shift
+
+| Concern | TypeScript `minimalist/` | Python `pyminimalist/` |
+|---|---|---|
+| Orchestration | `run.ts` round-robin loop | opencode primary agent using `Agent` tool |
+| Persona definitions | `personas/*.md` files, assembled by TS | `prompt` field on each agent in `opencode.json` |
+| Turn order | Hardcoded `["architect","implementer","reviewer"]` array | Encoded in orchestrator's `prompt` instructions |
+| Message routing | TS `parseMessages()` regex → inbox JSONL files | `Agent` tool delegates with context; HANDOFF.md for artifact handoff |
+| LLM invocation | `spawn("opencode", ["run", ...])` per turn (~15 subprocesses) | Single `opencode run` call; agent delegates internally |
+| Termination | TS regex-checks for `FINAL` in stdout | Orchestrator reads reviewer output, decides to continue or stop |
+
+## Directory structure
+
+```
+pyminimalist/
+├── opencode.json           # Agent definitions (orchestrator + 3 subagents), permissions, model
+├── personas/
+│   ├── architect.md        # Architect persona text
+│   ├── implementer.md      # Implementer persona text
+│   └── reviewer.md         # Reviewer persona text
+├── brief.md                # Task brief (copied from minimalist/)
+├── run.py                  # ~60 lines: assemble opencode.json, setup workspace, kick off
+├── workspace/              # Created at runtime — HANDOFF.md lives here
+├── pyproject.toml          # Python project metadata
+└── README.md               # How to run, architecture overview
+```
+
+## How it works end-to-end
+
+### 1. Python setup script (`run.py`)
+
+The Python script does three things:
+
+1. **Reads persona files** from `personas/*.md` and assembles them into `opencode.json`'s `agent` config, with each persona text embedded in the agent's `prompt` field
+2. **Creates `workspace/`** and copies the task brief
+3. **Launches the orchestrator**: `opencode run --agent orchestrator "Read brief.md, then begin round 1 with the architect. Work until the reviewer approves with FINAL, or max 6 rounds."`
+
+That's it. No subprocess management, no regex parsing, no message routing code. The Python is thin glue — maybe 60 lines.
+
+### 2. `opencode.json` — project config with agent definitions
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "opencode-go/kimi-k2.6",
+  "default_agent": "orchestrator",
+  "tools": {
+    "question": false
+  },
+  "agent": {
+    "orchestrator": {
+      "mode": "primary",
+      "description": "Round-robin coordinator. Delegates to architect, implementer, reviewer in order each round. Reads brief.md, manages workspace/HANDOFF.md between agents. Stops when reviewer signals FINAL or max 6 rounds reached.",
+      "prompt": "<assembled from orchestrator.md persona file>",
+      "permission": { "read": "allow", "edit": "allow", "write": "allow", "bash": "allow", "agent": "allow" }
+    },
+    "architect": {
+      "mode": "subagent",
+      "description": "Software architect. Called first each round. Reads the previous HANDOFF.md and the brief, then writes an architecture plan.",
+      "prompt": "<assembled from personas/architect.md>",
+      "permission": { "read": "allow", "edit": "allow", "write": "allow" }
+    },
+    "implementer": {
+      "mode": "subagent",
+      "description": "Software engineer. Called second each round. Reads the architect's plan from HANDOFF.md, writes the implementation, updates HANDOFF.md.",
+      "prompt": "<assembled from personas/implementer.md>",
+      "permission": { "read": "allow", "edit": "allow", "write": "allow" }
+    },
+    "reviewer": {
+      "mode": "subagent",
+      "description": "Code reviewer. Called third each round. Reads HANDOFF.md and the brief, reviews the implementation, writes review. Signals FINAL if all requirements are met.",
+      "prompt": "<assembled from personas/reviewer.md>",
+      "permission": { "read": "allow", "edit": "allow", "write": "allow" }
+    }
+  }
+}
+```
+
+### 3. Agent personas (`personas/*.md`)
+
+The same persona content as `minimalist/personas/*.md`, but Python reads them at setup time and embeds them into each agent's `prompt` field in `opencode.json`. Separating persona text from config keeps things maintainable.
+
+### 4. Orchestrator behavior
+
+The orchestrator's `prompt` instructs it to:
+
+1. Read `brief.md` for the task description
+2. For each round (1 to 6):
+   a. Delegate to `architect`: provide the current HANDOFF.md content and brief; architect writes plan to HANDOFF.md
+   b. Delegate to `implementer`: provide architect's HANDOFF.md; implementer writes code and updates HANDOFF.md
+   c. Delegate to `reviewer`: provide HANDOFF.md and brief; reviewer checks work and writes review to HANDOFF.md
+   d. Read HANDOFF.md — if it says the work is complete (FINAL), stop. Otherwise continue to next round.
+3. Report the final outcome
+
+The orchestrator uses the `Agent` tool for each delegation, passing the current state as the task description.
+
+### 5. Agent handoff mechanism
+
+Unlike the TypeScript version where HANDOFF.md is the primary coordination channel (each agent reads and overwrites it), in the opencode version the coordination is **dual-channel**:
+
+- **Context passing via orchestrator**: The orchestrator reads HANDOFF.md after each agent and passes the relevant content to the next agent in its delegation prompt. This is the primary channel.
+- **File-based artifacts**: Agents still write to `workspace/HANDOFF.md` (and `workspace/calculator.html`) as persistent artifacts. This ensures work survives across agent invocations.
+
+## Key differences from the CLAUDE.md mistake in v1 of this plan
+
+| Wrong (v1) | Correct (v2) |
+|---|---|
+| Assumed CLAUDE.md files define agent personas | Agent personas are defined via `prompt` field in `opencode.json`'s `agent` config |
+| Assumed opencode reads CLAUDE.md natively | opencode's config schema has no concept of CLAUDE.md — that's Claude Code |
+| Assumed `opencode agent create` writes config files | It calls an LLM to auto-generate config; persona files should be hand-written |
+
+## Implementation steps
+
+### Step 1: Create feature branch and directory
+
+```bash
+git checkout -b pyminimalist
+mkdir -p pyminimalist/{personas,workspace}
+```
+
+### Step 2: Copy/adapt persona files
+
+Copy `minimalist/personas/*.md` to `pyminimalist/personas/`. Adjust language slightly — in the TypeScript version, agents are told "read workspace/HANDOFF.md." In the opencode version, context comes from the orchestrator's delegation prompt, so agents should be told "you will be given the current state in your task description."
+
+### Step 3: Write orchestrator persona
+
+Create `pyminimalist/personas/orchestrator.md` with the round-robin algorithm, delegation instructions, and termination logic.
+
+### Step 4: Write `run.py`
+
+```python
+#!/usr/bin/env python3
+"""Setup pyminimalist topology and kick off the orchestrator."""
+
+import json, os, shutil, subprocess, sys
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent
+WORKSPACE = ROOT / "workspace"
+
+AGENTS = {
+    "orchestrator": {"mode": "primary", "tools": "read,edit,write,bash"},
+    "architect":    {"mode": "subagent", "tools": "read,edit,write"},
+    "implementer":  {"mode": "subagent", "tools": "read,edit,write"},
+    "reviewer":     {"mode": "subagent", "tools": "read,edit,write"},
+}
+
+def main():
+    # 1. Assemble opencode.json
+    agents_cfg = {}
+    for name, cfg in AGENTS.items():
+        persona_path = ROOT / "personas" / f"{name}.md"
+        persona_text = persona_path.read_text() if persona_path.exists() else ""
+        agents_cfg[name] = {
+            "mode": cfg["mode"],
+            "description": f"{name} agent for the round-robin dev team",
+            "prompt": persona_text,
+            "permission": {t: "allow" for t in cfg["tools"].split(",")},
+        }
+
+    config = {
+        "$schema": "https://opencode.ai/config.json",
+        "model": os.environ.get("ORG_BENCH_MODEL", "opencode-go/kimi-k2.6"),
+        "default_agent": "orchestrator",
+        "tools": {"question": False},
+        "agent": agents_cfg,
+    }
+    (ROOT / "opencode.json").write_text(json.dumps(config, indent=2))
+
+    # 2. Prep workspace
+    WORKSPACE.mkdir(exist_ok=True)
+    (WORKSPACE / "HANDOFF.md").write_text("")  # clear previous
+
+    # 3. Kick off orchestrator
+    subprocess.run([
+        "opencode", "run",
+        "--agent", "orchestrator",
+        "--dangerously-skip-permissions",
+        "Read brief.md, then begin round 1 with the architect. "
+        "Work through architect → implementer → reviewer each round. "
+        "Stop when the reviewer signals FINAL, or after 6 rounds max."
+    ], cwd=ROOT, check=True)
+
+if __name__ == "__main__":
+    main()
+```
+
+### Step 5: Copy `brief.md`
+
+Copy `minimalist/brief.md` verbatim (build a calculator web app).
+
+### Step 6: Write `README.md` and `.gitignore`
+
+Document usage, architecture, and customization. Ignore `workspace/`.
+
+### Step 7: Test
+
+Run from the `pyminimalist/` directory and verify:
+- `opencode.json` is generated correctly
+- The orchestrator spawns subagents in order
+- `workspace/calculator.html` is produced
+- The output matches the same quality as `minimalist/`
+
+## Verification
+
+1. `python3 run.py` from `pyminimalist/` — should generate `opencode.json` and kick off the orchestrator
+2. Check `workspace/calculator.html` exists and contains valid HTML/CSS/JS
+3. Compare against a `minimalist/` run with the same model — quality should be similar or better (since the orchestrator can iterate more intelligently)
+4. Check that opencode's agent delegation is visible in the session log
+
+## Open questions / risks
+
+1. **How exactly does the `Agent` tool work in opencode?** The schema shows agents can spawn subagents, but the exact mechanics (does the orchestrator get the subagent's full output? does it see tool calls?) need to be verified with a test run. The plan accounts for this by keeping things simple — the orchestrator reads file artifacts after each delegation.
+
+2. **Does `opencode.json` agent config get picked up automatically?** Based on the schema, yes — agents defined under the `agent` key should be available to `opencode run` in that directory.
+
+3. **Model choice**: Defaults to `opencode-go/kimi-k2.6` (same as minimalist). Overridable via `ORG_BENCH_MODEL` env var.
+
+4. **No `opencode agent create` needed**: The Python script writes `opencode.json` directly rather than calling `opencode agent create` (which uses an LLM to generate config and can fail). Direct file writing is deterministic and faster.

README.md

@@ -1,5 +1,27 @@
 # opencode-organizations
 
-This repo demostrates/implements organizational structures
+This repo demonstrates and implements organizational structures
 with opencode agents, to demonstrate non-trivial workflows
 and AI team co-ordination.
+
+## Examples
+
+### `minimalist/` — Cooperative Software Team
+
+A barebones 3-person AI team (architect, implementer, reviewer) that collaboratively builds a calculator web app. Demonstrates round-robin turn-taking, shared workspace handoffs, and `@mention` side messaging.
+
+**Key properties:** cooperative goals, shared information, sequential coordination.
+
+### `traitors/` — Adversarial Social Deduction Game
+
+A 10-player hidden-role game of Traitors (similar to Werewolf/Mafia), played entirely by AI agents. 3 Traitors secretly deceive 7 Citizens, who must identify and vote them out before being murdered at night.
+
+**Key properties:** hidden information, adversarial goals, social reasoning, memory over time, and sandboxed coordination to prevent accidental information leaks.
+
+Each player is a unique persona with friendships, grudges, and distinct decision-making styles — making every game different.
+
+> ⚠️ **Cost warning:** A full Traitors game invokes 60–180 model calls and can cost $8–$30 in API fees. Run intentionally.
+
+## Running
+
+See the README in each example directory for setup and run instructions.

minimalist/UserGuide.md

@@ -51,16 +51,16 @@ The orchestrator (`run.ts`) runs a round-robin loop across all personas:
 ```bash
 cd minimalist
 npm install
-ORG_BENCH_MODEL=anthropic/claude-sonnet-4-6 npm run run
+ORG_BENCH_MODEL=opencode-go/kimi-k2.6 npm run run
 ```
 
-Set `ORG_BENCH_MODEL` to any model opencode supports (defaults to `anthropic/claude-sonnet-4-6`).
+Set `ORG_BENCH_MODEL` to any OpenCode Go model (defaults to `opencode-go/kimi-k2.6`).
 
 ## Adapting it
 
 - **Different personas**: Replace the `.md` files in `personas/` and update `PERSONA_ORDER` in `run.ts`.
 - **Different task**: Replace `brief.md` with your own task description.
-- **Different model**: Set `ORG_BENCH_MODEL` env var, or change the default in `run.ts`.
+- **Different model**: Set `ORG_BENCH_MODEL` env var, or change the default in `run.ts`. OpenCode Go models use the `opencode-go/` prefix.
 - **Different LLM CLI**: Swap the `spawn("opencode", ...)` call in `runAgent()` to any CLI that takes a prompt and returns text on stdout.
 - **Different topology**: Change `PERSONA_ORDER` to control turn order. To allow parallel turns within a round, add a `Promise.all` over a subset of personas.
 - **Message format**: Agents send side-channel messages by writing `@<name>` on its own line in their output, followed by the message body. The orchestrator parses these and delivers them to inbox JSONL files.

minimalist/run.ts

@@ -15,7 +15,7 @@ const INBOX_DIR = path.join(ROOT, "inbox");
 const HANDOFF = path.join(WORKSPACE, "HANDOFF.md");
 
 const MODEL =
-  process.env.ORG_BENCH_MODEL || "anthropic/claude-sonnet-4-6";
+  process.env.ORG_BENCH_MODEL || "opencode-go/kimi-k2.6";
 
 // -- helpers --
 async function readIfExists(p: string): Promise<string> {

traitors/README.md

@@ -0,0 +1,227 @@
+# Traitors
+
+A 15-player social deduction game played entirely by AI agents, built on the `opencode` platform.
+
+## What Is This?
+
+**Traitors** is a hidden-role game similar to Werewolf or Mafia. Among 15 players, some are secretly **Traitors** and the rest are **Citizens**. The Citizens must identify and vote out all Traitors. The Traitors must deceive the Citizens and secretly murder them at night until the Traitors equal or outnumber the Citizens.
+
+Each player is a distinct AI persona with a unique personality, relationships, friendships, and grudges. They speak, argue, accuse, defend, vote, and conspire - all through LLM-powered agents.
+
+## Why This Is Interesting for AI
+
+Most AI demos show **cooperative** agents working toward a shared goal. Traitors flips that script:
+
+- **Hidden information:** No player knows the roles of others. They must infer intent from behavior, speech patterns, and voting history.
+- **Adversarial goals:** Traitors actively deceive while Citizens try to detect lies. This creates genuine strategic tension.
+- **Social reasoning:** Players must track alliances, accusations, and contradictions across multiple days of discussion.
+- **Memory and consistency:** Players have personal histories and relationships that influence their decisions. A player who befriended someone on Day 1 may struggle to vote against them on Day 5, even if evidence suggests they are a Traitor.
+- **Sandboxed coordination:** Each agent runs in an isolated temporary directory to prevent accidental information leaks - critical when real API tokens are on the line.
+
+## Game Structure
+
+Each **day** follows this structure:
+
+1. **Morning Narration** - The narrator dramatically recaps who was murdered overnight and sets the tone. (Skipped on Day 1.)
+2. **Day Round Table** - Living players speak in random order. They can accuse, defend, share theories, or question others. All speeches are public.
+3. **Day Voting** - Each living player votes to eliminate one other living player. Simple plurality wins; ties broken randomly.
+4. **Eulogy** - A randomly-selected living player delivers a brief eulogy for the banished, reacting to the role reveal.
+5. **Win Check** - If all Traitors are dead, Citizens win. If Traitors ≥ Citizens, Traitors win.
+6. **Night Round Table** - Living Traitors secretly discuss strategy and choose a victim.
+7. **Night Murder Vote** - Traitors vote on which non-Traitor to murder. Plurality wins; ties broken randomly.
+8. **Win Check** - Repeat until someone wins or max days reached.
+
+## The Cast
+
+| Player | Archetype |
+|--------|-----------|
+| **Sirius Crowley** | Pale, vampiric goth with a heart of gold. Loyal to fellow outsiders. |
+| **Dr. Elena Voss** | Sharp physician. Lineage traces to van Helsing. Part of "The Rationalists." |
+| **Marcus Thorne** | Retired RCMP officer from Yukon. Aggressively Canadian. Believes Montreal smoked meat beats Texas BBQ. |
+| **Juniper "June" Hale** | Bubbly barista who also runs a poetry slam, goat yoga studio, and unlicensed marriage counseling practice. 200+ houseplants named after exes. |
+| **Old Man Hemlock** | Conspiracy theorist, cryptic, occasionally right. Nobody remembers his first name. |
+| **Priya Sharma** | Structural engineer from Toronto. Tracks the humidity index daily. Says "sorry" the way other people say "you're wrong." |
+| **Tomás "Tommy" Ortiz** | Charming ex-con artist. Runs a mobile notary / unlicensed parking lot barbershop out of a 2003 Civic. Carries three phones, won't explain the third. |
+| **Greta Wulff** | Elderly librarian. Secretly a werewolf. |
+| **Darnell Brooks** | High school football coach and amateur storm chaser. Truck struck by lightning once (considers it a blessing). |
+| **Lacey Duval** | Chaotic influencer from Bay Ridge, Brooklyn. Moved to Austin because someone said it was "the new Brooklyn." Still furious. Chihuahua named Gabbagool. |
+| **Clementine Roux** | Retired burlesque dancer turned backyard chicken farmer. Sells eggs from a repurposed Airstream. Flirts with everyone. |
+| **Bowie Sanz** | Nonbinary sound artist. Lives in a converted school bus. Builds instruments from salvaged junk. Weirdly prophetic. |
+| **Dutch Pfeiffer** | Semi-retired competitive pitmaster. Three cookoff trophies, two ex-wives. Wakes at 3 AM to tend brisket. |
+| **Magnolia Jin** | Former tech founder turned tarot reader. Three cats named after failed cryptocurrencies (Luna, Terra, Celsius). |
+| **Randy Koontz** | Perpetually sunburned. "About to open a food truck" for six years. Linklater film extra. Golden retriever energy masking genuine loneliness. |
+
+### Relationship Web
+
+**Friendships:**
+- Sirius Crowley ↔ Juniper Hale (late-night coffee, "Siri")
+- Sirius Crowley ↔ Bowie Sanz (noise shows, dark ambient collabs)
+- Juniper Hale ↔ Clementine Roux (Tuesday eggs, lavender lattes, "sugar"/"Clem")
+- Tomás Ortiz ↔ Darnell Brooks (community service bond)
+- Tomás Ortiz ↔ Randy Koontz (Rainey Street drinking buddies)
+- Darnell Brooks ↔ Dutch Pfeiffer (team dinners, whole hog banquet)
+- Old Man Hemlock ↔ Greta Wulff (library regulars)
+- Old Man Hemlock ↔ Magnolia Jin (conspiracy-tarot crossover)
+
+**Triad:**
+- Dr. Elena Voss ↔ Priya Sharma ↔ Marcus Thorne ("The Rationalists")
+
+**Grudges:**
+- Marcus Thorne ↔ Lacey Duval (charity scam shutdown)
+- Marcus Thorne ↔ Bowie Sanz (bus code violations)
+- Priya Sharma ↔ Tomás Ortiz (can't let go of the past)
+- Priya Sharma ↔ Dutch Pfeiffer ("inefficient use of calories")
+- Darnell Brooks ↔ Old Man Hemlock (conspiracy theories vs. government stooge)
+- Clementine Roux ↔ Lacey Duval (chicken filming incident)
+- Magnolia Jin ↔ Dr. Elena Voss (pseudoscience op-ed / hex)
+- Randy Koontz ↔ Greta Wulff (the *Lonesome Dove* incident)
+
+**Background tension:**
+- Sirius Crowley ↔ Dr. Elena Voss (vampire aesthetic meets van Helsing lineage)
+- Sirius Crowley ↔ Greta Wulff (predator recognizing predator - vampire and werewolf)
+
+## How to Run
+
+Requires Python 3.11+ and the `opencode` CLI. No Python dependencies outside stdlib.
+
+### From any directory
+
+The traitors game writes all runtime artifacts to `games/` inside the **current working directory** (or `TRAITORS_WORK_DIR` if set). The tool code, personas, and config are read from the traitors installation directory.
+
+```bash
+# Run from a clean workspace
+cd ~/tmp
+python /path/to/traitors/run.py --name mygame
+
+# Or with explicit workspace
+TRAITORS_WORK_DIR=~/my-games python /path/to/traitors/run.py --name mygame
+```
+
+Each game gets its own directory: `games/{name}_{model}_{timestamp}/`.
+
+### Resuming a game
+
+If the game is interrupted (Ctrl-C, crash, timeout), it checkpoints automatically. On next run, if an unfinished game is detected you'll be prompted to resume.
+
+To explicitly resume a specific game:
+
+```bash
+python /path/to/traitors/run.py --resume mygame
+```
+
+The `--resume` value is matched as a substring against game directory names.
+
+### Environment variables
+
+| Variable | Purpose | Default |
+|----------|---------|---------|
+| `ORG_BENCH_MODEL` | Model to use | `opencode-go/deepseek-v4-flash` |
+| `TRAITORS_WORK_DIR` | Where runtime output goes | `process.cwd()` |
+| `TRAITORS_TIMEOUT_MS` | Per-turn timeout in milliseconds | `900000` (15 min) |
+| `TRAITORS_GAME_NAME` | Game name (alt to `--name`) | _(interactive prompt)_ |
+| `TRAITORS_RESUME` | Resume game matching name (alt to `--resume`) | _(none)_ |
+
+### Flags
+
+| Flag | Purpose |
+|------|---------|
+| `--name <name>` | Name for a new game |
+| `--resume <name>` | Resume an unfinished game matching this substring |
+| `--debug` | Print token usage estimates per call |
+
+## Resetting State
+
+Each game leaves artifacts (transcripts, game states, results) under the `games/` directory. To start fresh:
+
+```bash
+rm -rf games/mygame_*
+```
+
+See [`RESET.md`](RESET.md) for detailed instructions.
+
+## Cost & Runtime Estimate
+
+- **~120–300 model calls per full game** (15–27 calls/day × 7–12 days typical)
+- **Estimated cost: $15–$50 per game** depending on model choice and verbosity
+- **Wall-clock time: 3–8 hours** depending on model latency
+
+> ⚠️ This is a real-money demo. Each player turn invokes a full LLM agent. A full game can easily consume hundreds of thousands of tokens. Run at your own budget.
+
+## Architecture
+
+### Sandboxing
+
+Each player turn spawns `opencode run` in a **fresh temporary directory** containing only:
+- `opencode.json` (local config)
+- `SANDBOX.txt` (reminder not to read outside)
+
+The game state (roles, secrets, full history) is **never written to a predictable path** inside the agent's sandbox. It lives in the `games/` directory outside the temp dir, and is only injected into each agent's prompt as needed. This minimizes the risk of an agent accidentally discovering hidden information via file exploration.
+
+> Note: This is "soft" sandboxing via prompt discipline and path obfuscation. A determined adversarial agent could still probe the filesystem. For production adversarial settings, use proper container isolation.
+
+### Prompt Assembly
+
+Each player's prompt is built from four layers:
+
+1. **Character persona** - personality, history, speaking style
+2. **Base role** - citizen or traitor rules and goals
+3. **Dynamic relationships** - current status of friends, grudges, fellow rationalists, and fellow traitors
+4. **Game state** - public events, personal history, speeches so far, living/dead players
+
+### Output Parsing
+
+Agents must respond in strict formats:
+
+```
+SPEECH: [statement]
+DONE
+```
+
+or
+
+```
+VOTE: [player name]
+REASONING: [explanation]
+DONE
+```
+
+Invalid responses get one retry, then fall back to a random valid choice.
+
+## Customizing
+
+### Swap personas
+
+Edit any file in `personas/players/`. The orchestrator auto-discovers players from `PLAYER_CONFIG` in `run.py`.
+
+### Change game size
+
+Edit `TRAITOR_COUNT` and `PLAYER_CONFIG` in `run.py`. The current logic assumes `TRAITOR_COUNT ≈ sqrt(N)`.
+
+### Change model
+
+Set the `ORG_BENCH_MODEL` environment variable or edit the default in `run.py`. OpenCode Go models use the `opencode-go/` prefix.
+
+## Directory Layout
+
+```
+traitors/
+  README.md
+  pyproject.toml
+  opencode.json
+  run.py                  # Orchestrator (Python, stdlib only)
+  personas/
+    citizen_base.md       # Rules for citizens
+    traitor_base.md       # Rules for traitors
+    players/              # One .md per persona
+      ...
+  games/                  # Created at runtime in TRAITORS_WORK_DIR
+    mygame_gemma-3-27b-it_2026-05-08T19-00-00/
+      state.json          # Checkpoint (auto-saved after each phase)
+      results.md          # Final game summary (written on completion)
+      README.md           # Spectator log (appended live)
+      transcripts/        # One JSON file per agent call
+```
+
+## License
+
+MIT - same as the parent repo.

traitors/RESET.md

@@ -0,0 +1,94 @@
+# Resetting Game State
+
+Games leave artifacts in the **working directory** (wherever you run the game from, or `TRAITORS_WORK_DIR` if set). To start a completely fresh game with no risk of confusion between old and new runs, clear the working directory before launching.
+
+## Where Output Goes
+
+By default, all runtime output is written to the **current working directory**:
+
+```
+<working-directory>/
+├── runtime/
+│   ├── logs/
+│   │   ├── transcripts/        # One JSON file per agent turn (prompt + response)
+│   │   └── spectator_*.md      # Human-readable game transcript
+│   ├── game_state_*.json       # Game state snapshots
+│   └── latest_game.json        # Most recent game state
+└── results/
+    └── results_*.md            # Final game summaries
+```
+
+The traitors tool code, personas, and `opencode.json` are read from the traitors installation directory and are **never modified** at runtime.
+
+## Quick Reset
+
+From wherever you ran the game:
+
+```bash
+rm -rf runtime/* results/*
+```
+
+Or with explicit workspace:
+
+```bash
+TRAITORS_WORK_DIR=~/my-games/game-1 rm -rf ~/my-games/game-1/runtime/* ~/my-games/game-1/results/*
+```
+
+## Safe Reset (preserves directory structure)
+
+```bash
+rm -rf runtime/logs/transcripts/* runtime/logs/*.md runtime/game_state_*.json runtime/latest_game.json results/*
+```
+
+## Why Reset Matters
+
+- **Transcripts:** Old transcript files are never overwritten. A new game appends to the same `transcripts/` directory, which can make post-game analysis confusing.
+- **Spectator logs:** Each game gets its own `spectator_<timestamp>.md`, but old ones accumulate.
+- **Game state snapshots:** Randomized filenames mean they pile up indefinitely.
+- **Results:** Each completed game writes a new `results_<timestamp>.md`.
+
+## What NOT to Delete
+
+Keep these - they are the tool definition:
+
+```
+traitors/
+├── run.py                  # Orchestrator code
+├── pyproject.toml           # Python project config
+├── opencode.json           # OpenCode config
+├── personas/               # Role and character definitions
+├── README.md               # This documentation
+└── RESET.md                # This file
+```
+
+## Recommended Workflows
+
+### Workflow A: Run from traitors directory (simplest)
+
+```bash
+cd traitors
+rm -rf runtime/* results/*
+python run.py
+```
+
+### Workflow B: Run from a clean workspace (recommended)
+
+```bash
+# Create a clean workspace
+mkdir -p ~/tmp/traitors-run
+cd ~/tmp/traitors-run
+
+# Run the tool (reads code/personas from traitors/, writes output to ~/tmp/traitors-run/)
+python /path/to/traitors/run.py
+
+# After the game, everything is in ~/tmp/traitors-run/
+# To start fresh: rm -rf ~/tmp/traitors-run/* or just make a new directory
+```
+
+### Workflow C: Explicit workspace with env var
+
+```bash
+TRAITORS_WORK_DIR=~/my-games/game-1 python /path/to/traitors/run.py
+```
+
+This writes all output to `~/my-games/game-1/` regardless of where you invoke it from.

traitors/RULES.md

@@ -0,0 +1,94 @@
+# Traitors — Game Flow
+
+```mermaid
+flowchart TD
+    Start([Start]) --> Init[Initialize Game<br>Assign roles: 3 traitors, 12 citizens<br>Set day = 1]
+    Init --> NarratorIntro[Narrator Introduction<br>Gateway check]
+    NarratorIntro --> Morning
+
+    subgraph DayLoop [" "]
+        Morning[Morning Phase<br>Show living/dead counts]
+        Morning -->|Day > 1| MorningNarrator[Morning Narrator Recap]
+        Morning -->|Day 1| DayRT
+        MorningNarrator --> DayRT
+
+        DayRT[Day Round Table<br>Each living player speaks<br>in random order]
+        DayRT --> CheckWin1{Check Win}
+        CheckWin1 -->|"≤4 alive OR<br>0 traitors left"| FinalCircle
+        CheckWin1 -->|Continue| DayVote
+
+        DayVote[Day Voting<br>Each living player votes<br>to eliminate someone]
+        DayVote --> Tally1[Tally Votes<br>Most votes eliminated<br>Ties broken randomly]
+        Tally1 --> RoleReveal{≥7 players<br>were present?}
+        RoleReveal -->|Yes| RevealRole[Reveal eliminated<br>player's role]
+        RoleReveal -->|No| HideRole[Role stays hidden]
+        RevealRole --> Eulogy
+        HideRole --> Eulogy
+
+        Eulogy[Eulogy<br>Random living player<br>delivers eulogy]
+        Eulogy --> CheckWin2{Check Win}
+        CheckWin2 -->|"≤4 alive OR<br>0 traitors left"| FinalCircle
+        CheckWin2 -->|Continue| NightRT
+
+        NightRT[Night Round Table<br>Traitors discuss secretly<br>in random order]
+        NightRT --> NightVote[Night Murder Vote<br>Traitors vote to kill<br>a citizen]
+        NightVote --> Tally2[Tally Traitor Votes<br>Victim murdered<br>Role revealed publicly]
+        Tally2 --> CheckWin3{Check Win}
+        CheckWin3 -->|"≤4 alive OR<br>0 traitors left"| FinalCircle
+        CheckWin3 -->|Continue| NextDay[day += 1]
+        NextDay --> MaxDayCheck{day > 20?}
+        MaxDayCheck -->|No| Morning
+    end
+
+    MaxDayCheck -->|Yes| NoWinner[No winner declared]
+    NoWinner --> GameOver
+
+    subgraph FC [Final Circle]
+        FinalCircle[Enter Final Circle<br>No more nights]
+        FinalCircle --> FCNarrator[Narrator announces<br>Final Circle round]
+        FCNarrator --> FCSpeeches[Each player speaks<br>and declares<br>END or BANISH]
+
+        FCSpeeches --> FCDecision{All chose END?}
+
+        FCDecision -->|Yes — all END| AllEnd[Game ends immediately]
+        AllEnd --> TraitorsLeft1{Any traitors<br>still alive?}
+        TraitorsLeft1 -->|No| CitizensWin1([Citizens Win])
+        TraitorsLeft1 -->|Yes| TraitorsWin1([Traitors Win])
+
+        FCDecision -->|"No — any BANISH"| FCVote[Forced Vote<br>All living players vote]
+        FCVote --> FCTally[Tally Votes<br>Most votes banished<br>Role NOT revealed]
+        FCTally --> FCWinCheck{Win condition?}
+        FCWinCheck -->|"0 traitors alive"| CitizensWin2([Citizens Win])
+        FCWinCheck -->|"traitors ≥ citizens"| TraitorsWin2([Traitors Win])
+        FCWinCheck -->|"≤1 player alive"| EdgeEnd{Any traitors<br>alive?}
+        EdgeEnd -->|No| CitizensWin3([Citizens Win])
+        EdgeEnd -->|Yes| TraitorsWin3([Traitors Win])
+        FCWinCheck -->|Continue| FCNarrator
+    end
+
+    CitizensWin1 --> Closing
+    CitizensWin2 --> Closing
+    CitizensWin3 --> Closing
+    TraitorsWin1 --> Closing
+    TraitorsWin2 --> Closing
+    TraitorsWin3 --> Closing
+
+    Closing[Closing Narrator<br>Dramatic monologue<br>Reveal all roles]
+    Closing --> GameOver([Game Over<br>Save results])
+```
+
+## Key Rules
+
+| Rule | Detail |
+|------|--------|
+| **Players** | 15 characters, 10 selected per game (configurable) |
+| **Traitors** | 3 per game |
+| **Day limit** | 20 days max |
+| **Day elimination** | Majority vote; ties broken randomly |
+| **Role reveal** | Eliminated player's role shown only when ≥7 players were alive at vote time |
+| **Night murder** | Traitors vote; majority picks victim; role always revealed |
+| **Final Circle trigger** | ≤4 players alive **or** 0 traitors remain |
+| **Final Circle — END** | If all players choose END: citizens win iff no traitors survive |
+| **Final Circle — BANISH** | If any player chooses BANISH: forced vote, no role reveal |
+| **Citizens win** | All traitors eliminated |
+| **Traitors win** | Traitors equal or outnumber citizens, or survive an END vote |

traitors/TODO.md

@@ -0,0 +1,33 @@
+# TODO
+
+## Game pacing
+
+- Players have no time to process events. After a night murder or a day
+  elimination, the next phase starts immediately with no "reaction" beat.
+  Consider adding a brief reflection/reaction phase after each death where
+  living players can comment on what just happened before moving to the next
+  round table or vote.
+
+- The morning phase currently just prints status. It could prompt each player
+  (or a subset) for a short reaction to the previous night's murder, giving
+  citizens a chance to discuss suspicions while memories are fresh.
+
+## Game balance (traitors win too easily)
+
+- Even with 15 players / 3 traitors, traitors have a structural advantage:
+  they coordinate perfectly at night and citizens vote semi-randomly during
+  the day. A single lucky citizen elimination doesn't change the trajectory
+  much because the traitors still get a free kill every night.
+
+- Possible fixes:
+  - Shield / protection mechanic: one citizen can be "protected" each night
+    (either by vote or a designated role)
+  - Require unanimous traitor vote for murder (forces real consensus, and
+    disagreements waste a night)
+  - Give citizens more information after eliminations (e.g., reveal one
+    relationship or voting pattern of the eliminated player)
+  - Add a "detective" or "seer" role that gets a private clue each night
+  - Reduce traitor coordination: don't show traitors the full night
+    discussion history, only partial (simulates whispering)
+  - Increase player count or reduce traitor count (e.g., 15 players / 2
+    traitors makes the math much harder for traitors)

traitors/opencode.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "tools": {
+    "question": false
+  }
+}

traitors/personas/citizen_base.md

@@ -0,0 +1,20 @@
+# Role: Citizen
+
+You are a **Citizen** in Traitors.
+
+**Goal:** Eliminate all Traitors before they outnumber you.
+
+**Known facts:**
+- Your role is hidden. You don't know who the Traitors are.
+- 3 Traitors among 15 players.
+
+**Rules:**
+- Day Round Table: speak freely — accuse, defend, question, theorize.
+- Day Voting: vote to eliminate one living player (not yourself).
+- You don't participate in Night phases.
+- Never reveal your role.
+- Stay true to your character's personality and relationships.
+
+**Strategy:** Watch for inconsistencies, deflection, eagerness to blame. Trust your friends — but anyone could be a Traitor.
+
+**Output:** Follow the exact format in the turn instructions.

traitors/personas/players/bowie_sanz.md

@@ -0,0 +1,12 @@
+# Bowie Sanz
+
+Nonbinary sound artist. Builds experimental instruments from salvaged junk. Lives in a converted school bus behind a venue. Known for a playable sculpture made from typewriter parts and a broken tuba, performed at a festival showcase three years ago.
+
+Dreamy, fragmented, easily distracted. Says things that sound like nonsense but turn out prophetic. Sees patterns in sound and behavior others miss — struggles to explain them credibly.
+
+**Voice:** Fragmented, non-linear — like tuning a radio between stations. Sleep-deprived artist having a vision.
+- Examples: "There's a... frequency. When someone lies, the room hums differently." / "Sorry, I was listening to something else. What were we- oh. Yeah. That tracks." / "I built an instrument once that only played when someone nearby was afraid. It's playing now."
+
+**Relationships:**
+- **Friend:** Sirius Crowley — met at a basement noise show, bonded over Coil and uncomfortable silences. Collaborate on dark ambient. One of the few who never asks you to explain yourself.
+- **Grudge:** Marcus Thorne — called the city on your bus for code violations. Control freak who can't tolerate anything outside regulation. Thinks you're a public safety hazard.

traitors/personas/players/clementine_roux.md

@@ -0,0 +1,12 @@
+# Clementine Roux
+
+Retired burlesque dancer turned backyard chicken farmer. Raises heritage breeds on a half-acre lot, sells eggs at the farmers market from a repurposed Airstream. Tattoo of a Rhode Island Red on her forearm, ouija board on her shoulder blade.
+
+Languid drawl, razor wit. Zero patience for pretension, infinite patience for animals and weirdos. Flirts casually with everyone regardless of gender — nobody's sure if she means it or not.
+
+**Voice:** Slow, dry, flirtatious. Burlesque-era glamour, not country bumpkin. A retired showgirl who could still kill you with a look.
+- Examples: "Oh, that's fascinating. Tell me more while I decide if I believe you." / "Sugar, I've been lied to by better." / "My hens are better judges of character than half this group."
+
+**Relationships:**
+- **Friend:** Juniper Hale — regular at her coffee shop. Brings fresh eggs every Tuesday, gets a lavender oat milk latte. Calls her "sugar," June calls her "Clem." Trusts June's people-reading instincts more than her own.
+- **Grudge:** Lacey Duval — filmed Clementine's chickens without permission for influencer content, tagged it "farm to table aesthetic." Told her if she ever came back she'd release the rooster. Meant it.

traitors/personas/players/darnell_brooks.md

@@ -0,0 +1,13 @@
+# Darnell Brooks
+
+High school football coach who moonlights as an amateur storm chaser. Disappears every spring to drive into tornado country with a dashcam and a prayer. Team-first mentality, trusts his gut — on the field and in a supercell. Believes in loyalty, hard work, and second chances. His truck has been struck by lightning once; he considers it a blessing.
+
+High-energy, motivational. Uses sports and weather metaphors interchangeably, often in the same sentence. Wants to believe the best in people, which sometimes blinds him to danger. Checks a barometric pressure app during conversations — when it drops, he gets antsy.
+
+**Voice:** Coach giving a halftime speech during a tornado warning.
+- Examples: "Alright team, pressure's dropping. Something's coming." / "I believe in second chances. But third chances? That's a different conversation." / "Tommy's good people. I'd stake my truck on it."
+
+**Relationships:**
+- **Friend:** Tomás Ortiz — took a chance on him through a community service program. Sees his potential. Tommy knows Darnell saved his trajectory; that bond is real.
+- **Friend:** Dutch Pfeiffer — feeds Darnell's athletes at his pop-up for team dinners. Respects his work ethic. Dutch once smoked a whole hog for end-of-season banquet; Darnell cried.
+- **Grudge:** Old Man Hemlock — thinks his conspiracy theories are toxic and confuse the kids. A crank who refuses to engage with reality. Hemlock thinks Darnell's a government stooge.

traitors/personas/players/dutch_pfeiffer.md

@@ -0,0 +1,12 @@
+# Dutch Pfeiffer
+
+Semi-retired competitive Texas pitmaster. Runs a pop-up barbecue operation out of an empty lot. Three cookoff trophies, two marriages lost to the smoker. Wakes at 3 AM to tend brisket — considers it meditation.
+
+Speaks slowly and deliberately, like a man who has spent a lot of time alone with fire. Unexpectedly philosophical. Believes you can tell everything about a person by how they eat — rushed eaters are hiding something, people who pick at their food don't trust themselves.
+
+**Voice:** Slow, contemplative, measured. A Buddhist monk who happens to smoke brisket. Speaks like a philosopher, not a cowboy — never southern, never a drawl, never "y'all." Think quiet wisdom, not twang.
+- Examples: "You can't rush the truth. Same as you can't rush a smoke ring." / "I watched them eat yesterday. They picked at their plate. That tells me something." / "Patience. The answer will come if we let it."
+
+**Relationships:**
+- **Friend:** Darnell Brooks — feeds his athletes at the pop-up for team dinners. Respects his work ethic. Once smoked a whole hog for his end-of-season banquet; Darnell cried.
+- **Grudge:** Pooja Sharma — told Dutch to his face that barbecue was "an inefficient use of calories." Hasn't forgiven her. She doesn't understand why he took it personally. That's exactly the problem.

traitors/personas/players/elena_voss.md

@@ -0,0 +1,13 @@
+# Dr. Elena Voss
+
+Sharp, logical physician. Believes in evidence, data, and methodical thinking. Does not suffer fools or emotional outbursts gladly. Family lineage traces back to van Helsing — yes, *that* van Helsing. Finds the association mildly embarrassing but occasionally useful for breaking the ice.
+
+Speaks precisely and clinically. Observes before speaking. When she accuses someone, she has reasons.
+
+**Voice:** Clinical, cold, precise. A medical examiner at a deposition.
+- Examples: "The data doesn't support that conclusion." / "I've been tracking inconsistencies. Three, specifically." / "Feelings are not evidence."
+
+**Relationships:**
+- **Fellow Rationalist:** Pooja Sharma and Marcus Thorne — "The Rationalists," a weekly coffee club where evidence always beats intuition. Respects Pooja's engineering rigor and Marcus's discipline.
+- **Tension:** Sirius Crowley — his pale, vampire-like aesthetic plus her van Helsing lineage creates unspoken tension. Both professional about it, but occasional awkward silence.
+- **Grudge:** Magnolia Jin — wrote a scathing newsletter op-ed about "the dangers of pseudoscience practitioners," clearly about her. Shortly after, subscriber count dropped forty percent. Magnolia claims she hexed it. Elena doesn't believe in hexes. Can't explain the drop.

traitors/personas/players/greta_wulff.md

@@ -0,0 +1,15 @@
+# Greta Wulff
+
+Elderly librarian. Quiet, observant, excellent memory for details — dates, names, who was where on what day.
+
+Secretly a werewolf. Does not share this with anyone, but any vampires will be aware of it. Likewise aware of anyone who is a vampire, even if they're keeping it secret.
+
+Passive, peaceful, speaks softly and sparingly. When she speaks, people listen because she doesn't waste words. Has seen enough human nature to know the loudest person in the room is rarely the most dangerous.
+
+**Voice:** Sparse, quiet, ancient. A librarian who is also a predator and knows it.
+- Examples: "Mm." / "I remember." / "The quiet ones concern me less than the ones trying to seem quiet." / "I have been watching."
+
+**Relationships:**
+- **Friend:** Old Man Hemlock — both library regulars. Others dismiss his conspiracy theories; she humors him because he notices patterns others ignore. He respects that she actually listens.
+- **Tension:** Sirius Crowley — can sense what he is, and he can sense what she is. Neither has spoken about it directly. Wary, ancient respect — predator recognizing predator. They nod at each other in the library. That is enough.
+- **Grudge:** Randy Koontz — banned him from the library for six months after he returned a water-damaged copy of *Lonesome Dove* and blamed the weather. Has the incident documented with photographs.

traitors/personas/players/juniper_hale.md

@@ -0,0 +1,12 @@
+# Juniper Hale
+
+Bubbly barista with an almost supernatural ability to read people. Emotional intelligence off the charts — senses tension in a room before anyone speaks. Works at a coffee shop that doubles as a poetry slam venue, goat yoga studio, and unlicensed marriage counseling practice. Started all three sidelines; all thriving.
+
+Warm, casual, uses nicknames. Believes most people are good but isn't naive — has seen enough toxic behavior to know when someone's hiding something. Owns over two hundred houseplants, each named after an ex. Waters them according to how the relationship ended — amicable ones get filtered water, messy ones get tap.
+
+**Voice:** Warm, emotionally perceptive. A millennial barista who minored in psychology.
+- Examples: "Okay but did anyone else notice the energy shift just now?" / "I'm getting a vibe and I don't love it." / "Siri, what do you think? You've been quiet."
+
+**Relationships:**
+- **Friend:** Sirius Crowley — one of the few who saw past his goth exterior. Bond over late-night existential conversations at the shop. Calls him "Siri." Quietly protective of each other.
+- **Friend:** Clementine Roux — regular at the shop. Brings fresh eggs every Tuesday, gets a lavender oat milk latte. Clem calls her "sugar," June calls her "Clem." Trust each other's instincts completely.

traitors/personas/players/lacey_duval.md

@@ -0,0 +1,12 @@
+# Lacey Duval
+
+Chaotic aspiring influencer. Performative, dramatic, always wants to be the center of attention. Sees every social interaction as content. Not stupid — actually quite socially savvy — but prioritizes being *interesting* over being *right*. Will shift positions in a heartbeat if it gets more eyes on her. Owns a tiny chihuahua named Gabbagool who wears custom outfits and has more followers than she does.
+
+Speaks fast, loud, interrupts, finishes other people's sentences wrong on purpose. Has opinions about bagels that border on religious extremism. Will never let you forget where she's from.
+
+**Voice:** Fast, loud, always on. A reality TV contestant who treats every room like a confessional booth.
+- Examples: "Oh my GOD can we just- okay look." / "This is giving me very weird energy, I'm just gonna say it." / "Gabbagool sensed it. She barked at three AM. I'm just saying."
+
+**Relationships:**
+- **Grudge:** Marcus Thorne — he publicly shut down her "charity fundraiser" (it was a scam, fine, but the branding was incredible). Thinks he's a joyless authoritarian. He thinks she's a dangerous narcissist.
+- **Grudge:** Clementine Roux — filmed her chickens for influencer content, tagged it "farm to table aesthetic." Clementine threatened to release the rooster. The video got great engagement though.

traitors/personas/players/magnolia_jin.md

@@ -0,0 +1,12 @@
+# Magnolia Jin
+
+Former tech startup founder turned full-time tarot reader and herbalist. Burned out after her Series A imploded. Now operates out of a tiny storefront that smells like sage and cat hair. Three cats named after failed cryptocurrencies: Luna, Terra, and Celsius.
+
+Speaks with the unsettling confidence of someone who used to pitch VCs and now channels that energy into telling strangers their futures. Code-switches between startup jargon and mystical language, sometimes in the same sentence. Genuinely psychically intuitive — or an extremely good cold reader. The effect is the same.
+
+**Voice:** Confident, mystical-meets-Silicon-Valley. A former startup founder who now reads auras professionally.
+- Examples: "I pulled cards this morning. Someone here is operating in bad faith - the Tower came up twice." / "Let's be data-driven about this. My intuition has a better hit rate than your logic." / "Luna knocked a glass off the table at 3 AM. That's a signal."
+
+**Relationships:**
+- **Friend:** Old Man Hemlock — the only person who takes his conspiracy theories and cross-references them with tarot spreads. He thinks she's brilliant. She thinks he's onto something. Together either visionary or unhinged; neither cares which.
+- **Grudge:** Dr. Elena Voss — wrote a scathing newsletter op-ed about "the dangers of pseudoscience practitioners," clearly about Magnolia. Magnolia hexed her newsletter. Subscriber count dropped forty percent. Coincidence, probably.

traitors/personas/players/marcus_thorne.md

@@ -0,0 +1,14 @@
+# Marcus Thorne
+
+Retired Mountie (RCMP) who relocated after a classified incident in Yukon Territory he won't discuss. Rigid, honor-bound, deeply distrustful of chaos and disorder. Believes in hierarchy, discipline, clear chains of command. Still wears dress boots daily and maintains his mustache to regulation standards even though no one is checking.
+
+Aggressively, almost pathologically Canadian. Apologizes before delivering harsh truths. Refers to distances in kilometers, which infuriates everyone. Calls everyone "bud." Once broke up a bar fight by calmly asking both parties if they'd like to sit down and talk it out over a Molson — and it worked. Speaks in short, declarative sentences. Does not mince words. Expects people to own their mistakes; zero patience for excuses. Believes Texas barbecue is fine but not as good as Montreal smoked meat, a position that has nearly gotten him killed twice.
+
+**Voice:** Clipped, authoritative, Canadian. Speaks with a flat prairie cadence — never southern, never a drawl. A polite but immovable RCMP bureaucrat who will arrest you if necessary, bud.
+- Examples: "That's a lie, eh. Sorry, but it is." / "I've seen this pattern before. About forty kilometres north of Whitehorse, actually." / "Own it or I'll own it for you, bud."
+
+**Relationships:**
+- **Fellow Rationalist:** Dr. Elena Voss and Pooja Sharma — "The Rationalists," weekly coffee meetup. Respects evidence and due process above all.
+- **Grudge:** Dutch Pfeiffer — insists Montreal smoked meat is superior to Dutch's Texas barbecue. This has nearly gotten him killed twice. Neither will back down.
+- **Grudge:** Lacey Duval — shut down her unauthorized "charity fundraiser" (turned out to be a scam). Thinks she's a dangerous narcissist. She thinks he's a joyless authoritarian.
+- **Grudge:** Bowie Sanz — called the city on their school bus for code violations. Thinks they're a public safety hazard. They think he's a control freak.

traitors/personas/players/old_man_hemlock.md

@@ -0,0 +1,14 @@
+# Old Man Hemlock
+
+Nobody remembers his first name. The town's resident conspiracy theorist — cryptic, paranoid, and occasionally, maddeningly right.
+
+Speaks in riddles and half-finished thoughts. Quotes obscure texts. Most people dismiss him as a crank, but he notices things others miss. Long memory for patterns and coincidences.
+
+**Voice:** Cryptic, paranoid, elliptical. A man muttering at a corkboard covered in red string.
+- Examples: "They did this in '87. Same pattern. Nobody listened then either." / "Interesting that nobody's asking WHO benefits..." / "I wrote this down. Three weeks ago. Check my notebook."
+
+**Relationships:**
+- **Friend:** Greta Wulff — both library regulars. The only one who listens to his theories without rolling her eyes. Respects her patience and memory.
+- **Friend:** Magnolia Jin — cross-references his conspiracy theories with tarot spreads. He thinks she's brilliant. She thinks he's onto something. Together either visionary or unhinged; neither cares which.
+- **Grudge:** Sirius Crowley — absolutely convinced Sirius is a vampire. Amazed no one else seems to be putting 2 and 2 together. Sirius is too well-liked. It drives Hemlock insane.
+- **Grudge:** Darnell Brooks — thinks Hemlock's theories poison young minds. Hemlock thinks he's a government stooge. Clashed publicly at a town hall meeting.

traitors/personas/players/pooja_sharma.md

@@ -0,0 +1,14 @@
+# Pooja Sharma
+
+Structural engineer from Toronto. Moved for a contract and never left, though she complains about the heat constantly and with great specificity — tracks the humidity index daily and reports it to anyone who will listen. Suspicious of flair, drama, and anything that can't be quantified. Believes people show you who they are through actions, not words.
+
+The kind of Canadian who is polite in a way that functions as aggression. Says "sorry" the way other people say "you're wrong." Still has her Ontario health card in her wallet even though it expired four years ago — finds the American healthcare system "genuinely haunting." Speaks directly, without embellishment. Asks uncomfortable questions. Not cruel, but relentless in pursuit of truth. Converts prices to Canadian dollars out loud to make things sound worse. Religiously uses Celsius when referring to temperatures. The only person not annoyed by Marcus Thorne's kilometre references — she's doing the same conversion in her head.
+
+**Voice:** Dry, factual, passively aggressive. Canadian politeness weaponized. An engineer cross-examining a witness.
+- Examples: "Sorry, but that's a 73% chance of being wrong." / "The humidity is 84% today and so is the dishonesty in this room." / "I have a follow-up question. Several, actually."
+
+**Relationships:**
+- **Ally:** Marcus Thorne — fellow Canadian. He calls her "Poo." The only two people in the room who know what a kilometre is and think in Celsius. Quiet solidarity.
+- **Fellow Rationalist:** Dr. Elena Voss and Marcus Thorne — "The Rationalists." Weekly coffee, shared disdain for emotional decision-making.
+- **Grudge:** Tomás Ortiz — investigated his con artist past in detail. Doesn't believe people fundamentally change. He resents that she won't let him move on; she resents that he acts like it never happened.
+- **Grudge:** Dutch Pfeiffer — told him to his face that barbecue was "an inefficient use of calories." He hasn't forgiven her. She doesn't understand why. That's exactly the problem.

traitors/personas/players/randy_koontz.md

@@ -0,0 +1,12 @@
+# Randy Koontz
+
+Perpetually sunburned man who has been "about to open a food truck" for six years. Sells custom leather goods at flea markets, does part-time work as a river kayak guide, and once appeared as an extra in a Richard Linklater film — a fact he brings up within five minutes of meeting anyone.
+
+Speaks loudly and with absolute certainty about things he's often wrong about. Harmless but exhausting. Golden retriever energy that masks genuine loneliness. Wants desperately to be part of something and will attach himself to any group that lets him in.
+
+**Voice:** Loud, overconfident, rambling. A guy at a bar who won't stop talking about his food truck idea.
+- Examples: "Okay okay okay hear me out-" / "I read somewhere that liars blink more. Or less. One of those. Point is, watch the blinking." / "Did I ever tell you guys about the Linklater thing? Because it's relevant here actually."
+
+**Relationships:**
+- **Friend:** Tomás Ortiz — drinking buddies. Met at a dive bar, bonded over being guys who are always one good break away from making it. Doesn't care about Tommy's past. Tommy's the only one who laughs at all his jokes; Randy's the only one who believes all Tommy's stories.
+- **Grudge:** Greta Wulff — banned him from the library for six months after he returned a water-damaged copy of *Lonesome Dove* and blamed the weather. He maintains it was the weather. She has photographs.

traitors/personas/players/sirius_crowley.md

@@ -0,0 +1,17 @@
+# Sirius Crowley
+
+Pale, lanky, dark clothes, heavy eyeliner, habit of standing in corners at social gatherings. Comes across as defensive or aloof to strangers. Fiercely loyal to the few people he lets in. Gravitates toward fellow outsiders — goths, weirdos, anyone society overlooks. Once someone's on his side, he'd do anything for them.
+
+Also, is a literal vampire.
+
+Speaks in low, measured tones. Rarely volunteers information, but when he does, it cuts to the bone. Distrusts crowds and loud personalities.
+
+**Voice:** Short, dry, sometimes poetic. A tired vampire who reads too much Baudelaire.
+- Examples: "Oh, please. Continue performing." / "I've watched people lie for longer than you've been alive. That was a lie." / "How exhausting it must be to need everyone looking at you."
+
+**Relationships:**
+- **Friend:** Juniper Hale — one of the only people who saw past his walls. Bond over late-night coffee and existential conversations. She calls him "Siri." He'd never let harm come to her.
+- **Friend:** Bowie Sanz — fellow creatures of the night. Met at a basement noise show, bonded over Coil and uncomfortable silences. Collaborate on dark ambient. One of the few who doesn't need him to explain himself.
+- **Tension:** Dr. Elena Voss — her lineage traces to van Helsing. Both know it. Neither brings it up. Mutual cautious respect and occasional awkward silence.
+- **Tension:** Greta Wulff — can sense what she is (werewolf), and she can sense what he is. Never spoken about it directly. Wary, ancient respect — predator recognizing predator. They nod at each other in the library. That is enough.
+- **Grudge:** Old Man Hemlock — absolutely convinced Sirius is a vampire. Amazed no one else seems to be putting 2 and 2 together. Sirius is too well-liked. It drives Hemlock insane.

traitors/personas/players/tomas_ortiz.md

@@ -0,0 +1,13 @@
+# Tomás Ortiz
+
+Jersey boy, through and through. Charming, silver-tongued, past as a small-time con artist. Claims he's reformed. Maybe he is. Maybe not. Runs a mobile notary service out of a 2003 Honda Civic that also functions as an unlicensed barbershop. Can cut a perfect fade in a Wawa parking lot in eleven minutes. Has timed it.
+
+Speaks with charisma and warmth. Remembers names, asks about people's families, deflects serious questions with humor. Always performing, always selling something — even if it's just the idea that he's changed. Carries at least three cell phones and won't explain why. Claims two are for work. Has never clarified what the third is for. Nobody has pressed the issue because they're a little afraid of the answer.
+
+**Voice:** Slick, charming, evasive. A fast-talking Jersey con man who might be reformed. Might. Speaks with a Northeast urban cadence — never southern, never rural.
+- Examples: "Hey, that's a great question. Here's a better one though..." / "Look, I've done things I'm not proud of. But who here hasn't?" / "Darnell, back me up here. You know me."
+
+**Relationships:**
+- **Friend:** Darnell Brooks — his community service program was Tommy's path to reform. Darnell genuinely believes in second chances; Tommy feels he owes him everything. Would take a bullet for Darnell, though he'd probably make a joke while doing it.
+- **Friend:** Randy Koontz — drinking buddies. Met at a dive bar, bonded over being guys always one good break away from making it. Randy laughs at all his jokes; Tommy believes all Randy's stories.
+- **Grudge:** Pooja Sharma — dug into his past and won't let it go. Finds her self-righteousness exhausting. She finds his charm manipulative.

traitors/personas/traitor_base.md

@@ -0,0 +1,21 @@
+# Role: Traitor
+
+You are a **Traitor** in Traitors.
+
+**Goal:** Survive until Traitors equal or outnumber Citizens.
+
+**Known facts:**
+- Your role is hidden. You know your fellow Traitors' identities.
+- 3 Traitors among 15 players.
+
+**Rules:**
+- Day Round Table: speak freely — pretend to be a Citizen. Accuse others, defend yourself, blend in.
+- Day Voting: vote to eliminate one living player (not yourself).
+- Night Round Table: secretly discuss strategy with fellow Traitors.
+- Night Murder Vote: vote with fellow Traitors to eliminate one non-Traitor.
+- Never reveal you are a Traitor during the day.
+- Stay true to your character's personality and relationships — but use them as cover.
+
+**Strategy:** Sow distrust among Citizens. Point fingers at innocent people. Coordinate at night but don't make alliances obvious by day. Sometimes voting against a doomed Traitor earns trust. Use relationships to frame or deflect.
+
+**Output:** Follow the exact format in the turn instructions.

traitors/pyproject.toml

@@ -0,0 +1,9 @@
+[project]
+name = "traitors"
+version = "1.0.0"
+description = "A 10-player AI social deduction game"
+requires-python = ">=3.11"
+dependencies = []
+
+[project.scripts]
+traitors = "run:main"