lee-spec-kit 0.6.33 → 0.6.34

package/dist/index.js

@@ -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",
@@ -636,6 +640,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."
@@ -648,6 +655,7 @@ var koWarnings = {
   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 +1049,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",
@@ -1165,6 +1177,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."
@@ -1177,6 +1192,7 @@ var enWarnings = {
   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`)",
@@ -3163,6 +3179,7 @@ var ACTION_CATEGORIES = [
   "pre_pr_review",
   "pr_status_update",
   "code_review",
+  "feature_scope_split",
   "worktree_cleanup",
   "user_request_replan",
   "feature_done",
@@ -4575,6 +4592,52 @@ 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 withUserRequestReplanOption(actions, lang) {
   if (actions.some((action) => action.category === "user_request_replan")) {
     return actions;
@@ -4594,8 +4657,13 @@ 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 currentActions = withUserRequestReplanOption(
+        actionsWithScopeSplit,
         lang
       );
       const actions = applyApprovalPolicy(
@@ -4843,6 +4911,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, "\\$&");
 }
@@ -5466,6 +5545,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;
@@ -5514,6 +5594,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;
@@ -5701,6 +5787,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"));
@@ -5835,6 +5931,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 +6055,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,
@@ -6966,12 +7086,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 +7108,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 +7129,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 +7147,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 +7238,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 +14009,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 +14068,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 +14110,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 +14131,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)
+    };
   }
 };
 
@@ -14106,6 +14342,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 +14357,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()}
@@ -14216,12 +14472,15 @@ 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 (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 +14488,12 @@ 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();
+    }
   }
   const decisionsPath = path12.join(feature.path, "decisions.md");
   const decisionLogEntry = buildReportContent({
@@ -14238,7 +14503,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 +14551,7 @@ async function runPrePrReview(featureName, options) {
           decisionsPath: normalizePathForDoc(decisionsPath),
           evidencePath,
           decision,
+          reviewScope,
           tasksUpdated: nextTasks !== tasksContent
         },
         null,