harness-bujang 0.3.0 → 0.4.2

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
@@ -93,6 +93,48 @@ that any agent can pick up next time they read the chat.
 Requires the `sqlite3` command-line tool (preinstalled on macOS; `apt-get install
 sqlite3` on Ubuntu/WSL; sqlite-tools binaries on Windows).
 
+### `adapt`
+
+```
+npx harness-bujang adapt --to=<target> [options]
+
+Targets:
+  cursor    → .cursor/rules/bujang-*.mdc           (Cursor IDE)
+  cline     → .clinerules/bujang-*.md              (Cline)
+  aider     → CONVENTIONS.md + .aider.conf.yml     (Aider)
+  codex     → AGENTS.md                            (OpenAI Codex CLI / Copilot Coding Agent / Cody)
+  gemini    → GEMINI.md + .gemini/styleguide.md    (Antigravity / Gemini CLI / Code Assist)
+  all       → all of the above
+```
+
+Converts the canonical `.claude/agents/*.md` install into the file formats other
+editor / agent harness tools expect. The `.claude/agents/` directory remains the
+single source of truth — re-run `bujang adapt --to=<target>` after changes to
+keep adapters in sync.
+
+Examples:
+
+```bash
+npx harness-bujang adapt --to=cursor       # just Cursor
+npx harness-bujang adapt --to=cursor,aider # multiple
+npx harness-bujang adapt --to=all          # everything
+```
+
+Tools covered (5 adapter formats → 8+ tools):
+
+| Tool | File the adapter writes |
+|------|-------------------------|
+| Cursor IDE | `.cursor/rules/bujang-*.mdc` (with frontmatter) |
+| Cline | `.clinerules/bujang-*.md` |
+| Aider | `CONVENTIONS.md` + `.aider.conf.yml` (`read:`) |
+| OpenAI Codex CLI | `AGENTS.md` |
+| GitHub Copilot Coding Agent | `AGENTS.md` |
+| Sourcegraph Cody | `AGENTS.md` (recent versions) |
+| Google Antigravity | `GEMINI.md` (highest priority) + falls back to `AGENTS.md` |
+| Gemini CLI | `GEMINI.md` |
+| Gemini Code Assist (workspace) | `GEMINI.md` (precedence) + `.gemini/styleguide.md` |
+| Gemini Code Assist (GitHub PR review) | `.gemini/styleguide.md` |
+
 ## How the harness works once installed
 
 ```

package/dist/index.js

@@ -380,10 +380,13 @@ async function runInit(args) {
       printBackendInstructions(opts.chatBackend, opts.commitChat);
     } else {
       console.log(
-        `${c.yellow("\u26A0 Chat-room UI is Next.js only.")} ` + c.dim(`Skipping \u2014 your stack is detected as ${scan.framework}.`)
+        `${c.yellow("\u2139\uFE0E Chat-room UI (Next.js admin route) skipped")} ` + c.dim(`\u2014 your stack is detected as ${scan.framework}.`)
       );
       console.log(
-        c.dim("   (For non-Next.js stacks, use the agents only \u2014 chat-room support is on the roadmap.)")
+        `   ${c.dim("To use the chat room on this stack, run")} ${c.bold("bujang chat")} ${c.dim("\u2014 it serves the")}`
+      );
+      console.log(
+        `   ${c.dim("same KakaoTalk-style viewer at http://localhost:7777, no Next.js needed.")}`
       );
       console.log();
     }
@@ -394,15 +397,19 @@ async function runInit(args) {
   console.log(`   ${c.cyan("1.")} Open Claude Code in this project`);
   console.log(`   ${c.cyan("2.")} Run ${c.bold("/bujang-status")} (if the plugin is installed) or just`);
   console.log(`      ask ${c.bold('"Director, please add a hello-world endpoint"')}`);
-  console.log(`   ${c.cyan("3.")} Watch ${c.bold(context.ADMIN_HARNESS_ROUTE)} for live updates (after env setup)`);
+  if (scan.framework.startsWith("Next.js") && opts.installTemplate) {
+    console.log(`   ${c.cyan("3.")} Watch ${c.bold(context.ADMIN_HARNESS_ROUTE)} for live updates (after env setup)`);
+  } else {
+    console.log(`   ${c.cyan("3.")} Watch the chat room: ${c.bold("npx harness-bujang chat --create")} ${c.dim("\u2192 http://localhost:7777")}`);
+  }
   console.log();
 }
 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
   });
@@ -424,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}"`);
   }
@@ -855,11 +862,11 @@ async function upsertEnvVar(envFile, key, value) {
 }
 async function confirm2(message) {
   process.stdout.write(`${message} [y/N] `);
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     process.stdin.setEncoding("utf8");
     process.stdin.once("data", (chunk) => {
       const ans = chunk.toString().trim().toLowerCase();
-      resolve5(ans === "y" || ans === "yes");
+      resolve6(ans === "y" || ans === "yes");
       process.stdin.pause();
     });
   });
@@ -1002,7 +1009,7 @@ async function runChat(args) {
     res.writeHead(404);
     res.end("not found");
   });
-  await new Promise((resolve5) => server.listen(port, "127.0.0.1", resolve5));
+  await new Promise((resolve6) => server.listen(port, "127.0.0.1", resolve6));
   const url = `http://localhost:${port}`;
   console.log();
   console.log(c4.bold(c4.green("\u{1F7E2} \uD558\uB124\uC2A4 \uD1A1\uBC29 viewer")) + c4.dim(" \u2014 " + url));
@@ -1054,12 +1061,12 @@ async function findOpenPort(preferred) {
   throw new Error(`Could not find a free port in range ${preferred}-${preferred + 19}`);
 }
 function portIsFree(port) {
-  return new Promise((resolve5) => {
+  return new Promise((resolve6) => {
     const tester = http.createServer();
-    tester.once("error", () => resolve5(false));
+    tester.once("error", () => resolve6(false));
     tester.once("listening", () => {
       tester.close();
-      resolve5(true);
+      resolve6(true);
     });
     tester.listen(port, "127.0.0.1");
   });
@@ -1073,10 +1080,10 @@ function openBrowser(url) {
   }
 }
 function readBody(req) {
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const chunks = [];
     req.on("data", (chunk) => chunks.push(chunk));
-    req.on("end", () => resolve5(Buffer.concat(chunks).toString("utf8")));
+    req.on("end", () => resolve6(Buffer.concat(chunks).toString("utf8")));
     req.on("error", reject);
   });
 }
@@ -1347,17 +1354,18 @@ 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 room-click handlers (room list).
   document.querySelectorAll('[data-room-id]').forEach((el) => {
     el.addEventListener('click', () => {
       state.selectedRoom = el.getAttribute('data-room-id');
@@ -1370,43 +1378,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) {
@@ -1441,7 +1412,9 @@ setInterval(refresh, 2000);
 `
 );
 
-// src/index.ts
+// src/adapt.ts
+import * as fs6 from "fs/promises";
+import * as path6 from "path";
 var c5 = {
   bold: (s) => `\x1B[1m${s}\x1B[22m`,
   dim: (s) => `\x1B[2m${s}\x1B[22m`,
@@ -1450,18 +1423,419 @@ var c5 = {
   yellow: (s) => `\x1B[33m${s}\x1B[39m`,
   cyan: (s) => `\x1B[36m${s}\x1B[39m`
 };
+async function runAdapt(args) {
+  const opts = parseArgs4(args);
+  const agentsDir = path6.join(opts.target, ".claude/agents");
+  if (!await exists5(agentsDir)) {
+    console.log();
+    console.log(c5.red("\u2716 No .claude/agents/ directory found at " + agentsDir));
+    console.log();
+    console.log("  Run " + c5.bold("npx harness-bujang init") + " first to install the canonical agents,");
+    console.log("  then re-run this command to adapt them to your editor.");
+    console.log();
+    process.exitCode = 1;
+    return;
+  }
+  const agentFiles = await loadAgents(agentsDir);
+  if (agentFiles.length === 0) {
+    console.log();
+    console.log(c5.red("\u2716 .claude/agents/ exists but contains no .md files."));
+    console.log();
+    process.exitCode = 1;
+    return;
+  }
+  console.log();
+  console.log(c5.bold("\u{1F501} Harness-Bujang adapt"));
+  console.log(c5.dim(`   Target:    ${opts.target}`));
+  console.log(c5.dim(`   Agents:    ${agentFiles.length} files at .claude/agents/`));
+  console.log(c5.dim(`   Adapting:  ${opts.to.join(", ")}`));
+  console.log();
+  for (const target of opts.to) {
+    if (target === "cursor") await adaptCursor(opts.target, agentFiles, opts.yes);
+    if (target === "cline") await adaptCline(opts.target, agentFiles, opts.yes);
+    if (target === "aider") await adaptAider(opts.target, agentFiles, opts.yes);
+    if (target === "codex") await adaptCodex(opts.target, agentFiles, opts.yes);
+    if (target === "gemini") await adaptGemini(opts.target, agentFiles, opts.yes);
+  }
+  console.log(c5.bold(c5.green("\u2705 Done.")));
+  console.log();
+  console.log("Next:");
+  if (opts.to.includes("cursor")) {
+    console.log(`   ${c5.cyan("\u2022")} Cursor users: open the project \u2014 rules in ${c5.bold(".cursor/rules/")} are auto-loaded`);
+  }
+  if (opts.to.includes("cline")) {
+    console.log(`   ${c5.cyan("\u2022")} Cline users: rules in ${c5.bold(".clinerules/")} are auto-loaded by Cline`);
+  }
+  if (opts.to.includes("aider")) {
+    console.log(`   ${c5.cyan("\u2022")} Aider users: ${c5.bold("CONVENTIONS.md")} is loaded via ${c5.bold(".aider.conf.yml")} (read:)`);
+  }
+  if (opts.to.includes("codex")) {
+    console.log(`   ${c5.cyan("\u2022")} Codex / Copilot Coding Agent users: ${c5.bold("AGENTS.md")} at the project root is auto-loaded`);
+  }
+  if (opts.to.includes("gemini")) {
+    console.log(`   ${c5.cyan("\u2022")} Antigravity / Gemini CLI / Code Assist: ${c5.bold("GEMINI.md")} (highest precedence) + ${c5.bold(".gemini/styleguide.md")} (PR reviews)`);
+  }
+  console.log();
+  console.log(c5.dim("   When you change .claude/agents/ later, re-run this command to refresh."));
+  console.log();
+}
+async function adaptCursor(target, agents, overwrite) {
+  const dst = path6.join(target, ".cursor/rules");
+  await fs6.mkdir(dst, { recursive: true });
+  console.log(c5.bold("\u{1F4C2} Cursor \u2014 .cursor/rules/"));
+  for (const a of agents) {
+    const file = path6.join(dst, `bujang-${a.slug}.mdc`);
+    if (await exists5(file) && !overwrite) {
+      console.log(`   ${c5.yellow("\u26A0")}  bujang-${a.slug}.mdc ${c5.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+      continue;
+    }
+    const description = a.frontmatter.description || `Harness-Bujang ${a.slug}`;
+    const out = `---
+description: "Harness-Bujang ${a.slug}: ${escapeYamlString(description.replace(/\n/g, " ").slice(0, 240))}"
+alwaysApply: false
+---
+
+# Harness-Bujang \u2014 ${a.slug} role guide
+
+> Source of truth: \`.claude/agents/${a.slug}.md\` \u2014 re-run \`bujang adapt --to=cursor\` to sync.
+
+When the user request matches this role's domain (see description above), follow this guide as your primary system prompt for the response. Other rules under this directory describe sibling roles in the same harness.
+
+---
+
+` + a.body.trim() + `
+`;
+    await fs6.writeFile(file, out);
+    console.log(`   ${c5.green("\u2713")}  bujang-${a.slug}.mdc`);
+  }
+  console.log();
+}
+async function adaptCline(target, agents, overwrite) {
+  const dst = path6.join(target, ".clinerules");
+  await fs6.mkdir(dst, { recursive: true });
+  console.log(c5.bold("\u{1F4C2} Cline \u2014 .clinerules/"));
+  for (const a of agents) {
+    const file = path6.join(dst, `bujang-${a.slug}.md`);
+    if (await exists5(file) && !overwrite) {
+      console.log(`   ${c5.yellow("\u26A0")}  bujang-${a.slug}.md ${c5.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+      continue;
+    }
+    const description = a.frontmatter.description || "";
+    const out = `# Harness-Bujang \u2014 ${a.slug}
+
+` + (description ? `${description}
+
+` : "") + `> Source of truth: \`.claude/agents/${a.slug}.md\` \u2014 re-run \`bujang adapt --to=cline\` to sync.
+
+---
+
+` + a.body.trim() + `
+`;
+    await fs6.writeFile(file, out);
+    console.log(`   ${c5.green("\u2713")}  bujang-${a.slug}.md`);
+  }
+  console.log();
+}
+async function adaptAider(target, agents, overwrite) {
+  console.log(c5.bold("\u{1F4C2} Aider \u2014 CONVENTIONS.md + .aider.conf.yml"));
+  const conventionsPath = path6.join(target, "CONVENTIONS.md");
+  const conventionsExisted = await exists5(conventionsPath);
+  if (conventionsExisted && !overwrite) {
+    console.log(`   ${c5.yellow("\u26A0")}  CONVENTIONS.md ${c5.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+  } else {
+    let body = `# Project Conventions \u2014 Harness-Bujang
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=aider\` to sync.
+
+`;
+    body += `This file collects the multi-agent harness role guides into a single conventions file that Aider can load via \`.aider.conf.yml\`. Aider does not natively dispatch to subagents, so when the user's request matches a specific role's domain, internally adopt that role's instructions for the response.
+
+`;
+    body += `## Roles
+
+`;
+    for (const a of agents) {
+      const desc = a.frontmatter.description || "";
+      body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+    }
+    body += `
+---
+
+`;
+    for (const a of agents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    await fs6.writeFile(conventionsPath, body);
+    console.log(`   ${c5.green("\u2713")}  CONVENTIONS.md ${c5.dim(`(${agents.length} roles concatenated)`)}`);
+  }
+  const aiderConfPath = path6.join(target, ".aider.conf.yml");
+  const existing = await exists5(aiderConfPath) ? await fs6.readFile(aiderConfPath, "utf8") : "";
+  if (existing.includes("CONVENTIONS.md")) {
+    console.log(`   ${c5.dim("\u2022")}  .aider.conf.yml already references CONVENTIONS.md \u2014 left untouched`);
+  } else if (existing && !overwrite) {
+    console.log(`   ${c5.yellow("\u26A0")}  .aider.conf.yml exists and does NOT reference CONVENTIONS.md \u2014 skipped`);
+    console.log(`     ${c5.dim("Add manually:")}  read: CONVENTIONS.md`);
+  } else {
+    const out = existing ? existing.trimEnd() + `
+
+# Added by harness-bujang adapt
+read: CONVENTIONS.md
+` : `# Aider config \u2014 auto-loads Harness-Bujang conventions
+read: CONVENTIONS.md
+`;
+    await fs6.writeFile(aiderConfPath, out);
+    console.log(`   ${c5.green("\u2713")}  .aider.conf.yml ${c5.dim("(read: CONVENTIONS.md)")}`);
+  }
+  console.log();
+}
+async function adaptCodex(target, agents, overwrite) {
+  console.log(c5.bold("\u{1F4C2} Codex / Copilot Agent \u2014 AGENTS.md (project root)"));
+  const filePath = path6.join(target, "AGENTS.md");
+  if (await exists5(filePath) && !overwrite) {
+    console.log(`   ${c5.yellow("\u26A0")}  AGENTS.md ${c5.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+    console.log();
+    return;
+  }
+  let body = `# AGENTS.md \u2014 Harness-Bujang multi-agent harness
+
+`;
+  body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=codex\` to sync.
+
+`;
+  body += `This file follows the AGENTS.md convention adopted by OpenAI Codex CLI, GitHub Copilot Coding Agent, and several other agentic coding tools. It collects the harness role guides into a single document.
+
+`;
+  body += `When the user's request matches one of the role domains below, internally adopt that role's instructions for the response. If the request spans multiple domains, follow the **director** role's dispatch logic.
+
+`;
+  body += `## Roles
+
+`;
+  for (const a of agents) {
+    const desc = a.frontmatter.description || "";
+    body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+  }
+  body += `
+---
+
+`;
+  for (const a of agents) {
+    body += `## ${a.slug}
+
+`;
+    body += a.body.trim() + `
+
+---
+
+`;
+  }
+  await fs6.writeFile(filePath, body);
+  console.log(`   ${c5.green("\u2713")}  AGENTS.md ${c5.dim(`(${agents.length} roles concatenated, ${(body.length / 1024).toFixed(1)} KB)`)}`);
+  console.log();
+}
+async function adaptGemini(target, agents, overwrite) {
+  console.log(c5.bold("\u{1F4C2} Gemini / Antigravity \u2014 GEMINI.md + .gemini/styleguide.md"));
+  const geminiMdPath = path6.join(target, "GEMINI.md");
+  if (await exists5(geminiMdPath) && !overwrite) {
+    console.log(`   ${c5.yellow("\u26A0")}  GEMINI.md ${c5.dim("(exists, skipped \u2014 use --yes to overwrite)")}`);
+  } else {
+    let body = `# GEMINI.md \u2014 Harness-Bujang multi-agent harness
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=gemini\` to sync.
+
+`;
+    body += `This file is read by Google Antigravity (workspace highest priority), Gemini CLI, and Gemini Code Assist (workspace customization). It collects the harness role guides into a single document.
+
+`;
+    body += `When the user's request matches one of the role domains below, internally adopt that role's instructions for the response. If the request spans multiple domains, follow the **director** role's dispatch logic.
+
+`;
+    body += `## Roles
+
+`;
+    for (const a of agents) {
+      const desc = a.frontmatter.description || "";
+      body += `- **${a.slug}**${desc ? ` \u2014 ${desc.replace(/\n/g, " ").slice(0, 200)}` : ""}
+`;
+    }
+    body += `
+---
+
+`;
+    for (const a of agents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    await fs6.writeFile(geminiMdPath, body);
+    console.log(`   ${c5.green("\u2713")}  GEMINI.md ${c5.dim(`(${agents.length} roles concatenated, ${(body.length / 1024).toFixed(1)} KB)`)}`);
+  }
+  const styleguideDir = path6.join(target, ".gemini");
+  await fs6.mkdir(styleguideDir, { recursive: true });
+  const styleguidePath = path6.join(styleguideDir, "styleguide.md");
+  if (await exists5(styleguidePath) && !overwrite) {
+    console.log(`   ${c5.yellow("\u26A0")}  .gemini/styleguide.md ${c5.dim("(exists, skipped)")}`);
+  } else {
+    const reviewRoles = ["code-review-team", "security-team", "db-guard-team", "verifier-team"];
+    const reviewAgents = agents.filter((a) => reviewRoles.includes(a.slug));
+    let body = `# Code Review Style Guide \u2014 Harness-Bujang
+
+`;
+    body += `> Source of truth: \`.claude/agents/*.md\` \u2014 re-run \`bujang adapt --to=gemini\` to sync.
+
+`;
+    body += `This style guide is read by Gemini Code Assist for GitHub when reviewing PRs. It distills the review-relevant subset of the Harness-Bujang harness (code review, security, DB guard, verifier teams) into review criteria.
+
+`;
+    body += `When reviewing a PR, apply the following audit lenses in order:
+
+`;
+    for (const a of reviewAgents) {
+      body += `## ${a.slug}
+
+`;
+      body += a.body.trim() + `
+
+---
+
+`;
+    }
+    if (reviewAgents.length === 0) {
+      body += `_(No review-team agents found in .claude/agents/. Re-run init to install the canonical set.)_
+`;
+    }
+    await fs6.writeFile(styleguidePath, body);
+    console.log(`   ${c5.green("\u2713")}  .gemini/styleguide.md ${c5.dim(`(${reviewAgents.length} review roles)`)}`);
+  }
+  console.log();
+}
+async function loadAgents(agentsDir) {
+  const entries = await fs6.readdir(agentsDir);
+  const out = [];
+  for (const name of entries) {
+    if (!name.endsWith(".md")) continue;
+    const src = path6.join(agentsDir, name);
+    const raw = await fs6.readFile(src, "utf8");
+    const slug = name.replace(/\.md$/, "");
+    const { frontmatter, body } = splitFrontmatter(raw);
+    out.push({ slug, frontmatter, body, src });
+  }
+  out.sort((a, b) => {
+    if (a.slug === "director") return -1;
+    if (b.slug === "director") return 1;
+    return a.slug.localeCompare(b.slug);
+  });
+  return out;
+}
+function splitFrontmatter(raw) {
+  if (!raw.startsWith("---\n")) {
+    return { frontmatter: {}, body: raw };
+  }
+  const end = raw.indexOf("\n---\n", 4);
+  if (end < 0) {
+    return { frontmatter: {}, body: raw };
+  }
+  const fmRaw = raw.slice(4, end);
+  const body = raw.slice(end + 5);
+  const frontmatter = {};
+  const lines = fmRaw.split(/\r?\n/);
+  let currentKey = null;
+  for (const line of lines) {
+    const m = /^([a-zA-Z_-]+):\s?(.*)$/.exec(line);
+    if (m && m[1] && !line.startsWith(" ") && !line.startsWith("	")) {
+      currentKey = m[1];
+      frontmatter[currentKey] = m[2] ?? "";
+    } else if (currentKey && (line.startsWith(" ") || line.startsWith("	"))) {
+      frontmatter[currentKey] = (frontmatter[currentKey] ?? "") + " " + line.trim();
+    }
+  }
+  return { frontmatter, body };
+}
+function escapeYamlString(s) {
+  return s.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+function parseArgs4(args) {
+  const targetRaw = getFlag4(args, "--target") ?? ".";
+  const toRaw = getFlag4(args, "--to");
+  if (!toRaw) {
+    throw new Error(
+      `--to=<cursor|cline|aider|codex|gemini|all> is required. Examples:
+  bujang adapt --to=cursor
+  bujang adapt --to=codex             # AGENTS.md at project root
+  bujang adapt --to=gemini            # GEMINI.md + .gemini/styleguide.md
+  bujang adapt --to=cursor,aider      # multiple
+  bujang adapt --to=all               # cursor + cline + aider + codex + gemini`
+    );
+  }
+  const targets = toRaw === "all" ? ["cursor", "cline", "aider", "codex", "gemini"] : toRaw.split(",").map((t) => t.trim());
+  for (const t of targets) {
+    if (!["cursor", "cline", "aider", "codex", "gemini"].includes(t)) {
+      throw new Error(`Unknown adapter target "${t}" \u2014 expected one of: cursor, cline, aider, codex, gemini, all`);
+    }
+  }
+  return {
+    target: path6.resolve(targetRaw),
+    to: targets,
+    yes: args.includes("--yes") || args.includes("-y")
+  };
+}
+function getFlag4(args, name) {
+  for (const a of args) {
+    if (a.startsWith(`${name}=`)) return a.slice(name.length + 1);
+  }
+  const idx = args.indexOf(name);
+  if (idx >= 0 && idx + 1 < args.length && !args[idx + 1].startsWith("--")) {
+    return args[idx + 1];
+  }
+  return void 0;
+}
+async function exists5(p) {
+  try {
+    await fs6.access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/index.ts
+var c6 = {
+  bold: (s) => `\x1B[1m${s}\x1B[22m`,
+  dim: (s) => `\x1B[2m${s}\x1B[22m`,
+  green: (s) => `\x1B[32m${s}\x1B[39m`,
+  red: (s) => `\x1B[31m${s}\x1B[39m`,
+  yellow: (s) => `\x1B[33m${s}\x1B[39m`,
+  cyan: (s) => `\x1B[36m${s}\x1B[39m`
+};
 var HELP = `
-${c5.bold("harness-bujang")} \u2014 Korean-style multi-agent harness director for Claude Code
-${c5.dim("https://github.com/bjcho4141/harness-bujang")}
+${c6.bold("harness-bujang")} \u2014 Korean-style multi-agent harness director for Claude Code
+${c6.dim("https://github.com/bjcho4141/harness-bujang")}
 
-${c5.bold("Usage:")}
-  npx harness-bujang ${c5.cyan("init")}     [options]    Install the harness into a project
-  npx harness-bujang ${c5.cyan("status")}   [options]    Verify the harness install
-  npx harness-bujang ${c5.cyan("chat")}     [options]    Open the standalone chat-room viewer (any stack)
-  npx harness-bujang ${c5.cyan("migrate")}  --to=<sqlite|supabase>  Move chat data between backends
+${c6.bold("Usage:")}
+  npx harness-bujang ${c6.cyan("init")}     [options]    Install the harness into a project
+  npx harness-bujang ${c6.cyan("status")}   [options]    Verify the harness install
+  npx harness-bujang ${c6.cyan("chat")}     [options]    Open the standalone chat-room viewer (any stack)
+  npx harness-bujang ${c6.cyan("adapt")}    --to=<cursor|cline|aider|codex|gemini|all>  Convert .claude/agents/ for other tools
+  npx harness-bujang ${c6.cyan("migrate")}  --to=<sqlite|supabase>  Move chat data between backends
 
-${c5.bold("Options for init:")}
-  --lang=<ko|en>           Agent language (default: en)
+${c6.bold("Options for init:")}
+  --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)
@@ -1472,37 +1846,49 @@ ${c5.bold("Options for init:")}
   --no-learning-log        Skip learning log seed
   --yes, -y                Skip prompts and overwrite (non-interactive \u2014 for CI / scripts)
 
-${c5.dim("Run without --yes for an interactive setup (prompts for language, backend, etc.).")}
+${c6.dim("Run without --yes for an interactive setup (prompts for language, backend, etc.).")}
 
-${c5.bold("Options for chat:")}
+${c6.bold("Options for chat:")}
   --target=<path>          Project root (default: cwd)
   --port=<number>          Preferred port (default: 7777, falls forward if busy)
   --no-open                Don't auto-open the browser
   --create                 Create an empty chat DB + schema if none exists yet
 
-${c5.bold("Options for migrate:")}
+${c6.bold("Options for adapt:")}
+  --to=<cursor|cline|aider|codex|gemini|all>   Required \u2014 comma-separated list also OK
+  --target=<path>          Project root (default: cwd)
+  --yes, -y                Overwrite existing adapter files
+
+${c6.dim("Adapter targets:")}
+${c6.dim("  cursor  \u2192 .cursor/rules/bujang-*.mdc          (Cursor IDE)")}
+${c6.dim("  cline   \u2192 .clinerules/bujang-*.md             (Cline)")}
+${c6.dim("  aider   \u2192 CONVENTIONS.md + .aider.conf.yml    (Aider)")}
+${c6.dim("  codex   \u2192 AGENTS.md                           (Codex CLI / Copilot Coding Agent / Cody)")}
+${c6.dim("  gemini  \u2192 GEMINI.md + .gemini/styleguide.md   (Antigravity / Gemini CLI / Code Assist)")}
+
+${c6.bold("Options for migrate:")}
   --to=<sqlite|supabase>   Required \u2014 target backend
   --target=<path>          Project root (default: cwd)
   --yes, -y                Skip confirmation
 
-${c5.bold("Examples:")}
-  ${c5.dim("# Install Korean Bujang persona, SQLite chat (default \u2014 zero setup)")}
+${c6.bold("Examples:")}
+  ${c6.dim("# Install Korean Bujang persona, SQLite chat (default \u2014 zero setup)")}
   npx harness-bujang init --lang=ko
 
-  ${c5.dim("# Open the standalone chat-room \u2014 works on ANY stack (Next.js, Rails, Django, \u2026)")}
+  ${c6.dim("# Open the standalone chat-room \u2014 works on ANY stack (Next.js, Rails, Django, \u2026)")}
   npx harness-bujang chat
-  ${c5.dim("# \u2192 opens http://localhost:7777 in your browser")}
+  ${c6.dim("# \u2192 opens http://localhost:7777 in your browser")}
 
-  ${c5.dim("# Solo, multiple machines \u2014 sync chat history via git")}
+  ${c6.dim("# Solo, multiple machines \u2014 sync chat history via git")}
   npx harness-bujang init --commit-chat
 
-  ${c5.dim("# Production project with team sharing \u2014 Supabase backend")}
+  ${c6.dim("# Production project with team sharing \u2014 Supabase backend")}
   npx harness-bujang init --chat=supabase
 
-  ${c5.dim("# Started solo, now scaling up \u2014 promote to cloud")}
+  ${c6.dim("# Started solo, now scaling up \u2014 promote to cloud")}
   bujang migrate --to=supabase
 
-  ${c5.dim("# Going back to solo / archive \u2014 pull cloud data into local SQLite")}
+  ${c6.dim("# Going back to solo / archive \u2014 pull cloud data into local SQLite")}
   bujang migrate --to=sqlite
 `;
 async function main() {
@@ -1518,12 +1904,15 @@ async function main() {
     case "chat":
       await runChat(args.slice(1));
       break;
+    case "adapt":
+      await runAdapt(args.slice(1));
+      break;
     case "migrate":
       await runMigrate(args.slice(1));
       break;
     case "--version":
     case "-v":
-      console.log("0.3.0");
+      console.log("0.4.2");
       break;
     case "--help":
     case "-h":
@@ -1531,13 +1920,13 @@ async function main() {
       console.log(HELP);
       break;
     default:
-      console.error(c5.red(`Unknown command: ${command}`));
+      console.error(c6.red(`Unknown command: ${command}`));
       console.log(HELP);
       process.exit(1);
   }
 }
 main().catch((err) => {
-  console.error(c5.red(`
+  console.error(c6.red(`
 \u2716 ${err.message}`));
   if (process.env.DEBUG) console.error(err.stack);
   process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "harness-bujang",
-  "version": "0.3.0",
+  "version": "0.4.2",
   "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",