@dusky-bluehour/agent-service 0.6.6 → 0.6.8

package/scripts/init.mjs

@@ -16,6 +16,21 @@ const CLI_NAME = 'tri-agent-manager';
 const STATE_DIR_NAME = '.tri-agent-manager';
 const LEGACY_STATE_DIR_NAME = '.tri-agent-os';
 const GUIDE_FILE_NAME = 'USAGE.ko.md';
+const PROJECT_RULE_MODE_VALUES = new Set(['always', 'if-instructions', 'if-present', 'never']);
+const PROJECT_RULE_BOOTSTRAP = {
+  'claude-code': {
+    sourceRelativePath: path.join('claude-code', 'instructions', 'CLAUDE.template.md'),
+    destinationRelativePath: 'CLAUDE.md'
+  },
+  codex: {
+    sourceRelativePath: path.join('codex', 'instructions', 'AGENTS.template.md'),
+    destinationRelativePath: 'AGENTS.md'
+  },
+  gemini: {
+    sourceRelativePath: path.join('gemini', 'instructions', 'GEMINI.template.md'),
+    destinationRelativePath: 'GEMINI.md'
+  }
+};
 
 const HELP_TEXT = [
   `${CLI_NAME} 사용법`,
@@ -24,8 +39,8 @@ const HELP_TEXT = [
   `  ${CLI_NAME} list`,
   `  ${CLI_NAME} setup   (install + interactive 별칭)`,
   `  ${CLI_NAME} wizard  (install + interactive 별칭)`,
-  `  ${CLI_NAME} install [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--force] [--dry-run] [--yes]`,
-  `  ${CLI_NAME} update  [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--dry-run] [--yes]`,
+  `  ${CLI_NAME} install [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--install-root <map>] [--project-rules <mode>] [--force] [--dry-run] [--yes]`,
+  `  ${CLI_NAME} update  [--preset <id>] [--tool <ids>] [--components <ids>] [--target <path>] [--install-root <map>] [--project-rules <mode>] [--dry-run] [--yes]`,
   `  ${CLI_NAME} init    (install의 별칭)`,
   '',
   '옵션:',
@@ -33,7 +48,8 @@ const HELP_TEXT = [
   '  --tool        도구 선택 (예: codex,claude-code) / all',
   '  --components  구성요소 선택 (예: skills,workflows,commands) / all',
   '  --target      설치 경로 (기본: .)',
-  '  --install-root 도구별 설치 루트 오버라이드 (예: codex=.codex,antigravity=.agent)',
+  '  --install-root 도구별 설치 루트 오버라이드 (예: codex=.codex,gemini=.gemini)',
+  '  --project-rules 프로젝트 규칙 파일 정책 (always|if-instructions|if-present|never)',
   '  --force       install 시 기존 파일 덮어쓰기',
   '  --dry-run     복사하지 않고 작업 계획만 출력',
   '  --yes         확인 프롬프트 생략',
@@ -41,11 +57,10 @@ const HELP_TEXT = [
   '  --non-interactive 비대화형 모드 강제',
   '  (중복 선택 입력은 자동으로 1회로 정리됨)',
   '',
-  'pnpm 예시:',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager --interactive',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager update --interactive',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager setup',
-  '  pnpm dlx --package=@dusky-bluehour/agent-service@latest tri-agent-manager list'
+  'npx 예시:',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager --interactive',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager update --interactive',
+  '  npx --yes --package @dusky-bluehour/agent-service tri-agent-manager list'
 ].join('\n');
 
 function parseArgs(argv) {
@@ -73,6 +88,7 @@ function parseArgs(argv) {
     componentFlag: getFlag('--components'),
     targetFlag: getFlag('--target') ?? '.',
     installRootFlag: getFlag('--install-root'),
+    projectRulesFlag: getFlag('--project-rules'),
     force: hasFlag('--force'),
     dryRun: hasFlag('--dry-run'),
     yes: hasFlag('--yes'),
@@ -207,6 +223,15 @@ function getComponentInstallPath(component) {
   return installPath || component.path;
 }
 
+function getComponentDescription(toolId, component) {
+  const base = component?.description ?? '';
+  if (component?.id !== 'instructions' || !PROJECT_RULE_BOOTSTRAP[toolId]) {
+    return base;
+  }
+  const suffix = '규칙 파일 정책: always | if-instructions | if-present | never';
+  return base ? `${base} (${suffix})` : suffix;
+}
+
 function normalizeInstallRoot(rawRoot, toolId) {
   const trimmed = String(rawRoot ?? '').trim();
   if (!trimmed) {
@@ -227,6 +252,57 @@ function normalizeInstallRoot(rawRoot, toolId) {
   return normalized.replace(/\/+$/, '');
 }
 
+function normalizeProjectRulesMode(rawMode) {
+  const mode = String(rawMode ?? '')
+    .trim()
+    .toLowerCase();
+
+  if (!mode) {
+    return 'always';
+  }
+
+  const alias = {
+    on: 'always',
+    all: 'always',
+    instructions: 'if-instructions',
+    selected: 'if-instructions',
+    present: 'if-present',
+    existing: 'if-present',
+    off: 'never',
+    none: 'never'
+  };
+
+  const normalized = alias[mode] ?? mode;
+  if (!PROJECT_RULE_MODE_VALUES.has(normalized)) {
+    throw new Error(
+      `--project-rules 값이 올바르지 않습니다: ${rawMode} (always|if-instructions|if-present|never)`
+    );
+  }
+
+  return normalized;
+}
+
+function describeProjectRulesMode(mode) {
+  switch (mode) {
+    case 'always':
+      return '항상 생성/업데이트';
+    case 'if-instructions':
+      return '`instructions` 구성요소를 선택한 경우에만 생성/업데이트';
+    case 'if-present':
+      return '대상 규칙 파일이 이미 존재할 때만 업데이트';
+    case 'never':
+      return '생성/업데이트하지 않음';
+    default:
+      return mode;
+  }
+}
+
+function resolveProjectRuleDestination(toolId, installRoot) {
+  const meta = PROJECT_RULE_BOOTSTRAP[toolId];
+  if (!meta) return null;
+  return meta.destinationRelativePath.replace('{installRoot}', installRoot || '');
+}
+
 function parseInstallRootFlag(installRootFlag, catalog) {
   if (!installRootFlag) {
     return {};
@@ -240,7 +316,7 @@ function parseInstallRootFlag(installRootFlag, catalog) {
     const idx = token.indexOf('=');
     if (idx <= 0 || idx === token.length - 1) {
       throw new Error(
-        `--install-root 형식이 올바르지 않습니다: ${token} (예: codex=.codex,antigravity=.agent)`
+        `--install-root 형식이 올바르지 않습니다: ${token} (예: codex=.codex,gemini=.gemini)`
       );
     }
 
@@ -399,11 +475,7 @@ async function loadToolWorkflowSummary(tool, selection) {
 function getToolExecutionGuide(tool, installRoot) {
   if (tool.id === 'codex') {
     return [
-      `프로젝트 루트에 \`AGENTS.md\`를 만들고 \`${path.join(
-        installRoot,
-        'instructions',
-        'AGENTS.template.md'
-      )}\`를 기반으로 팀 규칙을 확정합니다.`,
+      '프로젝트 루트의 `AGENTS.md`(자동 생성됨)를 열고 팀 규칙으로 보완합니다.',
       `\`${path.join(
         installRoot,
         'workflows',
@@ -415,6 +487,7 @@ function getToolExecutionGuide(tool, installRoot) {
 
   if (tool.id === 'claude-code') {
     return [
+      '프로젝트 루트의 `CLAUDE.md`(자동 생성됨)를 열고 팀 컨텍스트를 채웁니다.',
       `\`${path.join(
         installRoot,
         'workflows',
@@ -428,8 +501,9 @@ function getToolExecutionGuide(tool, installRoot) {
     ];
   }
 
-  if (tool.id === 'antigravity') {
+  if (tool.id === 'gemini') {
     return [
+      '`GEMINI.md`(자동 생성됨)를 열고 운영 규칙을 확정합니다.',
       `\`${path.join(
         installRoot,
         'workflows',
@@ -454,6 +528,7 @@ function getToolExecutionGuide(tool, installRoot) {
 function getToolInteractionTips(tool, installRoot) {
   if (tool.id === 'codex') {
     return [
+      '프로젝트 루트의 `AGENTS.md`를 팀 규칙 단일 진입점으로 유지하세요.',
       'Codex 대화 입력창에서 `$`를 누르면 사용 가능한 스킬 목록을 바로 열 수 있습니다.',
       `프로젝트 루트에서 스킬 파일을 직접 확인하려면 \`ls ${path.join(
         installRoot,
@@ -469,6 +544,7 @@ function getToolInteractionTips(tool, installRoot) {
 
   if (tool.id === 'claude-code') {
     return [
+      '프로젝트 루트 `CLAUDE.md`를 최신 상태로 유지하면 세션마다 동일한 기준으로 동작합니다.',
       `서브에이전트 이름은 \`${path.join(installRoot, 'agents')}\` 경로의 파일명 기준입니다.`,
       `프로젝트 루트에서 \`ls ${path.join(
         installRoot,
@@ -478,8 +554,9 @@ function getToolInteractionTips(tool, installRoot) {
     ];
   }
 
-  if (tool.id === 'antigravity') {
+  if (tool.id === 'gemini') {
     return [
+      '`GEMINI.md`를 Manager 단계의 승인 규칙 문서로 사용하세요.',
       `워크플로우 선택은 \`${path.join(
         installRoot,
         'workflows',
@@ -520,6 +597,11 @@ async function writeUsageGuide({ catalog, selection, targetDir, mode }) {
   lines.push(`- 생성 시각: ${new Date().toISOString()}`);
   lines.push(`- 모드: ${mode}`);
   lines.push(`- 프리셋: ${selection.presetId ?? '수동/없음'}`);
+  lines.push(
+    `- 프로젝트 규칙 파일 정책: ${selection.projectRulesMode} (${describeProjectRulesMode(
+      selection.projectRulesMode
+    )})`
+  );
   lines.push(`- 대상 경로: ${targetDir}`);
   lines.push('');
   lines.push('이 문서는 현재 설치 선택값 기준으로 생성되었습니다.');
@@ -538,6 +620,10 @@ async function writeUsageGuide({ catalog, selection, targetDir, mode }) {
     lines.push(`## ${tool.title} (${tool.id})`);
     lines.push('');
     lines.push(`- 설치 루트: \`${path.join(targetDir, installRoot)}\``);
+    const projectRuleDestination = resolveProjectRuleDestination(tool.id, installRoot);
+    if (projectRuleDestination) {
+      lines.push(`- 프로젝트 규칙 파일: \`${path.join(targetDir, projectRuleDestination)}\``);
+    }
     if (tool.install_root_basis) {
       lines.push(`- 경로 기준: ${tool.install_root_basis}`);
     }
@@ -650,11 +736,11 @@ function resolveComponentsFromFlag(componentFlag, tool, mode) {
 }
 
 function clearTuiScreen() {
-  output.write('\x1Bc');
+  output.write('\x1B[2J\x1B[H');
 }
 
 function formatTuiLine(prefix, label, selected = false) {
-  const marker = selected ? '✅' : '⬜';
+  const marker = selected ? '\x1B[32m[x]\x1B[0m' : '[ ]';
   return `${prefix} ${marker} ${label}`;
 }
 
@@ -700,7 +786,7 @@ async function runSingleSelectMenu({ title, help, options, defaultIndex = 0 }) {
   while (true) {
     renderTuiHeader(title, help);
     options.forEach((option, index) => {
-      const pointer = index === cursor ? '👉' : '  ';
+      const pointer = index === cursor ? '◉' : '○';
       output.write(`${pointer} ${option.label}\n`);
       if (option.description) {
         output.write(`    ${option.description}\n`);
@@ -739,8 +825,8 @@ async function runMultiSelectMenu({
   const selected = new Set(preselectedIds);
   const optionRows = [
     ...choices.map((choice) => ({ kind: 'choice', ...choice })),
-    { kind: 'action', action: 'toggle-all', label: '🧩 전체 선택/해제' },
-    { kind: 'action', action: 'done', label: '🚀 선택 완료' }
+    { kind: 'action', action: 'toggle-all', label: '[*] 전체 선택/해제' },
+    { kind: 'action', action: 'done', label: '[>] 선택 완료' }
   ];
   let cursor = 0;
   let notice = '';
@@ -754,7 +840,7 @@ async function runMultiSelectMenu({
     output.write('\n');
 
     optionRows.forEach((row, index) => {
-      const pointer = index === cursor ? '👉' : '  ';
+      const pointer = index === cursor ? '◉' : '○';
       if (row.kind === 'choice') {
         output.write(`${formatTuiLine(pointer, row.label, selected.has(row.id))}\n`);
         if (row.description) {
@@ -823,7 +909,8 @@ async function promptInteractiveTui({
   mode,
   defaultTarget,
   presetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   readline.emitKeypressEvents(input);
   const wasRawMode = Boolean(input.isRaw);
@@ -856,6 +943,9 @@ async function promptInteractiveTui({
 
     const targetDir = path.resolve(process.cwd(), targetInput);
     const state = await readState(targetDir);
+    const defaultProjectRulesMode = normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? (mode === 'update' ? state?.project_rules_mode : 'always')
+    );
     const presets = Array.isArray(catalog.presets) ? catalog.presets : [];
 
     const defaultPresetId =
@@ -938,7 +1028,7 @@ async function promptInteractiveTui({
         choices: tool.components.map((component) => ({
           id: component.id,
           label: `${component.title} (${component.id})`,
-          description: component.description
+          description: getComponentDescription(tool.id, component)
         })),
         preselectedIds: defaultComponents,
         minSelected: 1
@@ -953,12 +1043,47 @@ async function promptInteractiveTui({
       cliOverrides: installRootOverridesFromFlag
     });
 
+    let projectRulesMode = defaultProjectRulesMode;
+    if (!projectRulesModeFromFlag) {
+      const modeOption = await runSingleSelectMenu({
+        title: '🧭 프로젝트 규칙 파일 정책',
+        help: '조작: 위/아래/좌/우 이동, Enter 선택, q 종료',
+        options: [
+          {
+            id: 'always',
+            label: '🟢 always',
+            description: describeProjectRulesMode('always')
+          },
+          {
+            id: 'if-instructions',
+            label: '🟡 if-instructions',
+            description: describeProjectRulesMode('if-instructions')
+          },
+          {
+            id: 'if-present',
+            label: '🔵 if-present',
+            description: describeProjectRulesMode('if-present')
+          },
+          {
+            id: 'never',
+            label: '⚪ never',
+            description: describeProjectRulesMode('never')
+          }
+        ],
+        defaultIndex: ['always', 'if-instructions', 'if-present', 'never'].indexOf(
+          defaultProjectRulesMode
+        )
+      });
+      projectRulesMode = normalizeProjectRulesMode(modeOption.id);
+    }
+
     return {
       targetDir,
       selectedToolIds,
       componentSelection,
       presetId: selectedPreset?.id ?? null,
-      installRootOverrides
+      installRootOverrides,
+      projectRulesMode
     };
   } finally {
     setRawMode(wasRawMode);
@@ -971,7 +1096,8 @@ async function promptInteractiveText({
   mode,
   defaultTarget,
   presetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   const rl = createInterface({ input, output });
 
@@ -1006,6 +1132,9 @@ async function promptInteractiveText({
     }
     const targetDir = path.resolve(process.cwd(), targetInput);
     const state = await readState(targetDir);
+    const defaultProjectRulesMode = normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? (mode === 'update' ? state?.project_rules_mode : 'always')
+    );
 
     const presets = Array.isArray(catalog.presets) ? catalog.presets : [];
     let selectedPreset = findPreset(catalog, presetFlag);
@@ -1059,7 +1188,7 @@ async function promptInteractiveText({
       console.log(`📦 [${tool.title}] 구성요소 목록`);
       tool.components.forEach((component, index) => {
         console.log(`${index + 1}. ${component.title} (${component.id})`);
-        console.log(`   - ${component.description}`);
+        console.log(`   - ${getComponentDescription(tool.id, component)}`);
       });
 
       let defaultComponents = tool.components.map((c) => c.id);
@@ -1094,12 +1223,32 @@ async function promptInteractiveText({
       cliOverrides: installRootOverridesFromFlag
     });
 
+    let projectRulesMode = defaultProjectRulesMode;
+    if (!projectRulesModeFromFlag) {
+      console.log('');
+      console.log('🧭 프로젝트 규칙 파일 정책');
+      console.log(`1. always           - ${describeProjectRulesMode('always')}`);
+      console.log(`2. if-instructions  - ${describeProjectRulesMode('if-instructions')}`);
+      console.log(`3. if-present       - ${describeProjectRulesMode('if-present')}`);
+      console.log(`4. never            - ${describeProjectRulesMode('never')}`);
+      const modeAnswer = await ask('정책을 선택하세요. (번호/ID)', defaultProjectRulesMode);
+      const normalizedModeAnswer = modeAnswer.trim().toLowerCase();
+      const modeByNumber = {
+        '1': 'always',
+        '2': 'if-instructions',
+        '3': 'if-present',
+        '4': 'never'
+      };
+      projectRulesMode = normalizeProjectRulesMode(modeByNumber[normalizedModeAnswer] ?? modeAnswer);
+    }
+
     return {
       targetDir,
       selectedToolIds,
       componentSelection,
       presetId: selectedPreset?.id ?? null,
-      installRootOverrides
+      installRootOverrides,
+      projectRulesMode
     };
   } finally {
     rl.close();
@@ -1120,7 +1269,8 @@ function buildSelectionFromFlags({
   toolFlag,
   componentFlag,
   targetFlag,
-  installRootOverridesFromFlag
+  installRootOverridesFromFlag,
+  projectRulesModeFromFlag
 }) {
   const preset = findPreset(catalog, presetFlag);
   const presetToolIds = resolveToolsFromPreset(preset, catalog);
@@ -1163,7 +1313,8 @@ function buildSelectionFromFlags({
     selectedToolIds,
     componentSelection,
     presetId: preset?.id ?? null,
-    installRootOverrides
+    installRootOverrides,
+    projectRulesMode: normalizeProjectRulesMode(projectRulesModeFromFlag ?? 'always')
   };
 }
 
@@ -1189,6 +1340,54 @@ async function copyEntry(srcPath, destPath, { overwrite, dryRun }) {
   return { status: destExists ? 'overwritten' : 'copied' };
 }
 
+async function copyProjectRuleBootstrap({
+  toolId,
+  targetDir,
+  installRoot,
+  overwrite,
+  dryRun,
+  selectedComponentIds,
+  projectRulesMode
+}) {
+  const ruleMeta = PROJECT_RULE_BOOTSTRAP[toolId];
+  if (!ruleMeta) {
+    return null;
+  }
+
+  const normalizedMode = normalizeProjectRulesMode(projectRulesMode ?? 'always');
+  if (normalizedMode === 'never') {
+    return null;
+  }
+
+  const componentIds = new Set(selectedComponentIds ?? []);
+  if (normalizedMode === 'if-instructions' && !componentIds.has('instructions')) {
+    return null;
+  }
+
+  const srcPath = path.join(rootDir, ruleMeta.sourceRelativePath);
+  if (!(await exists(srcPath))) {
+    throw new Error(`[${toolId}] 프로젝트 규칙 템플릿 누락: ${ruleMeta.sourceRelativePath}`);
+  }
+
+  const destinationRelativePath = ruleMeta.destinationRelativePath.replace(
+    '{installRoot}',
+    installRoot || ''
+  );
+  const dstPath = path.join(targetDir, destinationRelativePath);
+
+  if (normalizedMode === 'if-present' && !(await exists(dstPath))) {
+    return null;
+  }
+
+  const result = await copyEntry(srcPath, dstPath, { overwrite, dryRun });
+  return {
+    toolId,
+    source: ruleMeta.sourceRelativePath,
+    destination: destinationRelativePath,
+    status: result.status
+  };
+}
+
 function statusLabel(status) {
   switch (status) {
     case 'copied':
@@ -1209,17 +1408,17 @@ function statusLabel(status) {
 function statusIcon(status) {
   switch (status) {
     case 'copied':
-      return '✅';
+      return '🟢';
     case 'overwritten':
-      return '♻️';
+      return '🔵';
     case 'skipped':
-      return '⏭️';
+      return '⚪';
     case 'would-copy':
-      return '📝';
+      return '🟡';
     case 'would-overwrite':
-      return '🛠️';
+      return '🟣';
     default:
-      return '•';
+      return '○';
   }
 }
 
@@ -1241,8 +1440,19 @@ function printPlan(catalog, selection, mode, targetDir, dryRun = false) {
   console.log(`실행 타입  : ${dryRun ? 'dry-run (실제 파일 변경 없음)' : '실행 (파일 변경 반영)'}`);
   console.log(`프리셋     : ${selection.presetId ?? '수동/없음'}`);
   console.log(`대상 경로  : ${targetDir}`);
+  console.log(
+    `규칙 파일  : ${selection.projectRulesMode} (${describeProjectRulesMode(
+      selection.projectRulesMode
+    )})`
+  );
   console.log(`선택 도구  : ${selection.selectedToolIds.length}개`);
 
+  let totalComponents = 0;
+  for (const toolId of selection.selectedToolIds) {
+    totalComponents += (selection.componentSelection[toolId] ?? []).length;
+  }
+  console.log(`총 구성요소 : ${totalComponents}개`);
+
   selection.selectedToolIds.forEach((toolId, index) => {
     const tool = findTool(catalog, toolId);
     if (!tool) {
@@ -1272,6 +1482,20 @@ function printPlan(catalog, selection, mode, targetDir, dryRun = false) {
       }
     }
 
+    const projectRuleDestination = resolveProjectRuleDestination(tool.id, installRoot);
+    if (projectRuleDestination) {
+      let applyHint = '적용됨';
+      if (selection.projectRulesMode === 'if-instructions' && !componentIds.includes('instructions')) {
+        applyHint = '`instructions` 미선택으로 이번 실행에서는 생성/업데이트 안 함';
+      } else if (selection.projectRulesMode === 'if-present') {
+        applyHint = '대상 파일이 이미 있을 때만 업데이트';
+      } else if (selection.projectRulesMode === 'never') {
+        applyHint = '생성/업데이트 안 함';
+      }
+      console.log(`   규칙 파일 : ${projectRuleDestination}`);
+      console.log(`   적용 정책 : ${applyHint}`);
+    }
+
     if (tool.install_root_basis) {
       console.log(`   경로 기준 : ${tool.install_root_basis}`);
     }
@@ -1357,6 +1581,7 @@ async function writeState({ catalog, targetDir, packageData, mode, selection })
     package_version: packageData.version,
     updated_at: new Date().toISOString(),
     preset_id: selection.presetId ?? null,
+    project_rules_mode: normalizeProjectRulesMode(selection.projectRulesMode ?? 'always'),
     install_roots: installRoots,
     tools
   };
@@ -1381,6 +1606,22 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
 
   const results = [];
 
+  let totalSteps = 0;
+  for (const toolId of selection.selectedToolIds) {
+    const componentIds = selection.componentSelection[toolId] ?? [];
+    totalSteps += 1 + componentIds.length + 1;
+  }
+  let currentStep = 0;
+  const logStep = (label) => {
+    currentStep += 1;
+    const progress = `[${String(currentStep).padStart(String(totalSteps).length, ' ')}/${totalSteps}]`;
+    if (output.isTTY) {
+      output.write(`\r\x1B[K${progress} ${label}`);
+    } else {
+      console.log(`${progress} ${label}`);
+    }
+  };
+
   for (const toolId of selection.selectedToolIds) {
     const tool = findTool(catalog, toolId);
     if (!tool) {
@@ -1391,6 +1632,7 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
     const toolDestRoot = path.join(targetDir, installRoot);
     await fs.mkdir(toolDestRoot, { recursive: true });
 
+    logStep(`${tool.title} README 복사 중...`);
     const readmeSrc = path.join(rootDir, tool.root, tool.readme);
     const readmeDst = path.join(toolDestRoot, `README.tri-agent-manager.${tool.id}.md`);
     const readmeResult = await copyEntry(readmeSrc, readmeDst, { overwrite, dryRun });
@@ -1408,6 +1650,7 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
         throw new Error(`[${tool.id}] 알 수 없는 구성요소: ${componentId}`);
       }
 
+      logStep(`${tool.title} ${component.title} 복사 중...`);
       const src = path.join(rootDir, tool.root, component.path);
       const componentInstallPath = getComponentInstallPath(component);
       const dst = path.join(targetDir, installRoot, componentInstallPath);
@@ -1419,8 +1662,25 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
         status: result.status
       });
     }
+
+    logStep(`${tool.title} 프로젝트 규칙 처리 중...`);
+    const ruleResult = await copyProjectRuleBootstrap({
+      toolId,
+      targetDir,
+      installRoot,
+      overwrite,
+      dryRun,
+      selectedComponentIds: componentIds,
+      projectRulesMode: selection.projectRulesMode
+    });
+    if (ruleResult) {
+      results.push(ruleResult);
+    }
   }
 
+  if (output.isTTY) {
+    output.write('\r\x1B[K');
+  }
   console.log('');
   console.log('━━━━━━━━ 적용 결과 ━━━━━━━━');
   const summaryCounter = {
@@ -1505,8 +1765,9 @@ function printList(catalog) {
           getComponentInstallPath(component)
         )}`
       );
-      if (component.description) {
-        console.log(`      ${component.description}`);
+      const description = getComponentDescription(tool.id, component);
+      if (description) {
+        console.log(`      ${description}`);
       }
     });
   });
@@ -1530,7 +1791,7 @@ function printList(catalog) {
   }
 
   console.log('━━━━━━━━ 권장 흐름 ━━━━━━━━');
-  console.log(`1) pnpm dlx ${CLI_NAME} --interactive`);
+  console.log(`1) npx --yes --package @dusky-bluehour/agent-service ${CLI_NAME} --interactive`);
   console.log('2) 설치 후 .tri-agent-manager/state.json 기준으로 update');
   console.log('3) update 시 필요한 도구만 부분 갱신');
 }
@@ -1573,6 +1834,9 @@ async function main() {
   }
 
   const installRootOverridesFromFlag = parseInstallRootFlag(options.installRootFlag, catalog);
+  const projectRulesModeFromFlag = options.projectRulesFlag
+    ? normalizeProjectRulesMode(options.projectRulesFlag)
+    : null;
 
   const shouldUseInteractive =
     !options.nonInteractive &&
@@ -1584,7 +1848,8 @@ async function main() {
         mode: command,
         defaultTarget: options.targetFlag,
         presetFlag: options.presetFlag,
-        installRootOverridesFromFlag
+        installRootOverridesFromFlag,
+        projectRulesModeFromFlag
       })
     : buildSelectionFromFlags({
         catalog,
@@ -1593,12 +1858,16 @@ async function main() {
         toolFlag: options.toolFlag,
         componentFlag: options.componentFlag,
         targetFlag: options.targetFlag,
-        installRootOverridesFromFlag
+        installRootOverridesFromFlag,
+        projectRulesModeFromFlag
       });
 
   const stateForTarget = await readState(rawSelection.targetDir);
   const selection = {
     ...rawSelection,
+    projectRulesMode: normalizeProjectRulesMode(
+      projectRulesModeFromFlag ?? stateForTarget?.project_rules_mode ?? rawSelection.projectRulesMode
+    ),
     installRootOverrides: buildInstallRootOverrides({
       catalog,
       selectedToolIds: rawSelection.selectedToolIds,