projectops 4.71.3 → 4.73.0

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 기준점 없이 교체한 파일 안내