lee-spec-kit 0.6.42 → 0.7.0

package/dist/index.js

@@ -468,7 +468,8 @@ var koContext = {
   "context.suggestionCommandHint": "\uB77C\uBCA8 \uCC38\uACE0 \uBA85\uB839: {command}",
   "context.suggestionFinalPrompt": "\uD604\uC7AC \uCD94\uCC9C \uB77C\uBCA8: {labels}. \uC751\uB2F5\uC740 \uB77C\uBCA8 \uD1A0\uD070 \uD3EC\uD568 \uD615\uC2DD\uC73C\uB85C \uD574\uC8FC\uC138\uC694. (\uC608: {example}, `A \uC9C4\uD589\uD574`)",
   "context.autoRunUnavailable": "\uD604\uC7AC \uCEE8\uD14D\uC2A4\uD2B8\uC5D0\uC11C\uB294 \uC790\uB3D9 \uC2E4\uD589\uC744 \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
-  "context.autoRunSummary": "config \uAE30\uC900\uC73C\uB85C \uC2B9\uC778 \uD544\uC694 \uCE74\uD14C\uACE0\uB9AC \uC804\uAE4C\uC9C0 \uC5F0\uC18D \uC2E4\uD589\uD558\uC138\uC694: {categories}",
+  "context.autoRunSummary": "config \uAE30\uC900\uC73C\uB85C \uD604\uC7AC \uBC14\uB85C \uC790\uB3D9 \uC2E4\uD589\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC2B9\uC778 \uD544\uC694 \uCE74\uD14C\uACE0\uB9AC \uC804\uAE4C\uC9C0 \uC5F0\uC18D \uC2E4\uD589\uD558\uC138\uC694: {categories}",
+  "context.autoRunManualBoundary": "\uC790\uB3D9 \uC2E4\uD589 \uC124\uC815\uC740 \uAC00\uB2A5\uD558\uC9C0\uB9CC, \uD604\uC7AC \uB2E8\uACC4\uB294 \uBA3C\uC800 \uC218\uB3D9\uC73C\uB85C \uCC98\uB9AC\uD574\uC57C \uD569\uB2C8\uB2E4: {detail}",
   "context.autoRunCommandHint": "\uC790\uB3D9 \uC2E4\uD589 \uBA85\uB839(config \uAC8C\uC774\uD2B8): {command}",
   "context.subAgentOrchestrationHint": "\uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC804\uCCB4 \uD750\uB984\uACFC \uC2B9\uC778\uC744 \uAD00\uB9AC\uD569\uB2C8\uB2E4. \uD604\uC7AC \uB2E8\uACC4\uC758 owner\uAC00 `subagent`\uBA74 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uC5D0 \uB9E1\uAE30\uACE0, `main`\uC774\uBA74 \uBA54\uC778\uC5D0\uC11C \uC9C4\uD589\uD558\uC138\uC694.",
   "context.commandDetail.branchCreateWithWorktree": "({scope}) worktree {worktree}\uB97C \uC0AC\uC6A9\uD574 \uBE0C\uB79C\uCE58 {branch}\uB97C \uC0DD\uC131\uD558\uAC70\uB098 \uC7AC\uC0AC\uC6A9\uD558\uC138\uC694",
@@ -476,9 +477,9 @@ var koContext = {
   "context.commandDetail.branchCreateGeneric": "({scope}) feature \uBE0C\uB79C\uCE58\uC6A9 worktree\uB97C \uC0DD\uC131\uD558\uAC70\uB098 \uC7AC\uC0AC\uC6A9\uD558\uC138\uC694",
   "context.commandDetail.codeReviewMergeAfterOk": "({scope}) \uBA85\uC2DC\uC801 \uC2B9\uC778 \uD6C4 PR\uC744 \uBA38\uC9C0\uD558\uC138\uC694",
   "context.commandDetail.codeReviewPushFix": "({scope}) \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 push\uD558\uC138\uC694",
-  "context.commandDetail.prePrReviewRun": "({scope}) \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C PR \uC804 \uB9AC\uBDF0\uB97C \uC2E4\uD589\uD574 `review-trace.json`\uC744 \uC900\uBE44\uD558\uC138\uC694",
+  "context.commandDetail.prePrReviewRun": "({scope}) \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) PR \uC804 \uB9AC\uBDF0 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. \uC0C1\uD0DC \uC804\uC9C4\uC744 \uC704\uD574 evidence\uB294 \uBCC4\uB3C4\uB85C \uAE30\uB85D\uD574\uC57C \uD569\uB2C8\uB2E4",
   "context.commandDetail.prePrReviewRecord": "({scope}) Pre-PR \uB9AC\uBDF0 evidence\uB97C decisions.md\uC640 tasks.md\uC5D0 \uAE30\uB85D\uD558\uC138\uC694",
-  "context.commandDetail.codeReviewRun": "({scope}) \uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778\uD558\uACE0, \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C \uC218\uC815 \uC791\uC5C5/evidence \uC815\uB9AC\uB97C \uC9C4\uD589\uD558\uC138\uC694",
+  "context.commandDetail.codeReviewRun": "({scope}) \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uB9AC\uBDF0 \uC218\uC815 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. delegated work \uD6C4 PR Review Evidence/Decision\uC744 \uAE30\uB85D\uD574\uC57C \uB2E4\uC74C\uC73C\uB85C \uC9C4\uD589\uB429\uB2C8\uB2E4",
   "context.actionSummary.runDocsCommand": "\uBB38\uC11C \uC791\uC5C5 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uC138\uC694",
   "context.actionSummary.runProjectCommand": "\uD504\uB85C\uC81D\uD2B8 \uC791\uC5C5 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uC138\uC694",
   "context.actionDetail.featureFolder": "Feature \uD3F4\uB354\uC640 \uAE30\uBCF8 \uBB38\uC11C \uACE8\uACA9\uC744 \uC900\uBE44\uD558\uC138\uC694",
@@ -497,11 +498,12 @@ var koContext = {
   "context.actionDetail.issueCreateFromDoc": "Ready \uC0C1\uD0DC issue.md\uB85C \uC774\uC288\uB97C \uC0DD\uC131\uD558\uACE0 \uBC88\uD638\uB97C \uB3D9\uAE30\uD654\uD558\uC138\uC694",
   "context.actionDetail.taskExecute": "\uD604\uC7AC \uD0DC\uC2A4\uD06C\uB97C \uC9C4\uD589\uD558\uC138\uC694",
   "context.actionDetail.taskExecuteRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD558\uACE0 \uD0DC\uC2A4\uD06C\uB97C \uC2DC\uC791\uD558\uC138\uC694: {task}. (TODO\uBA74 DOING\uC73C\uB85C \uBCC0\uACBD)",
-  "context.actionDetail.taskExecuteContinue": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD574 \uC9C4\uD589 \uC911\uC778 \uD0DC\uC2A4\uD06C\uB97C \uC774\uC5B4\uAC00\uC138\uC694: {task}",
+  "context.actionDetail.taskExecuteContinue": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC791\uC5C5 handoff\uB97C \uC900\uBE44\uD574 \uC9C4\uD589 \uC911\uC778 \uD0DC\uC2A4\uD06C\uB97C \uB9C8\uBB34\uB9AC\uD558\uC138\uC694: {task}. (\uC644\uB8CC \uD6C4 \uACB0\uACFC/\uAC80\uC99D\uC744 \uACF5\uC720\uD558\uACE0 DONE\uC73C\uB85C \uBCC0\uACBD)",
+  "context.actionDetail.taskExecuteComplete": "\uD604\uC7AC \uD0DC\uC2A4\uD06C\uB97C \uC644\uB8CC \uCC98\uB9AC\uD558\uC138\uC694: {task}. (DOING\uC744 DONE\uC73C\uB85C \uBCC0\uACBD)",
   "context.actionDetail.reviewFixCommit": "\uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9 \uC694\uC57D\uC73C\uB85C \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uB9CC\uB4DC\uC138\uC694",
-  "context.actionDetail.prePrReviewRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C PR \uC804 \uB9AC\uBDF0\uB97C \uC2E4\uD589\uD574 `review-trace.json`\uC744 \uC900\uBE44\uD558\uC138\uC694",
+  "context.actionDetail.prePrReviewRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) PR \uC804 \uB9AC\uBDF0 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. \uC0C1\uD0DC \uC804\uC9C4\uC744 \uC704\uD574 evidence\uB294 \uBCC4\uB3C4\uB85C \uAE30\uB85D\uD574\uC57C \uD569\uB2C8\uB2E4",
   "context.actionDetail.prePrReviewRecord": "PR \uC804 \uB9AC\uBDF0 evidence\uB97C decisions.md\uC640 tasks.md\uC5D0 \uAE30\uB85D\uD558\uC138\uC694",
-  "context.actionDetail.codeReviewRun": "\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778\uD558\uACE0, \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C \uC218\uC815 \uC791\uC5C5/evidence \uC815\uB9AC\uB97C \uC9C4\uD589\uD558\uC138\uC694",
+  "context.actionDetail.codeReviewRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uB9AC\uBDF0 \uC218\uC815 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. delegated work \uD6C4 PR Review Evidence/Decision\uC744 \uAE30\uB85D\uD574\uC57C \uB2E4\uC74C\uC73C\uB85C \uC9C4\uD589\uB429\uB2C8\uB2E4",
   "context.actionDetail.prCreate": "PR\uC744 \uC0DD\uC131\uD558\uACE0 tasks \uAE30.md\uC758 PR \uC815\uBCF4\uB97C \uB9DE\uCD94\uC138\uC694",
   "context.actionDetail.prCreateRequiredSequence": "PR 2\uB2E8\uACC4(\uCD08\uC548/\uC2B9\uC778 \uD6C4 \uC0DD\uC131/\uB3D9\uAE30\uD654)\uB97C \uC21C\uC11C\uB300\uB85C \uC644\uB8CC\uD558\uC138\uC694",
   "context.actionDetail.prCreatePrepareFromDoc": "pr.md \uCD08\uC548\uC744 \uBCF4\uC644\uD558\uACE0 \uC0C1\uD0DC\uB97C Ready\uB85C \uC124\uC815\uD558\uC138\uC694",
@@ -623,8 +625,9 @@ var koMessages = {
   taskCommitGateReasonDoneCount: "\uCD5C\uC2E0 tasks.md \uCEE4\uBC0B\uC5D0\uC11C DONE \uC804\uD658\uC774 {count}\uAC74 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4",
   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)",
+  prePrReviewFieldMissing: "tasks.md\uC5D0 `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uC804 \uB9AC\uBDF0**: Pending | Running | 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 `spec.md`/`plan.md`/`tasks.md` \uB300\uBE44 \uAD6C\uD604 \uC801\uD569\uC131\uC744 \uAC80\uD1A0\uD558\uACE0, `Summary`/`Feature Intent Summary`/`Implementation Fit`/`Missing Cases`/`Spec Alignment Checked`/`Finding Count`/`Blocking Findings`/`Findings`/`Residual Risks`\uAC00 \uD3EC\uD568\uB41C `review-trace.json`\uC744 \uC0DD\uC131\uD55C \uB4A4 `pre-pr-review`\uB85C \uB9AC\uBDF0 \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694. `pre-pr-review-run` \uC790\uCCB4\uB294 evidence\uB97C \uC0DD\uC131\uD558\uAC70\uB098 \uC0C1\uD0DC\uB97C \uBC14\uB85C \uB118\uAE30\uC9C0 \uC54A\uC73C\uBA70, \uD604\uC7AC evidence \uC815\uCC45\uC774 \uACBD\uB85C\uB97C \uC694\uAD6C\uD560 \uB54C\uB9CC `--evidence review-trace.json`\uC744 \uD568\uAED8 \uC0AC\uC6A9\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
+  prePrReviewRunning: "Pre-PR \uB9AC\uBDF0 handoff\uAC00 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. delegated review\uB97C \uB9C8\uCE58\uACE0 `review-trace.json`\uC744 \uB9CC\uB4E0 \uB4A4 `pre-pr-review`\uB85C \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`/`Feature Intent Summary`/`Implementation Fit`/`Missing Cases`/`Spec Alignment Checked`/`Finding Count`/`Blocking Findings`/`Decision`/`Findings`(\uB610\uB294 \uBA85\uC2DC\uC801 `0 findings`)/`Residual Risks`\uB97C \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)",
   prePrReviewFixRequired: "\uD604\uC7AC `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 `{decision}`\uC785\uB2C8\uB2E4. PR \uC0DD\uC131 \uB2E8\uACC4\uB85C \uC774\uB3D9\uD558\uAE30 \uC804\uC5D0 pre-PR \uC9C0\uC801\uC0AC\uD56D\uC744 \uCF54\uB4DC\uC5D0 \uBC18\uC601\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
@@ -633,6 +636,7 @@ var koMessages = {
   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)",
   prReviewDecisionMissing: "tasks.md\uC758 `PR \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)",
+  prReviewRunning: "PR \uB9AC\uBDF0 handoff\uAC00 \uC774\uBBF8 \uC9C4\uD589 \uC911\uC785\uB2C8\uB2E4. delegated review/fix \uC791\uC5C5\uC744 \uB9C8\uCE5C \uB4A4 `PR \uB9AC\uBDF0 Evidence`\uC640 `PR \uB9AC\uBDF0 Decision`\uC744 \uCD5C\uC2E0\uC73C\uB85C \uAE30\uB85D\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
   prCreate: "PR \uBCF8\uBB38 \uD15C\uD50C\uB9BF\uC744 \uC0DD\uC131\uD574 \uBCC0\uACBD \uC0AC\uD56D/\uD14C\uC2A4\uD2B8 \uC139\uC158\uC744 \uAC80\uD1A0\xB7\uBCF4\uC644\uD558\uACE0, \uBA85\uC2DC\uC801 \uC9C4\uD589 \uC2B9\uC778(\uB77C\uBCA8 \uC81C\uACF5) \uD6C4 PR\uC744 \uC0DD\uC131\uD558\uC138\uC694. \uC774\uD6C4 tasks.md\uC5D0 PR \uB9C1\uD06C\uB97C \uAE30\uB85D\uD558\uC138\uC694.",
   prCreatePrepareFromDoc: "`pr.md`\uB97C \uAE30\uC900\uC73C\uB85C PR \uC81C\uBAA9/\uBCF8\uBB38/\uB77C\uBCA8 \uCD08\uC548\uC744 \uBCF4\uC644\uD558\uACE0 \uC9C4\uD589 \uC2B9\uC778\uC744 \uBC1B\uC544 \uD655\uC778 \uD6C4 \uC0C1\uD0DC\uB97C `Ready`\uB85C \uBCC0\uACBD\uD558\uC138\uC694.",
   prCreateExecuteFromDoc: "`pr.md` \uC0C1\uD0DC\uAC00 `Ready`\uC774\uBA74 PR\uC744 \uC0DD\uC131\uD558\uACE0, \uC0DD\uC131\uB41C PR \uB9C1\uD06C/PR \uC0C1\uD0DC\uB97C `tasks.md`\uC5D0 \uAE30\uB85D\uD558\uC138\uC694. (`pr.md`\uB294 \uC0C1\uD0DC `Ready`\uB9CC \uC720\uC9C0)",
@@ -673,7 +677,7 @@ var koWarnings = {
   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`)",
+  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 | Running | Done`)",
   legacyTasksPrePrEvidenceField: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. PR \uB2E8\uACC4 \uC804\uC5D0 `PR \uC804 \uB9AC\uBDF0 Evidence` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
   legacyTasksPrePrDecisionField: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. PR \uB2E8\uACC4 \uC804\uC5D0 `PR \uC804 \uB9AC\uBDF0 Decision` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694. (`- **PR \uC804 \uB9AC\uBDF0 Decision**: \uACB0\uC815: ...`)",
   legacyTasksPrReviewEvidenceField: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. \uB9AC\uBDF0 \uB2E8\uACC4 \uC804\uC5D0 `PR \uB9AC\uBDF0 Evidence` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
@@ -690,7 +694,7 @@ var koWarnings = {
   workflowPrRemoteChangesRequested: "\uC6D0\uACA9 PR\uC5D0\uC11C \uBCC0\uACBD \uC694\uCCAD \uB610\uB294 \uCD94\uAC00 \uB9AC\uBDF0\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uCF54\uBA58\uD2B8 \uBC18\uC601 \uD6C4 push\uD558\uACE0 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
   workflowPrRemoteChecksFailing: "\uC6D0\uACA9 PR \uCCB4\uD06C \uC2E4\uD328\uAC00 {count}\uAC74 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC2E4\uD328 \uC6D0\uC778\uC744 \uD574\uACB0 \uD6C4 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
   workflowPrRemoteChecksPending: "\uC6D0\uACA9 PR \uCCB4\uD06C \uB300\uAE30\uAC00 {count}\uAC74 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uCCB4\uD06C \uC644\uB8CC \uD6C4 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
-  workflowPrePrReviewMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (tasks.md\uC5D0 `- **PR \uC804 \uB9AC\uBDF0**: Pending | Done`\uC744 \uCD94\uAC00\uD558\uC138\uC694.)",
+  workflowPrePrReviewMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (tasks.md\uC5D0 `- **PR \uC804 \uB9AC\uBDF0**: Pending | Running | Done`\uC744 \uCD94\uAC00\uD558\uC138\uC694.)",
   workflowPrePrReviewNotDone: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC `PR \uC804 \uB9AC\uBDF0`\uAC00 Done\uC774 \uC544\uB2D9\uB2C8\uB2E4. (\uC0AC\uC804 \uCF54\uB4DC\uB9AC\uBDF0 \uD6C4 Done\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.)",
   workflowPrePrEvidenceMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC `PR \uC804 \uB9AC\uBDF0 Evidence`\uAC00 \uBE44\uC5B4\uC788\uAC70\uB098 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (`Pre-PR Review Log`/`PR \uC804 \uB9AC\uBDF0 \uB85C\uADF8`\uC5D0 placeholder\uAC00 \uC544\uB2CC `Summary`/`Feature Intent Summary`/`Implementation Fit`/`Missing Cases`/`Spec Alignment Checked`/`Finding Count`/`Blocking Findings`/`Decision`/`Findings`(\uB610\uB294 \uBA85\uC2DC\uC801 `0 findings`)/`Residual Risks`\uAC00 \uC788\uB294 \uC2E4\uC81C \uACBD\uB85C\uB97C \uAE30\uB85D\uD558\uC138\uC694.)",
   workflowPrePrDecisionMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC `PR \uC804 \uB9AC\uBDF0 Decision`\uC774 \uBE44\uC5B4\uC788\uAC70\uB098 \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (`decision: approve|changes_requested|blocked ...` \uD615\uC2DD)",
@@ -1020,7 +1024,8 @@ var enContext = {
   "context.suggestionCommandHint": "Reference command: {command}",
   "context.suggestionFinalPrompt": "Recommended labels now: {labels}. Please reply with a format that includes a label token. (e.g. {example}, `A proceed`)",
   "context.autoRunUnavailable": "Auto-run is not available in the current context.",
-  "context.autoRunSummary": "Run continuously by config until approval-required categories appear: {categories}",
+  "context.autoRunSummary": "Auto-run can execute now by config until approval-required categories appear: {categories}",
+  "context.autoRunManualBoundary": "Auto-run is configured, but the current step must be handled manually first: {detail}",
   "context.autoRunCommandHint": "Auto-run command (config-based gate): {command}",
   "context.subAgentOrchestrationHint": "The main agent manages overall flow and approvals. If the current state owner is `subagent`, hand execution to a helper agent; if it is `main`, keep it in the main agent.",
   "context.commandDetail.branchCreateWithWorktree": "({scope}) create or reuse worktree {worktree} for branch {branch}",
@@ -1028,9 +1033,9 @@ var enContext = {
   "context.commandDetail.branchCreateGeneric": "({scope}) create or reuse feature branch worktree",
   "context.commandDetail.codeReviewMergeAfterOk": "({scope}) merge PR after explicit OK",
   "context.commandDetail.codeReviewPushFix": "({scope}) push review-fix commits",
-  "context.commandDetail.prePrReviewRun": "({scope}) run the pre-PR review via a helper agent/sub-agent and prepare `review-trace.json`",
+  "context.commandDetail.prePrReviewRun": "({scope}) prepare a helper agent/sub-agent pre-PR review handoff; record evidence separately to advance state",
   "context.commandDetail.prePrReviewRecord": "({scope}) record pre-PR review evidence into decisions.md + tasks.md",
-  "context.commandDetail.codeReviewRun": "({scope}) check PR review comments, then use a helper agent/sub-agent for the follow-up fixes and evidence summary",
+  "context.commandDetail.codeReviewRun": "({scope}) prepare a helper agent/sub-agent review-fix handoff only; update PR Review Evidence/Decision after the delegated work",
   "context.actionSummary.runDocsCommand": "Run docs command",
   "context.actionSummary.runProjectCommand": "Run project command",
   "context.actionDetail.featureFolder": "Prepare feature folder and baseline docs",
@@ -1049,11 +1054,12 @@ var enContext = {
   "context.actionDetail.issueCreateFromDoc": "Create GitHub Issue from ready issue.md and sync Issue",
   "context.actionDetail.taskExecute": "Proceed with the current task",
   "context.actionDetail.taskExecuteRun": "Prepare helper agent/sub-agent task handoff and start the task: {task}. (TODO becomes DOING)",
-  "context.actionDetail.taskExecuteContinue": "Prepare helper agent/sub-agent handoff and continue the in-progress task: {task}",
+  "context.actionDetail.taskExecuteContinue": "Prepare helper agent/sub-agent handoff and wrap up the in-progress task: {task}. (Share outcome/verification, then mark it DONE)",
+  "context.actionDetail.taskExecuteComplete": "Mark the current task as complete: {task}. (Change DOING to DONE)",
   "context.actionDetail.reviewFixCommit": "Create a review-fix commit with resolved feedback summary",
-  "context.actionDetail.prePrReviewRun": "Run the pre-PR review via a helper agent/sub-agent and prepare `review-trace.json`",
+  "context.actionDetail.prePrReviewRun": "Prepare a helper agent/sub-agent pre-PR review handoff; record evidence separately to advance state",
   "context.actionDetail.prePrReviewRecord": "Record pre-PR review evidence into decisions.md and tasks.md",
-  "context.actionDetail.codeReviewRun": "Check PR review comments, then use a helper agent/sub-agent for the follow-up fixes and evidence summary",
+  "context.actionDetail.codeReviewRun": "Prepare a helper agent/sub-agent review-fix handoff only; update PR Review Evidence/Decision after the delegated work",
   "context.actionDetail.prCreate": "Create PR and sync PR fields in tasks.md",
   "context.actionDetail.prCreateRequiredSequence": "Complete PR 2-step flow: prepare draft + OK, then create and sync",
   "context.actionDetail.prCreatePrepareFromDoc": "Refine pr.md draft and set Status to Ready",
@@ -1175,8 +1181,9 @@ var enMessages = {
   taskCommitGateReasonDoneCount: "DONE transitions detected in the latest tasks.md commit ({count})",
   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)",
+  prePrReviewFieldMissing: "tasks.md is missing the `Pre-PR Review` field. Add `- **Pre-PR Review**: Pending | Running | Done` and run context again. (CHECK required)",
   prePrReviewRun: "Run the code review agent, compare the implementation against `spec.md`/`plan.md`/`tasks.md`, and generate `review-trace.json` with `Summary`, `Feature Intent Summary`, `Implementation Fit`, `Missing Cases`, `Spec Alignment Checked`, `Finding Count`, `Blocking Findings`, `Findings`, and `Residual Risks`. Then record findings with `pre-pr-review`; `pre-pr-review-run` itself does not generate evidence or advance state, and you should use `--evidence review-trace.json` only when the active evidence policy requires a path. (CHECK required)",
+  prePrReviewRunning: "Pre-PR review handoff is already in progress. Finish the delegated review, generate `review-trace.json`, then record the result with `pre-pr-review`. (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`, `Feature Intent Summary`, `Implementation Fit`, `Missing Cases`, `Spec Alignment Checked`, `Finding Count`, `Blocking Findings`, `Decision`, `Findings` (or explicit `0 findings`), and `Residual Risks`. (CHECK required)",
   prePrReviewDecisionMissing: "tasks.md `Pre-PR Decision` is empty/placeholder or missing decision format. Record it as `decision: ...` (or `\uACB0\uC815: ...`). (CHECK required)",
   prePrReviewFixRequired: "Current `Pre-PR Decision` is `{decision}`. Apply the requested fixes from pre-PR findings before moving to PR creation. (CHECK required)",
@@ -1185,6 +1192,7 @@ var enMessages = {
   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)",
   prReviewDecisionMissing: "tasks.md `PR Review Decision` is empty/placeholder or missing decision format. Record it as `decision: ...` (or `\uACB0\uC815: ...`). (CHECK required)",
+  prReviewRunning: "PR review handoff is already in progress. Complete the delegated review/fix work, then update `PR Review Evidence` and `PR Review Decision`. (CHECK required)",
   prCreate: "Generate the PR body template, refine changes/tests sections, get explicit progress approval (label), create the PR, then record the PR link in tasks.md.",
   prCreatePrepareFromDoc: "Use `pr.md` to refine PR title/body/labels draft, get explicit progress approval, then set status to `Ready`.",
   prCreateExecuteFromDoc: "When `pr.md` status is `Ready`, create the PR and record the PR link/status in `tasks.md`. (Keep only `pr.md` status as `Ready`.)",
@@ -1225,7 +1233,7 @@ var enWarnings = {
   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`)",
+  legacyTasksPrePrReviewField: "Legacy tasks.md format detected. Add `Pre-PR Review` before PR steps. (`- **Pre-PR Review**: Pending | Running | Done`)",
   legacyTasksPrePrEvidenceField: "Legacy tasks.md format detected. Add `Pre-PR Evidence` before PR steps.",
   legacyTasksPrePrDecisionField: "Legacy tasks.md format detected. Add `Pre-PR Decision` before PR steps. (`- **Pre-PR Decision**: decision: ...`)",
   legacyTasksPrReviewEvidenceField: "Legacy tasks.md format detected. Add `PR Review Evidence` before review iteration.",
@@ -1242,7 +1250,7 @@ var enWarnings = {
   workflowPrRemoteChangesRequested: "Remote PR shows changes requested or additional review required. Address comments, push, then re-check.",
   workflowPrRemoteChecksFailing: "Remote PR has {count} failing check(s). Fix failures, then re-check.",
   workflowPrRemoteChecksPending: "Remote PR has {count} pending check(s). Wait for checks to complete, then re-check.",
-  workflowPrePrReviewMissing: "Implementation is done but `Pre-PR Review` is missing. (Add `- **Pre-PR Review**: Pending | Done` in tasks.md.)",
+  workflowPrePrReviewMissing: "Implementation is done but `Pre-PR Review` is missing. (Add `- **Pre-PR Review**: Pending | Running | Done` in tasks.md.)",
   workflowPrePrReviewNotDone: "Implementation is done but `Pre-PR Review` is not Done. (Run pre-PR review, then update it to Done.)",
   workflowPrePrEvidenceMissing: "Implementation is done but `Pre-PR Evidence` is empty/invalid. (Point to an existing file and include `Pre-PR Review Log` with non-placeholder `Summary`, `Feature Intent Summary`, `Implementation Fit`, `Missing Cases`, `Spec Alignment Checked`, `Finding Count`, `Blocking Findings`, `Decision`, `Findings` (or explicit `0 findings`), and `Residual Risks`.)",
   workflowPrePrDecisionMissing: "Implementation is done but `Pre-PR Decision` is empty/invalid. (Use `decision: approve|changes_requested|blocked ...`.)",
@@ -3553,6 +3561,7 @@ function resolvePrePrReviewPolicy(workflow) {
 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.
+0. \uAC19\uC740 feature/pre-PR \uB9AC\uBDF0\uB97C \uB2F4\uB2F9\uD558\uB358 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC774\uBBF8 \uC788\uC73C\uBA74 \uC0C8\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0 \uC7AC\uC0AC\uC6A9\uD558\uC138\uC694. \uAE30\uBCF8\uC740 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 1\uAC1C\uC785\uB2C8\uB2E4.
 1. \`spec.md\`, \`plan.md\`, \`tasks.md\`\uB97C \uC77D\uACE0 feature \uBAA9\uD45C/\uBC94\uC704/\uC644\uB8CC \uAE30\uC900\uC744 \uBA3C\uC800 \uC694\uC57D\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'
@@ -3561,11 +3570,14 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 4. \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.
 5. \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.
 6. \uC6B0\uC120\uC21C\uC704 \uC2A4\uD0AC: ${skills.length > 0 ? skills.join(", ") : "\uC5C6\uC74C"} \uB85C \uC2EC\uD654 \uAC80\uD1A0\uB97C \uC9C4\uD589\uD558\uC138\uC694.
-7. \uCD94\uAC00 \uAC80\uC99D\uC774 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC audit/\uD0C0\uAE43 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uACE0, \uC2E4\uD589\uD588\uB2E4\uBA74 \`commandsExecuted\`\uC5D0 \uAE30\uB85D\uD558\uC138\uC694.
-8. \uC9C0\uC801\uC0AC\uD56D\uC774 \uB0A8\uC544 \uC788\uC73C\uBA74 \uBA3C\uC800 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested' \uB85C \uAE30\uB85D\uD558\uC138\uC694. \uB2E8, \`workflow.prePrReview.evidenceMode=any\` \uC774\uACE0 \uC2E4\uD589 \uC99D\uAC70 \uAC15\uC81C\uAC00 \uC5C6\uC73C\uBA74 \`--evidence\` \uC5C6\uC774 \uC9C1\uC811 \uAE30\uB85D\uD574\uB3C4 \uB429\uB2C8\uB2E4.
-9. \uC218\uC815/\uC7AC\uAC80\uC99D \uD6C4 \uCD5C\uC885 \uC2B9\uC778 \uC2DC\uC810\uC5D0 'npx lee-spec-kit pre-pr-review <feature> --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694. \`path_required\` \uC815\uCC45\uC77C \uB54C\uB9CC \`--evidence review-trace.json\` \uC744 \uD568\uAED8 \uBD99\uC774\uC138\uC694.`;
+7. \uCD94\uAC00 \uAC80\uC99D\uC774 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC audit/\uD0C0\uAE43 \uBA85\uB839\uC744 \uC2E4\uD589\uD558\uC138\uC694. \uBCC4\uB3C4 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uCD94\uAC00 \uC0DD\uC131\uB3C4 \uAF2D \uD544\uC694\uD560 \uB54C\uB9CC \uD558\uC138\uC694.
+8. \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uB9AC\uBDF0\uB97C \uC774\uC5B4\uAC00\uACE0, \uC774\uBBF8 \uC218\uC9D1\uD55C \uACB0\uACFC\uB9CC \uC815\uB9AC\uD574\uB3C4 \uB429\uB2C8\uB2E4.
+9. \uC2E4\uD589\uD55C \uBA85\uB839\uC774 \uC788\uC73C\uBA74 \`commandsExecuted\`\uC5D0 \uAE30\uB85D\uD558\uC138\uC694.
+10. \uC9C0\uC801\uC0AC\uD56D\uC774 \uB0A8\uC544 \uC788\uC73C\uBA74 \uBA3C\uC800 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested' \uB85C \uAE30\uB85D\uD558\uC138\uC694. \uB2E8, \`workflow.prePrReview.evidenceMode=any\` \uC774\uACE0 \uC2E4\uD589 \uC99D\uAC70 \uAC15\uC81C\uAC00 \uC5C6\uC73C\uBA74 \`--evidence\` \uC5C6\uC774 \uC9C1\uC811 \uAE30\uB85D\uD574\uB3C4 \uB429\uB2C8\uB2E4.
+11. \uC218\uC815/\uC7AC\uAC80\uC99D \uD6C4 \uCD5C\uC885 \uC2B9\uC778 \uC2DC\uC810\uC5D0 'npx lee-spec-kit pre-pr-review <feature> --decision approve' \uB97C \uC2E4\uD589\uD558\uC138\uC694. \`path_required\` \uC815\uCC45\uC77C \uB54C\uB9CC \`--evidence review-trace.json\` \uC744 \uD568\uAED8 \uBD99\uC774\uC138\uC694.`;
   }
   return `Conduct a pre-PR code review.
+0. Reuse the existing helper/sub-agent for this feature review if one already exists. Default to a single helper agent.
 1. Read \`spec.md\`, \`plan.md\`, and \`tasks.md\` first, then summarize the feature goal, scope, and done criteria.
 2. Split and check the review scope.
    - Main scope: 'git diff --name-only $(git merge-base HEAD origin/main)..HEAD'
@@ -3574,15 +3586,17 @@ function getPrePrReviewPrompt(lang, skills, fallbackText) {
 4. Generate a 'review-trace.json' file for all changed files, including \`findingCount\`, \`blockingFindings\`, evaluations for risk, security, perf, maintainability, and specific fileLine locators.
 5. The baseline is '${fallbackText}'. Always perform the 'Pre-PR Core Checklist' section of the 'create-pr' document.
 6. Priority skills: ${skills.length > 0 ? skills.join(", ") : "None"} for deeper technical review.
-7. Run extra audit/targeted verification only when the review needs more evidence, and record those commands in \`commandsExecuted\` when used.
-8. If unresolved findings remain, first record them with 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested'. When \`workflow.prePrReview.evidenceMode=any\` and execution evidence is not enforced, direct record mode without \`--evidence\` is also valid.
-9. After fixes and re-validation, run 'npx lee-spec-kit pre-pr-review <feature> --decision approve' for final pre-PR approval. Add \`--evidence review-trace.json\` only when the active evidence policy requires a path.`;
+7. Run extra audit/targeted verification only when the review truly needs more evidence. Spawn additional helper agents only when necessary.
+8. If helper-agent quota is exhausted, continue the review in the main agent and just keep the evidence consistent.
+9. Record commands in \`commandsExecuted\` only when you actually ran them.
+10. If unresolved findings remain, first record them with 'npx lee-spec-kit pre-pr-review <feature> --evidence review-trace.json --decision changes_requested'. When \`workflow.prePrReview.evidenceMode=any\` and execution evidence is not enforced, direct record mode without \`--evidence\` is also valid.
+11. After fixes and re-validation, run 'npx lee-spec-kit pre-pr-review <feature> --decision approve' for final pre-PR approval. Add \`--evidence review-trace.json\` only when the active evidence policy requires a path.`;
 }
 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.`;
+    return `\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD655\uC778/\uBD84\uC11D\uD55C \uB4A4 \uD544\uC694\uD55C \uC218\uC815\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uAE30\uC874 review \uB2F4\uB2F9 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694. \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uC774\uC5B4\uAC00\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.`;
   }
-  return `Review and analyze comments, then make necessary fixes. Keep PR status as Review and record the latest 'PR Review Evidence/Decision'. Push changes only after explicit approval (label) and only if the local branch is ahead of upstream.`;
+  return `Review and analyze comments, then make necessary fixes. Reuse the existing review helper agent if one already exists, and default to a single helper agent. If helper-agent quota is exhausted, continue in the main agent. Keep PR status as Review and record the latest 'PR Review Evidence/Decision'. Push changes only after explicit approval (label) and only if the local branch is ahead of upstream.`;
 }
 
 // src/utils/context/steps.ts
@@ -3621,7 +3635,7 @@ function isPrePrReviewSatisfied(feature, prePrReviewPolicy) {
   return true;
 }
 function isFeatureDone(feature, workflowPolicy, prePrReviewPolicy) {
-  return feature.specStatus === "Approved" && feature.planStatus === "Approved" && !feature.git.docsHasUncommittedChanges && !feature.git.projectHasUncommittedChanges && feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature) && (!workflowPolicy.requireIssue || !!feature.issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured(feature) && !!feature.pr.link) && (!workflowPolicy.requireMerge || feature.pr.status === "Approved") && isPrePrReviewSatisfied(feature, prePrReviewPolicy);
+  return feature.specStatus === "Approved" && feature.planStatus === "Approved" && !feature.git.docsHasCommitRequiredChanges && !feature.git.projectHasUncommittedChanges && feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature) && (!workflowPolicy.requireIssue || !!feature.issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured(feature) && !!feature.pr.link) && (!workflowPolicy.requireMerge || feature.pr.status === "Approved") && isPrePrReviewSatisfied(feature, prePrReviewPolicy);
 }
 function getPrReviewRemoteBlockReasons(feature, lang) {
   const remote = feature.pr.remote;
@@ -3694,6 +3708,13 @@ function buildTaskRunCommandArgs(feature, taskId) {
   }
   return commandArgs;
 }
+function buildTaskCompleteCommandArgs(feature, taskId) {
+  const commandArgs = ["task-complete", feature.folderName, "--task", taskId];
+  if (feature.type && feature.type !== "single") {
+    commandArgs.push("--component", feature.type);
+  }
+  return commandArgs;
+}
 function buildCodeReviewRunCommandArgs(feature) {
   const commandArgs = ["code-review-run", feature.folderName];
   if (feature.type && feature.type !== "single") {
@@ -3849,7 +3870,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   if (!diff.trim()) return 0;
   const removedByTask = /* @__PURE__ */ new Map();
   const addedByTask = /* @__PURE__ */ new Map();
-  const parseTaskLine2 = (line) => {
+  const parseTaskLine3 = (line) => {
     const match = line.match(
       /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\s+(.+?)\s*$/i
     );
@@ -3864,7 +3885,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   for (const line of diff.split("\n")) {
     if (line.startsWith("---") || line.startsWith("+++")) continue;
     if (line.startsWith("-")) {
-      const parsed = parseTaskLine2(line.slice(1));
+      const parsed = parseTaskLine3(line.slice(1));
       if (!parsed) continue;
       const existing = removedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -3872,7 +3893,7 @@ function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
       continue;
     }
     if (line.startsWith("+")) {
-      const parsed = parseTaskLine2(line.slice(1));
+      const parsed = parseTaskLine3(line.slice(1));
       if (!parsed) continue;
       const existing = addedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
       existing.add(parsed.status);
@@ -3953,7 +3974,7 @@ function getStepDefinitions(ctx) {
   const isTaskExecuteCurrent = (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);
   const isTaskExecuteWorktreeBlocked = (f) => isTaskExecuteCurrent(f) && workflowPolicy.requireWorktree && f.tasks.done < f.tasks.total && !!f.issueNumber && !f.git.projectInManagedWorktree;
   const isTaskExecuteFinalize = (f) => isTaskExecuteCurrent(f) && f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f);
-  const isTaskExecuteCommitPending = (f) => isTaskExecuteCurrent(f) && (isTaskExecuteFinalize(f) && (f.git.docsHasUncommittedChanges || f.git.projectHasUncommittedChanges) || !!f.nextTodoTask && (f.git.docsHasUncommittedChanges || f.git.projectHasUncommittedChanges));
+  const isTaskExecuteCommitPending = (f) => isTaskExecuteCurrent(f) && (isTaskExecuteFinalize(f) && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges) || !!f.nextTodoTask && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges));
   const isTaskExecuteStrictGateBlocked = (f) => {
     if (!isTaskExecuteCurrent(f) || !f.nextTodoTask) return false;
     if (taskCommitGatePolicy === "off" || !f.lastDoneTask || !f.git.docsGitCwd) {
@@ -4041,7 +4062,7 @@ function getStepDefinitions(ctx) {
     ];
   };
   const getTaskExecuteFinalizeActions = (f) => {
-    if (f.git.docsHasUncommittedChanges || f.git.projectHasUncommittedChanges) {
+    if (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges) {
       return getTaskExecuteCommitPendingActions(f);
     }
     const actions = [
@@ -4073,14 +4094,14 @@ function getStepDefinitions(ctx) {
       operationType: "local",
       requiresUserCheck: true,
       taskExecutePhase: "complete",
-      uiDetailKey: "context.actionDetail.taskExecuteContinue",
+      uiDetailKey: "context.actionDetail.taskExecuteComplete",
       uiDetailParams: {
         task: resolveTaskUiLabel(f.activeTask)
       },
       scope: "docs",
       cwd: f.git.docsGitCwd,
       cmd: buildSelfCliCommand(
-        buildTaskRunCommandArgs(
+        buildTaskCompleteCommandArgs(
           f,
           f.activeTask?.id || `T-${f.folderName}-active`
         )
@@ -4088,7 +4109,7 @@ function getStepDefinitions(ctx) {
     }
   ];
   const getTaskExecuteCommitPendingActions = (f) => {
-    if (f.git.docsHasUncommittedChanges) {
+    if (f.git.docsHasCommitRequiredChanges) {
       return [
         {
           type: "command",
@@ -4213,10 +4234,10 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
       }
     ];
   };
-  const isPostTaskSyncCurrent = (f) => isImplementationDone(f) && (f.git.docsHasUncommittedChanges || f.git.projectHasUncommittedChanges);
-  const isPostTaskSyncDocs = (f) => isPostTaskSyncCurrent(f) && f.git.docsHasUncommittedChanges;
-  const isPostTaskSyncReviewFix = (f) => isPostTaskSyncCurrent(f) && !f.git.docsHasUncommittedChanges && f.git.projectHasUncommittedChanges && (isReviewIterationPhase(f, workflowPolicy) || isPrePrFixIterationPhase(f, workflowPolicy, prePrReviewPolicy));
-  const isPostTaskSyncProject = (f) => isPostTaskSyncCurrent(f) && !f.git.docsHasUncommittedChanges && f.git.projectHasUncommittedChanges && !isPostTaskSyncReviewFix(f);
+  const isPostTaskSyncCurrent = (f) => isImplementationDone(f) && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges);
+  const isPostTaskSyncDocs = (f) => isPostTaskSyncCurrent(f) && f.git.docsHasCommitRequiredChanges;
+  const isPostTaskSyncReviewFix = (f) => isPostTaskSyncCurrent(f) && !f.git.docsHasCommitRequiredChanges && f.git.projectHasUncommittedChanges && (isReviewIterationPhase(f, workflowPolicy) || isPrePrFixIterationPhase(f, workflowPolicy, prePrReviewPolicy));
+  const isPostTaskSyncProject = (f) => isPostTaskSyncCurrent(f) && !f.git.docsHasCommitRequiredChanges && f.git.projectHasUncommittedChanges && !isPostTaskSyncReviewFix(f);
   const getPostTaskSyncDocsActions = (f) => [
     {
       type: "command",
@@ -4288,10 +4309,11 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
       }
     ];
   };
-  const isPrePrReviewCurrent = (f) => prePrReviewPolicy.enabled && workflowPolicy.requirePr && f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && isCompletionChecklistDone(f) && !f.git.docsHasUncommittedChanges && !f.git.projectHasUncommittedChanges && (!isPrMetadataConfigured(f) || !f.pr.link) && !isPrePrReviewSatisfied(f, prePrReviewPolicy);
+  const isPrePrReviewCurrent = (f) => prePrReviewPolicy.enabled && workflowPolicy.requirePr && f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && isCompletionChecklistDone(f) && !f.git.docsHasCommitRequiredChanges && !f.git.projectHasUncommittedChanges && (!isPrMetadataConfigured(f) || !f.pr.link) && !isPrePrReviewSatisfied(f, prePrReviewPolicy);
   const isPrePrReviewMetadataMissing = (f) => isPrePrReviewCurrent(f) && !f.docs.prePrReviewFieldExists;
   const isPrePrReviewFixRequired = (f) => isPrePrReviewCurrent(f) && !!f.prePrReview.decisionOutcome && f.prePrReview.decisionOutcome !== "approve";
-  const isPrePrReviewRun = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && !resolvePrePrReviewEvidencePath(f) && (prePrReviewPolicy.evidenceMode === "path_required" || prePrReviewPolicy.enforceExecutionEvidence);
+  const isPrePrReviewRun = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status !== "Running" && !resolvePrePrReviewEvidencePath(f) && (prePrReviewPolicy.evidenceMode === "path_required" || prePrReviewPolicy.enforceExecutionEvidence);
+  const isPrePrReviewRunning = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && f.prePrReview.status === "Running" && !resolvePrePrReviewEvidencePath(f) && (prePrReviewPolicy.evidenceMode === "path_required" || prePrReviewPolicy.enforceExecutionEvidence);
   const isPrePrReviewRecord = (f) => isPrePrReviewCurrent(f) && f.docs.prePrReviewFieldExists && !isPrePrReviewFixRequired(f) && (!!resolvePrePrReviewEvidencePath(f) || prePrReviewPolicy.evidenceMode === "any" && !prePrReviewPolicy.enforceExecutionEvidence);
   const getPrePrReviewMetadataActions = () => [
     {
@@ -4336,6 +4358,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
       cmd: buildSelfCliCommand(buildPrePrReviewRunCommandArgs(f))
     }
   ];
+  const getPrePrReviewRunningActions = () => [
+    {
+      type: "instruction",
+      category: "pre_pr_review_run",
+      requiresUserCheck: false,
+      message: tr(lang, "messages", "prePrReviewRunning")
+    }
+  ];
   const getPrePrReviewRecordActions = (f) => {
     const evidencePath = resolvePrePrReviewEvidencePath(f);
     return [
@@ -4346,7 +4376,9 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
         requiresUserCheck: true,
         scope: "docs",
         cwd: f.git.docsGitCwd,
-        cmd: buildSelfCliCommand(buildPrePrReviewCommandArgs(f, evidencePath))
+        cmd: buildSelfCliCommand(
+          buildPrePrReviewCommandArgs(f, evidencePath ?? void 0)
+        )
       }
     ];
   };
@@ -4362,7 +4394,8 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
   const isCodeReviewNeedEvidence = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && !isCodeReviewNeedEvidenceField(f) && !f.prReview.evidenceProvided;
   const isCodeReviewNeedDecisionField = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && !isCodeReviewNeedEvidenceField(f) && f.prReview.evidenceProvided && !f.docs.prReviewDecisionFieldExists;
   const isCodeReviewNeedDecision = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && !isCodeReviewNeedEvidenceField(f) && f.prReview.evidenceProvided && !isCodeReviewNeedDecisionField(f) && !f.prReview.decisionProvided;
-  const isCodeReviewRun = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && (f.git.projectBranchAhead || 0) === 0 && !isCodeReviewNeedEvidenceField(f) && !f.prReview.evidenceProvided && !f.prReview.decisionProvided;
+  const isCodeReviewRun = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && (f.git.projectBranchAhead || 0) === 0 && f.prReview.status !== "Running" && !isCodeReviewNeedEvidenceField(f) && !f.prReview.evidenceProvided && !f.prReview.decisionProvided;
+  const isCodeReviewRunning = (f) => isCodeReviewCurrent(f) && f.pr.status === "Review" && workflowPolicy.requireReview && (f.git.projectBranchAhead || 0) === 0 && f.prReview.status === "Running" && !isCodeReviewNeedEvidenceField(f) && !f.prReview.evidenceProvided && !f.prReview.decisionProvided;
   const isCodeReviewFinalize = (f) => isCodeReviewCurrent(f) && !isCodeReviewSyncApproved(f) && (!workflowPolicy.requireReview || f.pr.status === "Review" && !isCodeReviewNeedEvidenceField(f) && !isCodeReviewNeedEvidence(f) && !isCodeReviewNeedDecisionField(f) && !isCodeReviewNeedDecision(f) && f.prReview.evidenceProvided && f.prReview.decisionProvided);
   const isCodeReviewRequestReview = (f) => isCodeReviewCurrent(f) && !!f.pr.status && f.pr.status !== "Review";
   const getCodeReviewRunActions = (f) => [
@@ -4376,6 +4409,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
       cmd: buildSelfCliCommand(buildCodeReviewRunCommandArgs(f))
     }
   ];
+  const getCodeReviewRunningActions = () => [
+    {
+      type: "instruction",
+      category: "code_review_run",
+      requiresUserCheck: false,
+      message: tr(lang, "messages", "prReviewRunning")
+    }
+  ];
   const getCodeReviewFinalizeActions = (f) => {
     const remoteBlockReasons = getPrReviewRemoteBlockReasons(f, lang);
     const remoteUnavailable = workflowPolicy.mode === "github" && !!f.pr.link && (!f.pr.remote || !f.pr.remote.available);
@@ -4599,7 +4640,7 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
         done: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && isTasksDocApproved(f) && f.git.docsEverCommitted
       },
       current: {
-        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && isTasksDocApproved(f) && !f.activeTask && !f.git.docsEverCommitted && f.git.docsHasUncommittedChanges,
+        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && isTasksDocApproved(f) && !f.activeTask && !f.git.docsEverCommitted && f.git.docsHasCommitRequiredChanges,
         actions: (f) => {
           if (f.issueNumber) {
             return [
@@ -4747,9 +4788,9 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
           actions: (f) => getTaskExecuteFinalizeActions(f)
         },
         {
-          id: "task_running",
-          phase: "running",
-          owner: "subagent",
+          id: "task_complete",
+          phase: "finalize",
+          owner: "main",
           category: "task_execute",
           when: (f) => isTaskExecuteCurrent(f) && !!f.activeTask,
           actions: (f) => getTaskExecuteRunningActions(f)
@@ -4794,7 +4835,7 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
       step: 11,
       name: tr(lang, "steps", "docsCommitSync"),
       checklist: {
-        done: (f) => !f.git.docsHasUncommittedChanges && !f.git.projectHasUncommittedChanges
+        done: (f) => !f.git.docsHasCommitRequiredChanges && !f.git.projectHasUncommittedChanges
       },
       substates: [
         {
@@ -4854,6 +4895,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
           when: (f) => isPrePrReviewRun(f),
           actions: (f) => getPrePrReviewRunActions(f)
         },
+        {
+          id: "pre_pr_review_running",
+          phase: "running",
+          owner: "subagent",
+          category: "pre_pr_review_run",
+          when: (f) => isPrePrReviewRunning(f),
+          actions: () => getPrePrReviewRunningActions()
+        },
         {
           id: "pre_pr_review_record",
           phase: "record",
@@ -5006,6 +5055,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
           when: (f) => isCodeReviewRun(f),
           actions: (f) => getCodeReviewRunActions(f)
         },
+        {
+          id: "code_review_running",
+          phase: "running",
+          owner: "subagent",
+          category: "code_review_run",
+          when: (f) => isCodeReviewRunning(f),
+          actions: () => getCodeReviewRunningActions()
+        },
         {
           id: "code_review_need_evidence",
           phase: "blocked",
@@ -5206,7 +5263,7 @@ function applyApprovalPolicy(step, actions, approval, currentSubstatePhase) {
 function applyTaskExecutePhaseCheck(action, requiresUserCheck, policy, explicitlyRequired = false, currentSubstatePhase) {
   if (policy !== "start_only") return requiresUserCheck;
   if (action.category !== "task_execute") return requiresUserCheck;
-  const isCompletionPhase = currentSubstatePhase === "running" || !currentSubstatePhase && action.taskExecutePhase === "complete";
+  const isCompletionPhase = currentSubstatePhase === "running" || currentSubstatePhase === "finalize" || !currentSubstatePhase && action.taskExecutePhase === "complete";
   if (!isCompletionPhase) return requiresUserCheck;
   if (explicitlyRequired) return requiresUserCheck;
   return false;
@@ -5681,14 +5738,78 @@ function parsePrReviewStatus(value) {
   if (normalized === "review") return "Review";
   return "Approved";
 }
-function parsePrePrReviewStatus(value) {
+function parseReviewRunStatus(value) {
   if (!value) return void 0;
   const trimmed = value.trim();
   if (!trimmed || trimmed.includes("|")) return void 0;
   if (/^(done|complete|completed)$/i.test(trimmed)) return "Done";
+  if (/^running$/i.test(trimmed)) return "Running";
   if (/^pending$/i.test(trimmed)) return "Pending";
   return void 0;
 }
+function parseGitStatusPaths(status) {
+  return status.split("\n").map((line) => line.trimEnd()).filter(Boolean).map((line) => {
+    const rawPath = line.slice(3).trim();
+    const renamedPath = rawPath.includes(" -> ") ? rawPath.split(" -> ").pop() || rawPath : rawPath;
+    return renamedPath.replace(/\\/g, "/");
+  }).filter(Boolean);
+}
+function getGitDiffAgainstHead(ctx, cwd, relativePath) {
+  try {
+    return ctx.cmd.execFileSync("git", ["diff", "--unified=0", "HEAD", "--", relativePath], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).toString();
+  } catch {
+    return void 0;
+  }
+}
+function getGitPathPrefix(ctx, cwd) {
+  try {
+    return ctx.cmd.execFileSync("git", ["rev-parse", "--show-prefix"], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).toString().trim();
+  } catch {
+    return "";
+  }
+}
+function isAllowedReviewRunStatusRemoval(line) {
+  return /^\s*-\s+\*\*(?:Pre-PR Review|PR 전 리뷰|PR Review|PR 리뷰)\*\*:\s*(?:Pending|-)\s*$/u.test(
+    line
+  );
+}
+function isAllowedReviewRunStatusAddition(line) {
+  return /^\s*-\s+\*\*(?:Pre-PR Review|PR 전 리뷰|PR Review|PR 리뷰)\*\*:\s*Running\s*$/u.test(
+    line
+  );
+}
+function isReviewRunStateOnlyDocsChange(ctx, docsGitCwd, featurePathFromDocs, docsStatus) {
+  if (!docsStatus) return false;
+  const changedPaths = parseGitStatusPaths(docsStatus);
+  const tasksPath = `${featurePathFromDocs.replace(/\\/g, "/")}/tasks.md`;
+  const gitPrefix = getGitPathPrefix(ctx, docsGitCwd).replace(/\\/g, "/");
+  const prefixedTasksPath = `${gitPrefix}${tasksPath}`.replace(/^\.\/+/, "");
+  const acceptedTasksPaths = /* @__PURE__ */ new Set([tasksPath, prefixedTasksPath]);
+  if (changedPaths.length === 0 || changedPaths.some((entry) => !acceptedTasksPaths.has(entry))) {
+    return false;
+  }
+  const diff = getGitDiffAgainstHead(ctx, docsGitCwd, tasksPath);
+  if (!diff) return false;
+  const changedLines = diff.split("\n").filter(
+    (line) => (line.startsWith("+") || line.startsWith("-")) && !line.startsWith("+++") && !line.startsWith("---")
+  );
+  if (changedLines.length === 0) return false;
+  return changedLines.every((line) => {
+    const payload = line.slice(1);
+    if (line.startsWith("+")) {
+      return isAllowedReviewRunStatusAddition(payload);
+    }
+    return isAllowedReviewRunStatusRemoval(payload);
+  });
+}
 function isPlaceholderReviewEvidence(value) {
   if (!value) return true;
   const trimmed = value.trim();
@@ -6416,6 +6537,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   let prePrDecision;
   let prePrDecisionOutcome;
   let prePrDecisionProvided = false;
+  let prReviewRunStatus;
   let prReviewEvidence;
   let prReviewEvidenceProvided = false;
   let prReviewDecision;
@@ -6485,7 +6607,12 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       "PR \uC804 \uB9AC\uBDF0",
       "Pre-PR Review"
     ]);
-    prePrReviewStatus = parsePrePrReviewStatus(prePrReviewValue);
+    prePrReviewStatus = parseReviewRunStatus(prePrReviewValue);
+    const prReviewStatusValue = extractFirstSpecValue(content, [
+      "PR \uB9AC\uBDF0",
+      "PR Review"
+    ]);
+    prReviewRunStatus = parseReviewRunStatus(prReviewStatusValue);
     const prePrEvidenceValue = extractFirstSpecValue(content, [
       "PR \uC804 \uB9AC\uBDF0 Evidence",
       "Pre-PR Evidence"
@@ -6626,19 +6753,34 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     normalizedFeaturePathFromDocs
   );
   let docsHasUncommittedChanges = typeof context.docsHasUncommittedChanges === "boolean" ? context.docsHasUncommittedChanges : false;
+  let docsRawStatus;
   let docsEverCommitted = typeof context.docsEverCommitted === "boolean" ? context.docsEverCommitted : false;
   let docsGitUnavailable = !!context.docsGitUnavailable;
   if (typeof context.docsHasUncommittedChanges !== "boolean") {
-    const docsStatus = getGitStatusPorcelain(ctx, context.docsGitCwd, [
+    docsRawStatus = getGitStatusPorcelain(ctx, context.docsGitCwd, [
       normalizedFeaturePathFromDocs
     ]);
-    if (docsStatus === void 0) {
+    if (docsRawStatus === void 0) {
       docsGitUnavailable = true;
       docsHasUncommittedChanges = true;
     } else {
-      docsHasUncommittedChanges = docsStatus.trim().length > 0;
+      docsHasUncommittedChanges = docsRawStatus.trim().length > 0;
     }
   }
+  if (docsHasUncommittedChanges && docsRawStatus === void 0 && !docsGitUnavailable) {
+    docsRawStatus = getGitStatusPorcelain(ctx, context.docsGitCwd, [
+      normalizedFeaturePathFromDocs
+    ]);
+  }
+  let docsHasCommitRequiredChanges = docsHasUncommittedChanges;
+  if (docsHasUncommittedChanges && !docsGitUnavailable && isReviewRunStateOnlyDocsChange(
+    ctx,
+    context.docsGitCwd,
+    normalizedFeaturePathFromDocs,
+    docsRawStatus
+  )) {
+    docsHasCommitRequiredChanges = false;
+  }
   if (typeof context.docsEverCommitted !== "boolean") {
     const docsLastCommit = getLastCommitForPath(
       ctx,
@@ -6750,7 +6892,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       })
     );
   }
-  if (docsEverCommitted && docsHasUncommittedChanges) {
+  if (docsEverCommitted && docsHasCommitRequiredChanges) {
     warnings.push(tr(lang, "warnings", "docsUncommittedChanges"));
   }
   if (projectHasUncommittedChanges) {
@@ -6775,7 +6917,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   }
   const tasksDocApproved = !tasksDocStatusFieldExists || tasksDocStatus === "Approved";
   const implementationDone = tasksExists && tasksSummary.total > 0 && tasksSummary.total === tasksSummary.done && isCompletionChecklistDone2({ completionChecklist }) && tasksDocApproved;
-  const workflowDone = implementationDone && !docsHasUncommittedChanges && !projectHasUncommittedChanges && specStatus === "Approved" && planStatus === "Approved" && (!workflowPolicy.requireIssue || !!issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured2({
+  const workflowDone = implementationDone && !docsHasCommitRequiredChanges && !projectHasUncommittedChanges && specStatus === "Approved" && planStatus === "Approved" && (!workflowPolicy.requireIssue || !!issueNumber) && (!workflowPolicy.requirePr || isPrMetadataConfigured2({
     docs: { prFieldExists, prStatusFieldExists }
   }) && !!prLink) && (!workflowPolicy.requireMerge || prStatus === "Approved") && isPrePrReviewSatisfied2(
     {
@@ -6885,6 +7027,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       decisionProvided: prePrDecisionProvided
     },
     prReview: {
+      status: prReviewRunStatus,
       evidence: prReviewEvidence,
       evidenceProvided: prReviewEvidenceProvided,
       decision: prReviewDecision,
@@ -6902,6 +7045,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       expectedWorktreePath,
       docsEverCommitted,
       docsHasUncommittedChanges,
+      docsHasCommitRequiredChanges,
       projectHasUncommittedChanges,
       docsPathIgnored: docsPathIgnored === true,
       projectHasUpstream,
@@ -8271,7 +8415,7 @@ function toActionOptions(actions, lang) {
     const summary = getActionSummary(action, lang);
     const detail = buildActionDetail(action, lang);
     const requiresRequestText = action.category === "user_request_replan";
-    const replyExample = requiresRequestText ? `${label}, <your request>` : `${label} OK`;
+    const replyExample = requiresRequestText ? `${label}, <your request>` : label;
     return {
       label,
       summary,
@@ -8454,6 +8598,23 @@ async function resolveContextSelection(ctx, featureName, options) {
 }
 
 // src/services/ContextPresenter.ts
+function getActionExecutionMetadata(action) {
+  if (action.category === "code_review_run") {
+    return {
+      handoffOnly: true,
+      advancesWorkflow: false,
+      nextMainState: "code_review_running"
+    };
+  }
+  if (action.category === "pre_pr_review_run") {
+    return {
+      handoffOnly: true,
+      advancesWorkflow: false,
+      nextMainState: "pre_pr_review_running"
+    };
+  }
+  return null;
+}
 function isTaskExecuteProjectCommitCommand(option) {
   if (!option || option.action.type !== "command") return false;
   if (option.action.category !== "task_execute") return false;
@@ -8647,11 +8808,14 @@ function buildAutoRunCommand(state, featureName, selectedComponent, untilCategor
 function resolveAutoRunPlan(lang, state, featureName, selectedComponent, approval, approvalRequired) {
   const base = (reasonCode, untilCategories2 = [], unknownCategories2 = []) => ({
     available: false,
+    policyEligible: false,
+    executableNow: false,
     reasonCode,
     summary: tr(lang, "cli", "context.autoRunUnavailable"),
     command: "",
     untilCategories: untilCategories2,
-    unknownCategories: unknownCategories2
+    unknownCategories: unknownCategories2,
+    manualBoundary: null
   });
   if (state.status !== "single_matched") return base("NOT_SINGLE_MATCHED");
   if (state.actionOptions.length === 0) return base("NO_ACTION_OPTIONS");
@@ -8664,8 +8828,38 @@ function resolveAutoRunPlan(lang, state, featureName, selectedComponent, approva
   if (untilCategories.length === 0) {
     return base("NO_REQUIRE_CHECK_CATEGORIES", [], unknownCategories);
   }
+  const executable = state.actionOptions.find(
+    (option) => option.action.type === "command"
+  );
+  if (!executable) {
+    const manualBoundary = state.actionOptions[0] ? {
+      label: state.actionOptions[0].label,
+      category: state.actionOptions[0].action.category,
+      detail: state.actionOptions[0].detail
+    } : null;
+    return {
+      available: false,
+      policyEligible: true,
+      executableNow: false,
+      reasonCode: "MANUAL_BOUNDARY",
+      summary: tr(lang, "cli", "context.autoRunManualBoundary", {
+        detail: manualBoundary?.detail || ""
+      }),
+      command: buildAutoRunCommand(
+        state,
+        featureName,
+        selectedComponent,
+        untilCategories
+      ),
+      untilCategories,
+      unknownCategories,
+      manualBoundary
+    };
+  }
   return {
     available: true,
+    policyEligible: true,
+    executableNow: true,
     reasonCode: "AVAILABLE",
     summary: tr(lang, "cli", "context.autoRunSummary", {
       categories: untilCategories.join(", ")
@@ -8677,7 +8871,8 @@ function resolveAutoRunPlan(lang, state, featureName, selectedComponent, approva
       untilCategories
     ),
     untilCategories,
-    unknownCategories
+    unknownCategories,
+    manualBoundary: null
   };
 }
 function toSuggestionLabel(index) {
@@ -8786,7 +8981,7 @@ function buildRequiredDocHints(actionOptions) {
 }
 function getListLabel(f, stepsMap, lang, workflowPolicy, prePrReviewPolicy) {
   if (f.completion.implementationDone && !f.completion.workflowDone) {
-    if (f.git.docsHasUncommittedChanges) {
+    if (f.git.docsHasCommitRequiredChanges) {
       return tr(lang, "cli", "context.list.docsCommitNeeded");
     }
     if (f.git.projectHasUncommittedChanges) {
@@ -8853,87 +9048,45 @@ function getFeatureRef(feature) {
 }
 function toCompactFeature(feature) {
   if (!feature) return null;
-  return {
+  const compactFeature = {
     ref: getFeatureRef(feature),
-    id: feature.id ?? null,
-    slug: feature.slug,
-    folderName: feature.folderName,
-    type: feature.type,
-    path: feature.path,
     currentStep: feature.currentStep,
     currentSubstateId: feature.currentSubstateId,
     currentSubstateOwner: feature.currentSubstateOwner,
     currentSubstatePhase: feature.currentSubstatePhase,
-    nextAction: feature.nextAction,
-    completion: feature.completion,
+    completion: {
+      implementationDone: feature.completion.implementationDone,
+      workflowDone: feature.completion.workflowDone
+    },
     specStatus: feature.specStatus,
     planStatus: feature.planStatus,
-    tasks: feature.tasks,
-    prePrReview: {
-      status: feature.prePrReview.status,
-      evidenceProvided: feature.prePrReview.evidenceProvided,
-      decisionOutcome: feature.prePrReview.decisionOutcome,
-      decisionProvided: feature.prePrReview.decisionProvided
-    },
-    prReview: {
-      evidenceProvided: feature.prReview.evidenceProvided,
-      decisionProvided: feature.prReview.decisionProvided
-    },
-    pr: {
-      link: feature.pr.link,
-      status: feature.pr.status,
-      remote: feature.pr.remote
-    },
-    git: {
-      docsBranch: feature.git.docsBranch,
-      projectBranch: feature.git.projectBranch,
-      projectBranchAvailable: feature.git.projectBranchAvailable,
-      onExpectedBranch: feature.git.onExpectedBranch,
-      docsEverCommitted: feature.git.docsEverCommitted,
-      docsHasUncommittedChanges: feature.git.docsHasUncommittedChanges,
-      projectHasUncommittedChanges: feature.git.projectHasUncommittedChanges,
-      docsPathIgnored: feature.git.docsPathIgnored,
-      projectHasUpstream: feature.git.projectHasUpstream,
-      projectBranchAhead: feature.git.projectBranchAhead,
-      projectBranchBehind: feature.git.projectBranchBehind
-    },
-    docs: {
-      specExists: feature.docs.specExists,
-      planExists: feature.docs.planExists,
-      tasksExists: feature.docs.tasksExists,
-      issueDocIssueFieldExists: feature.docs.issueDocIssueFieldExists,
-      prDocPrFieldExists: feature.docs.prDocPrFieldExists,
-      prDocReviewStatusFieldExists: feature.docs.prDocReviewStatusFieldExists,
-      prFieldExists: feature.docs.prFieldExists,
-      prStatusFieldExists: feature.docs.prStatusFieldExists,
-      prePrReviewFieldExists: feature.docs.prePrReviewFieldExists,
-      prePrEvidenceFieldExists: feature.docs.prePrEvidenceFieldExists,
-      prePrDecisionFieldExists: feature.docs.prePrDecisionFieldExists,
-      prReviewEvidenceFieldExists: feature.docs.prReviewEvidenceFieldExists,
-      prReviewDecisionFieldExists: feature.docs.prReviewDecisionFieldExists
-    },
-    warnings: feature.warnings
+    tasks: feature.tasks
   };
+  if (feature.warnings.length > 0) {
+    compactFeature.warnings = feature.warnings;
+  }
+  return compactFeature;
 }
 function toCompactActionOption(option) {
   const base = {
     label: option.label,
-    summary: option.summary,
     detail: option.detail,
-    approvalPrompt: option.approvalPrompt,
-    requiresRequestText: option.requiresRequestText,
-    replyExample: option.replyExample,
     actionType: option.action.type,
     category: option.action.category,
     operationType: option.action.operationType,
     requiresUserCheck: !!option.action.requiresUserCheck
   };
+  const executionMetadata = getActionExecutionMetadata(option.action);
+  if (executionMetadata) {
+    base.handoffOnly = executionMetadata.handoffOnly;
+    base.advancesWorkflow = executionMetadata.advancesWorkflow;
+    if (executionMetadata.nextMainState) {
+      base.nextMainState = executionMetadata.nextMainState;
+    }
+  }
   if (option.action.taskExecutePhase) {
     base.taskExecutePhase = option.action.taskExecutePhase;
   }
-  if (option.action.uiDetailParams) {
-    base.uiDetailParams = option.action.uiDetailParams;
-  }
   if (option.action.type === "command") {
     base.scope = option.action.scope;
     base.cwd = option.action.cwd;
@@ -9271,6 +9424,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     );
   }
   const selectedAction = freshSelected.action;
+  const executionMetadata = getActionExecutionMetadata(selectedAction);
   if (selectedAction.category === "user_request_replan") {
     const requestText = (parsedApproval?.requestText?.trim() || (parsedApproval ? "" : implicitReplanRequest)).trim();
     if (!requestText) {
@@ -9350,6 +9504,13 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
         executeCommand = executeCommand.replace(" [--ticket <TICKET>]", "");
       }
       console.log(chalk8.gray(`   - Run with: ${executeCommand}`));
+      if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
+        console.log(
+          chalk8.gray(
+            "   - This command prepares a handoff only; complete the delegated work and update workflow evidence before re-running context."
+          )
+        );
+      }
     } else {
       console.log(
         chalk8.gray("   - Instruction-only action (no command execution).")
@@ -9426,6 +9587,30 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
       { owner: `context-execute:${selectedAction.scope}` }
     );
     if (jsonMode) {
+      if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
+        console.log(
+          JSON.stringify(
+            {
+              status: "approved_handoff_prepared",
+              reasonCode: "HANDOFF_PREPARED",
+              feature: freshState.matchedFeature?.folderName ?? null,
+              label: parsedLabel,
+              action: selectedAction,
+              userRequest,
+              contextVersion: freshState.contextVersion,
+              executed: true,
+              handoffOnly: true,
+              advancesWorkflow: false,
+              nextMainState: executionMetadata.nextMainState,
+              stdout: execResult.stdout?.trim() || void 0,
+              stderr: execResult.stderr?.trim() || void 0
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
       console.log(
         JSON.stringify(
           {
@@ -9446,6 +9631,15 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
       );
       return;
     }
+    if (executionMetadata?.handoffOnly && !executionMetadata.advancesWorkflow) {
+      console.log(
+        chalk8.yellow(
+          "Prepared handoff only. Complete the delegated work and update workflow evidence before re-running context."
+        )
+      );
+      console.log();
+      return;
+    }
     console.log(chalk8.green(`\u2705 Executed option ${parsedLabel}.`));
     console.log();
   } catch (error) {
@@ -9627,98 +9821,99 @@ async function runContext(featureName, options) {
     );
     if (options.jsonCompact) {
       const compactResult = {
-        schema: "context.v2.compact",
+        schema: "context.v3.compact",
         status: state.status,
         reasonCode: toReasonCode(state.status),
-        selectionMode: state.selectionMode,
-        selectionFallback: state.selectionFallback,
-        branches: state.branches,
-        warnings: state.warnings,
         contextVersion: state.contextVersion,
         matchedFeature: toCompactFeature(state.matchedFeature),
-        candidateRefs: state.targetFeatures.length > 1 ? state.targetFeatures.map(
-          (feature) => getFeatureRef(feature)
-        ) : [],
-        completedCandidateRefs: state.selectionMode === "open" ? state.doneFeatures.map(
-          (feature) => getFeatureRef(feature)
-        ) : [],
-        openCandidateRefs: state.selectionMode === "open" ? state.openFeatures.map(
-          (feature) => getFeatureRef(feature)
-        ) : [],
-        inProgressCandidateRefs: state.selectionMode === "open" ? state.inProgressFeatures.map(
-          (feature) => getFeatureRef(feature)
-        ) : [],
-        readyToCloseCandidateRefs: state.selectionMode === "open" ? state.readyToCloseFeatures.map(
-          (feature) => getFeatureRef(feature)
-        ) : [],
         actionOptions: state.actionOptions.map(
           (option) => toCompactActionOption(option)
         ),
-        suggestionOptions: suggestionOptions.map(
-          (option) => toCompactSuggestionOption(option)
-        ),
-        primaryActionLabel: primaryAction?.label ?? null,
-        workflowPolicy,
-        taskCommitGatePolicy,
-        prePrReviewPolicy,
         checkPolicy: {
-          docPath: "builtin://agents/policy",
           token: "<LABEL>",
-          acceptedTokens: [
-            "<LABEL>",
-            "<LABEL> OK",
-            "<LABEL> ...",
-            "... <LABEL> ..."
-          ],
-          tokenPattern: "^.*\\b([A-Z]+)\\b.*$",
           validLabels: state.actionOptions.map((o) => o.label),
-          activeCategories,
-          knownCategories: ACTION_CATEGORIES,
-          uncategorizedLabels,
           checkRequiredLabels,
           checkRequiredCategories,
           approvalRequired,
-          categoryPolicyGuidance: 'For approval.mode="category", match against `actionOptions[].category`.',
-          oneApprovalPerAction: approvalRequired,
-          requireFreshContext: true,
-          contextVersion: state.contextVersion,
-          config: config.approval ?? { mode: "builtin" }
+          contextVersion: state.contextVersion
+        },
+        agentOrchestration: {
+          subAgentHandoff: agentOrchestration.subAgentHandoff
         },
-        agentOrchestration,
         autoRun: {
           available: autoRunPlan.available,
+          policyEligible: autoRunPlan.policyEligible,
+          executableNow: autoRunPlan.executableNow,
           reasonCode: autoRunPlan.reasonCode,
-          summary: autoRunPlan.summary,
           command: autoRunPlan.command,
           untilCategories: autoRunPlan.untilCategories,
-          unknownCategories: autoRunPlan.unknownCategories
+          unknownCategories: autoRunPlan.unknownCategories,
+          manualBoundary: autoRunPlan.manualBoundary
         },
         approvalRequest: {
           required: approvalRequired,
           finalPrompt: finalApprovalPrompt,
-          userFacingLines: approvalUserFacingLines,
-          labels: approvalRequired ? state.actionOptions.map((o) => o.label) : [],
-          approveCommand,
-          executeCommand,
-          executeRequiresTicket: !!state.actionOptions[0]?.action?.requiresUserCheck
-        },
-        suggestionRequest: {
-          finalPrompt: suggestionFinalPrompt,
-          userFacingLines: [
-            ...suggestionOptions.map((o) => `${o.label}: ${o.summary}`),
-            suggestionFinalPrompt
-          ].filter((line) => line.length > 0),
-          labels: suggestionOptions.map((o) => o.label)
-        },
-        prPolicy: {
-          screenshots: {
-            upload: config.pr?.screenshots?.upload ?? false
-          }
-        },
-        requiredDocs,
-        recommendation
+          userFacingLines: approvalUserFacingLines
+        }
       };
-      console.log(JSON.stringify(compactResult, null, 2));
+      if (state.warnings.length > 0) {
+        compactResult.warnings = state.warnings;
+      }
+      if (requiredDocs.length > 0) {
+        compactResult.requiredDocs = requiredDocs;
+      }
+      if (state.status !== "single_matched") {
+        const candidateRefs = state.targetFeatures.length > 1 ? state.targetFeatures.map(
+          (feature) => getFeatureRef(feature)
+        ) : [];
+        const completedCandidateRefs = state.selectionMode === "open" ? state.doneFeatures.map(
+          (feature) => getFeatureRef(feature)
+        ) : [];
+        const openCandidateRefs = state.selectionMode === "open" ? state.openFeatures.map(
+          (feature) => getFeatureRef(feature)
+        ) : [];
+        const inProgressCandidateRefs = state.selectionMode === "open" ? state.inProgressFeatures.map(
+          (feature) => getFeatureRef(feature)
+        ) : [];
+        const readyToCloseCandidateRefs = state.selectionMode === "open" ? state.readyToCloseFeatures.map(
+          (feature) => getFeatureRef(feature)
+        ) : [];
+        const compactSuggestionOptions = suggestionOptions.map(
+          (option) => toCompactSuggestionOption(option)
+        );
+        compactResult.selectionMode = state.selectionMode;
+        compactResult.selectionFallback = state.selectionFallback;
+        if (candidateRefs.length > 0) {
+          compactResult.candidateRefs = candidateRefs;
+        }
+        if (completedCandidateRefs.length > 0) {
+          compactResult.completedCandidateRefs = completedCandidateRefs;
+        }
+        if (openCandidateRefs.length > 0) {
+          compactResult.openCandidateRefs = openCandidateRefs;
+        }
+        if (inProgressCandidateRefs.length > 0) {
+          compactResult.inProgressCandidateRefs = inProgressCandidateRefs;
+        }
+        if (readyToCloseCandidateRefs.length > 0) {
+          compactResult.readyToCloseCandidateRefs = readyToCloseCandidateRefs;
+        }
+        if (compactSuggestionOptions.length > 0) {
+          compactResult.suggestionOptions = compactSuggestionOptions;
+          compactResult.suggestionRequest = {
+            finalPrompt: suggestionFinalPrompt,
+            userFacingLines: [
+              ...suggestionOptions.map((o) => `${o.label}: ${o.summary}`),
+              suggestionFinalPrompt
+            ].filter((line) => line.length > 0),
+            labels: suggestionOptions.map((o) => o.label)
+          };
+        }
+        if (recommendation) {
+          compactResult.recommendation = recommendation;
+        }
+      }
+      console.log(JSON.stringify(compactResult));
       return;
     }
     const result = {
@@ -9736,7 +9931,16 @@ async function runContext(featureName, options) {
       inProgressCandidates: state.selectionMode === "open" ? state.inProgressFeatures : [],
       readyToCloseCandidates: state.selectionMode === "open" ? state.readyToCloseFeatures : [],
       actions: state.actions,
-      actionOptions: state.actionOptions,
+      actionOptions: state.actionOptions.map((option) => {
+        const executionMetadata = getActionExecutionMetadata(
+          option.action
+        );
+        if (!executionMetadata) return option;
+        return {
+          ...option,
+          ...executionMetadata
+        };
+      }),
       suggestionOptions,
       primaryActionLabel: primaryAction?.label ?? null,
       primaryActionType: primaryAction?.action.type ?? null,
@@ -9780,12 +9984,15 @@ async function runContext(featureName, options) {
       agentOrchestration,
       autoRun: {
         available: autoRunPlan.available,
+        policyEligible: autoRunPlan.policyEligible,
+        executableNow: autoRunPlan.executableNow,
         reasonCode: autoRunPlan.reasonCode,
         summary: autoRunPlan.summary,
         command: autoRunPlan.command,
         untilCategories: autoRunPlan.untilCategories,
         unknownCategories: autoRunPlan.unknownCategories,
-        guidance: 'Use auto-run only when `autoRun.available=true`. Do not treat `autoRun.available` alone as a delegation trigger; use `agentOrchestration.subAgentHandoff.required` + `mode="auto_run"` for actual delegation. Stop and request approval when `approvalRequest.required=true` or when auto mode reaches configured gate categories.'
+        manualBoundary: autoRunPlan.manualBoundary,
+        guidance: 'Use auto-run only when `autoRun.available=true`. If `autoRun.policyEligible=true` but `autoRun.executableNow=false`, resolve `autoRun.manualBoundary` first. Do not treat `autoRun.available` alone as a delegation trigger; use `agentOrchestration.subAgentHandoff.required` + `mode="auto_run"` for actual delegation. Stop and request approval when `approvalRequest.required=true` or when auto mode reaches configured gate categories.'
       },
       approvalRequest: {
         guidance: 'User-facing output must include only approval prompts (`A: ...`) and `finalPrompt`. Do not expose `requiredDocs`, `checkPolicy`, or raw `cmd` unless explicitly requested. For approved command actions, prefer one-shot `flow --approve <LABEL> --execute`. Keep short steps in main agent. Prefer `matchedFeature.currentSubstateOwner` + `agentOrchestration.subAgentHandoff` as the delegation SSOT; `currentActionShouldDelegate` is a compatibility mirror. Delegate auto-run only when `agentOrchestration.subAgentHandoff.required=true` with `mode="auto_run"`.',
@@ -10497,8 +10704,9 @@ async function checkDocsStructure(config, cwd) {
 }
 async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   const issues = [];
+  const fsAdapter = new DefaultFileSystemAdapter();
   const { definitions: prdDefinitions } = await scanPrdRequirements(
-    fs,
+    fsAdapter,
     config.docsDir
   );
   if (features.length === 0) {
@@ -11775,6 +11983,26 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
       executeStatus: executeResult?.status ?? "unknown",
       executeReasonCode: executeResult?.reasonCode
     });
+    if (executeResult?.status === "approved_handoff_prepared") {
+      return {
+        enabled: true,
+        untilCategories,
+        request: requestText,
+        preset: metadata?.preset ?? null,
+        source: metadata?.source ?? null,
+        resume,
+        status: "manual_required",
+        reasonCode: toAutoReasonCode("manual_required"),
+        iterations,
+        executions,
+        gate: null,
+        manual: {
+          label: executable.label,
+          category: executable.action.category,
+          detail: typeof executeResult?.nextMainState === "string" ? `Complete the delegated handoff work, then continue from ${executeResult.nextMainState}.` : executable.detail
+        }
+      };
+    }
     if (executeResult?.status !== "approved_executed") {
       return {
         enabled: true,
@@ -15878,6 +16106,12 @@ async function resolvePrePrFeatureContext(featureName, component) {
     component: resolveComponentOption(component)
   };
   const ctx = await createCliContext({ cwd: process.cwd() });
+  if (!ctx) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      "No lee-spec-kit config found in this workspace."
+    );
+  }
   const state = await resolveContextSelection(ctx, featureName, selectionOptions);
   if (state.status !== "single_matched" || !state.matchedFeature) {
     throw createCliError(
@@ -15898,6 +16132,23 @@ async function runPrePrReviewRun(featureName, options) {
     options.component
   );
   const policy = resolvePrePrReviewPolicy(config.workflow);
+  const preferred = getPreferredKeys(config.lang);
+  const tasksPath = path12.join(feature.path, "tasks.md");
+  let tasksUpdated = false;
+  if (await fs.pathExists(tasksPath)) {
+    const tasksContent = await fs.readFile(tasksPath, "utf-8");
+    const nextTasks = upsertSpecLine(
+      tasksContent,
+      ["PR \uC804 \uB9AC\uBDF0", "Pre-PR Review"],
+      preferred.review,
+      "Running",
+      ["PR \uC0C1\uD0DC", "PR Status"]
+    );
+    tasksUpdated = nextTasks !== tasksContent;
+    if (tasksUpdated) {
+      await fs.writeFile(tasksPath, nextTasks, "utf-8");
+    }
+  }
   const prompt = getPrePrReviewPrompt(
     config.lang,
     policy.skills,
@@ -15928,8 +16179,14 @@ async function runPrePrReviewRun(featureName, options) {
           fallback: policy.fallback,
           handoffOnly: true,
           advancesWorkflow: false,
+          reuseKey: `pre-pr:${featureRef}`,
+          suggestedParallelism: 1,
+          fallbackToMainAgentWhenQuotaExceeded: true,
           nextStepRequirement: "generate_review_trace_then_record",
+          nextMainState: "pre_pr_review_running",
           evidenceFile: "review-trace.json",
+          tasksUpdated,
+          tasksPath,
           prompt,
           recordCommands: {
             changesRequested: changesRequestedCommand,
@@ -15949,7 +16206,26 @@ async function runPrePrReviewRun(featureName, options) {
       config.lang === "ko" ? "\uC774 \uBA85\uB839\uC740 \uB9AC\uBDF0 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. review-trace.json\uC744 \uC9C1\uC811 \uC0DD\uC131\uD558\uAC70\uB098 \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC0C1\uD0DC\uB97C \uBC14\uB85C \uB118\uAE30\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." : "This command only prepares the review handoff. It does not generate review-trace.json or advance workflow state by itself."
     )
   );
+  console.log(
+    chalk8.gray(
+      config.lang === "ko" ? "- \uAE30\uC874 pre-PR \uB9AC\uBDF0 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694." : "- Reuse the existing pre-PR helper agent if one already exists; default to a single helper agent."
+    )
+  );
+  console.log(
+    chalk8.gray(
+      config.lang === "ko" ? "- \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uB9AC\uBDF0\uB97C \uC774\uC5B4\uAC00\uC138\uC694." : "- If helper-agent quota is exhausted, continue the review in the main agent."
+    )
+  );
+  console.log(`Reuse key: pre-pr:${featureRef}`);
+  console.log(`Suggested parallelism: 1`);
+  console.log(`Next main state: pre_pr_review_running`);
   console.log(`Evidence file: review-trace.json`);
+  if (tasksUpdated) {
+    console.log(`tasks.md updated: ${tasksPath}`);
+    console.log(
+      config.lang === "ko" ? "PR \uC804 \uB9AC\uBDF0 \uC0C1\uD0DC: Running" : "Pre-PR Review status: Running"
+    );
+  }
   console.log(`Record changes requested: ${changesRequestedCommand}`);
   console.log(`Record approval: ${approveCommand}`);
 }
@@ -16129,6 +16405,53 @@ async function runPrePrReview(featureName, options) {
   }
   console.log();
 }
+function escapeRegExp5(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findSpecLineIndex2(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
+  );
+  return lines.findIndex((line) => re.test(line));
+}
+function replaceSpecLine2(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
+  );
+  if (!re.test(line)) return line;
+  return line.replace(re, `$1${preferredKey}$2${value}`);
+}
+function computeInsertIndex2(lines, anchorKeys) {
+  const anchorIndex = findSpecLineIndex2(lines, anchorKeys);
+  if (anchorIndex !== -1) {
+    let cursor = anchorIndex + 1;
+    while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
+      cursor += 1;
+    }
+    return cursor;
+  }
+  const sectionIndex = lines.findIndex(
+    (line) => /^\s*##\s+(Task List|태스크 목록)\s*$/.test(line)
+  );
+  if (sectionIndex !== -1) return sectionIndex;
+  return lines.length;
+}
+function upsertSpecLine2(content, keys, preferredKey, value, anchorKeys) {
+  const lines = content.split("\n");
+  const index = findSpecLineIndex2(lines, keys);
+  if (index !== -1) {
+    lines[index] = replaceSpecLine2(lines[index], keys, preferredKey, value);
+    return lines.join("\n");
+  }
+  const insertAt = computeInsertIndex2(lines, anchorKeys);
+  lines.splice(insertAt, 0, `- **${preferredKey}**: ${value}`);
+  return lines.join("\n");
+}
+function getPreferredReviewKey(lang) {
+  return lang === "ko" ? "PR \uB9AC\uBDF0" : "PR Review";
+}
 function buildCodeReviewRunPrompt(input) {
   if (input.lang === "ko") {
     return [
@@ -16168,6 +16491,22 @@ async function runCodeReviewRun(featureName, options) {
     );
   }
   const feature = state.matchedFeature;
+  const tasksPath = path12.join(feature.path, "tasks.md");
+  let tasksUpdated = false;
+  if (await fs.pathExists(tasksPath)) {
+    const tasksContent = await fs.readFile(tasksPath, "utf-8");
+    const nextTasks = upsertSpecLine2(
+      tasksContent,
+      ["PR \uB9AC\uBDF0", "PR Review"],
+      getPreferredReviewKey(config.lang),
+      "Running",
+      ["PR \uC804 \uB9AC\uBDF0 Decision", "Pre-PR Decision", "PR \uC0C1\uD0DC", "PR Status"]
+    );
+    tasksUpdated = nextTasks !== tasksContent;
+    if (tasksUpdated) {
+      await fs.writeFile(tasksPath, nextTasks, "utf-8");
+    }
+  }
   const prompt = buildCodeReviewRunPrompt({
     featureRef: feature.folderName,
     basePrompt: getCodeReviewPrompt(config.lang),
@@ -16181,8 +16520,12 @@ async function runCodeReviewRun(featureName, options) {
     owner: "subagent",
     handoffOnly: true,
     advancesWorkflow: false,
-    nextMainState: "code_review_finalize",
-    tasksPath: path12.join(feature.path, "tasks.md"),
+    reuseKey: `code-review:${feature.folderName}`,
+    suggestedParallelism: 1,
+    fallbackToMainAgentWhenQuotaExceeded: true,
+    nextMainState: "code_review_running",
+    tasksUpdated,
+    tasksPath,
     decisionsPath: path12.join(feature.path, "decisions.md"),
     prompt,
     recordedAt: getLocalDateString()
@@ -16200,7 +16543,22 @@ async function runCodeReviewRun(featureName, options) {
   );
   console.log(chalk8.gray(`- substate: ${payload.substateId}`));
   console.log(chalk8.gray(`- owner: ${payload.owner}`));
+  console.log(chalk8.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk8.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
+  console.log(
+    chalk8.gray(
+      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
+    )
+  );
   console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
+  if (tasksUpdated) {
+    console.log(chalk8.gray(`- tasks.md updated: ${payload.tasksPath}`));
+    console.log(
+      chalk8.gray(
+        config.lang === "ko" ? "- PR \uB9AC\uBDF0 \uC0C1\uD0DC: Running" : "- PR Review status: Running"
+      )
+    );
+  }
   console.log(chalk8.gray(`- tasks.md: ${payload.tasksPath}`));
   console.log(chalk8.gray(`- decisions.md: ${payload.decisionsPath}`));
 }
@@ -16451,9 +16809,10 @@ function parseTaskLine(line) {
 function buildTaskRunPrompt(input) {
   const shared = [
     "Read `spec.md`, `plan.md`, and `tasks.md` before editing code.",
-    "Use sub-agents by default for code analysis and discovery work.",
-    "Parallelize impact analysis, test-location search, and existing-pattern discovery when those can be done independently.",
+    "Reuse the existing helper/sub-agent for this task if one already exists. Default to a single helper agent.",
+    "Use additional helper agents only when parallel analysis is clearly worth the extra slot cost.",
     "Keep one writer for overlapping files; do not let multiple sub-agents edit the same files concurrently.",
+    "If helper-agent quota is exhausted, continue the task in the main agent instead of blocking progress.",
     "Update the assigned task status and verification notes in `tasks.md` before leaving this task.",
     "Mark the task `DONE` only after code changes and verification are complete."
   ];
@@ -16464,9 +16823,10 @@ function buildTaskRunPrompt(input) {
       `- Task: ${input.taskId} ${input.title}`,
       input.mode === "start" ? "- \uC774 \uBA85\uB839\uC740 `tasks.md`\uC758 \uD604\uC7AC task\uB97C `DOING`\uC73C\uB85C \uBC14\uAFB8\uACE0, \uC774\uD6C4 \uAD6C\uD604 handoff prompt\uB97C \uC900\uBE44\uD569\uB2C8\uB2E4." : "- \uC774 \uBA85\uB839\uC740 \uC9C4\uD589 \uC911 task\uC758 \uAD6C\uD604 handoff prompt\uB97C \uB2E4\uC2DC \uC900\uBE44\uD569\uB2C8\uB2E4.",
       "- \uBA3C\uC800 `spec.md`, `plan.md`, `tasks.md`\uB97C \uC77D\uACE0 \uBC94\uC704\uC640 \uC644\uB8CC \uAE30\uC900\uC744 \uC815\uB9AC\uD558\uC138\uC694.",
-      "- \uCF54\uB4DC \uBD84\uC11D\uACFC \uD0D0\uC0C9 \uC791\uC5C5\uC740 \uAE30\uBCF8\uC801\uC73C\uB85C \uC11C\uBE0C\uC5D0\uC774\uC804\uD2B8\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
-      "- \uC601\uD5A5 \uBC94\uC704 \uBD84\uC11D, \uD14C\uC2A4\uD2B8 \uC704\uCE58 \uD0D0\uC0C9, \uAE30\uC874 \uD328\uD134 \uC870\uC0AC\uCC98\uB7FC \uB3C5\uB9BD\uC801\uC778 \uBD84\uC11D\uC740 \uBCD1\uB82C\uB85C \uC218\uD589\uD558\uC138\uC694.",
+      "- \uAE30\uC874\uC5D0 \uC774 task\uB97C \uB9E1\uB358 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC7AC\uC0AC\uC6A9\uD558\uACE0, \uAE30\uBCF8\uC740 1\uAC1C\uB9CC \uC0AC\uC6A9\uD558\uC138\uC694.",
+      "- \uC601\uD5A5 \uBC94\uC704 \uBD84\uC11D, \uD14C\uC2A4\uD2B8 \uC704\uCE58 \uD0D0\uC0C9, \uAE30\uC874 \uD328\uD134 \uC870\uC0AC\uAC00 \uC815\uB9D0 \uB3C5\uB9BD\uC801\uC77C \uB54C\uB9CC \uCD94\uAC00 \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.",
       "- \uAC19\uC740 \uD30C\uC77C\uAD70\uC744 \uC218\uC815\uD558\uB294 \uC791\uC131\uC790\uB294 \uD55C \uBA85\uB9CC \uB450\uC138\uC694.",
+      "- \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8 \uD55C\uB3C4\uC5D0 \uAC78\uB9AC\uBA74 \uBA54\uC778 \uC5D0\uC774\uC804\uD2B8\uC5D0\uC11C \uAD6C\uD604\uC744 \uC774\uC5B4\uAC00\uC138\uC694.",
       "- \uC774 task\uB97C \uB9C8\uCE58\uAE30 \uC804 `tasks.md`\uC5D0 \uC0C1\uD0DC\uC640 \uAC80\uC99D \uBA54\uBAA8\uB97C \uBC18\uC601\uD558\uC138\uC694.",
       "- \uCF54\uB4DC \uBCC0\uACBD\uACFC \uAC80\uC99D\uC774 \uB05D\uB0AC\uC744 \uB54C\uB9CC task\uB97C `DONE`\uC73C\uB85C \uD45C\uC2DC\uD558\uC138\uC694."
     ].join("\n");
@@ -16565,7 +16925,11 @@ async function runTaskRun(featureName, options) {
     mode,
     substateId: mode === "start" ? "task_run" : "task_running",
     owner: "subagent",
-    nextMainState: "task_finalize",
+    handoffOnly: true,
+    reuseKey: `task:${feature.folderName}:${resolvedTask.taskId}`,
+    suggestedParallelism: 1,
+    fallbackToMainAgentWhenQuotaExceeded: true,
+    nextMainState: "task_complete",
     tasksUpdated,
     tasksPath,
     prompt,
@@ -16579,6 +16943,13 @@ async function runTaskRun(featureName, options) {
   console.log();
   console.log(chalk8.gray(`- substate: ${payload.substateId}`));
   console.log(chalk8.gray(`- owner: ${payload.owner}`));
+  console.log(chalk8.gray(`- reuse key: ${payload.reuseKey}`));
+  console.log(chalk8.gray(`- suggested parallelism: ${payload.suggestedParallelism}`));
+  console.log(
+    chalk8.gray(
+      `- quota fallback: ${payload.fallbackToMainAgentWhenQuotaExceeded ? "continue in main agent" : "none"}`
+    )
+  );
   console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
   if (tasksUpdated) {
     console.log();
@@ -16614,6 +16985,146 @@ function taskRunCommand(program2) {
     }
   });
 }
+function parseTaskLine2(line) {
+  const match = line.match(
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[[^\]]+\](?:\[[^\]]+\])*\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
+  );
+  if (!match) return null;
+  return {
+    index: -1,
+    raw: line,
+    status: match[1],
+    taskId: match[2],
+    title: match[3]
+  };
+}
+function setTaskStatus2(line, nextStatus) {
+  return line.raw.replace(
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]/,
+    `- [${nextStatus}]`
+  );
+}
+async function resolveTaskCompleteContext(featureName, options) {
+  const config = await getConfig(process.cwd());
+  if (!config) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      "No lee-spec-kit config found in this workspace."
+    );
+  }
+  const ctx = await createCliContext({ cwd: process.cwd() });
+  const state = await resolveContextSelection(ctx, featureName, {
+    component: resolveComponentOption(options.component)
+  });
+  if (state.status !== "single_matched" || !state.matchedFeature) {
+    throw createCliError(
+      "CONTEXT_SELECTION_REQUIRED",
+      "task-complete requires a single matched feature. Pass <feature-name> explicitly."
+    );
+  }
+  return {
+    config,
+    feature: state.matchedFeature
+  };
+}
+async function runTaskComplete(featureName, options) {
+  const { feature } = await resolveTaskCompleteContext(featureName, options);
+  const tasksPath = path12.join(feature.path, "tasks.md");
+  if (!await fs.pathExists(tasksPath)) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `tasks.md not found for feature: ${feature.folderName}`
+    );
+  }
+  const content = await fs.readFile(tasksPath, "utf-8");
+  const lines = content.split("\n");
+  const requestedTaskId = options.task?.trim() || feature.activeTask?.id || feature.nextTodoTask?.id;
+  if (!requestedTaskId) {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      "No active task is available for task-complete."
+    );
+  }
+  const resolvedTask = lines.map((line, index) => {
+    const parsed = parseTaskLine2(line);
+    return parsed ? { ...parsed, index } : null;
+  }).find((entry) => entry?.taskId === requestedTaskId);
+  if (!resolvedTask) {
+    throw createCliError(
+      "INVALID_ARGUMENT",
+      `Task "${requestedTaskId}" was not found in tasks.md.`
+    );
+  }
+  if (resolvedTask.status === "DONE") {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `Task "${requestedTaskId}" is already DONE.`
+    );
+  }
+  if (resolvedTask.status !== "DOING" && resolvedTask.status !== "REVIEW") {
+    throw createCliError(
+      "PRECONDITION_FAILED",
+      `Task "${requestedTaskId}" must be DOING/REVIEW before marking it DONE.`
+    );
+  }
+  lines[resolvedTask.index] = setTaskStatus2(resolvedTask, "DONE");
+  await fs.writeFile(tasksPath, lines.join("\n"), "utf-8");
+  const payload = {
+    status: "ok",
+    reasonCode: "TASK_COMPLETED",
+    feature: feature.folderName,
+    taskId: resolvedTask.taskId,
+    title: resolvedTask.title,
+    previousStatus: resolvedTask.status,
+    nextStatus: "DONE",
+    substateId: "task_complete",
+    owner: "main",
+    nextMainState: "task_finalize",
+    tasksUpdated: true,
+    tasksPath,
+    recordedAt: getLocalDateString()
+  };
+  if (options.json) {
+    console.log(JSON.stringify(payload, null, 2));
+    return;
+  }
+  console.log(
+    chalk8.green(
+      `Marked task ${resolvedTask.taskId} as DONE for ${feature.folderName}.`
+    )
+  );
+  console.log(chalk8.gray(`- tasks.md updated: ${tasksPath}`));
+  console.log(chalk8.gray(`- status: ${resolvedTask.status} -> DONE`));
+  console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
+}
+function taskCompleteCommand(program2) {
+  program2.command("task-complete [feature-name]").description("Mark the active DOING/REVIEW task as DONE").option("--component <component>", "Component name for multi projects").option("--task <task-id>", "Explicit task id to mark DONE").option("--json", "Output JSON").action(
+    async (featureName, options) => {
+      try {
+        await runTaskComplete(featureName, options);
+      } catch (error) {
+        const config = await getConfig(process.cwd());
+        const lang = config?.lang ?? DEFAULT_LANG;
+        const cliError = toCliError(error);
+        const suggestions = getCliErrorSuggestions(cliError.code, lang);
+        if (options.json) {
+          console.log(
+            JSON.stringify({
+              status: "error",
+              reasonCode: cliError.code,
+              error: cliError.message,
+              suggestions
+            })
+          );
+        } else {
+          console.error(chalk8.red(`[${cliError.code}] ${cliError.message}`));
+          printCliErrorSuggestions(suggestions, lang);
+        }
+        process.exitCode = 1;
+      }
+    }
+  );
+}
 function isBannerDisabled() {
   const v = (process.env.LEE_SPEC_KIT_NO_BANNER || "").trim();
   return v === "1";
@@ -16797,6 +17308,7 @@ onboardCommand(program);
 prePrReviewCommand(program);
 codeReviewRunCommand(program);
 taskRunCommand(program);
+taskCompleteCommand(program);
 requirementsCommand(program);
 await program.parseAsync();
 //# sourceMappingURL=index.js.map