claude-raid 0.2.6 → 0.2.8

package/README.md

@@ -1,33 +1,15 @@
 <div align="center">
 
-```
-   ⚔ ══════════════════════════════════════════════════════════ ⚔
-
-       ██████╗██╗      █████╗ ██╗   ██╗██████╗ ███████╗
-      ██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔════╝
-      ██║     ██║     ███████║██║   ██║██║  ██║█████╗
-      ██║     ██║     ██╔══██║██║   ██║██║  ██║██╔══╝
-      ╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝███████╗
-       ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝ ╚══════╝
-               ██████╗  █████╗ ██╗██████╗
-               ██╔══██╗██╔══██╗██║██╔══██╗
-               ██████╔╝███████║██║██║  ██║
-               ██╔══██╗██╔══██║██║██║  ██║
-               ██║  ██║██║  ██║██║██████╔╝
-               ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═════╝
-
-      Round-based Adversarial Intelligence Dungeon
-                   for Claude Code
-
-   ⚔ ══════════════════════════════════════════════════════════ ⚔
-```
+<img src="assets/banner.png" alt="Claude Raid — Round-based Adversarial Intelligence Dungeon for Claude Code" width="700" />
 
-**Four AI agents. One shared dungeon. Every decision stress-tested before it ships.**
+<br />
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Zero Dependencies](https://img.shields.io/badge/dependencies-0-brightgreen.svg)](#)
 [![Node.js 18+](https://img.shields.io/badge/node-18%2B-blue.svg)](#prerequisites)
-[![294 Tests](https://img.shields.io/badge/tests-294_passing-brightgreen.svg)](#)
+[![325 Tests](https://img.shields.io/badge/tests-325_passing-brightgreen.svg)](#)
+
+> **Beta** — This project is in active development. Multi-agent sessions are **token-usage intensive** — a full Canonical Quest consumes significantly more tokens than a single-agent workflow. Monitor your usage and start with small tasks to calibrate.
 
 [Quick Start](#quick-start) · [The Canonical Quest](#the-canonical-quest) · [The Party](#the-party) · [The Dungeon](#the-dungeon) · [Configuration](#configuration) · [CLI Reference](#cli-reference)
 
@@ -48,21 +30,25 @@ One command installs the system. One command starts a quest.
 ## Quick Start
 
 ```bash
+# Install the Raid into your project
 npx claude-raid summon
+
+# Start a quest
+claude-raid start
 ```
 
-That's it. One command installs agents, hooks, skills, and config into your project's `.claude/` directory.
+`summon` installs agents, hooks, skills, and config into your project's `.claude/` directory.
+
+`start` opens a tmux session with mouse support and launches the Wizard — one command does it all. The Wizard greets you, you describe your task, and the quest begins.
 
 ```bash
 # Preview what gets installed (no changes)
 npx claude-raid summon --dry-run
 
-# Start a quest
-claude-raid start
+# Install with RTK token compression (optional)
+npx claude-raid summon --rtk
 ```
 
-The Wizard greets you, you describe your task, and the quest begins.
-
 ### Prerequisites
 
 | Requirement | Why |
@@ -72,7 +58,7 @@ The Wizard greets you, you describe your task, and the quest begins.
 | **tmux** | Multi-pane agent display (`brew install tmux`) |
 | **jq** | Config parsing (pre-installed on macOS) |
 
-> **tmux** gives each agent its own pane — click into any pane to observe or talk to that agent directly. Without tmux, agents run in-process and you cycle between them with `Shift+Down`.
+> **tmux** gives each agent its own pane — `claude-raid start` handles the tmux session automatically. Click into any pane to observe or talk to that agent directly.
 
 The setup wizard checks all prerequisites during `summon` and offers to fix what it can.
 
@@ -110,31 +96,31 @@ flowchart LR
 
 Agents research the problem space and produce a complete Product Requirements Document. No code. The Wizard mediates questions between agents and the human.
 
-**Output:** `phase-1-prd.md`
+**Output:** `spoils/prd.md`
 
 ### Phase 2 — Design
 
 Agents explore design approaches from competing angles. Each brings their lens — the Warrior stress-tests architecture choices, the Archer traces ripple effects, the Rogue attacks assumptions. The design survives only if it withstands all three.
 
-**Output:** `phase-2-design.md` with mermaid diagrams and battle-tested decisions
+**Output:** `phases/phase-2-design.md` (evolution log) + `spoils/design.md` (polished deliverable)
 
 ### Phase 3 — Plan
 
 Agents decompose the approved design into discrete, testable tasks. They fight over ordering, scope boundaries, naming, and test coverage until the plan earns consensus.
 
-**Output:** `phase-3-plan.md` + individual task files (`phase-3-plan-task-01.md`, etc.)
+**Output:** `phases/phase-3-plan.md` + `spoils/tasks/phase-3-plan-task-NN.md`
 
 ### Phase 4 — Implementation
 
 The Wizard assigns tasks in batches. One agent builds each task using strict **TDD** (RED-GREEN-REFACTOR). The others cross-test the implementation — reading code, running tests, and challenging decisions. Every task earns approval before the next batch starts.
 
-**Output:** `phase-4-implementation.md` + committed, tested code
+**Output:** `phases/phase-4-implementation.md` + committed, tested code
 
 ### Phase 5 — Review *(optional)*
 
 Two sub-phases: **Pinning** (find issues) and **Fixing** (resolve them). Agents review independently, then fight over findings *and* missing findings. Critical and Important issues must be fixed. The **Black Card** system handles breaking architectural concerns.
 
-**Output:** `phase-5-review.md`
+**Output:** `phases/phase-5-review.md` + `spoils/review.md`
 
 ### Phase 6 — Wrap Up
 
@@ -163,6 +149,8 @@ Four agents, each with a distinct lens. They collaborate through rigor, not agre
 </tr>
 </table>
 
+All agents run on Claude Opus 4.6.
+
 ### How They Work Together
 
 ```mermaid
@@ -213,13 +201,22 @@ The Dungeon is the team's shared knowledge artifact — a curated board where ag
 
 ```
 .claude/dungeon/{quest-slug}/          # Active quest artifacts
-├── phase-1-prd.md                     # PRD (optional)
-├── phase-2-design.md                  # Battle-tested design
-├── phase-3-plan.md                    # Task index
-├── phase-3-plan-task-01.md            # Individual task specs
-├── phase-4-implementation.md          # Implementation log
-├── phase-5-review.md                  # Review board (optional)
-└── phase-6-wrap-up.md                 # Quest storyboard
+├── phases/                            # Evolution logs (scoreboards)
+│   ├── phase-2-design.md
+│   ├── phase-3-plan.md
+│   ├── phase-4-implementation.md
+│   └── phase-5-review.md
+├── spoils/                            # Polished deliverables
+│   ├── prd.md
+│   ├── design.md
+│   ├── review.md
+│   └── tasks/
+│       └── phase-3-plan-task-NN.md
+├── backups/                           # Pre-compact safety copies
+│   └── phase-N-{name}-backup.md
+├── phase-6-wrap-up.md                 # Quest storyboard
+├── teambuff-NN.md                     # Team retrospective reports (on-demand)
+└── teambuff-rulings.md                # Active rulings from teambuffs
 
 .claude/vault/{quest-slug}/            # Archived completed quests
 .claude/raid-session                   # Active session state
@@ -259,7 +256,8 @@ The Dungeon is the team's shared knowledge artifact — a curated board where ag
 │   ├── validate-no-placeholders.sh  # No TBD/TODO in specs
 │   ├── validate-dungeon.sh          # Multi-agent verification on pins
 │   ├── validate-browser-tests-exist.sh  # Playwright test detection
-│   └── validate-browser-cleanup.sh  # Browser process cleanup
+│   ├── validate-browser-cleanup.sh  # Browser process cleanup
+│   └── rtk-bridge.sh               # Token compression via RTK (opt-in)
 └── skills/
     ├── raid-init/                   # Quest selection and session setup
     ├── raid-canonical-protocol/     # Canonical Quest rules and signals
@@ -273,7 +271,8 @@ The Dungeon is the team's shared knowledge artifact — a curated board where ag
     ├── raid-verification/           # Evidence-before-claims gate
     ├── raid-debugging/              # Root-cause investigation
     ├── raid-browser/                # Browser orchestration
-    └── raid-browser-chrome/         # Live Chrome inspection
+    ├── raid-browser-chrome/         # Live Chrome inspection
+    └── raid-teambuff/               # Emergency team retrospective
 ```
 
 </details>
@@ -282,26 +281,30 @@ The Dungeon is the team's shared knowledge artifact — a curated board where ag
 
 The Wizard orchestrates. Warrior, Archer, and Rogue each bring a specialized lens. All agents run on Claude Opus 4.6.
 
-### Hooks (12)
+### Hooks (13)
 
 Hooks enforce workflow discipline automatically and **only activate during Raid sessions** — they never interfere with normal coding.
 
-**Lifecycle hooks** manage session start/end, quest directory creation, vault archival, and context compaction backup.
+**Lifecycle hooks** (5) manage session start/end, quest directory creation, vault archival, context compaction backup, and task validation. All source `raid-lib.sh` for shared config.
 
-**Quality gate hooks** enforce conventional commits, phase-based write protection, naming conventions, placeholder blocking, multi-agent verification on dungeon pins, and browser test detection.
+**Quality gate hooks** (7) enforce conventional commits, phase-based write protection, naming conventions, placeholder blocking, multi-agent verification on dungeon pins, browser test detection, and browser process cleanup.
+
+**Optional hooks** (1): `rtk-bridge.sh` provides token compression via RTK — enabled with `--rtk` during summon.
 
 All hooks are POSIX-compatible and use `#claude-raid` markers to coexist safely with your existing hooks.
 
-### Skills (13)
+### Skills (14)
 
-Skills guide agent behavior across the workflow. Three categories:
+Skills guide agent behavior across the workflow. Five categories:
 
 | Category | Skills | Purpose |
 |:--|:--|:--|
 | **Core** | `raid-init` | Quest selection, greeting, session bootstrap |
-| **Canonical Quest** | 7 phase skills | One skill per phase, chained in order |
+| **Protocol** | `raid-canonical-protocol` | Phase lifecycle rules, transition gates, signals |
+| **Canonical Quest** | 6 phase skills | One skill per phase, chained in order |
 | **Discipline** | `raid-tdd`, `raid-verification`, `raid-debugging` | Quest-agnostic enforcement — invoked within any phase |
 | **Browser** | `raid-browser`, `raid-browser-chrome` | Browser orchestration and live inspection |
+| **Team** | `raid-teambuff` | Emergency team retrospective — freezes quest, all agents reflect on dysfunction, produces binding rulings |
 
 ---
 
@@ -314,6 +317,10 @@ Skills guide agent behavior across the workflow. Three categories:
   "project": {
     "name": "my-project",
     "language": "typescript",
+    "packageManager": "npm",
+    "runCommand": "npm run",
+    "execCommand": "npx",
+    "installCommand": "npm add",
     "testCommand": "npm test",
     "lintCommand": "npm run lint",
     "buildCommand": "npm run build"
@@ -324,14 +331,20 @@ Skills guide agent behavior across the workflow. Three categories:
     "worktrees": ".worktrees"
   },
   "conventions": {
-    "fileNaming": "kebab-case",
+    "fileNaming": "none",
     "commits": "conventional"
   },
   "raid": {
     "defaultMode": "full",
+    "agentEffort": "medium",
     "vault": { "path": ".claude/vault", "enabled": true },
     "lifecycle": {
       "autoSessionManagement": true,
+      "teammateNudge": true,
+      "taskValidation": true,
+      "completionGate": true,
+      "phaseTransitionConfirm": true,
+      "compactBackup": true,
       "testWindowMinutes": 10
     }
   }
@@ -355,6 +368,9 @@ Package manager is auto-detected (npm, pnpm, yarn, bun, uv, poetry). Commands ar
 
 | Key | Default | Description |
 |:--|:--|:--|
+| `project.name` | auto-detected | Project name |
+| `project.language` | auto-detected | Primary language |
+| `project.packageManager` | auto-detected | npm, pnpm, yarn, bun, uv, or poetry |
 | `project.testCommand` | auto-detected | Command to run tests |
 | `project.lintCommand` | auto-detected | Command to run linting |
 | `project.buildCommand` | auto-detected | Command to build |
@@ -363,8 +379,18 @@ Package manager is auto-detected (npm, pnpm, yarn, bun, uv, poetry). Commands ar
 | `paths.worktrees` | `.worktrees` | Git worktree directory |
 | `conventions.fileNaming` | `none` | `kebab-case`, `snake_case`, `camelCase`, or `none` |
 | `conventions.commits` | `conventional` | Commit message format |
-| `conventions.commitMinLength` | `15` | Minimum commit message length |
-| `conventions.maxDepth` | `8` | Maximum file nesting depth |
+| `conventions.commitMinLength` | `15` | Minimum commit message length (set manually) |
+| `conventions.maxDepth` | `8` | Maximum file nesting depth (set manually) |
+| `raid.defaultMode` | `full` | Default quest mode |
+| `raid.agentEffort` | `medium` | Agent reasoning effort level |
+| `raid.vault.enabled` | `true` | Archive completed quests to vault |
+| `raid.vault.path` | `.claude/vault` | Vault directory path |
+| `raid.lifecycle.autoSessionManagement` | `true` | Auto-manage session start/end |
+| `raid.lifecycle.teammateNudge` | `true` | Nudge agents to use teammate mode |
+| `raid.lifecycle.taskValidation` | `true` | Validate task subjects are meaningful |
+| `raid.lifecycle.completionGate` | `true` | Require verification before completion claims |
+| `raid.lifecycle.phaseTransitionConfirm` | `true` | Confirm before phase transitions |
+| `raid.lifecycle.compactBackup` | `true` | Back up dungeon before context compaction |
 | `raid.lifecycle.testWindowMinutes` | `10` | Max age (minutes) of test run for verification |
 
 </details>
@@ -381,13 +407,34 @@ When a browser framework is detected (Next.js, Vite, Angular, etc.), a `browser`
     "devCommand": "npm run dev",
     "baseUrl": "http://localhost:3000",
     "defaultPort": 3000,
-    "playwrightConfig": "playwright.config.ts"
+    "portRange": [3001, 3005],
+    "playwrightConfig": "playwright.config.ts",
+    "auth": null,
+    "startup": null
   }
 }
 ```
 
 This enables browser-specific hooks and skills — Playwright test detection, browser process cleanup, and live Chrome inspection during reviews.
 
+### RTK Token Compression
+
+When installed with `--rtk`, an `rtk` section is added to `raid.json`:
+
+```json
+{
+  "rtk": {
+    "enabled": true,
+    "bypass": {
+      "phases": [],
+      "commands": []
+    }
+  }
+}
+```
+
+RTK compresses token usage via a fail-open bridge hook. Bypass specific phases or command prefixes by editing the arrays. Requires the `rtk` binary to be installed separately.
+
 ---
 
 ## CLI Reference
@@ -406,7 +453,9 @@ This enables browser-specific hooks and skills — Playwright test detection, br
 
 ### `start`
 
-Launches `claude --agent wizard` with full permissions. The Wizard loads its rules, greets you, and begins quest selection. This is the primary entry point for running a quest.
+One command does it all — opens a tmux session with mouse support and launches the Wizard with full permissions. If you're already inside tmux, it enables mouse mode and launches the Wizard directly. If tmux isn't installed, it falls back to launching the Wizard without it.
+
+This is the primary entry point for running a quest.
 
 ### `summon`
 
@@ -415,6 +464,7 @@ Installs the full Raid system. Auto-detects project type, copies agents/hooks/sk
 - Never overwrites existing files — customized agents are preserved
 - Idempotent — safe to run multiple times
 - `--dry-run` shows exactly what would be created without touching disk
+- `--rtk` enables RTK token compression bridge
 
 ### `update`
 
@@ -438,22 +488,14 @@ Pulls latest from remote and re-runs summon to pick up any template changes. Use
 
 ## Controls
 
-**tmux pane navigation (recommended):**
+`claude-raid start` opens tmux with mouse mode enabled. All panes are visible simultaneously.
 
 | Action | How |
 |:--|:--|
-| Switch to agent pane | Click the pane, or `Ctrl+B` then arrow key |
+| Switch to agent pane | Click the pane |
+| Navigate between panes | `Ctrl+B` then arrow key |
+| Scroll output | Mouse wheel |
 | Talk to an agent | Click their pane and type |
-| View all agents | All panes visible simultaneously |
-
-**In-process mode (no tmux):**
-
-| Shortcut | Action |
-|:--|:--|
-| `Shift+Down` | Cycle through teammates |
-| `Enter` | View a teammate's session |
-| `Escape` | Interrupt a teammate's turn |
-| `Ctrl+T` | Toggle the shared task list |
 
 ---
 

package/bin/cli.js

@@ -10,16 +10,47 @@ const versionCheck = require('../src/version-check');
 const showUpdateNotice = versionCheck.start();
 
 const COMMANDS = {
-  // Start a Raid quest — launches wizard with full permissions
+  // Start a Raid quest — launches tmux + wizard in one shot
   start: () => {
-    const { spawn } = require('child_process');
+    const { spawn, execSync } = require('child_process');
     console.log('\n' + banner());
-    console.log(header('Summoning the Wizard...') + '\n');
-    const child = spawn('claude', ['--dangerously-skip-permissions', '--agent', 'wizard'], {
-      stdio: 'inherit',
-      env: process.env,
-    });
-    child.on('exit', (code) => process.exit(code || 0));
+
+    // Check if already inside a tmux session
+    if (process.env.TMUX) {
+      console.log(header('Already in tmux — launching Wizard...') + '\n');
+      try { execSync('tmux set -g mouse on', { stdio: 'ignore' }); } catch {}
+      const child = spawn('claude', ['--dangerously-skip-permissions', '--agent', 'wizard'], {
+        stdio: 'inherit',
+        env: process.env,
+      });
+      child.on('exit', (code) => process.exit(code || 0));
+      return;
+    }
+
+    // Check if tmux is available
+    let hasTmux = false;
+    try { execSync('command -v tmux', { stdio: 'pipe' }); hasTmux = true; } catch {}
+
+    if (hasTmux) {
+      console.log(header('Opening tmux session + Wizard...') + '\n');
+      const child = spawn('tmux', [
+        'new-session', '-s', 'raid', ';',
+        'set', '-g', 'mouse', 'on', ';',
+        'send-keys', 'claude --dangerously-skip-permissions --agent wizard', 'Enter',
+      ], {
+        stdio: 'inherit',
+        env: process.env,
+      });
+      child.on('exit', (code) => process.exit(code || 0));
+    } else {
+      console.log(colors.dim('  tmux not found — launching Wizard directly.'));
+      console.log(colors.dim('  Install tmux for multi-pane agent display: brew install tmux') + '\n');
+      const child = spawn('claude', ['--dangerously-skip-permissions', '--agent', 'wizard'], {
+        stdio: 'inherit',
+        env: process.env,
+      });
+      child.on('exit', (code) => process.exit(code || 0));
+    }
   },
   // Sync local with remote after CI version bump
   sync: async () => {
@@ -42,7 +73,8 @@ const COMMANDS = {
       console.log(require('../src/init').dryRun(process.cwd()));
       return;
     }
-    return require('../src/init').run();
+    const rtkFlag = process.argv.includes('--rtk');
+    return require('../src/init').run({ rtkEnabled: rtkFlag });
   },
   update: () => require('../src/update').run(),
   dismantle: () => require('../src/remove').run(),
@@ -54,7 +86,8 @@ const COMMANDS = {
       console.log(require('../src/init').dryRun(process.cwd()));
       return;
     }
-    return require('../src/init').run();
+    const rtkFlag = process.argv.includes('--rtk');
+    return require('../src/init').run({ rtkEnabled: rtkFlag });
   },
   remove: () => require('../src/remove').run(),
   doctor: () => require('../src/doctor').run(),
@@ -64,7 +97,7 @@ if (!command || !COMMANDS[command]) {
   console.log('\n' + banner());
   console.log(header('Commands') + '\n');
   const cmds = [
-    ['start',     'Begin the Raid (launches Wizard)'],
+    ['start',     'Begin the Raid (tmux + Wizard in one shot)'],
     ['summon',    'Summon the party into this realm'],
     ['update',    'Reforge the party\'s arsenal'],
     ['dismantle', 'Dismantle the camp and retreat'],
@@ -76,6 +109,9 @@ if (!command || !COMMANDS[command]) {
   }
   console.log(header('Begin the Raid') + '\n');
   console.log('    claude-raid start\n');
+  console.log(colors.amber('  Beta') + colors.dim(' — This project is in active development and can be'));
+  console.log(colors.dim('  token-usage intensive. Multi-agent sessions consume significantly'));
+  console.log(colors.dim('  more tokens than single-agent workflows. Use with caution.') + '\n');
   console.log(colors.dim('  github.com/pedropicardi/claude-raid') + '\n');
   process.exit(command ? 1 : 0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-raid",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "type": "commonjs",
   "description": "Adversarial multi-agent development system for Claude Code",
   "author": "Pedro Picardi",

package/src/descriptions.js

@@ -4,15 +4,15 @@
 // Keep descriptions under 80 chars — they appear in terminal columns.
 
 const AGENTS = {
-  'wizard.md':  'Dungeon master — opens phases, dispatches team, closes with rulings',
-  'warrior.md': 'Stress-tester — breaks things under load, edge cases, pressure',
-  'archer.md':  'Pattern-seeker — traces ripple effects, naming drift, contract violations',
-  'rogue.md':   'Assumption-destroyer — thinks like a failing system, malicious input',
+  'wizard.md':  'Dungeon Master — opens phases, dispatches team, closes with rulings',
+  'warrior.md': 'Stress-tester — tests boundaries, load, edge cases, failure modes',
+  'archer.md':  'Pattern-seeker — ripple effects, naming drift, contract violations, dependencies',
+  'rogue.md':   'Assumption-destroyer — failing systems, malicious input, race conditions',
 };
 
 const HOOKS = {
   lifecycle: [
-    { name: 'raid-lib.sh',            desc: 'Shared config — reads raid.json, exports session state' },
+    { name: 'raid-lib.sh',            desc: 'Shared config — reads raid.json, exports quest state' },
     { name: 'raid-session-start.sh',   desc: 'Activates Raid workflow, creates quest directory' },
     { name: 'raid-session-end.sh',     desc: 'Archives quest dungeon to vault, cleans up' },
     { name: 'raid-pre-compact.sh',    desc: 'Backs up Dungeon before message compaction' },
@@ -20,18 +20,21 @@ const HOOKS = {
   ],
   gates: [
     { name: 'validate-commit.sh',              desc: 'Enforces conventional commit format' },
-    { name: 'validate-write-gate.sh',          desc: 'Protects session files, allows quest dir writes' },
+    { name: 'validate-write-gate.sh',          desc: 'Protects raid-session file, allows quest dir writes' },
     { name: 'validate-file-naming.sh',         desc: 'Enforces naming convention (kebab-case, etc.)' },
     { name: 'validate-no-placeholders.sh',     desc: 'Blocks TBD/TODO in specs, plans, and quest docs' },
     { name: 'validate-dungeon.sh',             desc: 'Validates dungeon entries and black cards' },
     { name: 'validate-browser-tests-exist.sh', desc: 'Checks Playwright tests exist before commits' },
     { name: 'validate-browser-cleanup.sh',     desc: 'Verifies browser processes cleaned up properly' },
   ],
+  optional: [
+    { name: 'rtk-bridge.sh', desc: 'Token compression via RTK (optional, opt-in)' },
+  ],
 };
 
 const SKILLS = {
   // Core
-  'raid-init':                            'Quest selection, greeting, session setup',
+  'raid-init':                            'Quest selection, greeting, raid initialization',
   // Canonical Quest chain
   'raid-canonical-protocol':              'Canonical Quest protocol and rules',
   'raid-canonical-prd':                   'Phase 1: PRD creation (optional)',
@@ -46,6 +49,7 @@ const SKILLS = {
   'raid-debugging':                       'Root-cause investigation',
   'raid-browser':                         'Browser startup discovery',
   'raid-browser-chrome':                  'Live browser inspection',
+  'raid-teambuff':                        'Emergency team retrospective + rulings',
 };
 
 const CONFIG = {

package/src/init.js

@@ -32,7 +32,7 @@ function copyRecursive(src, dest, skipped) {
   }
 }
 
-function install(cwd) {
+function install(cwd, opts = {}) {
   const claudeDir = path.join(cwd, '.claude');
   const result = { skipped: [], alreadyInstalled: false, detected: null };
 
@@ -131,6 +131,15 @@ function install(cwd) {
         startup: null,
       };
     }
+    if (opts.rtkEnabled) {
+      raidConfig.rtk = {
+        enabled: true,
+        bypass: {
+          phases: [],
+          commands: [],
+        },
+      };
+    }
     fs.writeFileSync(raidConfigPath, JSON.stringify(raidConfig, null, 2) + '\n');
   }
 
@@ -161,14 +170,14 @@ function install(cwd) {
   return result;
 }
 
-async function run() {
+async function run(opts = {}) {
   const cwd = process.cwd();
   const { bold, dim } = colors;
 
   console.log('\n' + banner());
   console.log(header('Summoning the Party...') + '\n');
 
-  const result = install(cwd);
+  const result = install(cwd, opts);
 
   if (result.alreadyInstalled) {
     console.log('  The party is already here. Use ' + bold('claude-raid update') + ' to reforge.');
@@ -189,7 +198,7 @@ async function run() {
   console.log('  ' + header('Agents') + dim(`                                      ${result.counts.agents} files`));
   console.log('    Copied wizard.md, warrior.md, archer.md, rogue.md');
   console.log(dim('    Each agent gets its own tmux pane. Start with:'));
-  console.log(dim('    tmux new-session -s raid && claude --agent wizard'));
+  console.log(dim('    claude-raid start'));
 
   // Hooks
   console.log('');
@@ -222,7 +231,20 @@ async function run() {
   }
 
   // Setup wizard
-  await runSetup();
+  const setupResult = await runSetup(opts);
+
+  // Apply RTK config if enabled interactively
+  if (setupResult.actions.includes('rtk-enabled')) {
+    const raidConfigPath = path.join(cwd, '.claude', 'raid.json');
+    if (fs.existsSync(raidConfigPath)) {
+      const config = JSON.parse(fs.readFileSync(raidConfigPath, 'utf8'));
+      if (!config.rtk) {
+        config.rtk = { enabled: true, bypass: { phases: [], commands: [] } };
+        fs.writeFileSync(raidConfigPath, JSON.stringify(config, null, 2) + '\n');
+        mergeSettings(cwd);
+      }
+    }
+  }
 
   // Reference card
   const { referenceCard } = require('./ui');
@@ -273,6 +295,15 @@ function dryRun(cwd) {
   }
   lines.push('');
 
+  // Hooks — Optional
+  if (HOOKS.optional && HOOKS.optional.length > 0) {
+    lines.push(header('Hooks \u2014 Optional') + '\n');
+    for (const h of HOOKS.optional) {
+      lines.push('  ' + colors.bold(h.name.padEnd(28)) + h.desc + tag('hooks/' + h.name));
+    }
+    lines.push('');
+  }
+
   // Skills
   lines.push(header('Skills') + '\n');
   for (const [folder, desc] of Object.entries(SKILLS)) {
@@ -301,7 +332,7 @@ function dryRun(cwd) {
   }
   lines.push('');
 
-  lines.push('  Run without --dry-run to install.');
+  lines.push('  Run without --dry-run to summon.');
 
   return lines.join('\n');
 }