projectops 4.71.3 → 4.72.0

package/README.md

@@ -11,7 +11,7 @@
 **Status: actively maintained.** npm `latest` is exactly what is on the `main` branch; work in progress on `develop` is never published. Versions can still ship several times a day. To stay on a version you have tested, run `npx projectops@<version>` ([releases](https://github.com/Cassiiopeia/projectops/releases)).
 
 <!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->
-## Latest version : v4.71.2 (2026-10-21)
+## Latest version : v4.71.3 (2026-10-22)
 
 [View full version history](CHANGELOG.md)
 
@@ -229,7 +229,7 @@ flowchart TD
 </details>
 
 <details>
-<summary>Install Agent Skills only (Claude Code, Gemini CLI, Codex CLI, Cursor)</summary>
+<summary>Install Agent Skills only (Claude Code, Gemini CLI, Codex CLI, Cursor, GitHub Copilot)</summary>
 
 ```bash
 # Claude Code
@@ -252,7 +252,7 @@ The `--mode skills` wizard registers the Codex marketplace and also prepares the
 Where the Codex plugin marketplace is unavailable, use the fallback install described in the [Skills guide](docs/en/skills.md).
 
 ```bash
-# Cursor / the full Agent Skills install menu (recommended: npx)
+# Cursor / GitHub Copilot (~/.copilot/skills) / the full Agent Skills install menu (recommended: npx)
 npx projectops --mode skills
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projectops",
-  "version": "4.71.3",
+  "version": "4.72.0",
   "description": "ProjectOps: installer CLI for a fully automated GitHub project management template (versioning, CI/CD, release notes, agent skills)",
   "keywords": [
     "devops",

package/src/cli/args.js

@@ -37,6 +37,7 @@ export function parseArgs(argv) {
     projectsSync: null,  // #716 — Projects 보드 동기화 워크플로우 포함 여부 (null=미지정)
     json: false,         // --json: 기계가 읽는 출력 (--mode options)
     removeLegacy: false, // #809 — 구세대 배포 워크플로우(confirm 티어)도 .bak 으로 치운다
+    createDevelopmentBranch: false, // #715 — 비대화형에서 개발 브랜치 생성·push (원격에 쓰므로 명시할 때만)
     pathsCsv: "",            // "flutter=app,react=client" 원문 (정규화는 resolve 단계)
     force: false,
     lang: null,              // --lang en|ko (null = decided by src/i18n resolveLang)
@@ -177,6 +178,7 @@ export function parseArgs(argv) {
       case "--projects-sync": result.projectsSync = true; break;
       case "--no-projects-sync": result.projectsSync = false; break;
       case "--remove-legacy": result.removeLegacy = true; break;
+      case "--create-development-branch": result.createDevelopmentBranch = true; break;
       case "--json": result.json = true; break;
       case "--npm-publish":
         process.stderr.write(t("args.npmPublishDeprecated") + "\n");

package/src/cli/help.js

@@ -50,6 +50,9 @@ Options
       --publish CSV        library registries: nexus,npm,github-packages. omitted: none
       --deploy-branch NAME the DEVELOPMENT branch (head of the release PR), default develop. It is NOT the branch that deploys;
                            that is the repository default branch. This flag does not create the branch
+      --create-development-branch   create the development branch from the default branch and push it to origin when it
+                           is missing. Does nothing if it exists. A failed push does not fail the run; the summary prints
+                           the command to run yourself. omitted: off (pushing to the remote is never done without asking)
       --secret-backup / --no-secret-backup   upload GitHub Secrets to your server over SSH (needs SERVER_* secrets). omitted: excluded
       --ai-summary / --no-ai-summary         AI change summary comment on work PRs. Works with no extra setup. omitted: included
       --coderabbit / --no-coderabbit         install .coderabbit.yaml (only --mode full). Needs the CodeRabbit GitHub app. An existing
@@ -129,6 +132,9 @@ AI agent 나 CI 는 항상 이렇게 실행한다:      npx projectops --mode <
       --publish CSV        라이브러리 레지스트리: nexus,npm,github-packages. 생략: 없음
       --deploy-branch NAME **개발** 브랜치(릴리스 PR 의 head), 기본 develop. 배포가 도는 브랜치가 아니다 —
                            그것은 레포 기본 브랜치다. 이 플래그는 브랜치를 만들지 않는다
+      --create-development-branch   개발 브랜치가 없으면 기본 브랜치에서 만들고 origin 에 push 한다. 이미 있으면
+                           아무것도 하지 않는다. push 가 실패해도 실행은 실패하지 않고 직접 실행할 명령을 요약에 남긴다.
+                           생략: 꺼짐 (묻지 않고 원격에 push 하지 않는다)
       --secret-backup / --no-secret-backup   GitHub Secret 을 SSH 로 서버에 올린다 (SERVER_* secret 필요). 생략: 제외
       --ai-summary / --no-ai-summary         작업 PR 에 AI 변경 요약 댓글. 추가 설정 없이 동작. 생략: 포함
       --coderabbit / --no-coderabbit         .coderabbit.yaml 설치 (--mode full 에서만). CodeRabbit GitHub 앱이 필요하다.

package/src/commands/doctor.js

@@ -20,6 +20,7 @@ import { verifyInstall } from "../core/verify.js";
 import { readBaseline } from "../core/baseline.js";
 import { detectRepoName } from "../core/detect-fs.js";
 import { detectMigrations } from "../core/migrations/index.js";
+import { scanPlaceholderTriggers } from "../core/placeholder-triggers.js";
 import { t } from "../i18n/index.js";
 
 // 언어 전환(withLang 등) 시점에 평가되도록 함수로 둔다
@@ -96,6 +97,22 @@ export function localChecks(cwd = ".") {
     ],
   });
 
+  // 자동 트리거 + 예시 값 (#662) — 미치환 토큰 검사에 안 걸리는 your-project 류 값이 실패 런을 계속 만든다
+  const autoPlaceholders = scanPlaceholderTriggers(wfDir);
+  add({
+    name: t("doctor.ph.name"), purpose: t("doctor.ph.purpose"),
+    status: autoPlaceholders.length ? "WARN" : "OK",
+    value: autoPlaceholders.length ? t("doctor.count", { n: autoPlaceholders.length }) : t("doctor.none"),
+    detail: autoPlaceholders.length ? [
+      t("doctor.ph.l1"),
+      ...autoPlaceholders.flatMap((w) => [
+        `  ${w.file}  (${w.triggers.join(", ")})`,
+        ...w.values.map((p) => `    ${w.file}:${p.line}  ${p.key}: "${p.value}"`),
+      ]),
+      t("doctor.ph.fix"),
+    ] : null,
+  });
+
   const secretNames = [...v.secrets.keys()];
   add({
     name: t("doctor.sec.name"), purpose: t("doctor.sec.purpose"),

package/src/commands/full.js

@@ -58,7 +58,7 @@ export function runFull(context, tempDir, targetRoot = ".", hooks = {}) {
     })), { version, versionCode });
 
   // 2. README 버전 섹션
-  step("update-readme", () => addVersionSectionToReadme(version, targetRoot), { version });
+  step("update-readme", () => addVersionSectionToReadme(version, targetRoot, language), { version });
 
   // 5. scripts / config
   //    워크플로우 밖 영역도 기록한다 (#561) — "내 스크립트가 갱신됐나"를 로그만 보고 알 수 있게.

package/src/commands/version.js

@@ -37,7 +37,7 @@ export function runVersion(context, tempDir, targetRoot = ".") {
       // 호출부가 recordMode로 기존 값을 넘긴다 (full이 우세 — 업데이트 재실행 범위 축소 방지).
       templateOptions: toTemplateOptions(context, { mode: recordMode, optionsDate: today }),
     }));
-  addVersionSectionToReadme(version, targetRoot);
+  addVersionSectionToReadme(version, targetRoot, context.language);
   copyScripts(tempDir, targetRoot);
   copyConfigFolder(tempDir, targetRoot);
   applyLabelStyle(targetRoot, labelStyle); // #776

package/src/core/copy/readme.js

@@ -3,27 +3,35 @@ import { join } from "node:path";
 import { existsSync, readFileSync, appendFileSync } from "node:fs";
 
 const MARKER = "<!-- AUTO-VERSION-SECTION";
-// ## (최신 버전|최신버전|Version|버전) : vX.Y.Z (대소문자 무시)
-const VERSION_LINE_RE = /##\s*(최신\s*버전|최신버전|Version|버전)\s*:\s*v[0-9]+\.[0-9]+\.[0-9]+/i;
+// ## (최신 버전|최신버전|Latest version|Version|버전) : vX.Y.Z (대소문자 무시)
+const VERSION_LINE_RE = /##\s*(최신\s*버전|최신버전|Latest\s+version|Version|버전)\s*:\s*v[0-9]+\.[0-9]+\.[0-9]+/i;
+
+// 레포 언어별 섹션 문구 (.github/scripts/i18n 의 readme.version_heading 과 같은 값)
+const SECTION_TEXT = {
+  en: { heading: "Latest version", changelogLink: "View the full version history" },
+  ko: { heading: "최신 버전", changelogLink: "전체 버전 기록 보기" },
+};
 
 // README.md 없으면 스킵. 마커 또는 버전 라인 있으면 스킵. 없으면 파일 끝에 append.
 // 반환: 'skip-no-readme' | 'skip-marker' | 'skip-version-line' | 'added'
-export function addVersionSectionToReadme(version, targetRoot = ".") {
+// language 미지정은 ko — 언어를 넘기지 않는 기존 호출부의 결과를 바꾸지 않기 위함
+export function addVersionSectionToReadme(version, targetRoot = ".", language = "ko") {
   const p = join(targetRoot, "README.md");
   if (!existsSync(p)) return "skip-no-readme";
   const content = readFileSync(p, "utf8");
   if (content.includes(MARKER)) return "skip-marker";
   if (VERSION_LINE_RE.test(content)) return "skip-version-line";
 
+  const text = SECTION_TEXT[language] ?? SECTION_TEXT.ko;
   // append 본문은 빈 줄 + "---"로 시작 (원본 파일이 개행으로 끝난다는 전제).
   const section =
     "\n" +
     "---\n" +
     "\n" +
     "<!-- AUTO-VERSION-SECTION: DO NOT EDIT MANUALLY -->\n" +
-    `## 최신 버전 : v${version}\n` +
+    `## ${text.heading} : v${version}\n` +
     "\n" +
-    "[전체 버전 기록 보기](CHANGELOG.md)\n";
+    `[${text.changelogLink}](CHANGELOG.md)\n`;
   appendFileSync(p, section);
   return "added";
 }

package/src/core/copy/simple.js

@@ -35,6 +35,8 @@ export function copyScripts(tempDir, targetRoot = ".") {
     "asc_client.py",
     // iOS 버전 사전 점검, 업로드 거부 분류, 아카이브부터 업로드까지 재시도 (#643).
     "ios_release.py",
+    // Flutter iOS 빌드의 Xcode 선택(빈 값 = 러너 최신)과 SDK 누락 진단 (#758). 선택 규칙의 유일한 위치.
+    "select_xcode.py",
     // 릴리스 머지 때 완료 라벨이 붙은 이슈를 닫는다 (#771). close_on_release 옵션이 켜진 레포에서만 동작한다.
     "close_issues_on_release.py",
     // Play Store/TestFlight 배포 모드를 코드 설정(.github/config/store-deploy.json)에서 읽는다 (#767).
@@ -60,7 +62,7 @@ export function copyScripts(tempDir, targetRoot = ".") {
   const i18nSrc = join(tempDir, PATHS.scriptsDir, "i18n");
   if (exists(i18nSrc)) {
     for (const f of readdirSync(i18nSrc)) {
-      if (!/\.(py|json)$/.test(f)) continue; // __pycache__ 등은 제외
+      if (!/\.(py|json|cjs)$/.test(f)) continue; // __pycache__ 등은 제외 (cjs: 워크플로우 댓글 런타임)
       copyFileSync(join(i18nSrc, f), join(targetRoot, PATHS.scriptsDir, "i18n", f));
       copied++;
     }

package/src/core/development-branch.js

@@ -0,0 +1,58 @@
+// 비대화형 개발(릴리스 소스) 브랜치 생성 (#715) — --create-development-branch 를 준 실행에서만.
+// 대화형 ensureDeployBranch 를 "모든 질문에 예"로 다시 쓴다: 존재 판단·생성·push 경로를 한 벌로 유지.
+// 실패해도 예외를 던지지 않는다 — 통합 전체를 실패시키지 않고 수동 명령만 남긴다.
+import { ensureDeployBranch } from "./options-ask.js";
+
+// ensureDeployBranch state > 결과 3종 (created · skipped · failed)
+const STATUS_BY_STATE = {
+  "exists-local": "skipped",
+  "exists-remote": "skipped",
+  "pushed": "created",
+  "push-failed": "failed",
+  "create-failed": "failed",
+  "not-a-repo": "failed",
+  "not-checked": "failed",
+};
+
+// 실패 사유별 수동 명령 (push 실패는 로컬 브랜치가 이미 생겼으므로 push 만)
+function manualCommandFor(state, branch, base) {
+  if (state === "push-failed") return `git push -u origin ${branch}`;
+  if (state === "create-failed" && base) return `git branch ${branch} ${base} && git push -u origin ${branch}`;
+  return `git checkout -b ${branch} && git push -u origin ${branch}`;
+}
+
+/**
+ * 개발 브랜치 확인 > 없으면 기본 브랜치에서 생성 > origin push
+ * 반환: { status, reason, branch, base, pushed, manualCommand(실패 시만) }
+ */
+export async function createDevelopmentBranchUnattended({ targetRoot = ".", branch = "develop", defaultBranch = "", say = () => {} }) {
+  const answerYes = { confirm: async () => true };
+  const outcome = await ensureDeployBranch({ targetRoot, deployBranch: branch, defaultBranch, io: answerYes, say });
+  const status = STATUS_BY_STATE[outcome.state] ?? "failed";
+  return {
+    status,
+    reason: outcome.state,
+    branch,
+    base: defaultBranch,
+    pushed: outcome.pushed === true,
+    manualCommand: status === "failed" ? manualCommandFor(outcome.state, branch, defaultBranch) : null,
+  };
+}
+
+/**
+ * 실행 단계 래퍼: 플래그 확인 > 생성 시도 > 실행 기록(trace) 남김
+ * 플래그가 없으면 만들지 않고 "왜 안 만들었는지"만 기록. 반환: 결과 | null(플래그 없음)
+ */
+export async function runDevelopmentBranchStep({ isRequested = false, targetRoot, branch, defaultBranch, trace = null, say = () => {} }) {
+  const name = branch || "develop";
+  if (!isRequested) {
+    trace?.event("dev-branch", "not-requested", name, { flag: "--create-development-branch", note: "left as a manual step" });
+    return null;
+  }
+  const result = await createDevelopmentBranchUnattended({ targetRoot, branch: name, defaultBranch, say });
+  // action 이 곧 결과 — failed 는 로그에서 ERROR 로 보인다 (run-trace levelOf)
+  trace?.event("dev-branch", result.status, name, {
+    base: defaultBranch || null, reason: result.reason, pushed: result.pushed, manualCommand: result.manualCommand,
+  });
+  return result;
+}

package/src/core/ide/adapter.js

@@ -19,7 +19,7 @@
 //   remove(io, ctx): boolean                  제거(미설치면 no-op, true)
 //   manualHint(io): string                    CLI 없을 때 보여줄 수동 설치 명령(선택)
 //
-// io = runner.defaultIo() 또는 테스트 stub: { which, run, home, log }
+// io = runner.defaultIo() 또는 테스트 stub: { which, run, home, log, projectopsHome?(없으면 home/.projectops) }
 // ctx = { templateVersion, sourceSkillsDir } — 버전 표기·Cursor 복사 소스 등 공용 컨텍스트
 //
 // 규칙:

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

@@ -0,0 +1,84 @@
+// GitHub Copilot 어댑터 (agent skills 복사·메타 기록·제거).
+// 개인 스킬 폴더 ~/.copilot/skills/<이름>/SKILL.md 를 VS Code·Copilot CLI·JetBrains 플러그인이 모두 기본으로 읽는다
+//   (JetBrains 1.18 기본 위치: .agents/.github/.claude skills + ~/.agents·~/.copilot·~/.claude skills)
+// ~/.copilot/intellij-skills 는 JetBrains 플러그인이 내장 스킬을 덮어쓰는 관리 폴더라 쓰지 않는다.
+// 스킬 이름(frontmatter name)은 폴더명과 같아야 로드된다 — pro-* 폴더가 이미 그 규칙을 지킨다.
+import { join } from "node:path";
+import { existsSync, readdirSync } from "node:fs";
+import { migrateConfigRoot } from "../legacy.js";
+import { t } from "../../../i18n/index.js";
+import { readSkillsMeta } from "../skills-copy.js";
+import { applyHomeSkills, removeHomeSkills } from "../home-skills.js";
+
+const META_FILE_NAME = "copilot-skills-meta.json";
+const MESSAGE_PREFIX = "ide.copilot";
+// Copilot 사용 흔적 4종: copilot CLI, ~/.copilot 폴더(CLI·JetBrains 가 만듦), VS Code 확장, JetBrains 플러그인
+const COPILOT_CLI_NAME = "copilot";
+const COPILOT_HOME_DIR = ".copilot";
+const VSCODE_EXTENSION_DIRS = [".vscode/extensions", ".vscode-insiders/extensions"];
+// VS Code 확장 폴더명: github.copilot-1.2.3 · github.copilot-chat-0.30.0
+const VSCODE_EXTENSION_PREFIX = "github.copilot";
+// IDE 설정 루트 (macOS · Windows · Linux) > <제품><버전>/plugins/github-copilot-intellij
+//   Linux 는 플러그인이 <제품><버전>/ 바로 아래에 깔린다. Android Studio 도 같은 플러그인을 쓴다.
+const JETBRAINS_CONFIG_ROOTS = [
+  "Library/Application Support/JetBrains", "AppData/Roaming/JetBrains", ".local/share/JetBrains",
+  "Library/Application Support/Google", "AppData/Roaming/Google", ".local/share/Google",
+];
+const JETBRAINS_PLUGIN_PREFIX = "github-copilot";
+
+function skillsDir(io) { return join(io.home(), COPILOT_HOME_DIR, "skills"); }
+function metaPath(io) { return join(skillsDir(io), META_FILE_NAME); }
+function homeSkillsOptions(io) { return { skillsDest: skillsDir(io), metaFileName: META_FILE_NAME, messagePrefix: MESSAGE_PREFIX }; }
+
+// 쓰지 않는 사람 홈에 ~/.copilot 을 만들지 않도록, 흔적이 있을 때만 설치 후보로 둔다
+function isCopilotDetected(io) {
+  if (io.which(COPILOT_CLI_NAME)) return true;
+  if (existsSync(join(io.home(), COPILOT_HOME_DIR))) return true;
+  if (VSCODE_EXTENSION_DIRS.some((dir) => hasEntryWithPrefix(join(io.home(), dir), VSCODE_EXTENSION_PREFIX))) return true;
+  return JETBRAINS_CONFIG_ROOTS.some((root) => hasJetBrainsCopilotPlugin(join(io.home(), root)));
+}
+
+function hasJetBrainsCopilotPlugin(configRoot) {
+  for (const productDir of listNames(configRoot)) {
+    const productPath = join(configRoot, productDir);
+    if (hasEntryWithPrefix(join(productPath, "plugins"), JETBRAINS_PLUGIN_PREFIX)) return true;
+    if (hasEntryWithPrefix(productPath, JETBRAINS_PLUGIN_PREFIX)) return true;
+  }
+  return false;
+}
+
+function hasEntryWithPrefix(dir, prefix) {
+  return listNames(dir).some((name) => name.toLowerCase().startsWith(prefix));
+}
+
+function listNames(dir) {
+  if (!existsSync(dir)) return [];
+  try { return readdirSync(dir); } catch { return []; }
+}
+
+function detect(io) {
+  const { installed, version } = readSkillsMeta(metaPath(io));
+  if (installed) return { installed, version, cliMissing: false };
+  if (isCopilotDetected(io)) return { installed: false, version: null, cliMissing: false, note: t("ide.copilot.detected") };
+  return { installed: false, version: null, cliMissing: true, note: t("ide.copilot.notDetected") };
+}
+
+function apply(io, ctx = {}) {
+  if (detect(io).cliMissing) { io.log(manualHint()); return false; }
+  migrateConfigRoot(io);    // 공용 config 루트 이관
+  return applyHomeSkills(io, ctx, homeSkillsOptions(io));
+}
+
+// 사용자가 직접 넣은 스킬이 남으면 폴더 유지
+function remove(io, ctx = {}) {
+  return removeHomeSkills(io, ctx, homeSkillsOptions(io));
+}
+
+function manualHint() {
+  return t("ide.copilot.manual");
+}
+
+export const copilotAdapter = {
+  id: "copilot", label: "GitHub Copilot", order: 45,
+  detect, apply, remove, manualHint,
+};

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

@@ -1,95 +1,35 @@
 // Cursor 어댑터 (skills 복사·메타 기록·제거).
-// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더를 복사하고 meta.json으로 버전 추적.
+// 마켓플레이스 없음 → ~/.cursor/skills/ 에 skills/ 폴더, ~/.cursor/scripts/ 에 공용 파이썬을 복사하고 meta.json으로 버전 추적.
 import { join } from "node:path";
-import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { existsSync, readFileSync, rmSync } from "node:fs";
 import { migrateConfigRoot, isLegacyVersion } from "../legacy.js";
 import { t } from "../../../i18n/index.js";
-import { TEMPLATE_REPO_WEB_URL } from "../../paths.js";
+import { readSkillsMeta, ownedEntries } from "../skills-copy.js";
+import { applyHomeSkills, removeHomeSkills } from "../home-skills.js";
 
 const LEGACY_NAMES = ["cassiiopeia", "suh-devops-template"];
 const LEGACY_MAX_VERSION = "4.2.4";
+const META_FILE_NAME = "cursor-skills-meta.json";
+const MESSAGE_PREFIX = "ide.cursor";
 
-// 스킬을 쓰는 사람에게 필요 없는 것. projectops 자신을 검사하는 테스트다.
-// skills/ 는 통째로 복사되므로 여기서 걸러내지 않으면 사용자 홈에 그대로 쌓인다.
-const SKIP_IN_COPY = new Set(["conftest.py", "pytest.ini"]);
-const TEST_PATH = /(^|[\\/])(tests?|__pycache__)([\\/]|$)/;
-
-function metaPath(io) { return join(io.home(), ".cursor/skills/cursor-skills-meta.json"); }
+function skillsDir(io) { return join(io.home(), ".cursor/skills"); }
+function metaPath(io) { return join(skillsDir(io), META_FILE_NAME); }
+function homeSkillsOptions(io) { return { skillsDest: skillsDir(io), metaFileName: META_FILE_NAME, messagePrefix: MESSAGE_PREFIX }; }
 
 function detect(io) {
-  const mp = metaPath(io);
-  if (!existsSync(mp)) return { installed: false, version: null, cliMissing: false };
-  let version = null;
-  try {
-    const m = JSON.parse(readFileSync(mp, "utf8"));
-    version = m.version || null;
-  } catch { /* meta 손상 → 설치는 됐다고 봄 */ }
-  return { installed: true, version, cliMissing: false };
+  const { installed, version } = readSkillsMeta(metaPath(io));
+  return { installed, version, cliMissing: false };
 }
 
 function apply(io, ctx = {}) {
   migrateLegacy(io, ctx);   // 옛 이름/버전 감지 시 projectops 소유 항목 선별 삭제
   migrateConfigRoot(io);    // 공용 config 루트 이관
-  const src = resolveSkillsSrc(ctx);
-  if (!src) { io.log(t("ide.cursor.noSource")); return false; }
-  const dest = join(io.home(), ".cursor/skills");
-  io.log(t("ide.cursor.copying"));
-  try {
-    mkdirSync(dest, { recursive: true });
-    for (const e of readdirSync(src, { withFileTypes: true })) {
-      if (SKIP_IN_COPY.has(e.name)) continue;
-      cpSync(join(src, e.name), join(dest, e.name), {
-        recursive: true,
-        // 이 저장소 자기 코드를 검사하는 테스트는 남의 컴퓨터로 나갈 이유가 없다 (#591).
-        filter: (p) => !TEST_PATH.test(p),
-      });
-    }
-    // 소스에서 사라진 우리 스킬을 지운다. 복사는 overlay 라 덮어쓰기만 하면
-    // **폐기한 스킬이 남의 컴퓨터에 영영 남아** 계속 잡힌다 — util 복사가 같은
-    // 함정에 빠졌던 자리다 (#500). 남의 스킬은 접두사로 걸러 건드리지 않는다.
-    const srcNames = new Set(readdirSync(src));
-    for (const name of readdirSync(dest)) {
-      if (srcNames.has(name) || name === "cursor-skills-meta.json") continue;
-      if (!/^(pro|suh)-/.test(name)) continue;
-      try {
-        rmSync(join(dest, name), { recursive: true, force: true });
-        io.log(t("ide.cursor.obsolete", { name }));
-      } catch { /* 무시 — 지우지 못해도 설치는 계속한다 */ }
-    }
-    writeMeta(io, dest, ctx.templateVersion);
-    io.log(t("ide.cursor.installed", { dest, version: ctx.templateVersion || "unknown" }));
-    return true;
-  } catch {
-    io.log(t("ide.cursor.copyFailed"));
-    return false;
-  }
+  return applyHomeSkills(io, ctx, homeSkillsOptions(io));
 }
 
+// 타 스킬(somansa-tools 등) 남으면 폴더 유지
 function remove(io, ctx = {}) {
-  const dir = join(io.home(), ".cursor/skills");
-  if (!existsSync(join(dir, "cursor-skills-meta.json"))) { io.log(t("ide.cursor.removeNone")); return true; }
-  try {
-    for (const name of ownedEntries(io, ctx)) rmSync(join(dir, name), { recursive: true, force: true });
-    // 폴더가 비면 폴더 자체 제거, 타 스킬(somansa-tools 등) 남으면 유지
-    if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
-    io.log(t("ide.cursor.removed", { dir }));
-    return true;
-  } catch { io.log(t("ide.cursor.removeFailed", { dir })); return false; }
-}
-
-// projectops가 이 폴더에 설치했다고 볼 항목만 골라낸다.
-// 소스 skills/ 폴더명(pro-*, references, config.json.example) ∪ /^suh-/ ∪ meta 파일.
-// 접두어 없는 폴더(analyze·gitlab 등 somansa-tools)는 제외 → 보존.
-function ownedEntries(io, ctx) {
-  const dir = join(io.home(), ".cursor/skills");
-  if (!existsSync(dir)) return [];
-  let srcNames = new Set();
-  const src = resolveSkillsSrc(ctx);
-  if (src && existsSync(src)) srcNames = new Set(readdirSync(src));
-  const EXTRA = new Set(["cursor-skills-meta.json"]);
-  // suh- 는 옛 접두사, pro- 는 현행 접두사다. 둘 다 우리 것으로 친다 —
-  // 폐기한 스킬은 소스에 없으므로 srcNames 로는 잡히지 않는다 (#619).
-  return readdirSync(dir).filter((name) => srcNames.has(name) || /^(pro|suh)-/.test(name) || EXTRA.has(name));
+  return removeHomeSkills(io, ctx, homeSkillsOptions(io));
 }
 
 // 옛 이름/버전 meta면 projectops 소유 항목만 선별 삭제 → apply가 신규 재설치.
@@ -101,8 +41,8 @@ function migrateLegacy(io, ctx) {
   const oldName = meta.name && LEGACY_NAMES.includes(String(meta.name).toLowerCase());
   const oldVer = isLegacyVersion(meta.version, LEGACY_MAX_VERSION);
   if (!(oldName || oldVer)) return;
-  for (const name of ownedEntries(io, ctx)) {
-    try { rmSync(join(io.home(), ".cursor/skills", name), { recursive: true, force: true }); } catch { /* 무시 */ }
+  for (const name of ownedEntries(skillsDir(io), ctx, META_FILE_NAME)) {
+    try { rmSync(join(skillsDir(io), name), { recursive: true, force: true }); } catch { /* 무시 */ }
   }
   io.log(t("ide.cursor.legacy", { name: meta.name, version: meta.version }));
 }
@@ -111,29 +51,6 @@ function manualHint() {
   return t("ide.cursor.manual");
 }
 
-// ── 헬퍼 ──
-// 스킬 소스: 다운로드된 템플릿(TEMP)/skills 우선, 없으면 로컬 skills/.
-function resolveSkillsSrc(ctx) {
-  const cands = [ctx.sourceSkillsDir, ctx.tempDir && join(ctx.tempDir, "skills"), "skills"].filter(Boolean);
-  for (const c of cands) if (existsSync(c)) return c;
-  return "";
-}
-
-function writeMeta(io, destDir, templateVersion) {
-  const version = templateVersion || "unknown";
-  const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
-  const file = join(destDir, "cursor-skills-meta.json");
-  let installedAt = now;
-  if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
-  const meta = {
-    name: "projectops", version, scope: "user",
-    source: TEMPLATE_REPO_WEB_URL,
-    installPath: destDir, installedAt, lastUpdated: now,
-  };
-  mkdirSync(destDir, { recursive: true });
-  writeFileSync(file, JSON.stringify(meta, null, 2) + "\n");
-}
-
 export const cursorAdapter = {
   id: "cursor", label: "Cursor", order: 20,
   detect, apply, remove, manualHint,

package/src/core/ide/home-skills.js

@@ -0,0 +1,52 @@
+// 홈 복사형 IDE(Cursor·Copilot) 설치·제거 흐름 공용: 소스 찾기 > 복사 > 진입점 > 로그
+// 메시지는 어댑터별 키 묶음(<messagePrefix>.copying 등)을 쓴다.
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { t } from "../../i18n/index.js";
+import { resolveSkillsSrc, resolveScriptsSrc, installHomeSkills, removeOwnedEntries } from "./skills-copy.js";
+import { refreshStableEntrypoints, projectopsHomeOf } from "./stable-entry.js";
+
+/**
+ * 설치·업데이트: 스킬 소스 확인 > 스킬·공용 파이썬 복사 > 고정 진입점 > 결과 로그
+ * options: { skillsDest, metaFileName, messagePrefix }
+ */
+export function applyHomeSkills(io, ctx, { skillsDest, metaFileName, messagePrefix }) {
+  const skillsSrc = resolveSkillsSrc(ctx);
+  if (!skillsSrc) { io.log(t(`${messagePrefix}.noSource`)); return false; }
+  const scriptsSrc = resolveScriptsSrc(ctx, skillsSrc);
+  io.log(t(`${messagePrefix}.copying`));
+  try {
+    const { obsoleteNames, hasSharedScripts } = installHomeSkills({
+      skillsSrc, scriptsSrc, skillsDest, metaFileName, templateVersion: ctx.templateVersion,
+    });
+    for (const name of obsoleteNames) io.log(t("ide.skillsCopy.obsolete", { name }));
+    // 공용 파이썬이 없으면 스킬 CLI 가 import 에 실패 → 알림만 (문서형 스킬은 동작)
+    if (!hasSharedScripts) io.log(t("ide.skillsCopy.noScripts"));
+    io.log(t(`${messagePrefix}.installed`, { dest: skillsDest, version: ctx.templateVersion || "unknown" }));
+  } catch {
+    io.log(t(`${messagePrefix}.copyFailed`));
+    return false;
+  }
+  installStableEntrypoints(io, skillsSrc, scriptsSrc);
+  return true;
+}
+
+// 진입점 실패는 설치 실패가 아니다 (CLI 첫 실행 때 파이썬이 다시 깐다)
+function installStableEntrypoints(io, skillsSrc, scriptsSrc) {
+  try {
+    const projectopsHome = projectopsHomeOf(io);
+    for (const name of refreshStableEntrypoints(projectopsHome, { skillsSrc, scriptsSrc })) {
+      io.log(t("ide.skillsCopy.entrypoint", { path: join(projectopsHome, "bin", name) }));
+    }
+  } catch { io.log(t("ide.skillsCopy.entrypointFailed")); }
+}
+
+// 제거: 메타 없으면 건너뜀 > 우리 항목·공용 파이썬만 삭제 (남의 스킬이 남으면 폴더 유지)
+export function removeHomeSkills(io, ctx, { skillsDest, metaFileName, messagePrefix }) {
+  if (!existsSync(join(skillsDest, metaFileName))) { io.log(t(`${messagePrefix}.removeNone`)); return true; }
+  try {
+    removeOwnedEntries(skillsDest, ctx, metaFileName);
+    io.log(t(`${messagePrefix}.removed`, { dir: skillsDest }));
+    return true;
+  } catch { io.log(t(`${messagePrefix}.removeFailed`, { dir: skillsDest })); return false; }
+}

package/src/core/ide/registry.js

@@ -9,6 +9,7 @@ import { claudeAdapter } from "./adapters/claude.js";
 import { cursorAdapter } from "./adapters/cursor.js";
 import { geminiAdapter } from "./adapters/gemini.js";
 import { codexAdapter } from "./adapters/codex.js";
+import { copilotAdapter } from "./adapters/copilot.js";
 import { piAdapter } from "./adapters/pi.js";
 import { piHarnessAdapter } from "./adapters/pi-harness.js";
 
@@ -18,6 +19,7 @@ export const ADAPTERS = [
   cursorAdapter,
   geminiAdapter,
   codexAdapter,
+  copilotAdapter,
   piAdapter,
   piHarnessAdapter,
 ].map(assertAdapter).sort((a, b) => (a.order ?? 100) - (b.order ?? 100));

package/src/core/ide/runner.js

@@ -54,6 +54,8 @@ export function defaultIo() {
     which,
     run,
     home: () => homedir(),
+    // 파이썬 stable_entry 와 같은 규칙: PROJECTOPS_HOME > ~/.projectops
+    projectopsHome: () => process.env.PROJECTOPS_HOME || join(homedir(), ".projectops"),
     log: (msg) => console.error(msg), // 안내는 stderr로 (stdout 파이프 오염 방지)
   };
 }

package/src/core/ide/skills-copy.js

@@ -0,0 +1,147 @@
+// 스킬 폴더 복사 공용 (Cursor·Copilot): skills/ + 공용 파이썬 scripts/ > 홈 설치 루트, 테스트 제외, 폐기 정리, 메타 기록
+// 마켓플레이스 없이 SKILL.md 폴더를 그대로 읽는 IDE 가 같은 규칙을 쓰도록 한 곳에 둔다.
+// 설치 모양은 플러그인 캐시와 같다: <설치 루트>/skills/pro-*/scripts/x_cli.py + <설치 루트>/scripts/common
+//   (스킬 CLI bootstrap 이 x_cli.py 기준 3단계 위의 scripts/ 를 import 경로로 쓴다)
+import { dirname, join, relative } from "node:path";
+import { existsSync, readFileSync, mkdirSync, cpSync, rmSync, writeFileSync, readdirSync } from "node:fs";
+import { TEMPLATE_REPO_WEB_URL } from "../paths.js";
+
+// 스킬을 쓰는 사람에게 필요 없는 것. projectops 자신을 검사하는 테스트다.
+// skills/ 는 통째로 복사되므로 여기서 걸러내지 않으면 사용자 홈에 그대로 쌓인다.
+export const SKIP_IN_COPY = new Set(["conftest.py", "pytest.ini"]);
+export const TEST_PATH = /(^|[\\/])(tests?|__pycache__)([\\/]|$)/;
+// 우리 스킬 접두사: pro- 현행, suh- 옛 이름
+const OWNED_SKILL_NAME = /^(pro|suh)-/;
+// 공용 파이썬 패키지 표식: scripts/common/__init__.py
+const SHARED_SCRIPTS_MARKER = join("common", "__init__.py");
+const SHARED_SCRIPTS_DIR_NAME = "scripts";
+const PYTHON_CACHE_DIR_NAME = "__pycache__";
+
+// 스킬 소스: 다운로드된 템플릿(TEMP)/skills 우선, 없으면 로컬 skills/
+export function resolveSkillsSrc(ctx = {}) {
+  const cands = [ctx.sourceSkillsDir, ctx.tempDir && join(ctx.tempDir, "skills"), "skills"].filter(Boolean);
+  for (const c of cands) if (existsSync(c)) return c;
+  return "";
+}
+
+// 공용 파이썬 소스: 직접 지정 > 템플릿(TEMP)/scripts > 스킬 소스 옆 scripts/ (같은 레포)
+export function resolveScriptsSrc(ctx = {}, skillsSrc = "") {
+  const cands = [ctx.sourceScriptsDir, ctx.tempDir && join(ctx.tempDir, SHARED_SCRIPTS_DIR_NAME),
+    skillsSrc && join(dirname(skillsSrc), SHARED_SCRIPTS_DIR_NAME)].filter(Boolean);
+  for (const c of cands) if (existsSync(join(c, SHARED_SCRIPTS_MARKER))) return c;
+  return "";
+}
+
+// 메타 파일 > {installed, version, sharedScripts} (손상된 메타는 설치됐다고 봄)
+export function readSkillsMeta(metaFile) {
+  if (!existsSync(metaFile)) return { installed: false, version: null, sharedScripts: [] };
+  try {
+    const meta = JSON.parse(readFileSync(metaFile, "utf8"));
+    return { installed: true, version: meta.version || null, sharedScripts: Array.isArray(meta.sharedScripts) ? meta.sharedScripts : [] };
+  } catch { return { installed: true, version: null, sharedScripts: [] }; }
+}
+
+// 소스 최상위 항목 복사 (테스트·conftest 제외). 필터는 소스 기준 상대경로로 본다 —
+// 절대경로로 보면 소스가 ~/test/... 아래에 있을 때 전부 걸러진다.
+function copyEntriesWithoutTests(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  const copiedNames = [];
+  for (const e of readdirSync(src, { withFileTypes: true })) {
+    if (SKIP_IN_COPY.has(e.name) || TEST_PATH.test(e.name)) continue;
+    cpSync(join(src, e.name), join(dest, e.name), {
+      recursive: true,
+      // 이 저장소 자기 코드를 검사하는 테스트는 남의 컴퓨터로 나갈 이유가 없다 (#591).
+      filter: (p) => !TEST_PATH.test(relative(src, p)),
+    });
+    copiedNames.push(e.name);
+  }
+  return copiedNames;
+}
+
+/**
+ * 스킬 복사: 소스 > dest (테스트 제외) > 소스에서 사라진 우리 스킬 제거
+ * 폐기한 스킬 이름 목록 반환. 복사 실패는 예외로 올린다 (호출부가 로그·false 처리).
+ */
+export function copySkillsTree(src, dest, metaFileName) {
+  copyEntriesWithoutTests(src, dest);
+  // 복사는 overlay 라 덮어쓰기만 하면 **폐기한 스킬이 남의 컴퓨터에 영영 남아** 계속 잡힌다 (#500).
+  // 남의 스킬은 접두사로 걸러 건드리지 않는다.
+  const srcNames = new Set(readdirSync(src));
+  const obsoleteNames = [];
+  for (const name of readdirSync(dest)) {
+    if (srcNames.has(name) || name === metaFileName) continue;
+    if (!OWNED_SKILL_NAME.test(name)) continue;
+    try {
+      rmSync(join(dest, name), { recursive: true, force: true });
+      obsoleteNames.push(name);
+    } catch { /* 무시 — 지우지 못해도 설치는 계속한다 */ }
+  }
+  return obsoleteNames;
+}
+
+// 공용 파이썬 교체 복사: 지난 설치 항목 제거 > 소스 전체 복사 (폐기 모듈이 남지 않게). 복사한 항목 이름 반환
+function replaceSharedScripts(scriptsSrc, scriptsDest, previousNames) {
+  removeNamedEntries(scriptsDest, previousNames);
+  return copyEntriesWithoutTests(scriptsSrc, scriptsDest);
+}
+
+// 이름 목록 + 파이썬 실행이 만든 __pycache__ 삭제 > 폴더가 비면 폴더도 삭제
+function removeNamedEntries(dir, names) {
+  for (const name of [...names, PYTHON_CACHE_DIR_NAME]) {
+    // 메타에서 읽은 이름이라 경로 이동(../) 차단
+    if (!name || name.includes("/") || name.includes("\\") || name === "..") continue;
+    rmSync(join(dir, name), { recursive: true, force: true });
+  }
+  if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
+}
+
+/**
+ * 홈 설치 1회: 스킬 복사 > 공용 파이썬 교체 복사 > 메타 기록
+ * {obsoleteNames, hasSharedScripts} 반환. 실패는 예외로 올린다.
+ */
+export function installHomeSkills({ skillsSrc, scriptsSrc, skillsDest, metaFileName, templateVersion }) {
+  const metaFile = join(skillsDest, metaFileName);
+  const previousSharedScripts = readSkillsMeta(metaFile).sharedScripts;
+  const obsoleteNames = copySkillsTree(skillsSrc, skillsDest, metaFileName);
+  const scriptsDest = join(dirname(skillsDest), SHARED_SCRIPTS_DIR_NAME);
+  const sharedScripts = scriptsSrc ? replaceSharedScripts(scriptsSrc, scriptsDest, previousSharedScripts) : previousSharedScripts;
+  writeSkillsMeta(skillsDest, metaFileName, templateVersion, { sharedScripts });
+  return { obsoleteNames, hasSharedScripts: !!scriptsSrc };
+}
+
+// projectops 가 이 폴더에 설치했다고 볼 항목: 소스 폴더명 ∪ pro-/suh- 접두사 ∪ 메타 파일
+// 접두어 없는 폴더(somansa-tools 등 남의 스킬)는 제외 → 보존
+export function ownedEntries(dir, ctx, metaFileName) {
+  if (!existsSync(dir)) return [];
+  let srcNames = new Set();
+  const src = resolveSkillsSrc(ctx);
+  if (src && existsSync(src)) srcNames = new Set(readdirSync(src));
+  // 폐기한 스킬은 소스에 없으므로 srcNames 로는 잡히지 않는다 (#619).
+  return readdirSync(dir).filter((name) => srcNames.has(name) || OWNED_SKILL_NAME.test(name) || name === metaFileName);
+}
+
+// 우리 항목만 삭제 (메타에 적힌 공용 파이썬 포함) > 폴더가 비면 폴더도 삭제. 실패는 예외로 올린다.
+export function removeOwnedEntries(dir, ctx, metaFileName) {
+  const { sharedScripts } = readSkillsMeta(join(dir, metaFileName));
+  for (const name of ownedEntries(dir, ctx, metaFileName)) rmSync(join(dir, name), { recursive: true, force: true });
+  if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
+  const scriptsDest = join(dirname(dir), SHARED_SCRIPTS_DIR_NAME);
+  if (sharedScripts.length && existsSync(scriptsDest)) removeNamedEntries(scriptsDest, sharedScripts);
+}
+
+// 메타 기록: 버전 추적용 (installedAt 은 첫 설치 시각 유지). extraFields: sharedScripts 등
+export function writeSkillsMeta(destDir, metaFileName, templateVersion, extraFields = {}) {
+  const version = templateVersion || "unknown";
+  const now = new Date().toISOString().replace(/\.\d+Z$/, "Z");
+  const file = join(destDir, metaFileName);
+  let installedAt = now;
+  if (existsSync(file)) { try { installedAt = JSON.parse(readFileSync(file, "utf8")).installedAt || now; } catch { /* 무해 */ } }
+  const meta = {
+    name: "projectops", version, scope: "user",
+    source: TEMPLATE_REPO_WEB_URL,
+    installPath: destDir, installedAt, lastUpdated: now,
+    ...extraFields,
+  };
+  mkdirSync(destDir, { recursive: true });
+  writeFileSync(file, JSON.stringify(meta, null, 2) + "\n");
+}

package/src/core/ide/stable-entry.js

@@ -0,0 +1,51 @@
+// 고정 진입점 설치: ~/.projectops/bin/{projectops_cli.py, launch_cli.py} (#942·#897)
+// SKILL.md 는 이 진입점을 먼저 부른다. 파이썬 쪽은 CLI 를 한 번 실행해야 진입점을 깔므로,
+// 홈 복사 설치(Cursor·Copilot)는 첫 호출부터 길을 찾도록 설치 때 깐다 (#200).
+// 규칙은 파이썬 refresh_stable_entrypoint 와 같다: 소스 RESOLVER_REVISION 이 깔린 것보다 높을 때만 덮는다.
+import { join } from "node:path";
+import { existsSync, readFileSync, mkdirSync, writeFileSync, chmodSync, renameSync } from "node:fs";
+
+const REVISION_PATTERN = /^RESOLVER_REVISION = (\d+)/m;
+// 진입점 권한: 직접 실행 가능 (rwxr-xr-x)
+const STABLE_ENTRYPOINT_MODE = 0o755;
+// 진입점 2종: (설치 이름, 소스 경로 계산)
+const STABLE_ENTRYPOINTS = [
+  { name: "projectops_cli.py", source: ({ scriptsSrc }) => scriptsSrc && join(scriptsSrc, "projectops_cli.py") },
+  { name: "launch_cli.py", source: ({ skillsSrc }) => skillsSrc && join(skillsSrc, "pro-launch", "scripts", "launch_resolver.py") },
+];
+
+// 파일 > 내용 번호 (없거나 못 읽으면 -1)
+function readRevision(file) {
+  try {
+    const match = REVISION_PATTERN.exec(readFileSync(file, "utf8"));
+    return match ? Number(match[1]) : -1;
+  } catch { return -1; }
+}
+
+/**
+ * 진입점 갱신: 소스 번호 > 깔린 번호일 때만 임시 파일 > 권한 > 교체
+ * 바꾼 진입점 이름 목록 반환. 실패는 예외로 올린다.
+ */
+export function refreshStableEntrypoints(projectopsHome, sources) {
+  const binDir = join(projectopsHome, "bin");
+  const updatedNames = [];
+  for (const entry of STABLE_ENTRYPOINTS) {
+    const sourceFile = entry.source(sources);
+    if (!sourceFile || !existsSync(sourceFile)) continue;
+    const target = join(binDir, entry.name);
+    if (readRevision(sourceFile) <= readRevision(target)) continue;
+    mkdirSync(binDir, { recursive: true });
+    // 다른 세션이 동시에 읽어도 반쯤 쓴 파일을 보지 않게
+    const temporary = `${target}.${process.pid}.tmp`;
+    writeFileSync(temporary, readFileSync(sourceFile, "utf8"));
+    chmodSync(temporary, STABLE_ENTRYPOINT_MODE);
+    renameSync(temporary, target);
+    updatedNames.push(entry.name);
+  }
+  return updatedNames;
+}
+
+// projectops 홈: io 가 주면 그 값 (테스트 격리), 아니면 ~/.projectops
+export function projectopsHomeOf(io) {
+  return typeof io.projectopsHome === "function" ? io.projectopsHome() : join(io.home(), ".projectops");
+}

package/src/core/migration-guide.js

@@ -75,7 +75,7 @@ export function deriveEnvApplied(events = []) {
 // 실행 엔트리 렌더링. report:
 //   { now, mode, types, repoName, templateFrom, templateTo,
 //     options: {deploy, publish, secretBackup, coderabbit, changelogProvider, intent},
-//     branches: {defaultBranch, deployBranch, ready, created},
+//     branches: {defaultBranch, deployBranch, ready, created, result},  // result: #715 비대화형 생성 결과 | null
 //     breaking: {current, target, critical:[], warnings:[]} | null,
 //     migrations: {applied:[], confirmPending:[], askPending:[]} | null,
 //     orphans: {cleaned:[], pending:[]} | null,
@@ -130,7 +130,15 @@ export function renderGuideEntry(report) {
       for (const [k, v] of kv) checklist.push(`  - ${t} \`${k}\` = \`${v}\``);
     }
   }
-  if (r.branches?.created === true) {
+  const devBranch = r.branches?.deployBranch ?? "develop";
+  const devBranchResult = r.branches?.result ?? null; // #715 --create-development-branch 결과
+  if (devBranchResult?.status === "created") {
+    checklist.push(`- [x] Development (release source) branch \`${devBranch}\`: created from \`${devBranchResult.base || "HEAD"}\` and pushed (--create-development-branch)`);
+  } else if (devBranchResult?.status === "skipped") {
+    checklist.push(`- [x] Development (release source) branch \`${devBranch}\`: already exists, nothing changed (--create-development-branch)`);
+  } else if (devBranchResult?.status === "failed") {
+    checklist.push(`- [ ] **Create the development (release source) branch \`${devBranch}\`**: automatic creation failed (${devBranchResult.reason}). Run: \`${devBranchResult.manualCommand}\``);
+  } else if (r.branches?.created === true) {
     checklist.push(`- [x] Development (release source) branch \`${r.branches?.deployBranch ?? "develop"}\`: created and verified by the wizard`);
   } else if (r.branches?.ready === false) {
     checklist.push(`- [ ] Create the development (release source) branch \`${r.branches?.deployBranch ?? "develop"}\` (required for the release PR to work)`);
@@ -165,7 +173,7 @@ export function renderGuideEntry(report) {
   L.push(`mode: ${r.mode || "full"}`);
   L.push(`types: ${ylist(r.types)}`);
   L.push(`options: { deploy: ${yq(r.options?.deploy ?? "")}, publish: ${ylist(r.options?.publish)}, secret_backup: ${r.options?.secretBackup === true}, coderabbit: ${r.options?.coderabbit === true}, changelog_provider: ${yq(r.options?.changelogProvider ?? "")}, intent: ${yq(r.options?.intent ?? "")}, semver_auto: ${r.options?.semverAuto === true}, language: ${yq(r.options?.language ?? "")}, label_style: ${yq(r.options?.labelStyle ?? "")}, close_on_release: ${r.options?.closeOnRelease === true}, app_release: ${r.options?.appRelease === true} }`);
-  L.push(`branches: { default: ${yq(r.branches?.defaultBranch ?? "main")}, deploy: ${yq(r.branches?.deployBranch ?? "develop")}, deploy_branch_created: ${r.branches?.created === true} }`);
+  L.push(`branches: { default: ${yq(r.branches?.defaultBranch ?? "main")}, deploy: ${yq(r.branches?.deployBranch ?? "develop")}, deploy_branch_created: ${r.branches?.created === true}, create_result: ${devBranchResult ? yq(devBranchResult.status) : "null"} }`);
   L.push("workflows:");
   L.push(`  added: ${ylist(wf.added)}`);
   L.push(`  replaced_bak: ${ylist(wf.replacedBak)}`);

package/src/core/options-ask.js

@@ -21,35 +21,37 @@ import { DEPLOY_TARGETS, PUBLISH_TARGETS, CHANGELOG_PROVIDERS, DEFAULT_CODE_REVI
 //   true  = 브랜치가 이미 있거나 이번 실행에서 생성함 → 요약에서 생성 안내 불필요
 //   false = 없는데 사용자가 거절/생성 실패 → 안내 유지
 //   null  = 확인 자체를 못 함(비레포·질문 불가) → 안내 유지(보수적)
+// 반환 state (#715 — 비대화형 결과 기록용): not-checked · not-a-repo · exists-local · exists-remote ·
+//   declined · create-failed · push-declined · pushed · push-failed
 export async function ensureDeployBranch({ targetRoot = ".", deployBranch = "", defaultBranch = "", io = {}, say = () => {} }) {
-  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false, ready: null };
+  if (!deployBranch || typeof io.confirm !== "function") return { created: false, pushed: false, ready: null, state: "not-checked" };
   const st = branchStatus(targetRoot, deployBranch);
-  if (!st.isRepo) return { created: false, pushed: false, ready: null };
-  if (st.local) return { created: false, pushed: false, ready: true };
+  if (!st.isRepo) return { created: false, pushed: false, ready: null, state: "not-a-repo" };
+  if (st.local) return { created: false, pushed: false, ready: true, state: "exists-local" };
   if (st.remote === true) {
     say(msg("options.branch.remoteOnly", { branch: deployBranch }));
-    return { created: false, pushed: false, ready: true };
+    return { created: false, pushed: false, ready: true, state: "exists-remote" };
   }
   say(msg("options.branch.missing", { branch: deployBranch, base: defaultBranch || msg("options.branch.baseFallback") }));
   const mk = await io.confirm({ message: msg("options.branch.createPrompt", { base: defaultBranch || msg("options.branch.currentFallback"), branch: deployBranch }), initialValue: true });
   if (mk !== true) {
     say(msg("options.branch.skipped", { branch: deployBranch }));
-    return { created: false, pushed: false, ready: false };
+    return { created: false, pushed: false, ready: false, state: "declined" };
   }
   if (!createBranch(targetRoot, deployBranch, defaultBranch)) {
     say(msg("options.branch.createFailed", { branch: deployBranch, from: defaultBranch ? ` ${defaultBranch}` : "" }));
-    return { created: false, pushed: false, ready: false };
+    return { created: false, pushed: false, ready: false, state: "create-failed" };
   }
   say(msg("options.branch.created", { branch: deployBranch }));
   // #481 — push 질문에 브랜치명 명시 ("어느 브랜치를 push하는지" 불명확 방지)
   const up = await io.confirm({ message: msg("options.branch.pushPrompt", { branch: deployBranch }), initialValue: true });
-  if (up !== true) return { created: true, pushed: false, ready: true };
+  if (up !== true) return { created: true, pushed: false, ready: true, state: "push-declined" };
   if (pushBranch(targetRoot, deployBranch)) {
     say(msg("options.branch.pushed", { branch: deployBranch }));
-    return { created: true, pushed: true, ready: true };
+    return { created: true, pushed: true, ready: true, state: "pushed" };
   }
   say(msg("options.branch.pushFailed", { branch: deployBranch }));
-  return { created: true, pushed: false, ready: true };
+  return { created: true, pushed: false, ready: true, state: "push-failed" };
 }
 
 // 재노출 — 파서 본체는 version-yml.js에 있다 (순환 import 방지: options-ask → version-yml 방향만 허용)

package/src/core/options-schema.js

@@ -48,6 +48,8 @@ export const FLAGS = [
     description: "Registries a library is published to. Several allowed.", versionYml: "metadata.template.options.publish" },
   { flag: "--deploy-branch", value: "NAME", default: "develop",
     description: "Development branch: the head of the release PR. Not the repository default branch.", versionYml: "metadata.development_branch" },
+  { flag: "--create-development-branch", default: "off",
+    description: "Non-interactive runs: create the development branch from the default branch and push it to origin when it does not exist." },
   { flag: "--language", value: "LANG", values: [...REPO_LANGUAGES], default: "en for new installs, ko for existing installs",
     description: "Language of issue/PR templates and bot messages written into the repo.", versionYml: "metadata.template.options.language" },
   { flag: "--label-style", value: "STYLE", values: [...LABEL_STYLES], default: "en for new installs, ko for existing installs",
@@ -183,11 +185,18 @@ export const FLAG_DETAILS = {
   },
   "--deploy-branch": {
     when: "Only if your development branch is not named develop.",
-    effect: "Writes metadata.development_branch (and the old deploy_branch with the same value) and rewrites the branch name inside the installed workflows (release PR head, CI triggers, PR summary base). The branch is NOT created by this flag.",
+    effect: "Writes metadata.development_branch (and the old deploy_branch with the same value) and rewrites the branch name inside the installed workflows (release PR head, CI triggers, PR summary base). The branch is NOT created by this flag (use --create-development-branch).",
     omitted: "develop.",
     example: "npx projectops --mode full --force --deploy-branch dev",
     caution: "Despite the name this is the development branch (head of the release PR), not the branch that deploys. The deploying branch is the repository default branch.",
   },
+  "--create-development-branch": {
+    when: "Agents and CI integrating a repo that has no development branch yet. Interactive runs ask instead.",
+    effect: "After the install, checks the development branch (--deploy-branch, default develop). Exists locally or on origin: nothing is done. Missing: creates it from the repository default branch (no checkout) and pushes it with git push -u origin <branch>. The result (created, skipped or failed) is printed in the completion summary and recorded in .github/.projectops/logs/ and the migration guide checklist.",
+    omitted: "The branch is never created or pushed; the completion summary lists it as a manual step with the command to run.",
+    example: "npx projectops --mode full --force --create-development-branch",
+    caution: "It pushes to the remote. A failed push (credentials, network, no origin) does not fail the run: the exit code stays 0 and the summary prints the command to run yourself.",
+  },
   "--language": {
     when: "Set it only to change the language of an existing repo or to start a new repo in Korean.",
     effect: "Chooses the language of the issue/PR templates and bot comments written into the repo, and of the comments inside version.yml.",
@@ -294,6 +303,7 @@ export const RECIPES = [
   { goal: "Never install a template workflow again", command: "Add its file name to metadata.template.options.excluded_workflows in version.yml", note: "Delete the installed file too; the update will not bring it back." },
   { goal: "Stop retired workflows from running next to their replacements", command: "npx projectops --mode workflows --force --remove-legacy", note: "Run only after the new workflow is working." },
   { goal: "Keep every release a patch bump", command: "Set metadata.template.options.semver_auto: false in version.yml" },
+  { goal: "Install everything and create the development branch (develop) in one run", command: "npx projectops --mode full --force --create-development-branch", note: "Pushes the new branch to origin. Does nothing if it already exists." },
   { goal: "Install a library publish workflow", command: "npx projectops --mode workflows --force --type node --publish npm", note: "Needs the NPM_TOKEN secret." },
 ];
 

package/src/core/placeholder-triggers.js

@@ -0,0 +1,80 @@
+// 자동 트리거 + 예시 값이 함께 남은 워크플로우 감지 (#662)
+// 예시 값(your-project 등)은 미치환 토큰(__X__) 검사에 걸리지 않아, 푸시·라벨마다 실패 런이 쌓여도 doctor 가 통과시켰다.
+// ⚠️ YAML 파서 없이 라인 단위로 본다 (의존성 0 — 설치 CLI 는 dependencies 가 비어 있다).
+import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+
+// 사람이 직접 눌러야 도는 트리거 3개 — 나머지는 전부 자동 트리거로 본다
+const MANUAL_EVENTS = new Set(["workflow_dispatch", "workflow_call", "repository_dispatch"]);
+
+// 예시 값 판정: your-/your_ 접두 단어, example.com 류 도메인, 미치환 토큰 (heredoc 구분자 __SUH_*__ 제외)
+const PLACEHOLDER_VALUE_RES = [
+  /(^|[^a-z0-9])your[-_][a-z0-9]/i,
+  /(^|[.@/])example\.(com|org|net)\b/i,
+  /__(?!SUH_)[A-Z][A-Z0-9_]*__/,
+];
+
+// 환경변수형 줄만 본다: `  KEY: "값"` (run 스크립트 안 URL·문구 오탐 방지)
+const ENV_LINE_RE = /^\s*([A-Z][A-Z0-9_]*):\s*(?:"([^"]*)"|'([^']*)'|([^\s#][^#]*?))\s*(?:#.*)?$/;
+
+const isCommented = (line) => /^\s*#/.test(line);
+
+/**
+ * on: 블록 > 이벤트 이름 목록 (인라인 `on: push`, `on: [a, b]`, 블록 형식 3가지)
+ */
+export function parseTriggerEvents(text) {
+  const lines = String(text || "").split(/\r?\n/);
+  const start = lines.findIndex((l) => /^(on|"on"|'on'):/.test(l));
+  if (start < 0) return [];
+  const inline = lines[start].replace(/^[^:]*:\s*/, "").replace(/#.*$/, "").trim();
+  if (inline) return inline.replace(/^\[|\]$/g, "").split(",").map((s) => s.trim()).filter(Boolean);
+
+  // 블록: 첫 하위 줄의 들여쓰기 깊이에 있는 키만 이벤트로 센다
+  const events = [];
+  let depth = null;
+  for (const line of lines.slice(start + 1)) {
+    if (!line.trim() || isCommented(line)) continue;
+    const indent = line.match(/^\s*/)[0].length;
+    if (indent === 0) break;
+    if (depth === null) depth = indent;
+    if (indent !== depth) continue;
+    const key = line.trim().match(/^([A-Za-z_]+):/);
+    if (key) events.push(key[1]);
+  }
+  return events;
+}
+
+/**
+ * 워크플로우 본문 > 예시 값이 남은 환경변수 줄 [{ key, value, line }]
+ */
+export function findPlaceholderValues(text) {
+  const found = [];
+  String(text || "").split(/\r?\n/).forEach((line, index) => {
+    if (isCommented(line)) return;
+    const match = line.match(ENV_LINE_RE);
+    if (!match) return;
+    const value = match[2] ?? match[3] ?? match[4] ?? "";
+    if (PLACEHOLDER_VALUE_RES.some((re) => re.test(value))) {
+      found.push({ key: match[1], value, line: index + 1 });
+    }
+  });
+  return found;
+}
+
+/**
+ * 설치된 워크플로우 폴더 > 자동 트리거와 예시 값을 함께 가진 파일 [{ file, triggers, values }]
+ */
+export function scanPlaceholderTriggers(workflowsDir) {
+  if (!existsSync(workflowsDir)) return [];
+  const files = readdirSync(workflowsDir).filter((f) => /\.ya?ml$/.test(f)).sort();
+  const result = [];
+  for (const file of files) {
+    let text;
+    try { text = readFileSync(join(workflowsDir, file), "utf8"); } catch { continue; }
+    const triggers = parseTriggerEvents(text).filter((e) => !MANUAL_EVENTS.has(e));
+    if (!triggers.length) continue;
+    const values = findPlaceholderValues(text);
+    if (values.length) result.push({ file, triggers, values });
+  }
+  return result;
+}

package/src/i18n/doctor.en.js

@@ -20,6 +20,10 @@ export default {
   "doctor.unres.intro": "Template values are still present at the locations below.",
   "doctor.unres.more": "  ... and {n} more",
   "doctor.unres.outro": "If left as is, those workflows fail at the deploy step. Fill in the values yourself.",
+  "doctor.ph.name": "Example values with automatic triggers",
+  "doctor.ph.purpose": "Workflows that fail on every trigger until configured",
+  "doctor.ph.l1": "These workflows run automatically (push, labels and so on) but still hold example values, so each trigger can create a failed run.",
+  "doctor.ph.fix": "Fix: fill in the real values, or delete the workflows you do not use.",
   "doctor.sec.name": "Required secrets",
   "doctor.sec.purpose": "Values the installed workflows require",
   "doctor.sec.line": "  {name}  <- {n} workflow(s)",

package/src/i18n/doctor.ko.js

@@ -20,6 +20,10 @@ export default {
   "doctor.unres.intro": "아래 위치에 템플릿 값이 그대로 남아 있습니다.",
   "doctor.unres.more": "  … 외 {n}건",
   "doctor.unres.outro": "그대로 두면 해당 워크플로우가 배포 단계에서 실패합니다. 직접 값을 채워주세요.",
+  "doctor.ph.name": "자동 실행되는 예시 값",
+  "doctor.ph.purpose": "설정 전까지 실행될 때마다 실패하는 워크플로우",
+  "doctor.ph.l1": "아래 워크플로우는 자동으로 실행되는데(push, 라벨 등) 예시 값이 그대로 남아 있어, 실행될 때마다 실패 런이 생길 수 있습니다.",
+  "doctor.ph.fix": "조치: 실제 값을 채우거나, 쓰지 않는 워크플로우는 삭제하세요.",
   "doctor.sec.name": "필요한 Secret",
   "doctor.sec.purpose": "설치된 워크플로우가 요구하는 값",
   "doctor.sec.line": "  {name}  ← {n}개 워크플로우",

package/src/i18n/en.js

@@ -31,7 +31,7 @@ export default {
   "mode.version": "Versioning only (automation system)",
   "mode.workflows": "Workflows only (GitHub Actions build and deploy)",
   "mode.issues": "Issue/PR templates only",
-  "mode.skills": "AI skills only (Claude, Cursor, Gemini, Codex, PI)",
+  "mode.skills": "AI skills only (Claude, Cursor, Gemini, Codex, Copilot, PI)",
 
   // confirm and edit menus
   "confirm.prompt": "Continue with these settings?",
@@ -113,7 +113,7 @@ export default {
   "flow.askBranch": "Default branch",
   "flow.badVersion": "Invalid version format (use x.y.z). Keeping the current value.",
   "flow.badVersionTitle": "Version",
-  "flow.askSkills": "Also install or update AI agent skills (Claude, Cursor, Gemini, Codex, PI)?",
+  "flow.askSkills": "Also install or update AI agent skills (Claude, Cursor, Gemini, Codex, Copilot, PI)?",
   "flow.done": "Done. Installed in {mode} mode.",
   "flow.updateScope": "Update ({scope} scope)",
   "flow.conflictsTitle": "{count} workflows changed in the new template",

package/src/i18n/ide.en.js

@@ -30,14 +30,27 @@ export default {
   "ide.codex.legacy": "  Removed legacy Codex skills: {name}",
   "ide.cursor.noSource": "  Could not find the skills source (a skills/ folder is required).",
   "ide.cursor.copying": "Copying Cursor Skills...",
-  "ide.cursor.obsolete": "  Removed obsolete skill: {name}",
   "ide.cursor.installed": "  Cursor Skills installed ({dest}/, v{version})",
   "ide.cursor.copyFailed": "  Cursor Skills copy failed. Check the skills/ folder.",
   "ide.cursor.removeNone": "  No Cursor Skills are installed, skipping",
   "ide.cursor.removed": "  Cursor Skills removed (projectops-owned only, {dir}/)",
   "ide.cursor.removeFailed": "  Cursor Skills removal failed. Check manually: {dir}",
   "ide.cursor.legacy": "  Cleaned up legacy Cursor Skills (selective): name={name}, v={version}, reinstalling",
-  "ide.cursor.manual": "  Tip for Cursor: copy the skills/ folder to ~/.cursor/skills/.",
+  "ide.cursor.manual": "  Tip for Cursor: copy skills/ to ~/.cursor/skills/ and scripts/ to ~/.cursor/scripts/ (the skill CLIs import scripts/common).",
+  "ide.skillsCopy.obsolete": "  Removed obsolete skill: {name}",
+  "ide.skillsCopy.noScripts": "  Shared Python scripts (scripts/common) not found: the skills' Python CLIs will not run until reinstalled from the full template.",
+  "ide.skillsCopy.entrypoint": "  Stable entry point installed: {path}",
+  "ide.skillsCopy.entrypointFailed": "  Could not install the stable entry point under ~/.projectops/bin (the first CLI run retries).",
+  "ide.copilot.detected": "Installable (Copilot detected)",
+  "ide.copilot.notDetected": "Copilot not detected (no copilot CLI, ~/.copilot, VS Code Copilot extension or JetBrains Copilot plugin)",
+  "ide.copilot.noSource": "  Could not find the skills source (a skills/ folder is required).",
+  "ide.copilot.copying": "Copying GitHub Copilot Skills...",
+  "ide.copilot.installed": "  GitHub Copilot Skills installed ({dest}/, v{version}). Call them with /pro- in Copilot chat (VS Code, JetBrains) or the Copilot CLI",
+  "ide.copilot.copyFailed": "  GitHub Copilot Skills copy failed. Check the skills/ folder.",
+  "ide.copilot.removeNone": "  No GitHub Copilot Skills are installed, skipping",
+  "ide.copilot.removed": "  GitHub Copilot Skills removed (projectops-owned only, {dir}/)",
+  "ide.copilot.removeFailed": "  GitHub Copilot Skills removal failed. Check manually: {dir}",
+  "ide.copilot.manual": "  Tip for GitHub Copilot: copy skills/ to ~/.copilot/skills/ and scripts/ to ~/.copilot/scripts/ (the skill CLIs import scripts/common).",
   "ide.gemini.updating": "Updating the Gemini CLI extension...",
   "ide.gemini.updated": "  Gemini CLI extension updated",
   "ide.gemini.installing": "Installing the Gemini CLI extension...",

package/src/i18n/ide.ko.js

@@ -30,14 +30,27 @@ export default {
   "ide.codex.legacy": "  레거시 Codex skills 정리: {name}",
   "ide.cursor.noSource": "  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요).",
   "ide.cursor.copying": "Cursor Skills 복사 중...",
-  "ide.cursor.obsolete": "  폐기된 스킬 제거: {name}",
   "ide.cursor.installed": "  Cursor Skills 설치 완료 ({dest}/, v{version})",
   "ide.cursor.copyFailed": "  Cursor Skills 복사 실패 — skills/ 폴더를 확인하세요.",
   "ide.cursor.removeNone": "  설치된 Cursor Skills가 없어 건너뜁니다",
   "ide.cursor.removed": "  Cursor Skills 제거 완료 (projectops 소유만, {dir}/)",
   "ide.cursor.removeFailed": "  Cursor Skills 제거 실패 — 수동 확인: {dir}",
   "ide.cursor.legacy": "  레거시 Cursor Skills 정리(선별): name={name}, v={version} → 재설치",
-  "ide.cursor.manual": "  💡 Cursor: skills/ 폴더를 ~/.cursor/skills/ 로 복사하면 됩니다.",
+  "ide.cursor.manual": "  💡 Cursor: skills/ 를 ~/.cursor/skills/ 로, scripts/ 를 ~/.cursor/scripts/ 로 복사하면 됩니다 (스킬 CLI 가 scripts/common 을 import).",
+  "ide.skillsCopy.obsolete": "  폐기된 스킬 제거: {name}",
+  "ide.skillsCopy.noScripts": "  공용 파이썬(scripts/common)을 찾지 못했습니다 — 전체 템플릿으로 다시 설치하기 전까지 스킬의 파이썬 CLI 는 실행되지 않습니다.",
+  "ide.skillsCopy.entrypoint": "  고정 진입점 설치: {path}",
+  "ide.skillsCopy.entrypointFailed": "  ~/.projectops/bin 고정 진입점 설치 실패 (CLI 첫 실행 때 다시 시도)",
+  "ide.copilot.detected": "설치 가능 (Copilot 감지됨)",
+  "ide.copilot.notDetected": "Copilot 미감지 (copilot CLI · ~/.copilot · VS Code Copilot 확장 · JetBrains Copilot 플러그인 없음)",
+  "ide.copilot.noSource": "  설치할 스킬 소스를 찾지 못했습니다 (skills/ 폴더 필요).",
+  "ide.copilot.copying": "GitHub Copilot Skills 복사 중...",
+  "ide.copilot.installed": "  GitHub Copilot Skills 설치 완료 ({dest}/, v{version}) — Copilot 채팅(VS Code·JetBrains)·Copilot CLI 에서 /pro- 로 호출",
+  "ide.copilot.copyFailed": "  GitHub Copilot Skills 복사 실패 — skills/ 폴더를 확인하세요.",
+  "ide.copilot.removeNone": "  설치된 GitHub Copilot Skills가 없어 건너뜁니다",
+  "ide.copilot.removed": "  GitHub Copilot Skills 제거 완료 (projectops 소유만, {dir}/)",
+  "ide.copilot.removeFailed": "  GitHub Copilot Skills 제거 실패 — 수동 확인: {dir}",
+  "ide.copilot.manual": "  💡 GitHub Copilot: skills/ 를 ~/.copilot/skills/ 로, scripts/ 를 ~/.copilot/scripts/ 로 복사하면 됩니다 (스킬 CLI 가 scripts/common 을 import).",
   "ide.gemini.updating": "Gemini CLI extension 업데이트 중...",
   "ide.gemini.updated": "  Gemini CLI extension 업데이트 완료",
   "ide.gemini.installing": "Gemini CLI extension 설치 중...",

package/src/i18n/ko.js

@@ -29,7 +29,7 @@ export default {
   "mode.version": "버전 관리 전용 (자동화 시스템)",
   "mode.workflows": "워크플로우 전용 (GitHub Actions 빌드, 배포)",
   "mode.issues": "이슈/PR 템플릿 전용",
-  "mode.skills": "AI 스킬 전용 (Claude, Cursor, Gemini, Codex, PI)",
+  "mode.skills": "AI 스킬 전용 (Claude, Cursor, Gemini, Codex, Copilot, PI)",
 
   "confirm.prompt": "이 정보로 진행할까요?",
   "confirm.continue": "예, 계속 진행",
@@ -106,7 +106,7 @@ export default {
   "flow.askBranch": "기본 브랜치",
   "flow.badVersion": "버전 형식이 올바르지 않습니다 (x.y.z 형태). 기존 값을 유지합니다.",
   "flow.badVersionTitle": "버전",
-  "flow.askSkills": "AI 에이전트 스킬(Claude, Cursor, Gemini, Codex, PI)도 설치/업데이트할까요?",
+  "flow.askSkills": "AI 에이전트 스킬(Claude, Cursor, Gemini, Codex, Copilot, PI)도 설치/업데이트할까요?",
   "flow.done": "통합 완료. {mode} 모드로 설치했습니다.",
   "flow.updateScope": "업데이트 ({scope} 범위)",
   "flow.conflictsTitle": "템플릿이 갱신된 워크플로우 {count}개",

package/src/i18n/summary.en.js

@@ -10,7 +10,7 @@ export default {
   "done.feat.coderabbit": "CodeRabbit AI review settings",
   "done.feat.gitignore": "Required .gitignore entries",
   "done.feat.guide": "Setup guide (PROJECTOPS-SETUP-GUIDE.md)",
-  "done.feat.skills": "Agent skills (Claude, Cursor, Gemini, Codex, PI)",
+  "done.feat.skills": "Agent skills (Claude, Cursor, Gemini, Codex, Copilot, PI)",
   "done.addedFiles": "Added files:",
   "done.versionYml": "version.yml (version: {version}, types: {types})",
   "done.readmeAdded": "README.md (version section added)",
@@ -56,6 +56,10 @@ export default {
   "done.todo.pat2": "and allows automerge even with branch protection rules.",
   "done.todo.branchReady": "Branch {branch} is ready: the wizard checked and created it (nothing to do)",
   "done.todo.branch": "Create the {branch} branch (if it does not exist yet)",
+  "done.todo.branchCreated": "Branch {branch} was created from {base} and pushed to origin (--create-development-branch)",
+  "done.todo.branchExists": "Branch {branch} already exists: nothing was changed (--create-development-branch)",
+  "done.todo.branchFailed": "Branch {branch} could not be created or pushed ({reason}). The install itself completed. Run it yourself:",
+  "done.todo.branchFlagHint": "Non-interactive runs can create and push it for you: add --create-development-branch",
   "done.todo.ai": "(Optional) Get AI-polished release notes",
   "done.todo.ai1": "Release notes already work: they are built by analyzing commits, no setup needed.",
   "done.todo.ai2": "Do the steps below only if you want smoother wording.",

package/src/i18n/summary.ko.js

@@ -10,7 +10,7 @@ export default {
   "done.feat.coderabbit": "CodeRabbit AI 리뷰 설정",
   "done.feat.gitignore": ".gitignore 필수 항목",
   "done.feat.guide": "템플릿 설정 가이드 (PROJECTOPS-SETUP-GUIDE.md)",
-  "done.feat.skills": "Agent Skill 설치 (Claude, Cursor, Gemini, Codex, PI)",
+  "done.feat.skills": "Agent Skill 설치 (Claude, Cursor, Gemini, Codex, Copilot, PI)",
   "done.addedFiles": "추가된 파일:",
   "done.versionYml": "version.yml (버전: {version}, 타입: {types})",
   "done.readmeAdded": "README.md (버전 섹션 추가)",
@@ -56,6 +56,10 @@ export default {
   "done.todo.pat2": "더 확실하게 이어지고, 브랜치 보호 규칙이 있어도 자동 머지가 가능합니다.",
   "done.todo.branchReady": "{branch} 브랜치 준비 완료: 마법사가 확인 및 생성했습니다 (추가 작업 불필요)",
   "done.todo.branch": "{branch} 브랜치 생성 (아직 없다면)",
+  "done.todo.branchCreated": "{branch} 브랜치를 {base}에서 만들고 origin에 push했습니다 (--create-development-branch)",
+  "done.todo.branchExists": "{branch} 브랜치가 이미 있어 아무것도 바꾸지 않았습니다 (--create-development-branch)",
+  "done.todo.branchFailed": "{branch} 브랜치를 만들거나 push하지 못했습니다 ({reason}). 통합은 완료됐습니다. 직접 실행하세요:",
+  "done.todo.branchFlagHint": "비대화형 실행에서 --create-development-branch 를 주면 자동으로 만들고 push합니다",
   "done.todo.ai": "(선택) AI가 다듬은 릴리스 노트 받기",
   "done.todo.ai1": "지금 상태로도 릴리스 노트는 나옵니다. 커밋 내용을 분석해 만들기 때문에 아무 설정을 하지 않아도 됩니다.",
   "done.todo.ai2": "아래는 문장을 더 매끄럽게 하고 싶을 때만 하세요.",

package/src/index.js

@@ -20,6 +20,7 @@ import { createRunTrace, MIGRATION_DIR } from "./core/run-trace.js";
 import { appendGuideEntry } from "./core/migration-guide.js";
 import { resolveProjectPaths, markerForType } from "./core/paths-resolve.js";
 import { resolveOptions } from "./core/resolve-options.js";
+import { runDevelopmentBranchStep } from "./core/development-branch.js";
 import { printBannerCompact } from "./ui/banner.js";
 import { printSummary } from "./ui/summary.js";
 import { runFull } from "./commands/full.js";
@@ -304,6 +305,14 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
         // 알 수 없는 모드 → 복사 0건, 에러 아님
         break;
     }
+    // 개발 브랜치 생성 (#715) — --create-development-branch 일 때만. 실패해도 실행은 계속(수동 명령 안내)
+    const developmentBranchResult = await runDevelopmentBranchStep({
+      isRequested: opts.createDevelopmentBranch === true, targetRoot: cwd,
+      branch: context.deployBranch || "develop", defaultBranch: branch, trace,
+      say: (line) => console.error(line),
+    });
+    const isDevelopmentBranchReady = developmentBranchResult ? developmentBranchResult.status !== "failed" : null;
+
     // 마이그레이션 기록 (#493/#494) — Layer 2/3 트레이스 파일 + Layer 1 가이드 엔트리
     let migrationGuidePath = null;
     // 기록 파일 경로는 먼저 계산하고(가이드가 참조), 실제 쓰기는 완료 화면 출력 뒤로 미룬다 —
@@ -316,7 +325,8 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
         now, mode: opts.mode, types, repoName,
         templateFrom: existing?.templateVersion || "", templateTo: context.templateVersion,
         options: { deploy: deployTarget, publish: publishTargets, secretBackup: context.includeSecretBackup, coderabbit: context.codeReviewCoderabbit, changelogProvider: context.changelogProvider, intent, semverAuto: context.semverAuto , appRelease: context.appRelease, language: context.language, labelStyle: context.labelStyle, closeOnRelease: context.closeOnRelease, projectsSync: context.projectsSync, excludedWorkflows: context.excludedWorkflows, storeLocales: context.storeLocales, storeLocalesIos: context.storeLocalesIos, storeLocalesPlay: context.storeLocalesPlay },
-        branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: null, created: null },
+        branches: { defaultBranch: branch, deployBranch: context.deployBranch || "develop", ready: isDevelopmentBranchReady,
+          created: developmentBranchResult ? developmentBranchResult.status === "created" : null, result: developmentBranchResult },
         breaking: breakingReport, migrations: migrationsResult, orphans: { cleaned: [], pending: orphanPending },
         events: trace.events, counters: { skipped: result?.workflows?.skipped ?? 0 },
         traceFile: files?.traceFile ?? "", logFile: files?.logFile ?? "",
@@ -326,6 +336,8 @@ async function runCore(argv, { cwd = process.cwd(), source = { type: "git" }, cl
     // 완료 요약 (CLI 모드에서도 출력)
     printSummary({
       mode: opts.mode, types, version, deployBranch: context.deployBranch, migrationGuidePath,
+      developmentBranchResult,                                        // #715 생성 결과 (플래그 없으면 null)
+      shouldSuggestCreateBranchFlag: !developmentBranchResult,        // #715 플래그 없이 돌았으면 다음엔 쓰라고 안내
       counters: { workflows: result?.workflows?.copied ?? 0, workflowFiles: result?.workflows?.copiedFiles ?? [], utilModules: 0 },
       skippedConflicts: result?.workflows?.skippedConflicts ?? [],   // #654 병합 안내
       replacedBak: result?.workflows?.replacedBak ?? [],             // #673 기준점 없이 교체한 파일 안내

package/src/ui/summary.js

@@ -184,6 +184,7 @@ export function printSummary(ctx, targetRoot = ".", write = null) {
     err("     • iOS TestFlight: .github/util/flutter/testflight-wizard/testflight-wizard.html");
     err("     • Android Play Store: .github/util/flutter/playstore-wizard/playstore-wizard.html");
     err("     • Firebase App Distribution: .github/util/flutter/firebase-wizard/firebase-wizard.html");
+    err("     • Kakao / Google login (OAuth): .github/util/flutter/oauth-wizard/oauth-wizard.html");
     err(`     • ${t("done.flutter.open")}`);
     err("");
   }
@@ -241,11 +242,20 @@ export function printSummary(ctx, targetRoot = ".", write = null) {
   err("     → Secret Name: _GITHUB_PAT_TOKEN / Scopes: repo, workflow");
   err("");
   // Do not re-instruct a task the wizard already did.
-  if (deployBranchReady) {
+  const branchResult = ctx?.developmentBranchResult ?? null; // #715 --create-development-branch outcome
+  if (branchResult?.status === "created") {
+    err(`  2️⃣  ✅ ${t("done.todo.branchCreated", { branch: deployBranchName, base: branchResult.base || "HEAD" })}`);
+  } else if (branchResult?.status === "skipped") {
+    err(`  2️⃣  ✅ ${t("done.todo.branchExists", { branch: deployBranchName })}`);
+  } else if (branchResult?.status === "failed") {
+    err(`  2️⃣  ${t("done.todo.branchFailed", { branch: deployBranchName, reason: branchResult.reason })}`);
+    err(`     → ${branchResult.manualCommand}`);
+  } else if (deployBranchReady) {
     err(`  2️⃣  ✅ ${t("done.todo.branchReady", { branch: deployBranchName })}`);
   } else {
     err(`  2️⃣  ${t("done.todo.branch", { branch: deployBranchName })}`);
     err(`     → git checkout -b ${deployBranchName} && git push -u origin ${deployBranchName}`);
+    if (ctx?.shouldSuggestCreateBranchFlag === true) err(`     💡 ${t("done.todo.branchFlagHint")}`);
   }
   err("");
   // Only explain what the user selected: instructions for a disabled feature blur what to do.