War Room

Một “startup org” AI — CEO/CTO/CPO/CMO/COO + team — chạy dưới dạng multi-agent, audit thẳng thắn một sản phẩm/codebase rồi hiện thực hoá thành một hệ thống ticket git-native (Jira nhẹ) với verdict launch-readiness, P0 blockers, critical path, Sprint 0 — sau đó thực thi các ticket an toàn, giá trị cao.

TL;DR — một câu

1 · Lý tưởng / Triết lý — 7 nguyên tắc

2 · Kiến trúc tổng thể — 4 lớp

Trigger → Nguồn sự thật (brain) → Orchestration → Sản phẩm trong repo đích.

A. TRIGGER  (công tắc)
   ~/.claude/skills/war-room/SKILL.md
   "war room" / "gọi war room" / "bật mode CTO"  → nạp phương pháp
        │ trỏ về
B. BRAIN  (nguồn sự thật dùng chung — /home/ubuntu/brain/warroom/)
   METHODOLOGY.md            phương pháp đầy đủ
   templates/war-room-workflow.js   orchestration 3 phase   ★ trái tim
   templates/materialize.mjs        result → board.json
   templates/build-board.mjs        board.json → BOARD.md
   templates/board.seed.json        scaffold board rỗng
        │ chạy qua tool Workflow
C. ORCHESTRATION  (multi-agent)
   Phase 1 C-Suite Audit  → 5 lead audit song song
   Phase 2 Team Deep-Dive → team nở P0/P1 thành spec
   Phase 3 Synthesize     → Chief-of-Staff gộp 1 board
   return { org, synthesis }
        │ materialize + render + commit
D. SẢN PHẨM  (trong repo đích — <repo>/warroom/)
   board.json   ← NGUỒN SỰ THẬT (org, readiness, tickets, deps…)
   BOARD.md     ← kanban người đọc (generated)
   README.md    ← cách hệ thống ticket hoạt động
   (versioned trong git → resume xuyên session)

3 · Tổ chức — C-suite + teams

Mặc định 5 lead, thêm/bớt theo domain (CISO cho bảo mật, CMO Y khoa, Head of Data cho ML…). Mỗi lead tự khai roster 3–5 vai trò chuyên môn khi audit.

4 · Logic vận hành — Workflow 3 phase

Script: war-room-workflow.js (JS thuần, chạy qua tool Workflow). Điền 2 hằng: CONTEXT (grounding) và LEADS (roster). Trả về { org, synthesis }.

LEADS ─ pipeline(mỗi lead độc lập, KHÔNG chờ nhau giữa 2 phase):

 Phase 1  C-SUITE AUDIT     agent(auditPrompt, schema=AUDIT_SCHEMA)
    → { role, team, roster[3-5], findings[4-8], tickets[5-10] }

 Phase 2  TEAM DEEP-DIVE    top ≤4 ticket P0/P1 của lead →
    parallel( agent(expandPrompt, schema=EXPANDED_SCHEMA) )
    → { approach, subtasks, acceptance, estimate, risks, crossTeamDeps }

        ────────── (barrier) ──────────

 Phase 3  SYNTHESIZE   agent(Chief-of-Staff, schema=SYNTH_SCHEMA, effort=high)
    gộp toàn bộ → { readiness{verdict,score,summary}, blockers[],
      criticalPath[], sprint0[], crossTeamDeps[],
      tickets[25-40 đã dedupe, id=<ROLE>-NNN] }

Điểm thiết kế của logic

• Pipeline, không barrier giữa Phase 1↔2: lead nào audit xong là team lead đó nở ticket ngay → tiết kiệm wall-clock.
• Chỉ nở top ≤4 P0/P1 mỗi lead: dồn công sức vào việc quan trọng, không phình.
• Barrier trước Synthesize: Chief-of-Staff cần TOÀN BỘ để dedupe & xếp critical path.
• Structured output (schema) ở mọi agent: không parse chuỗi → materialize được ngay.
• Synthesize chạy effort:'high': khâu khó nhất (gộp + xếp thứ tự + chấm điểm) cần nhiều suy luận.

5 · Mô hình dữ liệu

Ticket

{
  "id": "CTO-001",          // <ROLE>-NNN
  "title": "…",
  "role": "CTO", "team": "Engineering",
  "priority": "P0",         // P0 blocker · P1 trước launch · P2 fast-follow · P3 sau
  "effort": "M",            // S <½d · M ~1-2d · L ~1wk · XL nhiều tuần
  "area": "…",
  "status": "backlog",      // backlog → todo → in_progress → review → done
  "problem": "…",
  "acceptance": ["…"],      // tiêu chí nghiệm thu cụ thể, test được
  "deps": ["CTO-000"],      // id ticket khác (blocked = có dep chưa done)
  "comments": [],           // trao đổi liên-team sống ở đây
  "created": "YYYY-MM-DD"
}

board.json (nguồn sự thật): { meta, org[], readiness{verdict,score,summary}, blockers[], criticalPath[], sprint0[], crossTeamDeps[], tickets[] }

P0 chặn launchP1 trước public P2 fast-follow · P3 sau · Effort S/M/L/XL · id <ROLE>-NNN · giao tiếp liên-team trong comments[]

6 · Pipeline hiện thực hoá

kết quả Workflow { org, synthesis }
   │  node materialize.mjs <result.json> <repo>/warroom [YYYY-MM-DD]
   ▼
<repo>/warroom/board.json   (normalize role; status="backlog"; comments:[])
   │  node <repo>/warroom/build-board.mjs
   ▼
<repo>/warroom/BOARD.md      (readiness → blockers → critical path → Sprint 0 → bảng theo role)
   │  git add + commit
   ▼
Board sống — update status/comments → rebuild → commit → resume xuyên session

7 · Quy trình chạy — 5 bước

1. Scaffold warroom/ vào repo đích: copy templates/README.md, build-board.mjs, board.seed.json (điền org).
2. Dựng CONTEXT (grounding): sản phẩm là gì · stack/repo path · đã có gì · gap/rủi ro · chiến lược · live URL · ràng buộc cứng · mục tiêu. ← đòn bẩy chất lượng số 1.
3. Chạy workflow: điền CONTEXT + LEADS → Workflow({ script }).
4. Materialize: node materialize.mjs <result.json> <repo>/warroom → node <repo>/warroom/build-board.mjs → commit.
5. Present + execute: trình verdict + P0 blockers + critical path + Sprint 0; làm P0 an toàn trước, gắn cờ việc cần người quyết. Xong ticket → update status+comments → rebuild → commit.

8 · Resume / Status / Nâng cấp

• status: đọc warroom/BOARD.md → tóm tắt P0 đang mở + việc in_progress.
• resume: chọn ticket P0/P1 chưa bị chặn (mọi deps đã done) → làm → đánh done+comment → rebuild → commit → lặp. Workflow dừng giữa chừng resume được: Workflow({scriptPath, resumeFromRunId}).
• Nâng cấp: học được gì hay → sửa METHODOLOGY.md + template ở brain → mọi war-room sau kế thừa.

9 · Templates (mã nguồn)

10 · Bản đồ file

11 · Vì sao thiết kế như vậy

• File-based/git-native thay vì Jira/Notion? Không phụ thuộc dịch vụ ngoài, versioned, agent đọc/ghi trực tiếp, diff review được, sống xuyên session, free.
• Tách skill vs brain? Skill mỏng để trigger nhanh; brain dày để tái dùng & nâng cấp một chỗ. warroom/ trong repo là trạng thái riêng từng dự án.
• C-suite thay vì 1 agent to? Mỗi lens bắt loại lỗi khác nhau; song song → phủ rộng & nhanh; Chief-of-Staff mới là người gộp.
• Structured output khắp nơi? Để materialize deterministic — không parse chữ, không lỗi định dạng.
• Honesty rule lên hàng đầu? Giá trị audit nằm ở sự thật khó nghe; board đẹp nhưng bỏ qua lỗ hổng = nguy hiểm hơn không audit.

🤖 Cho agents — cách đọc doc này