npm - lee-spec-kit - Versions diffs - 0.6.16 → 0.6.18 - Mend

lee-spec-kit 0.6.16 → 0.6.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (14) hide show

package/README.en.md +56 -20
package/README.md +57 -21
package/dist/index.js +1117 -229
package/package.json +8 -3
package/templates/en/common/README.md +6 -2
package/templates/en/common/agents/agents.md +1 -1
package/templates/en/common/agents/git-workflow.md +8 -1
package/templates/en/common/features/feature-base/issue.md +3 -7
package/templates/en/common/features/feature-base/pr.md +3 -3
package/templates/ko/common/README.md +6 -2
package/templates/ko/common/agents/agents.md +1 -1
package/templates/ko/common/agents/git-workflow.md +8 -1
package/templates/ko/common/features/feature-base/issue.md +3 -7
package/templates/ko/common/features/feature-base/pr.md +3 -3

package/dist/index.js CHANGED Viewed

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import path19 from 'path';
+import path20 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import fs15 from 'fs-extra';
@@ -11,7 +11,7 @@ import os from 'os';
 import { createHash, randomUUID } from 'crypto';
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path19.dirname(getFilename());
+var getDirname = () => path20.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function copyTemplates(src, dest) {
   await fs15.copy(src, dest, {
@@ -42,10 +42,10 @@ async function replaceInFiles(dir, replacements) {
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path19.dirname(__filename2);
+var __dirname2 = path20.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path19.resolve(__dirname2, "..");
-  return path19.join(rootDir, "templates");
+  const rootDir = path20.resolve(__dirname2, "..");
+  return path20.join(rootDir, "templates");
 }
 // src/utils/i18n.ts
@@ -139,6 +139,7 @@ var I18N = {
       "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.suggestion.createFeature": "\uC0C8 Feature\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4",
+      "context.suggestion.runOnboard": "\uCD08\uAE30 \uC124\uC815 \uC810\uAC80(onboard)\uC744 \uC2E4\uD589\uD569\uB2C8\uB2E4",
       "context.suggestion.showDone": "\uC644\uB8CC\uB41C Feature \uBAA9\uB85D\uC744 \uD655\uC778\uD569\uB2C8\uB2E4",
       "context.suggestion.showAll": "\uC804\uCCB4 Feature \uBAA9\uB85D\uC744 \uD655\uC778\uD569\uB2C8\uB2E4",
       "context.suggestion.selectFeature": "\uC9C4\uD589\uD560 Feature\uB97C \uC120\uD0DD\uD574 \uC0C1\uC138 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uC5FD\uB2C8\uB2E4",
@@ -202,6 +203,7 @@ var I18N = {
       "init.log.nextStepsTitle": "\uB2E4\uC74C \uB2E8\uACC4:",
       "init.log.nextSteps1": "  1. {docsDir}/prd/README.md \uC791\uC131",
       "init.log.nextSteps2": "  2. npx lee-spec-kit feature <name> \uC73C\uB85C \uAE30\uB2A5 \uCD94\uAC00",
+      "init.log.nextSteps3": "  3. npx lee-spec-kit onboard --strict \uB85C \uCD08\uAE30 \uC124\uC815 \uC810\uAC80",
       "init.log.gitRepoDetectedCommit": "\u{1F4E6} Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0, docs \uCEE4\uBC0B \uC911...",
       "init.log.gitInit": "\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911...",
       "init.warn.stagedChangesSkip": '\u26A0\uFE0F  \uD604\uC7AC Git index\uC5D0 \uC774\uBBF8 stage\uB41C \uBCC0\uACBD\uC774 \uC788\uC2B5\uB2C8\uB2E4. (--dir "." \uC778 \uACBD\uC6B0 \uCEE4\uBC0B \uBC94\uC704\uB97C \uC548\uC804\uD558\uAC8C \uC81C\uD55C\uD560 \uC218 \uC5C6\uC5B4 \uC790\uB3D9 \uCEE4\uBC0B\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4)',
@@ -274,7 +276,7 @@ var I18N = {
       "github.operationPrMerge": "GitHub PR merge",
       "github.createIssueFailed": "GitHub issue \uC0DD\uC131\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4",
       "github.createPrFailed": "GitHub PR \uC0DD\uC131\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4",
-      "github.mergeRequiresPr": "`--merge`\uB97C \uC0AC\uC6A9\uD558\uB824\uBA74 `--create` \uB610\uB294 `--pr <url|number>`\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
+      "github.mergeRequiresPr": "`--merge`\uB97C \uC0AC\uC6A9\uD558\uB824\uBA74 `--create`, `--pr <url|number>`, \uB610\uB294 tasks.md\uC758 PR \uB9C1\uD06C\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
       "github.checkoutBaseAfterMergeFailed": "merge \uD6C4 {base} \uBE0C\uB79C\uCE58 checkout\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4",
       "github.pullBaseAfterMergeFailed": "merge \uD6C4 {base} \uBE0C\uB79C\uCE58 \uCD5C\uC2E0\uD654\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4",
       "github.issueDefaultTitle": "{slug} ({summary})",
@@ -431,7 +433,7 @@ var I18N = {
       reviewFixCommitIssueGuidance: 'PR \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB294 \uD574\uACB0\uD55C \uB9AC\uBDF0 \uC9C0\uC801\uC0AC\uD56D\uC744 \uC694\uC57D\uD574\uC57C \uD558\uBA70, \uD0DC\uC2A4\uD06C \uC81C\uBAA9\uC744 \uC7AC\uC0AC\uC6A9\uD558\uC9C0 \uB9C8\uC138\uC694. \uC608: `cd "{projectGitCwd}" && (git diff --cached --quiet && echo "\uC2A4\uD14C\uC774\uC9D5\uB41C \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uB9AC\uBDF0 \uC218\uC815 \uBC18\uC601 \uD30C\uC77C\uB9CC git add [files] \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694." && exit 1 || git commit -m "fix(#{issueNumber}): <review-fix-summary>")` (`<review-fix-summary>`\uB294 \uC774\uBC88 \uCEE4\uBC0B\uC5D0\uC11C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9\uC73C\uB85C \uC9C1\uC811 \uC791\uC131)',
       reviewFixCommitGuidance: 'PR \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB294 \uD574\uACB0\uD55C \uB9AC\uBDF0 \uC9C0\uC801\uC0AC\uD56D\uC744 \uC694\uC57D\uD574\uC57C \uD558\uBA70, \uD0DC\uC2A4\uD06C \uC81C\uBAA9\uC744 \uC7AC\uC0AC\uC6A9\uD558\uC9C0 \uB9C8\uC138\uC694. \uC608: `cd "{projectGitCwd}" && (git diff --cached --quiet && echo "\uC2A4\uD14C\uC774\uC9D5\uB41C \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uB9AC\uBDF0 \uC218\uC815 \uBC18\uC601 \uD30C\uC77C\uB9CC git add [files] \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694." && exit 1 || git commit -m "fix(review): <review-fix-summary>")` (`<review-fix-summary>`\uB294 \uC774\uBC88 \uCEE4\uBC0B\uC5D0\uC11C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uD56D\uBAA9\uC73C\uB85C \uC9C1\uC811 \uC791\uC131)',
       standaloneNeedsProjectRoot: "standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot \uC124\uC815\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)",
-      createBranch: 'cd "{projectGitCwd}" && git checkout -b feat/{issueNumber}-{slug}',
+      createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
       tasksAllDoneButNoChecklist: '\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uB97C \uC791\uC131\uD558\uC138\uC694. tasks.md\uC758 "\uC644\uB8CC \uC870\uAC74" \uC139\uC158\uC5D0 \uAC80\uC99D \uD56D\uBAA9\uC744 \uCD94\uAC00\uD558\uACE0, \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uC138\uC694. \uCD5C\uC885 \uC2B9\uC778(OK)\uB3C4 \uBC18\uC601\uD558\uC138\uC694.',
       tasksAllDoneButChecklist: "\uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uC758 \uB0A8\uC740 \uD56D\uBAA9\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uD604\uC7AC \uC9C4\uD589: ({checked}/{total}) \uC0AC\uC6A9\uC790\uC640 \uD655\uC778 \uD6C4 \uCDA9\uC871 \uD56D\uBAA9\uC744 [x]\uB85C \uCCB4\uD06C\uD558\uACE0 \uCD5C\uC885 \uC2B9\uC778(OK)\uC744 \uBC18\uC601\uD558\uC138\uC694.",
       finishDoingTask: '\uD604\uC7AC DOING/REVIEW \uD0DC\uC2A4\uD06C\uB97C \uC644\uB8CC\uD569\uB2C8\uB2E4: "{title}" ({done}/{total}) \uACB0\uACFC/\uAC80\uC99D \uACF5\uC720 + \uC2B9\uC778(`A` \uB610\uB294 `A OK` \uD615\uC2DD) \uD6C4 DONE \uCC98\uB9AC',
@@ -441,7 +443,7 @@ var I18N = {
       taskCommitGateWarnProceed: "\u26A0\uFE0F \uD0DC\uC2A4\uD06C \uCEE4\uBC0B \uB2E8\uC704 \uC810\uAC80 \uACBD\uACE0: {reason}. \uD604\uC7AC\uB294 \uC9C4\uD589 \uAC00\uB2A5\uD558\uC9C0\uB9CC `1 \uD0DC\uC2A4\uD06C = 1 \uCEE4\uBC0B`\uC744 \uAD8C\uC7A5\uD569\uB2C8\uB2E4.",
       taskCommitGateReasonNoTasksCommit: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4",
       taskCommitGateReasonTasksFileUnavailable: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B \uC774\uB825\uC744 \uD310\uB3C5\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4",
-      taskCommitGateReasonDoneCount: "\uCD5C\uADFC \uD504\uB85C\uC81D\uD2B8 \uCF54\uB4DC \uCEE4\uBC0B \uC810\uAC80 \uACB0\uACFC\uAC00 \uC608\uC0C1\uACFC \uB2E4\uB985\uB2C8\uB2E4 ({count})",
+      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)",
@@ -465,16 +467,21 @@ var I18N = {
       prCreateExecute: "\uD655\uC815\uB41C PR \uBCF8\uBB38\uC73C\uB85C PR\uC744 \uC0DD\uC131\uD558\uACE0, \uC0DD\uC131\uB41C PR \uB9C1\uD06C\uB97C tasks.md\uC758 PR \uD544\uB4DC\uC5D0 \uAE30\uB85D\uD558\uC138\uC694.",
       prCreateRequiredSequence: "PR \uC0DD\uC131\uC740 \uD544\uC218 2\uB2E8\uACC4\uC785\uB2C8\uB2E4: (1) PR \uBCF8\uBB38 \uD15C\uD50C\uB9BF \uC0DD\uC131/\uBCF4\uC644 + \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK), (2) PR \uC0DD\uC131 + tasks.md PR \uB9C1\uD06C \uAE30\uB85D. \uC704 \uC21C\uC11C\uB97C \uBAA8\uB450 \uC644\uB8CC\uD558\uC138\uC694.",
       prFillStatus: "tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC124\uC815\uD558\uC138\uC694. (PR \uC0DD\uC131/\uB9AC\uBDF0 \uB2E8\uACC4\uC5D0\uC11C\uB294 Review\uB97C \uC720\uC9C0\uD569\uB2C8\uB2E4.)",
+      prReviewMergedSyncStatus: "\uC6D0\uACA9 PR\uC774 \uC774\uBBF8 \uBA38\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4. tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Approved\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694. (PR/\uB9AC\uBDF0 \uADFC\uAC70 \uD544\uB4DC\uB3C4 \uCD5C\uC2E0 \uC0C1\uD0DC\uB85C \uD655\uC778)",
       prResolveReview: "\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD574\uACB0\uD558\uB294 \uB3D9\uC548 PR \uC0C1\uD0DC\uB294 Review\uB85C \uC720\uC9C0\uD558\uC138\uC694. \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB294 \uD0DC\uC2A4\uD06C\uBA85\uC774 \uC544\uB2C8\uB77C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uC9C0\uC801\uC0AC\uD56D \uC694\uC57D\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694. \uBA38\uC9C0 \uC900\uBE44\uAC00 \uB418\uBA74 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `npx lee-spec-kit github pr {featureRef} --merge --confirm OK`\uB97C \uC2E4\uD589\uD558\uC138\uC694. (\uC131\uACF5 \uC2DC PR \uC0C1\uD0DC\uAC00 Approved\uB85C \uB3D9\uAE30\uD654\uB429\uB2C8\uB2E4.)",
       prReviewResolve: "\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uBA3C\uC800 \uD655\uC778/\uBD84\uC11D\uD55C \uB4A4 \uD544\uC694\uD55C \uC218\uC815 \uC791\uC5C5\uC744 \uC9C4\uD589\uD558\uC138\uC694. \uC9C4\uD589 \uC911\uC5D0\uB294 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC720\uC9C0\uD558\uC138\uC694. \uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B \uBA54\uC2DC\uC9C0\uB294 \uD0DC\uC2A4\uD06C\uBA85\uC774 \uC544\uB2C8\uB77C \uC2E4\uC81C\uB85C \uD574\uACB0\uD55C \uB9AC\uBDF0 \uC9C0\uC801\uC0AC\uD56D \uC694\uC57D\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694. `PR \uB9AC\uBDF0 Findings/Evidence`\uB97C \uCD5C\uC2E0\uC73C\uB85C \uAE30\uB85D\uD558\uACE0, \uCEE4\uBC0B \uD6C4 \uC6D0\uACA9 \uBC18\uC601(push)\uB3C4 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK)\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589\uD558\uC138\uC694.",
-      prReviewPush: '\uB9AC\uBDF0 \uC218\uC815 \uCEE4\uBC0B\uC744 \uC6D0\uACA9 PR \uBE0C\uB79C\uCE58\uC5D0 \uBC18\uC601\uD558\uB824\uBA74 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `cd "{projectGitCwd}" && git push`\uB97C \uC2E4\uD589\uD558\uC138\uC694.',
+      prReviewPush: 'cd "{projectGitCwd}" && git push',
       prReviewRemoteBlocked: "\uC6D0\uACA9 PR \uC0C1\uD0DC\uB97C \uD655\uC778\uD55C \uACB0\uACFC \uC544\uC9C1 \uBA38\uC9C0 \uC900\uBE44\uAC00 \uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4: {reasons}. \uB9AC\uBDF0 \uCF54\uBA58\uD2B8/\uCCB4\uD06C \uC0C1\uD0DC\uB97C \uC815\uB9AC\uD55C \uB4A4 \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694.",
       prReviewRemoteReasonChangesRequested: "\uB9AC\uBDF0 \uC2B9\uC778 \uC0C1\uD0DC\uAC00 \uBCC0\uACBD \uC694\uCCAD \uB610\uB294 \uCD94\uAC00 \uB9AC\uBDF0 \uD544\uC694 \uC0C1\uD0DC\uC785\uB2C8\uB2E4",
+      prReviewRemoteReasonClosed: "PR\uC774 \uBA38\uC9C0\uB418\uC9C0 \uC54A\uC740 \uCC44 \uB2EB\uD600 \uC788\uC2B5\uB2C8\uB2E4 (reopen \uB610\uB294 \uC0C8 PR \uD544\uC694)",
       prReviewRemoteReasonChecksFailing: "\uC2E4\uD328\uD55C \uCCB4\uD06C\uAC00 {count}\uAC74 \uC788\uC2B5\uB2C8\uB2E4",
       prReviewRemoteReasonChecksPending: "\uB300\uAE30 \uC911\uC778 \uCCB4\uD06C\uAC00 {count}\uAC74 \uC788\uC2B5\uB2C8\uB2E4",
       prReviewRemoteReasonMergeBlocked: "\uBA38\uC9C0 \uC0C1\uD0DC\uAC00 `{status}`\uB85C \uCC28\uB2E8\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4",
+      prReviewRemoteReasonUnavailable: "\uC6D0\uACA9 PR \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4 (gh \uC778\uC99D/\uB124\uD2B8\uC6CC\uD06C/\uAD8C\uD55C \uD655\uC778 \uD544\uC694)",
       prReviewMerge: "\uBA38\uC9C0 \uC900\uBE44\uAC00 \uB418\uBA74 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `npx lee-spec-kit github pr {featureRef} --merge --confirm OK`\uB97C \uC2E4\uD589\uD558\uC138\uC694. (\uC131\uACF5 \uC2DC PR \uC0C1\uD0DC\uAC00 Approved\uB85C \uB3D9\uAE30\uD654\uB429\uB2C8\uB2E4.)",
+      prReviewMergeCommand: "npx lee-spec-kit github pr {featureRef} --merge --confirm OK",
       prRequestReview: "\uB9AC\uBDF0\uC5B4\uC5D0\uAC8C \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uACE0 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC124\uC815/\uC720\uC9C0\uD558\uC138\uC694.",
+      userRequestReplan: "\uD604\uC7AC \uB2E8\uACC4\uC640 \uBCC4\uAC1C\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC81C\uC548\uD55C \uC0C8 \uC694\uAD6C\uB97C \uBA3C\uC800 \uBC18\uC601\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC694\uAD6C\uC0AC\uD56D\uC744 \uC694\uC57D\uD574 tasks.md\uC5D0 \uCD94\uAC00\uD558\uAC70\uB098 \uBCC4\uB3C4 Feature\uB85C \uBD84\uB9AC\uD55C \uB4A4, \uBB38\uC11C \uC0C1\uD0DC\uB97C \uB9DE\uCD94\uACE0 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
       featureDone: "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC694\uAD6C\uC0AC\uD56D\uACFC \uBAA8\uB4E0 \uD0DC\uC2A4\uD06C/\uC644\uB8CC \uC870\uAC74\uC774 \uCDA9\uC871\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uB8CC \uC0C1\uD0DC\uC785\uB2C8\uB2E4.",
       fallbackRerunContext: "\uC0C1\uD0DC\uB97C \uD310\uBCC4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694."
     },
@@ -589,6 +596,7 @@ var I18N = {
       "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.suggestion.createFeature": "Create a new feature",
+      "context.suggestion.runOnboard": "Run onboarding checks",
       "context.suggestion.showDone": "Show completed features",
       "context.suggestion.showAll": "Show all features",
       "context.suggestion.selectFeature": "Select a feature and open detailed context",
@@ -652,6 +660,7 @@ var I18N = {
       "init.log.nextStepsTitle": "Next steps:",
       "init.log.nextSteps1": "  1. Write {docsDir}/prd/README.md",
       "init.log.nextSteps2": "  2. Add a feature with: npx lee-spec-kit feature <name>",
+      "init.log.nextSteps3": "  3. Run setup checks: npx lee-spec-kit onboard --strict",
       "init.log.gitRepoDetectedCommit": "\u{1F4E6} Git repo detected, committing docs...",
       "init.log.gitInit": "\u{1F4E6} Initializing Git...",
       "init.warn.stagedChangesSkip": '\u26A0\uFE0F  There are already staged changes in the Git index. (With --dir ".", commit scope cannot be safely restricted, so auto-commit is skipped.)',
@@ -724,7 +733,7 @@ var I18N = {
       "github.operationPrMerge": "GitHub PR merge",
       "github.createIssueFailed": "Failed to create GitHub issue",
       "github.createPrFailed": "Failed to create GitHub PR",
-      "github.mergeRequiresPr": "`--merge` requires `--create` or `--pr <url|number>`.",
+      "github.mergeRequiresPr": "`--merge` requires `--create`, `--pr <url|number>`, or a PR link in tasks.md.",
       "github.checkoutBaseAfterMergeFailed": "Failed to checkout {base} after merge",
       "github.pullBaseAfterMergeFailed": "Failed to update {base} after merge",
       "github.issueDefaultTitle": "{slug} ({summary})",
@@ -881,7 +890,7 @@ var I18N = {
       reviewFixCommitIssueGuidance: 'Commit PR review fixes. The commit message must summarize review comments resolved in this commit, not reuse a task title. Example: `cd "{projectGitCwd}" && (git diff --cached --quiet && echo "No staged files. Stage only files that implement review fixes with git add [files], then run again." && exit 1 || git commit -m "fix(#{issueNumber}): <review-fix-summary>")` (replace `<review-fix-summary>` with what this commit actually resolves).',
       reviewFixCommitGuidance: 'Commit PR review fixes. The commit message must summarize review comments resolved in this commit, not reuse a task title. Example: `cd "{projectGitCwd}" && (git diff --cached --quiet && echo "No staged files. Stage only files that implement review fixes with git add [files], then run again." && exit 1 || git commit -m "fix(review): <review-fix-summary>")` (replace `<review-fix-summary>` with what this commit actually resolves).',
       standaloneNeedsProjectRoot: "Standalone mode requires projectRoot. (npx lee-spec-kit config --project-root ...)",
-      createBranch: 'cd "{projectGitCwd}" && git checkout -b feat/{issueNumber}-{slug}',
+      createBranch: 'cd "{projectGitCwd}" && mkdir -p .worktrees && (git worktree add ".worktrees/feat-{issueNumber}-{slug}" "feat/{issueNumber}-{slug}" || git worktree add -b "feat/{issueNumber}-{slug}" ".worktrees/feat-{issueNumber}-{slug}") && echo "worktree: {projectGitCwd}/.worktrees/feat-{issueNumber}-{slug}"',
       tasksAllDoneButNoChecklist: 'Create the completion checklist. Add verification items to the tasks.md "Completion Criteria" section, then mark satisfied items as [x] after user confirmation. Record final approval (OK) as well.',
       tasksAllDoneButChecklist: "Proceed with remaining completion checklist items. Current progress: ({checked}/{total}) Mark items as [x] only after user confirmation and real verification. Record final approval (OK) as well.",
       finishDoingTask: 'Finish the current DOING/REVIEW task: "{title}" ({done}/{total}) Share outcome/verification + get OK before marking DONE',
@@ -891,7 +900,7 @@ var I18N = {
       taskCommitGateWarnProceed: "\u26A0\uFE0F Task commit boundary warning: {reason}. You may continue, but `1 task = 1 commit` is recommended.",
       taskCommitGateReasonNoTasksCommit: "No recent project code commit was found",
       taskCommitGateReasonTasksFileUnavailable: "Cannot read recent project code commit history",
-      taskCommitGateReasonDoneCount: "Project commit gate check result is unexpected ({count})",
+      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)",
@@ -915,16 +924,21 @@ var I18N = {
       prCreateExecute: "Create the PR with the finalized body, then record the created PR link in tasks.md.",
       prCreateRequiredSequence: "PR creation is a required 2-step sequence: (1) generate/refine PR body template + explicit user OK, (2) create PR + record PR link in tasks.md. Complete both in order.",
       prFillStatus: "Set PR Status in tasks.md to Review. (Keep Review during PR creation/review stages.)",
+      prReviewMergedSyncStatus: "The remote PR is already merged. Update PR Status in tasks.md to Approved. (Also verify PR/review evidence fields are up to date.)",
       prResolveReview: "Keep PR Status as Review while addressing comments. For review-fix commits, use commit messages that summarize resolved review feedback (not task titles). Once ready to merge, get explicit user OK and run `npx lee-spec-kit github pr {featureRef} --merge --confirm OK`. (On success, PR Status is synced to Approved.)",
       prReviewResolve: "First review/analyze the PR comments, then apply the required fixes. Keep PR Status as Review while addressing comments. For review-fix commits, use commit messages that summarize resolved review feedback (not task titles). Keep `PR Review Findings/Evidence` updated, then run push only after explicit user OK.",
-      prReviewPush: 'To reflect review-fix commits on the PR head branch, get explicit user OK and run `cd "{projectGitCwd}" && git push`.',
+      prReviewPush: 'cd "{projectGitCwd}" && git push',
       prReviewRemoteBlocked: "Remote PR checks indicate this PR is not ready to merge yet: {reasons}. Resolve review comments/check statuses, then re-check.",
       prReviewRemoteReasonChangesRequested: "review decision is changes requested or additional review required",
+      prReviewRemoteReasonClosed: "PR is closed without merge (reopen or create a new PR)",
       prReviewRemoteReasonChecksFailing: "{count} failing check(s) detected",
       prReviewRemoteReasonChecksPending: "{count} pending check(s) detected",
       prReviewRemoteReasonMergeBlocked: "merge state is blocked (`{status}`)",
+      prReviewRemoteReasonUnavailable: "remote PR status could not be verified (check gh auth/network/permissions)",
       prReviewMerge: "When ready to merge, get explicit user OK and run `npx lee-spec-kit github pr {featureRef} --merge --confirm OK`. (On success, PR Status is synced to Approved.)",
+      prReviewMergeCommand: "npx lee-spec-kit github pr {featureRef} --merge --confirm OK",
       prRequestReview: "Request review and set/keep PR Status as Review.",
+      userRequestReplan: "You can pause this step and handle a newly requested user requirement first. Summarize it, add it to tasks.md or split it into a separate Feature, then align document statuses and rerun context.",
       featureDone: "Workflow requirements and all tasks/completion criteria are satisfied. This feature is done.",
       fallbackRerunContext: "Cannot determine status. Check the docs and run context again."
     },
@@ -1345,10 +1359,10 @@ function sleep(ms) {
   return new Promise((resolve) => globalThis.setTimeout(resolve, ms));
 }
 function toScopeKey(value) {
-  return createHash("sha1").update(path19.resolve(value)).digest("hex").slice(0, 16);
+  return createHash("sha1").update(path20.resolve(value)).digest("hex").slice(0, 16);
 }
 function getTempRuntimeDir(scopePath) {
-  return path19.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
+  return path20.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
 }
 function resolveGitRuntimeDir(cwd) {
   try {
@@ -1362,38 +1376,38 @@ function resolveGitRuntimeDir(cwd) {
       }
     ).trim();
     if (!out) return null;
-    return path19.isAbsolute(out) ? out : path19.resolve(cwd, out);
+    return path20.isAbsolute(out) ? out : path20.resolve(cwd, out);
   } catch {
     return null;
   }
 }
 function getRuntimeStateDir(cwd) {
-  const resolved = path19.resolve(cwd);
+  const resolved = path20.resolve(cwd);
   return resolveGitRuntimeDir(resolved) ?? getTempRuntimeDir(resolved);
 }
 function getDocsLockPath(docsDir) {
-  return path19.join(
+  return path20.join(
     getRuntimeStateDir(docsDir),
     "locks",
     `docs-${toScopeKey(docsDir)}.lock`
   );
 }
 function getInitLockPath(targetDir) {
-  return path19.join(
-    getRuntimeStateDir(path19.dirname(path19.resolve(targetDir))),
+  return path20.join(
+    getRuntimeStateDir(path20.dirname(path20.resolve(targetDir))),
     "locks",
     `init-${toScopeKey(targetDir)}.lock`
   );
 }
 function getApprovalTicketStorePath(docsDir) {
-  return path19.join(
+  return path20.join(
     getRuntimeStateDir(docsDir),
     "tickets",
     `approval-${toScopeKey(docsDir)}.json`
   );
 }
 function getProjectExecutionLockPath(cwd) {
-  return path19.join(getRuntimeStateDir(cwd), "locks", "project.lock");
+  return path20.join(getRuntimeStateDir(cwd), "locks", "project.lock");
 }
 async function isStaleLock(lockPath, staleMs) {
   try {
@@ -1434,7 +1448,7 @@ function isProcessAlive(pid) {
   }
 }
 async function tryAcquire(lockPath, owner) {
-  await fs15.ensureDir(path19.dirname(lockPath));
+  await fs15.ensureDir(path20.dirname(lockPath));
   try {
     const fd = await fs15.open(lockPath, "wx");
     const payload = JSON.stringify(
@@ -1511,30 +1525,30 @@ var ENGINE_MANAGED_AGENT_FILES = [
   "pr-template.md"
 ];
 var ENGINE_MANAGED_AGENT_DIRS = ["skills"];
-var ENGINE_MANAGED_FEATURE_PATH = path19.join(
+var ENGINE_MANAGED_FEATURE_PATH = path20.join(
   "features",
   "feature-base"
 );
 async function pruneEngineManagedDocs(docsDir) {
   const removed = [];
   for (const file of ENGINE_MANAGED_AGENT_FILES) {
-    const target = path19.join(docsDir, "agents", file);
+    const target = path20.join(docsDir, "agents", file);
     if (await fs15.pathExists(target)) {
       await fs15.remove(target);
-      removed.push(path19.relative(docsDir, target));
+      removed.push(path20.relative(docsDir, target));
     }
   }
   for (const dir of ENGINE_MANAGED_AGENT_DIRS) {
-    const target = path19.join(docsDir, "agents", dir);
+    const target = path20.join(docsDir, "agents", dir);
     if (await fs15.pathExists(target)) {
       await fs15.remove(target);
-      removed.push(path19.relative(docsDir, target));
+      removed.push(path20.relative(docsDir, target));
     }
   }
-  const featureBasePath = path19.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
+  const featureBasePath = path20.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
   if (await fs15.pathExists(featureBasePath)) {
     await fs15.remove(featureBasePath);
-    removed.push(path19.relative(docsDir, featureBasePath));
+    removed.push(path20.relative(docsDir, featureBasePath));
   }
   return removed;
 }
@@ -1675,7 +1689,7 @@ ${tr(lang2, "cli", "common.canceled")}`)
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path19.basename(cwd);
+  const defaultName = path20.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let components = parseComponentsOption(options.components);
@@ -1688,7 +1702,7 @@ async function runInit(options) {
   const componentProjectRoots = parseComponentProjectRootsOption(
     options.componentProjectRoots
   );
-  const targetDir = path19.resolve(cwd, options.dir || "./docs");
+  const targetDir = path20.resolve(cwd, options.dir || "./docs");
   const skipPrompts = !!options.yes || !!options.nonInteractive;
   if (options.docsRepo && !["embedded", "standalone"].includes(options.docsRepo)) {
     throw createCliError(
@@ -2077,7 +2091,7 @@ async function runInit(options) {
       );
       console.log();
       const templatesDir = getTemplatesDir();
-      const commonPath = path19.join(templatesDir, lang, "common");
+      const commonPath = path20.join(templatesDir, lang, "common");
       if (!await fs15.pathExists(commonPath)) {
         throw new Error(
           tr(lang, "cli", "init.error.templateNotFound", { path: commonPath })
@@ -2085,11 +2099,11 @@ async function runInit(options) {
       }
       await copyTemplates(commonPath, targetDir);
       if (projectType === "multi") {
-        const featuresRoot = path19.join(targetDir, "features");
+        const featuresRoot = path20.join(targetDir, "features");
         for (const component of components) {
-          const componentDir = path19.join(featuresRoot, component);
+          const componentDir = path20.join(featuresRoot, component);
           await fs15.ensureDir(componentDir);
-          const readmePath = path19.join(componentDir, "README.md");
+          const readmePath = path20.join(componentDir, "README.md");
           if (!await fs15.pathExists(readmePath)) {
             await fs15.writeFile(
               readmePath,
@@ -2118,7 +2132,7 @@ async function runInit(options) {
         workflow: {
           mode: workflowMode,
           codeDirtyScope: "auto",
-          taskCommitGate: "strict",
+          taskCommitGate: "warn",
           prePrReview: {
             skills: ["code-review-excellence"],
             minorPolicy: "warn"
@@ -2142,7 +2156,7 @@ async function runInit(options) {
           config.projectRoot = projectRoot;
         }
       }
-      const configPath = path19.join(targetDir, ".lee-spec-kit.json");
+      const configPath = path20.join(targetDir, ".lee-spec-kit.json");
       await fs15.writeJson(configPath, config, { spaces: 2 });
       console.log(chalk6.green(tr(lang, "cli", "init.log.docsCreated")));
       console.log();
@@ -2152,6 +2166,7 @@ async function runInit(options) {
         chalk6.gray(tr(lang, "cli", "init.log.nextSteps1", { docsDir: targetDir }))
       );
       console.log(chalk6.gray(tr(lang, "cli", "init.log.nextSteps2")));
+      console.log(chalk6.gray(tr(lang, "cli", "init.log.nextSteps3")));
       console.log();
     },
     { owner: "init" }
@@ -2159,7 +2174,8 @@ async function runInit(options) {
 }
 async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
   try {
-    const runGit = (args, workdir) => {
+    const gitWorkdir = docsRepo === "standalone" ? targetDir : cwd;
+    const runGit2 = (args, workdir) => {
       execFileSync("git", args, { cwd: workdir, stdio: "ignore" });
     };
     const getCachedStagedFiles = (workdir) => {
@@ -2205,14 +2221,14 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
       }
     };
     try {
-      runGit(["rev-parse", "--is-inside-work-tree"], cwd);
+      runGit2(["rev-parse", "--is-inside-work-tree"], gitWorkdir);
       console.log(chalk6.blue(tr(lang, "cli", "init.log.gitRepoDetectedCommit")));
     } catch {
       console.log(chalk6.blue(tr(lang, "cli", "init.log.gitInit")));
-      runGit(["init"], cwd);
+      runGit2(["init"], gitWorkdir);
     }
-    const relativePath = path19.relative(cwd, targetDir);
-    const stagedBeforeAdd = getCachedStagedFiles(cwd);
+    const relativePath = docsRepo === "standalone" ? "." : path20.relative(cwd, targetDir);
+    const stagedBeforeAdd = getCachedStagedFiles(gitWorkdir);
     if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
       console.log(
         chalk6.yellow(
@@ -2223,8 +2239,8 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
       console.log();
       return;
     }
-    if (relativePath !== "." && isPathIgnored(cwd, relativePath)) {
-      const repoRelativePath = toRepoRelativePath(cwd, relativePath);
+    if (relativePath !== "." && isPathIgnored(gitWorkdir, relativePath)) {
+      const repoRelativePath = toRepoRelativePath(gitWorkdir, relativePath);
       console.log(
         chalk6.yellow(
           tr(lang, "cli", "init.warn.docsPathIgnoredSkipCommit", {
@@ -2242,14 +2258,14 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
       console.log();
       return;
     }
-    runGit(["add", relativePath], cwd);
-    runGit(
+    runGit2(["add", relativePath], gitWorkdir);
+    runGit2(
       ["commit", "-m", "init: docs \uAD6C\uC870 \uCD08\uAE30\uD654 (lee-spec-kit)", "--", relativePath],
-      cwd
+      gitWorkdir
     );
     if (docsRepo === "standalone" && pushDocs && docsRemote) {
       try {
-        runGit(["remote", "add", "origin", docsRemote], cwd);
+        runGit2(["remote", "add", "origin", docsRemote], gitWorkdir);
         console.log(
           chalk6.green(tr(lang, "cli", "init.log.gitRemoteSet", { remote: docsRemote }))
         );
@@ -2268,17 +2284,17 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
 }
 function getAncestorDirs(startDir) {
   const dirs = [];
-  let current = path19.resolve(startDir);
+  let current = path20.resolve(startDir);
   while (true) {
     dirs.push(current);
-    const parent = path19.dirname(current);
+    const parent = path20.dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return dirs;
 }
 function hasWorkspaceBoundary(dir) {
-  return fs15.existsSync(path19.join(dir, "package.json")) || fs15.existsSync(path19.join(dir, ".git"));
+  return fs15.existsSync(path20.join(dir, "package.json")) || fs15.existsSync(path20.join(dir, ".git"));
 }
 function getSearchBaseDirs(cwd) {
   const ancestors = getAncestorDirs(cwd);
@@ -2294,7 +2310,7 @@ function normalizeComponentKeys(value) {
   return Object.keys(value).map((key) => key.trim().toLowerCase()).filter(Boolean);
 }
 async function inferComponentsFromFeaturesDir(docsDir) {
-  const featuresPath = path19.join(docsDir, "features");
+  const featuresPath = path20.join(docsDir, "features");
   if (!await fs15.pathExists(featuresPath)) return [];
   const entries = await fs15.readdir(featuresPath, { withFileTypes: true });
   const inferred = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name.trim().toLowerCase()).filter(
@@ -2305,21 +2321,21 @@ async function inferComponentsFromFeaturesDir(docsDir) {
 async function getConfig(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
-    ...explicitDocsDir ? [path19.resolve(explicitDocsDir)] : [],
+    ...explicitDocsDir ? [path20.resolve(explicitDocsDir)] : [],
     ...getSearchBaseDirs(cwd)
   ];
   const visitedBaseDirs = /* @__PURE__ */ new Set();
   const visitedDocsDirs = /* @__PURE__ */ new Set();
   for (const baseDir of baseDirs) {
-    const resolvedBaseDir = path19.resolve(baseDir);
+    const resolvedBaseDir = path20.resolve(baseDir);
     if (visitedBaseDirs.has(resolvedBaseDir)) continue;
     visitedBaseDirs.add(resolvedBaseDir);
-    const possibleDocsDirs = [path19.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    const possibleDocsDirs = [path20.join(resolvedBaseDir, "docs"), resolvedBaseDir];
     for (const docsDir of possibleDocsDirs) {
-      const resolvedDocsDir = path19.resolve(docsDir);
+      const resolvedDocsDir = path20.resolve(docsDir);
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
-      const configPath = path19.join(resolvedDocsDir, ".lee-spec-kit.json");
+      const configPath = path20.join(resolvedDocsDir, ".lee-spec-kit.json");
       if (await fs15.pathExists(configPath)) {
         try {
           const configFile = await fs15.readJson(configPath);
@@ -2349,16 +2365,16 @@ async function getConfig(cwd) {
         } catch {
         }
       }
-      const agentsPath = path19.join(resolvedDocsDir, "agents");
-      const featuresPath = path19.join(resolvedDocsDir, "features");
+      const agentsPath = path20.join(resolvedDocsDir, "agents");
+      const featuresPath = path20.join(resolvedDocsDir, "features");
       if (await fs15.pathExists(agentsPath) && await fs15.pathExists(featuresPath)) {
         const inferredComponents = await inferComponentsFromFeaturesDir(resolvedDocsDir);
         const projectType = inferredComponents.length > 0 ? "multi" : "single";
         const components = projectType === "multi" ? resolveProjectComponents("multi", inferredComponents) : void 0;
         const langProbeCandidates = [
-          path19.join(agentsPath, "custom.md"),
-          path19.join(agentsPath, "constitution.md"),
-          path19.join(agentsPath, "agents.md")
+          path20.join(agentsPath, "custom.md"),
+          path20.join(agentsPath, "constitution.md"),
+          path20.join(agentsPath, "agents.md")
         ];
         let lang = "en";
         for (const candidate of langProbeCandidates) {
@@ -2424,13 +2440,13 @@ async function patchMarkdownIfExists(filePath, transform) {
   await fs15.writeFile(filePath, transform(content), "utf-8");
 }
 async function applyLocalWorkflowTemplateToFeatureDir(featureDir, lang) {
-  await patchMarkdownIfExists(path19.join(featureDir, "spec.md"), sanitizeSpecForLocal);
+  await patchMarkdownIfExists(path20.join(featureDir, "spec.md"), sanitizeSpecForLocal);
   await patchMarkdownIfExists(
-    path19.join(featureDir, "tasks.md"),
+    path20.join(featureDir, "tasks.md"),
     (content) => sanitizeTasksForLocal(content, lang)
   );
-  await fs15.remove(path19.join(featureDir, "issue.md"));
-  await fs15.remove(path19.join(featureDir, "pr.md"));
+  await fs15.remove(path20.join(featureDir, "issue.md"));
+  await fs15.remove(path20.join(featureDir, "pr.md"));
 }
 // src/commands/feature.ts
@@ -2575,19 +2591,19 @@ async function runFeature(name, options) {
       }
       let featuresDir;
       if (projectType === "multi") {
-        featuresDir = path19.join(docsDir, "features", component);
+        featuresDir = path20.join(docsDir, "features", component);
       } else {
-        featuresDir = path19.join(docsDir, "features");
+        featuresDir = path20.join(docsDir, "features");
       }
       const featureFolderName = `${featureId}-${name}`;
-      const featureDir = path19.join(featuresDir, featureFolderName);
+      const featureDir = path20.join(featuresDir, featureFolderName);
       if (await fs15.pathExists(featureDir)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "feature.folderExists", { path: featureDir })
         );
       }
-      const featureBasePath = path19.join(
+      const featureBasePath = path20.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -2646,7 +2662,7 @@ async function runFeature(name, options) {
         featureName: name,
         component: projectType === "multi" ? component : void 0,
         featurePath: featureDir,
-        featurePathFromDocs: path19.relative(docsDir, featureDir)
+        featurePathFromDocs: path20.relative(docsDir, featureDir)
       };
     },
     { owner: "feature" }
@@ -2658,9 +2674,9 @@ function sleep2(ms) {
 async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const candidates = [
-    ...explicitDocsDir ? [path19.resolve(explicitDocsDir)] : [],
-    path19.resolve(cwd, "docs"),
-    path19.resolve(cwd)
+    ...explicitDocsDir ? [path20.resolve(explicitDocsDir)] : [],
+    path20.resolve(cwd, "docs"),
+    path20.resolve(cwd)
   ];
   const endAt = Date.now() + timeoutMs;
   while (Date.now() < endAt) {
@@ -2687,11 +2703,11 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   return getConfig(cwd);
 }
 async function getNextFeatureId(docsDir, projectType, components) {
-  const featuresDir = path19.join(docsDir, "features");
+  const featuresDir = path20.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "multi") {
-    scanDirs.push(...components.map((component) => path19.join(featuresDir, component)));
+    scanDirs.push(...components.map((component) => path20.join(featuresDir, component)));
   } else {
     scanDirs.push(featuresDir);
   }
@@ -2840,6 +2856,9 @@ function getPrReviewRemoteBlockReasons(feature, lang) {
   const remote = feature.pr.remote;
   if (!remote || !remote.available) return [];
   const reasons = [];
+  if (remote.state === "CLOSED" && !remote.isMerged) {
+    reasons.push(tr(lang, "messages", "prReviewRemoteReasonClosed"));
+  }
   if (remote.hasBlockingReview) {
     reasons.push(tr(lang, "messages", "prReviewRemoteReasonChangesRequested"));
   }
@@ -2905,14 +2924,90 @@ function normalizeTaskTopic(value) {
 function normalizeCommitSubjectForGate(value) {
   return normalizeCommitTopicText(value).replace(/^[a-z]+(?:\([^)]*\))?!?:\s*/i, "").toLowerCase();
 }
+function toTaskKey(rawTitle) {
+  const trimmed = normalizeCommitTopicText(rawTitle);
+  if (!trimmed) return "";
+  const idMatch = trimmed.match(/^(T-[A-Za-z0-9-]+)/i);
+  if (idMatch) return idMatch[1].toUpperCase();
+  return normalizeTaskTopic(trimmed).toLowerCase();
+}
+function countDoneTransitionsInLatestTasksCommit(feature) {
+  const docsGitCwd = feature.git.docsGitCwd;
+  const tasksRelativePath = normalizeGitRelativePath(
+    path20.join(feature.docs.featurePathFromDocs, "tasks.md")
+  );
+  const diff = readGitText(docsGitCwd, [
+    "diff",
+    "--unified=0",
+    "--no-color",
+    "HEAD~1",
+    "HEAD",
+    "--",
+    tasksRelativePath
+  ]);
+  if (diff === void 0) return 0;
+  if (!diff.trim()) return 0;
+  const removedByTask = /* @__PURE__ */ new Map();
+  const addedByTask = /* @__PURE__ */ new Map();
+  const parseTaskLine = (line) => {
+    const match = line.match(/^\s*-\s*\[(TODO|DOING|DONE|REVIEW)\]\s+(.+?)\s*$/i);
+    if (!match) return null;
+    const key = toTaskKey(match[2]);
+    if (!key) return null;
+    return {
+      key,
+      status: match[1].toUpperCase()
+    };
+  };
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("---") || line.startsWith("+++")) continue;
+    if (line.startsWith("-")) {
+      const parsed = parseTaskLine(line.slice(1));
+      if (!parsed) continue;
+      const existing = removedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
+      existing.add(parsed.status);
+      removedByTask.set(parsed.key, existing);
+      continue;
+    }
+    if (line.startsWith("+")) {
+      const parsed = parseTaskLine(line.slice(1));
+      if (!parsed) continue;
+      const existing = addedByTask.get(parsed.key) || /* @__PURE__ */ new Set();
+      existing.add(parsed.status);
+      addedByTask.set(parsed.key, existing);
+    }
+  }
+  let doneTransitions = 0;
+  for (const [taskKey, addedStatuses] of addedByTask.entries()) {
+    if (!addedStatuses.has("DONE")) continue;
+    const removedStatuses = removedByTask.get(taskKey);
+    if (!removedStatuses) continue;
+    const transitionedFromOpen = removedStatuses.has("TODO") || removedStatuses.has("DOING") || removedStatuses.has("REVIEW");
+    if (transitionedFromOpen) {
+      doneTransitions += 1;
+    }
+  }
+  return doneTransitions;
+}
 function checkTaskCommitGate(feature) {
+  const doneTransitions = countDoneTransitionsInLatestTasksCommit(feature);
+  if (doneTransitions === 0) {
+    return { pass: true, doneTransitions };
+  }
+  if (typeof doneTransitions === "number" && doneTransitions > 1) {
+    return {
+      pass: false,
+      reason: "DONE_TRANSITIONS_COUNT",
+      doneTransitions
+    };
+  }
   const projectGitCwd = feature.git.projectGitCwd;
   const lastDoneTopic = normalizeTaskTopic(feature.lastDoneTask?.title || "");
   if (!projectGitCwd || !lastDoneTopic) {
     return { pass: true };
   }
   const args = ["log", "-n", "1", "--pretty=%s", "--", "."];
-  const relativeDocsDir = path19.relative(projectGitCwd, feature.git.docsGitCwd);
+  const relativeDocsDir = path20.relative(projectGitCwd, feature.git.docsGitCwd);
   const normalizedDocsDir = normalizeGitRelativePath(relativeDocsDir);
   if (normalizedDocsDir && normalizedDocsDir !== "." && normalizedDocsDir !== ".." && !normalizedDocsDir.startsWith("../")) {
     args.push(`:(exclude)${normalizedDocsDir}/**`);
@@ -2933,6 +3028,10 @@ function checkTaskCommitGate(feature) {
 }
 function getTaskCommitGateReasonText(lang, check) {
   switch (check.reason) {
+    case "DONE_TRANSITIONS_COUNT":
+      return tr(lang, "messages", "taskCommitGateReasonDoneCount", {
+        count: check.doneTransitions || 0
+      });
     case "NO_PROJECT_COMMIT":
       return tr(lang, "messages", "taskCommitGateReasonNoTasksCommit");
     case "PROJECT_LOG_UNAVAILABLE":
@@ -3746,6 +3845,16 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
             ];
           }
           if (f.pr.status === "Review") {
+            if (f.pr.remote?.available && f.pr.remote.isMerged) {
+              return [
+                {
+                  type: "instruction",
+                  category: "pr_status_update",
+                  requiresUserCheck: true,
+                  message: tr(lang, "messages", "prReviewMergedSyncStatus")
+                }
+              ];
+            }
             if (!f.docs.prReviewFindingsFieldExists) {
               return [
                 {
@@ -3787,6 +3896,7 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
               ];
             }
             const remoteBlockReasons = getPrReviewRemoteBlockReasons(f, lang);
+            const remoteUnavailable = workflowPolicy.mode === "github" && !!f.pr.link && (!f.pr.remote || !f.pr.remote.available);
             const actions = [
               {
                 type: "instruction",
@@ -3814,16 +3924,41 @@ ${tr(lang, "messages", "taskCommitGateWarnProceed", {
                 })
               });
             }
-            actions.push({
-              type: "instruction",
-              category: "code_review",
-              requiresUserCheck: true,
-              message: remoteBlockReasons.length > 0 ? tr(lang, "messages", "prReviewRemoteBlocked", {
-                reasons: remoteBlockReasons.join("; ")
-              }) : tr(lang, "messages", "prReviewMerge", {
-                featureRef: f.id || f.folderName
-              })
-            });
+            if (remoteBlockReasons.length > 0 || remoteUnavailable) {
+              const reasons = [...remoteBlockReasons];
+              if (remoteUnavailable) {
+                reasons.push(tr(lang, "messages", "prReviewRemoteReasonUnavailable"));
+              }
+              actions.push({
+                type: "instruction",
+                category: "code_review",
+                requiresUserCheck: true,
+                message: tr(lang, "messages", "prReviewRemoteBlocked", {
+                  reasons: reasons.join("; ")
+                })
+              });
+            } else if (f.git.docsGitCwd) {
+              actions.push({
+                type: "command",
+                category: "code_review",
+                requiresUserCheck: true,
+                operationType: "remote",
+                scope: "docs",
+                cwd: f.git.docsGitCwd,
+                cmd: tr(lang, "messages", "prReviewMergeCommand", {
+                  featureRef: f.id || f.folderName
+                })
+              });
+            } else {
+              actions.push({
+                type: "instruction",
+                category: "code_review",
+                requiresUserCheck: true,
+                message: tr(lang, "messages", "prReviewMerge", {
+                  featureRef: f.id || f.folderName
+                })
+              });
+            }
             return actions;
           }
           return [
@@ -3901,14 +4036,32 @@ function applyApprovalPolicy(step, actions, approval) {
     return { ...a, requiresUserCheck };
   });
 }
+function withUserRequestReplanOption(actions, lang) {
+  if (actions.some((action) => action.category === "user_request_replan")) {
+    return actions;
+  }
+  return [
+    ...actions,
+    {
+      type: "instruction",
+      category: "user_request_replan",
+      requiresUserCheck: true,
+      message: tr(lang, "messages", "userRequestReplan")
+    }
+  ];
+}
 function resolveFeatureProgress(feature, stepDefinitions, lang, approval) {
   const ordered = [...stepDefinitions].sort((a, b) => a.step - b.step);
   for (const definition of ordered) {
     if (!definition.current) continue;
     if (definition.current.when(feature)) {
+      const currentActions = withUserRequestReplanOption(
+        definition.current.actions(feature),
+        lang
+      );
       const actions = applyApprovalPolicy(
         definition.step,
-        definition.current.actions(feature),
+        currentActions,
         approval
       );
       return {
@@ -4034,6 +4187,7 @@ function isGitPathIgnored(cwd, relativePath) {
     return void 0;
   }
 }
+var GIT_WORKTREE_CACHE = /* @__PURE__ */ new Map();
 function getGitTopLevel(cwd) {
   try {
     return execSync("git rev-parse --show-toplevel", {
@@ -4045,6 +4199,52 @@ function getGitTopLevel(cwd) {
     return null;
   }
 }
+function listGitWorktrees(cwd) {
+  const topLevel = getGitTopLevel(cwd) || cwd;
+  const cacheKey = path20.resolve(topLevel);
+  const cached = GIT_WORKTREE_CACHE.get(cacheKey);
+  if (cached) return cached;
+  try {
+    const out = execFileSync("git", ["worktree", "list", "--porcelain"], {
+      cwd: topLevel,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    const entries = [];
+    let current = null;
+    for (const rawLine of out.split("\n")) {
+      const line = rawLine.trim();
+      if (!line) {
+        if (current?.path) entries.push(current);
+        current = null;
+        continue;
+      }
+      if (line.startsWith("worktree ")) {
+        if (current?.path) entries.push(current);
+        current = { path: line.slice("worktree ".length).trim() };
+        continue;
+      }
+      if (line.startsWith("branch ")) {
+        if (!current) continue;
+        const fullRef = line.slice("branch ".length).trim();
+        current.branch = fullRef.replace(/^refs\/heads\//, "");
+      }
+    }
+    if (current?.path) entries.push(current);
+    GIT_WORKTREE_CACHE.set(cacheKey, entries);
+    return entries;
+  } catch {
+    return void 0;
+  }
+}
+function findWorktreePathForBranch(cwd, branchName) {
+  const target = branchName.trim();
+  if (!target) return void 0;
+  const entries = listGitWorktrees(cwd);
+  if (!entries) return void 0;
+  const match = entries.find((entry) => entry.branch === target);
+  return match?.path;
+}
 function resolveProjectGitCwd(config, repo, lang = config.lang ?? DEFAULT_LANG) {
   const docsRepo = config.docsRepo;
   if (docsRepo !== "standalone") {
@@ -4198,13 +4398,13 @@ function parsePrLink(value) {
   return trimmed;
 }
 function normalizeGitPath(value) {
-  return value.split(path19.sep).join("/");
+  return value.split(path20.sep).join("/");
 }
 function resolveProjectStatusPaths(projectGitCwd, docsDir) {
-  const relativeDocsDir = path19.relative(projectGitCwd, docsDir);
+  const relativeDocsDir = path20.relative(projectGitCwd, docsDir);
   if (!relativeDocsDir) return [];
-  if (path19.isAbsolute(relativeDocsDir)) return [];
-  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path19.sep}`)) {
+  if (path20.isAbsolute(relativeDocsDir)) return [];
+  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path20.sep}`)) {
     return [];
   }
   const normalizedDocsDir = normalizeGitPath(relativeDocsDir).replace(/\/+$/, "");
@@ -4226,6 +4426,27 @@ function uniqueNormalizedPaths(values) {
 var PROJECT_DIRTY_STATUS_CACHE = /* @__PURE__ */ new Map();
 var COMPONENT_STATUS_PATH_CACHE = /* @__PURE__ */ new Map();
 var PR_REMOTE_STATUS_CACHE = /* @__PURE__ */ new Map();
+var FEATURE_WORKTREE_CACHE = /* @__PURE__ */ new Map();
+function resolveFeatureWorktreePath(projectGitCwd, issueNumber, slug, folderName) {
+  const expectedBranches = [
+    `feat/${issueNumber}-${slug}`,
+    `feat/${issueNumber}-${folderName}`
+  ];
+  for (const branchName of expectedBranches) {
+    const cacheKey = `${projectGitCwd}::${branchName}`;
+    let foundPath = FEATURE_WORKTREE_CACHE.get(cacheKey);
+    if (typeof foundPath === "undefined") {
+      foundPath = findWorktreePathForBranch(projectGitCwd, branchName) || null;
+      FEATURE_WORKTREE_CACHE.set(cacheKey, foundPath);
+    }
+    if (!foundPath) continue;
+    return {
+      cwd: foundPath,
+      branch: getCurrentBranch(foundPath) || branchName
+    };
+  }
+  return void 0;
+}
 function toUpperToken(value) {
   if (typeof value !== "string") return void 0;
   const normalized = value.trim().toUpperCase();
@@ -4268,7 +4489,7 @@ function resolvePrRemoteStatus(prRef, projectGitCwd) {
         "view",
         prRef,
         "--json",
-        "reviewDecision,mergeStateStatus,isDraft,statusCheckRollup"
+        "state,mergedAt,reviewDecision,mergeStateStatus,isDraft,statusCheckRollup"
       ],
       {
         cwd: projectGitCwd,
@@ -4283,6 +4504,9 @@ function resolvePrRemoteStatus(prRef, projectGitCwd) {
       return null;
     }
     const parsed = JSON.parse(raw);
+    const state = toUpperToken(parsed.state);
+    const mergedAt = typeof parsed.mergedAt === "string" && parsed.mergedAt.trim().length > 0 ? parsed.mergedAt.trim() : void 0;
+    const isMerged = state === "MERGED" || !!mergedAt;
     const reviewDecision = toUpperToken(parsed.reviewDecision);
     const mergeStateStatus = toUpperToken(parsed.mergeStateStatus);
     const isDraft = parsed.isDraft === true;
@@ -4297,11 +4521,14 @@ function resolvePrRemoteStatus(prRef, projectGitCwd) {
     const remote = {
       source: "gh",
       available: true,
+      state,
+      mergedAt,
+      isMerged,
       reviewDecision,
       mergeStateStatus,
       isDraft,
       hasBlockingReview: reviewDecision === "CHANGES_REQUESTED" || reviewDecision === "REVIEW_REQUIRED",
-      mergeBlocked: isDraft || isMergeBlockedState(mergeStateStatus),
+      mergeBlocked: !isMerged && (isDraft || isMergeBlockedState(mergeStateStatus)),
       failingChecks,
       pendingChecks
     };
@@ -4325,10 +4552,10 @@ async function resolveComponentStatusPaths(projectGitCwd, component, workflow) {
   const normalizedCandidates = uniqueNormalizedPaths(
     candidates.map((candidate) => {
       if (!candidate) return "";
-      if (!path19.isAbsolute(candidate)) return candidate;
-      const relative = path19.relative(projectGitCwd, candidate);
+      if (!path20.isAbsolute(candidate)) return candidate;
+      const relative = path20.relative(projectGitCwd, candidate);
       if (!relative) return "";
-      if (relative === ".." || relative.startsWith(`..${path19.sep}`)) return "";
+      if (relative === ".." || relative.startsWith(`..${path20.sep}`)) return "";
       return relative;
     }).filter(Boolean)
   );
@@ -4341,7 +4568,7 @@ async function resolveComponentStatusPaths(projectGitCwd, component, workflow) {
   if (cached) return [...cached];
   const existing = [];
   for (const candidate of normalizedCandidates) {
-    if (await fs15.pathExists(path19.join(projectGitCwd, candidate))) {
+    if (await fs15.pathExists(path20.join(projectGitCwd, candidate))) {
       existing.push(candidate);
     }
   }
@@ -4430,15 +4657,15 @@ async function parseFeature(featurePath, type, context, options) {
   const lang = options.lang;
   const workflowPolicy = resolveWorkflowPolicy(options.workflow);
   const prePrReviewPolicy = resolvePrePrReviewPolicy(options.workflow);
-  const folderName = path19.basename(featurePath);
+  const folderName = path20.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
   const slug = match?.[2] || folderName;
-  const specPath = path19.join(featurePath, "spec.md");
-  const planPath = path19.join(featurePath, "plan.md");
-  const tasksPath = path19.join(featurePath, "tasks.md");
-  const issueDocPath = path19.join(featurePath, "issue.md");
-  const prDocPath = path19.join(featurePath, "pr.md");
+  const specPath = path20.join(featurePath, "spec.md");
+  const planPath = path20.join(featurePath, "plan.md");
+  const tasksPath = path20.join(featurePath, "tasks.md");
+  const issueDocPath = path20.join(featurePath, "issue.md");
+  const prDocPath = path20.join(featurePath, "pr.md");
   let specStatus;
   let issueNumber;
   const specExists = await fs15.pathExists(specPath);
@@ -4449,6 +4676,30 @@ async function parseFeature(featurePath, type, context, options) {
     const issueValue = extractFirstSpecValue(content, ["\uC774\uC288 \uBC88\uD638", "Issue Number", "Issue"]);
     issueNumber = parseIssueNumber(issueValue);
   }
+  let effectiveProjectGitCwd = context.projectGitCwd;
+  let effectiveProjectBranch = context.projectBranch;
+  let effectiveProjectBranchAvailable = context.projectBranchAvailable;
+  if (effectiveProjectGitCwd && issueNumber) {
+    const alreadyExpected = isExpectedFeatureBranch(
+      effectiveProjectBranch,
+      issueNumber,
+      slug,
+      folderName
+    );
+    if (!alreadyExpected) {
+      const worktree = resolveFeatureWorktreePath(
+        effectiveProjectGitCwd,
+        issueNumber,
+        slug,
+        folderName
+      );
+      if (worktree) {
+        effectiveProjectGitCwd = worktree.cwd;
+        effectiveProjectBranch = worktree.branch;
+        effectiveProjectBranchAvailable = true;
+      }
+    }
+  }
   let planStatus;
   const planExists = await fs15.pathExists(planPath);
   if (planExists) {
@@ -4588,20 +4839,20 @@ async function parseFeature(featurePath, type, context, options) {
     prDocPrFieldExists = hasAnySpecKey(content, ["PR", "Pull Request"]);
     prDocReviewStatusFieldExists = hasAnySpecKey(content, ["PR \uC0C1\uD0DC", "PR Status"]);
   }
-  if (workflowPolicy.requireReview && prStatus === "Review" && prLink && context.projectGitCwd) {
-    prRemote = resolvePrRemoteStatus(prLink, context.projectGitCwd) || void 0;
+  if (workflowPolicy.requireReview && prStatus === "Review" && prLink && effectiveProjectGitCwd) {
+    prRemote = resolvePrRemoteStatus(prLink, effectiveProjectGitCwd) || void 0;
   }
   const warnings = [];
-  if (context.projectBranchAvailable === false) {
+  if (effectiveProjectBranchAvailable === false) {
     warnings.push(tr(lang, "warnings", "projectBranchUnavailable"));
   }
   const onExpectedBranch = isExpectedFeatureBranch(
-    context.projectBranch,
+    effectiveProjectBranch,
     issueNumber,
     slug,
     folderName
   );
-  const relativeFeaturePathFromDocs = path19.relative(context.docsDir, featurePath);
+  const relativeFeaturePathFromDocs = path20.relative(context.docsDir, featurePath);
   const normalizedFeaturePathFromDocs = normalizeGitPath(relativeFeaturePathFromDocs);
   const docsPathIgnored = typeof context.docsPathIgnored === "boolean" ? context.docsPathIgnored : isGitPathIgnored(context.docsGitCwd, normalizedFeaturePathFromDocs);
   let docsHasUncommittedChanges = typeof context.docsHasUncommittedChanges === "boolean" ? context.docsHasUncommittedChanges : false;
@@ -4625,10 +4876,10 @@ async function parseFeature(featurePath, type, context, options) {
   }
   let projectHasUncommittedChanges = typeof context.projectHasUncommittedChanges === "boolean" ? context.projectHasUncommittedChanges : false;
   let projectStatusUnavailable = !!context.projectStatusUnavailable;
-  if (typeof context.projectHasUncommittedChanges !== "boolean" && context.projectGitCwd) {
+  if (typeof context.projectHasUncommittedChanges !== "boolean" && effectiveProjectGitCwd) {
     const dirtyScopePolicy = resolveCodeDirtyScopePolicy(options.workflow, options.projectType);
     const projectCacheKey = JSON.stringify({
-      projectGitCwd: context.projectGitCwd,
+      projectGitCwd: effectiveProjectGitCwd,
       docsDir: context.docsDir,
       type,
       dirtyScopePolicy,
@@ -4642,19 +4893,19 @@ async function parseFeature(featurePath, type, context, options) {
       let projectStatusPaths = [];
       if (dirtyScopePolicy === "component" && type !== "single") {
         const componentStatusPaths = await resolveComponentStatusPaths(
-          context.projectGitCwd,
+          effectiveProjectGitCwd,
           type,
           options.workflow
         );
-        projectStatusPaths = componentStatusPaths.length > 0 ? componentStatusPaths : resolveProjectStatusPaths(context.projectGitCwd, context.docsDir);
+        projectStatusPaths = componentStatusPaths.length > 0 ? componentStatusPaths : resolveProjectStatusPaths(effectiveProjectGitCwd, context.docsDir);
       } else {
         projectStatusPaths = resolveProjectStatusPaths(
-          context.projectGitCwd,
+          effectiveProjectGitCwd,
           context.docsDir
         );
       }
       const projectStatus = getGitStatusPorcelain(
-        context.projectGitCwd,
+        effectiveProjectGitCwd,
         projectStatusPaths
       );
       projectStatusUnavailable = projectStatus === void 0;
@@ -4823,10 +5074,10 @@ async function parseFeature(featurePath, type, context, options) {
     pr: { link: prLink, status: prStatus, remote: prRemote },
     git: {
       docsBranch: context.docsBranch,
-      projectBranch: context.projectBranch,
-      projectBranchAvailable: context.projectBranchAvailable,
+      projectBranch: effectiveProjectBranch,
+      projectBranchAvailable: effectiveProjectBranchAvailable,
       docsGitCwd: context.docsGitCwd,
-      projectGitCwd: context.projectGitCwd,
+      projectGitCwd: effectiveProjectGitCwd,
       onExpectedBranch,
       docsEverCommitted,
       docsHasUncommittedChanges,
@@ -4999,7 +5250,7 @@ async function scanFeatures(config) {
     }
   }
   const relativeFeaturePaths = allFeatureDirs.map(
-    (dir) => normalizeRelPath(path19.relative(config.docsDir, dir))
+    (dir) => normalizeRelPath(path20.relative(config.docsDir, dir))
   );
   const docsGitMeta = buildDocsFeatureGitMeta(config.docsDir, relativeFeaturePaths);
   const parseTargets = config.projectType === "single" ? [{ type: "single", dirs: componentFeatureDirs.get("single") || [] }] : resolveProjectComponents(config.projectType, config.components).map((component) => ({
@@ -5010,7 +5261,7 @@ async function scanFeatures(config) {
     const parsed = await Promise.all(
       target.dirs.map(async (dir) => {
         const relativeFeaturePathFromDocs = normalizeRelPath(
-          path19.relative(config.docsDir, dir)
+          path20.relative(config.docsDir, dir)
         );
         const docsMeta = docsGitMeta.get(relativeFeaturePathFromDocs);
         return parseFeature(
@@ -5079,13 +5330,13 @@ async function runStatus(options) {
     );
   }
   const { docsDir, projectType, projectName, lang } = config;
-  const featuresDir = path19.join(docsDir, "features");
+  const featuresDir = path20.join(docsDir, "features");
   const scan = await scanFeatures(config);
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   for (const f of scan.features) {
     const id = f.id || "UNKNOWN";
-    const relPath = path19.relative(docsDir, f.path);
+    const relPath = path20.relative(docsDir, f.path);
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(relPath);
     if (!f.docs.specExists || !f.docs.tasksExists) continue;
@@ -5166,7 +5417,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path19.join(featuresDir, "status.md");
+    const outputPath = path20.join(featuresDir, "status.md");
     const date = getLocalDateString();
     const content = [
       "# Feature Status",
@@ -5194,7 +5445,7 @@ function escapeRegExp2(value) {
 }
 async function getFeatureNameFromSpec(featureDir, fallbackSlug, fallbackFolderName) {
   try {
-    const specPath = path19.join(featureDir, "spec.md");
+    const specPath = path20.join(featureDir, "spec.md");
     if (!await fs15.pathExists(specPath)) return fallbackSlug;
     const content = await fs15.readFile(specPath, "utf-8");
     const keys = ["\uAE30\uB2A5\uBA85", "Feature Name"];
@@ -5276,10 +5527,10 @@ async function runUpdate(options) {
           console.log(chalk6.blue(tr(lang, "cli", "update.updatingAgents")));
         }
         if (agentsMode === "all") {
-          const commonAgentsBase = path19.join(templatesDir, lang, "common", "agents");
-          const targetAgentsBase = path19.join(docsDir, "agents");
-          const commonAgents = agentsMode === "skills" ? path19.join(commonAgentsBase, "skills") : commonAgentsBase;
-          const targetAgents = agentsMode === "skills" ? path19.join(targetAgentsBase, "skills") : targetAgentsBase;
+          const commonAgentsBase = path20.join(templatesDir, lang, "common", "agents");
+          const targetAgentsBase = path20.join(docsDir, "agents");
+          const commonAgents = commonAgentsBase;
+          const targetAgents = targetAgentsBase;
           const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
           const projectName = config.projectName ?? "{{projectName}}";
           const commonReplacements = {
@@ -5306,7 +5557,7 @@ async function runUpdate(options) {
           }
           console.log(
             chalk6.green(
-              `  \u2705 ${agentsMode === "skills" ? tr(lang, "cli", "update.skillsUpdated") : tr(lang, "cli", "update.agentsUpdated")}`
+              `  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`
             )
           );
         }
@@ -5359,7 +5610,7 @@ function normalizeSkillList2(raw) {
   return [...deduped];
 }
 async function backfillMissingConfigDefaults(docsDir) {
-  const configPath = path19.join(docsDir, ".lee-spec-kit.json");
+  const configPath = path20.join(docsDir, ".lee-spec-kit.json");
   if (!await fs15.pathExists(configPath)) {
     return { changed: false, changedPaths: [] };
   }
@@ -5380,7 +5631,7 @@ async function backfillMissingConfigDefaults(docsDir) {
   const workflow = raw.workflow;
   setIfMissing(workflow, "mode", "github", "workflow.mode");
   setIfMissing(workflow, "codeDirtyScope", "auto", "workflow.codeDirtyScope");
-  setIfMissing(workflow, "taskCommitGate", "strict", "workflow.taskCommitGate");
+  setIfMissing(workflow, "taskCommitGate", "warn", "workflow.taskCommitGate");
   if (!isPlainObject(workflow.prePrReview)) {
     workflow.prePrReview = {};
     changedPaths.push("workflow.prePrReview");
@@ -5432,8 +5683,8 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
   const files = await fs15.readdir(sourceDir);
   let updatedCount = 0;
   for (const file of files) {
-    const sourcePath = path19.join(sourceDir, file);
-    const targetPath = path19.join(targetDir, file);
+    const sourcePath = path20.join(sourceDir, file);
+    const targetPath = path20.join(targetDir, file);
     const stat = await fs15.stat(sourcePath);
     if (stat.isFile()) {
       if (protectedFiles.has(file)) {
@@ -5516,7 +5767,7 @@ function extractPorcelainPaths(line) {
 function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   const top = getGitTopLevel2(docsDir);
   if (!top) return null;
-  const rel = path19.relative(top, docsDir) || ".";
+  const rel = path20.relative(top, docsDir) || ".";
   try {
     const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
       cwd: top,
@@ -5528,7 +5779,7 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
     }
     const ignoredRelPaths = new Set(
       ignoredAbsPaths.map(
-        (absPath) => normalizeGitPath2(path19.relative(top, absPath) || ".")
+        (absPath) => normalizeGitPath2(path20.relative(top, absPath) || ".")
       )
     );
     const filtered = output.split("\n").filter((line) => {
@@ -5585,7 +5836,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runConfig(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path19.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path20.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   if (!config) {
     throw createCliError(
@@ -5593,7 +5844,7 @@ async function runConfig(options) {
       tr(DEFAULT_LANG, "cli", "common.configNotFound")
     );
   }
-  const configPath = path19.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path20.join(config.docsDir, ".lee-spec-kit.json");
   if (!options.projectRoot) {
     console.log();
     console.log(chalk6.blue(tr(config.lang, "cli", "config.currentTitle")));
@@ -5609,6 +5860,7 @@ async function runConfig(options) {
     console.log();
     return;
   }
+  const projectRoot = options.projectRoot;
   await withFileLock(
     getDocsLockPath(config.docsDir),
     async () => {
@@ -5662,13 +5914,13 @@ async function runConfig(options) {
         }
         assertAllowedComponent(targetComponent, components);
         const currentRoot = typeof configFile.projectRoot === "object" && configFile.projectRoot ? configFile.projectRoot : {};
-        currentRoot[targetComponent] = options.projectRoot;
+        currentRoot[targetComponent] = projectRoot;
         configFile.projectRoot = currentRoot;
         console.log(
           chalk6.green(
             tr(config.lang, "cli", "config.projectRootSet", {
               repo: targetComponent.toUpperCase(),
-              path: options.projectRoot
+              path: projectRoot
             })
           )
         );
@@ -5679,11 +5931,11 @@ async function runConfig(options) {
             "`--component` is only valid for multi projectRoot updates."
           );
         }
-        configFile.projectRoot = options.projectRoot;
+        configFile.projectRoot = projectRoot;
         console.log(
           chalk6.green(
             tr(config.lang, "cli", "config.projectRootSetSingle", {
-              path: options.projectRoot
+              path: projectRoot
             })
           )
         );
@@ -5752,6 +6004,7 @@ function getActionSummary(action) {
   if (action.category === "pre_pr_review") return "Run pre-PR self review";
   if (action.category === "pr_status_update") return "Update PR status";
   if (action.category === "code_review") return "Process code review feedback";
+  if (action.category === "user_request_replan") return "Handle a new user request first";
   if (action.category === "task_execute") return "Proceed with task execution";
   if (action.category === "review_fix_commit") return "Commit review feedback fixes";
   if (action.category === "feature_done") return "Feature is complete";
@@ -5959,42 +6212,42 @@ var BUILTIN_DOC_DEFINITIONS = [
   {
     id: "agents",
     title: { ko: "\uC5D0\uC774\uC804\uD2B8 \uC6B4\uC601 \uADDC\uCE59", en: "Agent Operating Rules" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "agents.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "agents.md")
   },
   {
     id: "git-workflow",
     title: { ko: "Git \uC6CC\uD06C\uD50C\uB85C\uC6B0", en: "Git Workflow" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "git-workflow.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "git-workflow.md")
   },
   {
     id: "issue-doc",
     title: { ko: "Issue \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "Issue Document Template" },
-    relativePath: (_, lang) => path19.join(lang, "common", "features", "feature-base", "issue.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "features", "feature-base", "issue.md")
   },
   {
     id: "pr-doc",
     title: { ko: "PR \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "PR Document Template" },
-    relativePath: (_, lang) => path19.join(lang, "common", "features", "feature-base", "pr.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "features", "feature-base", "pr.md")
   },
   {
     id: "create-feature",
     title: { ko: "create-feature \uC2A4\uD0AC", en: "create-feature skill" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "skills", "create-feature.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "skills", "create-feature.md")
   },
   {
     id: "execute-task",
     title: { ko: "execute-task \uC2A4\uD0AC", en: "execute-task skill" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "skills", "execute-task.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "skills", "execute-task.md")
   },
   {
     id: "create-issue",
     title: { ko: "create-issue \uC2A4\uD0AC", en: "create-issue skill" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "skills", "create-issue.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "skills", "create-issue.md")
   },
   {
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
-    relativePath: (_, lang) => path19.join(lang, "common", "agents", "skills", "create-pr.md")
+    relativePath: (_, lang) => path20.join(lang, "common", "agents", "skills", "create-pr.md")
   }
 ];
 var DOC_FOLLOWUPS = {
@@ -6030,7 +6283,8 @@ var CATEGORY_DOC_MAP = {
   pre_pr_review: ["create-pr"],
   pr_create: ["create-pr", "pr-doc", "git-workflow"],
   pr_status_update: ["create-pr"],
-  code_review: ["create-pr"]
+  code_review: ["create-pr"],
+  user_request_replan: ["agents", "execute-task"]
 };
 function getBuiltinDocIds() {
   return BUILTIN_DOC_DEFINITIONS.map((doc) => doc.id);
@@ -6081,7 +6335,7 @@ function listBuiltinDocs(projectType, lang) {
       id: doc.id,
       title: doc.title[lang],
       relativePath,
-      absolutePath: path19.join(templatesDir, relativePath)
+      absolutePath: path20.join(templatesDir, relativePath)
     };
   });
 }
@@ -6130,7 +6384,7 @@ function parseApprovalLabel(input, validLabels) {
 function getApprovalTicketPaths(config) {
   return {
     runtimePath: getApprovalTicketStorePath(config.docsDir),
-    legacyPath: path19.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
+    legacyPath: path20.join(config.docsDir, LEGACY_APPROVAL_TICKET_FILENAME)
   };
 }
 function getApprovalSessionId() {
@@ -6158,7 +6412,7 @@ async function loadApprovalTicketStore(storePath) {
   }
 }
 async function saveApprovalTicketStore(storePath, payload) {
-  await fs15.ensureDir(path19.dirname(storePath));
+  await fs15.ensureDir(path20.dirname(storePath));
   await fs15.writeJson(storePath, payload, { spaces: 2 });
 }
 async function resolveApprovalTicketStoreAndPath(config, nowMs) {
@@ -6376,9 +6630,14 @@ function buildSuggestionOptions(lang, state, projectType, selectedComponent) {
   const showDoneCommand = `npx lee-spec-kit context --done${componentArg}`;
   const showAllCommand = `npx lee-spec-kit context --all${componentArg}`;
   const showOpenCommand = `npx lee-spec-kit context${componentArg}`;
+  const runOnboardCommand = "npx lee-spec-kit onboard --strict";
   const rawSuggestions = [];
   switch (state.status) {
     case "no_features":
+      rawSuggestions.push({
+        summary: tr(lang, "cli", "context.suggestion.runOnboard"),
+        command: runOnboardCommand
+      });
       rawSuggestions.push({
         summary: tr(lang, "cli", "context.suggestion.createFeature"),
         command: createFeatureCommand
@@ -6487,7 +6746,10 @@ function getCommandExecutionLockPath(action, config) {
   return getProjectExecutionLockPath(action.cwd);
 }
 function contextCommand(program2) {
-  program2.command("context [feature-name]").description("Show current feature context and next actions").option("--json", "Output in JSON format for agents").option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option(
+  program2.command("context [feature-name]").description("Show current feature context and next actions").option("--json", "Output in JSON format for agents").option(
+    "--json-compact",
+    "Output compact JSON for agents (implies --json, reduced duplication)"
+  ).option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option(
     "--approve <reply>",
     "Approve one labeled option (examples: A, A OK, A proceed, A \uC9C4\uD589\uD574)"
   ).option(
@@ -6508,7 +6770,7 @@ function contextCommand(program2) {
         const lang = config?.lang ?? DEFAULT_LANG;
         const cliError = toCliError(error);
         const suggestions = getCliErrorSuggestions(cliError.code, lang);
-        if (options.json) {
+        if (options.json || options.jsonCompact) {
           console.log(
             JSON.stringify({
               status: "error",
@@ -6600,6 +6862,111 @@ function getMultipleFeaturesRecommendation(projectType, selectedComponent) {
   }
   return "Multiple features detected across components. Please specify feature name (slug | F001 | F001-slug) or use --component.";
 }
+function getFeatureRef(feature) {
+  return feature.folderName || `${feature.type}:${feature.slug}`;
+}
+function toCompactFeature(feature) {
+  if (!feature) return null;
+  return {
+    ref: getFeatureRef(feature),
+    id: feature.id ?? null,
+    slug: feature.slug,
+    folderName: feature.folderName,
+    type: feature.type,
+    path: feature.path,
+    currentStep: feature.currentStep,
+    nextAction: feature.nextAction,
+    completion: feature.completion,
+    specStatus: feature.specStatus,
+    planStatus: feature.planStatus,
+    tasks: feature.tasks,
+    prePrReview: {
+      status: feature.prePrReview.status,
+      findings: feature.prePrReview.findings,
+      evidenceProvided: feature.prePrReview.evidenceProvided
+    },
+    prReview: {
+      findings: feature.prReview.findings,
+      evidenceProvided: feature.prReview.evidenceProvided
+    },
+    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
+    },
+    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,
+      prePrFindingsFieldExists: feature.docs.prePrFindingsFieldExists,
+      prePrEvidenceFieldExists: feature.docs.prePrEvidenceFieldExists,
+      prReviewFindingsFieldExists: feature.docs.prReviewFindingsFieldExists,
+      prReviewEvidenceFieldExists: feature.docs.prReviewEvidenceFieldExists
+    },
+    warnings: feature.warnings
+  };
+}
+function toCompactActionOption(option) {
+  const base = {
+    label: option.label,
+    summary: option.summary,
+    detail: option.detail,
+    approvalPrompt: option.approvalPrompt,
+    actionType: option.action.type,
+    category: option.action.category,
+    operationType: option.action.operationType,
+    requiresUserCheck: !!option.action.requiresUserCheck
+  };
+  if (option.action.type === "command") {
+    base.scope = option.action.scope;
+    base.cwd = option.action.cwd;
+    base.cmd = option.action.cmd;
+    return base;
+  }
+  base.message = option.action.message;
+  return base;
+}
+function toCompactSuggestionOption(option) {
+  return {
+    label: option.label,
+    summary: option.summary,
+    command: option.command
+  };
+}
+function resolveContextRecommendation(state, projectType, selectedComponent) {
+  if (state.status === "multiple_active") {
+    return getMultipleFeaturesRecommendation(projectType, selectedComponent);
+  }
+  if (state.status === "no_features") {
+    return "No features found. Run onboarding checks first, then create a feature.";
+  }
+  if (state.status === "no_open") {
+    return "No open features found. Use `context --done` to inspect completed features.";
+  }
+  if (state.status === "no_match") {
+    return "No features found.";
+  }
+  if (state.targetFeatures.length === 1) {
+    return state.targetFeatures[0].nextAction;
+  }
+  return "No matched feature.";
+}
 async function runContext(featureName, options) {
   const cwd = process.cwd();
   const config = await getConfig(cwd);
@@ -6659,7 +7026,8 @@ async function runContext(featureName, options) {
     );
     return;
   }
-  if (options.json) {
+  const jsonMode = !!options.json || !!options.jsonCompact;
+  if (jsonMode) {
     const primaryAction = state.actionOptions[0] ?? null;
     const finalApprovalPrompt = buildFinalApprovalPrompt(lang, state.actionOptions);
     const approveCommand = buildApprovalCommand(
@@ -6674,6 +7042,76 @@ async function runContext(featureName, options) {
       selectedComponent,
       true
     );
+    const recommendation = resolveContextRecommendation(
+      state,
+      config.projectType,
+      selectedComponent
+    );
+    if (options.jsonCompact) {
+      const compactResult = {
+        schema: "context.v2.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),
+          oneApprovalPerAction: true,
+          requireFreshContext: true,
+          contextVersion: state.contextVersion,
+          config: config.approval ?? { mode: "builtin" }
+        },
+        approvalRequest: {
+          finalPrompt: finalApprovalPrompt,
+          userFacingLines: [
+            ...state.actionOptions.map((o) => o.approvalPrompt),
+            finalApprovalPrompt
+          ].filter((line) => line.length > 0),
+          labels: 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
+      };
+      console.log(JSON.stringify(compactResult, null, 2));
+      return;
+    }
     const result = {
       status: state.status,
       reasonCode: toReasonCode(state.status),
@@ -6765,24 +7203,8 @@ async function runContext(featureName, options) {
         }
       },
       requiredDocs,
-      recommendation: ""
+      recommendation
     };
-    if (result.status === "multiple_active") {
-      result.recommendation = getMultipleFeaturesRecommendation(
-        config.projectType,
-        selectedComponent
-      );
-    } else if (result.status === "no_features") {
-      result.recommendation = "No features found. Create a feature first.";
-    } else if (result.status === "no_open") {
-      result.recommendation = "No open features found. Use `context --done` to inspect completed features.";
-    } else if (result.status === "no_match") {
-      result.recommendation = "No features found.";
-    } else if (state.targetFeatures.length === 1) {
-      result.recommendation = state.targetFeatures[0].nextAction;
-    } else {
-      result.recommendation = "No matched feature.";
-    }
     console.log(JSON.stringify(result, null, 2));
     return;
   }
@@ -6956,7 +7378,7 @@ async function runContext(featureName, options) {
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
-  console.log(`   \u2022 Path: ${path19.relative(cwd, f.path)}`);
+  console.log(`   \u2022 Path: ${path20.relative(cwd, f.path)}`);
   if (f.git.projectBranch) {
     console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
   }
@@ -7055,6 +7477,7 @@ async function runContext(featureName, options) {
 async function runApprovedOption(state, config, lang, featureName, selectionOptions, options) {
   const approval = options.approve || "";
   const ticketToken = (options.ticket || "").trim();
+  const jsonMode = !!options.json || !!options.jsonCompact;
   let parsedLabel = null;
   if (state.status !== "single_matched" || !state.matchedFeature) {
     throw createCliError(
@@ -7115,7 +7538,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
       label: parsedLabel,
       featureRef
     }) : null;
-    if (options.json) {
+    if (jsonMode) {
       console.log(
         JSON.stringify(
           {
@@ -7194,7 +7617,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
         `Approved label "${parsedLabel}" is instruction-only. Re-run without \`--execute\` or pick a command option.`
       );
     }
-    if (options.json) {
+    if (jsonMode) {
       console.log(
         JSON.stringify(
           {
@@ -7219,7 +7642,7 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     console.log();
     return;
   }
-  if (!options.json) {
+  if (!jsonMode) {
     console.log();
     console.log(chalk6.blue(`\u25B6 Executing option ${parsedLabel}...`));
     console.log(chalk6.gray(`   ${selectedAction.cmd}`));
@@ -7231,12 +7654,12 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
       lockPath,
       async () => executeCommandAction(
         selectedAction.cmd,
-        !!options.json,
+        jsonMode,
         selectedAction.cwd
       ),
       { owner: `context-execute:${selectedAction.scope}` }
     );
-    if (options.json) {
+    if (jsonMode) {
       console.log(
         JSON.stringify(
           {
@@ -7285,7 +7708,7 @@ var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
 ]);
 function formatPath(cwd, p) {
   if (!p) return "";
-  return path19.isAbsolute(p) ? path19.relative(cwd, p) : p;
+  return path20.isAbsolute(p) ? path20.relative(cwd, p) : p;
 }
 function detectPlaceholders(content) {
   const patterns = [
@@ -7434,7 +7857,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
     const placeholderContext = {
       projectName: config.projectName,
       featureName: f.slug,
-      featurePath: f.docs.featurePathFromDocs || path19.relative(config.docsDir, f.path),
+      featurePath: f.docs.featurePathFromDocs || path20.relative(config.docsDir, f.path),
       repoType: f.type,
       featureNumber
     };
@@ -7444,7 +7867,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       "tasks.md"
     ];
     for (const file of files) {
-      const fullPath = path19.join(f.path, file);
+      const fullPath = path20.join(f.path, file);
       if (!await fs15.pathExists(fullPath)) continue;
       const original = await fs15.readFile(fullPath, "utf-8");
       let next = original;
@@ -7489,7 +7912,7 @@ async function checkDocsStructure(config, cwd) {
   const issues = [];
   const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
   for (const dir of requiredDirs) {
-    const p = path19.join(config.docsDir, dir);
+    const p = path20.join(config.docsDir, dir);
     if (!await fs15.pathExists(p)) {
       issues.push({
         level: "error",
@@ -7499,7 +7922,7 @@ async function checkDocsStructure(config, cwd) {
       });
     }
   }
-  const configPath = path19.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path20.join(config.docsDir, ".lee-spec-kit.json");
   if (!await fs15.pathExists(configPath)) {
     issues.push({
       level: "warn",
@@ -7522,7 +7945,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   }
   const idMap = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const rel = f.docs.featurePathFromDocs || path19.relative(config.docsDir, f.path);
+    const rel = f.docs.featurePathFromDocs || path20.relative(config.docsDir, f.path);
     const id = f.id || "UNKNOWN";
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(rel);
@@ -7530,7 +7953,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
     if (!isInitialTemplateState) {
       const featureDocs = ["spec.md", "plan.md", "tasks.md"];
       for (const file of featureDocs) {
-        const p = path19.join(f.path, file);
+        const p = path20.join(f.path, file);
         if (!await fs15.pathExists(p)) continue;
         const content = await fs15.readFile(p, "utf-8");
         const placeholders = detectPlaceholders(content);
@@ -7545,7 +7968,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         });
       }
       if (decisionsPlaceholderMode !== "off") {
-        const decisionsPath = path19.join(f.path, "decisions.md");
+        const decisionsPath = path20.join(f.path, "decisions.md");
         if (await fs15.pathExists(decisionsPath)) {
           const content = await fs15.readFile(decisionsPath, "utf-8");
           const placeholders = detectPlaceholders(content);
@@ -7574,7 +7997,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "spec_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.specStatusUnset"),
-        path: formatPath(cwd, path19.join(f.path, "spec.md"))
+        path: formatPath(cwd, path20.join(f.path, "spec.md"))
       });
     }
     if (f.docs.planExists && !f.planStatus && !isInitialTemplateState) {
@@ -7582,7 +8005,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "plan_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.planStatusUnset"),
-        path: formatPath(cwd, path19.join(f.path, "plan.md"))
+        path: formatPath(cwd, path20.join(f.path, "plan.md"))
       });
     }
     if (f.docs.tasksExists && f.tasks.total === 0 && !isInitialTemplateState) {
@@ -7590,7 +8013,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_empty",
         message: tr(config.lang, "cli", "doctor.issue.tasksEmpty"),
-        path: formatPath(cwd, path19.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path20.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && !f.docs.tasksDocStatusFieldExists && !isInitialTemplateState) {
@@ -7598,7 +8021,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_doc_status_missing",
         message: tr(config.lang, "cli", "doctor.issue.tasksDocStatusMissing"),
-        path: formatPath(cwd, path19.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path20.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && f.docs.tasksDocStatusFieldExists && !f.tasksDocStatus && !isInitialTemplateState) {
@@ -7606,7 +8029,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_doc_status_unset",
         message: tr(config.lang, "cli", "doctor.issue.tasksDocStatusUnset"),
-        path: formatPath(cwd, path19.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path20.join(f.path, "tasks.md"))
       });
     }
   }
@@ -7630,7 +8053,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
       level: "warn",
       code: "missing_feature_id",
       message: tr(config.lang, "cli", "doctor.issue.missingFeatureId"),
-      path: formatPath(cwd, path19.join(config.docsDir, p))
+      path: formatPath(cwd, path20.join(config.docsDir, p))
     });
   }
   return issues;
@@ -7752,7 +8175,7 @@ function doctorCommand(program2) {
       }
       console.log();
       console.log(chalk6.bold(tr(lang, "cli", "doctor.title")));
-      console.log(chalk6.gray(`- Docs: ${path19.relative(cwd, docsDir)}`));
+      console.log(chalk6.gray(`- Docs: ${path20.relative(cwd, docsDir)}`));
       console.log(chalk6.gray(`- Type: ${projectType}`));
       console.log(chalk6.gray(`- Lang: ${lang}`));
       console.log();
@@ -7925,7 +8348,7 @@ async function runView(featureName, options) {
   }
   console.log();
   console.log(chalk6.bold("\u{1F4CA} Workflow View"));
-  console.log(chalk6.gray(`- Docs: ${path19.relative(cwd, config.docsDir)}`));
+  console.log(chalk6.gray(`- Docs: ${path20.relative(cwd, config.docsDir)}`));
   console.log(
     chalk6.gray(
       `- Features: ${state.features.length} (open ${state.openFeatures.length} / done ${state.doneFeatures.length})`
@@ -8298,25 +8721,25 @@ function tg(lang, key, vars = {}) {
 }
 function detectGithubCliLangSync(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
-  const startDirs = [explicitDocsDir ? path19.resolve(explicitDocsDir) : "", path19.resolve(cwd)].filter(Boolean);
+  const startDirs = [explicitDocsDir ? path20.resolve(explicitDocsDir) : "", path20.resolve(cwd)].filter(Boolean);
   const scanOrder = [];
   const seen = /* @__PURE__ */ new Set();
   for (const start of startDirs) {
     let current = start;
     while (true) {
-      const abs = path19.resolve(current);
+      const abs = path20.resolve(current);
       if (!seen.has(abs)) {
         scanOrder.push(abs);
         seen.add(abs);
       }
-      const parent = path19.dirname(abs);
+      const parent = path20.dirname(abs);
       if (parent === abs) break;
       current = parent;
     }
   }
   for (const base of scanOrder) {
-    for (const docsDir of [path19.join(base, "docs"), base]) {
-      const configPath = path19.join(docsDir, ".lee-spec-kit.json");
+    for (const docsDir of [path20.join(base, "docs"), base]) {
+      const configPath = path20.join(docsDir, ".lee-spec-kit.json");
       if (fs15.existsSync(configPath)) {
         try {
           const parsed = fs15.readJsonSync(configPath);
@@ -8324,11 +8747,11 @@ function detectGithubCliLangSync(cwd) {
         } catch {
         }
       }
-      const agentsPath = path19.join(docsDir, "agents");
-      const featuresPath = path19.join(docsDir, "features");
+      const agentsPath = path20.join(docsDir, "agents");
+      const featuresPath = path20.join(docsDir, "features");
       if (!fs15.existsSync(agentsPath) || !fs15.existsSync(featuresPath)) continue;
       for (const probe of ["custom.md", "constitution.md", "agents.md"]) {
-        const file = path19.join(agentsPath, probe);
+        const file = path20.join(agentsPath, probe);
         if (!fs15.existsSync(file)) continue;
         try {
           const content = fs15.readFileSync(file, "utf-8");
@@ -8426,7 +8849,7 @@ function ensureSections(body, sections, kind, lang) {
 }
 function ensureDocsExist(docsDir, relativePaths, lang) {
   const missing = relativePaths.filter(
-    (relativePath) => !fs15.existsSync(path19.join(docsDir, relativePath))
+    (relativePath) => !fs15.existsSync(path20.join(docsDir, relativePath))
   );
   if (missing.length > 0) {
     throw createCliError(
@@ -8436,13 +8859,13 @@ function ensureDocsExist(docsDir, relativePaths, lang) {
   }
 }
 function buildDefaultBodyFileName(kind, docsDir, component) {
-  const key = `${path19.resolve(docsDir)}::${component.trim().toLowerCase()}`;
+  const key = `${path20.resolve(docsDir)}::${component.trim().toLowerCase()}`;
   const digest = createHash("sha1").update(key).digest("hex").slice(0, 12);
   return `lee-spec-kit.${digest}.${kind}.md`;
 }
 function toBodyFilePath(raw, kind, docsDir, component) {
-  const selected = raw?.trim() || path19.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
-  return path19.resolve(selected);
+  const selected = raw?.trim() || path20.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
+  return path20.resolve(selected);
 }
 function toProjectRootDocsPath(relativePathFromDocs) {
   const normalized = relativePathFromDocs.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
@@ -8535,6 +8958,10 @@ function resolveGithubDocsCwd(config, feature) {
   if (docsGitCwd) return docsGitCwd;
   return config.docsDir;
 }
+function shouldPushDocsSync(config) {
+  if (config.docsRepo !== "standalone") return true;
+  return config.pushDocs === true;
+}
 function getFeatureDocPaths(feature) {
   const featurePathFromDocs = feature.docs.featurePathFromDocs;
   return {
@@ -9257,8 +9684,8 @@ function ensureCleanWorktree(cwd, lang) {
     );
   }
 }
-function commitAndPushPath(cwd, absPath, message, lang) {
-  const relativePath = path19.relative(cwd, absPath) || absPath;
+function commitAndPushPath(cwd, absPath, message, lang, options) {
+  const relativePath = path20.relative(cwd, absPath) || absPath;
   const status = runProcessOrThrow(
     "git",
     ["status", "--porcelain=v1", "--", relativePath],
@@ -9268,6 +9695,7 @@ function commitAndPushPath(cwd, absPath, message, lang) {
   if (status.stdout.trim().length === 0) return;
   runProcessOrThrow("git", ["add", "--", relativePath], cwd, tg(lang, "stageFileFailed"));
   runProcessOrThrow("git", ["commit", "-m", message], cwd, tg(lang, "commitSyncFailed"));
+  if (options?.pushToOrigin === false) return;
   const branch = gitCurrentBranch(cwd, lang);
   runProcessOrThrow(
     "git",
@@ -9390,9 +9818,9 @@ function githubCommand(program2) {
         [paths.specPath, paths.planPath, paths.tasksPath],
         config.lang
       );
-      const specContent = await fs15.readFile(path19.join(config.docsDir, paths.specPath), "utf-8");
-      const planContent = await fs15.readFile(path19.join(config.docsDir, paths.planPath), "utf-8");
-      const tasksContent = await fs15.readFile(path19.join(config.docsDir, paths.tasksPath), "utf-8");
+      const specContent = await fs15.readFile(path20.join(config.docsDir, paths.specPath), "utf-8");
+      const planContent = await fs15.readFile(path20.join(config.docsDir, paths.planPath), "utf-8");
+      const tasksContent = await fs15.readFile(path20.join(config.docsDir, paths.tasksPath), "utf-8");
       const overview = resolveOverviewFromSpec(specContent, feature, config.lang);
       const title = options.title?.trim() || tg(config.lang, "issueDefaultTitle", {
         slug: feature.slug,
@@ -9430,7 +9858,7 @@ function githubCommand(program2) {
           config.lang
         );
       } else {
-        await fs15.ensureDir(path19.dirname(bodyFile));
+        await fs15.ensureDir(path20.dirname(bodyFile));
         await fs15.writeFile(bodyFile, generatedBody, "utf-8");
       }
       let issueUrl;
@@ -9529,10 +9957,10 @@ function githubCommand(program2) {
       const labels = parseLabels(options.labels, config.lang);
       const paths = getFeatureDocPaths(feature);
       ensureDocsExist(config.docsDir, [paths.specPath, paths.tasksPath], config.lang);
-      const specContent = await fs15.readFile(path19.join(config.docsDir, paths.specPath), "utf-8");
-      const planPath = path19.join(config.docsDir, paths.planPath);
+      const specContent = await fs15.readFile(path20.join(config.docsDir, paths.specPath), "utf-8");
+      const planPath = path20.join(config.docsDir, paths.planPath);
       const planContent = await fs15.pathExists(planPath) ? await fs15.readFile(planPath, "utf-8") : "";
-      const tasksContent = await fs15.readFile(path19.join(config.docsDir, paths.tasksPath), "utf-8");
+      const tasksContent = await fs15.readFile(path20.join(config.docsDir, paths.tasksPath), "utf-8");
       const overview = resolveOverviewFromSpec(specContent, feature, config.lang);
       const defaultTitle = feature.issueNumber ? tg(config.lang, "prDefaultTitleWithIssue", {
         issue: feature.issueNumber,
@@ -9575,13 +10003,14 @@ function githubCommand(program2) {
           config.lang
         );
       } else {
-        await fs15.ensureDir(path19.dirname(bodyFile));
+        await fs15.ensureDir(path20.dirname(bodyFile));
         await fs15.writeFile(bodyFile, generatedBody, "utf-8");
       }
       const retryCount = toRetryCount(options.retry, config.lang);
       let prUrl = options.pr?.trim() || "";
       let mergedAttempts;
       let syncChanged = false;
+      const pushDocsSync = shouldPushDocsSync(config);
       if (options.create) {
         const projectGitCwd = resolveGithubProjectCwd(config, feature);
         ensureNoTodoPlaceholders(body, tg(config.lang, "kindPr"), config.lang);
@@ -9614,6 +10043,9 @@ function githubCommand(program2) {
         );
         prUrl = created.stdout.trim();
       }
+      if (!prUrl && options.merge) {
+        prUrl = (feature.pr.link || "").trim();
+      }
       if (!prUrl && options.merge) {
         throw createCliError(
           "INVALID_ARGUMENT",
@@ -9629,7 +10061,7 @@ function githubCommand(program2) {
       }
       if (prUrl && options.syncTasks !== false) {
         const synced = syncTasksPrMetadata(
-          path19.join(config.docsDir, paths.tasksPath),
+          path20.join(config.docsDir, paths.tasksPath),
           prUrl,
           "Review",
           config.lang
@@ -9648,7 +10080,8 @@ function githubCommand(program2) {
             docsGitCwd,
             synced.path,
             message,
-            config.lang
+            config.lang,
+            { pushToOrigin: pushDocsSync }
           );
         }
       }
@@ -9676,7 +10109,7 @@ function githubCommand(program2) {
         );
         if (prUrl && options.syncTasks !== false) {
           const mergedSync = syncTasksPrMetadata(
-            path19.join(config.docsDir, paths.tasksPath),
+            path20.join(config.docsDir, paths.tasksPath),
             prUrl,
             "Approved",
             config.lang
@@ -9694,7 +10127,8 @@ function githubCommand(program2) {
               docsGitCwd,
               mergedSync.path,
               message,
-              config.lang
+              config.lang,
+              { pushToOrigin: pushDocsSync }
             );
           }
         }
@@ -9881,7 +10315,7 @@ function docsCommand(program2) {
         );
         return;
       }
-      const relativeFromCwd = path19.relative(process.cwd(), loaded.entry.absolutePath);
+      const relativeFromCwd = path20.relative(process.cwd(), loaded.entry.absolutePath);
       console.log();
       console.log(chalk6.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
       console.log(
@@ -9959,7 +10393,7 @@ function detectCommand(program2) {
 }
 async function runDetect(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path19.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path20.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   const detected = !!config;
   const reasonCode = detected ? "PROJECT_DETECTED" : "PROJECT_NOT_DETECTED";
@@ -9986,7 +10420,7 @@ async function runDetect(options) {
       );
       return;
     }
-    const configPath2 = path19.join(config.docsDir, ".lee-spec-kit.json");
+    const configPath2 = path20.join(config.docsDir, ".lee-spec-kit.json");
     const configFilePresent2 = await fs15.pathExists(configPath2);
     const detectionSource2 = configFilePresent2 ? "config" : "heuristic";
     console.log(
@@ -10020,7 +10454,7 @@ async function runDetect(options) {
     console.log();
     return;
   }
-  const configPath = path19.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path20.join(config.docsDir, ".lee-spec-kit.json");
   const configFilePresent = await fs15.pathExists(configPath);
   const detectionSource = configFilePresent ? "config" : "heuristic";
   console.log(chalk6.green(`- ${tr(lang, "cli", "detect.resultDetected")}`));
@@ -10054,6 +10488,459 @@ async function runDetect(options) {
   }
   console.log();
 }
+function t(lang, ko, en) {
+  return lang === "ko" ? ko : en;
+}
+function quotePath(value) {
+  return `"${value.replace(/"/g, '\\"')}"`;
+}
+function toSlug(value) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "project";
+}
+function runGit(args, cwd) {
+  try {
+    return execFileSync("git", args, {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return void 0;
+  }
+}
+function isGitRepo(cwd) {
+  return runGit(["rev-parse", "--is-inside-work-tree"], cwd) === "true";
+}
+function hasHeadCommit(cwd) {
+  return !!runGit(["rev-parse", "--verify", "HEAD"], cwd);
+}
+function getOriginUrl(cwd) {
+  const out = runGit(["remote", "get-url", "origin"], cwd);
+  return out || void 0;
+}
+function hasTemplateMarkers(content) {
+  const patterns = [
+    /\{\{projectName\}\}/,
+    /\{\{date\}\}/,
+    /\(Write your project mission here\)/,
+    /\(Write project-specific architecture principles here/i,
+    /\(Write project code quality standards here/i,
+    /\(Write project security principles here/i,
+    /\(Write your project-specific rules here\)/,
+    /\(Override default rules or add additional rules here\)/,
+    /\(Write project-specific workflows here\)/,
+    /\(Write other rules here\)/,
+    /\(프로젝트의 미션을 작성하세요\)/,
+    /\(프로젝트별 아키텍처 원칙을 작성하세요/,
+    /\(프로젝트의 코드 품질 기준을 작성하세요/,
+    /\(프로젝트의 보안 원칙을 작성하세요/,
+    /\(여기에 프로젝트만의 규칙을 작성하세요\)/,
+    /\(기본 규칙을 오버라이드하거나 추가 규칙을 작성하세요\)/,
+    /\(프로젝트만의 워크플로우가 있다면 작성하세요\)/,
+    /\(기타 규칙을 작성하세요\)/
+  ];
+  return patterns.some((pattern) => pattern.test(content));
+}
+async function countFeatureDirs(docsDir, projectType) {
+  const pattern = projectType === "single" ? "features/*/" : "features/*/*/";
+  const dirs = await glob(pattern, {
+    cwd: docsDir,
+    absolute: false,
+    ignore: ["**/feature-base/**"]
+  });
+  return dirs.map((value) => value.replace(/\\/g, "/").replace(/\/+$/, "")).filter((value) => {
+    const base = path20.posix.basename(value);
+    return !!base && base !== "feature-base";
+  }).length;
+}
+async function hasUserPrdFile(prdDir) {
+  if (!await fs15.pathExists(prdDir)) return false;
+  const files = await glob("**/*.md", {
+    cwd: prdDir,
+    nodir: true,
+    absolute: false,
+    ignore: ["**/node_modules/**"]
+  });
+  return files.some((relativePath) => path20.basename(relativePath).toLowerCase() !== "readme.md");
+}
+function finalizeChecks(checks) {
+  const summary = checks.reduce(
+    (acc, check) => {
+      acc[check.status] += 1;
+      return acc;
+    },
+    { ok: 0, warn: 0, block: 0 }
+  );
+  const status = summary.block > 0 ? "blocked" : summary.warn > 0 ? "needs_action" : "ready";
+  return { checks, summary, status };
+}
+function printOnboardResult(lang, result) {
+  console.log();
+  console.log(chalk6.bold(t(lang, "\u{1F9ED} Onboarding \uC810\uAC80", "\u{1F9ED} Onboarding Checks")));
+  for (const check of result.checks) {
+    const mark = check.status === "ok" ? chalk6.green("\u2705") : check.status === "warn" ? chalk6.yellow("\u26A0\uFE0F") : chalk6.red("\u274C");
+    const level = check.status === "ok" ? chalk6.green("OK") : check.status === "warn" ? chalk6.yellow("WARN") : chalk6.red("BLOCK");
+    console.log(`${mark} [${level}] ${check.title}`);
+    console.log(`   ${check.message}`);
+    if (check.path) console.log(chalk6.gray(`   path: ${check.path}`));
+    if (check.suggestedCommand) {
+      console.log(chalk6.gray(`   ${t(lang, "\uB2E4\uC74C \uBA85\uB839", "next")}: ${check.suggestedCommand}`));
+    }
+  }
+  console.log();
+  console.log(
+    chalk6.bold(
+      t(
+        lang,
+        `\uC694\uC57D: OK ${result.summary.ok}, WARN ${result.summary.warn}, BLOCK ${result.summary.block}`,
+        `Summary: OK ${result.summary.ok}, WARN ${result.summary.warn}, BLOCK ${result.summary.block}`
+      )
+    )
+  );
+  if (result.status === "ready") {
+    console.log(chalk6.green(t(lang, "\uC628\uBCF4\uB529 \uC900\uBE44\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "Onboarding checks passed.")));
+  } else if (result.status === "needs_action") {
+    console.log(chalk6.yellow(t(lang, "\uCD94\uAC00 \uC815\uB9AC\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.", "Some onboarding actions are required.")));
+  } else {
+    console.log(chalk6.red(t(lang, "\uC628\uBCF4\uB529 \uC120\uD589 \uC791\uC5C5\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", "Onboarding is blocked by required setup.")));
+  }
+  console.log();
+}
+async function runOnboardChecks(config) {
+  const lang = config.lang;
+  const checks = [];
+  const docsDir = config.docsDir;
+  const docsGitReady = isGitRepo(docsDir);
+  if (!docsGitReady) {
+    checks.push({
+      id: "docs_git_repo",
+      status: "block",
+      title: t(lang, "docs Git \uB808\uD3EC \uCD08\uAE30\uD654", "Docs git repository initialized"),
+      message: t(
+        lang,
+        "docs \uACBD\uB85C\uAC00 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uC544\uB2D9\uB2C8\uB2E4.",
+        "Docs directory is not a git repository."
+      ),
+      path: docsDir,
+      suggestedCommand: `git -C ${quotePath(docsDir)} init`
+    });
+  } else {
+    checks.push({
+      id: "docs_git_repo",
+      status: "ok",
+      title: t(lang, "docs Git \uB808\uD3EC \uCD08\uAE30\uD654", "Docs git repository initialized"),
+      message: t(lang, "docs Git \uB808\uD3EC\uAC00 \uD655\uC778\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "Docs git repository is available."),
+      path: docsDir
+    });
+    if (!hasHeadCommit(docsDir)) {
+      checks.push({
+        id: "docs_initial_commit",
+        status: "warn",
+        title: t(lang, "docs \uCD08\uAE30 \uCEE4\uBC0B", "Docs initial commit"),
+        message: t(
+          lang,
+          "docs \uCCAB \uCEE4\uBC0B\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uCD08\uAE30 \uC124\uC815 \uCEE4\uBC0B\uC744 \uBA3C\uC800 \uC0DD\uC131\uD558\uC138\uC694.",
+          "No initial commit found in docs repo. Create an initial setup commit first."
+        ),
+        path: docsDir,
+        suggestedCommand: `git -C ${quotePath(docsDir)} add . && git -C ${quotePath(docsDir)} commit -m "docs: onboard setup"`
+      });
+    } else {
+      checks.push({
+        id: "docs_initial_commit",
+        status: "ok",
+        title: t(lang, "docs \uCD08\uAE30 \uCEE4\uBC0B", "Docs initial commit"),
+        message: t(lang, "docs \uCD08\uAE30 \uCEE4\uBC0B\uC774 \uC874\uC7AC\uD569\uB2C8\uB2E4.", "Initial commit exists in docs repo."),
+        path: docsDir
+      });
+    }
+    const docsDirty = runGit(["status", "--porcelain=v1"], docsDir);
+    if (docsDirty === void 0) {
+      checks.push({
+        id: "docs_worktree",
+        status: "warn",
+        title: t(lang, "docs \uC791\uC5C5 \uD2B8\uB9AC \uC0C1\uD0DC", "Docs worktree status"),
+        message: t(
+          lang,
+          "docs \uBCC0\uACBD \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+          "Unable to read docs worktree status."
+        ),
+        path: docsDir
+      });
+    } else if (docsDirty.trim().length > 0) {
+      checks.push({
+        id: "docs_worktree",
+        status: "warn",
+        title: t(lang, "docs \uC791\uC5C5 \uD2B8\uB9AC \uC0C1\uD0DC", "Docs worktree status"),
+        message: t(
+          lang,
+          "\uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 docs \uBCC0\uACBD\uC0AC\uD56D\uC774 \uC788\uC2B5\uB2C8\uB2E4.",
+          "Uncommitted docs changes were found."
+        ),
+        path: docsDir,
+        suggestedCommand: `git -C ${quotePath(docsDir)} add . && git -C ${quotePath(docsDir)} commit -m "docs: onboard updates"`
+      });
+    } else {
+      checks.push({
+        id: "docs_worktree",
+        status: "ok",
+        title: t(lang, "docs \uC791\uC5C5 \uD2B8\uB9AC \uC0C1\uD0DC", "Docs worktree status"),
+        message: t(lang, "docs \uC791\uC5C5 \uD2B8\uB9AC\uAC00 \uAE68\uB057\uD569\uB2C8\uB2E4.", "Docs worktree is clean."),
+        path: docsDir
+      });
+    }
+  }
+  const constitutionPath = path20.join(docsDir, "agents", "constitution.md");
+  if (!await fs15.pathExists(constitutionPath)) {
+    checks.push({
+      id: "constitution_exists",
+      status: "block",
+      title: t(lang, "Constitution \uC791\uC131", "Constitution setup"),
+      message: t(
+        lang,
+        "`agents/constitution.md` \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.",
+        "`agents/constitution.md` is missing."
+      ),
+      path: constitutionPath,
+      suggestedCommand: `npx lee-spec-kit update --agents`
+    });
+  } else {
+    const content = await fs15.readFile(constitutionPath, "utf-8");
+    if (hasTemplateMarkers(content)) {
+      checks.push({
+        id: "constitution_filled",
+        status: "block",
+        title: t(lang, "Constitution \uC791\uC131", "Constitution setup"),
+        message: t(
+          lang,
+          "Constitution\uC5D0 \uD15C\uD50C\uB9BF placeholder\uAC00 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8 \uAE30\uC900\uC73C\uB85C \uBA3C\uC800 \uC791\uC131\uD558\uC138\uC694.",
+          "Constitution still contains template placeholders. Fill project-specific content first."
+        ),
+        path: constitutionPath
+      });
+    } else {
+      checks.push({
+        id: "constitution_filled",
+        status: "ok",
+        title: t(lang, "Constitution \uC791\uC131", "Constitution setup"),
+        message: t(lang, "Constitution\uC774 \uC791\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "Constitution looks filled."),
+        path: constitutionPath
+      });
+    }
+  }
+  const customPath = path20.join(docsDir, "agents", "custom.md");
+  if (await fs15.pathExists(customPath)) {
+    const content = await fs15.readFile(customPath, "utf-8");
+    if (hasTemplateMarkers(content)) {
+      checks.push({
+        id: "custom_optional",
+        status: "warn",
+        title: t(lang, "Custom \uADDC\uCE59 \uBB38\uC11C", "Custom rules doc"),
+        message: t(
+          lang,
+          "`agents/custom.md`\uB294 \uC120\uD0DD \uD56D\uBAA9\uC774\uC9C0\uB9CC, \uD604\uC7AC \uD15C\uD50C\uB9BF \uC0C1\uD0DC\uC785\uB2C8\uB2E4. \uD544\uC694\uD558\uBA74 \uADDC\uCE59\uC744 \uC791\uC131\uD558\uC138\uC694.",
+          "`agents/custom.md` is optional, but it still looks like template content. Fill it if your project needs custom rules."
+        ),
+        path: customPath
+      });
+    } else {
+      checks.push({
+        id: "custom_optional",
+        status: "ok",
+        title: t(lang, "Custom \uADDC\uCE59 \uBB38\uC11C", "Custom rules doc"),
+        message: t(lang, "Custom \uADDC\uCE59 \uBB38\uC11C\uAC00 \uAD6C\uC131\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "Custom rules doc looks configured."),
+        path: customPath
+      });
+    }
+  }
+  const prdDir = path20.join(docsDir, "prd");
+  const featureCount = await countFeatureDirs(docsDir, config.projectType);
+  const prdReady = await hasUserPrdFile(prdDir);
+  if (!prdReady) {
+    checks.push({
+      id: "prd_ready",
+      status: featureCount === 0 ? "block" : "warn",
+      title: t(lang, "PRD \uC900\uBE44 \uC0C1\uD0DC", "PRD readiness"),
+      message: featureCount === 0 ? t(
+        lang,
+        "PRD \uBB38\uC11C\uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. Feature \uC0DD\uC131 \uC804\uC5D0 PRD\uBD80\uD130 \uC791\uC131\uD558\uC138\uC694.",
+        "PRD is empty. Write PRD first before creating features."
+      ) : t(
+        lang,
+        "PRD \uBB38\uC11C\uAC00 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uC774\uBBF8 Feature\uAC00 \uC788\uB2E4\uBA74 PRD\uB97C \uBCF4\uAC15\uD558\uC138\uC694.",
+        "PRD is empty. If features already exist, fill PRD as soon as possible."
+      ),
+      path: prdDir,
+      suggestedCommand: `touch ${quotePath(path20.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
+    });
+  } else {
+    checks.push({
+      id: "prd_ready",
+      status: "ok",
+      title: t(lang, "PRD \uC900\uBE44 \uC0C1\uD0DC", "PRD readiness"),
+      message: t(lang, "PRD \uBB38\uC11C\uAC00 \uD655\uC778\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", "PRD document is present."),
+      path: prdDir
+    });
+  }
+  const workflowPolicy = resolveWorkflowPolicy(config.workflow);
+  if (workflowPolicy.mode === "github") {
+    const projectKeys = config.projectType === "multi" ? resolveProjectComponents(config.projectType, config.components) : ["single"];
+    for (const key of projectKeys) {
+      const resolved = resolveProjectGitCwd(config, key, lang);
+      const title = t(
+        lang,
+        config.projectType === "multi" ? `\uD504\uB85C\uC81D\uD2B8 Git \uC5F0\uACB0 (${key})` : "\uD504\uB85C\uC81D\uD2B8 Git \uC5F0\uACB0",
+        config.projectType === "multi" ? `Project git connectivity (${key})` : "Project git connectivity"
+      );
+      if (resolved.warning || !resolved.cwd) {
+        checks.push({
+          id: `project_git_${key}`,
+          status: "block",
+          title,
+          message: resolved.warning || t(
+            lang,
+            "\uD504\uB85C\uC81D\uD2B8 \uB808\uD3EC \uACBD\uB85C\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
+            "Project repository path could not be resolved."
+          )
+        });
+        continue;
+      }
+      if (!isGitRepo(resolved.cwd)) {
+        checks.push({
+          id: `project_git_${key}`,
+          status: "block",
+          title,
+          message: t(
+            lang,
+            "\uD504\uB85C\uC81D\uD2B8 \uACBD\uB85C\uAC00 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uC544\uB2D9\uB2C8\uB2E4.",
+            "Project path is not a git repository."
+          ),
+          path: resolved.cwd,
+          suggestedCommand: `git -C ${quotePath(resolved.cwd)} init`
+        });
+        continue;
+      }
+      const origin = getOriginUrl(resolved.cwd);
+      if (!origin) {
+        checks.push({
+          id: `project_origin_${key}`,
+          status: "block",
+          title: t(
+            lang,
+            config.projectType === "multi" ? `\uD504\uB85C\uC81D\uD2B8 origin \uC124\uC815 (${key})` : "\uD504\uB85C\uC81D\uD2B8 origin \uC124\uC815",
+            config.projectType === "multi" ? `Project origin configured (${key})` : "Project origin configured"
+          ),
+          message: t(
+            lang,
+            "GitHub \uC6CC\uD06C\uD50C\uB85C\uC6B0\uB97C \uC704\uD574 \uD504\uB85C\uC81D\uD2B8 \uB808\uD3EC\uC758 origin remote\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
+            "Project repo origin remote is required for github workflow."
+          ),
+          path: resolved.cwd,
+          suggestedCommand: `git -C ${quotePath(resolved.cwd)} remote add origin <git-url>`
+        });
+      } else {
+        checks.push({
+          id: `project_origin_${key}`,
+          status: "ok",
+          title: t(
+            lang,
+            config.projectType === "multi" ? `\uD504\uB85C\uC81D\uD2B8 origin \uC124\uC815 (${key})` : "\uD504\uB85C\uC81D\uD2B8 origin \uC124\uC815",
+            config.projectType === "multi" ? `Project origin configured (${key})` : "Project origin configured"
+          ),
+          message: t(
+            lang,
+            `origin\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: ${origin}`,
+            `origin is configured: ${origin}`
+          ),
+          path: resolved.cwd
+        });
+      }
+    }
+  }
+  if (config.docsRepo === "standalone" && config.pushDocs) {
+    const origin = getOriginUrl(docsDir);
+    if (!origin) {
+      checks.push({
+        id: "docs_origin",
+        status: "block",
+        title: t(lang, "docs origin \uC124\uC815", "Docs origin configured"),
+        message: t(
+          lang,
+          "standalone + pushDocs=true \uC124\uC815\uC5D0\uC11C\uB294 docs origin remote\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
+          "docs origin remote is required when standalone + pushDocs=true."
+        ),
+        path: docsDir,
+        suggestedCommand: `git -C ${quotePath(docsDir)} remote add origin <docs-git-url>`
+      });
+    } else {
+      checks.push({
+        id: "docs_origin",
+        status: "ok",
+        title: t(lang, "docs origin \uC124\uC815", "Docs origin configured"),
+        message: t(lang, `origin\uC774 \uC124\uC815\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: ${origin}`, `origin is configured: ${origin}`),
+        path: docsDir
+      });
+    }
+  }
+  return finalizeChecks(checks);
+}
+function onboardCommand(program2) {
+  program2.command("onboard").description("Run onboarding checks for initial setup").option("--json", "Output in JSON format for agents").option("--strict", "Exit with code 1 when WARN/BLOCK exists").action(async (options) => {
+    try {
+      await runOnboard(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(
+          chalk6.red(tr(lang, "cli", "common.errorLabel")),
+          chalk6.red(`[${cliError.code}] ${cliError.message}`)
+        );
+        printCliErrorSuggestions(suggestions, lang);
+      }
+      process.exit(1);
+    }
+  });
+}
+async function runOnboard(options) {
+  const config = await getConfig(process.cwd());
+  if (!config) {
+    throw createCliError(
+      "CONFIG_NOT_FOUND",
+      tr(DEFAULT_LANG, "cli", "common.configNotFound")
+    );
+  }
+  const lang = config.lang;
+  const result = await runOnboardChecks(config);
+  if (options.json) {
+    const payload = {
+      status: "ok",
+      reasonCode: result.status === "ready" ? "ONBOARD_READY" : result.status === "needs_action" ? "ONBOARD_NEEDS_ACTION" : "ONBOARD_BLOCKED",
+      docsDir: config.docsDir,
+      docsRepo: config.docsRepo || "embedded",
+      workflow: resolveWorkflowPolicy(config.workflow),
+      summary: result.summary,
+      checks: result.checks
+    };
+    console.log(JSON.stringify(payload, null, 2));
+  } else {
+    printOnboardResult(lang, result);
+  }
+  if (options.strict && (result.summary.warn > 0 || result.summary.block > 0)) {
+    process.exitCode = 1;
+  }
+}
 function isBannerDisabled() {
   const v = (process.env.LEE_SPEC_KIT_NO_BANNER || "").trim();
   return v === "1";
@@ -10097,11 +10984,11 @@ ${version}
   }
   return `${ascii}${footer}`;
 }
-var CACHE_FILE = path19.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+var CACHE_FILE = path20.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path19.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path20.join(__dirname$1, "..", "package.json");
     if (fs15.existsSync(packageJsonPath)) {
       const pkg = fs15.readJsonSync(packageJsonPath);
       return pkg.version;
@@ -10205,7 +11092,7 @@ function shouldCheckForUpdates() {
 if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
-    const packageJsonPath = path19.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path20.join(__dirname$1, "..", "package.json");
     if (fs15.existsSync(packageJsonPath)) {
       const pkg = fs15.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);
@@ -10233,4 +11120,5 @@ flowCommand(program);
 githubCommand(program);
 docsCommand(program);
 detectCommand(program);
+onboardCommand(program);
 await program.parseAsync();