project-librarian 0.6.0 → 0.6.2

package/README.ko.md

@@ -41,7 +41,7 @@ npx project-librarian@latest install --scope project --agents all
 npx project-librarian@latest update
 ```
 
-이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
+이 명령은 관리 설정 파일, 에이전트 훅, 위키 운영/메타 파일, 기존 프로젝트 범위 스킬 복사본을 갱신합니다. 기존 공유 `.agents/skills/project-librarian/` 복사본도 특정 에이전트 설정 표면을 암묵적으로 추가하지 않고 갱신합니다. 일반 업데이트는 관리 중인 표면을 보존하며, 아직 관리 표면이 없으면 `.codex/`나 `.cursor/`처럼 이미 존재하는 에이전트 루트만 대상으로 삼습니다. 관련 없는 에이전트 디렉터리는 만들지 않습니다. 기존 Project Librarian 설치나 에이전트 루트를 하나도 감지하지 못하면 파일을 쓰기 전에 중단하고 `init` 또는 명시적인 `--agents` 선택을 요구합니다. 현재 `wiki/`는 보존하고 migration flag는 거부하므로 위키를 `wiki_legacy*`로 바꾸지 않습니다.
 
 특정 프로젝트 표면을 의도적으로 추가하거나 갱신할 때는 `--agents`를 명시합니다.
 

package/README.md

@@ -41,7 +41,7 @@ To refresh an existing setup without migrating the wiki, run:
 npx project-librarian@latest update
 ```
 
-That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
+That updates managed setup files, agent hooks, wiki operating/meta files, and existing project-scoped skill copies. Existing shared `.agents/skills/project-librarian/` copies are refreshed without implying any agent-specific setup surface. A plain update preserves managed surfaces; when no managed surface exists yet, it targets only agent roots already present such as `.codex/` or `.cursor/`. It does not create unrelated agent directories. If neither an existing Project Librarian install nor an agent root can be detected, update stops before writing and asks for `init` or an explicit `--agents` selection. It preserves the current `wiki/` and rejects migration flags, so it will not rename the wiki to `wiki_legacy*`.
 
 Use `--agents` when you intentionally want to add or refresh a specific project surface:
 

package/SKILL.md

@@ -37,6 +37,7 @@ Supported actions:
 Prefer an already installed local runner over network package execution:
 
 - In the project-librarian source repository, use `node dist/init-project-wiki.js` when `dist/init-project-wiki.js` exists.
+- In a target repository with a shared project-scoped skill install, use `node .agents/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Codex skill install, use `node .codex/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Claude skill install, use `node .claude/skills/project-librarian/dist/init-project-wiki.js`.
 - In a target repository with a project-scoped Cursor skill install, use `node .cursor/skills/project-librarian/dist/init-project-wiki.js`.
@@ -69,7 +70,7 @@ $PROJECT_LIBRARIAN
 Use the command variants as follows:
 
 - New project wiki or normal update: `$PROJECT_LIBRARIAN`.
-- Explicit existing-project update without migration: `$PROJECT_LIBRARIAN update` (rejects `--migrate` and `--adopt-existing`).
+- Explicit existing-project update without migration: `$PROJECT_LIBRARIAN update` (rejects `--migrate` and `--adopt-existing`). Without `--agents`, it preserves managed agent surfaces or detects existing agent roots; it never creates unrelated agent surfaces. If neither an existing Project Librarian install nor an agent root is detectable, use `init` for a fresh project or select `--agents` explicitly.
 - Existing wiki/docs need migration: `$PROJECT_LIBRARIAN --migrate`.
 - Install hook files without changing git config: `$PROJECT_LIBRARIAN --no-git-config`.
 - Install reusable Project Librarian skill files: `$PROJECT_LIBRARIAN install --scope user|project --agents codex|claude|cursor|gemini|all`. `install-skill` remains a compatibility alias, but prefer `install` in new guidance.

package/dist/agent-surfaces.js

@@ -4,6 +4,7 @@ exports.agentSurfaceRequiredFiles = exports.allAgentSurfaces = void 0;
 exports.parseAgentSurfaceValues = parseAgentSurfaceValues;
 exports.hasProjectLibrarianInstall = hasProjectLibrarianInstall;
 exports.activeAgentSurfaces = activeAgentSurfaces;
+exports.existingAgentSurfaceRoots = existingAgentSurfaceRoots;
 exports.resolveBootstrapAgentSurfaces = resolveBootstrapAgentSurfaces;
 exports.includesAgentSurface = includesAgentSurface;
 exports.allAgentSurfaces = ["codex", "claude", "cursor", "gemini"];
@@ -19,7 +20,14 @@ const agentSurfaceProjectSkillFiles = {
     cursor: [".cursor/skills/project-librarian/SKILL.md"],
     gemini: [".gemini/skills/project-librarian/SKILL.md"],
 };
+const agentSurfaceRoots = {
+    codex: ".codex",
+    claude: ".claude",
+    cursor: ".cursor",
+    gemini: ".gemini",
+};
 const projectLibrarianCommonInstallFiles = [
+    ".agents/skills/project-librarian/SKILL.md",
     "wiki/startup.md",
     "wiki/index.md",
     "wiki/AGENTS.md",
@@ -55,12 +63,32 @@ function activeAgentSurfaces(fileExists) {
     return exports.allAgentSurfaces.filter((surface) => (exports.agentSurfaceRequiredFiles[surface].some((file) => fileExists(file))
         || agentSurfaceProjectSkillFiles[surface].some((file) => fileExists(file))));
 }
-function resolveBootstrapAgentSurfaces(explicitSurfaces, fileExists, readFile) {
-    if (explicitSurfaces.length > 0)
-        return Array.from(explicitSurfaces);
-    if (hasProjectLibrarianInstall(fileExists, readFile))
-        return activeAgentSurfaces(fileExists);
-    return Array.from(exports.allAgentSurfaces);
+function existingAgentSurfaceRoots(fileExists) {
+    return exports.allAgentSurfaces.filter((surface) => fileExists(agentSurfaceRoots[surface]));
+}
+function resolveBootstrapAgentSurfaces(lifecycle, explicitSurfaces, fileExists, readFile) {
+    if (explicitSurfaces.length > 0) {
+        return { source: "explicit", surfaces: Array.from(explicitSurfaces) };
+    }
+    const managedSurfaces = activeAgentSurfaces(fileExists);
+    if (managedSurfaces.length > 0) {
+        return { source: "managed-install", surfaces: managedSurfaces };
+    }
+    const hasCommonInstall = hasProjectLibrarianInstall(fileExists, readFile);
+    if (lifecycle === "update") {
+        const existingRoots = existingAgentSurfaceRoots(fileExists);
+        if (existingRoots.length > 0) {
+            return { source: "existing-agent-root", surfaces: existingRoots };
+        }
+        if (hasCommonInstall) {
+            return { source: "common-install", surfaces: [] };
+        }
+        return { source: "missing-update-target", surfaces: [] };
+    }
+    if (hasCommonInstall) {
+        return { source: "common-install", surfaces: [] };
+    }
+    return { source: "fresh-init", surfaces: Array.from(exports.allAgentSurfaces) };
 }
 function includesAgentSurface(surfaces, surface) {
     return surfaces.includes(surface);

package/dist/hooks.js

@@ -149,6 +149,7 @@ const mcpServerName = "project-librarian";
 // runner wins; absent any local install we register the published binary.
 const localRunnerCandidates = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     ".codex/skills/project-librarian/dist/init-project-wiki.js",
     ".claude/skills/project-librarian/dist/init-project-wiki.js",
     ".cursor/skills/project-librarian/dist/init-project-wiki.js",
@@ -458,7 +459,7 @@ function wikiScope(files) {
     else if (file.startsWith(".gemini/hooks/") || file === ".gemini/settings.json") add("gemini-hooks");
     else if (file === "AGENTS.md" || file === "CLAUDE.md" || file === "GEMINI.md") add("agents");
     else if (file.startsWith(".githooks/")) add("git-hooks");
-    else if (file.startsWith("tools/project-librarian/")) add("skill");
+    else if (file.startsWith("tools/project-librarian/") || file.startsWith(".agents/skills/project-librarian/")) add("skill");
   }
   return scopes.length === 0 ? "none" : scopes.join(", ");
 }
@@ -467,6 +468,7 @@ function validationTrailers() {
   const home = process.env.HOME || "";
   const lintScript = [
     "tools/project-librarian/dist/init-project-wiki.js",
+    ".agents/skills/project-librarian/dist/init-project-wiki.js",
     path.join(home, ".codex/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".claude/skills/project-librarian/dist/init-project-wiki.js"),
     path.join(home, ".cursor/skills/project-librarian/dist/init-project-wiki.js"),
@@ -517,7 +519,8 @@ const wikiFiles = staged.filter((file) => {
     || file === ".gemini/settings.json"
     || file.startsWith(".gemini/hooks/")
     || file.startsWith(".githooks/")
-    || file.startsWith("tools/project-librarian/");
+    || file.startsWith("tools/project-librarian/")
+    || file.startsWith(".agents/skills/project-librarian/");
 });
 
 if (wikiFiles.length === 0) process.exit(0);

package/dist/init-project-wiki.js

@@ -51,7 +51,7 @@ Options:
   --goal, --state, --blocked       With --handoff-save, provide resume context fields.
   --next, --decision               With --handoff-save, repeat for next actions and decisions.
   --glossary-init                  Create and route the optional glossary page.
-  --agents <list>                  With init/update, write only selected agent surfaces: codex, claude, cursor, gemini, or all. Existing project skill/setup surfaces are preserved by default.
+  --agents <list>                  With init/update, write only selected agent surfaces: codex, claude, cursor, gemini, or all. Update preserves managed surfaces or existing agent roots by default.
   --prune-check                    Report active pages with stale or unresolved signals.
   --prune-check-strict             With --prune-check, omit age-only candidates and show only higher-signal lifecycle items.
   --review-migration               Sync unit coverage and compatible inbox statuses into migration review files.
@@ -75,7 +75,7 @@ Options:
 Commands:
   install                          Install the reusable Project Librarian skill files for selected agents.
   install-skill                    Compatibility alias for install.
-  update                           Run the idempotent wiki/setup update path, sync existing project-scoped skill installs, and reject migration flags.
+  update                           Update an existing install or detected agent root without creating unrelated agent surfaces; reject migration flags.
   mcp                              Run the stdio MCP server exposing answer-shaped code-evidence tools (code_context_pack, code_impact, code_ownership, code_workspace_graph, code_search, code_status) over the existing .project-wiki index.
 
   --help                           Show this help.`);
@@ -320,14 +320,18 @@ function runInitCommand() {
         runRefreshIndexOnlyMode();
         process.exit(0);
     }
-    const selectedAgentSurfaces = args_1.agentTargets.length > 0
-        ? args_1.agentTargets
-        : args_1.migrateMode
-            ? Array.from(agent_surfaces_1.allAgentSurfaces)
-            : (0, agent_surfaces_1.resolveBootstrapAgentSurfaces)(args_1.agentTargets, workspace_1.exists, workspace_1.read);
+    const agentSurfaceResolution = args_1.migrateMode
+        ? { source: "explicit", surfaces: Array.from(agent_surfaces_1.allAgentSurfaces) }
+        : (0, agent_surfaces_1.resolveBootstrapAgentSurfaces)(args_1.command === "update" ? "update" : "init", args_1.agentTargets, workspace_1.exists, workspace_1.read);
+    if (agentSurfaceResolution.source === "missing-update-target") {
+        console.error("update cannot detect an existing Project Librarian install or agent surface; use init for a fresh project or pass --agents explicitly.");
+        process.exit(1);
+    }
+    const selectedAgentSurfaces = agentSurfaceResolution.surfaces;
     const projectSkillSyncSurfaces = args_1.command === "update"
         ? (0, install_skill_1.installedProjectSkillSurfaces)().filter((surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface))
         : [];
+    const syncSharedProjectSkill = args_1.command === "update" && (0, install_skill_1.hasSharedProjectSkillInstall)();
     const shouldWriteSurface = (surface) => (0, agent_surfaces_1.includesAgentSurface)(selectedAgentSurfaces, surface);
     const writeCodexSurface = shouldWriteSurface("codex");
     const writeClaudeSurface = shouldWriteSurface("claude");
@@ -357,6 +361,10 @@ function runInitCommand() {
         for (const result of (0, install_skill_1.syncProjectSkillInstall)(surface))
             results.push(result);
     }
+    if (syncSharedProjectSkill) {
+        for (const result of (0, install_skill_1.syncSharedProjectSkillInstall)())
+            results.push(result);
+    }
     // B1 fallback: sync the CURRENT startup.md TL;DR into the managed AGENTS.md block
     // so non-interactive `codex exec` (which does not run SessionStart hooks) still
     // gets compact startup context. Routers are starter files written later in this

package/dist/install-skill.js

@@ -34,8 +34,11 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.projectSkillTarget = projectSkillTarget;
+exports.sharedProjectSkillTarget = sharedProjectSkillTarget;
 exports.installedProjectSkillSurfaces = installedProjectSkillSurfaces;
+exports.hasSharedProjectSkillInstall = hasSharedProjectSkillInstall;
 exports.syncProjectSkillInstall = syncProjectSkillInstall;
+exports.syncSharedProjectSkillInstall = syncSharedProjectSkillInstall;
 exports.runInstallSkillMode = runInstallSkillMode;
 const fs = __importStar(require("node:fs"));
 const os = __importStar(require("node:os"));
@@ -43,6 +46,7 @@ const path = __importStar(require("node:path"));
 const agent_surfaces_1 = require("./agent-surfaces");
 const args_1 = require("./args");
 const skillName = "project-librarian";
+const sharedProjectSkillRelativeRoot = path.join(".agents", "skills", skillName);
 const packageFiles = [
     "SKILL.md",
     "dist",
@@ -121,6 +125,9 @@ function projectSkillRelativeRoot(agent) {
 function projectSkillTarget(agent) {
     return path.join(process.cwd(), projectSkillRelativeRoot(agent));
 }
+function sharedProjectSkillTarget() {
+    return path.join(process.cwd(), sharedProjectSkillRelativeRoot);
+}
 function installTarget(agent, scope) {
     const base = scope === "user" ? userAgentRoot(agent) : path.join(process.cwd(), projectAgentRoot(agent));
     return path.join(base, "skills", skillName);
@@ -247,6 +254,9 @@ function copyPath(source, target, targetRoot, dryRun) {
 function installedProjectSkillSurfaces() {
     return agent_surfaces_1.allAgentSurfaces.filter((agent) => fs.existsSync(path.join(projectSkillTarget(agent), "SKILL.md")));
 }
+function hasSharedProjectSkillInstall() {
+    return fs.existsSync(path.join(sharedProjectSkillTarget(), "SKILL.md"));
+}
 function copyPackageFiles(targetRoot, dryRun, labelRoot = targetRoot) {
     const root = packageRoot();
     const packageRows = packageFiles.map((relativePath) => {
@@ -269,6 +279,13 @@ function syncProjectSkillInstall(agent) {
         return [label, status];
     });
 }
+function syncSharedProjectSkillInstall() {
+    return copyPackageFiles(sharedProjectSkillTarget(), false, sharedProjectSkillRelativeRoot).map(([label, status]) => {
+        if (status === "dry-run")
+            throw new Error("shared project skill sync does not support dry-run status");
+        return [label, status];
+    });
+}
 function runInstallSkillMode() {
     const scope = installScope();
     const agents = installAgents();

package/dist/native/project-librarian-indexer-manifest.json

@@ -21,8 +21,8 @@
       "architecture": "arm64",
       "format": "elf",
       "path": "dist/native/linux-arm64/project-librarian-indexer",
-      "sha256": "f3cc884acca4f5863fb6a6545a4a9f9a37a67872bfe780f4b14f0c4a8a667f16",
-      "size": 3065520,
+      "sha256": "88146d5bbe5b77bb53e2cbe872ad6d2a8a93a58fa1b53671841cc94463443f46",
+      "size": 3065568,
       "triple": "linux-arm64"
     },
     {
@@ -45,15 +45,15 @@
       "architecture": "x64",
       "format": "elf",
       "path": "dist/native/linux-x64-musl/project-librarian-indexer",
-      "sha256": "0055ec9fefa385d6d637fa1e457308c38f892e0fbdb389db3fcbdf546f0daca8",
-      "size": 3247400,
+      "sha256": "811221a87fe5d8ef9f67f4eafe4386ef7aa03bdc1601e89fa191c0e0d7b0dcd5",
+      "size": 3247424,
       "triple": "linux-x64-musl"
     },
     {
       "architecture": "arm64",
       "format": "pe",
       "path": "dist/native/win32-arm64/project-librarian-indexer.exe",
-      "sha256": "b49ad30a72a9a93ff524cc1643b141c94de4850655ce646d80579edc5b832f71",
+      "sha256": "3246ad92e1a78b80bf5779742c799bfe8f155f38415429a9af6dc399879c8fb2",
       "size": 2098688,
       "triple": "win32-arm64"
     },
@@ -61,7 +61,7 @@
       "architecture": "x64",
       "format": "pe",
       "path": "dist/native/win32-x64/project-librarian-indexer.exe",
-      "sha256": "36a8416e4975100f89bc57281b311b45158469fb12ea37d33dac2d5855a5e47a",
+      "sha256": "8ecf7bfde196e1e03f999a19e587d253ad758dfbc8b9e3305733899bb4aca207",
       "size": 2375680,
       "triple": "win32-x64"
     }

package/docs/cli-reference.md

@@ -9,7 +9,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 
 `install-skill` remains a compatibility alias for `install`.
 
-`update` is the explicit existing-project update command. It rejects `--migrate` and `--adopt-existing`; use top-level `--migrate` when legacy docs or wiki content should be preserved into `wiki_legacy*` and reviewed. When project-scoped Project Librarian skill installs already exist for the selected agent surfaces, `update` copies the current package's reusable skill files and required local-runner runtime dependencies into those project skill directories before refreshing the managed setup.
+`update` is the explicit existing-project update command. It rejects `--migrate` and `--adopt-existing`; use top-level `--migrate` when legacy docs or wiki content should be preserved into `wiki_legacy*` and reviewed. Without `--agents`, it first preserves Project Librarian-managed surfaces, then falls back to agent roots already present in the repository. It never falls back to all agents during update. If no install or agent root is detectable, it exits before writing and requires `init` or `--agents`. When project-scoped Project Librarian skill installs already exist for the selected agent surfaces, `update` copies the current package's reusable skill files and required local-runner runtime dependencies into those project skill directories before refreshing the managed setup. An existing shared `.agents/skills/project-librarian/` install is synchronized independently without selecting agent-specific setup surfaces.
 
 ### Important Options
 

package/docs/ko/cli-reference.md

@@ -9,7 +9,7 @@ node .codex/skills/project-librarian/dist/init-project-wiki.js install [--scope
 
 `install-skill`은 `install`의 호환성 별칭으로 계속 지원됩니다.
 
-`update`는 기존 프로젝트 갱신을 명시하는 명령입니다. `--migrate`와 `--adopt-existing`를 거부합니다. 기존 문서나 위키 내용을 `wiki_legacy*`로 보존하고 검토해야 한다면 top-level `--migrate`를 사용합니다. 선택된 에이전트 표면에 프로젝트 범위 Project Librarian 스킬 설치가 이미 있으면 `update`는 현재 패키지의 재사용 가능한 스킬 파일과 로컬 실행기에 필요한 필수 런타임 의존성을 해당 프로젝트 스킬 디렉터리에 복사한 뒤 관리 설정을 갱신합니다.
+`update`는 기존 프로젝트 갱신을 명시하는 명령입니다. `--migrate`와 `--adopt-existing`를 거부합니다. 기존 문서나 위키 내용을 `wiki_legacy*`로 보존하고 검토해야 한다면 top-level `--migrate`를 사용합니다. `--agents`가 없으면 Project Librarian이 관리 중인 표면을 먼저 보존하고, 관리 표면이 없을 때만 저장소에 이미 존재하는 에이전트 루트를 사용합니다. 업데이트에서는 전체 에이전트로 폴백하지 않습니다. 설치나 에이전트 루트를 하나도 감지하지 못하면 파일을 쓰기 전에 종료하고 `init` 또는 `--agents`를 요구합니다. 선택된 에이전트 표면에 프로젝트 범위 Project Librarian 스킬 설치가 이미 있으면 `update`는 현재 패키지의 재사용 가능한 스킬 파일과 로컬 실행기에 필요한 필수 런타임 의존성을 해당 프로젝트 스킬 디렉터리에 복사한 뒤 관리 설정을 갱신합니다. 기존 공유 `.agents/skills/project-librarian/` 설치는 에이전트별 설정 표면을 선택하지 않고 별도로 동기화합니다.
 
 ### 주요 옵션
 

package/docs/ko/usage.md

@@ -32,9 +32,9 @@ npx project-librarian@latest install --scope project --agents all
 
 프로젝트 설정/갱신 실행기도 `--agents`를 받습니다. 새 설정은 프로젝트 범위 Project Librarian 스킬 설치가 없을 때만 지원하는 모든 에이전트 표면을 기본으로 만듭니다. 저장소에 이미 `.codex/skills/project-librarian/`, `.claude/skills/project-librarian/` 같은 프로젝트 범위 스킬이 있으면 첫 설정도 그 설치된 에이전트 집합을 기본값으로 사용합니다.
 
-마이그레이션 없는 기존 설정 갱신은 저장소에 이미 있는 에이전트 표면만 보존해서 갱신합니다. 따라서 Codex와 Claude 파일만 있던 저장소는 일반 갱신만으로 Cursor나 Gemini 파일이 새로 생기지 않습니다. 새 표면을 의도적으로 추가하려면 `project-librarian update --agents cursor` 또는 `project-librarian update --agents all`처럼 명시합니다. 목록에 없는 표면을 삭제하지는 않습니다.
+마이그레이션 없는 기존 설정 갱신은 Project Librarian이 관리 중인 에이전트 표면을 보존해서 갱신합니다. 아직 관리 표면이 없으면 저장소에 이미 있는 에이전트 루트만 선택하므로, 설정 파일이 아직 없는 `.codex/` 저장소에는 Codex 설정만 추가되고 Claude, Cursor, Gemini 파일은 생기지 않습니다. 감지 가능한 설치나 에이전트 루트가 하나도 없는 업데이트는 파일을 쓰기 전에 종료합니다. 새 프로젝트에는 `init`을 사용하고, 대상을 직접 정하려면 `--agents`를 전달합니다. 새 표면을 의도적으로 추가하려면 `project-librarian update --agents cursor` 또는 `project-librarian update --agents all`처럼 명시합니다. 목록에 없는 표면을 삭제하지는 않습니다.
 
-`project-librarian update`는 선택된 표면에 이미 프로젝트 범위 Project Librarian 스킬 설치가 있으면 현재 실행 중인 패키지의 재사용 가능한 스킬 파일과 프로젝트 로컬 실행기에 필요한 런타임 의존성을 그 프로젝트 스킬 디렉터리로 동기화합니다. 기본적으로 새 프로젝트 범위 스킬 설치를 만들지는 않고, 사용자 범위 스킬 설치도 갱신하지 않습니다. 사용자 범위 스킬은 `install --scope user`로 명시적으로 갱신합니다.
+`project-librarian update`는 선택된 표면에 이미 프로젝트 범위 Project Librarian 스킬 설치가 있으면 현재 실행 중인 패키지의 재사용 가능한 스킬 파일과 프로젝트 로컬 실행기에 필요한 런타임 의존성을 그 프로젝트 스킬 디렉터리로 동기화합니다. 기존 공유 `.agents/skills/project-librarian/` 설치는 별도로 동기화하며 Codex, Claude, Cursor, Gemini 설정 표면을 암묵적으로 추가하지 않습니다. 기본적으로 새 프로젝트 범위 스킬 설치를 만들지는 않고, 사용자 범위 스킬 설치도 갱신하지 않습니다. 사용자 범위 스킬은 `install --scope user`로 명시적으로 갱신합니다.
 
 ## 실행 경로
 
@@ -42,6 +42,7 @@ npx project-librarian@latest install --scope project --agents all
 
 | 설치 위치 | 실행 경로 |
 | --- | --- |
+| 공유 프로젝트 범위 스킬 | `node .agents/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Codex 스킬 | `node .codex/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Claude 스킬 | `node .claude/skills/project-librarian/dist/init-project-wiki.js` |
 | 프로젝트 범위 Cursor 스킬 | `node .cursor/skills/project-librarian/dist/init-project-wiki.js` |

package/docs/usage.md

@@ -30,9 +30,9 @@ npx project-librarian@latest install --scope project --agents all
 
 `--agents` accepts comma-separated values such as `codex,claude,cursor,gemini`. `all` targets every supported agent. `--scope` accepts `user` or `project`.
 
-The project setup/update runner also accepts `--agents`. Fresh setup defaults to all supported agent surfaces only when no project-scoped Project Librarian skill install is present. If the repository already has project-scoped skills such as `.codex/skills/project-librarian/` and `.claude/skills/project-librarian/`, the first setup uses that installed agent set by default. Existing non-migration updates preserve the agent surfaces already present in the repository, so a repo that has only Codex and Claude files will not gain Cursor or Gemini files on a plain update. Use `project-librarian update --agents cursor` or `project-librarian update --agents all` when you intentionally want to add newly supported surfaces; unlisted surfaces are not deleted.
+The project setup/update runner also accepts `--agents`. Fresh setup defaults to all supported agent surfaces only when no project-scoped Project Librarian skill install is present. If the repository already has project-scoped skills such as `.codex/skills/project-librarian/` and `.claude/skills/project-librarian/`, the first setup uses that installed agent set by default. Existing non-migration updates preserve Project Librarian-managed surfaces. If no managed surface exists yet, update selects only agent roots already present, so a bare `.codex/` repository gains the Codex setup without gaining Claude, Cursor, or Gemini files. An update with no detectable install or agent root exits before writing; use `init` for a fresh project or pass `--agents`. Use `project-librarian update --agents cursor` or `project-librarian update --agents all` when you intentionally want to add newly supported surfaces; unlisted surfaces are not deleted.
 
-`project-librarian update` also syncs any project-scoped Project Librarian skill installs that already exist for the selected surfaces from the currently running package, including the runtime dependencies needed by the project-local runner. This means `npx project-librarian@latest update` can refresh the repository's managed setup, hooks, wiki meta files, and existing project-scoped skill copies without migration. It does not create new project-scoped skill installs by default and does not update user-scoped skill installs; use `install --scope user` for that.
+`project-librarian update` also syncs any project-scoped Project Librarian skill installs that already exist for the selected surfaces from the currently running package, including the runtime dependencies needed by the project-local runner. An existing shared `.agents/skills/project-librarian/` install is synchronized independently and does not imply Codex, Claude, Cursor, or Gemini setup surfaces. This means `npx project-librarian@latest update` can refresh the repository's managed setup, hooks, wiki meta files, and existing project-scoped skill copies without migration. It does not create new project-scoped skill installs by default and does not update user-scoped skill installs; use `install --scope user` for that.
 
 ## Runner Paths
 
@@ -40,6 +40,7 @@ These paths are mainly for agents and automation. After installation, agents sho
 
 | Installation | Runner |
 | --- | --- |
+| Shared project-scoped skill | `node .agents/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Codex skill | `node .codex/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Claude skill | `node .claude/skills/project-librarian/dist/init-project-wiki.js` |
 | Project-scoped Cursor skill | `node .cursor/skills/project-librarian/dist/init-project-wiki.js` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "project-librarian",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Create and maintain compact project context for humans and LLM coding agents.",
   "license": "MIT",
   "type": "commonjs",