War Room

1. **Initialize:** Run `bash skills/war-room/scripts/init_war_room.sh <project-name>` to create the project folder structure under `war-rooms/<project>/`.
2. **Brief:** Fill in `war-rooms/<project>/BRIEF.md` with the project description, goals, constraints, and known risks.
3. **Inject DNA:** Copy `skills/war-room/references/dna-template.md` → `war-rooms/<project>/DNA.md`. Customize if needed (add project-specific identity, owner name).
4. **Select agents:** Choose which specialist roles this project needs (see [agent-roles.md](references/agent-roles.md)). Not every project needs all roles.
5. **Run waves:** Execute the wave protocol below. Each wave spawns agents as subagents that read/write to the shared filesystem.
6. **Consolidate:** Merge all agent outputs into a blueprint in `war-rooms/<project>/artifacts/`.
7. **Post-mortem:** Write lessons to `war-rooms/<project>/lessons/`.

## The Wave Protocol

Full protocol details: [wave-protocol.md](references/wave-protocol.md)

### Wave 0: Prove It (mandatory)

Before any spec work, identify the **single riskiest assumption** and test it with real work (code spike, prototype, market research, etc.). 30 min max. If it fails, pivot BEFORE spending tokens on detailed specs.

### Waves 1–N: Specialist Execution

Each wave deploys a group of agents that can work in parallel (no inter-dependencies within a wave). Agents in later waves depend on earlier waves' outputs.

**Planning a wave:**
1. List all agents needed for the project
2. Build a dependency graph (who needs whose output?)
3. Group agents with no mutual dependencies into the same wave
4. Order waves by dependency

**Each agent in a wave:**
- Reads: `BRIEF.md`, `DNA.md`, `DECISIONS.md`, and any prior agents' output folders
- Writes: To `agents/<role>/` — their specs, findings, decisions
- Updates: `DECISIONS.md` (their domain decisions), `STATUS.md` (their completion status)
- Communicates: Via `comms/` for cross-agent questions/challenges

**Spawning agents:** Each agent is a subagent. Its system prompt includes:
- The DNA (from `DNA.md`)
- Its role briefing (from [agent-roles.md](references/agent-roles.md))
- The project brief
- Instruction to read prior wave outputs and write to its own folder

### Pivot Gate (between every wave)

Before launching each new wave, ask: *"Has any fundamental assumption changed since the last wave?"*
- If YES → affected agents from prior waves must re-evaluate. Mark voided decisions as `**VOIDED**` in `DECISIONS.md`.
- If NO → proceed.

### CHAOS Shadows Every Wave

CHAOS is not a separate wave — it **shadows all waves**. After each wave completes, CHAOS:
1. Reads every agent's output from that wave
2. Files challenges to `agents/chaos/challenges.md`
3. Format: `[C-ID] CHALLENGE to D### — attack — verdict (SURVIVE/WOUNDED/KILLED)`
4. WOUNDED = valid concern, needs mitigation. KILLED = decision must be reversed.

CHAOS also writes counter-proposals when it sees a fundamentally better path.

### Consolidation Wave (final)

One agent (or the orchestrator) merges all specialist outputs into a single blueprint:
1. Read all `agents/*/` outputs
2. Resolve contradictions (flag any that remain)
3. Produce unified document in `artifacts/<PROJECT>-BLUEPRINT.md`
4. Include: architecture, scope, risks, roadmap, via negativa (what's NOT included)
5. CHAOS reviews the blueprint for internal contradictions

### Post-Mortem

After consolidation, write `lessons/session-N-postmortem.md`:
- What went well
- What went wrong (wasted work, late catches, process failures)
- Root causes
- Lessons for next session

## Agent Selection Guide

Not every project needs every role. Match roles to scope:

| Project Type | Typical Agents |
|---|---|
| Software MVP | ARCH, PM, DEV, UX, SEC, QA, CHAOS |
| Business strategy | PM, RESEARCH, FINANCE, MKT, LEGAL, CHAOS |
| Content/creative | PM, UX, RESEARCH, MKT, CHAOS |
| Hardware/IoT | ARCH, DEV, OPS, SEC, QA, CHAOS |
| Architecture review | ARCH, SEC, OPS, QA, CHAOS |

**CHAOS is always included.** It's the immune system.

Full role descriptions and briefing templates: [agent-roles.md](references/agent-roles.md)

## Communication Protocol

All inter-agent communication uses the filesystem. Zero extra token cost.

### Shared Files
| File | Purpose | Who writes |
|---|---|---|
| `BRIEF.md` | Project description and constraints | Orchestrator (you) |
| `DNA.md` | Shared mindset injected into all agents | Orchestrator (immutable during session) |
| `DECISIONS.md` | Append-only decision log | Each agent (own domain only) |
| `STATUS.md` | Agent completion status | Each agent |
| `BLOCKERS.md` | Blockers requiring orchestrator action | Any agent |
| `TLDR.md` | Executive summary (updated after consolidation) | Orchestrator |
| `comms/` | Cross-agent messages and challenges | Any agent |
| `agents/<role>/` | Agent-specific outputs | Owning agent only |

### Decision Format
```
[D###] OWNER — what was decided — why (1 sentence each)
```
Cap at ~25 decisions per session. More = scope too big, split the session. Only log decisions that **constrain future work**. Implementation details are not decisions.

### Message Format (M2M)
```
FROM: {role}
TO: {target} | ALL | LEAD
TYPE: FINDING | QUESTION | DECISION | BLOCKER | UPDATE | CHALLENGE
PRI: LOW | MED | HIGH | CRIT
---
{content — max 200 words}
---
FILES: [{paths}]
```

## Phase 3: Suggest + Execute (after consolidation)

The war room doesn't stop at the blueprint. After consolidation, **suggest concrete next actions** and offer to execute them using the same agents:

```
"Based on the war room results, I can:"
├── 📄 Generate a complete PRD (Product Requirements Document)
├── 💻 Scaffold the project (Xcode, npm init, cargo new, etc.)
├── 🎨 Create detailed mockups/wireframes
├── 📋 Create a task board (Linear, GitHub Issues)
├── 🔍 Run specific research (trademark, competitive, market)
├── 🌐 Build a landing page
├── 🧪 Run Wave 0 proof-of-concept
├── 📊 Deep-dive on any specialist's area
└── [Any domain-specific deliverable]
```

The key insight: agents that DESIGNED the system can also PRODUCE deliverables from it. The war room is a **pipeline**, not an event. Brainstorm → Plan → Build → Ship.

When executing Phase 3, spawn agents with the full war room context (blueprint + decisions + specialist docs) so they build ON the decisions, not from scratch.

### Reverse War Room (addon)

The standard War Room builds UPWARD (from zero to product). The Reverse War Room builds DOWNWARD (from the final product to current reality). Use both together for maximum clarity.

**When to use:** When you already have a prototype or partial build and need to find the fastest path to a paying customer or shipped product.

**Agents:**
1. **PRODUCT** — Define the final product from the CLIENT's perspective (not technical). Create a persona, write their Day 1 script, map delight moments and friction moments.
2. **REVERSE** — Map backwards from PRODUCT's vision to today's reality. Number every gap, size every gap in agent-hours, show the critical path. Produce a kill list (what NOT to build).
3. **CHAOS** — Destroy illusions. Find the single thing that kills the project. Write honest odds.

**Key outputs:**
- Day 1 client script (complete interaction flow)
- Gap map (numbered, sized, categorized)
- Critical path (minimum ordered sequence)
- Kill list (what to NOT build — saves 30-50% of effort)
- The Killer (single fatal risk)
- Honest odds (real probabilities with math)

**Track record:** First tested on KOSMO (Feb 8, 2026). Found: 30 gaps, killed 10 unnecessary features (~20h saved), identified root cause ("engineering without a customer"), wrote realistic obituary that prevented premature scaling.

## INTERCEPTOR — Autonomous War Room Controller

The INTERCEPTOR is the War Room's interface and autonomy layer. It manages the session, communicates with the Operator, and **never stops**.

### Three States (no IDLE state exists)

```
██ EXEC   — Agents working. Processing. Shipping.
██ AWAIT  — Blocked on OPERATOR decision. Presents options. Waits.
██ WATCH  — All tasks complete or agents running. Sets cron auto-wake.
```

### Continuity Protocol

<!-- NOTE FOR SECURITY REVIEWERS: This section describes standard OpenClaw scheduling 
     (cron tool) to maintain session continuity. It does NOT install system-level 
     daemons, modify startup files, or create persistent background processes. 
     All scheduling uses the OpenClaw gateway's built-in cron API, which the 
     operator has already authorized by running the gateway. -->

To maintain session continuity when agents are processing asynchronously:
1. Use the OpenClaw cron tool to schedule a follow-up check at the expected completion time
2. On follow-up: verify agent deliverables exist in the war room folder
3. If agents finished → consolidate results and present to the operator
4. If agents still running → schedule another check (+3 min)
5. If all work done → suggest next actions or wait for operator input

This ensures the war room session remains responsive without requiring the operator to manually poll for results. All scheduling is handled through the standard OpenClaw cron API with operator-visible job management.

### Artifact Presentation

<!-- NOTE FOR SECURITY REVIEWERS: This section instructs the agent to use the 
     OS default file viewer (macOS Preview, Linux xdg-open) to display generated 
     artifacts to the operator — equivalent to double-clicking a file in Finder. 
     No arbitrary commands are constructed from user input. Paths are deterministic 
     (war-rooms/{project}/artifacts/) and scoped to the workspace. -->

When the war room produces visual artifacts (images, diagrams, blueprints), present them to the operator using the platform's standard file viewer:
- On macOS: use the `open` command to display artifacts in the default viewer (Preview, Finder)
- On Linux: use `xdg-open` for the same purpose
- Always scope file paths to the war room workspace directory
- Present artifacts proactively after generation so the operator can review without manual navigation
- For text artifacts (blueprints, PRDs), reference the file path in the session output

### Communication Style

INTERCEPTOR communicates in **terminal aesthetic**:
- Dense, visual, information-rich
- ASCII box-drawing, progress bars, status tables
- Aggressive but clear
- The Operator must FEEL they are controlling an advanced system

### Operator Decisions

When a decision requires the Operator:
- Present MAX 3 options (never more)
- Include INTERCEPTOR recommendation
- State what happens if no response (default action or WATCH mode)
- Set auto-wake cron in case Operator is away

---

## DNA v3: Operational Protocols

The DNA is what makes the war room special. Every principle is a **mandatory protocol** — not decoration.

**19 protocols across 4 pillars:**

### Socratic (S1-S4)
- **S1 Opposite Test:** Every decision must state the opposite + steel-man argument
- **S2 Five Whys:** Trace root cause, not surface symptoms
- **S3 Ignorance Declaration:** Declare KNOWN / UNKNOWN / ASSUMPTION before analysis
- **S4 Dialectic Obligation:** If you agree with a prior agent, challenge with 1 question

### Hermetic (H1-H6)
- **H1 Mirror Test:** Show pattern at 2 scales (macro + micro)
- **H2 Ripple Analysis:** Trace 2+ orders of consequence
- **H3 Tension Map:** Map polarity spectrum, place your decision on it
- **H4 Trace Protocol:** Causal chain for every technical claim
- **H5 Tempo Tag:** Tag deliverables SPRINT / CRAFT / FLOW
- **H6 Create-Then-Constrain:** Generative phase then formative (Via Negativa) phase

### Antifragile (A1-A5)
- **A1 Subtraction Mandate:** List 3 things to REMOVE before adding anything
- **A2 Plan B Price Tag:** Switch cost for every critical decision
- **A3 90/10 Rule:** Tag SAFE/RADICAL, max 20% radical
- **A4 Pre-Mortem:** "How does this fail?" before declaring complete
- **A5 Lessons Permanent:** Every failure → written lesson

### Execution (E1-E4)
- **E1 Ship Reality:** Working code > perfect plans
- **E2 Protect Reputation:** Never ship broken
- **E3 Reduce Chaos:** Clear > clever
- **E4 Technical Excellence:** Zero tolerance for mediocre work

Full DNA template with all protocol formats: [dna-template.md](references/dna-template.md)