@taejung3852/project-scaffold 0.1.2 → 0.1.4

package/README.kr.md

@@ -181,7 +181,7 @@ npx @taejung3852/project-scaffold@latest agents
 
 전체 목록과 실제 설치 경로는 위 명령으로 확인한다. `--agent all`과 `--agent '*'`도 지원한다.
 
-CLI는 루트 `skills/{wiki,brief,review}`를 한 번 설치한 뒤 같은 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 `.agents/skills/`를 기본값으로 사용한다. `claude`, `hermes`, `gemini`, `agy` 같은 별칭도 지원한다. Gemini CLI, Antigravity CLI, Antigravity 2.0은 제품 표면과 전역 스킬 경로가 다르므로 레지스트리에서는 별도 대상으로 유지한다.
+CLI는 루트 `skills/{wiki,brief,review}`를 한 번 설치한 뒤 같은 프로젝트 경로를 사용하는 에이전트를 묶어서 상대 심링크를 생성한다. 대화형 선택에서는 `.agents/skills/`를 사용하는 에이전트가 `universal` 공용 그룹 하나로 표시되고, 전용 프로젝트 경로가 필요한 에이전트만 별도 선택지로 표시된다. `--agent`를 생략하면 로컬 설치 흔적을 감지해 후보를 추천하고, 감지하지 못하면 범용 그룹을 기본값으로 사용한다. `claude`, `hermes`, `gemini`, `agy` 같은 별칭도 지원한다. Gemini CLI, Antigravity CLI, Antigravity 2.0은 제품 표면과 전역 스킬 경로가 다르므로 레지스트리에서는 별도 대상으로 유지한다.
 
 ## 설치되는 구조
 

package/README.md

@@ -181,7 +181,7 @@ npx @taejung3852/project-scaffold@latest agents
 
 Use this command to see every ID and path. `--agent all` and `--agent '*'` are also supported.
 
-The CLI installs canonical `skills/{wiki,brief,review}` once and deduplicates agents that share the same target directory. Without `--agent`, it recommends reliably detected local agents and falls back to universal `.agents/skills/` when none are found. Existing aliases such as `claude`, `hermes`, `gemini`, and `agy` remain supported. Google agents are kept as separate registry targets because Gemini CLI, Antigravity CLI, and Antigravity 2.0 use different product surfaces and global skill paths.
+The CLI installs canonical `skills/{wiki,brief,review}` once and deduplicates agents that share the same target directory. In the interactive flow, agents that share `.agents/skills/` are selected as one `universal` group; only agents with dedicated project paths appear as separate options. Without `--agent`, it recommends reliably detected local agents and falls back to the universal group when none are found. Existing aliases such as `claude`, `hermes`, `gemini`, and `agy` remain supported. Google agents are kept as separate registry targets because Gemini CLI, Antigravity CLI, and Antigravity 2.0 use different product surfaces and global skill paths.
 
 ## Installed structure
 

package/lib/agents.js

@@ -17,6 +17,7 @@ import {
 } from "@clack/prompts";
 
 export const supportedAgents = supportedAgentIds;
+const universalProjectSkillsDir = ".agents/skills";
 
 function writeFileSafely(file, content, force, managedFiles) {
   if (fs.existsSync(file) && !force) return false;
@@ -121,6 +122,71 @@ export function registryLines() {
   return lines;
 }
 
+function isUniversalProjectAgent(agentId) {
+  return agentRegistry[agentId]?.projectSkillsDir === universalProjectSkillsDir;
+}
+
+const universalProjectAgents = supportedAgentIds.filter(isUniversalProjectAgent);
+
+export function buildAgentSelectionOptions(detected = []) {
+  const detectedSet = new Set(detected);
+  const dedicatedAgents = supportedAgentIds.filter((agent) => !isUniversalProjectAgent(agent));
+  const universalNames = universalProjectAgents
+    .map((agent) => agentRegistry[agent]?.displayName ?? agent)
+    .filter(Boolean);
+  const previewNames = universalNames.slice(0, 4).join(", ");
+
+  return [
+    {
+      value: "all",
+      label: "모든 에이전트",
+      hint: `${supportedAgentIds.length}개 설치`,
+    },
+    {
+      value: "universal",
+      label: "공용 Agent Skills",
+      hint: `${universalProjectSkillsDir} · ${previewNames} 등 ${universalNames.length}개`,
+    },
+    ...dedicatedAgents.map((agent) => {
+      const entry = agentRegistry[agent];
+      return {
+        value: agent,
+        label: entry?.displayName ?? agent,
+        hint: detectedSet.has(agent)
+          ? `감지됨 · ${entry?.projectSkillsDir ?? ""}`
+          : entry?.projectSkillsDir,
+      };
+    }),
+  ];
+}
+
+export function agentSelectionSummary() {
+  const universalNames = universalProjectAgents
+    .map((agent) => agentRegistry[agent]?.displayName ?? agent)
+    .filter(Boolean);
+  const dedicatedAgents = supportedAgentIds.filter((agent) => !isUniversalProjectAgent(agent));
+  const dedicatedNames = dedicatedAgents
+    .map((agent) => `${agentRegistry[agent]?.displayName ?? agent} (${agentRegistry[agent]?.projectSkillsDir})`)
+    .filter(Boolean);
+
+  return [
+    "\n에이전트 설치 대상",
+    `  공용 그룹 · ${universalProjectSkillsDir} (${universalNames.length}개)`,
+    `    ${universalNames.join(", ")}`,
+    `  전용 그룹 · 에이전트별 경로 (${dedicatedNames.length}개)`,
+    `    ${dedicatedNames.join(", ")}`,
+  ];
+}
+
+export function buildAgentSelectionDefaults(detected = []) {
+  const detectedUniversal = detected.some(isUniversalProjectAgent);
+  const dedicatedDetected = detected.filter((agent) => !isUniversalProjectAgent(agent));
+  return [
+    ...(detectedUniversal || detected.length === 0 ? ["universal"] : []),
+    ...dedicatedDetected,
+  ];
+}
+
 export async function chooseAgents(
   values,
   yes = false,
@@ -131,44 +197,24 @@ export async function chooseAgents(
   }
 
   const detected = detectAgents({ target });
-  const defaults = detected.length > 0 ? detected : ["universal"];
+  const defaults = buildAgentSelectionDefaults(detected);
 
   if (yes || !process.stdin.isTTY) {
     return defaults;
   }
 
   if (detected.length > 0) {
-    console.log(`\n감지된 에이전트: ${detected.join(", ")}`);
+    const detectedLabels = detected.map((agent) => agentRegistry[agent]?.displayName ?? agent);
+    console.log(`\n감지된 에이전트: ${detectedLabels.join(", ")}`);
   } else {
     console.log("\n자동 감지된 에이전트가 없습니다.");
   }
 
-  const orderedAgents = [
-    ...defaults,
-    ...supportedAgentIds.filter(
-      (agent) => !defaults.includes(agent),
-    ),
-  ];
+  console.log(agentSelectionSummary().join("\n"));
 
   const selected = await multiselect({
-    message: "설치할 에이전트를 선택하세요",
-    options: [
-      {
-        value: "all",
-        label: "모든 에이전트",
-        hint: `${supportedAgentIds.length}개 설치`,
-      },
-      ...orderedAgents.map((agent) => {
-        const entry = agentRegistry[agent];
-        return {
-          value: agent,
-          label: entry?.displayName ?? agent,
-          hint: detected.includes(agent)
-            ? `감지됨 · ${entry?.projectSkillsDir ?? ""}`
-            : entry?.projectSkillsDir,
-        };
-      }),
-    ],
+    message: "설치할 스킬 경로를 선택하세요",
+    options: buildAgentSelectionOptions(detected),
     initialValues: defaults,
     required: true,
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@taejung3852/project-scaffold",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "LLM Wiki-based project context scaffold for AI coding agents",
   "type": "module",
   "bin": {