@walwal-harness/cli 6.1.6 → 7.1.1

package/bin/init.js

@@ -53,6 +53,9 @@ function resolveProjectRoot() {
 const PROJECT_ROOT = resolveProjectRoot();
 const HARNESS_DIR = path.join(PROJECT_ROOT, '.harness');
 const CLAUDE_SKILLS_DIR = path.join(PROJECT_ROOT, '.claude', 'skills');
+const CLAUDE_COMMANDS_DIR = path.join(PROJECT_ROOT, '.claude', 'commands');
+const CODEX_SKILLS_DIR = path.join(PROJECT_ROOT, '.codex', 'skills');
+const CODEX_COMMANDS_DIR = path.join(PROJECT_ROOT, '.codex', 'commands');
 
 // ─────────────────────────────────────────
 // Utility
@@ -86,10 +89,170 @@ function fileExists(p) {
   return fs.existsSync(p);
 }
 
+function deepMerge(base, override) {
+  if (!override || typeof override !== 'object' || Array.isArray(override)) return base;
+  const out = { ...(base || {}) };
+  for (const [key, value] of Object.entries(override)) {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+      out[key] = deepMerge(out[key] || {}, value);
+    } else {
+      out[key] = value;
+    }
+  }
+  return out;
+}
+
 function log(msg) {
   console.log(`[walwal-harness] ${msg}`);
 }
 
+function readClaudeSettings() {
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  if (!fileExists(settingsPath)) return {};
+  try {
+    return JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+  } catch (e) {
+    log('WARNING: Could not parse existing .claude/settings.json, creating new');
+    return {};
+  }
+}
+
+function writeClaudeSettings(settings) {
+  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
+  ensureDir(path.dirname(settingsPath));
+  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+}
+
+function mergeClaudePermissionAllow(settings, entries) {
+  if (!settings.permissions || typeof settings.permissions !== 'object') {
+    settings.permissions = {};
+  }
+  if (!Array.isArray(settings.permissions.allow)) {
+    settings.permissions.allow = [];
+  }
+
+  let changed = false;
+  for (const entry of entries) {
+    if (!settings.permissions.allow.includes(entry)) {
+      settings.permissions.allow.push(entry);
+      changed = true;
+    }
+  }
+  return changed;
+}
+
+const V7_REMOVED_CONVENTION_FILES = [
+  'conductor.md',
+  'coo-developer.md',
+  'dispatcher.md',
+  'documentationer.md',
+  'evaluator-architecture.md',
+  'evaluator-code-quality.md',
+  'evaluator-functional.md',
+  'evaluator-security.md',
+  'evaluator-visual.md',
+  'generator-backend.md',
+  'generator-designer.md',
+  'generator-devops.md',
+  'generator-frontend.md',
+  'meeting-manager.md',
+  'planner.md',
+  'service-ops.md',
+];
+
+const V7_REMOVED_GOTCHA_FILES = [
+  ...V7_REMOVED_CONVENTION_FILES,
+  'generator-backend-laravel.md',
+];
+
+const LEGACY_V7_FILE_OWNER = {
+  'conductor.md': 'ceo.md',
+  'dispatcher.md': 'ceo.md',
+  'coo-developer.md': 'coo.md',
+  'planner.md': 'coo.md',
+  'documentationer.md': 'coo.md',
+  'generator-frontend.md': 'cto.md',
+  'generator-backend.md': 'cto.md',
+  'generator-backend-laravel.md': 'cto.md',
+  'generator-devops.md': 'cto.md',
+  'evaluator-architecture.md': 'cto.md',
+  'generator-designer.md': 'cdo.md',
+  'evaluator-visual.md': 'cdo.md',
+  'evaluator-functional.md': 'cqo.md',
+  'evaluator-code-quality.md': 'cqo.md',
+  'evaluator-security.md': 'cqo.md',
+  'meeting-manager.md': 'ops.md',
+  'service-ops.md': 'ops.md',
+};
+
+function removeLegacyV7Files(dir, files) {
+  for (const file of files) {
+    const target = path.join(dir, file);
+    if (fs.existsSync(target)) {
+      fs.rmSync(target, { force: true });
+    }
+  }
+}
+
+function extractMarkdownEntryBlocks(md, prefix) {
+  const escapedPrefix = prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const re = new RegExp(
+    `^#{2,3}\\s+\\[(${escapedPrefix}-[A-Z0-9_-]+)\\][\\s\\S]*?(?=^#{2,3}\\s+\\[${escapedPrefix}-|$(?![\\s\\S]))`,
+    'gm',
+  );
+  const blocks = [];
+  let match;
+  while ((match = re.exec(md)) !== null) {
+    blocks.push({ id: match[1], body: match[0].trimEnd() });
+  }
+  return blocks;
+}
+
+function migrateLegacyRoleEntries(dir, files, kind) {
+  const prefix = kind === 'gotchas' ? 'G' : 'C';
+  const migrated = [];
+  const backupDir = path.join(HARNESS_DIR, 'archive', 'pre-v7-role-migration');
+  for (const file of files) {
+    const sourcePath = path.join(dir, file);
+    if (!fs.existsSync(sourcePath)) continue;
+
+    const content = fs.readFileSync(sourcePath, 'utf8');
+    const blocks = extractMarkdownEntryBlocks(content, prefix);
+    if (!blocks.length) continue;
+
+    const targetFile = LEGACY_V7_FILE_OWNER[file] || 'shared.md';
+    const targetPath = path.join(dir, targetFile);
+    const targetOriginal = fs.existsSync(targetPath) ? fs.readFileSync(targetPath, 'utf8') : '';
+    const targetIds = new Set(
+      kind === 'gotchas'
+        ? extractGotchaEntryIds(targetOriginal)
+        : extractConventionEntryIds(targetOriginal),
+    );
+    const appendBlocks = [];
+    for (const block of blocks) {
+      if (targetIds.has(block.id)) continue;
+      appendBlocks.push([
+        block.body,
+        '',
+        `- **Migration source**: ${kind}/${file}`,
+      ].join('\n'));
+      targetIds.add(block.id);
+    }
+    if (!appendBlocks.length) continue;
+
+    ensureDir(backupDir);
+    fs.writeFileSync(path.join(backupDir, `${kind}-${file}`), content);
+    const sep = targetOriginal.trim() ? '\n\n' : '';
+    fs.writeFileSync(targetPath, targetOriginal.replace(/\s*$/, '') + sep + appendBlocks.join('\n\n') + '\n');
+    migrated.push(`${file} → ${targetFile} (${appendBlocks.length})`);
+  }
+
+  if (migrated.length) {
+    log(`${kind} legacy role entries migrated: ${migrated.join(', ')}`);
+    log(`Legacy role migration backup: ${backupDir}`);
+  }
+}
+
 // ─────────────────────────────────────────
 // First-install migration — extract Convention/Gotcha-shaped sections from
 // existing CLAUDE.md / AGENTS.md into .harness/conventions and .harness/gotchas.
@@ -114,12 +277,15 @@ function migrateExistingDocs() {
 
   const scopeFor = (body) => {
     const b = body.toLowerCase();
-    if (/\b(backend|api|nestjs|controller|dto|service|msa|repository)\b/.test(b)) return 'generator-backend';
-    if (/\b(frontend|react|next\.?js|ui|component|tsx|tailwind|hook)\b/.test(b)) return 'generator-frontend';
-    if (/\b(planner|plan\.md|sprint|feature-list|api-contract)\b/.test(b)) return 'planner';
-    if (/\b(playwright|e2e|functional test)\b/.test(b)) return 'evaluator-functional';
-    if (/\b(visual|layout|screenshot|a11y|accessibility|responsive)\b/.test(b)) return 'evaluator-visual';
-    if (/\b(code quality|lint|tsc|architecture|typescript strict)\b/.test(b)) return 'evaluator-code-quality';
+    if (/\b(ceo|dispatcher|owner|goal|hot-?fix|mission)\b/.test(b)) return 'ceo';
+    if (/\b(coo|planning|research|hypothesis|backtest|reference)\b/.test(b)) return 'coo';
+    if (/\b(cdo|design|brand|ui|ux|mock|visual)\b/.test(b)) return 'cdo';
+    if (/\b(cto|architecture|backend|frontend|api|platform|account|devops|implementation)\b/.test(b)) return 'cto';
+    if (/\b(cqo|quality|regression|e2e|test|archive|memory|gotcha)\b/.test(b)) return 'cqo';
+    if (/\b(ops|operation|service|log|incident|deploy|launch)\b/.test(b)) return 'ops';
+    if (/\b(hiring|hire|recruit|hr-resource|worker)\b/.test(b)) return 'hiring';
+    if (/\b(resource-manager|resource manager|alias|keyword|wording)\b/.test(b)) return 'resource-manager';
+    if (/\b(brick-office|dashboard)\b/.test(b)) return 'brick-office';
     return 'shared';
   };
 
@@ -187,13 +353,12 @@ function migrateExistingDocs() {
         report.push(`[${id}] "${sec.title}" → conventions/${scope}.md  (from ${sourceRef})`);
       } else {
         const scope = scopeFor(sec.title + '\n' + body);
-        const agent = scope === 'shared' ? 'planner' : scope;  // default shared-gotchas to planner
         extractedGotcha.counter += 1;
         const id = `G-${String(extractedGotcha.counter).padStart(3, '0')}`;
-        const target = path.join(HARNESS_DIR, 'gotchas', `${agent}.md`);
+        const target = path.join(HARNESS_DIR, 'gotchas', `${scope}.md`);
         appendEntry(target, id, 'gotcha', sec.title, body, sourceRef);
-        extractedGotcha.byAgent[agent] = (extractedGotcha.byAgent[agent] || 0) + 1;
-        report.push(`[${id}] "${sec.title}" → gotchas/${agent}.md  (from ${sourceRef})`);
+        extractedGotcha.byAgent[scope] = (extractedGotcha.byAgent[scope] || 0) + 1;
+        report.push(`[${id}] "${sec.title}" → gotchas/${scope}.md  (from ${sourceRef})`);
       }
     }
   }
@@ -246,13 +411,40 @@ function scaffoldHarness() {
   ensureDir(path.join(HARNESS_DIR, 'archive'));
   ensureDir(path.join(HARNESS_DIR, 'gotchas'));
   ensureDir(path.join(HARNESS_DIR, 'conventions'));
+  ensureDir(path.join(HARNESS_DIR, 'documents'));
+  ensureDir(path.join(HARNESS_DIR, 'logs'));
+  ensureDir(path.join(HARNESS_DIR, 'memories'));
+  ensureDir(path.join(HARNESS_DIR, 'shared'));
+
+  migrateLegacyRoleEntries(path.join(HARNESS_DIR, 'conventions'), V7_REMOVED_CONVENTION_FILES, 'conventions');
+  migrateLegacyRoleEntries(path.join(HARNESS_DIR, 'gotchas'), V7_REMOVED_GOTCHA_FILES, 'gotchas');
+
+  removeLegacyV7Files(path.join(HARNESS_DIR, 'conventions'), V7_REMOVED_CONVENTION_FILES);
+  removeLegacyV7Files(path.join(HARNESS_DIR, 'gotchas'), V7_REMOVED_GOTCHA_FILES);
+
+  const hrResourceSrc = path.join(PKG_ROOT, 'HR-Resource');
+  const hrResourceDest = path.join(HARNESS_DIR, 'shared', 'HR-Resource');
+  if (fs.existsSync(hrResourceSrc) && (!fs.existsSync(hrResourceDest) || isForce)) {
+    copyDir(hrResourceSrc, hrResourceDest);
+    log('HR-Resource copied to .harness/shared/HR-Resource');
+  }
+
+  const rosterPath = path.join(HARNESS_DIR, 'shared', 'hr-roster.json');
+  if (!fileExists(rosterPath) || isForce) {
+    fs.writeFileSync(rosterPath, JSON.stringify({ hired: [] }, null, 2) + '\n');
+  }
+
+  const resourceIndexPath = path.join(HARNESS_DIR, 'shared', 'resource-index.json');
+  if (!fileExists(resourceIndexPath) || isForce) {
+    fs.writeFileSync(resourceIndexPath, JSON.stringify({ aliases: {}, keywords: {} }, null, 2) + '\n');
+  }
 
   // Copy gotchas — preserve any existing file that has accumulated entries.
   // Dispatcher appends `### [G-NNN] ...` entries directly; we must NEVER overwrite
   // a file that has such entries, or user learning history is lost.
   const gotchasSrc = path.join(PKG_ROOT, 'gotchas');
   if (fs.existsSync(gotchasSrc)) {
-    const ENTRY_PATTERN = /^### \[G-\d+\]/m;  // Gotcha entry heading
+    const ENTRY_PATTERN = /^### \[G-[A-Z0-9_-]+\]/m;  // Gotcha entry heading
     const CUSTOM_MARKER = '## Custom Gotchas'; // Legacy marker still supported
     const files = fs.readdirSync(gotchasSrc);
     for (const file of files) {
@@ -372,6 +564,7 @@ function scaffoldHarness() {
         // Preserve user customizations
         const userPreserve = {
           behavior: existing.behavior,
+          runtime: existing.runtime,
           'flow.pre_eval_gate.frontend_cwd': existing?.flow?.pre_eval_gate?.frontend_cwd,
           'flow.pre_eval_gate.backend_cwd': existing?.flow?.pre_eval_gate?.backend_cwd,
           'flow.pre_eval_gate.frontend_checks': existing?.flow?.pre_eval_gate?.frontend_checks,
@@ -382,6 +575,9 @@ function scaffoldHarness() {
         // Re-apply preserved user settings
         const merged = JSON.parse(fs.readFileSync(configDest, 'utf8'));
         if (userPreserve.behavior) merged.behavior = userPreserve.behavior;
+        if (userPreserve.runtime) {
+          merged.runtime = deepMerge(merged.runtime || {}, userPreserve.runtime);
+        }
         if (userPreserve['flow.pre_eval_gate.frontend_cwd']) {
           merged.flow.pre_eval_gate.frontend_cwd = userPreserve['flow.pre_eval_gate.frontend_cwd'];
         }
@@ -405,6 +601,8 @@ function scaffoldHarness() {
     }
   }
 
+  ensureHarnessEnv();
+
   // HARNESS.md — ALWAYS update
   const harnessMdSrc = path.join(PKG_ROOT, 'assets', 'templates', 'HARNESS.md');
   const harnessMdDest = path.join(HARNESS_DIR, 'HARNESS.md');
@@ -443,38 +641,57 @@ function scaffoldHarness() {
   log('.harness/ scaffolding complete');
 }
 
+function ensureHarnessEnv() {
+  const envPath = path.join(PROJECT_ROOT, '.env');
+  const marker = 'HARNESS_BASE_PORT';
+  const re = new RegExp(`^${marker}`, 'm');
+
+  let content = '';
+  if (fileExists(envPath)) {
+    content = fs.readFileSync(envPath, 'utf8');
+  }
+
+  if (re.test(content)) return;
+
+  const prefix = content && !content.endsWith('\n') ? '\n' : '';
+  const block = `${prefix}${content ? '\n' : ''}# Walwal Harness — CEO must agree on a {xx}000 base port with the Owner.\n# Set HARNESS_BASE_PORT before CXX agents allocate any service ports.\n# HARNESS_BASE_PORT=\n`;
+  fs.writeFileSync(envPath, content + block);
+  log('.env: HARNESS_BASE_PORT placeholder added — set value with Owner approval before starting services');
+}
+
 // ─────────────────────────────────────────
 // 2. Skills → .claude/skills/
 // ─────────────────────────────────────────
 function installSkills() {
-  log('Installing skills to .claude/skills/...');
+  log('Installing skills to .claude/skills/ and .codex/skills/...');
 
-  const skillsSrc = path.join(PKG_ROOT, 'skills');
-  if (!fs.existsSync(skillsSrc)) {
-    log('WARNING: skills/ directory not found in package');
-    return;
-  }
+  const hrSrc = path.join(PKG_ROOT, 'HR-Resource');
+  const destinations = [CLAUDE_SKILLS_DIR, CODEX_SKILLS_DIR];
 
-  // harness- 프리픽스 스킬 전체 삭제 후 재복사 — 잔류 방지
-  if (fs.existsSync(CLAUDE_SKILLS_DIR)) {
-    const existing = fs.readdirSync(CLAUDE_SKILLS_DIR, { withFileTypes: true });
+  for (const destRoot of destinations) {
+    ensureDir(destRoot);
+    const existing = fs.readdirSync(destRoot, { withFileTypes: true });
     for (const entry of existing) {
       if (entry.isDirectory() && entry.name.startsWith('harness-')) {
-        fs.rmSync(path.join(CLAUDE_SKILLS_DIR, entry.name), { recursive: true, force: true });
+        fs.rmSync(path.join(destRoot, entry.name), { recursive: true, force: true });
       }
     }
-    log('  Cleared existing harness-* skills');
   }
+  log('  Cleared existing harness-* skills');
 
-  const skills = fs.readdirSync(skillsSrc, { withFileTypes: true })
-    .filter(d => d.isDirectory())
-    .map(d => d.name);
+  const installSkillDir = (src, destName) => {
+    for (const destRoot of destinations) {
+      copyDir(src, path.join(destRoot, destName));
+    }
+    log(`  Installed: ${destName}`);
+  };
 
-  for (const skill of skills) {
-    const src = path.join(skillsSrc, skill);
-    const dest = path.join(CLAUDE_SKILLS_DIR, `harness-${skill}`);
-    copyDir(src, dest);
-    log(`  Installed: harness-${skill}`);
+  const coreHrSkills = ['ceo', 'coo', 'cdo', 'cto', 'cqo', 'ops', 'hiring', 'resource-manager', 'brick-office'];
+  if (fs.existsSync(hrSrc)) {
+    for (const skill of coreHrSkills) {
+      const src = path.join(hrSrc, skill);
+      if (fs.existsSync(src)) installSkillDir(src, `harness-${skill}`);
+    }
   }
 
   log('Skills installation complete');
@@ -520,7 +737,7 @@ function installScripts() {
 // 3a. Commands → .claude/commands/
 // ─────────────────────────────────────────
 function installCommands() {
-  log('Installing commands to .claude/commands/...');
+  log('Installing commands to .claude/commands/ and .codex/commands/...');
 
   const commandsSrc = path.join(PKG_ROOT, 'commands');
   if (!fs.existsSync(commandsSrc)) {
@@ -528,24 +745,26 @@ function installCommands() {
     return;
   }
 
-  const commandsDest = path.join(PROJECT_ROOT, '.claude', 'commands');
-  ensureDir(commandsDest);
+  const commandDests = [CLAUDE_COMMANDS_DIR, CODEX_COMMANDS_DIR];
+  commandDests.forEach(ensureDir);
 
   // Remove existing harness-* commands to prevent stale files
-  if (fs.existsSync(commandsDest)) {
+  for (const commandsDest of commandDests) {
     const existing = fs.readdirSync(commandsDest);
     for (const f of existing) {
-      if (f.startsWith('harness-')) {
+      if (f.startsWith('harness-') || ['goal.md', 'hot-fix.md', 'play-harness.md', 'release-harness.md', 'stop-harness.md', 'brick-office.md', 'hiring.md', 'resource-manager.md', 'ceo.md', 'coo.md', 'cdo.md', 'cto.md', 'cqo.md', 'ops.md'].includes(f)) {
         fs.unlinkSync(path.join(commandsDest, f));
       }
     }
-    log('  Cleared existing harness-* commands');
   }
+  log('  Cleared existing harness commands');
 
   // Copy all command files
   const files = fs.readdirSync(commandsSrc).filter(f => f.endsWith('.md'));
   for (const file of files) {
-    copyFile(path.join(commandsSrc, file), path.join(commandsDest, file));
+    for (const commandsDest of commandDests) {
+      copyFile(path.join(commandsSrc, file), path.join(commandsDest, file));
+    }
     log(`  Installed: /${file.replace('.md', '')}`);
   }
 
@@ -559,18 +778,10 @@ function installSessionHook() {
   log('Installing SessionStart hook...');
 
   const settingsDir = path.join(PROJECT_ROOT, '.claude');
-  const settingsFile = path.join(settingsDir, 'settings.json');
 
   ensureDir(settingsDir);
 
-  let settings = {};
-  if (fileExists(settingsFile)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
-    } catch (e) {
-      log('WARNING: Could not parse existing .claude/settings.json, creating new');
-    }
-  }
+  let settings = readClaudeSettings();
 
   // Ensure hooks.SessionStart array exists
   if (!settings.hooks) settings.hooks = {};
@@ -608,10 +819,10 @@ function installSessionHook() {
       matcher: '',
       hooks: [{ type: 'command', command: hookCmd }]
     });
-    fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+    writeClaudeSettings(settings);
     log('SessionStart hook installed in .claude/settings.json');
   } else if (migrated) {
-    fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+    writeClaudeSettings(settings);
     log('SessionStart hook migrated to matcher + hooks-array format');
   } else {
     log('SessionStart hook already installed');
@@ -625,18 +836,10 @@ function installStatusline() {
   log('Installing statusline...');
 
   const settingsDir = path.join(PROJECT_ROOT, '.claude');
-  const settingsFile = path.join(settingsDir, 'settings.json');
 
   ensureDir(settingsDir);
 
-  let settings = {};
-  if (fileExists(settingsFile)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
-    } catch (e) {
-      log('WARNING: Could not parse existing .claude/settings.json, creating new');
-    }
-  }
+  let settings = readClaudeSettings();
 
   // Check if statusLine is already configured
   if (settings.statusLine && settings.statusLine.command &&
@@ -651,7 +854,7 @@ function installStatusline() {
     refreshInterval: 3
   };
 
-  fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+  writeClaudeSettings(settings);
   log('Statusline installed — persistent status bar at terminal bottom');
 }
 
@@ -662,18 +865,10 @@ function installUserPromptSubmitHook() {
   log('Installing UserPromptSubmit hook (auto dispatcher routing)...');
 
   const settingsDir = path.join(PROJECT_ROOT, '.claude');
-  const settingsFile = path.join(settingsDir, 'settings.json');
 
   ensureDir(settingsDir);
 
-  let settings = {};
-  if (fileExists(settingsFile)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
-    } catch (e) {
-      log('WARNING: Could not parse existing .claude/settings.json, creating new');
-    }
-  }
+  let settings = readClaudeSettings();
 
   if (!settings.hooks) settings.hooks = {};
   if (!settings.hooks.UserPromptSubmit) settings.hooks.UserPromptSubmit = [];
@@ -699,7 +894,7 @@ function installUserPromptSubmitHook() {
       matcher: '',
       hooks: [{ type: 'command', command: hookCmd }]
     });
-    fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+    writeClaudeSettings(settings);
     log('UserPromptSubmit hook installed in .claude/settings.json');
     log('  → All prompts will be routed through harness-dispatcher');
     log('  → Opt-out per message: say "harness skip" or "without harness"');
@@ -716,18 +911,10 @@ function installStopHook() {
   log('Installing Stop hook (auto-chain conductor tick)...');
 
   const settingsDir = path.join(PROJECT_ROOT, '.claude');
-  const settingsFile = path.join(settingsDir, 'settings.json');
 
   ensureDir(settingsDir);
 
-  let settings = {};
-  if (fileExists(settingsFile)) {
-    try {
-      settings = JSON.parse(fs.readFileSync(settingsFile, 'utf8'));
-    } catch (e) {
-      log('WARNING: Could not parse existing .claude/settings.json, creating new');
-    }
-  }
+  let settings = readClaudeSettings();
 
   if (!settings.hooks) settings.hooks = {};
   if (!settings.hooks.Stop) settings.hooks.Stop = [];
@@ -752,7 +939,7 @@ function installStopHook() {
       matcher: '',
       hooks: [{ type: 'command', command: hookCmd }]
     });
-    fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+    writeClaudeSettings(settings);
     log('Stop hook installed in .claude/settings.json');
     log('  → Conductor 가 running 인 동안 turn 종료 시 자동으로 다음 tick 으로 연쇄');
     log('  → 비활성: .harness/config.json behavior.auto_chain_on_stop = false');
@@ -769,11 +956,7 @@ function installStopHook() {
 // 3d. Agent Teams env var
 // ─────────────────────────────────────────
 function installAgentTeamsEnv() {
-  const settingsPath = path.join(PROJECT_ROOT, '.claude', 'settings.json');
-  let settings = {};
-  if (fileExists(settingsPath)) {
-    try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch (e) {}
-  }
+  let settings = readClaudeSettings();
 
   let changed = false;
 
@@ -787,26 +970,24 @@ function installAgentTeamsEnv() {
     log('Agent Teams already enabled');
   }
 
-  // Add git worktree permission for parallel worker isolation
-  if (!settings.permissions) settings.permissions = {};
-  if (!settings.permissions.allow) settings.permissions.allow = [];
-  const worktreePerms = [
+  // Add Claude Code permissions required for harness-driven edits, scripts,
+  // and parallel worker isolation. Existing permissions are preserved.
+  const harnessPerms = [
+    'Bash(*)',
+    'Write(*)',
+    'Edit(*)',
+    'Read(*)',
+    'MultiEdit(*)',
     'Bash(git worktree *)',
     'Bash(git checkout *)',
     'Bash(git merge *)',
     'Bash(git branch *)'
   ];
-  for (const perm of worktreePerms) {
-    if (!settings.permissions.allow.includes(perm)) {
-      settings.permissions.allow.push(perm);
-      changed = true;
-    }
-  }
+  changed = mergeClaudePermissionAllow(settings, harnessPerms) || changed;
 
   if (changed) {
-    ensureDir(path.dirname(settingsPath));
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
-    log('Git worktree permissions added for parallel worker isolation');
+    writeClaudeSettings(settings);
+    log('Claude settings merged: harness permissions/env preserved with existing settings');
   }
 }
 
@@ -957,8 +1138,8 @@ function showHelp() {
 ╚══════════════════════════════════════╝
 
 Usage:
-  npx walwal-harness                       Initialize project for harness engineering
-  npx walwal-harness --force               Re-initialize (overwrites existing files)
+  npx walwal-harness init                  Initialize project for harness engineering
+  npx walwal-harness init --force          Re-initialize (overwrites existing harness files)
   npx walwal-harness migrate               Apply migration (always-on company mode)
   npx walwal-harness migrate --dry-run     Preview migration changes without applying
   npx walwal-harness verify                Verify install integrity
@@ -971,18 +1152,18 @@ Runtime (always-on company mode):
   - Owner 입력은 GOAL 모호성, escalation, 결과 보고에만 필요합니다.
 
 What it does:
-  1. Scaffolds .harness/ directory (actions, archive, gotchas, config)
-  2. Installs skills to .claude/skills/ (dispatcher, planner, generators, evaluators)
-  3. Copies helper scripts to scripts/
+  1. Scaffolds project-local .harness/ runtime state
+  2. Installs commands to .claude/commands/ and .codex/commands/
+  3. Installs CXX and harness skills to .claude/skills/ and .codex/skills/
+  4. Copies HR-Resource to .harness/shared/HR-Resource for hiring
   4. Registers SessionStart + UserPromptSubmit + Stop hooks
   5. Installs statusline (persistent 1-line status bar)
-  6. Creates AGENTS.md + CLAUDE.md symlink
+  6. Creates AGENTS.md + CLAUDE.md symlink when needed
 
 After init:
-  1. Restart Claude Code session (/exit → re-enter directory)
-  2. Say "하네스 엔지니어링 시작" or /harness-dispatcher
-  3. After GOAL intake, Conductor runs the company loop autonomously.
-  4. (선택) bash scripts/harness-wake-install.sh install . — 1시간마다 자동 wake.
+  1. Restart Claude/Codex session if command discovery needs refresh.
+  2. Use /goal or /hot-fix.
+  3. Internal agents must call hired agents/skills, not slash commands.
 `);
 }
 
@@ -1192,11 +1373,13 @@ function runMigrate(opts = {}) {
   const dryRun = opts.dryRun || false;
   const flags = detectMigrationNeeded();
   const gotchaMissingTotal = Object.values(flags.gotchaMissingEntries || {}).reduce((n, a) => n + a.length, 0);
+  const conventionMissingTotal = Object.values(flags.conventionMissingEntries || {}).reduce((n, a) => n + a.length, 0);
   if (
     !flags.progressV3toV4 &&
     !flags.configMissingCompanyMode &&
     (!flags.memoryMissingSystemEntries || flags.memoryMissingSystemEntries.length === 0) &&
     gotchaMissingTotal === 0 &&
+    conventionMissingTotal === 0 &&
     !flags.bundleVersionStale
   ) {
     console.log('');
@@ -1539,7 +1722,6 @@ function main() {
   console.log('╚══════════════════════════════════════════════════════════╝');
   console.log('  bash scripts/harness-dashboard-up.sh');
   console.log('  → http://localhost:3001 에서 .harness/ 상태 실시간 시각화');
-  console.log('  → 첫 실행 시 git sparse-checkout 으로 ~5MB 만 가져옵니다.');
   console.log('');
 
   console.log('');
@@ -1557,9 +1739,9 @@ function main() {
     log('╚═══════════════════════════════════════════════════════════╝');
   } else {
     log('Next steps:');
-    log('  1. Restart Claude Code session (/exit → re-enter directory)');
-    log('  2. Say "하네스 엔지니어링 시작" or /harness-dispatcher');
-    log('  3. 회사모드가 자동으로 병렬 실행합니다. 진행 여부를 묻지 않습니다.');
+    log('  1. Restart Claude/Codex if command discovery needs refresh.');
+    log('  2. Use /goal or /hot-fix.');
+    log('  3. Internal agents call hired agents/skills, not slash commands.');
   }
   console.log('');
 }

package/commands/goal.md

@@ -0,0 +1,25 @@
+---
+description: Set, revise, or extend a company mission goal.
+argument-hint: "<goal request>"
+---
+
+# /goal
+
+Route the Owner request to the installed `harness-ceo` agent/skill.
+
+Required flow:
+1. Create or update a mission under `.harness/documents/{mission_name}/`.
+2. Record CEO decisions in `.harness/documents/{mission_name}/ceo.md`.
+3. CEO decides whether brainstorming is needed or whether CXX questions can be issued immediately.
+4. CEO asks COO, CDO, CTO, and CQO only the questions needed for this goal.
+5. CXX roles must start in a fresh session context. Do not let the default model impersonate a missing worker.
+6. CXX roles must not directly execute specialist deliverables. They must use hired workers for research, planning, design, implementation, QA, ops checks, and documentation.
+7. If a required CXX or worker skill is missing, CEO must invoke the installed `harness-hiring` skill before assigning the work.
+8. CEO must require worker report paths under `.harness/documents/{mission_name}/workers/` before accepting CXX completion.
+9. Do not invoke internal roles through slash commands; commands are Owner entrypoints only.
+
+Owner request:
+
+```
+$ARGUMENTS
+```