lee-spec-kit 0.6.33 → 0.6.35

package/dist/index.js

@@ -8,7 +8,7 @@ import chalk8 from 'chalk';
 import { spawn, spawnSync, execFileSync, execSync } from 'child_process';
 import os from 'os';
 import { createHash, randomUUID } from 'crypto';
-import fs8 from 'fs';
+import fs9 from 'fs';
 import { Buffer as Buffer$1 } from 'buffer';
 
 var getFilename = () => fileURLToPath(import.meta.url);
@@ -512,6 +512,10 @@ var koContext = {
   "context.actionDetail.codeReviewRemoteBlocked": "\uC6D0\uACA9 PR \uCC28\uB2E8 \uC0AC\uC720\uB97C \uD574\uC18C\uD55C \uB4A4 \uBA38\uC9C0\uB97C \uC9C4\uD589\uD558\uC138\uC694",
   "context.actionDetail.codeReviewMergeAfterOk": "\uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 PR\uC744 \uBA38\uC9C0\uD558\uC138\uC694",
   "context.actionDetail.codeReviewRequestReview": "\uB9AC\uBDF0 \uC694\uCCAD\uC744 \uC9C4\uD589\uD558\uACE0 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC720\uC9C0\uD558\uC138\uC694",
+  "context.actionDetail.featureScopeSplit": "\uC774 Feature\uB97C \uB354 \uC791\uC740 \uC774\uC288 \uB2E8\uC704\uB85C \uBD84\uB9AC\uD560\uC9C0 \uAC80\uD1A0\uD558\uC138\uC694",
+  "context.actionDetail.featureScopeSplitKeep": "\uBD84\uD560 \uAC00\uC774\uB4DC\uB97C \uD655\uC778\uD55C \uB4A4 \uD604\uC7AC \uC774\uC288 \uBC94\uC704\uB97C \uC720\uC9C0\uD558\uACE0 \uC9C4\uD589\uD558\uC138\uC694",
+  "context.actionDetail.featureScopeSplitTwo": "\uACB0\uD569\uB3C4/\uD30C\uC77C\uACB9\uCE68/\uD14C\uC2A4\uD2B8/\uBC30\uD3EC \uAE30\uC900\uC73C\uB85C 2\uAC1C \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uC138\uC694",
+  "context.actionDetail.featureScopeSplitFour": "\uAE30\uC900 \uAE30\uBC18\uC73C\uB85C 4\uAC1C \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uACE0 \uC758\uC874 \uC21C\uC11C\uB300\uB85C PR\uC744 \uBA38\uC9C0\uD558\uC138\uC694",
   "context.actionDetail.worktreeCleanup": "\uC644\uB8CC\uB41C feature worktree\uB97C \uC815\uB9AC\uD558\uC138\uC694",
   "context.actionDetail.prMetadataMigrate": "tasks.md\uC758 PR \uD56D\uBAA9 \uD615\uC2DD\uC744 \uCD5C\uC2E0 \uD15C\uD50C\uB9BF\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694",
   "context.actionDetail.prMetadataMigratePrFields": "tasks.md\uC5D0 PR/PR \uC0C1\uD0DC \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694",
@@ -595,6 +599,8 @@ var koMessages = {
   reviewFixCommitGuidance: "PR \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uB9AC\uBDF0 \uBC18\uC601 \uD30C\uC77C\uB9CC \uC2A4\uD14C\uC774\uC9D5\uD55C \uB4A4 `fix(review): <review-fix-summary>` \uD615\uC2DD\uC73C\uB85C \uCEE4\uBC0B\uD558\uC138\uC694. `<review-fix-summary>`\uC5D0\uB294 \uC774\uBC88 \uCEE4\uBC0B\uC5D0\uC11C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9 \uC694\uC57D\uC744 \uC791\uC131\uD558\uC138\uC694. (\uD0DC\uC2A4\uD06C \uC81C\uBAA9 \uC7AC\uC0AC\uC6A9 \uAE08\uC9C0)",
   standaloneNeedsProjectRoot: "standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot \uC124\uC815\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)",
   createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && WT="{projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}" && for f in .env .env.local .env.development .env.development.local .env.test .env.test.local .env.production .env.production.local; do [ -f "{projectGitCwd}/$f" ] && [ ! -e "$WT/$f" ] && cp "{projectGitCwd}/$f" "$WT/$f" || true; done && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
+  moveToExistingWorktree: '\uD574\uB2F9 feature\uC6A9 worktree\uAC00 \uC774\uBBF8 \uC788\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 `cd "{worktreePath}"`\uB85C \uC774\uB3D9\uD55C \uB4A4 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.',
+  worktreeRequiredFromMainBranch: "`workflow.requireWorktree`\uAC00 \uD65C\uC131\uD654\uB418\uC5B4 \uC788\uC9C0\uB9CC \uD604\uC7AC feature \uBE0C\uB79C\uCE58\uAC00 \uBA54\uC778 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0 \uCCB4\uD06C\uC544\uC6C3\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uBA54\uC778 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uB97C \uAE30\uBCF8 \uBE0C\uB79C\uCE58\uB85C \uB418\uB3CC\uB9B0 \uB4A4 `.worktrees/feat-{issueNumber}-{slug}`\uB97C \uC0DD\uC131/\uC7AC\uC0AC\uC6A9\uD558\uACE0 \uADF8 worktree\uC5D0\uC11C \uACC4\uC18D \uC9C4\uD589\uD558\uC138\uC694.",
   worktreeCleanupCommand: 'cd "{projectGitCwd}" && WT="{worktreePath}" && ROOT="$(pwd)" && case "$WT" in "$ROOT"/.worktrees/*) if git worktree list --porcelain | grep -Fxq "worktree $WT"; then git worktree remove --force "$WT" || true; fi; [ -d "$WT" ] && rm -rf "$WT" || true ;; *) echo "skip unsafe worktree path: $WT" ;; esac && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
   tasksAllDoneButNoChecklist: '\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uB97C \uC791\uC131\uD558\uC138\uC694. tasks.md\uC758 "\uC644\uB8CC \uC870\uAC74" \uC139\uC158\uC5D0 \uAC80\uC99D \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0, \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uC138\uC694. \uBA85\uC2DC\uC801\uC778 \uCD5C\uC885 \uC2B9\uC778\uB3C4 \uBC18\uC601\uD558\uC138\uC694.',
   tasksAllDoneButChecklist: "\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uC758 \uB0A8\uC740 \uD56D\uBAA9\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uD604\uC7AC \uC9C4\uD589: ({checked}/{total}) \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uACE0 \uBA85\uC2DC\uC801\uC778 \uCD5C\uC885 \uC2B9\uC778\uC744 \uBC18\uC601\uD558\uC138\uC694.",
@@ -609,9 +615,10 @@ var koMessages = {
   taskCommitGateReasonMismatchLastDone: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B\uC774 \uC9C1\uC804 \uC644\uB8CC \uD0DC\uC2A4\uD06C\uC640 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4",
   prLegacyAsk: "tasks.md\uC5D0 PR/PR \uC0C1\uD0DC \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uD15C\uD50C\uB9BF\uC744 \uCD5C\uC2E0 \uD3EC\uB9F7\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD560\uAE4C\uC694? (\uD655\uC778 \uD544\uC694)",
   prePrReviewFieldMissing: "tasks.md\uC5D0 `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uC804 \uB9AC\uBDF0**: Pending | Done` \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewRun: "\uCF54\uB4DC \uB9AC\uBDF0 \uC5D0\uC774\uC804\uD2B8\uB97C \uC2E4\uD589\uD574 `review-trace.json`\uC744 \uC0DD\uC131\uD55C \uB4A4, `pre-pr-review --evidence review-trace.json`\uC73C\uB85C \uB9AC\uBDF0 \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewEvidenceMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC2E4\uC81C \uD30C\uC77C \uACBD\uB85C\uC640 `Pre-PR Review Log`(\uB610\uB294 `PR \uC804 \uB9AC\uBDF0 \uB85C\uADF8`)\uC5D0 placeholder\uAC00 \uC544\uB2CC `Summary`/`Decision`/`Findings`(\uB610\uB294 \uBA85\uC2DC\uC801 `0 findings`)/`Residual Risks`/`Tests Run`\uC744 \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewRun: "\uCF54\uB4DC \uB9AC\uBDF0 \uC5D0\uC774\uC804\uD2B8\uB97C \uC2E4\uD589\uD574 \uBE44\uC5B4\uC788\uC9C0 \uC54A\uC740 `commandsExecuted`\uB97C \uD3EC\uD568\uD55C `review-trace.json`\uC744 \uC0DD\uC131\uD55C \uB4A4, `pre-pr-review --evidence review-trace.json`\uC73C\uB85C \uB9AC\uBDF0 \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewEvidenceMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uC2E4\uC81C \uD30C\uC77C \uACBD\uB85C\uC640 `Pre-PR Review Log`(\uB610\uB294 `PR \uC804 \uB9AC\uBDF0 \uB85C\uADF8`)\uC5D0 placeholder\uAC00 \uC544\uB2CC `Summary`/`Decision`/`Findings`(\uB610\uB294 \uBA85\uC2DC\uC801 `0 findings`)/`Residual Risks`/`Tests Run`/\uC2E4\uD589 \uBA85\uB839(`commandsExecuted`)\uC744 \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prePrReviewDecisionMissing: "tasks.md\uC758 `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 \uBE44\uC5B4\uC788\uAC70\uB098 \uACB0\uC815 \uD615\uC2DD\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. `\uACB0\uC815: ...`(\uB610\uB294 `decision: ...`) \uD615\uC2DD\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewDecisionReconfirm: "\uD604\uC7AC `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 `{decision}`\uC785\uB2C8\uB2E4. \uC9C0\uC801\uC0AC\uD56D\uC744 \uBC18\uC601\uD55C \uB4A4 \uC774\uC804 \uC0C1\uD0DC \uC7AC\uC0AC\uC6A9\uC744 \uB9C9\uAE30 \uC704\uD574 \uBA85\uC2DC\uC801\uC73C\uB85C Decision\uC744 \uC9C0\uC815\uD574 \uC7AC\uC2E4\uD589\uD558\uC138\uC694: `{command}` (\uD655\uC778 \uD544\uC694)",
   prReviewEvidenceFieldMissing: "tasks.md\uC5D0 `PR \uB9AC\uBDF0 Evidence` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uB9AC\uBDF0 Evidence**: -` \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0 \uB2E4\uC2DC \uC9C4\uD589\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prReviewEvidenceMissing: "tasks.md\uC758 `PR \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. `\uC694\uC57D: ...`(\uB610\uB294 `summary: ...`) \uD615\uC2DD\uC73C\uB85C \uAE30\uB85D\uD558\uAC70\uB098 `PR Review Log`(\uB610\uB294 `PR \uB9AC\uBDF0 \uB85C\uADF8`)\uC758 `Summary`/`Decision`\uC774 \uC788\uB294 \uD30C\uC77C \uACBD\uB85C\uB97C \uC9C0\uC815\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prReviewDecisionFieldMissing: "tasks.md\uC5D0 `PR \uB9AC\uBDF0 Decision` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uB9AC\uBDF0 Decision**: -` \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0 \uB2E4\uC2DC \uC9C4\uD589\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
@@ -636,6 +643,9 @@ var koMessages = {
   prReviewMerge: "\uBA38\uC9C0 \uC900\uBE44\uAC00 \uB418\uBA74 \uBA85\uC2DC\uC801\uC778 \uC2B9\uC778(\uB77C\uBCA8)\uC744 \uBC1B\uC740 \uB4A4 \uBA38\uC9C0 \uC635\uC158\uC744 \uC2E4\uD589\uD558\uC138\uC694. (\uC131\uACF5 \uC2DC PR \uC0C1\uD0DC\uAC00 Approved\uB85C \uB3D9\uAE30\uD654\uB429\uB2C8\uB2E4.)",
   prReviewMergeCommand: "npx lee-spec-kit github pr {featureRef} --merge --confirm OK",
   prRequestReview: "\uB9AC\uBDF0\uC5B4\uC5D0\uAC8C \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uACE0 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC124\uC815/\uC720\uC9C0\uD558\uC138\uC694.",
+  featureScopeSplitKeep: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}; \uBD84\uD560 \uC81C\uC548 \uAE30\uC900: {taskThreshold}/{decisionsThreshold}) \uD604\uC7AC \uAD8C\uC7A5 \uBD84\uD560\uC740 {recommendedIssues}\uAC1C \uC774\uC288\uC785\uB2C8\uB2E4. \uBA3C\uC800 `{guideCommand}`\uB97C \uD655\uC778\uD558\uACE0 \uACB0\uD569\uB3C4, \uBCC0\uACBD \uD30C\uC77C \uACB9\uCE68, \uD14C\uC2A4\uD2B8 \uACBD\uACC4, \uBC30\uD3EC \uB3C5\uB9BD\uC131 \uAE30\uC900\uC73C\uB85C \uD310\uB2E8\uD558\uC138\uC694. \uC774\uC288\uB97C \uC720\uC9C0\uD560 \uACBD\uC6B0 tasks.md \uBC94\uC704\uB97C \uCD95\uC18C\uD558\uACE0 \uC800\uC6B0\uC120 TODO\uB294 \uD65C\uC131 \uBC30\uCE58\uC5D0\uC11C \uC81C\uC678\uD558\uC138\uC694.",
+  featureScopeSplitTwo: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) \uAD8C\uC7A5 \uADDC\uCE59\uC0C1 40~79 \uD0DC\uC2A4\uD06C\uC774\uBA74\uC11C \uD558\uB4DC \uAE30\uC900 \uBBF8\uB9CC\uC774\uBA74 2\uAC1C \uC774\uC288 \uBD84\uD560\uC774 \uAE30\uBCF8\uC785\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C \uACB0\uD569\uB3C4/\uD30C\uC77C\uACB9\uCE68/\uD14C\uC2A4\uD2B8/\uBC30\uD3EC \uAE30\uC900\uC73C\uB85C \uBD84\uD560\uD558\uC138\uC694. \uAC01 \uC774\uC288\uC5D0\uB294 \uB2E4\uC74C \uD15C\uD50C\uB9BF\uC744 \uAE30\uB85D\uD558\uC138\uC694: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
+  featureScopeSplitFour: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}\uC774\uBA74 4\uAC1C \uC774\uC288 \uBD84\uD560\uC744 \uAC15\uD558\uAC8C \uAD8C\uC7A5\uD569\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C 4\uAC1C\uC758 \uC5F0\uAD00 \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uACE0 \uC758\uC874 \uC21C\uC11C\uB97C \uBA85\uC2DC\uD55C \uB4A4 PR\uC744 \uC21C\uCC28 \uBA38\uC9C0\uD558\uC138\uC694. \uAC01 \uC774\uC288 \uD15C\uD50C\uB9BF: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   userRequestReplan: "\uD604\uC7AC \uB2E8\uACC4\uC640 \uBCC4\uAC1C\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC81C\uC548\uD55C \uC0C8 \uC694\uAD6C\uB97C \uBA3C\uC800 \uBC18\uC601\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC694\uAD6C\uC0AC\uD56D\uC744 \uC694\uC57D\uD574 tasks.md\uC5D0 \uCD94\uAC00\uD558\uAC70\uB098 \uBCC4\uB3C4 Feature\uB85C \uBD84\uB9AC\uD55C \uB4A4, \uBB38\uC11C \uC0C1\uD0DC\uB97C \uB9DE\uCD94\uACE0 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   featureDone: "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC694\uAD6C\uC0AC\uD56D\uACFC \uBAA8\uB4E0 \uD0DC\uC2A4\uD06C/\uC644\uB8CC \uC870\uAC74\uC774 \uCDA9\uC871\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uB8CC \uC0C1\uD0DC\uC785\uB2C8\uB2E4.",
   fallbackRerunContext: "\uC0C1\uD0DC\uB97C \uD310\uBCC4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694."
@@ -644,10 +654,13 @@ var koMessages = {
 // src/utils/locales/ko/warnings.ts
 var koWarnings = {
   projectBranchUnavailable: "\uD504\uB85C\uC81D\uD2B8 \uBE0C\uB79C\uCE58\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.)",
+  projectExpectedBranchOnMainWorkspace: "feature \uBE0C\uB79C\uCE58\uAC00 \uBA54\uC778 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0\uC11C \uCCB4\uD06C\uC544\uC6C3\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uAC00\uB2A5\uD558\uBA74 `.worktrees/*` \uACBD\uB85C\uC5D0\uC11C \uC791\uC5C5\uD558\uC138\uC694.",
+  workflowWorktreeRequired: "`workflow.requireWorktree=true` \uC124\uC815\uC73C\uB85C \uC778\uD574 \uD0DC\uC2A4\uD06C \uC2E4\uD589\uC740 `.worktrees/*` \uACBD\uB85C\uC5D0\uC11C\uB9CC \uD5C8\uC6A9\uB429\uB2C8\uB2E4.",
   docsGitUnavailable: "docs \uB808\uD3EC\uC758 git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (\uB808\uD3EC \uC704\uCE58 / git init \uD655\uC778)",
   docsPathIgnored: "\uD604\uC7AC Feature \uBB38\uC11C \uACBD\uB85C\uAC00 git ignore \uB300\uC0C1\uC785\uB2C8\uB2E4: {path} (docs \uCEE4\uBC0B \uAC10\uC9C0\uAC00 \uC81C\uD55C\uB420 \uC218 \uC788\uC2B5\uB2C8\uB2E4.)",
   docsUncommittedChanges: "\uBB38\uC11C \uBCC0\uACBD\uC0AC\uD56D\uC774 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uCD94\uAC00 \uBB38\uC11C \uCEE4\uBC0B \uD544\uC694) \uCEE4\uBC0B \uBA54\uC2DC\uC9C0 \uADDC\uCE59\uC740 git-workflow \uAC00\uC774\uB4DC\uB97C \uAE30\uC900\uC73C\uB85C \uD655\uC778\uD558\uC138\uC694.",
   projectUncommittedChanges: "\uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uBCC0\uACBD\uC0AC\uD56D\uC774 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uCD94\uAC00 \uCF54\uB4DC \uCEE4\uBC0B \uD544\uC694)",
+  featureScopeSplitSuggested: "Feature \uBC94\uC704\uAC00 \uB2E8\uC77C \uC774\uC288\uB85C \uCC98\uB9AC\uD558\uAE30\uC5D0 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}; \uBD84\uD560 \uC81C\uC548 \uAE30\uC900: tasks {taskThreshold}\uAC1C \uB610\uB294 decisions {decisionsThreshold}\uC904) \uD604\uC7AC \uAD8C\uC7A5 \uBD84\uD560: {recommendedIssues}\uAC1C \uC774\uC288 (4\uBD84\uD560 \uD558\uB4DC \uAE30\uC900: tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}).",
   legacyTasksDocStatusField: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. `\uBB38\uC11C \uC0C1\uD0DC` \uD544\uB4DC(Draft/Review/Approved)\uB97C \uCD94\uAC00\uD574 \uD0DC\uC2A4\uD06C \uC2B9\uC778 \uB2E8\uACC4\uB97C \uD65C\uC131\uD654\uD558\uC138\uC694.",
   legacyTasksPrFields: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. PR \uB2E8\uACC4 \uC804\uC5D0 `PR` \uBC0F `PR \uC0C1\uD0DC` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
   legacyTasksPrePrReviewField: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. PR \uB2E8\uACC4 \uC804\uC5D0 `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694. (`- **PR \uC804 \uB9AC\uBDF0**: Pending | Done`)",
@@ -1041,6 +1054,10 @@ var enContext = {
   "context.actionDetail.codeReviewRemoteBlocked": "Resolve remote PR blockers before merge",
   "context.actionDetail.codeReviewMergeAfterOk": "Merge PR after explicit OK",
   "context.actionDetail.codeReviewRequestReview": "Request review and keep PR Status as Review",
+  "context.actionDetail.featureScopeSplit": "Review whether this feature should be split into smaller issue units",
+  "context.actionDetail.featureScopeSplitKeep": "Keep current issue scope and continue (after split-guide check)",
+  "context.actionDetail.featureScopeSplitTwo": "Split into 2 linked issues using coupling/file-overlap/test/deploy criteria",
+  "context.actionDetail.featureScopeSplitFour": "Split into 4 linked issues (criteria-based) and merge PRs in dependency order",
   "context.actionDetail.worktreeCleanup": "Clean up the completed feature worktree",
   "context.actionDetail.prMetadataMigrate": "Update tasks.md PR fields to the latest template format",
   "context.actionDetail.prMetadataMigratePrFields": "Update tasks.md with PR/PR Status fields",
@@ -1124,6 +1141,8 @@ var enMessages = {
   reviewFixCommitGuidance: "Commit PR review fixes. Stage only review-fix files, then commit with `fix(review): <review-fix-summary>`. `<review-fix-summary>` must describe review comments resolved in this commit (do not reuse task titles).",
   standaloneNeedsProjectRoot: "Standalone mode requires projectRoot. (npx lee-spec-kit config --project-root ...)",
   createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && WT="{projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}" && for f in .env .env.local .env.development .env.development.local .env.test .env.test.local .env.production .env.production.local; do [ -f "{projectGitCwd}/$f" ] && [ ! -e "$WT/$f" ] && cp "{projectGitCwd}/$f" "$WT/$f" || true; done && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
+  moveToExistingWorktree: 'A matching feature worktree already exists. Move first: `cd "{worktreePath}"`, then re-run context.',
+  worktreeRequiredFromMainBranch: "`workflow.requireWorktree` is enabled, but this feature branch is checked out in the main workspace. Switch the main workspace to a base branch first, then create/reuse `.worktrees/feat-{issueNumber}-{slug}` and continue from that worktree.",
   worktreeCleanupCommand: 'cd "{projectGitCwd}" && WT="{worktreePath}" && ROOT="$(pwd)" && case "$WT" in "$ROOT"/.worktrees/*) if git worktree list --porcelain | grep -Fxq "worktree $WT"; then git worktree remove --force "$WT" || true; fi; [ -d "$WT" ] && rm -rf "$WT" || true ;; *) echo "skip unsafe worktree path: $WT" ;; esac && git worktree prune && CURRENT_BRANCH=$(git branch --show-current) && DEFAULT_BRANCH=$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null | cut -d/ -f2-) && TARGET_BRANCH="${DEFAULT_BRANCH:-$CURRENT_BRANCH}" && if [ -n "$TARGET_BRANCH" ]; then git checkout "$TARGET_BRANCH" >/dev/null 2>&1 || true; fi && if git rev-parse --abbrev-ref --symbolic-full-name "@{u}" >/dev/null 2>&1 && [ -z "$(git status --porcelain)" ]; then git pull --ff-only || true; fi',
   tasksAllDoneButNoChecklist: 'Create the completion checklist. Add verification items to the tasks.md "Completion Criteria" section, then mark satisfied items as [x] after user confirmation. Record explicit final approval as well.',
   tasksAllDoneButChecklist: "Proceed with remaining completion checklist items. Current progress: ({checked}/{total}) Mark items as [x] only after user confirmation and real verification. Record explicit final approval as well.",
@@ -1138,9 +1157,10 @@ var enMessages = {
   taskCommitGateReasonMismatchLastDone: "The latest project code commit does not match the last completed task",
   prLegacyAsk: "tasks.md is missing PR/PR Status fields. Update to the latest template format? (CHECK required)",
   prePrReviewFieldMissing: "tasks.md is missing the `Pre-PR Review` field. Add `- **Pre-PR Review**: Pending | Done` and run context again. (CHECK required)",
-  prePrReviewRun: "Run the code review agent to generate `review-trace.json`, then execute `pre-pr-review --evidence review-trace.json` to record findings. (CHECK required)",
-  prePrReviewEvidenceMissing: "tasks.md `Pre-PR Evidence` is empty/invalid. Point to a real file and include a `Pre-PR Review Log` section with non-placeholder `Summary`, `Decision`, `Findings` (or explicit `0 findings`), `Residual Risks`, and `Tests Run`. (CHECK required)",
+  prePrReviewRun: "Run the code review agent and generate `review-trace.json` with non-empty `commandsExecuted`, then execute `pre-pr-review --evidence review-trace.json` to record findings. (CHECK required)",
+  prePrReviewEvidenceMissing: "tasks.md `Pre-PR Evidence` is empty/invalid. Point to a real file and include a `Pre-PR Review Log` section with non-placeholder `Summary`, `Decision`, `Findings` (or explicit `0 findings`), `Residual Risks`, `Tests Run`, and real executed commands (`commandsExecuted`). (CHECK required)",
   prePrReviewDecisionMissing: "tasks.md `Pre-PR Decision` is empty/placeholder or missing decision format. Record it as `decision: ...` (or `\uACB0\uC815: ...`). (CHECK required)",
+  prePrReviewDecisionReconfirm: "Current `Pre-PR Decision` is `{decision}`. After fixing findings, rerun pre-PR review with an explicit decision to avoid replaying the prior state: `{command}` (CHECK required)",
   prReviewEvidenceFieldMissing: "tasks.md is missing the `PR Review Evidence` field. Add `- **PR Review Evidence**: -` and continue. (CHECK required)",
   prReviewEvidenceMissing: "tasks.md `PR Review Evidence` is empty/invalid. Use `summary: ...` (or `\uC694\uC57D: ...`), or point to a file containing `PR Review Log` with non-placeholder `Summary` and `Decision`. (CHECK required)",
   prReviewDecisionFieldMissing: "tasks.md is missing the `PR Review Decision` field. Add `- **PR Review Decision**: -` and continue. (CHECK required)",
@@ -1165,6 +1185,9 @@ var enMessages = {
   prReviewMerge: "When ready to merge, get explicit approval (label) and run the merge option. (On success, PR Status is synced to Approved.)",
   prReviewMergeCommand: "npx lee-spec-kit github pr {featureRef} --merge --confirm OK",
   prRequestReview: "Request review and set/keep PR Status as Review.",
+  featureScopeSplitKeep: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}; split suggestion threshold: {taskThreshold}/{decisionsThreshold}). Current recommendation is {recommendedIssues} issues. Before deciding, read `{guideCommand}` and evaluate coupling, changed-file overlap, test boundary, and deployment independence. If you keep one issue, tighten scope in tasks.md and move low-priority TODO items out of the active batch.",
+  featureScopeSplitTwo: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Recommendation rule: 40~79 tasks and below the hard threshold usually maps to 2 issues. Follow `{guideCommand}` and split by coupling/file-overlap/test/deploy criteria. For each new issue, document this template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
+  featureScopeSplitFour: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Hard recommendation is 4 issues when tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}. Follow `{guideCommand}` and split into 4 linked issues with explicit dependency order and sequential PR merges. Use the per-issue template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   userRequestReplan: "You can pause this step and handle a newly requested user requirement first. Summarize it, add it to tasks.md or split it into a separate Feature, then align document statuses and rerun context.",
   featureDone: "Workflow requirements and all tasks/completion criteria are satisfied. This feature is done.",
   fallbackRerunContext: "Cannot determine status. Check the docs and run context again."
@@ -1173,10 +1196,13 @@ var enMessages = {
 // src/utils/locales/en/warnings.ts
 var enWarnings = {
   projectBranchUnavailable: "Cannot determine project branch. (In standalone mode, projectRoot is required.)",
+  projectExpectedBranchOnMainWorkspace: "Feature branch is checked out in the main workspace. Prefer working from a `.worktrees/*` path.",
+  workflowWorktreeRequired: "With `workflow.requireWorktree=true`, task execution is allowed only from `.worktrees/*` paths.",
   docsGitUnavailable: "Cannot read git status for the docs repo. (Check repo location / git init.)",
   docsPathIgnored: "Current feature docs path is ignored by git: {path} (docs commit detection may be limited).",
   docsUncommittedChanges: "Docs changes are not committed. (Additional docs commit needed.) Check commit message rules against the git-workflow guide.",
   projectUncommittedChanges: "Project code changes are not committed. (Additional code commit needed.)",
+  featureScopeSplitSuggested: "Feature scope may be too large for one issue (tasks: {taskCount}, decisions lines: {decisionsLineCount}; suggest split at {taskThreshold} tasks or {decisionsThreshold} decision lines). Current recommendation: split into {recommendedIssues} issue units (hard 4-way rule: tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}).",
   legacyTasksDocStatusField: "Legacy tasks.md format detected. Add a `Doc Status` field (Draft/Review/Approved) to enable tasks approval.",
   legacyTasksPrFields: "Legacy tasks.md format detected. Add `PR` and `PR Status` fields before PR steps.",
   legacyTasksPrePrReviewField: "Legacy tasks.md format detected. Add `Pre-PR Review` before PR steps. (`- **Pre-PR Review**: Pending | Done`)",
@@ -2444,6 +2470,7 @@ async function runInit(options) {
         docsRepo,
         workflow: {
           mode: workflowMode,
+          requireWorktree: false,
           codeDirtyScope: "auto",
           taskCommitGate: "warn",
           auto: {
@@ -2453,7 +2480,9 @@ async function runInit(options) {
             skills: ["code-review-excellence"],
             fallback: "builtin-checklist",
             evidenceMode: "path_required",
-            decisionEnum: ["approve", "changes_requested", "blocked"]
+            decisionEnum: ["approve", "changes_requested", "blocked"],
+            enforceExecutionEvidence: true,
+            executionCommandPrefixes: []
           }
         },
         pr: {
@@ -3163,6 +3192,7 @@ var ACTION_CATEGORIES = [
   "pre_pr_review",
   "pr_status_update",
   "code_review",
+  "feature_scope_split",
   "worktree_cleanup",
   "user_request_replan",
   "feature_done",
@@ -3182,6 +3212,7 @@ function resolveWorkflowPolicy(workflow) {
     mode,
     requireIssue: false,
     requireBranch: false,
+    requireWorktree: false,
     requirePr: false,
     requireReview: false,
     requireMerge: false
@@ -3189,6 +3220,7 @@ function resolveWorkflowPolicy(workflow) {
     mode,
     requireIssue: true,
     requireBranch: true,
+    requireWorktree: false,
     requirePr: true,
     requireReview: true,
     requireMerge: true
@@ -3199,6 +3231,9 @@ function resolveWorkflowPolicy(workflow) {
   if (typeof workflow?.requireBranch === "boolean") {
     policy.requireBranch = workflow.requireBranch;
   }
+  if (typeof workflow?.requireWorktree === "boolean") {
+    policy.requireWorktree = workflow.requireWorktree;
+  }
   if (typeof workflow?.requirePr === "boolean") {
     policy.requirePr = workflow.requirePr;
   }
@@ -3211,6 +3246,9 @@ function resolveWorkflowPolicy(workflow) {
   if (!policy.requireIssue) {
     policy.requireBranch = false;
   }
+  if (!policy.requireBranch) {
+    policy.requireWorktree = false;
+  }
   if (!policy.requirePr) {
     policy.requireReview = false;
     policy.requireMerge = false;
@@ -3267,6 +3305,16 @@ function normalizeDecisionEnumList(input) {
   }
   return [...deduped];
 }
+function normalizeCommandPrefixList(input) {
+  if (!Array.isArray(input)) return [];
+  const deduped = /* @__PURE__ */ new Set();
+  for (const raw of input) {
+    const value = String(raw || "").trim();
+    if (!value) continue;
+    deduped.add(value);
+  }
+  return [...deduped];
+}
 function resolvePrePrReviewPolicy(workflow) {
   const workflowPolicy = resolveWorkflowPolicy(workflow);
   const configured = workflow?.prePrReview;
@@ -3274,17 +3322,45 @@ function resolvePrePrReviewPolicy(workflow) {
   const configuredDecisionEnum = normalizeDecisionEnumList(
     configured?.decisionEnum
   );
+  const configuredCommandPrefixes = normalizeCommandPrefixList(
+    configured?.executionCommandPrefixes
+  );
   const configuredEnabled = typeof configured?.enabled === "boolean" ? configured.enabled : workflowPolicy.requirePr;
+  const configuredExecutionEvidence = typeof configured?.enforceExecutionEvidence === "boolean" ? configured.enforceExecutionEvidence : true;
   return {
     enabled: workflowPolicy.requirePr ? configuredEnabled : false,
     skills: configuredSkills.length > 0 ? configuredSkills : DEFAULT_PRE_PR_REVIEW_SKILLS,
     fallback: configured?.fallback === "builtin-checklist" ? configured.fallback : "builtin-checklist",
     evidenceMode: configured?.evidenceMode === "any" ? "any" : "path_required",
-    decisionEnum: configuredDecisionEnum.length > 0 ? configuredDecisionEnum : DEFAULT_PRE_PR_DECISION_ENUM
+    decisionEnum: configuredDecisionEnum.length > 0 ? configuredDecisionEnum : DEFAULT_PRE_PR_DECISION_ENUM,
+    enforceExecutionEvidence: configuredExecutionEvidence,
+    executionCommandPrefixes: configuredCommandPrefixes.length > 0 ? configuredCommandPrefixes : []
   };
 }
 
 // src/utils/agent-orchestration.ts
+function getPrePrReviewPrompt(lang, skills, fallbackText) {
+  if (lang === "ko") {
+    return `PR \uC0DD\uC131 \uC804 \uC0AC\uC804 \uCF54\uB4DC\uB9AC\uBDF0\uB97C \uC9C4\uD589\uD558\uC138\uC694.
+1. \uC790\uB3D9\uD654\uB41C \uC624\uB958 \uBD84\uC11D\uAE30(\uC608: vitest, biome check, pnpm audit)\uB97C \uC2E4\uD589\uD558\uC138\uC694.
+2. \uB9AC\uBDF0 \uBC94\uC704\uB97C \uBD84\uB9AC\uD574 \uD655\uC778\uD558\uC138\uC694.
+   - main \uAE30\uC900: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
+   - worktree \uAE30\uC900: 'git diff --name-only', 'git diff --name-only --cached', 'git ls-files --others --exclude-standard'
+3. \uD655\uC778\uB41C \uAC01 \uD30C\uC77C\uC5D0 \uB300\uD574 risk, security, perf, maintainability \uD3C9\uAC00\uC640 \uAD6C\uCCB4\uC801\uC778 fileLine \uC704\uCE58\uAC00 \uD3EC\uD568\uB41C 'review-trace.json' \uC99D\uAC70 \uD30C\uC77C\uC744 \uC0DD\uC131\uD558\uC138\uC694. \uC794\uC5EC \uC704\uD5D8(residualRisks)\uACFC \uC2E4\uD589\uD55C \uBA85\uB839\uC5B4(commandsExecuted)\uB3C4 \uD3EC\uD568\uD558\uC138\uC694.
+4. \uAE30\uBCF8 \uBCA0\uC774\uC2A4\uB77C\uC778\uC740 '${fallbackText}'\uC774\uBA70, 'create-pr' \uBB38\uC11C\uC758 'Pre-PR \uAE30\uBCF8 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8' \uC139\uC158\uC744 \uC218\uD589\uD558\uC138\uC694. 
+5. \uC6B0\uC120\uC21C\uC704 \uC2A4\uD0AC: ${skills.length > 0 ? skills.join(", ") : "\uC5C6\uC74C"} \uB85C \uC2EC\uD654 \uAC80\uD1A0\uB97C \uC9C4\uD589\uD558\uC138\uC694.
+\uC644\uB8CC \uD6C4 'pnpm lee pre-pr-review <feature> --evidence review-trace.json --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694.`;
+  }
+  return `Conduct a pre-PR code review.
+1. Run automated analyzers (e.g., vitest, biome check, pnpm audit).
+2. Split and check the review scope.
+   - Main scope: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
+   - Worktree scope: 'git diff --name-only', 'git diff --name-only --cached', 'git ls-files --others --exclude-standard'
+3. Generate a 'review-trace.json' file for all changed files, including evaluations for risk, security, perf, maintainability, and specific fileLine locators. Also include residualRisks and commandsExecuted array.
+4. The baseline is '${fallbackText}'. Always perform the 'Pre-PR Core Checklist' section of the 'create-pr' document. 
+5. Priority skills: ${skills.length > 0 ? skills.join(", ") : "None"} for deeper technical review.
+After completion, execute 'pnpm lee pre-pr-review <feature> --evidence review-trace.json --decision approve'.`;
+}
 function getCodeReviewPrompt(lang) {
   if (lang === "ko") {
     return `\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778/\uBD84\uC11D\uD55C \uB4A4 \uD544\uC694\uD55C \uC218\uC815\uC744 \uC9C4\uD589\uD558\uC138\uC694. PR \uC0C1\uD0DC\uB294 Review\uB97C \uC720\uC9C0\uD558\uACE0 'PR \uB9AC\uBDF0 Evidence/Decision'\uC744 \uCD5C\uC2E0\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. \uC6D0\uACA9 \uBC18\uC601(push)\uC740 \uBA85\uC2DC\uC801\uC778 \uBA38\uC9C0 \uC2B9\uC778(\uB77C\uBCA8) \uD6C4, \uB85C\uCEEC \uBE0C\uB79C\uCE58\uAC00 upstream\uBCF4\uB2E4 \uC55E\uC120 \uACBD\uC6B0\uC5D0\uB9CC \uC9C4\uD589\uD558\uC138\uC694.`;
@@ -3371,6 +3447,17 @@ function buildSelfCliCommand(args) {
   const base = [process.execPath, entry, "--no-banner", ...args];
   return base.map((arg) => toShellArg(arg)).join(" ");
 }
+function buildPrePrReviewCommandArgs(feature, evidencePath, decision) {
+  const commandArgs = ["pre-pr-review", feature.folderName];
+  if (feature.type && feature.type !== "single") {
+    commandArgs.push("--component", feature.type);
+  }
+  commandArgs.push("--evidence", evidencePath);
+  if (decision) {
+    commandArgs.push("--decision", decision);
+  }
+  return commandArgs;
+}
 function resolvePrePrReviewEvidencePath(feature) {
   const docsRoot = feature.git.docsGitCwd;
   const candidates = [];
@@ -3392,7 +3479,7 @@ function resolvePrePrReviewEvidencePath(feature) {
     const abs = path12.resolve(candidate);
     if (seen.has(abs)) continue;
     seen.add(abs);
-    if (!fs8.existsSync(abs)) continue;
+    if (!fs9.existsSync(abs)) continue;
     if (!abs.toLowerCase().endsWith(".json")) continue;
     const rel = path12.relative(docsRoot, abs).replace(/\\/g, "/");
     if (rel && !rel.startsWith("../")) {
@@ -3849,6 +3936,60 @@ function getStepDefinitions(ctx) {
       current: {
         when: (f) => f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && isTasksDocApproved(f) && (!workflowPolicy.requireBranch || f.git.onExpectedBranch || f.tasks.done === f.tasks.total),
         actions: (f) => {
+          if (workflowPolicy.requireWorktree && f.tasks.done < f.tasks.total && f.issueNumber && !f.git.projectInManagedWorktree) {
+            if (f.git.expectedWorktreePath) {
+              return [
+                {
+                  type: "instruction",
+                  category: "branch_create",
+                  requiresUserCheck: true,
+                  uiDetailKey: "context.actionDetail.branchCreate",
+                  message: tr(lang, "messages", "moveToExistingWorktree", {
+                    worktreePath: f.git.expectedWorktreePath
+                  })
+                }
+              ];
+            }
+            if (!f.git.projectGitCwd) {
+              return [
+                {
+                  type: "instruction",
+                  category: "branch_create",
+                  requiresUserCheck: true,
+                  message: tr(lang, "messages", "standaloneNeedsProjectRoot")
+                }
+              ];
+            }
+            if (f.git.onExpectedBranch) {
+              return [
+                {
+                  type: "instruction",
+                  category: "branch_create",
+                  requiresUserCheck: true,
+                  uiDetailKey: "context.actionDetail.branchCreate",
+                  message: tr(lang, "messages", "worktreeRequiredFromMainBranch", {
+                    projectGitCwd: f.git.projectGitCwd,
+                    issueNumber: f.issueNumber,
+                    slug: f.slug
+                  })
+                }
+              ];
+            }
+            return [
+              {
+                type: "command",
+                category: "branch_create",
+                requiresUserCheck: true,
+                scope: "project",
+                cwd: f.git.projectGitCwd,
+                cmd: tr(lang, "messages", "createBranch", {
+                  projectGitCwd: f.git.projectGitCwd,
+                  issueNumber: f.issueNumber,
+                  slug: f.slug
+                })
+              }
+            ];
+          }
           if (f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f)) {
             if (f.git.docsHasUncommittedChanges) {
               return [
@@ -4204,15 +4345,30 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 type: "instruction",
                 category: "pre_pr_review",
                 requiresUserCheck: true,
-                message: tr(lang, "messages", "prePrReviewRun")
+                message: getPrePrReviewPrompt(
+                  lang,
+                  prePrReviewPolicy.skills,
+                  prePrReviewPolicy.fallback
+                )
               }
             ];
           }
-          const commandArgs = ["pre-pr-review", f.folderName];
-          if (f.type && f.type !== "single") {
-            commandArgs.push("--component", f.type);
+          if (f.prePrReview.decisionOutcome && f.prePrReview.decisionOutcome !== "approve") {
+            return [
+              {
+                type: "instruction",
+                category: "pre_pr_review",
+                requiresUserCheck: true,
+                message: tr(lang, "messages", "prePrReviewDecisionReconfirm", {
+                  decision: f.prePrReview.decisionOutcome,
+                  command: buildSelfCliCommand(
+                    buildPrePrReviewCommandArgs(f, evidencePath, "approve")
+                  )
+                })
+              }
+            ];
           }
-          commandArgs.push("--evidence", evidencePath);
+          const commandArgs = buildPrePrReviewCommandArgs(f, evidencePath);
           return [
             {
               type: "command",
@@ -4575,6 +4731,77 @@ function applyTaskExecutePhaseCheck(action, requiresUserCheck, policy, explicitl
   if (explicitlyRequired) return requiresUserCheck;
   return false;
 }
+function withFeatureScopeSplitOptions(actions, feature, lang) {
+  if (!feature.scopeSplit.suggested) return actions;
+  if (feature.tasks.total === 0 || feature.tasks.done >= feature.tasks.total) {
+    return actions;
+  }
+  if (actions.some((action) => action.category === "feature_scope_split")) {
+    return actions;
+  }
+  const recommendedIssues = feature.scopeSplit.recommendation === "split_4" ? 4 : 2;
+  const recommendationLabel = feature.scopeSplit.recommendation === "split_4" ? "split_4" : feature.scopeSplit.recommendation === "split_2" ? "split_2" : "none";
+  const vars = {
+    taskCount: feature.scopeSplit.taskCount,
+    decisionsLineCount: feature.scopeSplit.decisionsLineCount,
+    taskThreshold: feature.scopeSplit.suggestTaskCountThreshold,
+    decisionsThreshold: feature.scopeSplit.suggestDecisionsLineCountThreshold,
+    recommendFourTaskThreshold: feature.scopeSplit.recommendSplitFourTaskCountThreshold,
+    recommendFourDecisionsThreshold: feature.scopeSplit.recommendSplitFourDecisionsLineCountThreshold,
+    recommendedIssues,
+    recommendationLabel,
+    guideCommand: "npx lee-spec-kit docs get split-feature --json"
+  };
+  return [
+    ...actions,
+    {
+      type: "instruction",
+      category: "feature_scope_split",
+      requiresUserCheck: true,
+      uiDetailKey: "context.actionDetail.featureScopeSplitKeep",
+      message: tr(lang, "messages", "featureScopeSplitKeep", vars)
+    },
+    {
+      type: "instruction",
+      category: "feature_scope_split",
+      requiresUserCheck: true,
+      uiDetailKey: "context.actionDetail.featureScopeSplitTwo",
+      message: tr(lang, "messages", "featureScopeSplitTwo", vars)
+    },
+    {
+      type: "instruction",
+      category: "feature_scope_split",
+      requiresUserCheck: true,
+      uiDetailKey: "context.actionDetail.featureScopeSplitFour",
+      message: tr(lang, "messages", "featureScopeSplitFour", vars)
+    }
+  ];
+}
+function withExistingWorktreeMoveOption(actions, feature, lang) {
+  if (feature.tasks.total === 0 || feature.tasks.done >= feature.tasks.total) {
+    return actions;
+  }
+  if (feature.git.projectInManagedWorktree) return actions;
+  if (!feature.git.onExpectedBranch) return actions;
+  if (!feature.git.expectedWorktreePath) return actions;
+  if (actions.some(
+    (action) => action.category === "branch_create" && action.type === "instruction" && action.message.includes(feature.git.expectedWorktreePath || "")
+  )) {
+    return actions;
+  }
+  return [
+    ...actions,
+    {
+      type: "instruction",
+      category: "branch_create",
+      requiresUserCheck: true,
+      uiDetailKey: "context.actionDetail.branchCreate",
+      message: tr(lang, "messages", "moveToExistingWorktree", {
+        worktreePath: feature.git.expectedWorktreePath
+      })
+    }
+  ];
+}
 function withUserRequestReplanOption(actions, lang) {
   if (actions.some((action) => action.category === "user_request_replan")) {
     return actions;
@@ -4594,8 +4821,18 @@ function resolveFeatureProgress(feature, stepDefinitions, lang, approval) {
   for (const definition of ordered) {
     if (!definition.current) continue;
     if (definition.current.when(feature)) {
-      const currentActions = withUserRequestReplanOption(
+      const actionsWithScopeSplit = withFeatureScopeSplitOptions(
         definition.current.actions(feature),
+        feature,
+        lang
+      );
+      const actionsWithWorktreeMove = withExistingWorktreeMoveOption(
+        actionsWithScopeSplit,
+        feature,
+        lang
+      );
+      const currentActions = withUserRequestReplanOption(
+        actionsWithWorktreeMove,
         lang
       );
       const actions = applyApprovalPolicy(
@@ -4737,9 +4974,22 @@ function isGitPathIgnored(ctx, cwd, relativePath) {
   }
 }
 var GIT_WORKTREE_CACHE = /* @__PURE__ */ new Map();
+var WORKTREE_MARKER = `${path12.sep}.worktrees${path12.sep}`;
 function resetContextGitCaches() {
   GIT_WORKTREE_CACHE.clear();
 }
+function isManagedWorktreePath(cwd) {
+  if (!cwd) return false;
+  const normalized = path12.resolve(cwd);
+  return normalized.includes(WORKTREE_MARKER);
+}
+function resolveProjectRootFromGitCwd(cwd) {
+  const normalized = path12.resolve(cwd);
+  const markerIndex = normalized.lastIndexOf(WORKTREE_MARKER);
+  if (markerIndex <= 0) return normalized;
+  const projectRoot = normalized.slice(0, markerIndex);
+  return projectRoot || normalized;
+}
 function getGitTopLevel(ctx, cwd) {
   try {
     return ctx.cmd.execFileSync("git", ["rev-parse", "--show-toplevel"], {
@@ -4843,6 +5093,17 @@ function isExpectedFeatureBranch(branchName, issueNumber, slug, folderName) {
   const rest = match[1];
   return rest === slug || rest === folderName;
 }
+var FEATURE_SCOPE_SPLIT_TASK_THRESHOLD = 40;
+var FEATURE_SCOPE_SPLIT_DECISIONS_LINE_THRESHOLD = 1200;
+var FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_TASK_THRESHOLD = 80;
+var FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_DECISIONS_LINE_THRESHOLD = 2500;
+function countDocumentLines(content) {
+  if (!content) return 0;
+  const lines = content.split(/\r?\n/);
+  if (lines.length === 0) return 0;
+  if (lines[lines.length - 1] === "") return lines.length - 1;
+  return lines.length;
+}
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -5033,7 +5294,13 @@ function isExplicitZeroFindingsEntry(value) {
   if (!trimmed) return false;
   return /^0+\s*findings?\b/.test(trimmed) || /^no\s+findings?\b/.test(trimmed) || /^findings?\s*[:：]\s*0+\b/.test(trimmed) || /^지적\s*사항?\s*[:：]?\s*0+\b/.test(trimmed) || /^지적\s*없음\b/.test(trimmed);
 }
-function hasPrePrReviewLogQuality(content) {
+function isNoCommandsPlaceholder(value) {
+  const trimmed = value.trim().toLowerCase();
+  if (!trimmed) return true;
+  return /^none(?:\s+specified)?\b/.test(trimmed) || /^no\s+commands?\b/.test(trimmed) || /^n\/a\b/.test(trimmed) || /^없음\b/.test(trimmed) || /^명령(?:어)?\s*없음\b/.test(trimmed);
+}
+function hasPrePrReviewLogQuality(content, options) {
+  const requireCommandsExecuted = !!options?.requireCommandsExecuted;
   const sections = splitReviewLogSections(content, PRE_PR_REVIEW_LOG_HEADER);
   for (const section of sections) {
     const summaryEntries = collectStructuredReviewEntries(section, [
@@ -5074,16 +5341,28 @@ function hasPrePrReviewLogQuality(content) {
       "\uD14C\uC2A4\uD2B8 \uC2E4\uD589"
     ]);
     if (!hasValidReviewLogEntries(testsRunEntries)) continue;
+    if (requireCommandsExecuted) {
+      const commandsEntries = collectStructuredReviewEntries(section, [
+        "Commands Executed",
+        "Executed Commands",
+        "\uC2E4\uD589 \uBA85\uB839\uC5B4",
+        "\uC2E4\uD589 \uBA85\uB839"
+      ]);
+      const hasCommandsExecuted = commandsEntries.map((entry) => entry.trim()).some(
+        (entry) => entry.length > 0 && !isReviewDraftPlaceholder(entry) && !isPlaceholderReviewEvidence(entry) && !isNoCommandsPlaceholder(entry)
+      );
+      if (!hasCommandsExecuted) continue;
+    }
     return true;
   }
   return false;
 }
 var PRE_PR_REVIEW_LOG_HEADER = /^##\s+(?:Pre-PR Review Log|PR 전 리뷰 로그)\b.*$/gim;
 var PR_REVIEW_LOG_HEADER = /^##\s+(?:PR Review Log|PR 리뷰 로그)\b.*$/gim;
-async function hasPrePrReviewLogEvidence(ctx, candidatePath) {
+async function hasPrePrReviewLogEvidence(ctx, candidatePath, options) {
   try {
     const content = await ctx.fs.readFile(candidatePath, "utf-8");
-    return hasPrePrReviewLogQuality(content);
+    return hasPrePrReviewLogQuality(content, options);
   } catch {
     return false;
   }
@@ -5130,12 +5409,19 @@ async function isPrePrEvidenceProvided(ctx, rawValue, policy, context) {
     rawValue,
     context
   );
+  if (policy.enforceExecutionEvidence && !existingEvidencePath) {
+    return false;
+  }
   if (policy.evidenceMode !== "path_required") {
     if (!existingEvidencePath) return true;
-    return hasPrePrReviewLogEvidence(ctx, existingEvidencePath);
+    return hasPrePrReviewLogEvidence(ctx, existingEvidencePath, {
+      requireCommandsExecuted: policy.enforceExecutionEvidence
+    });
   }
   if (!existingEvidencePath) return false;
-  return hasPrePrReviewLogEvidence(ctx, existingEvidencePath);
+  return hasPrePrReviewLogEvidence(ctx, existingEvidencePath, {
+    requireCommandsExecuted: policy.enforceExecutionEvidence
+  });
 }
 async function isPrReviewEvidenceProvided(ctx, rawValue, context) {
   if (isPlaceholderReviewEvidence(rawValue)) return false;
@@ -5203,6 +5489,31 @@ function resetContextParseCaches() {
   PR_REMOTE_STATUS_CACHE.clear();
   FEATURE_WORKTREE_CACHE.clear();
 }
+function getExpectedWorktreeCandidates(projectGitCwd, issueNumber, slug, folderName) {
+  const projectRoot = resolveProjectRootFromGitCwd(projectGitCwd);
+  const names = [`feat-${issueNumber}-${slug}`, `feat-${issueNumber}-${folderName}`];
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const name of names) {
+    const candidate = path12.resolve(projectRoot, ".worktrees", name);
+    if (seen.has(candidate)) continue;
+    seen.add(candidate);
+    out.push(candidate);
+  }
+  return out;
+}
+function resolveExistingExpectedWorktreePath(projectGitCwd, issueNumber, slug, folderName) {
+  for (const candidate of getExpectedWorktreeCandidates(
+    projectGitCwd,
+    issueNumber,
+    slug,
+    folderName
+  )) {
+    if (!fs9.existsSync(candidate)) continue;
+    return candidate;
+  }
+  return void 0;
+}
 function resolveFeatureWorktreePath(ctx, projectGitCwd, issueNumber, slug, folderName) {
   const expectedBranches = [
     `feat/${issueNumber}-${slug}`,
@@ -5221,6 +5532,21 @@ function resolveFeatureWorktreePath(ctx, projectGitCwd, issueNumber, slug, folde
       branch: getCurrentBranch(ctx, foundPath) || branchName
     };
   }
+  const expectedBranchesSet = new Set(expectedBranches);
+  for (const candidate of getExpectedWorktreeCandidates(
+    projectGitCwd,
+    issueNumber,
+    slug,
+    folderName
+  )) {
+    if (!fs9.existsSync(candidate)) continue;
+    const branchName = getCurrentBranch(ctx, candidate);
+    if (!expectedBranchesSet.has(branchName)) continue;
+    return {
+      cwd: candidate,
+      branch: branchName
+    };
+  }
   return void 0;
 }
 function toUpperToken(value) {
@@ -5466,6 +5792,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   const specPath = path12.join(featurePath, "spec.md");
   const planPath = path12.join(featurePath, "plan.md");
   const tasksPath = path12.join(featurePath, "tasks.md");
+  const decisionsPath = path12.join(featurePath, "decisions.md");
   const issueDocPath = path12.join(featurePath, "issue.md");
   const prDocPath = path12.join(featurePath, "pr.md");
   let specStatus;
@@ -5486,25 +5813,17 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   let effectiveProjectBranch = context.projectBranch;
   let effectiveProjectBranchAvailable = context.projectBranchAvailable;
   if (effectiveProjectGitCwd && issueNumber) {
-    const alreadyExpected = isExpectedFeatureBranch(
-      effectiveProjectBranch,
+    const worktree = resolveFeatureWorktreePath(
+      ctx,
+      effectiveProjectGitCwd,
       issueNumber,
       slug,
       folderName
     );
-    if (!alreadyExpected) {
-      const worktree = resolveFeatureWorktreePath(
-        ctx,
-        effectiveProjectGitCwd,
-        issueNumber,
-        slug,
-        folderName
-      );
-      if (worktree) {
-        effectiveProjectGitCwd = worktree.cwd;
-        effectiveProjectBranch = worktree.branch;
-        effectiveProjectBranchAvailable = true;
-      }
+    if (worktree) {
+      effectiveProjectGitCwd = worktree.cwd;
+      effectiveProjectBranch = worktree.branch;
+      effectiveProjectBranchAvailable = true;
     }
   }
   let planStatus;
@@ -5514,6 +5833,12 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     const statusValue = extractFirstSpecValue(content, ["\uC0C1\uD0DC", "Status"]);
     planStatus = parseDocStatus(statusValue);
   }
+  const decisionsExists = await ctx.fs.pathExists(decisionsPath);
+  let decisionsLineCount = 0;
+  if (decisionsExists) {
+    const content = await ctx.fs.readFile(decisionsPath, "utf-8");
+    decisionsLineCount = countDocumentLines(content);
+  }
   const tasksExists = await ctx.fs.pathExists(tasksPath);
   const tasksSummary = { total: 0, todo: 0, doing: 0, done: 0 };
   let activeTask;
@@ -5650,25 +5975,17 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     prReviewDecisionProvided = !isPlaceholderReviewEvidence(prReviewDecisionValue) && hasStructuredReviewDecision(prReviewDecisionValue);
   }
   if (effectiveProjectGitCwd && issueNumber) {
-    const alreadyExpected = isExpectedFeatureBranch(
-      effectiveProjectBranch,
+    const worktree = resolveFeatureWorktreePath(
+      ctx,
+      effectiveProjectGitCwd,
       issueNumber,
       slug,
       folderName
     );
-    if (!alreadyExpected) {
-      const worktree = resolveFeatureWorktreePath(
-        ctx,
-        effectiveProjectGitCwd,
-        issueNumber,
-        slug,
-        folderName
-      );
-      if (worktree) {
-        effectiveProjectGitCwd = worktree.cwd;
-        effectiveProjectBranch = worktree.branch;
-        effectiveProjectBranchAvailable = true;
-      }
+    if (worktree) {
+      effectiveProjectGitCwd = worktree.cwd;
+      effectiveProjectBranch = worktree.branch;
+      effectiveProjectBranchAvailable = true;
     }
   }
   const issueDocExists = await ctx.fs.pathExists(issueDocPath);
@@ -5701,6 +6018,16 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   if (workflowPolicy.requireMerge && prStatus === "Review" && prLink && effectiveProjectGitCwd) {
     prRemote = resolvePrRemoteStatus(ctx, prLink, effectiveProjectGitCwd) || void 0;
   }
+  const scopeSplitReasons = [];
+  if (tasksSummary.total >= FEATURE_SCOPE_SPLIT_TASK_THRESHOLD) {
+    scopeSplitReasons.push("task_count");
+  }
+  if (decisionsLineCount >= FEATURE_SCOPE_SPLIT_DECISIONS_LINE_THRESHOLD) {
+    scopeSplitReasons.push("decisions_lines");
+  }
+  const scopeSplitSuggested = scopeSplitReasons.length > 0;
+  const scopeSplitRecommendFour = tasksSummary.total >= FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_TASK_THRESHOLD || decisionsLineCount >= FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_DECISIONS_LINE_THRESHOLD;
+  const scopeSplitRecommendation = !scopeSplitSuggested ? "none" : scopeSplitRecommendFour ? "split_4" : "split_2";
   const warnings = [];
   if (effectiveProjectBranchAvailable === false) {
     warnings.push(tr(lang, "warnings", "projectBranchUnavailable"));
@@ -5711,6 +6038,18 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     slug,
     folderName
   );
+  const projectInManagedWorktree = isManagedWorktreePath(effectiveProjectGitCwd);
+  const expectedWorktreePath = effectiveProjectGitCwd && issueNumber ? resolveExistingExpectedWorktreePath(
+    effectiveProjectGitCwd,
+    issueNumber,
+    slug,
+    folderName
+  ) : void 0;
+  if (workflowPolicy.requireBranch && tasksSummary.total > tasksSummary.done && onExpectedBranch && !projectInManagedWorktree) {
+    warnings.push(tr(lang, "warnings", "projectExpectedBranchOnMainWorkspace"));
+  } else if (workflowPolicy.requireWorktree && tasksSummary.total > tasksSummary.done && !projectInManagedWorktree) {
+    warnings.push(tr(lang, "warnings", "workflowWorktreeRequired"));
+  }
   const relativeFeaturePathFromDocs = path12.relative(
     context.docsDir,
     featurePath
@@ -5835,6 +6174,19 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   if (tasksExists && !tasksDocStatusFieldExists) {
     warnings.push(tr(lang, "warnings", "legacyTasksDocStatusField"));
   }
+  if (scopeSplitSuggested && tasksSummary.total > tasksSummary.done) {
+    warnings.push(
+      tr(lang, "warnings", "featureScopeSplitSuggested", {
+        taskCount: tasksSummary.total,
+        decisionsLineCount,
+        taskThreshold: FEATURE_SCOPE_SPLIT_TASK_THRESHOLD,
+        decisionsThreshold: FEATURE_SCOPE_SPLIT_DECISIONS_LINE_THRESHOLD,
+        recommendFourTaskThreshold: FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_TASK_THRESHOLD,
+        recommendFourDecisionsThreshold: FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_DECISIONS_LINE_THRESHOLD,
+        recommendedIssues: scopeSplitRecommendation === "split_4" ? 4 : 2
+      })
+    );
+  }
   if (docsEverCommitted && docsHasUncommittedChanges) {
     warnings.push(tr(lang, "warnings", "docsUncommittedChanges"));
   }
@@ -5946,6 +6298,17 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     planStatus,
     tasksDocStatus,
     tasks: tasksSummary,
+    scopeSplit: {
+      suggested: scopeSplitSuggested,
+      reasons: scopeSplitReasons,
+      recommendation: scopeSplitRecommendation,
+      taskCount: tasksSummary.total,
+      decisionsLineCount,
+      suggestTaskCountThreshold: FEATURE_SCOPE_SPLIT_TASK_THRESHOLD,
+      suggestDecisionsLineCountThreshold: FEATURE_SCOPE_SPLIT_DECISIONS_LINE_THRESHOLD,
+      recommendSplitFourTaskCountThreshold: FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_TASK_THRESHOLD,
+      recommendSplitFourDecisionsLineCountThreshold: FEATURE_SCOPE_SPLIT_RECOMMEND_FOUR_DECISIONS_LINE_THRESHOLD
+    },
     activeTask,
     lastDoneTask,
     nextTodoTask,
@@ -5972,6 +6335,8 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       docsGitCwd: context.docsGitCwd,
       projectGitCwd: effectiveProjectGitCwd,
       onExpectedBranch,
+      projectInManagedWorktree,
+      expectedWorktreePath,
       docsEverCommitted,
       docsHasUncommittedChanges,
       projectHasUncommittedChanges,
@@ -6545,6 +6910,16 @@ function normalizeSkillList2(raw) {
   }
   return [...deduped];
 }
+function normalizeStringList(raw) {
+  if (!Array.isArray(raw)) return [];
+  const deduped = /* @__PURE__ */ new Set();
+  for (const item of raw) {
+    const value = String(item || "").trim();
+    if (!value) continue;
+    deduped.add(value);
+  }
+  return [...deduped];
+}
 function normalizeDecisionEnumList2(raw) {
   if (!Array.isArray(raw)) return [];
   const deduped = /* @__PURE__ */ new Set();
@@ -6578,6 +6953,7 @@ async function backfillMissingConfigDefaults(docsDir) {
   }
   const workflow = raw.workflow;
   setIfMissing(workflow, "mode", "github", "workflow.mode");
+  setIfMissing(workflow, "requireWorktree", false, "workflow.requireWorktree");
   setIfMissing(workflow, "codeDirtyScope", "auto", "workflow.codeDirtyScope");
   setIfMissing(workflow, "taskCommitGate", "warn", "workflow.taskCommitGate");
   if (!isPlainObject(workflow.auto)) {
@@ -6632,6 +7008,24 @@ async function backfillMissingConfigDefaults(docsDir) {
       changedPaths.push("workflow.prePrReview.decisionEnum");
     }
   }
+  setIfMissing(
+    prePrReview,
+    "enforceExecutionEvidence",
+    true,
+    "workflow.prePrReview.enforceExecutionEvidence"
+  );
+  if (prePrReview.executionCommandPrefixes === void 0) {
+    prePrReview.executionCommandPrefixes = [];
+    changedPaths.push("workflow.prePrReview.executionCommandPrefixes");
+  } else {
+    const normalizedExecutionCommandPrefixes = normalizeStringList(
+      prePrReview.executionCommandPrefixes
+    );
+    if (JSON.stringify(normalizedExecutionCommandPrefixes) !== JSON.stringify(prePrReview.executionCommandPrefixes)) {
+      prePrReview.executionCommandPrefixes = normalizedExecutionCommandPrefixes;
+      changedPaths.push("workflow.prePrReview.executionCommandPrefixes");
+    }
+  }
   if (!isPlainObject(raw.pr)) {
     raw.pr = {};
     changedPaths.push("pr");
@@ -6966,12 +7360,18 @@ var BUILTIN_DOC_DEFINITIONS = [
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
     relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "create-pr.md")
+  },
+  {
+    id: "split-feature",
+    title: { ko: "feature \uBD84\uD560 \uAC00\uC774\uB4DC", en: "feature split guide" },
+    relativePath: (_, lang) => path12.join(lang, "common", "agents", "skills", "split-feature.md")
   }
 ];
 var DOC_FOLLOWUPS = {
   agents: [
     "create-feature",
     "execute-task",
+    "split-feature",
     "git-workflow",
     "create-issue",
     "issue-doc",
@@ -6982,9 +7382,10 @@ var DOC_FOLLOWUPS = {
   "issue-doc": [],
   "pr-doc": [],
   "create-feature": ["execute-task"],
-  "execute-task": ["git-workflow"],
+  "execute-task": ["git-workflow", "split-feature"],
   "create-issue": ["issue-doc"],
-  "create-pr": ["pr-doc"]
+  "create-pr": ["pr-doc"],
+  "split-feature": []
 };
 var CATEGORY_DOC_MAP = {
   spec_write: ["agents"],
@@ -7002,6 +7403,7 @@ var CATEGORY_DOC_MAP = {
   pr_create: ["create-pr", "pr-doc", "git-workflow"],
   pr_status_update: ["create-pr"],
   code_review: ["create-pr"],
+  feature_scope_split: ["split-feature", "execute-task"],
   worktree_cleanup: ["git-workflow"],
   user_request_replan: ["agents", "execute-task"]
 };
@@ -7019,6 +7421,9 @@ function normalizeBuiltinDocId(input) {
   if (normalized === "execute-task") return "execute-task";
   if (normalized === "create-issue") return "create-issue";
   if (normalized === "create-pr") return "create-pr";
+  if (normalized === "split-feature" || normalized === "feature-split") {
+    return "split-feature";
+  }
   if (normalized === "agents") return "agents";
   return null;
 }
@@ -7107,6 +7512,7 @@ var ACTION_DETAIL_KEY_BY_CATEGORY = {
   pr_create: "context.actionDetail.prCreate",
   pr_status_update: "context.actionDetail.prStatusUpdate",
   code_review: "context.actionDetail.codeReview",
+  feature_scope_split: "context.actionDetail.featureScopeSplit",
   worktree_cleanup: "context.actionDetail.worktreeCleanup",
   pr_metadata_migrate: "context.actionDetail.prMetadataMigrate",
   user_request_replan: "context.actionDetail.userRequestReplan",
@@ -13877,6 +14283,22 @@ function normalizeCommandsExecuted(value) {
   if (!Array.isArray(value)) return [];
   return value.map((entry) => typeof entry === "string" ? entry.trim() : "").filter(Boolean);
 }
+function normalizeGitPath3(value) {
+  return value.trim().replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/\/+$/, "");
+}
+function parseGitPathList(stdout) {
+  return stdout.split("\n").map((entry) => normalizeGitPath3(entry)).filter(Boolean);
+}
+function uniquePaths(values) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of values) {
+    if (!value || seen.has(value)) continue;
+    seen.add(value);
+    out.push(value);
+  }
+  return out;
+}
 function normalizeEvidenceFiles(value) {
   if (!Array.isArray(value)) {
     throw createCliError(
@@ -13920,6 +14342,10 @@ var PrePrReviewValidator = class {
     this.ctx = ctx;
   }
   async validateEvidence(evidencePath, projectRoot) {
+    const result = await this.validateEvidenceWithScope(evidencePath, projectRoot);
+    return result.evidence;
+  }
+  async validateEvidenceWithScope(evidencePath, projectRoot) {
     const fullPath = path12.resolve(evidencePath);
     if (!await fs.pathExists(fullPath)) {
       throw createCliError(
@@ -13958,14 +14384,18 @@ var PrePrReviewValidator = class {
         );
       }
     }
-    const changedFiles = await this.getChangedFiles(projectRoot);
+    const scope = await this.collectReviewScope(projectRoot);
+    const changedFiles = uniquePaths([
+      ...scope.mainChangedFiles,
+      ...scope.worktreeChangedFiles
+    ]);
     const reviewedFiles = new Set(
       normalizedEvidence.files.map(
         (f) => path12.relative(
           projectRoot,
           path12.resolve(projectRoot, f.path)
         )
-      )
+      ).map((entry) => normalizeGitPath3(entry)).filter(Boolean)
     );
     const missingFiles = changedFiles.filter((f) => !reviewedFiles.has(f));
     if (missingFiles.length > 0) {
@@ -13975,40 +14405,120 @@ var PrePrReviewValidator = class {
 ${missingFiles.map((f) => `- ${f}`).join("\n")}`
       );
     }
-    return normalizedEvidence;
+    return {
+      evidence: normalizedEvidence,
+      scope
+    };
   }
-  async getChangedFiles(cwd) {
-    const branchResult = await this.ctx.cmd.runAsync("git", ["rev-parse", "--abbrev-ref", "origin/HEAD"], { cwd }).catch(() => null);
-    let baseBranch = "origin/main";
-    if (branchResult && branchResult.code === 0 && branchResult.stdout.trim()) {
-      baseBranch = branchResult.stdout.trim().replace(/^origin\//, "");
+  async collectReviewScope(cwd) {
+    const baseRef = await this.resolveBaseRef(cwd);
+    const mergeBase = await this.resolveMergeBase(cwd, baseRef);
+    const mainDiff = await this.getMainChangedFiles(cwd, mergeBase);
+    const worktreeDiff = await this.getWorktreeChangedFiles(cwd);
+    if (!mainDiff.ok && !worktreeDiff.ok) {
+      throw createCliError(
+        "VALIDATION_FAILED",
+        "Unable to determine changed files from git diff. Ensure this is a git repository with accessible history."
+      );
     }
-    let diffTarget = "HEAD~1";
+    return {
+      baseRef,
+      mergeBase,
+      mainRange: mainDiff.rangeLabel,
+      mainChangedFiles: mainDiff.files,
+      worktreeChangedFiles: worktreeDiff.files
+    };
+  }
+  async resolveBaseRef(cwd) {
     try {
-      const mergeBaseRes = await this.ctx.cmd.runAsync(
+      const result = await this.ctx.cmd.runAsync(
         "git",
-        ["merge-base", "HEAD", baseBranch],
+        ["rev-parse", "--abbrev-ref", "origin/HEAD"],
         { cwd }
       );
-      if (mergeBaseRes.code === 0 && mergeBaseRes.stdout.trim()) {
-        diffTarget = mergeBaseRes.stdout.trim();
+      if (result.code === 0) {
+        const value = result.stdout.trim();
+        if (value && value !== "origin/HEAD") {
+          return value;
+        }
       }
     } catch {
     }
-    const targets = [diffTarget, "HEAD~1", ""];
-    const seen = /* @__PURE__ */ new Set();
-    for (const target of targets) {
-      if (seen.has(target)) continue;
-      seen.add(target);
-      const args = target ? ["diff", "--name-only", target] : ["diff", "--name-only"];
-      const diffResult = await this.ctx.cmd.runAsync("git", args, { cwd });
-      if (diffResult.code !== 0) continue;
-      return diffResult.stdout.split("\n").map((s) => s.trim()).filter(Boolean);
+    return "origin/main";
+  }
+  async resolveMergeBase(cwd, baseRef) {
+    const candidates = uniquePaths([
+      baseRef,
+      baseRef.replace(/^origin\//, ""),
+      "origin/main",
+      "main"
+    ]);
+    for (const candidate of candidates) {
+      if (!candidate) continue;
+      try {
+        const result = await this.ctx.cmd.runAsync(
+          "git",
+          ["merge-base", "HEAD", candidate],
+          { cwd }
+        );
+        if (result.code !== 0) continue;
+        const mergeBase = normalizeGitPath3(result.stdout);
+        if (mergeBase) return mergeBase;
+      } catch {
+      }
     }
-    throw createCliError(
-      "VALIDATION_FAILED",
-      "Unable to determine changed files from git diff. Ensure this is a git repository with accessible history."
-    );
+    return null;
+  }
+  async getMainChangedFiles(cwd, mergeBase) {
+    const ranges = uniquePaths([
+      mergeBase ? `${mergeBase}..HEAD` : "",
+      "HEAD~1..HEAD",
+      "HEAD^..HEAD"
+    ]);
+    for (const range of ranges) {
+      if (!range) continue;
+      try {
+        const result = await this.ctx.cmd.runAsync(
+          "git",
+          ["diff", "--name-only", range],
+          { cwd }
+        );
+        if (result.code !== 0) continue;
+        return {
+          ok: true,
+          rangeLabel: range,
+          files: uniquePaths(parseGitPathList(result.stdout))
+        };
+      } catch {
+      }
+    }
+    return {
+      ok: false,
+      rangeLabel: mergeBase ? `${mergeBase}..HEAD` : "HEAD~1..HEAD",
+      files: []
+    };
+  }
+  async getWorktreeChangedFiles(cwd) {
+    let hasSuccessfulCommand = false;
+    const files = [];
+    const commands = [
+      ["diff", "--name-only"],
+      ["diff", "--name-only", "--cached"],
+      ["ls-files", "--others", "--exclude-standard"]
+    ];
+    for (const args of commands) {
+      try {
+        const result = await this.ctx.cmd.runAsync("git", args, { cwd });
+        if (result.code !== 0) continue;
+        hasSuccessfulCommand = true;
+        files.push(...parseGitPathList(result.stdout));
+      } catch {
+      }
+    }
+    return {
+      ok: hasSuccessfulCommand,
+      files: uniquePaths(files)
+    };
   }
 };
 
@@ -14075,6 +14585,9 @@ function upsertSpecLine(content, keys, preferredKey, value, anchorKeys) {
 function normalizePathForDoc(value) {
   return value.replace(/\\/g, "/");
 }
+function normalizeShellLikeCommand(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
 function getPreferredKeys(lang) {
   if (lang === "ko") {
     return {
@@ -14106,6 +14619,8 @@ function buildReportContent(input) {
     - Maintainability: ${f.review.maintainability}`;
     }).join("\n");
   }
+  const mainScopeFiles = input.scope.mainChangedFiles.length > 0 ? input.scope.mainChangedFiles.map((entry) => `    - ${entry}`).join("\n") : "    - (none)";
+  const worktreeScopeFiles = input.scope.worktreeChangedFiles.length > 0 ? input.scope.worktreeChangedFiles.map((entry) => `    - ${entry}`).join("\n") : "    - (none)";
   return `## Pre-PR Review Log (${input.date})
 
 - **Feature**: ${input.folderName}
@@ -14119,12 +14634,30 @@ ${commandsRun}
 - **Residual Risks**:
   - ${input.evidence.residualRisks}
 
+- **Review Scope**:
+  - **Main Base Ref**: ${input.scope.baseRef}
+  - **Main Merge Base**: ${input.scope.mergeBase ?? "unresolved"}
+  - **Main Range**: ${input.scope.mainRange}
+  - **Main Changed Files**:
+${mainScopeFiles}
+  - **Worktree Changed Files**:
+${worktreeScopeFiles}
+
 - **Findings (Changed Files)**:
 ${filesSection}
 
 - **Trace**: pre-pr-review command executed and synced with tasks.md
 `;
 }
+function createFallbackReviewScope() {
+  return {
+    baseRef: "origin/main",
+    mergeBase: null,
+    mainRange: "HEAD~1..HEAD",
+    mainChangedFiles: [],
+    worktreeChangedFiles: []
+  };
+}
 function appendDecisionLog(content, entry) {
   const normalized = content.trimEnd();
   if (!normalized) return `${entry.trim()}
@@ -14207,6 +14740,12 @@ async function runPrePrReview(featureName, options) {
       "`--decision` must be one of: approve, changes_requested, blocked."
     );
   }
+  if (!explicitDecision && feature.prePrReview.decisionOutcome && feature.prePrReview.decisionOutcome !== "approve") {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      `Existing Pre-PR decision is "${feature.prePrReview.decisionOutcome}". Re-run with explicit --decision to avoid replaying the previous non-approve decision.`
+    );
+  }
   const decision = explicitDecision || feature.prePrReview.decisionOutcome || "approve";
   if (!policy.decisionEnum.includes(decision)) {
     throw createCliError(
@@ -14216,12 +14755,21 @@ async function runPrePrReview(featureName, options) {
   }
   const note = options.note?.trim() || (decision === "approve" ? "baseline review completed" : decision === "changes_requested" ? "follow-up changes are required before PR creation" : "blocked until prerequisite risk is resolved");
   let evidenceObj;
+  let reviewScope = createFallbackReviewScope();
+  if (policy.enforceExecutionEvidence && !options.evidence) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      "`--evidence <path>` is required when workflow.prePrReview.enforceExecutionEvidence=true."
+    );
+  }
   if (options.evidence) {
     const validator = new PrePrReviewValidator(ctx);
-    evidenceObj = await validator.validateEvidence(
+    const validationResult = await validator.validateEvidenceWithScope(
       options.evidence,
       process.cwd()
     );
+    evidenceObj = validationResult.evidence;
+    reviewScope = validationResult.scope;
   } else if (policy.evidenceMode === "path_required") {
     throw createCliError(
       "INVALID_ARGUMENT",
@@ -14229,6 +14777,34 @@ async function runPrePrReview(featureName, options) {
     );
   } else {
     evidenceObj = DEFAULT_EVIDENCE_FOR_ANY_MODE;
+    const validator = new PrePrReviewValidator(ctx);
+    try {
+      reviewScope = await validator.collectReviewScope(process.cwd());
+    } catch {
+      reviewScope = createFallbackReviewScope();
+    }
+  }
+  if (policy.enforceExecutionEvidence) {
+    const normalizedCommands = evidenceObj.commandsExecuted.map((entry) => normalizeShellLikeCommand(entry)).filter(Boolean);
+    if (normalizedCommands.length === 0) {
+      throw createCliError(
+        "VALIDATION_FAILED",
+        "Evidence must include non-empty commandsExecuted entries when workflow.prePrReview.enforceExecutionEvidence=true."
+      );
+    }
+    if (policy.executionCommandPrefixes.length > 0) {
+      const hasMatchedPrefix = normalizedCommands.some(
+        (cmd) => policy.executionCommandPrefixes.some(
+          (prefix) => cmd.toLowerCase().startsWith(normalizeShellLikeCommand(prefix).toLowerCase())
+        )
+      );
+      if (!hasMatchedPrefix) {
+        throw createCliError(
+          "VALIDATION_FAILED",
+          `Evidence commandsExecuted must include at least one command starting with workflow.prePrReview.executionCommandPrefixes: ${policy.executionCommandPrefixes.join(", ")}`
+        );
+      }
+    }
   }
   const decisionsPath = path12.join(feature.path, "decisions.md");
   const decisionLogEntry = buildReportContent({
@@ -14238,7 +14814,8 @@ async function runPrePrReview(featureName, options) {
     note,
     fallback: policy.fallback,
     skills: policy.skills,
-    evidence: evidenceObj
+    evidence: evidenceObj,
+    scope: reviewScope
   });
   const decisionsContent = await fs.pathExists(decisionsPath) ? await fs.readFile(decisionsPath, "utf-8") : "";
   const nextDecisions = appendDecisionLog(decisionsContent, decisionLogEntry);
@@ -14285,6 +14862,7 @@ async function runPrePrReview(featureName, options) {
           decisionsPath: normalizePathForDoc(decisionsPath),
           evidencePath,
           decision,
+          reviewScope,
           tasksUpdated: nextTasks !== tasksContent
         },
         null,