projectops 4.2.12 → 4.2.14

package/README.md

@@ -7,7 +7,7 @@
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.2.11 (2026-07-12)
+## 최신 버전 : v4.2.13 (2026-07-12)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.2.12",
+  "version": "4.2.14",
   "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -3,6 +3,7 @@ import { VALID_TYPES } from "../context.js";
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+export const INTENT_VALUES = ["app", "library", "both", "none", "manual"];
 
 // argv(process.argv.slice(2)) → 파싱 결과. 오류 시 throw(호출부에서 exit 1).
 export function parseArgs(argv) {
@@ -14,6 +15,7 @@ export function parseArgs(argv) {
     deployTarget: null,      // 배포 축 (#439): docker-ssh|vercel|none, null=미설정
     publishTargets: null,    // publish 축 (#439): 타겟 배열, null=미설정
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
+    intent: null,            // 프로젝트 성격 (#485): --intent app|library|both|none|manual, null=미설정(역추론)
     includeSecretBackup: null,
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
@@ -79,6 +81,15 @@ export function parseArgs(argv) {
         if (v) result.deployBranch = v;
         break;
       }
+      case "--intent": {
+        // 프로젝트 성격 (#485). 미지정이면 --deploy/--publish에서 역추론.
+        const v = (args.shift() ?? "").trim();
+        if (!INTENT_VALUES.includes(v)) {
+          throw new CliError(`--intent 값은 ${INTENT_VALUES.join(" | ")} 중 하나여야 합니다: '${v}'`);
+        }
+        result.intent = v;
+        break;
+      }
       // ── deprecated alias (1 minor 유지 — #439) ──
       case "--nexus":
         process.stderr.write("⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.\n");

package/src/cli/help.js

@@ -13,6 +13,8 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
                            (next는 react로 흡수됨 — Next.js 프로젝트는 react 사용)
       --project-version V  통합 대상의 초기 버전 (예: 1.0.0). 미지정 시 자동 감지
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
+      --intent KIND        프로젝트 성격(#485): app | library | both | none | manual
+                           (미지정 시 --deploy/--publish에서 역추론. library/none→deploy 제외, app/none→publish 제외)
       --deploy TARGET      배포 방식 택1: docker-ssh(기본) | vercel | none
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
       --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개

package/src/commands/full.js

@@ -24,7 +24,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     force = true, now, today, templateVersion = "unknown",
     deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
     changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
-    deployBranch = "" } = context;
+    deployBranch = "", intent = null } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -41,7 +41,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
       version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
       templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
-        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit, intent },
     }));
 
   // 2. README 버전 섹션

package/src/commands/interactive.js

@@ -12,7 +12,7 @@ import { parseExisting } from "../core/version-yml.js";
 import { runBreakingCheck } from "../core/breaking-check.js";
 import { runMigrations } from "../core/migrations/index.js";
 import { resolveProjectPaths } from "../core/paths-resolve.js";
-import { askAllOptionalWorkflows } from "../core/options-ask.js";
+import { askAllOptionalWorkflows, OPTION_AXES } from "../core/options-ask.js";
 import { promptEnvPlan } from "../ui/env-plan.js";
 import { listWorkflowConflicts } from "../core/copy/workflows.js";
 import { createContext, VALID_TYPES } from "../context.js";
@@ -88,6 +88,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
     let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
     let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
+    let intent = existing?.options?.intent ?? null; // #485 프로젝트 성격
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
 
@@ -104,6 +105,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider: existing?.options?.changelogProvider ?? null,
           changelogBaseUrl: existing?.options?.changelogBaseUrl ?? null,
           deployBranch: existing?.options?.deployBranch ?? null,
+          intent: existing?.options?.intent ?? null,
         },
         force: false, tty: realTty,
         io: {
@@ -120,6 +122,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       changelogProvider = r.changelogProvider;
       changelogBaseUrl = r.changelogBaseUrl;
       deployBranch = r.deployBranch;
+      intent = r.intent;
     }
 
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
@@ -159,15 +162,15 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
         } else if (what === "branch") {
           const b = await io.askText("기본 브랜치", branch);
           if (!isCancel(b) && b) branch = b;
-        } else if (what === "deploy-publish") {
-          // 배포/publish 축 재질문 (#439 — forceAsk)
+        } else if (OPTION_AXES.includes(what)) {
+          // #483 — 선택한 축 하나만 재질문 (scope). 나머지 옵션은 현재값 그대로 유지.
           const r = await askAllOptionalWorkflows({
             tempDir, types, targetRoot: cwd, defaultBranch: branch,
             current: {
               deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup,
-              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch,
+              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
             },
-            force: false, tty: realTty, forceAsk: true,
+            force: false, tty: realTty, forceAsk: true, scope: [what],
             io: {
               confirm: ({ message, initialValue }) => io.askYesNo(message, initialValue),
               select: io.engineIo?.select,
@@ -182,9 +185,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           changelogProvider = r.changelogProvider;
           changelogBaseUrl = r.changelogBaseUrl;
           deployBranch = r.deployBranch;
-        } else if (what === "secret") {
-          const y = await io.askYesNo("Secret 백업 워크플로우를 포함할까요?", includeSecretBackup);
-          if (!isCancel(y)) includeSecretBackup = y === true;
+          intent = r.intent;
         }
       }
     }
@@ -214,7 +215,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     const { now, today } = clock || utcNow();
     const ctx = createContext({
       mode, force: true, types, version, versionCode, branch, paths, deployTarget, publishTargets, includeSecretBackup,
-      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch,
+      codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch, intent,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     });
     ctx.templateVersion = templateVersion;

package/src/context.js

@@ -24,6 +24,7 @@ export function createContext(overrides = {}) {
     changelogBaseUrl: null,  // ollama일 때만 값
     codeReviewCoderabbit: null,
     deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력
+    intent: null,            // 프로젝트 성격 (#485 — app/library/both/none/manual). null=미설정(역추론)
     templateVersion: "",
     tempDir: "",
     deployValues: new Map(), // "type.KEY" -> value

package/src/core/options-ask.js

@@ -10,7 +10,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { listYamlFiles } from "./fsutil.js";
 import { PATHS } from "./paths.js";
-import { parseTemplateOptions } from "./version-yml.js";
+import { parseTemplateOptions, inferIntent } from "./version-yml.js";
 import { branchStatus, createBranch, pushBranch } from "./git-branch.js";
 
 // 개발(배포) 브랜치 존재 확인 + 생성 제안 (#477) — 대화형 전용.
@@ -24,7 +24,7 @@ export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "",
     say(`ℹ️ '${deployBranch}' 브랜치가 원격에는 있고 로컬에 없습니다 — 필요 시 'git switch ${deployBranch}'로 가져오세요.`);
     return { created: false, pushed: false };
   }
-  say(`⚠️ 배포 브랜치 '${deployBranch}'가 없습니다 — 릴리스 파이프라인(${deployBranch}→${defaultBranch || "기본 브랜치"} PR)이 동작하려면 필요합니다.`);
+  say(`⚠️ 개발(릴리스 소스) 브랜치 '${deployBranch}'가 없습니다 — 릴리스(${deployBranch}→${defaultBranch || "기본 브랜치"} PR)가 동작하려면 필요합니다.`);
   const mk = await io.confirm({ message: `${defaultBranch || "현재"} 브랜치에서 '${deployBranch}' 브랜치를 만들까요?`, initialValue: true });
   if (mk !== true) {
     say(`→ 건너뜁니다. 나중에 직접: git checkout -b ${deployBranch} && git push -u origin ${deployBranch}`);
@@ -35,7 +35,8 @@ export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "",
     return { created: false, pushed: false };
   }
   say(`✅ 로컬 브랜치 '${deployBranch}' 생성 완료 (checkout은 하지 않았습니다)`);
-  const up = await io.confirm({ message: "원격(origin)에도 push할까요?", initialValue: true });
+  // #481 — push 질문에 브랜치명 명시 ("어느 브랜치를 push하는지" 불명확 방지)
+  const up = await io.confirm({ message: `원격(origin)에 '${deployBranch}' 브랜치도 push할까요?`, initialValue: true });
   if (up !== true) return { created: true, pushed: false };
   if (pushBranch(targetRoot, deployBranch)) {
     say(`✅ origin/${deployBranch} push 완료`);
@@ -85,15 +86,28 @@ async function askOptionalWorkflow({ dir, icon, short, desc, current, force, tty
   return include;
 }
 
+// 옵션 질문의 축 키 (#483 수정 스코프 단위) — 수정 메뉴가 이 단위로 한 축만 재질문한다.
+// intent(#485)는 프로젝트 성격 — 재질문 시 deploy/publish 축을 재유도한다.
+export const OPTION_AXES = ["intent", "deploy", "publish", "code-review", "changelog", "release-branch", "secret"];
+
+// intent → 어떤 배포 축을 물을지 (#485). manual은 둘 다(기존 순차 질문), 나머지는 유도.
+const INTENT_ASKS_DEPLOY = { app: true, both: true, manual: true, library: false, none: false };
+const INTENT_ASKS_PUBLISH = { library: true, both: true, manual: true, app: false, none: false };
+
 // 배포/publish 축 + Secret 백업을 순서대로 질문 (.sh ask_all_optional_workflows 등가).
 // tempDir: 템플릿 다운로드 루트 — project-types는 {tempDir}/.github/workflows/project-types
 // current: { deploy: string|null, publish: string[]|null, secretBackup: bool|null } — CLI 명시값
-// 반환: { deploy: string, publish: string[], secretBackup: bool }
+// scope: null이면 전 축(초기 통합·전체 재질문). Set/배열이면 그 축만 forceAsk 대상 (#483 수정 메뉴 격리).
+//        스코프 밖 축은 forceAsk여도 current/저장값을 그대로 유지하고 다시 묻지 않는다.
+// 반환: { deploy, publish, secretBackup, codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch }
 export async function askAllOptionalWorkflows({
   tempDir, types = [], current = {}, targetRoot = ".",
-  force = false, tty = true, io = {}, forceAsk = false, defaultBranch = "",
+  force = false, tty = true, io = {}, forceAsk = false, defaultBranch = "", scope = null,
 }) {
   const say = io.log || ((m) => process.stderr.write(`${m}\n`));
+  // 축별 재질문 여부: 전역 forceAsk이고, scope가 없거나 그 축을 포함할 때만 강제 질문.
+  const scopeSet = scope == null ? null : new Set(scope);
+  const ask = (axis) => forceAsk && (scopeSet === null || scopeSet.has(axis));
   let deploy = current.deploy ?? null;
   let publish = current.publish ?? null;
   let secretBackup = current.secretBackup ?? null;
@@ -101,6 +115,7 @@ export async function askAllOptionalWorkflows({
   let changelogProvider = current.changelogProvider ?? null;
   let changelogBaseUrl = current.changelogBaseUrl ?? null;
   let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
+  let intent = current.intent ?? null; // #485 프로젝트 성격 (app/library/both/none/manual)
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
   // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
@@ -131,44 +146,99 @@ export async function askAllOptionalWorkflows({
       if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
       // #456 deploy_branch 저장값 재사용
       if (deployBranch === null && saved.deployBranch != null) deployBranch = saved.deployBranch;
+      // #485 intent 저장값 재사용 — 없으면 저장된 deploy/publish에서 역추론(구 version.yml 하위호환)
+      if (intent === null) intent = saved.intent ?? inferIntent(saved.deploy, saved.publish);
     }
   }
 
-  // ── ② 배포 방식 (택1) — basic 단독이면 질문 스킵, none으로 확정 ──
+  // ── ② intent(프로젝트 성격) 우선 분기 → 배포 축 유도 (#485) ──
+  // basic 단독이면 intent 개념 자체가 없어 질문 스킵, none/[]로 확정.
   if (isBasicOnly) {
     if (deploy === null) deploy = "none";
     if (publish === null) publish = [];
+    intent = "none";
   } else {
-    if (forceAsk || deploy === null) {
+    // 수정 메뉴에서 deploy/publish 축만 콕 집어 고칠 때(scope에 그 축이 있고 intent는 없음)는
+    // intent 질문·게이팅을 건너뛰고 그 축만 바로 편집한다 (#483 격리 존중). intent는 값 유지·역추론.
+    const scopedAxisOnly = scopeSet !== null && !scopeSet.has("intent");
+    if (scopedAxisOnly) {
+      if (intent === null) intent = inferIntent(deploy, publish) ?? "manual";
+    } else {
+      // intent 질문: 미확정이거나(초기 통합) intent 축을 강제 재질문(수정 메뉴 "프로젝트 성격")일 때.
+      const askIntent = ask("intent") || intent === null;
+      if (askIntent) {
+        if (force || !tty || typeof io.select !== "function") {
+          // 비대화형: CLI intent 미지정이면 deploy/publish에서 역추론, 그래도 없으면 manual(기존 동작)
+          intent = intent ?? inferIntent(deploy, publish) ?? "manual";
+        } else {
+          say("");
+          say("🧭 이 프로젝트는 어떤 성격인가요? (배포 관련 질문을 여기에 맞춰 좁혀드립니다)");
+          const ans = await io.select({
+            message: "프로젝트 성격을 선택하세요",
+            options: [
+              { value: "app", label: "서버/호스팅에 올려 돌리는 앱·서비스 (배포만)" },
+              { value: "library", label: "남이 가져다 쓰는 라이브러리/패키지 (publish만)" },
+              { value: "both", label: "둘 다 (서버로도 돌리고 라이브러리로도 냄)" },
+              { value: "none", label: "배포 안 함 (CI·빌드 검증만)" },
+              { value: "manual", label: "직접 하나씩 고를게요 (모든 옵션 개별 질문)" },
+            ],
+          });
+          intent = (!isCancel(ans) && INTENT_ASKS_DEPLOY[ans] !== undefined) ? ans : (intent ?? "manual");
+          say(`프로젝트 성격: ${intent}`);
+        }
+        // intent 확정 후 유도: 안 묻는 축은 값 확정, 묻는 축은 재질문 대상으로 되돌린다.
+        if (!INTENT_ASKS_DEPLOY[intent]) deploy = "none";
+        if (!INTENT_ASKS_PUBLISH[intent]) publish = [];
+        if (INTENT_ASKS_DEPLOY[intent] && ask("intent")) deploy = null;
+        if (INTENT_ASKS_PUBLISH[intent] && ask("intent")) publish = null;
+      }
+    }
+    // intent가 정해진 뒤, 유도 규칙에 따라 각 축을 물을지 결정 (#485).
+    // scopedAxisOnly(수정 메뉴 단일 축)면 intent 게이트를 무시하고 그 축을 편집하게 한다.
+    const deployGate = scopedAxisOnly ? true : INTENT_ASKS_DEPLOY[intent];
+    const publishGate = scopedAxisOnly ? true : INTENT_ASKS_PUBLISH[intent];
+    const willAskDeploy = deployGate && (ask("deploy") || deploy === null);
+    const willAskPublish = publishGate && (ask("publish") || publish === null);
+    // 유도로 안 묻는 축은 기본값 확정.
+    if (!deployGate && deploy === null) deploy = "none";
+    if (!publishGate && publish === null) publish = [];
+    // manual(직접 고르기)에서 둘 다 물을 땐 두 축이 별개임을 한 번 안내 (#480 계승).
+    if (intent === "manual" && willAskDeploy && willAskPublish && tty && typeof io.select === "function") {
+      say("");
+      say("🧭 배포는 두 가지가 따로 있습니다 — 서로 독립이라 각각 답하시면 됩니다:");
+      say("   1) 실행물 배포 — 서버/호스팅에 올려 돌리는 것 (Docker, Vercel …)");
+      say("   2) 라이브러리 배포(publish) — 남이 가져다 쓰게 레지스트리에 내는 것 (Nexus, npm …)");
+    }
+    if (willAskDeploy) {
       if (force || !tty || typeof io.select !== "function") {
         deploy = deploy ?? "docker-ssh";
       } else {
         say("");
-        say("🚀 이 프로젝트를 어디에 배포하나요?");
-        say("   서버·호스팅에 올릴 계획이 있으면 고르고, 지금 없으면 '배포 안 함'으로 두면 됩니다.");
+        say("🚀 (1) 실행물(서버/앱)을 어디에 올리나요?");
+        say("   서버·호스팅에 올릴 계획이 있으면 고르고, 없으면 '서버에 올리지 않음'으로 두세요.");
         const ans = await io.select({
-          message: "배포 방식을 선택하세요",
+          message: "실행물 배포 방식을 선택하세요",
           options: [
             { value: "docker-ssh", label: "Docker + SSH 서버 배포 (기본)" },
             { value: "vercel", label: "Vercel" },
-            { value: "none", label: "배포하지 않음 (라이브러리/CI 전용)" },
+            { value: "none", label: "서버에 올리지 않음 (빌드 검증만 · 라이브러리는 다음에서 선택)" },
           ],
         });
         deploy = (!isCancel(ans) && DEPLOY_TARGETS.includes(ans)) ? ans : (deploy ?? "docker-ssh");
-        say(`배포 방식: ${deploy}`);
+        say(`실행물 배포: ${deploy}`);
       }
     }
 
     // ── ③ publish 타겟 (다중 선택) ──
-    if (forceAsk || publish === null) {
+    if (willAskPublish) {
       if (force || !tty || typeof io.multiselect !== "function") {
         publish = publish ?? [];
       } else {
         say("");
-        say("📦 라이브러리로 배포(publish)할 계획이 있나요?");
-        say("   사내 Nexus·npmjs·GitHub Packages 중 해당되는 걸 고르세요. 없으면 그냥 Enter.");
+        say("📦 (2) 이 프로젝트를 남이 가져다 쓰는 라이브러리로도 배포(publish)하나요?");
+        say("   (1) 실행물 배포와 별개입니다. 해당되는 걸 고르고, 라이브러리 배포를 안 하면 아무것도 고르지 말고 Enter.");
         const ans = await io.multiselect({
-          message: "publish 타겟을 선택하세요 (Space 토글, Enter 확정)",
+          message: "라이브러리 배포 타겟 (없으면 선택 없이 Enter = 배포 안 함)",
           options: [
             { value: "nexus", label: "사내 Maven(Nexus) 라이브러리 배포" },
             { value: "npm", label: "공개 npmjs 패키지 배포 (NPM_TOKEN)" },
@@ -180,13 +250,13 @@ export async function askAllOptionalWorkflows({
         publish = (!isCancel(ans) && Array.isArray(ans))
           ? ans.filter((t) => PUBLISH_TARGETS.includes(t))
           : (publish ?? []);
-        say(`Publish 타겟: ${publish.join(",") || "없음"}`);
+        say(publish.length ? `라이브러리 배포: ${publish.join(", ")}` : "라이브러리 배포: 안 함");
       }
     }
   }
 
   // ── code_review: CodeRabbit AI 코드 리뷰 (changelog와 무관 — #455) ──
-  if (forceAsk || codeReviewCoderabbit === null) {
+  if (ask("code-review") || codeReviewCoderabbit === null) {
     if (force || !tty || typeof io.confirm !== "function") {
       codeReviewCoderabbit = codeReviewCoderabbit ?? false;
     } else {
@@ -195,24 +265,33 @@ export async function askAllOptionalWorkflows({
       const ans = await io.confirm({ message: "CodeRabbit AI 코드 리뷰 사용", initialValue: false });
       codeReviewCoderabbit = (ans === true && !isCancel(ans));
       say(`CodeRabbit 코드 리뷰: ${codeReviewCoderabbit ? "사용" : "미사용"}`);
+      // #481 — "사용"만으로는 안 붙는다. 앱 설치 + 레포 접근 권한이 있어야 실제로 리뷰가 달린다.
+      if (codeReviewCoderabbit) {
+        say("   ⚠️ 실제로 리뷰가 붙으려면 추가 설정이 필요합니다:");
+        say("      1) https://coderabbit.ai 접속 → GitHub으로 로그인");
+        say("      2) CodeRabbit GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
+        say("      (이 단계를 안 하면 워크플로우는 켜져도 PR에 리뷰 댓글이 달리지 않습니다)");
+      }
     }
   }
 
   // ── changelog: 릴리스 노트 생성기 (기본 커서 = github-ai — #455) ──
-  if (forceAsk || changelogProvider === null) {
+  if (ask("changelog") || changelogProvider === null) {
     if (force || !tty || typeof io.select !== "function") {
       changelogProvider = changelogProvider ?? "github-ai";
     } else {
       say("");
-      say("📝 릴리스 노트(changelog)는 뭘로 만들까요?");
+      say("📝 릴리스 노트(changelog)는 1순위로 뭘로 만들까요?");
       say("   GitHub AI는 설정 없이 바로 됩니다. 나머지는 나중에 GitHub Secret 등록이 필요할 수 있어요.");
+      // #481 — 하나만 골라야 하는 게 아니다. 고른 게 실패하면 자동 폴백하므로 안심하고 고르라고 안내.
+      say("   ✅ 고른 방식이 실패해도 자동으로 GitHub AI → 커밋 분석 순으로 폴백하니 릴리스 노트는 항상 생성됩니다.");
       const ans = await io.select({
-        message: "changelog 생성기를 선택하세요",
+        message: "1순위 changelog 생성기를 선택하세요 (실패 시 자동 폴백)",
         options: [
           { value: "github-ai", label: "GitHub AI (추천 · 설정 불필요)" },
           { value: "coderabbit", label: "CodeRabbit" },
           { value: "openai", label: "OpenAI 호환 API (키 등록 필요)" },
-          { value: "commit", label: "커밋 분석만 (AI 없음)" },
+          { value: "commit", label: "커밋 분석만 (AI 없음 · 최후 안전망)" },
         ],
       });
       changelogProvider = (!isCancel(ans) && CHANGELOG_PROVIDERS.includes(ans)) ? ans : (changelogProvider ?? "github-ai");
@@ -221,7 +300,7 @@ export async function askAllOptionalWorkflows({
   }
 
   // ollama 선택 시에만 base_url 질문 (나머지 provider는 preset base_url 자동 — #455)
-  if (changelogProvider === "ollama" && (forceAsk || changelogBaseUrl === null || changelogBaseUrl === "")) {
+  if (changelogProvider === "ollama" && (ask("changelog") || changelogBaseUrl === null || changelogBaseUrl === "")) {
     if (force || !tty || typeof io.text !== "function") {
       changelogBaseUrl = changelogBaseUrl ?? "";
     } else {
@@ -233,18 +312,21 @@ export async function askAllOptionalWorkflows({
     changelogBaseUrl = "";
   }
 
-  // ── deploy_branch: 릴리스 PR의 head 브랜치 (#456 — default_branch와 별개) ──
-  //    대부분 develop→main 릴리스 구조라 기본값 develop. 다른 head를 쓰는 레포를 위해 물어본다.
-  if (forceAsk || deployBranch === null) {
+  // ── 릴리스 소스(개발) 브랜치 (#456 필드 deploy_branch — 이름과 달리 "개발 브랜치"다, #482) ──
+  //    이 값은 릴리스 PR(개발→기본)의 head, 즉 개발한 걸 모아 기본 브랜치로 올리는 브랜치다.
+  //    "배포 브랜치"가 아니다 — 배포가 도는 곳은 기본 브랜치(default) 쪽 개념. #482 참조.
+  if (ask("release-branch") || deployBranch === null) {
     if (force || !tty || typeof io.text !== "function") {
       deployBranch = deployBranch ?? "develop";
     } else {
+      const base = defaultBranch || "main"; // git으로 감지된 기본 브랜치 (#481 동적 안내)
       say("");
-      say("🌿 릴리스 배포 브랜치(릴리스 PR의 head)는 무엇인가요?");
-      say("   develop→main 릴리스 구조면 develop 그대로 두세요. 배포 브랜치가 따로면 그 이름을 적어주세요.");
-      const ans = await io.text({ message: "배포 브랜치", initialValue: deployBranch ?? "develop" });
+      say("🌿 개발한 코드를 모아서 배포로 올리는 '개발 브랜치'는 무엇인가요?");
+      say(`   감지된 기본(배포) 브랜치는 '${base}'입니다. 개발은 보통 그 앞단 브랜치(예: develop)에서 모아 올립니다.`);
+      say("   특별한 이유가 없으면 develop 그대로 두세요.");
+      const ans = await io.text({ message: "개발(릴리스 소스) 브랜치", initialValue: deployBranch ?? "develop" });
       deployBranch = (typeof ans === "string" && !isCancel(ans) && ans.trim()) ? ans.trim() : (deployBranch ?? "develop");
-      say(`배포 브랜치: ${deployBranch}`);
+      say(`개발(릴리스 소스) 브랜치: ${deployBranch}`);
       // 브랜치 존재 확인 + 생성 제안 (#477) — 없으면 릴리스 파이프라인이 조용히 놀게 된다
       await ensureDeployBranch({ targetRoot, deployBranch, defaultBranch, io, say });
     }
@@ -256,14 +338,18 @@ export async function askAllOptionalWorkflows({
   secretBackup = await askOptionalWorkflow({
     dir: join(ptDir, "common", "secret-backup"), icon: "🔐", short: "Secret 서버 백업",
     desc: "GitHub Secret에 저장한 설정 파일을 SSH로 서버에 업로드·이력관리하는 워크플로우입니다.",
-    current: secretBackup, force, tty, io, forceAsk, say,
+    current: secretBackup, force, tty, io, forceAsk: ask("secret"), say,
   });
 
+  const finalDeploy = deploy ?? "docker-ssh";
+  const finalPublish = publish ?? [];
   return {
-    deploy: deploy ?? "docker-ssh", publish: publish ?? [], secretBackup: secretBackup === true,
+    deploy: finalDeploy, publish: finalPublish, secretBackup: secretBackup === true,
     codeReviewCoderabbit: codeReviewCoderabbit === true,
     changelogProvider: changelogProvider ?? "github-ai",
     changelogBaseUrl: changelogBaseUrl ?? "",
     deployBranch: deployBranch ?? "develop",
+    // #485 intent — 확정값 우선, 없으면 최종 deploy/publish에서 역추론(basic·비대화형 경로 보정)
+    intent: intent ?? inferIntent(finalDeploy, finalPublish) ?? "manual",
   };
 }

package/src/core/version-yml.js

@@ -52,7 +52,7 @@ const HEADER = `# ==============================================================
 export function parseTemplateOptions(content) {
   const out = { deploy: null, publish: null, secretBackup: null,
                 changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null,
-                deployBranch: null };
+                deployBranch: null, intent: null };
   // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
   for (const line of String(content || "").split("\n")) {
     if (line.startsWith("#")) continue;
@@ -85,6 +85,14 @@ export function parseTemplateOptions(content) {
         const bm = line.match(/^\s+base_url:\s*(.*)/);
         if (bm) { out.changelogBaseUrl = strip(bm[1]); continue; }
       }
+      // intent(프로젝트 성격, #485) — deploy 라인보다 먼저 매칭 (deploy: 와 intent: 구분).
+      // 값 뒤 인라인 주석(# ...)이 붙으므로 따옴표 안 or 첫 토큰만 취한다.
+      let im = line.match(/^\s+intent:\s*["']?([a-z]+)["']?/);
+      if (im) {
+        const v = im[1];
+        if (["app", "library", "both", "none", "manual"].includes(v)) out.intent = v;
+        continue;
+      }
       let m = line.match(/^\s+deploy:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -144,6 +152,22 @@ export function parseTemplateOptions(content) {
   return out;
 }
 
+// deploy/publish 저장값에서 intent(프로젝트 성격) 역추론 (#485 — intent 키 없는 구 version.yml 하위호환).
+//   deploy≠none & publish=[]  → app     (서버/앱만)
+//   deploy=none & publish≠[]  → library (라이브러리만)
+//   deploy≠none & publish≠[]  → both
+//   deploy=none & publish=[]  → none
+// deploy/publish가 아직 null(미설정)이면 intent도 추론 불가 → null 반환(진입 질문을 하도록).
+export function inferIntent(deploy, publish) {
+  if (deploy == null && (publish == null)) return null;
+  const hasServer = deploy != null && deploy !== "none";
+  const hasLib = Array.isArray(publish) && publish.length > 0;
+  if (hasServer && hasLib) return "both";
+  if (hasServer) return "app";
+  if (hasLib) return "library";
+  return "none";
+}
+
 // v4.1.0 이전 단수 project_type 키 → project_types 배열 최소 변환 (#471).
 // version.yml을 재생성하지 않는 경로(workflows 모드)에서 신형 version_manager(단수 키 명시 거부)와의
 // 정합을 맞춘다 — 해당 라인만 교체하고 나머지 내용은 손대지 않는다.
@@ -267,14 +291,17 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   // template 옵션 블록 (.sh save_template_options 신규 추가 케이스). templateOptions 지정 시.
   if (templateOptions) {
     const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
-            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true } = templateOptions;
+            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true, intent = null } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
+    // intent(프로젝트 성격, #485) — 미지정이면 deploy/publish에서 역추론해 기록 (재통합 시 진입 질문 생략용)
+    const intentVal = intent || inferIntent(deployTarget, publishTargets) || "manual";
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
     out += `    version: "${templateVersion}"\n`;
     out += `    integrated_date: "${optionsDate}"\n`;
     out += `    last_update_date: "${optionsDate}"\n`;
     out += `    options:\n`;
+    out += `      intent: "${intentVal}"   # 프로젝트 성격(app/library/both/none/manual) — 배포 질문 유도 기준\n`;
     out += `      deploy: "${deployTarget}"\n`;
     out += `      publish: ${publishJson}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;

package/src/index.js

@@ -103,15 +103,26 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
   const { now, today } = clock || utcNow();
   const tempDir = join(cwd, PATHS.tempDir);
 
+  // 프로젝트 성격(#485): CLI --intent → version.yml 저장값. deploy/publish 유도의 기준.
+  const intent = opts.intent ?? existing?.options?.intent ?? null;
+  // 배포/publish 축(#439): CLI 플래그 최우선 → 저장값 → 기본값. 단 --intent가 명시됐고 해당 축 플래그가
+  //   없으면 intent가 유도한다 (#485 비대화형): library/none이면 deploy=none, app/none이면 publish=[].
+  let deployTarget = opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh";
+  let publishTargets = opts.publishTargets ?? existing?.options?.publish ?? [];
+  if (opts.intent != null) {
+    if ((intent === "library" || intent === "none") && opts.deployTarget == null) deployTarget = "none";
+    if ((intent === "app" || intent === "none") && opts.publishTargets == null) publishTargets = [];
+  }
+
   const context = createContext({
     mode: opts.mode, force: true, types, version, versionCode, branch,
     paths,
-    // 배포/publish 축(#439): CLI 플래그 최우선 → version.yml 저장 옵션(구 키 자동 마이그레이션) → 기본값
-    deployTarget: opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh",
-    publishTargets: opts.publishTargets ?? existing?.options?.publish ?? [],
+    deployTarget,
+    publishTargets,
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
     // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
     deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
+    intent,
     // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
     changelogProvider: existing?.options?.changelogProvider ?? "github-ai",
     changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",

package/src/ui/prompts.js

@@ -39,7 +39,14 @@ export async function editMenu({ showOptional = false } = {}) {
     { value: "branch", label: "기본 브랜치" },
   ];
   if (showOptional) {
-    options.push({ value: "deploy-publish", label: "배포/Publish 방식" });
+    // #485 — 프로젝트 성격(intent): 재선택 시 배포/publish 축을 재유도한다.
+    options.push({ value: "intent", label: "프로젝트 성격 (배포 유형)" });
+    // #483 — 항목별 격리: 한 축만 골라 그 축만 재질문한다 (통짜 "배포/Publish 방식" 분해)
+    options.push({ value: "deploy", label: "배포 방식 (서버 실행물)" });
+    options.push({ value: "publish", label: "라이브러리 배포(publish) 타겟" });
+    options.push({ value: "code-review", label: "CodeRabbit 코드 리뷰" });
+    options.push({ value: "changelog", label: "릴리스 노트(changelog) 생성기" });
+    options.push({ value: "release-branch", label: "릴리스 소스(개발) 브랜치" });
     options.push({ value: "secret", label: "Secret 백업 포함 여부" });
   }
   options.push({ value: "done", label: "모두 맞음, 계속" });

package/src/ui/summary.js

@@ -142,8 +142,8 @@ export function printSummary(ctx, targetRoot = ".") {
   err(`  2️⃣  ${deployBranchName} 브랜치 생성 (아직 없다면)`);
   err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
   err("");
-  err("  3️⃣  CodeRabbit 활성화");
-  err("     → https://coderabbit.ai 방문하여 저장소 활성화");
+  err("  3️⃣  CodeRabbit 활성화 (코드 리뷰를 켰다면)");
+  err("     → https://coderabbit.ai 로그인 → GitHub 앱 설치 → 이 저장소에 접근 권한(grant access) 부여");
   err("");
   err(SEPARATOR);
   err("");