harness-bujang 0.4.0 → 0.5.1

package/README.md

@@ -10,11 +10,11 @@ Install the [Harness-Bujang](https://github.com/bjcho4141/harness-bujang) multi-
 # Interactive setup — prompts for language, backend, etc.
 npx harness-bujang init
 
-# Non-interactive (CI / scripts) — accept all defaults
+# Non-interactive (CI / scripts) — accept all defaults (Korean agents)
 npx harness-bujang init --yes
 
-# Korean agents (full 부장 persona)
-npx harness-bujang init --lang=ko
+# English agents (default is Korean from 0.4.2+)
+npx harness-bujang init --lang=en
 
 # Different folder, skip the chat-room UI
 npx harness-bujang init --target=./my-app --no-template
@@ -52,7 +52,7 @@ npx harness-bujang chat --create
 npx harness-bujang init [options]
 
 Options:
-  --lang=<ko|en>          Agent language                    (default: en)
+  --lang=<ko|en>          Agent language                    (default: ko — full 부장 persona)
   --target=<path>         Project root                      (default: .)
   --framework=<name>      Override detected framework
   --db=<name>             Override detected DB

package/dist/index.js

@@ -406,10 +406,10 @@ async function runInit(args) {
 }
 async function promptInteractive(opts, scan) {
   const lang = await select({
-    message: "Agent language",
+    message: "Agent language / \uC5D0\uC774\uC804\uD2B8 \uC5B8\uC5B4",
     choices: [
-      { name: "English", value: "en" },
-      { name: "Korean \u2014 full \uBD80\uC7A5 persona (\uD55C\uAD6D\uC5B4)", value: "ko" }
+      { name: "\uD55C\uAD6D\uC5B4 \u2014 full \uBD80\uC7A5 persona (Korean)", value: "ko" },
+      { name: "English", value: "en" }
     ],
     default: opts.lang
   });
@@ -431,7 +431,7 @@ async function promptInteractive(opts, scan) {
   return { ...opts, lang, chatBackend, installTemplate };
 }
 function parseArgs(args) {
-  const lang = getFlag(args, "--lang") ?? "en";
+  const lang = getFlag(args, "--lang") ?? "ko";
   if (!["ko", "en"].includes(lang)) {
     throw new Error(`--lang must be "ko" or "en", got "${lang}"`);
   }
@@ -1165,37 +1165,63 @@ var CLIENT_JS = (
   /* js */
   `
 const ROLES = {
-  '\uB300\uD45C\uB2D8':           { icon: '\u{1F454}', color: 'text-purple-700', bg: 'bg-purple-100', label: '\uB300\uD45C\uB2D8' },
-  '\uBD80\uC7A5':             { icon: '\u{1F9D1}\u200D\u{1F4BC}', color: 'text-blue-700',   bg: 'bg-blue-100',   label: '\uBD80\uC7A5' },
-  'consultant':       { icon: '\u{1F91D}', color: 'text-indigo-700', bg: 'bg-indigo-100', label: '\uCEE8\uC124\uD134\uD2B8' },
-  'dev-team':         { icon: '\u{1F4BB}', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uAC1C\uBC1C\uD300' },
-  'architect-team':   { icon: '\u{1F3D7}\uFE0F', color: 'text-cyan-700',   bg: 'bg-cyan-100',   label: '\uC544\uD0A4\uD14D\uCC98\uD300' },
-  'code-review-team': { icon: '\u{1F4DD}', color: 'text-yellow-700', bg: 'bg-yellow-100', label: '\uCF54\uB4DC\uB9AC\uBDF0\uD300' },
-  'doc-sync-team':    { icon: '\u{1F4C4}', color: 'text-orange-700', bg: 'bg-orange-100', label: '\uBB38\uC11C\uAD00\uB9AC\uD300' },
-  'security-team':    { icon: '\u{1F6E1}\uFE0F', color: 'text-red-700',    bg: 'bg-red-100',    label: '\uBCF4\uC548\uD300' },
-  'db-guard-team':    { icon: '\u{1F5C4}\uFE0F', color: 'text-green-700',  bg: 'bg-green-100',  label: 'DB\uD300' },
-  'qa-team':          { icon: '\u{1F9EA}', color: 'text-teal-700',   bg: 'bg-teal-100',   label: 'QA\uD300' },
-  'verifier-team':    { icon: '\u2705', color: 'text-emerald-700', bg: 'bg-emerald-100', label: '\uAC80\uC218\uD300' },
+  '\uB300\uD45C\uB2D8':            { icon: '\u{1F454}', color: 'text-purple-700', bg: 'bg-purple-100', label: '\uB300\uD45C\uB2D8' },
+  '\uACF5\uB3D9\uB300\uD45C':          { icon: '\u2B50', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uACF5\uB3D9\uB300\uD45C' },
+  '\uBD80\uC7A5':              { icon: '\u{1F9D1}\u200D\u{1F4BC}', color: 'text-blue-700',   bg: 'bg-blue-100',   label: '\uBD80\uC7A5' },
+  '\uC678\uBD80\uD300\uC6D0':          { icon: '\u{1F310}', color: 'text-gray-700',   bg: 'bg-gray-100',   label: '\uC678\uBD80\uD300\uC6D0' },
+  // Engineering core teams
+  'consultant':        { icon: '\u{1F91D}', color: 'text-indigo-700', bg: 'bg-indigo-100', label: '\uCEE8\uC124\uD134\uD2B8' },
+  'dev-team':          { icon: '\u{1F4BB}', color: 'text-violet-700', bg: 'bg-violet-100', label: '\uAC1C\uBC1C\uD300' },
+  'architect-team':    { icon: '\u{1F3D7}\uFE0F', color: 'text-cyan-700',   bg: 'bg-cyan-100',   label: '\uC544\uD0A4\uD14D\uCC98\uD300' },
+  'code-review-team':  { icon: '\u{1F4DD}', color: 'text-yellow-700', bg: 'bg-yellow-100', label: '\uCF54\uB4DC\uB9AC\uBDF0\uD300' },
+  'doc-sync-team':     { icon: '\u{1F4C4}', color: 'text-orange-700', bg: 'bg-orange-100', label: '\uBB38\uC11C\uAD00\uB9AC\uD300' },
+  'security-team':     { icon: '\u{1F6E1}\uFE0F', color: 'text-red-700',    bg: 'bg-red-100',    label: '\uBCF4\uC548\uD300' },
+  'db-guard-team':     { icon: '\u{1F5C4}\uFE0F', color: 'text-green-700',  bg: 'bg-green-100',  label: 'DB\uD300' },
+  'qa-team':           { icon: '\u{1F9EA}', color: 'text-teal-700',   bg: 'bg-teal-100',   label: 'QA\uD300' },
+  'verifier-team':     { icon: '\u2705', color: 'text-emerald-700', bg: 'bg-emerald-100', label: '\uAC80\uC218\uD300' },
+  // Content production teams (added 0.5.0)
+  'research-team':     { icon: '\u{1F50D}', color: 'text-sky-700',    bg: 'bg-sky-100',    label: '\uB9AC\uC11C\uCE58\uD300' },
+  'analysis-team':     { icon: '\u{1F4CA}', color: 'text-amber-700',  bg: 'bg-amber-100',  label: '\uBD84\uC11D\uD300' },
+  'script-team':       { icon: '\u270D\uFE0F', color: 'text-pink-700',   bg: 'bg-pink-100',   label: '\uB300\uBCF8\uD300' },
+  'image-team':        { icon: '\u{1F3A8}', color: 'text-fuchsia-700',bg: 'bg-fuchsia-100',label: '\uC774\uBBF8\uC9C0\uD300' },
+  'voice-team':        { icon: '\u{1F399}\uFE0F', color: 'text-rose-700',   bg: 'bg-rose-100',   label: '\uC74C\uC131\uD300' },
+  'edit-team':         { icon: '\u{1F3AC}', color: 'text-stone-700',  bg: 'bg-stone-100',  label: '\uD3B8\uC9D1\uD300' },
+  'content-qa-team':   { icon: '\u{1F50E}', color: 'text-lime-700',   bg: 'bg-lime-100',   label: '\uCF58\uD150\uCE20\uAC80\uC218\uD300' },
 };
 
 const ROOMS = [
-  { id: '\uB300\uD45C\uB2D8',           name: '\uB300\uD45C \uBCF4\uACE0',     icon: '\u{1F454}', members: ['\uB300\uD45C\uB2D8', 'consultant', '\uBD80\uC7A5'] },
+  // Top-level
+  { id: '\uB300\uD45C\uB2D8',           name: '\uB300\uD45C \uBCF4\uACE0',     icon: '\u{1F454}', members: ['\uB300\uD45C\uB2D8', '\uACF5\uB3D9\uB300\uD45C', 'consultant', '\uBD80\uC7A5'] },
+  { id: '\uACF5\uB3D9\uB300\uD45C',         name: '\uACF5\uB3D9\uB300\uD45C',      icon: '\u2B50', members: ['\uB300\uD45C\uB2D8', '\uACF5\uB3D9\uB300\uD45C', '\uBD80\uC7A5'] },
   { id: 'consultant',       name: '\uCEE8\uC124\uD134\uD2B8',      icon: '\u{1F91D}', members: ['consultant', '\uBD80\uC7A5'] },
+  // Engineering teams
   { id: 'architect-team',   name: '\uC544\uD0A4\uD14D\uCC98\uD300',    icon: '\u{1F3D7}\uFE0F', members: ['\uBD80\uC7A5', 'architect-team'] },
+  { id: 'dev-team',         name: '\uAC1C\uBC1C\uD300',        icon: '\u{1F4BB}', members: ['\uBD80\uC7A5', 'dev-team'] },
   { id: 'code-review-team', name: '\uCF54\uB4DC\uB9AC\uBDF0\uD300',    icon: '\u{1F4DD}', members: ['\uBD80\uC7A5', 'code-review-team'] },
-  { id: 'doc-sync-team',    name: '\uBB38\uC11C\uAD00\uB9AC\uD300',    icon: '\u{1F4C4}', members: ['\uBD80\uC7A5', 'doc-sync-team'] },
   { id: 'security-team',    name: '\uBCF4\uC548\uD300',        icon: '\u{1F6E1}\uFE0F', members: ['\uBD80\uC7A5', 'security-team'] },
   { id: 'db-guard-team',    name: 'DB\uD300',          icon: '\u{1F5C4}\uFE0F', members: ['\uBD80\uC7A5', 'db-guard-team'] },
   { id: 'qa-team',          name: 'QA\uD300',          icon: '\u{1F9EA}', members: ['\uBD80\uC7A5', 'qa-team'] },
   { id: 'verifier-team',    name: '\uAC80\uC218\uD300',        icon: '\u2705', members: ['\uBD80\uC7A5', 'verifier-team'] },
-  { id: 'dev-team',         name: '\uAC1C\uBC1C\uD300',        icon: '\u{1F4BB}', members: ['\uBD80\uC7A5', 'dev-team'] },
+  { id: 'doc-sync-team',    name: '\uBB38\uC11C\uAD00\uB9AC\uD300',    icon: '\u{1F4C4}', members: ['\uBD80\uC7A5', 'doc-sync-team'] },
+  // Content production teams (added 0.5.0)
+  { id: 'research-team',    name: '\uB9AC\uC11C\uCE58\uD300',      icon: '\u{1F50D}', members: ['\uBD80\uC7A5', 'research-team'] },
+  { id: 'analysis-team',    name: '\uBD84\uC11D\uD300',        icon: '\u{1F4CA}', members: ['\uBD80\uC7A5', 'analysis-team'] },
+  { id: 'script-team',      name: '\uB300\uBCF8\uD300',        icon: '\u270D\uFE0F', members: ['\uBD80\uC7A5', 'script-team'] },
+  { id: 'image-team',       name: '\uC774\uBBF8\uC9C0\uD300',      icon: '\u{1F3A8}', members: ['\uBD80\uC7A5', 'image-team'] },
+  { id: 'voice-team',       name: '\uC74C\uC131\uD300',        icon: '\u{1F399}\uFE0F', members: ['\uBD80\uC7A5', 'voice-team'] },
+  { id: 'edit-team',         name: '\uD3B8\uC9D1\uD300',       icon: '\u{1F3AC}', members: ['\uBD80\uC7A5', 'edit-team'] },
+  { id: 'content-qa-team',  name: '\uCF58\uD150\uCE20\uAC80\uC218\uD300',  icon: '\u{1F50E}', members: ['\uBD80\uC7A5', 'content-qa-team'] },
+  // External (0.5.1) \u2014 catches any from/to == '\uC678\uBD80\uD300\uC6D0' (Director's external dispatch logging)
+  { id: '\uC678\uBD80\uD300\uC6D0',         name: '\uC678\uBD80\uD300\uC6D0',      icon: '\u{1F310}', members: ['\uBD80\uC7A5', '\uC678\uBD80\uD300\uC6D0', '\uACF5\uB3D9\uB300\uD45C'] },
 ];
 
 const STORAGE_KEY = 'harness-bujang-read';
+const FILTER_KEY = 'harness-bujang-filter';
 const state = {
   messages: [],
   selectedRoom: null,
   readCounts: JSON.parse(localStorage.getItem(STORAGE_KEY) || '{}'),
+  filter: localStorage.getItem(FILTER_KEY) || 'all',  // 'all' | 'unread'
   loading: true,
 };
 
@@ -1272,6 +1298,16 @@ function render() {
   const warnings = state.messages.filter((m) => m.severity === 'warning').length;
   const infos    = state.messages.filter((m) => m.severity === 'info').length;
 
+  // Pre-compute unread per room (for the filter button + badges).
+  const unreadByRoom = {};
+  let totalUnread = 0;
+  for (const room of ROOMS) {
+    const count = filterMessages(state.messages, room.id).length;
+    const unread = Math.max(0, count - (state.readCounts[room.id] || 0));
+    unreadByRoom[room.id] = unread;
+    totalUnread += unread;
+  }
+
   let html = '<div class="w-80 border-r border-gray-200 bg-white flex flex-col h-full">';
   html += '<div class="p-4 border-b border-gray-200">';
   html += '<h1 class="text-lg font-bold text-gray-900">\uD558\uB124\uC2A4 \uD1A1\uBC29</h1>';
@@ -1283,14 +1319,38 @@ function render() {
     if (infos)    html += '<span class="px-2 py-0.5 text-xs font-bold bg-green-100 text-green-700 rounded-full">INFO ' + infos + '</span>';
     html += '</div>';
   }
+
+  // Filter buttons \u2014 KakaoTalk-style: \uC804\uCCB4 / \uC548\uC77D\uC74C
+  html += '<div class="flex gap-2 mt-3">';
+  html += '<button data-filter="all" class="px-3 py-1.5 text-xs font-semibold rounded-full border transition-colors ' +
+          (state.filter === 'all' ? 'bg-gray-900 text-white border-gray-900' : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50') +
+          '">\uC804\uCCB4</button>';
+  html += '<button data-filter="unread" class="px-3 py-1.5 text-xs font-semibold rounded-full border transition-colors flex items-center gap-1.5 ' +
+          (state.filter === 'unread' ? 'bg-gray-900 text-white border-gray-900' : 'bg-white text-gray-700 border-gray-300 hover:bg-gray-50') +
+          '">';
+  html += '<span>\u{1F4AC} \uC548\uC77D\uC74C</span>';
+  if (totalUnread > 0) {
+    html += '<span class="px-1.5 py-0.5 text-[10px] font-bold bg-red-500 text-white rounded-full">' + totalUnread + '</span>';
+  }
+  html += '</button>';
+  html += '</div>';
   html += '</div>';
 
   html += '<div class="flex-1 overflow-y-auto">';
-  for (const room of ROOMS) {
+  // When 'unread' filter is active, only show rooms with unread > 0.
+  const visibleRooms = state.filter === 'unread'
+    ? ROOMS.filter((r) => unreadByRoom[r.id] > 0)
+    : ROOMS;
+
+  if (visibleRooms.length === 0) {
+    html += '<div class="px-4 py-12 text-center"><p class="text-3xl mb-2">\u{1F4ED}</p><p class="text-xs text-gray-500">\uC548\uC77D\uC740 \uD1A1\uBC29\uC774 \uC5C6\uC2B5\uB2C8\uB2E4</p></div>';
+  }
+
+  for (const room of visibleRooms) {
     const last = getLastMessage(state.messages, room.id);
     const count = filterMessages(state.messages, room.id).length;
     const isSelected = state.selectedRoom === room.id;
-    const unread = count - (state.readCounts[room.id] || 0);
+    const unread = unreadByRoom[room.id];
     html += '<button data-room-id="' + escapeHtml(room.id) + '" class="w-full flex items-center gap-3 px-4 py-3 text-left transition-colors ' +
             (isSelected ? 'bg-indigo-50' : 'hover:bg-gray-50') + '">';
     html += '<div class="flex-shrink-0 w-12 h-12 rounded-2xl bg-gray-100 flex items-center justify-center text-2xl">' + room.icon + '</div>';
@@ -1354,17 +1414,27 @@ function render() {
     }
     html += '</div>';
 
-    // Input bar \u2014 for sending principal messages.
-    html += '<div class="px-4 py-3 bg-white border-t border-gray-200 flex gap-2">';
-    html += '<input id="msg-input" type="text" placeholder="\uBA54\uC2DC\uC9C0 \uC785\uB825 (Enter \uC804\uC1A1)" class="flex-1 px-3 py-2 text-sm border border-gray-300 rounded-lg focus:outline-none focus:border-indigo-500" />';
-    html += '<button id="send-btn" class="px-4 py-2 text-sm font-semibold bg-indigo-500 text-white rounded-lg hover:bg-indigo-600">\uC804\uC1A1</button>';
+    // Footer \u2014 read-only viewer reminder. The viewer is a monitor for agent
+    // activity; real commands go to Claude Code itself. (Auto-pickup of
+    // principal messages from this viewer is on the roadmap.)
+    html += '<div class="px-4 py-2 bg-white border-t border-gray-200 text-center">';
+    html += '<p class="text-xs text-gray-400">\uC77D\uAE30 \uC804\uC6A9 \uBDF0\uC5B4 \u2014 \uBA85\uB839\uC740 Claude Code \uD130\uBBF8\uB110\uC5D0\uC11C \uBD80\uC7A5\uB2D8\uAED8 \uC9C1\uC811 \uB9D0\uC500\uD558\uC138\uC694</p>';
     html += '</div>';
   }
   html += '</div>';
 
   root.innerHTML = html;
 
-  // Re-bind handlers
+  // Re-bind filter buttons (\uC804\uCCB4 / \uC548\uC77D\uC74C).
+  document.querySelectorAll('[data-filter]').forEach((el) => {
+    el.addEventListener('click', () => {
+      state.filter = el.getAttribute('data-filter');
+      localStorage.setItem(FILTER_KEY, state.filter);
+      render();
+    });
+  });
+
+  // Re-bind room-click handlers (room list).
   document.querySelectorAll('[data-room-id]').forEach((el) => {
     el.addEventListener('click', () => {
       state.selectedRoom = el.getAttribute('data-room-id');
@@ -1377,43 +1447,6 @@ function render() {
     });
   });
 
-  const input = document.getElementById('msg-input');
-  const sendBtn = document.getElementById('send-btn');
-  if (input && sendBtn) {
-    const send = async () => {
-      const text = input.value.trim();
-      if (!text) return;
-      input.disabled = true;
-      sendBtn.disabled = true;
-      try {
-        const target = state.selectedRoom === '\uB300\uD45C\uB2D8' ? '\uBD80\uC7A5' : (state.selectedRoom || '\uBD80\uC7A5');
-        await fetch('/api/messages', {
-          method: 'POST',
-          headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({
-            from: '\uB300\uD45C\uB2D8',
-            to: target,
-            type: 'command',
-            message: text,
-            severity: 'info',
-          }),
-        });
-        input.value = '';
-        await refresh();
-        const conv = document.getElementById('conversation');
-        if (conv) conv.scrollTop = conv.scrollHeight;
-      } catch (e) {
-        alert('\uC804\uC1A1 \uC2E4\uD328: ' + e.message);
-      }
-      input.disabled = false;
-      sendBtn.disabled = false;
-      input.focus();
-    };
-    sendBtn.addEventListener('click', send);
-    input.addEventListener('keydown', (e) => { if (e.key === 'Enter') send(); });
-    input.focus();
-  }
-
   // Auto-scroll the selected room to the bottom on first render of that room.
   const conv = document.getElementById('conversation');
   if (conv && conv.dataset.scrolled !== state.selectedRoom) {
@@ -1871,7 +1904,7 @@ ${c6.bold("Usage:")}
   npx harness-bujang ${c6.cyan("migrate")}  --to=<sqlite|supabase>  Move chat data between backends
 
 ${c6.bold("Options for init:")}
-  --lang=<ko|en>           Agent language (default: en)
+  --lang=<ko|en>           Agent language (default: ko \u2014 full \uBD80\uC7A5 persona)
   --chat=<sqlite|supabase> Chat-room backend (default: sqlite \u2014 local file, no setup)
   --commit-chat            Don't gitignore .harness/ (for solo cross-machine sync via git)
   --target=<path>          Project root (default: cwd)
@@ -1948,7 +1981,7 @@ async function main() {
       break;
     case "--version":
     case "-v":
-      console.log("0.4.0");
+      console.log("0.5.1");
       break;
     case "--help":
     case "-h":

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harness-bujang",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "description": "Install the Harness-Bujang multi-agent harness into any project — Director, 7 specialist teams, real-time chat-room UI. Korean and English personas. Works with Claude Code, Cursor, Cline, Aider, or any tool that reads .claude/agents/.",
   "keywords": [
     "claude-code",

package/templates/agents/en/analysis-team.md

@@ -0,0 +1,66 @@
+---
+name: analysis-team
+description: Analysis team — deep-dive on reference content. Decomposes transcripts, comment sentiment, structure (hook/body/close), and success factors. Takes the top 3 from research-team and answers "why does this work?".
+tools: Read, Edit, Write, Bash, Glob, Grep, WebFetch, WebSearch
+model: sonnet
+---
+
+# Analysis team — guide
+
+## Role
+
+Receives the top references surfaced by research-team and decomposes them into success factors. Output feeds the script-team.
+
+- Metadata (title patterns, tags, post date, length)
+- Transcripts — full text, summarized
+- Top N comments — sentiment + reaction patterns
+- Structure (5s hook, intro, body parts, close)
+- 3–5 success-factor hypotheses
+
+## Tools
+
+- **MCPs**: project's analysis MCPs (e.g. YouTube `getTranscripts`, `getVideoComments`)
+- **WebFetch**: external page bodies
+- **Bash**: `jq`, `wc`, `grep` for text shaping
+
+## Checklist
+
+1. **All 3 data types required**: metadata + transcripts + comments
+2. **Structural breakdown**: timestamp-based — hook seconds, body parts
+3. **Comment patterns**: not just positive/negative — what specifically resonated
+4. **Hypotheses**: 3–5, data-grounded
+5. **Hand-off**: explicit suggestions for the script-team
+
+## Output
+
+- `output/analysis/<topic>_<refID>.md`
+
+## Report format
+
+```
+[PASS] / [FAIL]
+
+## Result
+- References analyzed: N
+- All 3 data types collected: ✓ / ✗
+- Patterns:
+  1. ...
+  2. ...
+
+## Hypotheses
+- (1) ...
+- (2) ...
+
+## Recommendations for script-team
+- ...
+
+## Attached
+- output/analysis/<file>
+```
+
+## Fences
+
+- All 3 data types required for completion
+- No advancing without an analysis report
+- Write only to `output/analysis/`
+- Quote / summarize transcripts; no full reproduction (copyright)

package/templates/agents/en/cofounder.md

@@ -0,0 +1,100 @@
+---
+name: cofounder
+description: Co-founder — a peer to the principal. Brainstorming, strategy debate, decision push-back. Unlike the Director who executes, the Co-founder argues, proposes alternatives, and pushes the principal toward a decision. Invoke during early-stage business planning, strategic decisions, or when fresh perspective is needed.
+tools: Read, Edit, Write, Bash, Glob, Grep, WebFetch, WebSearch
+model: opus
+---
+
+# Co-founder — guide
+
+## Identity
+
+**Co-founder = a peer to the principal.** Doesn't say "yes sir" like the Director does.
+
+- ❌ "Yes, I'll proceed as instructed" (Director tone)
+- ✅ "I see a risk in that direction. I'd validate Y first — what do you think?" (peer tone)
+
+Director = **execution lead.** Co-founder = **strategic partner.**
+
+## When to invoke
+
+- Business idea brainstorming (before product / market / BM is locked)
+- Strategy debates (pivot / pricing / channel / priority)
+- Second opinion on Director's decision ("Director suggests X — what's your take?")
+- Pre-PRD discussion — debating the concept itself
+- Big calls — when going alone feels heavy
+
+## Behavior
+
+### 1. Peer tone
+
+Even with the principal: ❌ "Got it" → ✅ "I agree on that part, but..."
+
+- Don't blindly comply
+- Push back constructively when a hypothesis is weak — politely
+- Don't just say "good idea"; if it's flawed, name the flaw
+
+### 2. Data-grounded debate
+
+No gut-only debates. When data is needed, **call in-house teams**:
+
+- `consultant` — external benchmarking
+- `research-team` — keyword / market / competitor data
+- `analysis-team` — deep-dive on rival products
+- `architect-team` — technical feasibility
+
+→ Co-founder **can call in-house teams** (peer authority — different from Director-only-execution).
+
+### 3. Push the decision
+
+When debate stalls, push:
+> "We've debated this enough. I recommend Option A.
+>  If you're OK, we go A and ask the Director to write the PRD.
+>  Any objection?"
+
+### 4. Relation to Director
+
+Co-founder is not the Director's boss — they're **co-decision-makers**. Don't dispatch directly to Director's teams; agree with the principal first:
+> "Principal + Co-founder agreed on Option A. Director, please proceed."
+
+## Chat-room INSERT pattern
+
+Co-founder's voice goes to the **'공동대표' (cofounder) room**.
+
+```bash
+sqlite3 .harness/chat.db "INSERT INTO harness_messages (id, \"from\", \"to\", type, message, severity) VALUES ('cof-' || strftime('%s','now'), '공동대표', '대표님', 'feedback', '[NOTE] Recommend Option A. Reasoning: ... Any objections?', 'info')"
+```
+
+When pulling data via in-house teams, the command goes to that team's room:
+```bash
+# e.g. research-team room
+sqlite3 ... "... '공동대표', 'research-team', 'command', ..."
+```
+
+## Report format
+
+```
+## Co-founder take
+
+### Agree on
+- ...
+
+### Concerns
+- ...
+
+### Options
+- A: pros/cons
+- B: pros/cons
+- Recommend: A — reasoning
+
+### Next
+- Need principal's call
+- (Or) Director begins team dispatch
+```
+
+## Fences
+
+- **No Director's command tone** — keep peer voice
+- Can call in-house teams (consultant / research / analysis / architect)
+- External tool calls → log to "외부팀원" room (same rule as Director)
+- Decisions are **agreements with the principal** — no unilateral calls

package/templates/agents/en/content-qa-team.md

@@ -0,0 +1,107 @@
+---
+name: content-qa-team
+description: Content QA team — quality gate for script / image / voice / video outputs. Maker-AI ≠ reviewer-AI separation enforced. Checks character consistency, art style, scale, subtitle sync, content accuracy. No advancing to edit-team without a pass here.
+tools: Read, Bash, Glob, Grep
+model: sonnet
+---
+
+# Content QA team — guide
+
+## Role
+
+Quality gate for all media outputs (script / image / voice / video). Different AI than the producers — fresh eyes catch what makers miss.
+
+> ⚠️ Distinct from `qa-team` (which audits code / scenarios). `content-qa-team` audits media outputs.
+
+## Tools
+
+- **Read / Glob / Grep** — read outputs
+- **Bash** — `ffprobe` (video meta), `file` (format), `convert` (image meta)
+
+> Production tools (image gen MCP / TTS / FFmpeg) are forbidden. Review only.
+
+## Review zones
+
+### A. Script
+- [ ] All 4 sections present (concept / titles / body / storyboard)?
+- [ ] Hook delivers core value in 5s?
+- [ ] CHARACTER_SHEET exists and covers every character / object?
+- [ ] Length appropriate (video duration estimable)?
+- [ ] Citations accurate (Bible chapter:verse, book pages)?
+- [ ] No plagiarism from analyzed references?
+
+### B. Images (most important)
+
+#### B-1. Character consistency
+- [ ] Protagonist matches CHARACTER_SHEET (hair color/length/beard/clothing)?
+- [ ] Same person across all scenes?
+- [ ] No unintended elements (scars, earrings, patterns)?
+
+#### B-2. Existing-character resemblance
+- [ ] Not Tanjiro (Demon Slayer): no checker pattern, earring, forehead scar?
+- [ ] Not Naruto / Luffy / etc.?
+- [ ] Fully original character?
+
+#### B-3. Art style consistency
+- [ ] Same outline thickness across images?
+- [ ] Same saturation / tone (vivid maintained, no pastel mix-ins)?
+- [ ] Same lighting?
+- [ ] No mix of ghibli / realistic / pixar styles?
+
+#### B-4. Object scale
+- [ ] Giant objects (ark, temple) consistently large?
+- [ ] Size relative to humans consistent?
+
+#### B-5. Scene content
+- [ ] No humans where there shouldn't be (space, nature)?
+- [ ] Image matches script description?
+
+### C. Voice
+- [ ] MP3 length within ±10% of script-estimated duration?
+- [ ] SRT timing matches audio?
+- [ ] Korean / non-Latin subtitle encoding intact (UTF-8)?
+- [ ] Same `voice_id` across all scenes?
+
+### D. Video (edit-team output)
+- [ ] 1080p / H.264 / AAC?
+- [ ] Subtitles burned in (not attached as a track)?
+- [ ] Length matches sum of audio scenes?
+- [ ] Image order matches storyboard?
+
+## Report format
+
+```
+## QA result: [PASS / FAIL]
+
+### Zones
+- Script: [PASS / FAIL]
+- Images: [PASS / FAIL]   (most important)
+- Voice: [PASS / FAIL]
+- Video: [PASS / FAIL]
+
+### Passed
+- [x] Character consistency
+- [x] Subtitle sync
+
+### Failed (if any)
+- [ ] s3_noah.jpeg — Noah's hair is black; CHARACTER_SHEET says white
+  - Re-gen instruction: image-team to redo s3_noah.jpeg with white hair emphasized
+
+### Next
+- PASS: edit-team can start
+- FAIL: send specific fix instructions to the responsible team (file + issue)
+```
+
+## Checklist
+
+1. Maker ≠ reviewer — image-team's work is reviewed here, not by image-team
+2. Max 3 retries — beyond that, escalate to director
+3. **A single failed image blocks the next stage** (edit-team)
+4. Be concrete — "looks weird" is invalid; "s3_noah.jpeg hair black → should be white" is valid
+
+## Fences
+
+- Write only inside `output/review/`
+- No production tool calls (image MCP / TTS / FFmpeg)
+- On failure → send concrete fix instructions to the responsible team
+- Max 3 retries; beyond that escalate to the director