docuking-mcp 2.7.0 → 2.8.1

package/handlers/kingcast.js

@@ -12,8 +12,8 @@ import {
   getAiBasePath,
 } from '../lib/config.js';
 
-// 킹캐스트 대상 폴더
-const KINGCAST_FOLDERS = ['_Infra_Config', '_Policy'];
+// 킹캐스트 대상 폴더 (xx_ 접두사로 루트 레벨에 위치)
+const KINGCAST_FOLDERS = ['xx_Infra_Config', 'xx_Policy'];
 
 // 킹캐스트 해시 저장 파일
 const KINGCAST_HASH_FILE = '.docuking/kingcast_hashes.json';
@@ -32,14 +32,13 @@ function calculateFileHash(filePath) {
 
 /**
  * 킹캐스트 대상 파일 수집
- * yy_All_Docu/_Infra_Config/, yy_All_Docu/_Policy/ 내의 모든 파일
+ * xx_Infra_Config/, xx_Policy/ (루트 레벨) 내의 모든 파일
  */
 function collectKingcastFiles(localPath) {
-  const allDocuPath = path.join(localPath, 'yy_All_Docu');
   const files = {};
 
   for (const folder of KINGCAST_FOLDERS) {
-    const folderPath = path.join(allDocuPath, folder);
+    const folderPath = path.join(localPath, folder);
     if (!fs.existsSync(folderPath)) continue;
 
     const collectRecursive = (dir, relativePath = '') => {
@@ -171,25 +170,25 @@ function updateLocalRules(localPath, currentFiles, changes, config) {
   const coworkerFolder = config?.coworkerFolder || '';
   const projectName = config?.projectName || 'Unknown Project';
 
-  // _Policy 파일들 분류 (번호순 정렬)
+  // xx_Policy 파일들 분류 (번호순 정렬)
   const policyFiles = Object.entries(currentFiles)
-    .filter(([key]) => key.startsWith('_Policy/'))
+    .filter(([key]) => key.startsWith('xx_Policy/'))
     .map(([key, file]) => ({ key, ...file }))
     .sort((a, b) => a.key.localeCompare(b.key));
 
-  // _Infra_Config 파일들 분류
+  // xx_Infra_Config 파일들 분류
   const infraConfigFiles = Object.entries(currentFiles)
-    .filter(([key]) => key.startsWith('_Infra_Config/'))
+    .filter(([key]) => key.startsWith('xx_Infra_Config/'))
     .map(([key, file]) => ({ key, ...file }));
 
   const createdFiles = [];
 
   // ========================================
-  // 1. _Policy 파일들을 서브파일 구조로 복사
+  // 1. xx_Policy 파일들을 서브파일 구조로 복사
   // ========================================
   for (const file of policyFiles) {
-    // _Policy/00_project_overview.md → 00_project_overview.md
-    const relativePath = file.key.replace('_Policy/', '');
+    // xx_Policy/00_project_overview.md → 00_project_overview.md
+    const relativePath = file.key.replace('xx_Policy/', '');
     const targetPath = path.join(localRulesPath, relativePath);
 
     // 디렉토리 생성
@@ -206,6 +205,12 @@ function updateLocalRules(localPath, currentFiles, changes, config) {
     }
   }
 
+  // ========================================
+  // 1.5. xx_Infra_Config는 복사하지 않음
+  // 이미 Pull 후 xx_Infra_Config/에 존재함
+  // AI가 변경 감지 시 직접 읽고 로컬 환경에 맞게 적용
+  // ========================================
+
   // ========================================
   // 2. 협업자용 설정 파일 생성 (_coworker_config.md)
   // ========================================
@@ -271,13 +276,13 @@ git checkout -b coworker/${coworkerFolder}
 ## 환경 정보 (읽기 전용 참고)
 `;
 
-    // _Infra_Config에서 민감하지 않은 정보 추가
+    // xx_Infra_Config에서 민감하지 않은 정보 추가
     let infraInfo = '';
     for (const file of infraConfigFiles) {
       const fileName = path.basename(file.key);
       // 배포 관련 정보만 참조 (민감 정보 제외)
       if (fileName.includes('deploy') || fileName.includes('README')) {
-        infraInfo += `\n참고 문서: yy_All_Docu/${file.key}`;
+        infraInfo += `\n참고 문서: ${file.key}`;
       }
     }
 
@@ -316,11 +321,22 @@ git checkout -b coworker/${coworkerFolder}
     indexContent += '\n(정책 문서가 없습니다)\n';
   } else {
     for (const file of policyFiles) {
-      const relativePath = file.key.replace('_Policy/', '');
+      const relativePath = file.key.replace('xx_Policy/', '');
       indexContent += `- [${relativePath}](./${relativePath})\n`;
     }
   }
 
+  // 인프라 설정 파일 안내 (복사하지 않으므로 원본 경로 표시)
+  if (infraConfigFiles.length > 0) {
+    indexContent += '\n## 인프라 설정 (xx_Infra_Config/)\n';
+    indexContent += '> 아래 파일들은 복사되지 않습니다. 원본 경로에서 직접 읽으세요.\n';
+    indexContent += '> 변경 감지 시 AI가 내용을 읽고 로컬 환경에 맞게 적용해야 합니다.\n\n';
+    for (const file of infraConfigFiles) {
+      const relativePath = file.key.replace('xx_Infra_Config/', '');
+      indexContent += `- xx_Infra_Config/${relativePath}\n`;
+    }
+  }
+
   if (isCoworker) {
     indexContent += `\n## 협업자 설정\n- [_coworker_config.md](./_coworker_config.md)\n`;
   }
@@ -329,12 +345,13 @@ git checkout -b coworker/${coworkerFolder}
   createdFiles.push('00_index.md');
 
   // ========================================
-  // 4. 삭제된 정책에 해당하는 로컬 파일 삭제
+  // 4. 삭제된 정책/인프라에 해당하는 로컬 파일 삭제
   // ========================================
   if (changes.deleted.length > 0) {
     for (const deletedKey of changes.deleted) {
-      if (deletedKey.startsWith('_Policy/')) {
-        const relativePath = deletedKey.replace('_Policy/', '');
+      // xx_Policy 삭제
+      if (deletedKey.startsWith('xx_Policy/')) {
+        const relativePath = deletedKey.replace('xx_Policy/', '');
         const targetPath = path.join(localRulesPath, relativePath);
         if (fs.existsSync(targetPath)) {
           try {
@@ -345,6 +362,8 @@ git checkout -b coworker/${coworkerFolder}
           }
         }
       }
+      // xx_Infra_Config는 복사하지 않으므로 삭제 처리 불필요
+      // Pull 시 자동으로 원본 폴더에서 제거됨
     }
   }
 
@@ -454,8 +473,23 @@ export async function executeKingcast(localPath) {
     message += `\n   📄 정책 파일 ${result.policyCount}개 → .claude/rules/local/`;
   }
 
+  // xx_Infra_Config 변경 감지 시 안내
+  const infraChanges = [
+    ...changes.added.filter(k => k.startsWith('xx_Infra_Config/')),
+    ...changes.modified.filter(k => k.startsWith('xx_Infra_Config/')),
+  ];
+  if (infraChanges.length > 0) {
+    message += `\n\n🔧 인프라 설정 변경 감지 (${infraChanges.length}개):`;
+    for (const file of infraChanges) {
+      message += `\n   - ${file}`;
+    }
+    message += `\n\n   👉 AI는 위 파일들을 읽고 로컬 환경에 맞게 적용하세요.`;
+    message += `\n   👉 예: .env 변수 추가/변경, 배포 설정 확인 등`;
+  }
+
   // 정책 변경 시 경고 메시지 추가
-  if (changes.modified.length > 0) {
+  const policyModified = changes.modified.filter(k => k.startsWith('xx_Policy/'));
+  if (policyModified.length > 0) {
     message += `\n\n⚠️ 중요: 정책이 변경되었습니다!`;
     message += `\n   기존 코드가 새 정책과 맞지 않을 수 있습니다.`;
     message += `\n   변경된 정책 파일을 읽고, 기존 코드에도 새 정책을 적용하세요.`;
@@ -511,9 +545,9 @@ export async function handleKingcastStatus(args) {
 ## 킹캐스트 대상 파일
 `;
 
-  // _Infra_Config 파일
-  statusText += '\n### _Infra_Config/\n';
-  const infraConfigFiles = Object.keys(currentFiles).filter(k => k.startsWith('_Infra_Config/'));
+  // xx_Infra_Config 파일
+  statusText += '\n### xx_Infra_Config/\n';
+  const infraConfigFiles = Object.keys(currentFiles).filter(k => k.startsWith('xx_Infra_Config/'));
   if (infraConfigFiles.length === 0) {
     statusText += '(없음)\n';
   } else {
@@ -522,9 +556,9 @@ export async function handleKingcastStatus(args) {
     }
   }
 
-  // _Policy 파일
-  statusText += '\n### _Policy/\n';
-  const policyFiles = Object.keys(currentFiles).filter(k => k.startsWith('_Policy/'));
+  // xx_Policy 파일
+  statusText += '\n### xx_Policy/\n';
+  const policyFiles = Object.keys(currentFiles).filter(k => k.startsWith('xx_Policy/'));
   if (policyFiles.length === 0) {
     statusText += '(없음)\n';
   } else {

package/handlers/sync.js

@@ -88,6 +88,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   // zz_ai_* 폴더 목록
   const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
 
+  // xx_ 시스템 폴더 목록 (오너 전용)
+  const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
+
   if (isCoworker) {
     // 협업자: yy_Coworker_{폴더명}/ 폴더를 yy_All_Docu/ 밖에 별도 생성
     coworkerFolderName = `yy_Coworker_${coworkerFolder}`;
@@ -108,15 +111,14 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
       }
     }
   } else {
-    // 오너: yy_All_Docu/ 안에 _Infra_Config/, _Policy/, _Private/ 생성
-    const infraConfigPath = path.join(mainFolderPath, '_Infra_Config');
-    if (!fs.existsSync(infraConfigPath)) {
-      fs.mkdirSync(infraConfigPath, { recursive: true });
-    }
-    const policyPath = path.join(mainFolderPath, '_Policy');
-    if (!fs.existsSync(policyPath)) {
-      fs.mkdirSync(policyPath, { recursive: true });
+    // 오너: xx_ 시스템 폴더 (루트에 생성)
+    for (const folder of systemFolders) {
+      const folderPath = path.join(localPath, folder);
+      if (!fs.existsSync(folderPath)) {
+        fs.mkdirSync(folderPath, { recursive: true });
+      }
     }
+    // 오너: yy_All_Docu/ 안에 _Private/ 생성
     const ownerPrivatePath = path.join(mainFolderPath, '_Private');
     if (!fs.existsSync(ownerPrivatePath)) {
       fs.mkdirSync(ownerPrivatePath, { recursive: true });
@@ -296,27 +298,27 @@ docuking_init을 먼저 실행하세요.`,
       };
     }
 
-    // 오너 Push 대상: yy_All_Docu/ + zz_ai_*/ 폴더들
+    // 오너 Push 대상: xx_*/ + yy_All_Docu/ + zz_ai_*/ 폴더들
     pushTargetFolders.push({ localPath: mainFolderPath, serverPrefix: 'yy_All_Docu' });
 
-    // zz_ai_* 폴더들 찾기
+    // xx_*, zz_ai_* 폴더들 찾기
     const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
     for (const entry of rootEntries) {
-      if (entry.isDirectory() && entry.name.startsWith('zz_ai_')) {
-        const zzPath = path.join(localPath, entry.name);
-        pushTargetFolders.push({ localPath: zzPath, serverPrefix: entry.name });
+      if (entry.isDirectory() && (entry.name.startsWith('xx_') || entry.name.startsWith('zz_ai_'))) {
+        const folderPath = path.join(localPath, entry.name);
+        pushTargetFolders.push({ localPath: folderPath, serverPrefix: entry.name });
       }
     }
   }
 
-  // .env 파일 자동 백업: _Infra_Config/ 폴더에 복사
-  // 오너만 가능 (협업자는 _Infra_Config/ 에 접근 불가)
+  // .env 파일 자동 백업: xx_Infra_Config/ 폴더에 복사
+  // 오너만 가능 (협업자는 xx_Infra_Config/ 에 접근 불가)
   if (!isCoworker) {
     const envFilePath = path.join(localPath, '.env');
-    const infraConfigPath = path.join(mainFolderPath, '_Infra_Config');
+    const infraConfigPath = path.join(localPath, 'xx_Infra_Config');
 
     if (fs.existsSync(envFilePath)) {
-      // _Infra_Config 폴더 생성
+      // xx_Infra_Config 폴더 생성
       if (!fs.existsSync(infraConfigPath)) {
         fs.mkdirSync(infraConfigPath, { recursive: true });
       }
@@ -325,7 +327,7 @@ docuking_init을 먼저 실행하세요.`,
       const envBackupPath = path.join(infraConfigPath, '.env');
       try {
         fs.copyFileSync(envFilePath, envBackupPath);
-        console.error(`[DocuKing] .env → _Infra_Config/.env 자동 백업 완료`);
+        console.error(`[DocuKing] .env → xx_Infra_Config/.env 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] .env 백업 실패: ${err.message}`);
       }
@@ -341,7 +343,7 @@ docuking_init을 먼저 실행하세요.`,
       const backendEnvBackupPath = path.join(infraConfigPath, 'backend.env');
       try {
         fs.copyFileSync(backendEnvPath, backendEnvBackupPath);
-        console.error(`[DocuKing] backend/.env → _Infra_Config/backend.env 자동 백업 완료`);
+        console.error(`[DocuKing] backend/.env → xx_Infra_Config/backend.env 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] backend/.env 백업 실패: ${err.message}`);
       }
@@ -357,7 +359,7 @@ docuking_init을 먼저 실행하세요.`,
       const frontendEnvBackupPath = path.join(infraConfigPath, 'frontend.env.local');
       try {
         fs.copyFileSync(frontendEnvPath, frontendEnvBackupPath);
-        console.error(`[DocuKing] frontend/.env.local → _Infra_Config/frontend.env.local 자동 백업 완료`);
+        console.error(`[DocuKing] frontend/.env.local → xx_Infra_Config/frontend.env.local 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] frontend/.env.local 백업 실패: ${err.message}`);
       }
@@ -373,7 +375,7 @@ docuking_init을 먼저 실행하세요.`,
       const packageJsonBackupPath = path.join(infraConfigPath, 'package.json');
       try {
         fs.copyFileSync(packageJsonPath, packageJsonBackupPath);
-        console.error(`[DocuKing] package.json → _Infra_Config/package.json 자동 백업 완료`);
+        console.error(`[DocuKing] package.json → xx_Infra_Config/package.json 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] package.json 백업 실패: ${err.message}`);
       }
@@ -389,7 +391,7 @@ docuking_init을 먼저 실행하세요.`,
       const backendPackageJsonBackupPath = path.join(infraConfigPath, 'backend.package.json');
       try {
         fs.copyFileSync(backendPackageJsonPath, backendPackageJsonBackupPath);
-        console.error(`[DocuKing] backend/package.json → _Infra_Config/backend.package.json 자동 백업 완료`);
+        console.error(`[DocuKing] backend/package.json → xx_Infra_Config/backend.package.json 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] backend/package.json 백업 실패: ${err.message}`);
       }
@@ -405,7 +407,7 @@ docuking_init을 먼저 실행하세요.`,
       const frontendPackageJsonBackupPath = path.join(infraConfigPath, 'frontend.package.json');
       try {
         fs.copyFileSync(frontendPackageJsonPath, frontendPackageJsonBackupPath);
-        console.error(`[DocuKing] frontend/package.json → _Infra_Config/frontend.package.json 자동 백업 완료`);
+        console.error(`[DocuKing] frontend/package.json → xx_Infra_Config/frontend.package.json 자동 백업 완료`);
       } catch (err) {
         console.error(`[DocuKing] frontend/package.json 백업 실패: ${err.message}`);
       }
@@ -1026,11 +1028,14 @@ export async function handlePullInternal(args) {
 
       // 서버 경로에 따라 로컬 저장 위치 결정
       // 프로젝트 루트 기준 절대경로 그대로 사용
+      // - xx_Infra_Config/xxx → xx_Infra_Config/xxx (시스템/인프라)
+      // - xx_Policy/xxx → xx_Policy/xxx (정책)
       // - yy_All_Docu/xxx → yy_All_Docu/xxx (오너 문서)
       // - yy_Coworker_xxx/yyy → yy_Coworker_xxx/yyy (협업자 폴더)
       // - zz_ai_xxx/yyy → zz_ai_xxx/yyy (AI 폴더)
       let fullPath;
-      if (file.path.startsWith('yy_All_Docu/') ||
+      if (file.path.startsWith('xx_') ||
+          file.path.startsWith('yy_All_Docu/') ||
           file.path.startsWith('yy_Coworker_') ||
           file.path.startsWith('zz_ai_')) {
         // 서버 경로 그대로 로컬에 저장
@@ -1168,7 +1173,8 @@ export async function handlePullInternal(args) {
       try {
         // 서버 경로에 따라 로컬 경로 결정
         let fullPath;
-        if (deletedFile.path.startsWith('yy_All_Docu/') ||
+        if (deletedFile.path.startsWith('xx_') ||
+            deletedFile.path.startsWith('yy_All_Docu/') ||
             deletedFile.path.startsWith('yy_Coworker_') ||
             deletedFile.path.startsWith('zz_ai_')) {
           fullPath = path.join(localPath, deletedFile.path);
@@ -1460,16 +1466,16 @@ export async function handleStatus(args) {
     }
     pushableFiles = localFiles; // 협업자는 자기 폴더의 모든 파일 Push 가능
   } else {
-    // 오너: yy_All_Docu/ + zz_ai_*/ 폴더에서 파일 수집
+    // 오너: xx_*/ + yy_All_Docu/ + zz_ai_*/ 폴더에서 파일 수집
     if (fs.existsSync(mainFolderPath)) {
       collectFilesSimple(mainFolderPath, '', localFiles);
     }
-    // zz_ai_* 폴더들도 수집
+    // xx_*, zz_ai_* 폴더들도 수집
     const rootEntries = fs.readdirSync(localPath, { withFileTypes: true });
     for (const entry of rootEntries) {
-      if (entry.isDirectory() && entry.name.startsWith('zz_ai_')) {
-        const zzPath = path.join(localPath, entry.name);
-        collectFilesSimple(zzPath, '', localFiles);
+      if (entry.isDirectory() && (entry.name.startsWith('xx_') || entry.name.startsWith('zz_ai_'))) {
+        const folderPath = path.join(localPath, entry.name);
+        collectFilesSimple(folderPath, '', localFiles);
       }
     }
     pushableFiles = localFiles; // 오너는 모든 파일 Push 가능

package/index.js

@@ -6,8 +6,9 @@
  * AI 시대의 문서 협업 플랫폼 - AI가 문서를 Push/Pull 할 수 있게 해주는 MCP 서버
  *
  * 폴더 구조:
+ * - xx_Infra_Config/          : 시스템 설정 (.env 백업, 배포 정보 등) - Push 대상
+ * - xx_Policy/                : 정책 문서 (AI 행동 지침) - Push 대상, 킹캐스트 대상
  * - yy_All_Docu/              : 문서 동기화 폴더 (Push/Pull 대상)
- * - yy_All_Docu/_Infra_Config/: 민감 정보 백업 (.env 자동 복사, 팀 공유)
  * - yy_All_Docu/_Private/     : 오너 비공개 폴더 (오너만 접근)
  * - yy_Coworker_{폴더명}/     : 협업자 폴더 (yy_All_Docu와 별도, 동기화 대상)
  * - zz_ai_1_Talk/             : AI 대화록 (킹톡, Push 대상)
@@ -15,6 +16,7 @@
  * - zz_ai_3_Plan/             : AI 플랜 (킹플랜, Push 대상)
  *
  * 접두사 규칙:
+ * - xx_ : 시스템용 폴더 (인프라, 정책) - Push 대상
  * - yy_ : 사람용 폴더 (문서, 협업자) - Push 대상
  * - zz_ai_ : AI용 폴더 (Talk, Todo, Plan) - Push 대상
  * - _   : 비공개 폴더 (본인만 접근)
@@ -87,7 +89,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 - localPath: 로컬 프로젝트 경로
 
 **오너 초기화 시:**
-- yy_All_Docu/, _Infra_Config/, _Policy/, _Private/ 폴더 생성
+- xx_Infra_Config/, xx_Policy/ 폴더 생성 (시스템 설정)
+- yy_All_Docu/, yy_All_Docu/_Private/ 폴더 생성
 - zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 폴더 생성
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - 초기화 완료 후 정책 문서 작성 가이드 제공
@@ -97,7 +100,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - "Pull을 실행하세요" 안내 (오너 정책이 킹캐스트로 로컬화됨)
 
-**정책 문서 템플릿 (오너용, _Policy/ 폴더에 작성):**
+**정책 문서 템플릿 (오너용, xx_Policy/ 폴더에 작성):**
 
 [필수]
 - 00_project_overview.md - 프로젝트 개요, 기술 스택, 팀 구성, 주요 URL
@@ -188,7 +191,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_pull',
-        description: '서버에서 문서를 다운로드하여 yy_All_Docu/ 폴더에 저장합니다. "DocuKing에서 가져와" 요청 시 사용.\n\n**킹캐스트**: Pull 후 _Policy/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다. _Infra_Config/는 참조용으로 내려오지만 로컬화하지 않습니다.',
+        description: '서버에서 문서를 다운로드합니다. "DocuKing에서 가져와" 요청 시 사용.\n\n**킹캐스트**: Pull 후 xx_Policy/, xx_Infra_Config/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -451,7 +454,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
 
 **검증 대상:**
 - .claude/rules/local/ 의 정책 파일 기준 (킹캐스트로 로컬화된 정책)
-- yy_All_Docu/_Policy/ 정책 파일도 참조
+- xx_Policy/ 정책 파일도 참조
 - 폴더 구조, 명명 규칙, API 규칙, DB 스키마 등
 
 **출력:**
@@ -577,7 +580,7 @@ zz_ai_3_Plan/
 
 ### 3. docuking_pull
 서버 문서를 로컬로 다운로드합니다.
-**킹캐스트**: Pull 후 _Policy/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다. _Infra_Config/는 참조용으로 내려오지만 로컬화하지 않습니다.
+**킹캐스트**: Pull 후 xx_Policy/, xx_Infra_Config/ 폴더 변경이 감지되면 자동으로 .claude/rules/local/에 로컬화됩니다.
 
 ### 4. docuking_list
 서버 파일 목록을 조회합니다.
@@ -653,7 +656,7 @@ DocuKing 협업의 핵심 원칙입니다. **각자 자기 영역만 수정할
 
 ## 킹캐스트 (KingCast) - 정책 자동 배포
 
-오너가 \`yy_All_Docu/_Policy/\` 폴더에 정책을 작성하고 Push하면,
+오너가 \`xx_Policy/\` 폴더에 정책을 작성하고 Push하면,
 협업자가 Pull할 때 자동으로 \`.claude/rules/local/\`에 서브파일 구조로 로컬화됩니다.
 
 ### 킹캐스트 동작 원리
@@ -662,12 +665,12 @@ DocuKing 협업의 핵심 원칙입니다. **각자 자기 영역만 수정할
 \`\`\`
 
 ### 킹캐스트 대상 폴더
-- \`yy_All_Docu/_Infra_Config/\` - 환경 설정 (참조용, 로컬화하지 않음)
-- \`yy_All_Docu/_Policy/\` - AI 행동 지침 (로컬화 대상)
+- \`xx_Infra_Config/\` - 환경 설정 (.env 백업, 배포 정보 등) → 변경 감지만 (복사X)
+- \`xx_Policy/\` - AI 행동 지침 → .claude/rules/local/에 복사
 
 ### 정책 파일 작성 템플릿 (오너용)
 \`\`\`
-_Policy/
+xx_Policy/
 ├── 00_project_overview.md    # 프로젝트 개요
 ├── 01_folder_structure.md    # 폴더 구조
 ├── 02_api_convention.md      # API 규칙
@@ -681,9 +684,11 @@ _Policy/
 - \`.claude/rules/local/_coworker_config.md\` - 협업자 설정 (협업자만)
 
 ### AI 필독: 킹캐스트 후 행동
-1. Pull 후 "📢 킹캐스트" 메시지가 표시되면, 정책 변경이 감지된 것
+1. Pull 후 "📢 킹캐스트" 메시지가 표시되면, 정책/환경 변경이 감지된 것
 2. \`.claude/rules/local/00_index.md\`를 읽고 정책 목록 확인
 3. 각 정책 파일을 **읽어서** 내용을 숙지하고 규칙을 따라 작업
+4. **xx_Infra_Config 변경 시**: 원본 경로(xx_Infra_Config/)에서 직접 읽고 로컬 환경에 맞게 적용
+   - 예: .env 변수 추가/수정, 배포 설정 확인 등
 
 웹 탐색기: https://docuking.ai
 `;

package/lib/init.js

@@ -64,7 +64,7 @@ ${marker}
 - 의미 있는 작업 시작 시 (추적용)
 
 ### 규칙
-1. 동기화 대상: yy_All_Docu/ + zz_ai_*/ 폴더 모두
+1. 동기화 대상: xx_*/ + yy_All_Docu/ + zz_ai_*/ 폴더 모두
 2. 킹푸시는 Plan 완료(done) 시 자동 실행
 3. **Talk → Todo → Plan → Done** 순서 준수
 4. Plan 전에 반드시 Talk로 배경 기록
@@ -85,7 +85,7 @@ ${marker}
 
 | 역할 | Push (올리기) | Pull (내리기) | 삭제 |
 |------|---------------|---------------|------|
-| **오너** | \`yy_All_Docu/\` + \`zz_ai_*/\` | 합집합 전체 | 자기 영역만 |
+| **오너** | \`xx_*/\` + \`yy_All_Docu/\` + \`zz_ai_*/\` | 합집합 전체 | 자기 영역만 |
 | **협업자** | \`yy_Coworker_{본인}/\` (안에 zz_ai_* 포함) | 합집합 전체 | 자기 영역만 |
 
 ### 합집합이란?
@@ -103,6 +103,8 @@ ${marker}
 ### 폴더 구조 (Pull 후)
 \`\`\`
 project/
+├── xx_Infra_Config/             ← 시스템 설정 (오너 관리)
+├── xx_Policy/                   ← 정책 문서 (오너 관리, 킹캐스트 대상)
 ├── yy_All_Docu/                 ← 오너 문서 (읽기만)
 ├── yy_Coworker_a_Kim/           ← 협업자 Kim
 │   ├── 작업문서.md
@@ -120,19 +122,19 @@ project/
 
 ## 킹캐스트 (KingCast) - 정책 자동 배포
 
-오너가 \`yy_All_Docu/_Policy/\` 폴더에 정책을 작성하고 Push하면,
+오너가 \`xx_Policy/\` 폴더에 정책을 작성하고 Push하면,
 협업자가 Pull할 때 자동으로 \`.claude/rules/local/\`에 로컬화됩니다.
 
 ### 킹캐스트 대상 폴더
-- \`yy_All_Docu/_Infra_Config/\` - 환경 설정 (참조용, 로컬화하지 않음)
-- \`yy_All_Docu/_Policy/\` - AI 행동 지침 (로컬화 대상)
+- \`xx_Infra_Config/\` - 환경 설정 (.env 백업, 배포 정보 등) → 변경 감지만
+- \`xx_Policy/\` - AI 행동 지침 → .claude/rules/local/에 복사
 
 ### 킹캐스트 동작
 1. Pull 실행
-2. _Infra_Config/, _Policy/ 폴더 변경 감지
-3. \`_Policy/\` 파일들을 \`.claude/rules/local/\`에 서브파일 구조로 복사
-4. 협업자의 경우 변수 치환 (폴더명, 브랜치명 등 로컬화)
-5. \`_Infra_Config/\`는 참조용으로 내려오지만, 협업자가 직접 다룰 정보가 아니므로 로컬화하지 않음
+2. xx_Infra_Config/, xx_Policy/ 폴더 변경 감지 (해시 비교)
+3. \`xx_Policy/\` 파일들을 \`.claude/rules/local/\`에 서브파일 구조로 복사
+4. \`xx_Infra_Config/\` 변경 시 AI에게 알림 (복사X, 원본 경로에서 직접 읽음)
+5. 협업자의 경우 AI가 내용을 읽고 로컬 환경에 맞게 적용
 
 ### Git 제외 정책
 
@@ -144,9 +146,11 @@ project/
 - \`.claude/rules/local/*.md\` - 정책 파일 (폴더구조, API규칙 등 민감정보 없음)
 
 ### AI 필독
-- Pull 후 "📢 킹캐스트" 메시지가 표시되면, 정책 파일의 내용을 읽어 변경사항을 확인하세요.
+- Pull 후 "📢 킹캐스트" 메시지가 표시되면 반드시 확인하세요.
 - \`.claude/rules/local/00_index.md\`를 읽고 정책 문서 목록을 확인하세요.
 - 각 정책 파일의 내용을 읽고 규칙을 따라 작업하세요.
+- **xx_Infra_Config 변경 감지 시**: 해당 파일을 직접 읽고 로컬 환경에 맞게 적용하세요.
+  - 예: .env 변수 추가/수정, 배포 설정 확인 등
 `;
 
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docuking-mcp",
-  "version": "2.7.0",
+  "version": "2.8.1",
   "description": "DocuKing MCP Server - AI 시대의 문서 협업 플랫폼",
   "type": "module",
   "main": "index.js",