lee-spec-kit 0.6.39 → 0.6.40

package/dist/index.js

@@ -215,6 +215,7 @@ var koCli = {
   "doctor.issue.tasksEmpty": "tasks.md\uC5D0 \uD0DC\uC2A4\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md\uC758 \uBB38\uC11C \uC0C1\uD0DC(Doc Status)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md\uC5D0 \uBB38\uC11C \uC0C1\uD0DC(Doc Status) \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **\uBB38\uC11C \uC0C1\uD0DC**: -`\uC640 `\uAC12: Draft | Review | Approved`\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C PRD-FR-001 \uAC19\uC740 ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
   "doctor.issue.duplicateFeatureId": "\uC911\uBCF5 Feature ID \uAC10\uC9C0: {id} ({count}\uAC1C)",
   "doctor.issue.missingFeatureId": "Feature \uD3F4\uB354\uBA85\uC774 F001-... \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4. (ID\uB97C \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC74C)",
   "init.selectLangPrompt": "\uBB38\uC11C \uC5B8\uC5B4\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
@@ -475,9 +476,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}) PR \uC804 \uB9AC\uBDF0\uB97C \uC2DC\uC791\uD558\uC138\uC694. (\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
+  "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.prePrReviewRecord": "({scope}) Pre-PR \uB9AC\uBDF0 evidence\uB97C decisions.md\uC640 tasks.md\uC5D0 \uAE30\uB85D\uD558\uC138\uC694",
-  "context.commandDetail.codeReviewRun": "({scope}) PR \uB9AC\uBDF0\uB97C \uC2DC\uC791\uD558\uC138\uC694. (\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
+  "context.commandDetail.codeReviewRun": "({scope}) \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C PR \uB9AC\uBDF0\uB97C \uC2E4\uD589\uD574 evidence/\uC218\uC815 \uC694\uC57D\uC744 \uC900\uBE44\uD558\uC138\uC694",
   "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",
@@ -495,12 +496,12 @@ var koContext = {
   "context.actionDetail.issueCreatePrepareFromDoc": "issue.md \uCD08\uC548\uC744 \uBCF4\uC644\uD558\uACE0 \uC0C1\uD0DC\uB97C Ready\uB85C \uC124\uC815\uD558\uC138\uC694",
   "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": "\uC791\uC5C5 \uAD6C\uD604\uC744 \uC2DC\uC791\uD558\uC138\uC694. (\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
-  "context.actionDetail.taskExecuteContinue": "\uC9C4\uD589 \uC911\uC778 \uC791\uC5C5\uC744 \uACC4\uC18D \uC9C4\uD589\uD558\uC138\uC694. (\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
+  "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. (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",
   "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": "PR \uC804 \uB9AC\uBDF0\uB97C \uC218\uD589\uD558\uC138\uC694. (`review-trace.json` \uC0DD\uC131, \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
+  "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.prePrReviewRecord": "PR \uC804 \uB9AC\uBDF0 evidence\uB97C decisions.md\uC640 tasks.md\uC5D0 \uAE30\uB85D\uD558\uC138\uC694",
-  "context.actionDetail.codeReviewRun": "PR \uB9AC\uBDF0\uB97C \uC9C4\uD589\uD558\uC138\uC694. (\uB9AC\uBDF0 evidence/\uC218\uC815 \uC694\uC57D \uC900\uBE44, \uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent) \uC2E4\uD589 \uB2E8\uACC4)",
+  "context.actionDetail.codeReviewRun": "\uBCF4\uC870 \uC5D0\uC774\uC804\uD2B8(sub-agent)\uB85C PR \uB9AC\uBDF0\uB97C \uC2E4\uD589\uD574 evidence/\uC218\uC815 \uC694\uC57D\uC744 \uC900\uBE44\uD558\uC138\uC694",
   "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,7 +624,7 @@ var koMessages = {
   taskCommitGateReasonMismatchLastDone: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B\uC774 \uC9C1\uC804 \uC644\uB8CC \uD0DC\uC2A4\uD06C\uC640 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4",
   prLegacyAsk: "tasks.md\uC5D0 PR/PR \uC0C1\uD0DC \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uD15C\uD50C\uB9BF\uC744 \uCD5C\uC2E0 \uD3EC\uB9F7\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD560\uAE4C\uC694? (\uD655\uC778 \uD544\uC694)",
   prePrReviewFieldMissing: "tasks.md\uC5D0 `PR \uC804 \uB9AC\uBDF0` \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **PR \uC804 \uB9AC\uBDF0**: Pending | Done` \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694. (\uD655\uC778 \uD544\uC694)",
-  prePrReviewRun: "\uCF54\uB4DC \uB9AC\uBDF0 \uC5D0\uC774\uC804\uD2B8\uB97C \uC2E4\uD589\uD574 `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. \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)",
+  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)",
   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)",
@@ -766,6 +767,7 @@ var enCli = {
   "doctor.issue.tasksEmpty": "tasks.md has no tasks.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md Doc Status is not set. (Set it to Draft, Review, or Approved.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md is missing the Doc Status field. Add `- **Doc Status**: -` and `Values: Draft | Review | Approved`.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent IDs like PRD-FR-001 in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
   "doctor.issue.duplicateFeatureId": "Duplicate Feature ID detected: {id} ({count})",
   "doctor.issue.missingFeatureId": "Feature folder name is not in F001-... format. (Cannot extract ID)",
   "init.selectLangPrompt": "Select docs language:",
@@ -1026,9 +1028,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}) start the pre-PR review. (helper agent/sub-agent execution stage)",
+  "context.commandDetail.prePrReviewRun": "({scope}) run the pre-PR review via a helper agent/sub-agent and prepare `review-trace.json`",
   "context.commandDetail.prePrReviewRecord": "({scope}) record pre-PR review evidence into decisions.md + tasks.md",
-  "context.commandDetail.codeReviewRun": "({scope}) start the PR review. (helper agent/sub-agent execution stage)",
+  "context.commandDetail.codeReviewRun": "({scope}) run the PR review via a helper agent/sub-agent and prepare evidence/fix summary",
   "context.actionSummary.runDocsCommand": "Run docs command",
   "context.actionSummary.runProjectCommand": "Run project command",
   "context.actionDetail.featureFolder": "Prepare feature folder and baseline docs",
@@ -1046,12 +1048,12 @@ var enContext = {
   "context.actionDetail.issueCreatePrepareFromDoc": "Refine issue.md draft and set Status to Ready",
   "context.actionDetail.issueCreateFromDoc": "Create GitHub Issue from ready issue.md and sync Issue",
   "context.actionDetail.taskExecute": "Proceed with the current task",
-  "context.actionDetail.taskExecuteRun": "Start implementing the task. (helper agent/sub-agent execution stage)",
-  "context.actionDetail.taskExecuteContinue": "Continue the in-progress task. (helper agent/sub-agent execution stage)",
+  "context.actionDetail.taskExecuteRun": "Prepare helper agent/sub-agent task handoff and start the task. (TODO becomes DOING)",
+  "context.actionDetail.taskExecuteContinue": "Prepare helper agent/sub-agent handoff and continue the in-progress task",
   "context.actionDetail.reviewFixCommit": "Create a review-fix commit with resolved feedback summary",
-  "context.actionDetail.prePrReviewRun": "Run the pre-PR review. (generate `review-trace.json`, helper agent/sub-agent execution stage)",
+  "context.actionDetail.prePrReviewRun": "Run the pre-PR review via a helper agent/sub-agent and prepare `review-trace.json`",
   "context.actionDetail.prePrReviewRecord": "Record pre-PR review evidence into decisions.md and tasks.md",
-  "context.actionDetail.codeReviewRun": "Run the PR review. (prepare review evidence/fix summary, helper agent/sub-agent execution stage)",
+  "context.actionDetail.codeReviewRun": "Run the PR review via a helper agent/sub-agent and prepare evidence/fix summary",
   "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",
@@ -1174,7 +1176,7 @@ var enMessages = {
   taskCommitGateReasonMismatchLastDone: "The latest project code commit does not match the last completed task",
   prLegacyAsk: "tasks.md is missing PR/PR Status fields. Update to the latest template format? (CHECK required)",
   prePrReviewFieldMissing: "tasks.md is missing the `Pre-PR Review` field. Add `- **Pre-PR Review**: Pending | Done` and run context again. (CHECK required)",
-  prePrReviewRun: "Run the code review agent, 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`; use `--evidence review-trace.json` when the active evidence policy requires a path. (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)",
   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)",
@@ -10106,6 +10108,108 @@ function printChecklist(f, stepDefinitions) {
     console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
   });
 }
+var PRD_REQUIREMENT_ID_RE = /\bPRD-(?:FR|US|NFR)-\d+\b/gi;
+function isPrdRequirementId(value) {
+  return /^PRD-(?:FR|US|NFR)-\d+$/i.test(value.trim());
+}
+function isNonPrdTag(value) {
+  const trimmed = value.trim();
+  return /^NON[-_ ]?PRD$/i.test(trimmed);
+}
+function normalizeRelPath2(value) {
+  return value.replace(/\\/g, "/").replace(/^\.\/+/, "");
+}
+function extractTitleAfterId(line, id) {
+  const idx = line.indexOf(id);
+  if (idx < 0) return void 0;
+  const after = line.slice(idx + id.length);
+  const cleaned = after.replace(/^[\s:：\-–—)\]]+/, "").trim();
+  return cleaned ? cleaned : void 0;
+}
+async function scanPrdRequirements(fsAdapter, docsDir) {
+  const prdDir = path12.join(docsDir, "prd");
+  const files = await walkFiles(fsAdapter, prdDir, {
+    extensions: [".md"],
+    ignoreDirs: [".git", "node_modules", "dist", "tmp"]
+  });
+  const definitions = /* @__PURE__ */ new Map();
+  const duplicates = [];
+  for (const filePath of files) {
+    if (path12.basename(filePath).toLowerCase() === "readme.md") {
+      continue;
+    }
+    let content = "";
+    try {
+      content = await fsAdapter.readFile(filePath, "utf-8");
+    } catch {
+      continue;
+    }
+    const relFile = normalizeRelPath2(path12.relative(docsDir, filePath));
+    const lines = content.split(/\r?\n/);
+    let inCodeBlock = false;
+    for (let i = 0; i < lines.length; i += 1) {
+      const line = lines[i] || "";
+      if (/^\s*(```|~~~)/.test(line)) {
+        inCodeBlock = !inCodeBlock;
+        continue;
+      }
+      if (inCodeBlock) continue;
+      const ids = [...line.matchAll(PRD_REQUIREMENT_ID_RE)].map(
+        (match) => (match[0] || "").toUpperCase()
+      );
+      if (ids.length === 0) continue;
+      for (const id of ids) {
+        const def = {
+          id,
+          title: extractTitleAfterId(line, id),
+          file: relFile,
+          line: i + 1
+        };
+        const existing = definitions.get(id);
+        if (existing) {
+          duplicates.push(def);
+          continue;
+        }
+        definitions.set(id, def);
+      }
+    }
+  }
+  return { definitions, duplicates, filesScanned: files.length };
+}
+function parseTaskLines(content) {
+  const out = [];
+  const lines = content.split(/\r?\n/);
+  let inCodeBlock = false;
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i] || "";
+    if (/^\s*(```|~~~)/.test(line)) {
+      inCodeBlock = !inCodeBlock;
+      continue;
+    }
+    if (inCodeBlock) continue;
+    const match = line.match(
+      /^\s*-\s*\[([A-Z]+)\]((?:\[[^\]]+\])*)\s*(.+?)\s*$/
+    );
+    if (!match) continue;
+    const status = (match[1] || "").trim().toUpperCase();
+    const tagsPart = match[2] || "";
+    const title = (match[3] || "").trim();
+    if (!title) continue;
+    if (status !== "TODO" && status !== "DOING" && status !== "DONE" && status !== "REVIEW") {
+      continue;
+    }
+    const tags = [...tagsPart.matchAll(/\[([^\]]+)\]/g)].map((m) => (m[1] || "").trim()).filter(Boolean);
+    out.push({
+      status,
+      tags,
+      title,
+      line: i + 1
+    });
+  }
+  return out;
+}
+
+// src/commands/doctor.ts
 var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
   "placeholder_left",
   "spec_status_unset",
@@ -10362,6 +10466,10 @@ async function checkDocsStructure(config, cwd) {
 }
 async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   const issues = [];
+  const { definitions: prdDefinitions } = await scanPrdRequirements(
+    fs,
+    config.docsDir
+  );
   if (features.length === 0) {
     issues.push({
       level: "warn",
@@ -10443,6 +10551,24 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         path: formatPath(cwd, path12.join(f.path, "tasks.md"))
       });
     }
+    if (f.docs.tasksExists) {
+      const tasksPath = path12.join(f.path, "tasks.md");
+      const tasksContent = await fs.readFile(tasksPath, "utf-8");
+      const unknownPrdTags = [...new Set(
+        parseTaskLines(tasksContent).flatMap((task) => task.tags).filter((tag) => isPrdRequirementId(tag)).map((tag) => tag.trim().toUpperCase()).filter((tag) => !prdDefinitions.has(tag))
+      )].sort();
+      if (unknownPrdTags.length > 0) {
+        issues.push({
+          level: "warn",
+          code: "tasks_prd_tag_unknown",
+          message: tr(config.lang, "cli", "doctor.issue.tasksPrdTagUnknown", {
+            ids: unknownPrdTags.slice(0, 5).join(", "),
+            extra: unknownPrdTags.length > 5 ? ` (+${unknownPrdTags.length - 5} more)` : ""
+          }),
+          path: formatPath(cwd, tasksPath)
+        });
+      }
+    }
     if (f.docs.tasksExists && !f.docs.tasksDocStatusFieldExists && !isInitialTemplateState) {
       issues.push({
         level: "warn",
@@ -15660,6 +15786,9 @@ async function runPrePrReviewRun(featureName, options) {
           feature: featureRef,
           skills: policy.skills,
           fallback: policy.fallback,
+          handoffOnly: true,
+          advancesWorkflow: false,
+          nextStepRequirement: "generate_review_trace_then_record",
           evidenceFile: "review-trace.json",
           prompt,
           recordCommands: {
@@ -15675,6 +15804,11 @@ async function runPrePrReviewRun(featureName, options) {
   }
   console.log(prompt);
   console.log();
+  console.log(
+    chalk8.yellow(
+      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(`Evidence file: review-trace.json`);
   console.log(`Record changes requested: ${changesRequestedCommand}`);
   console.log(`Record approval: ${approveCommand}`);
@@ -15903,6 +16037,8 @@ async function runCodeReviewRun(featureName, options) {
     feature: feature.folderName,
     substateId: "code_review_run",
     owner: "subagent",
+    handoffOnly: true,
+    advancesWorkflow: false,
     nextMainState: "code_review_finalize",
     tasksPath: path12.join(feature.path, "tasks.md"),
     decisionsPath: path12.join(feature.path, "decisions.md"),
@@ -15915,6 +16051,11 @@ async function runCodeReviewRun(featureName, options) {
   }
   console.log(prompt);
   console.log();
+  console.log(
+    chalk8.yellow(
+      config.lang === "ko" ? "\uC774 \uBA85\uB839\uC740 PR \uB9AC\uBDF0 handoff\uB9CC \uC900\uBE44\uD569\uB2C8\uB2E4. \uB9AC\uBDF0 evidence/decision\uC744 \uC9C1\uC811 \uAE30\uB85D\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 PR review handoff. It does not record review evidence/decision or advance workflow state by itself."
+    )
+  );
   console.log(chalk8.gray(`- substate: ${payload.substateId}`));
   console.log(chalk8.gray(`- owner: ${payload.owner}`));
   console.log(chalk8.gray(`- next main state: ${payload.nextMainState}`));
@@ -15949,105 +16090,6 @@ function codeReviewRunCommand(program2) {
     }
   );
 }
-var PRD_REQUIREMENT_ID_RE = /\bPRD-(?:FR|US|NFR)-\d+\b/gi;
-function isPrdRequirementId(value) {
-  return /^PRD-(?:FR|US|NFR)-\d+$/i.test(value.trim());
-}
-function isNonPrdTag(value) {
-  const trimmed = value.trim();
-  return /^NON[-_ ]?PRD$/i.test(trimmed);
-}
-function normalizeRelPath2(value) {
-  return value.replace(/\\/g, "/").replace(/^\.\/+/, "");
-}
-function extractTitleAfterId(line, id) {
-  const idx = line.indexOf(id);
-  if (idx < 0) return void 0;
-  const after = line.slice(idx + id.length);
-  const cleaned = after.replace(/^[\s:：\-–—)\]]+/, "").trim();
-  return cleaned ? cleaned : void 0;
-}
-async function scanPrdRequirements(fsAdapter, docsDir) {
-  const prdDir = path12.join(docsDir, "prd");
-  const files = await walkFiles(fsAdapter, prdDir, {
-    extensions: [".md"],
-    ignoreDirs: [".git", "node_modules", "dist", "tmp"]
-  });
-  const definitions = /* @__PURE__ */ new Map();
-  const duplicates = [];
-  for (const filePath of files) {
-    let content = "";
-    try {
-      content = await fsAdapter.readFile(filePath, "utf-8");
-    } catch {
-      continue;
-    }
-    const relFile = normalizeRelPath2(path12.relative(docsDir, filePath));
-    const lines = content.split(/\r?\n/);
-    let inCodeBlock = false;
-    for (let i = 0; i < lines.length; i += 1) {
-      const line = lines[i] || "";
-      if (/^\s*(```|~~~)/.test(line)) {
-        inCodeBlock = !inCodeBlock;
-        continue;
-      }
-      if (inCodeBlock) continue;
-      const ids = [...line.matchAll(PRD_REQUIREMENT_ID_RE)].map(
-        (match) => (match[0] || "").toUpperCase()
-      );
-      if (ids.length === 0) continue;
-      for (const id of ids) {
-        const def = {
-          id,
-          title: extractTitleAfterId(line, id),
-          file: relFile,
-          line: i + 1
-        };
-        const existing = definitions.get(id);
-        if (existing) {
-          duplicates.push(def);
-          continue;
-        }
-        definitions.set(id, def);
-      }
-    }
-  }
-  return { definitions, duplicates, filesScanned: files.length };
-}
-function parseTaskLines(content) {
-  const out = [];
-  const lines = content.split(/\r?\n/);
-  let inCodeBlock = false;
-  for (let i = 0; i < lines.length; i += 1) {
-    const line = lines[i] || "";
-    if (/^\s*(```|~~~)/.test(line)) {
-      inCodeBlock = !inCodeBlock;
-      continue;
-    }
-    if (inCodeBlock) continue;
-    const match = line.match(
-      /^\s*-\s*\[([A-Z]+)\]((?:\[[^\]]+\])*)\s*(.+?)\s*$/
-    );
-    if (!match) continue;
-    const status = (match[1] || "").trim().toUpperCase();
-    const tagsPart = match[2] || "";
-    const title = (match[3] || "").trim();
-    if (!title) continue;
-    if (status !== "TODO" && status !== "DOING" && status !== "DONE" && status !== "REVIEW") {
-      continue;
-    }
-    const tags = [...tagsPart.matchAll(/\[([^\]]+)\]/g)].map((m) => (m[1] || "").trim()).filter(Boolean);
-    out.push({
-      status,
-      tags,
-      title,
-      line: i + 1
-    });
-  }
-  return out;
-}
-
-// src/commands/requirements.ts
 function getRequirementState(tasks) {
   if (tasks.total === 0) return "UNTRACKED";
   if (tasks.done === tasks.total) return "DONE";
@@ -16252,7 +16294,7 @@ async function runRequirements(options) {
 }
 function parseTaskLine(line) {
   const match = line.match(
-    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[([^\]]+)\]\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
+    /^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\[([^\]]+)\](?:\[[^\]]+\])*\s+(T-[A-Za-z0-9-]+)\s+(.+?)\s*$/
   );
   if (!match) return null;
   return {
@@ -16275,9 +16317,10 @@ function buildTaskRunPrompt(input) {
   ];
   if (input.lang === "ko") {
     return [
-      `${input.mode === "start" ? "\uC0C8 task \uC2E4\uD589\uC744 \uC2DC\uC791\uD558\uC138\uC694." : "\uC9C4\uD589 \uC911\uC778 task \uC2E4\uD589\uC744 \uC774\uC5B4\uAC00\uC138\uC694."}`,
+      `${input.mode === "start" ? "\uC0C8 task \uC2E4\uD589\uC6A9 handoff\uB97C \uC900\uBE44\uD558\uC138\uC694." : "\uC9C4\uD589 \uC911\uC778 task handoff\uB97C \uC774\uC5B4\uAC00\uC138\uC694."}`,
       `- Feature: ${input.featureRef}`,
       `- 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.",
@@ -16287,9 +16330,10 @@ function buildTaskRunPrompt(input) {
     ].join("\n");
   }
   return [
-    input.mode === "start" ? "Start this task execution." : "Continue this in-progress task execution.",
+    input.mode === "start" ? "Prepare the handoff for this task execution." : "Prepare the handoff for this in-progress task.",
     `- Feature: ${input.featureRef}`,
     `- Task: ${input.taskId} ${input.title}`,
+    `- ${input.mode === "start" ? "This command marks the current task as DOING in tasks.md, then prepares the implementation handoff prompt." : "This command prepares the implementation handoff prompt again for the in-progress task."}`,
     ...shared.map((line) => `- ${line}`)
   ].join("\n");
 }
@@ -16401,7 +16445,9 @@ async function runTaskRun(featureName, options) {
   }
 }
 function taskRunCommand(program2) {
-  program2.command("task-run [feature-name]").description("Prepare and start a task execution handoff for sub-agent work").option("--component <component>", "Component name for multi projects").option("--task <task-id>", "Explicit task id to execute").option("--json", "Output JSON").action(async (featureName, options) => {
+  program2.command("task-run [feature-name]").description(
+    "Prepare task execution handoff for sub-agent work (marks TODO tasks as DOING)"
+  ).option("--component <component>", "Component name for multi projects").option("--task <task-id>", "Explicit task id to execute").option("--json", "Output JSON").action(async (featureName, options) => {
     try {
       await runTaskRun(featureName, options);
     } catch (error) {