docuking-mcp 2.13.0 → 3.0.0

package/README.md

@@ -77,18 +77,18 @@ claude mcp add docuking -s user -- docuking-mcp
 
 | 도구 | 설명 |
 |------|------|
-| docuking_init | 프로젝트 연결, yy_All_Docu/ 및 zz_ai_* 폴더 생성 |
-| docuking_push | yy_All_Docu/ → 서버 업로드 |
-| docuking_pull | 서버 → yy_All_Docu/ 다운로드 |
+| docuking_init | 프로젝트 연결, 필수 폴더 생성 |
+| docuking_push | 로컬 → 서버 업로드 |
+| docuking_pull | 서버 → 로컬 다운로드 |
 | docuking_status | 동기화 상태 확인 |
 | docuking_list | 서버 파일 목록 조회 |
 | docuking_log | 커밋 히스토리 조회 |
 | docuking_diff | 버전 간 차이 비교 |
 | docuking_rollback | 특정 커밋으로 롤백 |
-| docuking_talk | AI 대화록 저장 (zz_ai_1_Talk/) |
-| docuking_plan | 작업 계획 관리 (zz_ai_3_Plan/) |
+| docuking_talk | AI 대화록 저장 (xy_TalkTodoPlan/) |
+| docuking_plan | 작업 계획 관리 (xy_TalkTodoPlan/) |
 | docuking_done | 작업 완료 처리 |
-| docuking_todo | 킹투두 관리 (zz_ai_2_Todo/) |
+| docuking_todo | 킹투두 관리 (xy_TalkTodoPlan/z_King_Todo.md) |
 | docuking_urgent | 긴급 보고 (xx_Urgent/) |
 | docuking_delete | 서버 파일 삭제 |
 | docuking_validate | 정책 준수 검증 |
@@ -100,20 +100,17 @@ claude mcp add docuking -s user -- docuking-mcp
 ├── xx_Infra_Config/         ← 시스템 설정 (동기화 대상)
 ├── xx_Policy/               ← 정책 문서 (동기화 대상, 킹캐스트)
 ├── xx_Urgent/               ← 긴급 보고 (동기화 대상)
+├── xy_TalkTodoPlan/         ← 오너 AI 기록 (Talk+Todo+Plan 통합)
 ├── yy_All_Docu/             ← 문서 허브 (동기화 대상)
-├── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
-│   ├── zz_ai_1_Talk/        ← 협업자의 AI 대화록
-│   ├── zz_ai_2_Todo/        ← 협업자의 AI 투두
-│   └── zz_ai_3_Plan/        ← 협업자의 AI 플랜
-├── zz_ai_1_Talk/            ← 오너의 AI 대화록 (동기화 대상)
-├── zz_ai_2_Todo/            ← 오너의 AI 투두 (동기화 대상)
-└── zz_ai_3_Plan/            ← 오너의 AI 플랜 (동기화 대상)
+└── yy_Coworker_{이름}/      ← 협업자 작업 폴더 (동기화 대상)
+    └── zz_TalkTodoPlan/     ← 협업자의 AI 기록
 ```
 
 **접두사 규칙:**
 - `xx_*`: 시스템/인프라 폴더
+- `xy_*`: 오너 AI 기록 폴더
 - `yy_*`: 사람용 폴더
-- `zz_ai_*`: AI용 폴더
+- `zz_*`: 협업자 AI 기록 폴더 (협업자 폴더 안에서만)
 
 ## 웹사이트
 

package/handlers/docs.js

@@ -17,11 +17,12 @@ export async function handleTodo(args) {
   const localPath = args.localPath || process.cwd();
   const { action, todo, todoId } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_2_Todo/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_2_Todo/
-  const { basePath } = getAiBasePath(localPath);
-  const todoBasePath = path.join(basePath, 'zz_ai_2_Todo');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const todoBasePath = path.join(basePath, aiFolder);
   const todoFilePath = path.join(todoBasePath, 'z_King_Todo.md');
 
   // 폴더 생성
@@ -182,7 +183,7 @@ export async function handleTodo(args) {
           text: `📋 킹투두 미결: 없음
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
         }],
       };
     }
@@ -197,7 +198,7 @@ export async function handleTodo(args) {
 ${listText}
 
 ✅ 완료: ${completedCount}개
-📁 전체 기록: zz_ai_2_Todo/z_King_Todo.md`,
+📁 전체 기록: ${aiFolder}/z_King_Todo.md`,
       }],
     };
   }
@@ -215,10 +216,11 @@ export async function handleTalk(args) {
   const { title, content: talkContent, tags = [] } = args;
 
   // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_1_Talk/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_1_Talk/
-  const { basePath } = getAiBasePath(localPath);
-  const talkBasePath = path.join(basePath, 'zz_ai_1_Talk');
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const talkBasePath = path.join(basePath, aiFolder);
 
   // 날짜 기반 파일명 생성 (T_ 접두사)
   const { fileName, timestamp } = generateDateFileName(title, 'T');
@@ -299,11 +301,12 @@ export async function handlePlan(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, title, goal, steps = [], notes } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -453,11 +456,12 @@ export async function handleDone(args) {
   const localPath = args.localPath || process.cwd();
   const { planId, summary, artifacts = [] } = args;
 
-  // 협업자 여부에 따라 zz_ai 경로 결정
-  // - 오너: localPath/zz_ai_3_Plan/
-  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_ai_3_Plan/
-  const { basePath } = getAiBasePath(localPath);
-  const planBasePath = path.join(basePath, 'zz_ai_3_Plan');
+  // 협업자 여부에 따라 AI 폴더 경로 결정
+  // - 오너: localPath/xy_TalkTodoPlan/
+  // - 협업자: localPath/yy_Coworker_{폴더명}/zz_TalkTodoPlan/
+  const { basePath, isCoworker } = getAiBasePath(localPath);
+  const aiFolder = isCoworker ? 'zz_TalkTodoPlan' : 'xy_TalkTodoPlan';
+  const planBasePath = path.join(basePath, aiFolder);
 
   // 계획 파일 찾기
   const planFiles = findPlanFilesLocal(planBasePath, planId);

package/handlers/sync.js

@@ -96,8 +96,9 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
   let coworkerFolderName = null;
   let coworkerFolderPath = null;
 
-  // zz_ai_* 폴더 목록
-  const aiFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  // AI 폴더 (오너: xy_TalkTodoPlan, 협업자: zz_TalkTodoPlan)
+  const ownerAiFolder = 'xy_TalkTodoPlan';
+  const coworkerAiFolder = 'zz_TalkTodoPlan';
 
   // xx_ 시스템 폴더 목록 (오너 전용)
   const systemFolders = ['xx_Infra_Config', 'xx_Policy'];
@@ -120,12 +121,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(coworkerPrivatePath)) {
       fs.mkdirSync(coworkerPrivatePath, { recursive: true });
     }
-    // 협업자 폴더 안에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(coworkerFolderPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 협업자 폴더 안에 zz_TalkTodoPlan 폴더 생성
+    const coworkerAiFolderPath = path.join(coworkerFolderPath, coworkerAiFolder);
+    if (!fs.existsSync(coworkerAiFolderPath)) {
+      fs.mkdirSync(coworkerAiFolderPath, { recursive: true });
     }
   } else {
     // 오너: xx_ 시스템 폴더 (루트에 생성)
@@ -140,12 +139,10 @@ docuking_init 호출 시 apiKey 파라미터를 포함해주세요.`,
     if (!fs.existsSync(ownerPrivatePath)) {
       fs.mkdirSync(ownerPrivatePath, { recursive: true });
     }
-    // 오너: 루트에 zz_ai_* 폴더 생성
-    for (const folder of aiFolders) {
-      const folderPath = path.join(localPath, folder);
-      if (!fs.existsSync(folderPath)) {
-        fs.mkdirSync(folderPath, { recursive: true });
-      }
+    // 오너: 루트에 xy_TalkTodoPlan 폴더 생성
+    const ownerAiFolderPath = path.join(localPath, ownerAiFolder);
+    if (!fs.existsSync(ownerAiFolderPath)) {
+      fs.mkdirSync(ownerAiFolderPath, { recursive: true });
     }
   }
 
@@ -806,82 +803,23 @@ docuking_init을 먼저 실행하세요.`,
   }
 
   // ========================================
-  // 4. 서버에만 있고 로컬에 없는 파일 soft-delete (deleted_at 기반)
+  // 4. 자동 삭제 비활성화 (2026-01-17 버그 수정)
+  // ========================================
+  // 이전 로직: "서버에 있고 로컬에 없으면 삭제"
+  // 문제: 다른 프로젝트에서 Pull하면 서버 파일이 삭제됨
+  // 해결: 자동 삭제 제거, docuking_delete로만 명시적 삭제
+  //
+  // 삭제는 명시적으로만:
+  // - 사용자가 "이 파일 삭제해줘" 요청 시
+  // - docuking_delete MCP 도구 사용
   // ========================================
-  // 단, 협업자 폴더(yy_Coworker_*)는 삭제하지 않음 (오너가 협업자 파일을 삭제하면 안됨)
-  // source: 'web' 파일은 MCP에서 삭제 시도하지 않음 (클라이언트에서 필터링)
-  // 중요: localPathsBeforePull 사용 (Pull 전에 수집한 목록)
-  //       processedLocalPaths는 Pull로 내려받은 파일도 포함하므로 사용 금지
   let deleted = 0;
   const deletedFilePaths = [];
-  let protectedFiles = []; // source: 'web' 파일 (보호됨)
-  const webProtectedPaths = []; // MCP에서 미리 필터링한 웹 파일
-
-  if (serverAllPaths.length > 0 && !isCoworker) {
-    // 오너만 삭제 수행
-    // yy_Coworker_*로 시작하는 경로는 삭제 대상에서 제외
-    // localPathsBeforePull: Pull 전에 수집한 로컬 파일 목록 (좀비 파일 방지)
-    //
-    // ★ 핵심: source: 'web' 파일은 삭제 대상에서 미리 제외!
-    // 이렇게 하면 웹에서 생성한 파일이 절대 삭제되지 않음
-    const pathsToDelete = serverAllPaths.filter(p => {
-      // 1. 로컬에 있으면 제외 (삭제 대상 아님)
-      if (localPathsBeforePull.has(p)) return false;
-
-      // 2. 협업자 폴더는 제외
-      if (p.startsWith('yy_Coworker_')) return false;
-
-      // 3. source: 'web' 파일은 제외 (웹에서 생성된 파일 보호)
-      const meta = serverPathToMeta[p];
-      if (meta && meta.source === 'web') {
-        webProtectedPaths.push(p);
-        return false;
-      }
-
-      return true;
-    });
-
-    // 웹 보호 파일 로그
-    if (webProtectedPaths.length > 0) {
-      console.error(`[DocuKing] source:web 파일 ${webProtectedPaths.length}개 삭제에서 제외:`, webProtectedPaths.slice(0, 5));
-    }
-
-    console.error(`[DocuKing] soft-delete 대상: ${pathsToDelete.length}개 (서버에만 있고 Pull 전 로컬에 없던 파일, source:local만)`);
-
-    if (pathsToDelete.length > 0) {
-      try {
-        // soft-delete API 호출 (deleted_at 설정, 3일 후 hard delete)
-        const deleteResponse = await fetch(`${API_ENDPOINT}/files/soft-delete`, {
-          method: 'POST',
-          headers: {
-            'Content-Type': 'application/json',
-            'Authorization': `Bearer ${apiKey}`,
-          },
-          body: JSON.stringify({
-            projectId,
-            paths: pathsToDelete,
-          }),
-        });
-
-        if (deleteResponse.ok) {
-          const deleteResult = await deleteResponse.json();
-          deleted = deleteResult.deleted || 0;
-          deletedFilePaths.push(...(deleteResult.deletedPaths || []));
-          protectedFiles = deleteResult.protected || [];
+  let protectedFiles = [];
 
-          // 보호된 파일이 있으면 로그 출력 (Backend에서 추가로 보호한 파일)
-          if (protectedFiles.length > 0) {
-            console.error(`[DocuKing] Backend에서 추가 보호된 파일 ${protectedFiles.length}개:`, protectedFiles.slice(0, 5));
-          }
-        }
-      } catch (e) {
-        console.error('[DocuKing] 파일 soft-delete 실패:', e.message);
-      }
-    }
-
-    // MCP에서 미리 제외한 웹 파일도 보호 목록에 추가 (결과 표시용)
-    protectedFiles = [...protectedFiles, ...webProtectedPaths];
-  }
+  // 자동 삭제 로직 비활성화 - 아래 코드는 주석 처리
+  // "로컬에 없으면 삭제" 로직은 위험하므로 제거
+  console.error(`[DocuKing] 자동 삭제 비활성화됨 (명시적 삭제만 허용: docuking_delete 사용)`);
 
   // 5. 빈 폴더 생성
   let createdEmptyFolders = 0;
@@ -1072,10 +1010,10 @@ export async function handlePullInternal(args) {
   const commonFolders = ['xx_Urgent'];
 
   // 오너 전용 폴더
-  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan'];
+  const ownerFolders = ['xx_Infra_Config', 'xx_Policy', 'xy_TalkTodoPlan'];
 
   // 협업자 전용 폴더 (yy_Coworker_{폴더명}/ 안에)
-  const coworkerSubFolders = ['zz_ai_1_Talk', 'zz_ai_2_Todo', 'zz_ai_3_Plan', '_Private'];
+  const coworkerSubFolders = ['zz_TalkTodoPlan', '_Private'];
 
   // 공통 폴더 체크
   for (const folder of commonFolders) {
@@ -1300,11 +1238,24 @@ export async function handlePullInternal(args) {
           current++;
           continue;
         }
+
+        // ========================================
+        // [버그 수정] 로컬 파일 우선 정책
+        // 해시가 다르면 → 로컬 수정이 있다는 뜻
+        // 서버 파일로 덮어쓰지 않고 로컬 유지
+        // 다음 Push에서 로컬 → 서버로 업로드됨
+        // ========================================
+        console.error(`[DocuKing] 로컬 우선: ${file.path} (해시 다름 → 로컬 유지, Push 시 업로드됨)`);
+        results.push({ type: 'skip', path: file.path, reason: 'local-modified' });
+        skipped++;
+        current++;
+        continue;
       } catch (e) {
         // 해시 계산 실패 시 다운로드 대상
       }
     }
 
+    // 로컬에 파일이 없는 경우만 다운로드
     filesToDownload.push({ ...file, fullPath });
   }
 
@@ -1437,29 +1388,18 @@ export async function handlePullInternal(args) {
   }
 
   // ========================================
-  // mark-as-pulled 호출 (source: 'web' → 'local' 변경)
-  // Pull된 웹 파일/폴더는 이제 로컬이 관리권한을 가짐
+  // mark-as-pulled 비활성화 (2026-01-17 정책 변경)
+  // ========================================
+  // 이전 로직: source를 'web' → 'local'로 변경
+  // 문제: source는 "출생신고"로, 한 번 정해지면 불변이어야 함
+  // 변경하면 "출처 위조"가 됨
+  //
+  // 새 정책: source는 절대 변경하지 않음
+  // - web에서 태어난 파일은 Pull해도 source: 'web' 유지
+  // - local에서 태어난 파일은 Push해도 source: 'local' 유지
   // ========================================
   if (filesToMarkAsPulled.length > 0) {
-    try {
-      const markResponse = await fetch(`${API_ENDPOINT}/files/mark-as-pulled`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'Authorization': `Bearer ${apiKey}`,
-        },
-        body: JSON.stringify({
-          projectId,
-          paths: filesToMarkAsPulled,
-        }),
-      });
-
-      if (markResponse.ok) {
-        console.error(`[DocuKing] mark-as-pulled 완료: ${filesToMarkAsPulled.length}개`);
-      }
-    } catch (e) {
-      console.error('[DocuKing] mark-as-pulled 실패:', e.message);
-    }
+    console.error(`[DocuKing] mark-as-pulled 비활성화됨 (source 불변 정책): ${filesToMarkAsPulled.length}개 파일의 source 유지`);
   }
 
   // ========================================

package/index.js

@@ -8,17 +8,18 @@
  * 폴더 구조:
  * - xx_Infra_Config/          : 시스템 설정 (.env 백업, 배포 정보 등) - Push 대상
  * - xx_Policy/                : 정책 문서 (AI 행동 지침) - Push 대상, 킹캐스트 대상
+ * - xx_Urgent/                : 긴급 보고 (킹어전트) - Push 대상
+ * - xy_TalkTodoPlan/          : 오너 AI 기록 (Talk+Todo+Plan 통합) - Push 대상
  * - yy_All_Docu/              : 문서 동기화 폴더 (Push/Pull 대상)
  * - yy_All_Docu/_Private/     : 오너 비공개 폴더 (오너만 접근)
  * - yy_Coworker_{폴더명}/     : 협업자 폴더 (yy_All_Docu와 별도, 동기화 대상)
- * - zz_ai_1_Talk/             : AI 대화록 (킹톡, Push 대상)
- * - zz_ai_2_Todo/             : AI 투두 (킹투두, Push 대상)
- * - zz_ai_3_Plan/             : AI 플랜 (킹플랜, Push 대상)
+ * - yy_Coworker_{폴더명}/zz_TalkTodoPlan/ : 협업자 AI 기록
  *
  * 접두사 규칙:
- * - xx_ : 시스템용 폴더 (인프라, 정책) - Push 대상
- * - yy_ : 사람용 폴더 (문서, 협업자) - Push 대상
- * - zz_ai_ : AI용 폴더 (Talk, Todo, Plan) - Push 대상
+ * - xx_ : 시스템용 폴더 (인프라, 정책, 긴급)
+ * - xy_ : 오너 AI 기록 폴더
+ * - yy_ : 사람용 폴더 (문서, 협업자)
+ * - zz_ : 협업자 AI 기록 폴더 (협업자 폴더 안에서만 사용)
  * - _   : 비공개 폴더 (본인만 접근)
  *
  * 도구:
@@ -98,13 +99,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 **오너 초기화 시:**
 - xx_Infra_Config/, xx_Policy/, xx_Urgent/ 폴더 생성 (시스템 설정)
+- xy_TalkTodoPlan/ 폴더 생성 (AI 기록 통합)
 - yy_All_Docu/, yy_All_Docu/_Private/ 폴더 생성
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 폴더 생성
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - 초기화 완료 후 정책 문서 작성 가이드 제공
 
 **협업자 초기화 시:**
-- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_ai_*/ 포함)
+- yy_Coworker_{폴더명}/ 폴더 생성 (안에 _Private/, zz_TalkTodoPlan/ 포함)
 - CLAUDE.md에 DocuKing 연결 안내 추가
 - "Pull을 실행하세요" 안내 (오너 정책이 킹캐스트로 로컬화됨)
 
@@ -168,7 +169,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
         description: `문서를 DocuKing 서버에 동기화합니다. 내부적으로 Pull → Push 순서로 실행 (git pull && git push 패턴).
 
 **AI 필독: 다음 상황에서 자발적으로 이 도구 사용을 제안하세요:**
-- zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ 에 문서를 생성/수정한 후
+- xy_TalkTodoPlan/ (또는 협업자의 zz_TalkTodoPlan/) 에 문서를 생성/수정한 후
 - yy_All_Docu/ 에 문서를 생성/수정한 후
 - docuking_plan, docuking_done, docuking_talk, docuking_todo 실행 후
 - 사용자가 "올려", "푸시", "동기화" 등을 언급할 때
@@ -315,7 +316,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_talk',
-        description: '의미 있는 대화 내용을 zz_ai_1_Talk/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
+        description: '의미 있는 대화 내용을 xy_TalkTodoPlan/ 폴더에 기록합니다 (Push 대상, 킹톡). AI가 중요한 논의/결정이라고 판단하거나, 사용자가 "이거 기록해줘"라고 요청할 때 사용.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -342,7 +343,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 zz_ai_3_Plan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 xy_TalkTodoPlan/ 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜). 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -411,7 +412,7 @@ init 완료 후 오너에게 "정책 문서를 작성하시겠습니까?" 제안
       },
       {
         name: 'docuking_todo',
-        description: `킹투두(King Todo) - 프로젝트 공식 할일을 zz_ai_2_Todo/z_King_Todo.md에 관리합니다 (Push 대상).
+        description: `킹투두(King Todo) - 프로젝트 공식 할일을 xy_TalkTodoPlan/z_King_Todo.md에 관리합니다 (Push 대상).
 
 **AI 내장 TodoWrite와 다름!** 킹투두는 웹에 동기화되고 팀과 공유됩니다.
 
@@ -630,7 +631,7 @@ DocuKing은 문서 버전 관리 시스템입니다. Git이 코드를 관리하
 - **로컬**: 사용자의 yy_All_Docu/ 폴더 (동기화 대상)
 - **웹탐색기**: DocuKing 서버의 파일 저장소 (킹폴더)
 - **캔버스**: 선택된 파일을 시각화하는 작업 공간
-- **AI 작업 폴더**: zz_ai_1_Talk/, zz_ai_2_Todo/, zz_ai_3_Plan/ (Push 대상)
+- **AI 작업 폴더**: xy_TalkTodoPlan/ (오너) 또는 zz_TalkTodoPlan/ (협업자) - Push 대상
 
 작동 방식: 로컬 yy_All_Docu/ → Push → 킹폴더 → 캔버스에서 시각화
 
@@ -690,10 +691,12 @@ DocuKing 문서 폴더는 git에서 제외해야 합니다. 코드는 git으로,
 
 \`\`\`gitignore
 # DocuKing 문서 폴더 (문서는 DocuKing으로 관리)
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
+yy_Coworker_*/
 \`\`\`
 
 **왜 gitignore에 등록해야 하나요?**
@@ -730,12 +733,12 @@ zz_ai_3_Plan/
 특정 커밋으로 되돌립니다. (웹 탐색기에서 사용 가능)
 
 ### 9. docuking_talk
-의미 있는 대화 내용을 \`zz_ai_1_Talk/\` 폴더에 기록합니다 (Push 대상, 킹톡).
+의미 있는 대화 내용을 \`xy_TalkTodoPlan/\` 폴더에 기록합니다 (Push 대상, 킹톡).
 - AI가 중요한 논의/결정이라고 판단할 때
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`zz_ai_3_Plan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
+작업 계획을 \`xy_TalkTodoPlan/\` 폴더에 생성/업데이트합니다 (Push 대상, 킹플랜).
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -746,7 +749,7 @@ zz_ai_3_Plan/
 - 완료 요약 및 산출물 기록
 
 ### 12. docuking_todo
-킹투두를 관리합니다 (\`zz_ai_2_Todo/z_King_Todo.md\`).
+킹투두를 관리합니다 (\`xy_TalkTodoPlan/z_King_Todo.md\`).
 - action: "add" (추가), "done" (완료), "list" (조회)
 - 프로젝트 공식 할일 목록 (Push하면 웹에서 확인 가능)
 

package/lib/init.js

@@ -105,12 +105,13 @@ ${marker}
 project/
 ├── xx_Infra_Config/             ← 시스템 설정 (오너 관리)
 ├── xx_Policy/                   ← 정책 문서 (오너 관리, 킹캐스트 대상)
-├── yy_All_Docu/                 ← 오너 문서 (읽기만)
+├── xx_Urgent/                   ← 긴급 보고 (킹어전트)
+├── xy_TalkTodoPlan/             ← 오너 AI 기록 (Talk+Todo+Plan 통합)
+├── yy_All_Docu/                 ← 오너 문서
 ├── yy_Coworker_a_Kim/           ← 협업자 Kim
 │   ├── 작업문서.md
-│   └── zz_ai_1_Talk/            ← Kim의 AI 기록
-├── yy_Coworker_b_Lee/           ← 협업자 Lee
-└── zz_ai_*/                     ← 오너의 AI 폴더
+│   └── zz_TalkTodoPlan/         ← Kim의 AI 기록
+└── yy_Coworker_b_Lee/           ← 협업자 Lee
 \`\`\`
 
 ### AI가 협업자에게 안내할 것
@@ -242,11 +243,12 @@ export function updateGitignore(localPath) {
   const marker = '# DocuKing (문서는 DocuKing으로 관리)';
   const docukingEntries = `
 ${marker}
+xx_Infra_Config/
+xx_Policy/
+xx_Urgent/
+xy_TalkTodoPlan/
 yy_All_Docu/
 yy_Coworker_*/
-zz_ai_1_Talk/
-zz_ai_2_Todo/
-zz_ai_3_Plan/
 .docuking/config.json
 .claude/rules/local/_coworker_config.md
 `;

package/lib/utils.js

@@ -47,9 +47,10 @@ export function generatePlanId() {
 
 /**
  * 계획 파일 찾기 (planId로 검색)
+ * @param {string} planDir - AI 폴더 경로 (xy_TalkTodoPlan 또는 zz_TalkTodoPlan)
+ * @param {string} planId - 찾을 계획 ID
  */
-export function findPlanFiles(basePath, planId) {
-  const planDir = path.join(basePath, 'zz_ai_3_Plan');
+export function findPlanFiles(planDir, planId) {
   if (!fs.existsSync(planDir)) return [];
 
   const results = [];

package/package.json

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