projectops 4.2.2 → 4.2.4

package/README.md

@@ -2,12 +2,12 @@
 
 # 🚀 Projectops
 
-**GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿 (구 SUH-DEVOPS-TEMPLATE)**
+**GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿**
 
 > 이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## 최신 버전 : v4.2.1 (2026-07-09)
+## 최신 버전 : v4.2.3 (2026-07-09)
 
 [전체 버전 기록 보기](CHANGELOG.md)
 
@@ -27,9 +27,9 @@
 | 버전 수동 관리, 태그 직접 생성 | 릴리스(develop→main PR) 시 patch 버전 자동 증가 + 태그 생성 |
 | 체인지로그 직접 작성 (30분+) | CodeRabbit AI가 PR마다 자동 생성 |
 | CI/CD 처음부터 설정 | 프로젝트 타입별 워크플로우 즉시 구성 |
-| 이슈 매번 형식 맞춰 작성 (5분+) | `/cassiiopeia:suh-issue` 한 번에 표준 템플릿 생성 |
-| 커밋 메시지 이슈 URL 수동 복사 | `/cassiiopeia:suh-commit` 이슈 컨텍스트 기반 자동 완성 |
-| PR 설명/보고서 직접 작성 | `/cassiiopeia:suh-report` git diff 분석 후 자동 생성 |
+| 이슈 매번 형식 맞춰 작성 (5분+) | `/projectops:issue` 한 번에 표준 템플릿 생성 |
+| 커밋 메시지 이슈 URL 수동 복사 | `/projectops:commit` 이슈 컨텍스트 기반 자동 완성 |
+| PR 설명/보고서 직접 작성 | `/projectops:report` git diff 분석 후 자동 생성 |
 | 코드 리뷰·분석 매번 프롬프트 입력 | 25종 Skills로 일관된 결과, 매번 재입력 불필요 |
 
 ---
@@ -40,23 +40,23 @@ Agent Skills가 개발 사이클 전체를 커버합니다.
 
 ```mermaid
 flowchart TD
-    A([작업 시작]) --> B["/cassiiopeia:suh-issue\n이슈 등록 + GitHub 자동 생성"]
-    B --> C["/cassiiopeia:suh-init-worktree\nworktree + 민감파일 자동 복사"]
+    A([작업 시작]) --> B["/projectops:issue\n이슈 등록 + GitHub 자동 생성"]
+    B --> C["/projectops:init-worktree\nworktree + 민감파일 자동 복사"]
     C --> D{작업 유형}
 
-    D -->|새 기능| E1["/cassiiopeia:suh-plan\n전략 수립"]
-    D -->|버그| E2["/cassiiopeia:suh-troubleshoot\n원인 분석"]
-    D -->|리팩토링| E3["/cassiiopeia:suh-refactor-analyze\nSmell 탐지"]
+    D -->|새 기능| E1["/projectops:plan\n전략 수립"]
+    D -->|버그| E2["/projectops:troubleshoot\n원인 분석"]
+    D -->|리팩토링| E3["/projectops:refactor-analyze\nSmell 탐지"]
 
-    E1 --> F["/cassiiopeia:suh-implement\n구현"]
+    E1 --> F["/projectops:implement\n구현"]
     E2 --> F
     E3 --> F
-    F --> G["/cassiiopeia:suh-test\n테스트"]
-    G --> H["/cassiiopeia:suh-review\n셀프 리뷰"]
-    H --> I["/cassiiopeia:suh-commit\n이슈 연동 커밋 자동 완성"]
-    I --> J["/cassiiopeia:suh-report\n구현 보고서 + GitHub 댓글"]
+    F --> G["/projectops:test\n테스트"]
+    G --> H["/projectops:review\n셀프 리뷰"]
+    H --> I["/projectops:commit\n이슈 연동 커밋 자동 완성"]
+    I --> J["/projectops:report\n구현 보고서 + GitHub 댓글"]
     J --> K([PR 등록])
-    K --> L["/cassiiopeia:suh-changelog-deploy\ndevelop push → main 릴리스 PR + automerge"]
+    K --> L["/projectops:changelog-deploy\ndevelop push → main 릴리스 PR + automerge"]
 ```
 
 > Skills 전체 목록 및 상세 사용법: **[docs/SKILLS.md](docs/SKILLS.md)**
@@ -94,7 +94,9 @@ npx projectops
 > Node.js 20.12+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: `npx projectops --mode full --type spring,react --force`
 
 <details>
-<summary>대안 — 스크립트 직접 실행 (Node 없이)</summary>
+<summary>대안 — 스크립트 직접 실행 (Node 없이, <b>deprecated</b>)</summary>
+
+> ⚠️ **`template_integrator.sh` / `.ps1`은 deprecated입니다 (#458).** 실행하면 `npx projectops`로 안내하며, 다음 minor에서 제거될 수 있습니다. Node 20.12+를 쓸 수 있으면 위의 `npx projectops`를 사용하세요.
 
 ```bash
 # macOS / Linux
@@ -113,7 +115,7 @@ $wc=New-Object Net.WebClient;$wc.Encoding=[Text.Encoding]::UTF8;iex $wc.Download
 ```bash
 # Claude Code
 claude plugin marketplace add Cassiiopeia/projectops
-claude plugin install cassiiopeia@cassiiopeia-marketplace --scope user
+claude plugin install projectops@projectops-marketplace --scope user
 ```
 
 ```bash
@@ -144,7 +146,7 @@ bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main
 
 </details>
 
-> Claude Code는 `/cassiiopeia:` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.
+> Claude Code는 `/projectops:` 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 [Skills 가이드](docs/SKILLS.md)를 확인하세요.
 
 ---
 
@@ -169,46 +171,46 @@ bash <(curl -fsSL "https://raw.githubusercontent.com/Cassiiopeia/projectops/main
 
 | 스킬 | 용도 |
 |------|------|
-| `/cassiiopeia:suh-issue` | 설명 한 줄 → GitHub 이슈 템플릿 자동 작성 + 등록 |
-| `/cassiiopeia:suh-init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
-| `/cassiiopeia:suh-commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
-| `/cassiiopeia:suh-report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
-| `/cassiiopeia:suh-changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
-| `/cassiiopeia:suh-github` | GitHub 이슈/PR/댓글 독립 조회 및 관리 |
+| `/projectops:issue` | 설명 한 줄 → GitHub 이슈 템플릿 자동 작성 + 등록 |
+| `/projectops:init-worktree` | Git worktree 생성 + 민감 파일 자동 복사 |
+| `/projectops:commit` | 이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수) |
+| `/projectops:report` | git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅 |
+| `/projectops:changelog-deploy` | develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge |
+| `/projectops:github` | GitHub 이슈/PR/댓글 독립 조회 및 관리 |
 
 ### 📊 분석형 (코드 수정 없음)
 
 | 스킬 | 용도 |
 |------|------|
-| `/cassiiopeia:suh-analyze` | 구현 전 현재 코드 상태 분석 및 영향 범위 평가 |
-| `/cassiiopeia:suh-plan` | 요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립 |
-| `/cassiiopeia:suh-design-analyze` | 아키텍처/API/DB/UI 설계 분석 (구현 X) |
-| `/cassiiopeia:suh-refactor-analyze` | Code Smell 탐지 + Before/After 기반 리팩토링 계획 |
-| `/cassiiopeia:suh-review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
-| `/cassiiopeia:suh-troubleshoot` | 가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시 |
+| `/projectops:analyze` | 구현 전 현재 코드 상태 분석 및 영향 범위 평가 |
+| `/projectops:plan` | 요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립 |
+| `/projectops:design-analyze` | 아키텍처/API/DB/UI 설계 분석 (구현 X) |
+| `/projectops:refactor-analyze` | Code Smell 탐지 + Before/After 기반 리팩토링 계획 |
+| `/projectops:review` | 보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류 |
+| `/projectops:troubleshoot` | 가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시 |
 
 ### 🔧 구현형 (실제 코드 작성)
 
 | 스킬 | 용도 |
 |------|------|
-| `/cassiiopeia:suh-implement` | 계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수) |
-| `/cassiiopeia:suh-design` | 아키텍처/API/DB/UI 설계 + 구현까지 |
-| `/cassiiopeia:suh-refactor` | Extract Method, DRY 등 리팩토링 기법 단계별 적용 |
-| `/cassiiopeia:suh-test` | AAA 패턴 단위/통합/E2E 테스트 코드 작성 |
-| `/cassiiopeia:suh-figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |
-| `/cassiiopeia:suh-build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
+| `/projectops:implement` | 계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수) |
+| `/projectops:design` | 아키텍처/API/DB/UI 설계 + 구현까지 |
+| `/projectops:refactor` | Extract Method, DRY 등 리팩토링 기법 단계별 적용 |
+| `/projectops:test` | AAA 패턴 단위/통합/E2E 테스트 코드 작성 |
+| `/projectops:figma` | Figma CSS → React/RN/Flutter 반응형 코드 변환 |
+| `/projectops:build` | 프로젝트 빌드 실행, 에러 분석, 최적화 제안 |
 
 ### 📝 문서/산출물 생성형
 
 | 스킬 | 용도 |
 |------|------|
-| `/cassiiopeia:suh-document` | 코드 주석/README/API 문서 작성 |
-| `/cassiiopeia:suh-testcase` | 이슈 분석 → QA 체크리스트 생성 |
-| `/cassiiopeia:suh-ppt` | 트러블슈팅/구현 사례 → 5섹션 발표자료 |
-| `/cassiiopeia:suh-spring-test` | Spring Boot 테스트 샘플 코드 생성 |
-| `/cassiiopeia:suh-synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
-| `/cassiiopeia:suh-ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
-| `/cassiiopeia:suh-skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
+| `/projectops:document` | 코드 주석/README/API 문서 작성 |
+| `/projectops:testcase` | 이슈 분석 → QA 체크리스트 생성 |
+| `/projectops:ppt` | 트러블슈팅/구현 사례 → 5섹션 발표자료 |
+| `/projectops:spring-test` | Spring Boot 테스트 샘플 코드 생성 |
+| `/projectops:synology-expose` | Synology NAS 외부 도메인 노출 설정 가이드 |
+| `/projectops:ssh` | 원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용) |
+| `/projectops:skill-creator` | Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드) |
 
 ---
 
@@ -233,13 +235,13 @@ Issue나 PR에 댓글로 자동화를 실행합니다.
 
 | 명령어 | 기능 | 대상 |
 |--------|------|------|
-| `@suh-lab server build` | 임시 서버 배포 | Spring, Python |
-| `@suh-lab server destroy` | 서버 삭제 | Spring, Python |
-| `@suh-lab server status` | 서버 상태 확인 | Spring, Python |
-| `@suh-lab build app` | iOS + Android 빌드 | Flutter |
-| `@suh-lab apk build` | Android만 빌드 | Flutter |
-| `@suh-lab ios build` | iOS만 빌드 | Flutter |
-| `@suh-lab create qa` | QA 이슈 자동 생성 | 모든 프로젝트 |
+| `@projectops server build` | 임시 서버 배포 | Spring, Python |
+| `@projectops server destroy` | 서버 삭제 | Spring, Python |
+| `@projectops server status` | 서버 상태 확인 | Spring, Python |
+| `@projectops build app` | iOS + Android 빌드 | Flutter |
+| `@projectops apk build` | Android만 빌드 | Flutter |
+| `@projectops ios build` | iOS만 빌드 | Flutter |
+| `@projectops create qa` | QA 이슈 자동 생성 | 모든 프로젝트 |
 
 > 상세: [PR Preview](docs/PR-PREVIEW.md) | [Flutter 빌드](docs/FLUTTER-TEST-BUILD-TRIGGER.md) | [이슈 자동화](docs/ISSUE-AUTOMATION.md)
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "projectops",
-  "version": "4.2.2",
-  "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI (구 SUH-DEVOPS-TEMPLATE 마법사)",
+  "version": "4.2.4",
+  "description": "ProjectOps — 완전 자동화 GitHub 프로젝트 관리 템플릿 통합 CLI",
   "keywords": [
     "devops",
     "automation",

package/src/cli/args.js

@@ -13,6 +13,7 @@ export function parseArgs(argv) {
     primaryType: "",
     deployTarget: null,      // 배포 축 (#439): docker-ssh|vercel|none, null=미설정
     publishTargets: null,    // publish 축 (#439): 타겟 배열, null=미설정
+    deployBranch: "",        // 릴리스 PR head 브랜치 (#456): --deploy-branch, 빈 값=미지정
     includeSecretBackup: null,
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
@@ -72,6 +73,12 @@ export function parseArgs(argv) {
         result.publishTargets = targets;
         break;
       }
+      case "--deploy-branch": {
+        // 릴리스 PR head 브랜치 (#456). default_branch와 별개.
+        const v = (args.shift() ?? "").trim();
+        if (v) result.deployBranch = v;
+        break;
+      }
       // ── deprecated alias (1 minor 유지 — #439) ──
       case "--nexus":
         process.stderr.write("⚠️  --nexus는 deprecated입니다. --publish nexus --deploy none 을 사용하세요.\n");

package/src/cli/help.js

@@ -15,6 +15,7 @@ export const HELP_TEXT = `projectops — GitHub 프로젝트 자동화 템플릿
       --paths "t=p,..."    타입별 프로젝트 경로 (모노레포). 예: flutter=app,react=client
       --deploy TARGET      배포 방식 택1: docker-ssh(기본) | vercel | none
       --publish CSV        publish 타겟 csv: nexus,npm,github-packages (기본: 없음)
+      --deploy-branch NAME 릴리스 PR head 브랜치 (#456, 기본: develop). default_branch와 별개
       --secret-backup / --no-secret-backup   Secret 백업 워크플로우 포함/제외
       --nexus / --npm-publish  (deprecated — --publish nexus / --publish npm 사용)
       --force              모든 확인 생략, 비대화형 기본값 사용

package/src/commands/full.js

@@ -22,7 +22,9 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
     force = true, now, today, templateVersion = "unknown",
-    deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false } = context;
+    deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
+    changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
+    deployBranch = "" } = context;
 
   // project_paths 마커 계산 (.sh existing_marker_in_dir 등가 — 대표 마커명)
   const pathMarkers = new Map();
@@ -36,9 +38,10 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   // 1. version.yml 생성 (전체 재생성 — metadata → deploy → template 순, .sh 최종형과 동일)
   writeText(join(targetRoot, PATHS.versionFile),
     buildVersionYml({
-      version, types, paths, pathMarkers, branch, versionCode, now, today,
+      version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
       deployValues,
-      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today },
+      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
     }));
 
   // 2. README 버전 섹션
@@ -56,7 +59,8 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
   copyDiscussionTemplates(tempDir, targetRoot);
 
   // 8. coderabbit / gitignore / setup guide
-  copyCoderabbit(tempDir, { force }, targetRoot);
+  //    CodeRabbit 코드리뷰 미사용 선택(#457)이면 .coderabbit.yaml을 복사하지 않는다.
+  copyCoderabbit(tempDir, { force, enabled: codeReviewCoderabbit }, targetRoot);
   ensureGitignore(targetRoot);
   copySetupGuide(tempDir, targetRoot);
 

package/src/commands/interactive.js

@@ -83,6 +83,10 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     let deployTarget = existing?.options?.deploy ?? "docker-ssh";
     let publishTargets = existing?.options?.publish ?? [];
     let includeSecretBackup = existing?.options?.secretBackup ?? false;
+    let codeReviewCoderabbit = existing?.options?.codeReviewCoderabbit ?? true;
+    let changelogProvider = existing?.options?.changelogProvider ?? "github-ai";
+    let changelogBaseUrl = existing?.options?.changelogBaseUrl ?? "";
+    let deployBranch = existing?.options?.deployBranch ?? "develop"; // #456
     const showOptional = mode === "full" || mode === "workflows";
     const realTty = process.stdout.isTTY === true;
 
@@ -93,17 +97,28 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
     if (showOptional) {
       const r = await askAllOptionalWorkflows({
         tempDir, types, targetRoot: cwd,
-        current: { deploy: existing?.options?.deploy ?? null, publish: existing?.options?.publish ?? null, secretBackup: existing?.options?.secretBackup ?? null },
+        current: {
+          deploy: existing?.options?.deploy ?? null, publish: existing?.options?.publish ?? null, secretBackup: existing?.options?.secretBackup ?? null,
+          codeReviewCoderabbit: existing?.options?.codeReviewCoderabbit ?? null,
+          changelogProvider: existing?.options?.changelogProvider ?? null,
+          changelogBaseUrl: existing?.options?.changelogBaseUrl ?? null,
+          deployBranch: existing?.options?.deployBranch ?? null,
+        },
         force: false, tty: realTty,
         io: {
           confirm: ({ message, initialValue }) => io.askYesNo(message, initialValue),
           select: io.engineIo?.select,
           multiselect: io.engineIo?.multiselect,
+          text: io.engineIo?.text ?? (({ message }) => io.askText?.(message, "")),
         },
       });
       deployTarget = r.deploy;
       publishTargets = r.publish;
       includeSecretBackup = r.secretBackup;
+      codeReviewCoderabbit = r.codeReviewCoderabbit;
+      changelogProvider = r.changelogProvider;
+      changelogBaseUrl = r.changelogBaseUrl;
+      deployBranch = r.deployBranch;
     }
 
     // 확인/수정 루프 — ESC는 '머무르기' (.sh L1877~1881: 명시적 '아니오'만 종료)
@@ -114,7 +129,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
       if (io.analysisCard) {
         io.analysisCard({ mode, modeLabel: modeLabel(mode), types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional, paths });
       } else {
-        io.note?.(summarize({ mode, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional }), "프로젝트 분석 결과");
+        io.note?.(summarize({ mode, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional, changelogProvider, codeReviewCoderabbit }), "프로젝트 분석 결과");
       }
       const choice = await io.confirmProjectMenu();
       if (choice === "cancel") { io.cancelMessage?.("설치를 취소했습니다."); return 0; }
@@ -147,17 +162,25 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
           // 배포/publish 축 재질문 (#439 — forceAsk)
           const r = await askAllOptionalWorkflows({
             tempDir, types, targetRoot: cwd,
-            current: { deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup },
+            current: {
+              deploy: deployTarget, publish: publishTargets, secretBackup: includeSecretBackup,
+              codeReviewCoderabbit, changelogProvider, changelogBaseUrl, deployBranch,
+            },
             force: false, tty: realTty, forceAsk: true,
             io: {
               confirm: ({ message, initialValue }) => io.askYesNo(message, initialValue),
               select: io.engineIo?.select,
               multiselect: io.engineIo?.multiselect,
+              text: io.engineIo?.text ?? (({ message }) => io.askText?.(message, "")),
             },
           });
           deployTarget = r.deploy;
           publishTargets = r.publish;
           includeSecretBackup = r.secretBackup;
+          codeReviewCoderabbit = r.codeReviewCoderabbit;
+          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;
@@ -190,6 +213,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,
       repoName, templateVersion, resolvers, envValues, envUseDefaults, now, today,
     });
     ctx.templateVersion = templateVersion;
@@ -240,7 +264,7 @@ export async function runInteractive(baseCtx, { cwd = process.cwd(), source = {
   }
 }
 
-function summarize({ mode, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional }) {
+function summarize({ mode, types, version, branch, deployTarget, publishTargets, includeSecretBackup, showOptional, changelogProvider, codeReviewCoderabbit }) {
   const lines = [
     `통합 모드 : ${modeLabel(mode)}`,
     `프로젝트 타입 : ${types.join(", ")}${types.length > 1 ? " (멀티)" : ""}`,
@@ -251,6 +275,8 @@ function summarize({ mode, types, version, branch, deployTarget, publishTargets,
     lines.push(`배포 방식 : ${deployTarget || "docker-ssh"}`);
     lines.push(`Publish : ${(publishTargets ?? []).join(",") || "없음"}`);
     lines.push(`Secret 백업 : ${includeSecretBackup ? "포함" : "제외"}`);
+    lines.push(`Changelog : ${changelogProvider || "github-ai"}`);
+    lines.push(`CodeRabbit 리뷰 : ${codeReviewCoderabbit ? "사용" : "미사용"}`);
   }
   return lines.join("\n");
 }

package/src/commands/version.js

@@ -12,15 +12,18 @@ import { ensureGitignore } from "../core/copy/gitignore.js";
 
 export function runVersion(context, tempDir, targetRoot = ".") {
   const { version, types = [], paths = new Map(), branch = "main", versionCode = 1,
-    now, today, templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false } = context;
+    now, today, templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false,
+    changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true,
+    deployBranch = "" } = context;
 
   const pathMarkers = new Map();
   for (const [t] of paths) pathMarkers.set(t, markerForType(t));
 
   writeText(join(targetRoot, PATHS.versionFile),
     buildVersionYml({
-      version, types, paths, pathMarkers, branch, versionCode, now, today,
-      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today },
+      version, types, paths, pathMarkers, branch, deployBranch, versionCode, now, today,
+      templateOptions: { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate: today,
+        changelogProvider, changelogBaseUrl, codeReviewCoderabbit },
     }));
   addVersionSectionToReadme(version, targetRoot);
   copyScripts(tempDir, targetRoot);

package/src/context.js

@@ -19,6 +19,11 @@ export function createContext(overrides = {}) {
     deployTarget: null,      // 'docker-ssh'(기본) | 'vercel' | 'none'
     publishTargets: null,    // ['nexus','npm','github-packages'] 부분집합
     includeSecretBackup: null,
+    // changelog provider 축 (#455 — null=미설정)
+    changelogProvider: null, // 'github-ai'(기본) | 'coderabbit' | 'openai' | 'gemini' | 'claude' | 'ollama' | 'commit'
+    changelogBaseUrl: null,  // ollama일 때만 값
+    codeReviewCoderabbit: null,
+    deployBranch: "",        // 릴리스 PR head 브랜치 (#456). 빈 값=metadata.deploy_branch 미출력
     templateVersion: "",
     tempDir: "",
     deployValues: new Map(), // "type.KEY" -> value

package/src/core/copy/coderabbit.js

@@ -3,9 +3,12 @@
 import { join } from "node:path";
 import { exists, copyFileSync } from "../fsutil.js";
 
-// 반환: 'skip-no-src' | 'copied-new' | 'overwritten-backup' | 'skip-non-tty'
-// opts: { force, tty }  — SP2-B 검증은 force:true 경로.
-export function copyCoderabbit(tempDir, { force = false, tty = false } = {}, targetRoot = ".") {
+// 반환: 'skip-disabled' | 'skip-no-src' | 'copied-new' | 'overwritten-backup' | 'skip-non-tty'
+// opts: { force, tty, enabled }  — SP2-B 검증은 force:true 경로.
+// enabled=false면(#457 CodeRabbit 미사용 선택) 파일을 아예 복사하지 않는다.
+// enabled 미지정(undefined)이면 기존 동작(복사) 유지 — 구 호출부 하위호환.
+export function copyCoderabbit(tempDir, { force = false, tty = false, enabled } = {}, targetRoot = ".") {
+  if (enabled === false) return "skip-disabled";
   const src = join(tempDir, ".coderabbit.yaml");
   if (!exists(src)) return "skip-no-src";
   const dst = join(targetRoot, ".coderabbit.yaml");

package/src/core/copy/simple.js

@@ -50,8 +50,8 @@ export function copyDiscussionTemplates(tempDir, targetRoot = ".") {
   return true;
 }
 
-// SUH-DEVOPS-TEMPLATE-SETUP-GUIDE.md 루트로 덮어쓰기. 없으면 스킵.
-export const SETUP_GUIDE_NAME = "SUH-DEVOPS-TEMPLATE-SETUP-GUIDE.md";
+// PROJECTOPS-SETUP-GUIDE.md 루트로 덮어쓰기. 없으면 스킵.
+export const SETUP_GUIDE_NAME = "PROJECTOPS-SETUP-GUIDE.md";
 export function copySetupGuide(tempDir, targetRoot = ".") {
   const src = join(tempDir, SETUP_GUIDE_NAME);
   if (!exists(src)) return false;

package/src/core/ide/adapters/claude.js

@@ -1,12 +1,12 @@
 // Claude Code 어댑터 (.sh _manage_claude_section / _do_claude_plugin_install /
 // _remove_claude_section / _remove_claude_plugin_data 등가).
-// 마켓플레이스 Cassiiopeia/projectops, 플러그인 cassiiopeia@cassiiopeia-marketplace.
+// 마켓플레이스 Cassiiopeia/projectops, 플러그인 projectops@projectops-marketplace.
 import { join } from "node:path";
 import { existsSync, readdirSync, mkdirSync, cpSync, rmSync } from "node:fs";
 import { compareCacheName } from "../util.js";
 
 const MARKETPLACE = "Cassiiopeia/projectops";
-const PLUGIN = "cassiiopeia@cassiiopeia-marketplace";
+const PLUGIN = "projectops@projectops-marketplace";
 
 function detect(io) {
   if (!io.which("claude")) return { installed: false, version: null, cliMissing: true, note: "CLI 없음" };
@@ -17,7 +17,7 @@ function detect(io) {
     const list = Array.isArray(arr) ? arr : (arr.plugins || []);
     for (const p of list) {
       const name = String(p.name || p.id || "");
-      if (name.includes("cassiiopeia@") || name === "cassiiopeia") { scope = p.scope || ""; version = p.version || null; break; }
+      if (name.includes("projectops@") || name === "projectops") { scope = p.scope || ""; version = p.version || null; break; }
     }
   } catch { /* 파싱 실패 → 미설치 취급 */ }
   return { installed: !!scope, version, cliMissing: false, scope };
@@ -42,7 +42,7 @@ function install(io, scope = "user") {
 }
 
 function update(io, scope) {
-  const cacheRoot = join(io.home(), ".claude/plugins/cache/cassiiopeia-marketplace/cassiiopeia");
+  const cacheRoot = join(io.home(), ".claude/plugins/cache/projectops-marketplace/projectops");
   const oldCache = latestCacheDir(cacheRoot);
   io.log("플러그인 업데이트 중...");
   const up = io.run("claude", ["plugin", "update", PLUGIN, "--scope", scope]);

package/src/core/ide/adapters/codex.js

@@ -1,13 +1,13 @@
 // Codex CLI 어댑터 (.sh _manage_codex_skills / _do_codex_marketplace_register /
 // _remove_codex_section 등가).
-// marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/cassiiopeia 심링크는 감지·제거에 사용.
+// marketplace 등록/업그레이드가 주 경로. native ~/.agents/skills/projectops 심링크는 감지·제거에 사용.
 import { join } from "node:path";
 import { existsSync, lstatSync, rmSync } from "node:fs";
 
 const MARKETPLACE = "Cassiiopeia/projectops";
-const PLUGIN = "cassiiopeia";
+const PLUGIN = "projectops";
 
-function nativeTarget(io) { return join(io.home(), ".agents/skills/cassiiopeia"); }
+function nativeTarget(io) { return join(io.home(), ".agents/skills/projectops"); }
 
 function detect(io) {
   const tgt = nativeTarget(io);

package/src/core/ide/adapters/cursor.js

@@ -62,7 +62,7 @@ function writeMeta(io, destDir, templateVersion) {
   let installedAt = now;
   if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
   const meta = {
-    name: "cassiiopeia", version, scope: "user",
+    name: "projectops", version, scope: "user",
     source: "https://github.com/Cassiiopeia/projectops",
     installPath: destDir, installedAt, lastUpdated: now,
   };

package/src/core/ide/adapters/gemini.js

@@ -1,6 +1,6 @@
 // Gemini CLI 어댑터 (.sh _manage_gemini_extension / _remove_gemini_section 등가).
 // extension install/update/uninstall. 마켓플레이스 대신 git URL 확장.
-const EXT = "cassiiopeia";
+const EXT = "projectops";
 const URL = "https://github.com/Cassiiopeia/projectops";
 
 function detect(io) {

package/src/core/ide/adapters/pi-common.js

@@ -11,7 +11,7 @@ export function piInstalled(io) {
   if (!io.which("pi")) return false;
   const r = io.run("pi", ["list"]); // pi는 일부 출력을 stderr로 보냄 → 둘 다 검사
   const out = (r.stdout || "") + (r.stderr || "");
-  return /SUH-DEVOPS-TEMPLATE|projectops|cassiiopeia/i.test(out);
+  return /SUH-DEVOPS-TEMPLATE|projectops/i.test(out);
 }
 
 // pi 클론 경로(harness loader가 사는 곳). 레포명 변경 전 구 경로 하위호환.

package/src/core/ide/adapters/pi.js

@@ -18,7 +18,7 @@ function apply(io) {
   }
   if (piInstalled(io)) {
     io.log("  PI 패키지 설치 / 업데이트 완료");
-    io.log("  → 'pi' 재실행 후 'pi list' 로 확인, 채팅창에서 /suh-analyze 등 호출");
+    io.log("  → 'pi' 재실행 후 'pi list' 로 확인, 채팅창에서 /projectops:analyze 등 호출");
     return true;
   }
   io.log(`  PI 설치/업데이트 실패 — 수동: pi install ${PI_PACKAGE_URL}`);

package/src/core/options-ask.js

@@ -17,6 +17,8 @@ export { parseTemplateOptions };
 
 export const DEPLOY_TARGETS = ["docker-ssh", "vercel", "none"];
 export const PUBLISH_TARGETS = ["nexus", "npm", "github-packages"];
+// #455 — changelog 생성기 provider. github-ai가 기본(설정 제로). openai/gemini/claude/ollama는 openai 호환 한 갈래.
+export const CHANGELOG_PROVIDERS = ["github-ai", "coderabbit", "openai", "gemini", "claude", "ollama", "commit"];
 
 const isCancel = (v) => typeof v === "symbol";
 
@@ -62,6 +64,10 @@ export async function askAllOptionalWorkflows({
   let deploy = current.deploy ?? null;
   let publish = current.publish ?? null;
   let secretBackup = current.secretBackup ?? null;
+  let codeReviewCoderabbit = current.codeReviewCoderabbit ?? null;
+  let changelogProvider = current.changelogProvider ?? null;
+  let changelogBaseUrl = current.changelogBaseUrl ?? null;
+  let deployBranch = current.deployBranch ?? null; // #456 릴리스 PR head 브랜치
 
   // basic 단독 타입은 서버 배포도 라이브러리 publish도 개념상 성립하지 않는다.
   // 배포/publish 질문을 건너뛰고 none·[]로 조용히 확정한다 (타입 변경 시 재질문됨).
@@ -86,6 +92,12 @@ export async function askAllOptionalWorkflows({
         secretBackup = saved.secretBackup;
         say(`Secret 백업 옵션: version.yml 저장값(${secretBackup}) 유지 — 재질문 생략`);
       }
+      // #455 changelog/code_review 저장값 재사용
+      if (codeReviewCoderabbit === null && saved.codeReviewCoderabbit !== null) codeReviewCoderabbit = saved.codeReviewCoderabbit;
+      if (changelogProvider === null && saved.changelogProvider !== null) changelogProvider = saved.changelogProvider;
+      if (changelogBaseUrl === null && saved.changelogBaseUrl !== null) changelogBaseUrl = saved.changelogBaseUrl;
+      // #456 deploy_branch 저장값 재사용
+      if (deployBranch === null && saved.deployBranch != null) deployBranch = saved.deployBranch;
     }
   }
 
@@ -140,6 +152,69 @@ export async function askAllOptionalWorkflows({
     }
   }
 
+  // ── code_review: CodeRabbit AI 코드 리뷰 (changelog와 무관 — #455) ──
+  if (forceAsk || codeReviewCoderabbit === null) {
+    if (force || !tty || typeof io.confirm !== "function") {
+      codeReviewCoderabbit = codeReviewCoderabbit ?? false;
+    } else {
+      say("");
+      say("🤖 CodeRabbit AI 코드 리뷰를 쓸까요? (PR 올릴 때 코드 리뷰 댓글을 답니다)");
+      const ans = await io.confirm({ message: "CodeRabbit AI 코드 리뷰 사용", initialValue: false });
+      codeReviewCoderabbit = (ans === true && !isCancel(ans));
+      say(`CodeRabbit 코드 리뷰: ${codeReviewCoderabbit ? "사용" : "미사용"}`);
+    }
+  }
+
+  // ── changelog: 릴리스 노트 생성기 (기본 커서 = github-ai — #455) ──
+  if (forceAsk || changelogProvider === null) {
+    if (force || !tty || typeof io.select !== "function") {
+      changelogProvider = changelogProvider ?? "github-ai";
+    } else {
+      say("");
+      say("📝 릴리스 노트(changelog)는 뭘로 만들까요?");
+      say("   GitHub AI는 설정 없이 바로 됩니다. 나머지는 나중에 GitHub Secret 등록이 필요할 수 있어요.");
+      const ans = await io.select({
+        message: "changelog 생성기를 선택하세요",
+        options: [
+          { value: "github-ai", label: "GitHub AI (추천 · 설정 불필요)" },
+          { value: "coderabbit", label: "CodeRabbit" },
+          { value: "openai", label: "OpenAI 호환 API (키 등록 필요)" },
+          { value: "commit", label: "커밋 분석만 (AI 없음)" },
+        ],
+      });
+      changelogProvider = (!isCancel(ans) && CHANGELOG_PROVIDERS.includes(ans)) ? ans : (changelogProvider ?? "github-ai");
+      say(`changelog 생성기: ${changelogProvider}`);
+    }
+  }
+
+  // ollama 선택 시에만 base_url 질문 (나머지 provider는 preset base_url 자동 — #455)
+  if (changelogProvider === "ollama" && (forceAsk || changelogBaseUrl === null || changelogBaseUrl === "")) {
+    if (force || !tty || typeof io.text !== "function") {
+      changelogBaseUrl = changelogBaseUrl ?? "";
+    } else {
+      const ans = await io.text({ message: "Ollama 서버 base_url (예: https://ai.suhsaechan.kr/v1)" });
+      changelogBaseUrl = (typeof ans === "string" && !isCancel(ans)) ? ans.trim() : "";
+      say(`Ollama base_url: ${changelogBaseUrl || "(미지정)"}`);
+    }
+  } else if (changelogBaseUrl === null) {
+    changelogBaseUrl = "";
+  }
+
+  // ── deploy_branch: 릴리스 PR의 head 브랜치 (#456 — default_branch와 별개) ──
+  //    대부분 develop→main 릴리스 구조라 기본값 develop. 다른 head를 쓰는 레포를 위해 물어본다.
+  if (forceAsk || deployBranch === null) {
+    if (force || !tty || typeof io.text !== "function") {
+      deployBranch = deployBranch ?? "develop";
+    } else {
+      say("");
+      say("🌿 릴리스 배포 브랜치(릴리스 PR의 head)는 무엇인가요?");
+      say("   develop→main 릴리스 구조면 develop 그대로 두세요. 배포 브랜치가 따로면 그 이름을 적어주세요.");
+      const ans = await io.text({ message: "배포 브랜치", initialValue: deployBranch ?? "develop" });
+      deployBranch = (typeof ans === "string" && !isCancel(ans) && ans.trim()) ? ans.trim() : (deployBranch ?? "develop");
+      say(`배포 브랜치: ${deployBranch}`);
+    }
+  }
+
   // ── ④ Secret 백업: 공통 폴더 (배포축 아님 — 기존 폴더 질문 유지) ──
   const real = join(tempDir, PATHS.workflowsDir, PATHS.projectTypesDir);
   const ptDir = existsSync(real) ? real : join(tempDir, PATHS.projectTypesDir);
@@ -149,5 +224,11 @@ export async function askAllOptionalWorkflows({
     current: secretBackup, force, tty, io, forceAsk, say,
   });
 
-  return { deploy: deploy ?? "docker-ssh", publish: publish ?? [], secretBackup: secretBackup === true };
+  return {
+    deploy: deploy ?? "docker-ssh", publish: publish ?? [], secretBackup: secretBackup === true,
+    codeReviewCoderabbit: codeReviewCoderabbit === true,
+    changelogProvider: changelogProvider ?? "github-ai",
+    changelogBaseUrl: changelogBaseUrl ?? "",
+    deployBranch: deployBranch ?? "develop",
+  };
 }

package/src/core/version-yml.js

@@ -32,7 +32,7 @@ const HEADER = `# ==============================================================
 # 연관된 워크플로우:
 # - .github/workflows/PROJECT-VERSION-CONTROL.yaml
 # - .github/workflows/PROJECT-README-VERSION-UPDATE.yaml
-# - .github/workflows/PROJECT-AUTO-CHANGELOG-CONTROL.yaml
+# - .github/workflows/PROJECT-RELEASE-CHANGELOG.yaml
 #
 # 주의사항:
 # - project_types는 최초 설정 후 변경하지 마세요
@@ -49,17 +49,40 @@ const HEADER = `# ==============================================================
 // 구 synology 키 등 다른 키는 어느 분기에도 안 걸려 자연히 무시된다.
 // (options-ask.js가 이 함수를 import한다 — 순환 방지 위해 여기(version-yml)에 정의.)
 export function parseTemplateOptions(content) {
-  const out = { deploy: null, publish: null, secretBackup: null };
+  const out = { deploy: null, publish: null, secretBackup: null,
+                changelogProvider: null, changelogBaseUrl: null, codeReviewCoderabbit: null,
+                deployBranch: null };
+  // deploy_branch는 metadata 직속(#456) — template.options 밖이라 별도로 스캔한다.
+  for (const line of String(content || "").split("\n")) {
+    if (line.startsWith("#")) continue;
+    const m = line.match(/^\s+deploy_branch:\s*"([^"]*)"/);
+    if (m) { out.deployBranch = m[1]; break; }
+  }
   let legacyNexus = null;
   let legacyNpm = null;
   // 값 정규화: 따옴표 제거 + 트림 (.sh tr -d '"' | tr -d "'" | xargs 등가)
   const strip = (s) => String(s).replace(/["']/g, "").trim();
   let inTemplate = false;
   let inOptions = false;
+  let inCodeReview = false;
+  let inChangelog = false;
   for (const line of String(content || "").split("\n")) {
     if (/^\s*template:/.test(line)) { inTemplate = true; continue; }
     if (inTemplate && /^\s+options:/.test(line)) { inOptions = true; continue; }
     if (inTemplate && inOptions) {
+      // 중첩 블록 헤더 감지 (options 밑 한 단계) — code_review / changelog (#455)
+      if (/^\s+code_review:\s*$/.test(line)) { inCodeReview = true; inChangelog = false; continue; }
+      if (/^\s+changelog:\s*$/.test(line)) { inChangelog = true; inCodeReview = false; continue; }
+      if (inCodeReview) {
+        const cm = line.match(/^\s+coderabbit:\s*(.+)/);
+        if (cm) { const v = strip(cm[1]); if (v === "true") out.codeReviewCoderabbit = true; if (v === "false") out.codeReviewCoderabbit = false; continue; }
+      }
+      if (inChangelog) {
+        const pm = line.match(/^\s+provider:\s*(.+)/);
+        if (pm) { out.changelogProvider = strip(pm[1]); continue; }
+        const bm = line.match(/^\s+base_url:\s*(.*)/);
+        if (bm) { out.changelogBaseUrl = strip(bm[1]); continue; }
+      }
       let m = line.match(/^\s+deploy:\s*(.+)/);
       if (m) {
         const v = strip(m[1]);
@@ -152,9 +175,12 @@ export function parseExisting(content) {
       if (/^\S/.test(l)) break;
     }
   }
+  // 브랜치 정보 (#456) — default_branch(레포 기본)와 deploy_branch(릴리스 PR head)는 별개.
+  const defaultBranch = line(/^\s*default_branch:\s*"([^"]*)"/);
+  const deployBranch = line(/^\s*deploy_branch:\s*"([^"]*)"/);
   // 선택 워크플로우 옵션 (metadata.template.options — nexus/secret_backup)
   const options = parseTemplateOptions(text);
-  return { version, versionCode, types, paths, templateVersion, options };
+  return { version, versionCode, types, paths, templateVersion, options, defaultBranch, deployBranch };
 }
 
 // version.yml 전체 생성 (.sh create_version_yml + save_template_options 신규 케이스 등가).
@@ -164,7 +190,7 @@ export function parseExisting(content) {
 //   today = "YYYY-MM-DD" (UTC)
 //   pathMarkers = Map<type, markerFilename> (project_paths 주석용)
 //   templateOptions = { templateVersion, deployTarget, publishTargets, includeSecretBackup, optionsDate } (template 블록)
-export function buildVersionYml({ version, types = [], paths = new Map(), pathMarkers = new Map(), branch = "main", versionCode = 1, now, today, templateOptions = null, deployValues = new Map() }) {
+export function buildVersionYml({ version, types = [], paths = new Map(), pathMarkers = new Map(), branch = "main", deployBranch = "", versionCode = 1, now, today, templateOptions = null, deployValues = new Map() }) {
   const typesJson = types.length ? `[${types.map((t) => `"${t}"`).join(",")}]` : `["basic"]`;
 
   let out = HEADER + "\n";
@@ -186,6 +212,9 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
   out += `  last_updated: "${now}"\n`;
   out += `  last_updated_by: "template_integrator"\n`;
   out += `  default_branch: "${branch}"\n`;
+  // deploy_branch: 릴리스 PR의 head 브랜치(#456). default_branch(레포 기본)와 별개 개념.
+  // 지정된 경우에만 출력 — 미지정이면 스킬이 develop로 폴백(하위호환).
+  if (deployBranch) out += `  deploy_branch: "${deployBranch}"\n`;
   out += `  integrated_from: "projectops"\n`;
   out += `  integration_date: "${today}"\n`;
 
@@ -203,7 +232,8 @@ 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 } = templateOptions;
+    const { templateVersion = "unknown", deployTarget = "docker-ssh", publishTargets = [], includeSecretBackup = false, optionsDate = today,
+            changelogProvider = "github-ai", changelogBaseUrl = "", codeReviewCoderabbit = true } = templateOptions;
     const publishJson = `[${publishTargets.map((t) => `"${t}"`).join(",")}]`;
     out += `  template:\n`;
     out += `    source: "projectops"\n`;
@@ -214,6 +244,11 @@ export function buildVersionYml({ version, types = [], paths = new Map(), pathMa
     out += `      deploy: "${deployTarget}"\n`;
     out += `      publish: ${publishJson}\n`;
     out += `      secret_backup: ${includeSecretBackup}\n`;
+    out += `      code_review:\n`;
+    out += `        coderabbit: ${codeReviewCoderabbit}\n`;
+    out += `      changelog:\n`;
+    out += `        provider: "${changelogProvider}"\n`;
+    out += `        base_url: "${changelogBaseUrl}"\n`;
   }
   return out;
 }

package/src/index.js

@@ -109,6 +109,12 @@ export async function run(argv, { cwd = process.cwd(), source = { type: "git" },
     deployTarget: opts.deployTarget ?? existing?.options?.deploy ?? "docker-ssh",
     publishTargets: opts.publishTargets ?? existing?.options?.publish ?? [],
     includeSecretBackup: opts.includeSecretBackup ?? existing?.options?.secretBackup ?? false,
+    // 릴리스 배포 브랜치(#456): CLI 플래그 → version.yml 저장값 → 빈 값(미출력, 스킬이 develop 폴백)
+    deployBranch: opts.deployBranch || existing?.options?.deployBranch || "",
+    // changelog/code_review 축(#455): 비대화형은 저장값 → 기본값. null이 흘러 provider:"null"로 기록되던 버그 수정.
+    changelogProvider: existing?.options?.changelogProvider ?? "github-ai",
+    changelogBaseUrl: existing?.options?.changelogBaseUrl ?? "",
+    codeReviewCoderabbit: existing?.options?.codeReviewCoderabbit ?? false,
     repoName,
     // 실 resolver 4종 (.sh resolve_token 등가 — spring-app-yml 스텁 제거)
     resolvers: makeResolvers(cwd, repoName, paths),

package/src/ui/readline-engine.js

@@ -6,6 +6,7 @@
 // 계약: 취소(ESC/Ctrl+C)는 CANCEL 심볼 반환. 각 함수 async.
 import { emitKeypressEvents } from "node:readline";
 import { stdin, stdout } from "node:process";
+import { visualWidth } from "./ansi.js";
 
 export const CANCEL = Symbol("cancel");
 
@@ -28,18 +29,31 @@ const S_BAR = paint("│", c.gray);
 const S_Q = paint("◆", c.cyan);
 const S_DONE = paint("◇", c.green);
 
+// 한 논리 라인이 터미널 폭에서 차지하는 물리 줄 수 (wrap 고려).
+// WHY: 긴 라벨(한글 2칸 포함)이 터미널 폭을 넘으면 터미널이 자동 줄바꿈해 물리적으로 2줄+가 된다.
+//   커서 되감기(ESC[nA)는 물리 줄 기준이므로, 논리 줄 수만 세면 wrap된 만큼 덜 올라가
+//   이전 출력이 안 지워지고 매 렌더마다 화면이 아래로 밀린다. (실측: Windows PowerShell 폭 80)
+export function physicalRows(line, cols) {
+  const w = visualWidth(line); // ANSI 시퀀스 제외 + CJK 2칸
+  if (cols <= 0) return 1;
+  // 빈 줄도 최소 1행. 폭의 정수배로 딱 떨어지면 wrap 안 되므로 그대로(80칸 라인@80폭 = 1행).
+  if (w === 0) return 1;
+  return Math.max(1, Math.ceil(w / cols));
+}
+
 // 여러 줄 지운 뒤 커서를 블록 시작으로 되돌리는 렌더러.
-// prevLines 만큼 위로 올라가 지우고 새로 그린다.
+// 직전 렌더의 "물리 줄 수"만큼 위로 올라가 지우고 새로 그린다 (wrap 안전).
 function makeRenderer() {
-  let prevLines = 0;
+  let prevRows = 0; // 직전 렌더가 실제로 차지한 물리 줄 수
   return {
     render(lines) {
-      if (prevLines > 0) stdout.write(`${ESC}${prevLines}A`); // 위로
+      if (prevRows > 0) stdout.write(`${ESC}${prevRows}A`); // 물리 줄 기준으로 위로
       stdout.write(`${ESC}0J`); // 커서 아래 전부 지우기
       stdout.write(lines.join("\n") + "\n");
-      prevLines = lines.length;
+      const cols = stdout.columns || 80; // 터미널 폭 (파이프 등으로 없으면 80 가정)
+      prevRows = lines.reduce((sum, l) => sum + physicalRows(l, cols), 0);
     },
-    reset() { prevLines = 0; },
+    reset() { prevRows = 0; },
   };
 }
 

package/src/ui/status-cards.js

@@ -80,11 +80,15 @@ export function printIdeStatus(statuses, out = (s) => process.stdout.write(s)) {
 }
 
 // 층5 — 신규 통합 vs 업데이트 판별 라인 (Breaking 박스는 breaking-check.js)
+// WHY 판정: version.yml의 metadata.template.version(이전 통합 흔적)이 있으면 업데이트, 없으면 신규.
+// 사용자가 "무슨 기준으로 신규/업데이트인지"를 바로 알도록 판정 근거를 화면에 밝힌다.
 export function printInstallKind({ currentTemplateVersion = "", templateVersion = "" }, out = (s) => process.stdout.write(s)) {
   if (currentTemplateVersion) {
     out(`${GUT}  ♻️  ${paint("업데이트", A.bold)} — 템플릿 ${paint(`v${currentTemplateVersion}`, A.dim)} → ${paint(`v${templateVersion}`, A.green)}\n`);
+    out(`${GUT}     ${paint("version.yml에 이전 통합 기록이 있어 업데이트로 진행합니다", A.dim)}\n`);
   } else {
     out(`${GUT}  🆕 ${paint("신규 통합", A.bold)} — 이 프로젝트에 처음 설치합니다 (템플릿 ${paint(`v${templateVersion}`, A.green)})\n`);
+    out(`${GUT}     ${paint("version.yml에 이전 통합 기록이 없어 신규로 봅니다", A.dim)}\n`);
   }
   out(`${GUT}\n`);
 }

package/src/ui/summary.js

@@ -168,6 +168,6 @@ export function printSummary(ctx, targetRoot = ".") {
   err(SEPARATOR);
   err("");
   err(`${CYAN}📖 자세한 설정 방법은 다음 파일을 참고하세요:${NC}`);
-  err("   → SUH-DEVOPS-TEMPLATE-SETUP-GUIDE.md");
+  err("   → PROJECTOPS-SETUP-GUIDE.md");
   err("");
 }