lee-spec-kit 0.7.9 → 0.7.11

package/dist/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import path15 from 'path';
+import path16 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import fs from 'fs-extra';
@@ -8,11 +8,12 @@ import chalk9 from 'chalk';
 import { spawn, spawnSync, execFileSync, execSync } from 'child_process';
 import os from 'os';
 import { createHash, randomUUID } from 'crypto';
-import fs12 from 'fs';
+import fs13 from 'fs';
+import fs20 from 'fs/promises';
 import { Buffer as Buffer$1 } from 'buffer';
 
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path15.dirname(getFilename());
+var getDirname = () => path16.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function walkFiles(fsAdapter, rootDir, options = {}) {
   const out = [];
@@ -25,7 +26,7 @@ async function walkFiles(fsAdapter, rootDir, options = {}) {
   async function visit(current) {
     const entries = await fsAdapter.readdir(current);
     for (const entryName of entries) {
-      const absolute = path15.join(current, entryName);
+      const absolute = path16.join(current, entryName);
       const stat = await fsAdapter.stat(absolute);
       if (stat.isDirectory()) {
         if (ignored.has(entryName.trim().toLowerCase())) continue;
@@ -34,7 +35,7 @@ async function walkFiles(fsAdapter, rootDir, options = {}) {
       }
       if (!stat.isFile()) continue;
       if (normalizedExtensions.size > 0) {
-        const ext = path15.extname(entryName).toLowerCase();
+        const ext = path16.extname(entryName).toLowerCase();
         if (!normalizedExtensions.has(ext)) continue;
       }
       out.push(absolute);
@@ -50,7 +51,7 @@ async function listSubdirectories(fsAdapter, rootDir) {
   const entries = await fsAdapter.readdir(rootDir);
   const dirs = [];
   for (const entryName of entries) {
-    const absolute = path15.join(rootDir, entryName);
+    const absolute = path16.join(rootDir, entryName);
     const stat = await fsAdapter.stat(absolute);
     if (stat.isDirectory()) {
       dirs.push(absolute);
@@ -151,10 +152,10 @@ var DefaultFileSystemAdapter = class {
   }
 };
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path15.dirname(__filename2);
+var __dirname2 = path16.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path15.resolve(__dirname2, "..");
-  return path15.join(rootDir, "templates");
+  const rootDir = path16.resolve(__dirname2, "..");
+  return path16.join(rootDir, "templates");
 }
 
 // src/utils/locales/ko/cli.ts
@@ -212,7 +213,7 @@ var koCli = {
   "doctor.issue.tasksEmpty": "tasks.md\uC5D0 \uD0DC\uC2A4\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md\uC758 \uBB38\uC11C \uC0C1\uD0DC(Doc Status)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md\uC5D0 \uBB38\uC11C \uC0C1\uD0DC(Doc Status) \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. `- **\uBB38\uC11C \uC0C1\uD0DC**: -`\uC640 `\uAC12: Draft | Review | Approved`\uB97C \uCD94\uAC00\uD558\uC138\uC694.",
-  "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C PRD-FR-001 \uAC19\uC740 ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md\uC5D0 \uC815\uC758\uB418\uC9C0 \uC54A\uC740 PRD \uD0DC\uADF8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: {ids}{extra}. tasks.md\uC5D0\uC11C `PRD-*` ID\uB97C \uC784\uC758\uB85C \uB9CC\uB4E4\uC9C0 \uB9D0\uACE0, \uBA3C\uC800 docs/prd \uB610\uB294 \uC0C1\uC704 \uC694\uAD6C\uC0AC\uD56D \uBB38\uC11C\uC5D0 ID\uB97C backfill\uD55C \uB4A4 spec.md `PRD Refs`\uC640 tasks \uD0DC\uADF8\uB97C \uD568\uAED8 \uB9DE\uCD94\uC138\uC694.",
   "doctor.issue.unmanagedDocsEntry": "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {path}. \uCD5C\uC885 SSOT\uB85C \uC4F0\uC9C0 \uB9D0\uACE0 feature-local docs\uB85C \uC815\uADDC\uD654\uD558\uAC70\uB098, \uC758\uB3C4\uB41C \uACBD\uB85C\uB77C\uBA74 `.lee-spec-kit.json`\uC758 `allowedDocsEntries`\uC5D0 \uCD94\uAC00\uD558\uC138\uC694.",
   "doctor.issue.duplicateFeatureId": "\uC911\uBCF5 Feature ID \uAC10\uC9C0: {id} ({count}\uAC1C)",
   "doctor.issue.missingFeatureId": "Feature \uD3F4\uB354\uBA85\uC774 F001-... \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4. (ID\uB97C \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC74C)",
@@ -255,7 +256,7 @@ var koCli = {
   "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.nextSteps4": "  4. \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8 AGENTS.md \uC5C6\uC774 Codex\uB97C \uC4F4\uB2E4\uBA74 bootstrap \uC124\uCE58: npx lee-spec-kit setup codex-bootstrap",
+  "init.log.nextSteps4": "  4. \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8 AGENTS.md \uC5C6\uC774 Codex\uB97C \uC4F4\uB2E4\uBA74 bootstrap helper \uB97C \uC120\uD0DD\uC801\uC73C\uB85C \uC124\uCE58: npx lee-spec-kit integrations codex",
   "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,10 +275,10 @@ var koCli = {
   "idea.nextSteps1": "  1. \uBC94\uC704, PRD Refs, \uC2B9\uACA9 \uBA54\uBAA8\uB97C \uC791\uC131",
   "idea.nextSteps2": "  2. Feature\uB85C \uC2B9\uACA9: npx lee-spec-kit feature <name> --idea {ideaId}",
   "idea.nextSteps3": "  3. Feature\uB85C \uB9CC\uB4E4\uC9C0 \uC54A\uC744 \uACBD\uC6B0 Dropped\uB85C \uD45C\uC2DC",
-  "setup.codexBootstrapInstalled": "\u2705 Codex bootstrap \uC124\uCE58 \uC644\uB8CC: {path}",
-  "setup.codexBootstrapAlreadyInstalled": "\u2705 Codex bootstrap \uC774 \uC774\uBBF8 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: {path}",
-  "setup.codexBootstrapRemoved": "\u2705 Codex bootstrap \uC81C\uAC70 \uC644\uB8CC: {path}",
-  "setup.codexBootstrapAlreadyAbsent": "\u2705 Codex bootstrap \uC774 \uC774\uBBF8 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
+  "setup.codexBootstrapInstalled": "\u2705 \uC120\uD0DD\uC801 Codex bootstrap \uC124\uCE58 \uC644\uB8CC: {path}",
+  "setup.codexBootstrapAlreadyInstalled": "\u2705 \uC120\uD0DD\uC801 Codex bootstrap \uC774 \uC774\uBBF8 \uC124\uCE58\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: {path}",
+  "setup.codexBootstrapRemoved": "\u2705 \uC120\uD0DD\uC801 Codex bootstrap \uC81C\uAC70 \uC644\uB8CC: {path}",
+  "setup.codexBootstrapAlreadyAbsent": "\u2705 \uC120\uD0DD\uC801 Codex bootstrap \uC774 \uC774\uBBF8 \uC5C6\uC2B5\uB2C8\uB2E4: {path}",
   "github.cmdGithubDescription": "GitHub \uC6CC\uD06C\uD50C\uB85C\uC6B0 \uB3C4\uC6B0\uBBF8 (issue/pr \uBCF8\uBB38 \uD15C\uD50C\uB9BF \uC0DD\uC131, \uAC80\uC99D, merge \uC7AC\uC2DC\uB3C4)",
   "github.cmdIssueDescription": "feature \uBB38\uC11C \uAE30\uBC18 GitHub issue \uBCF8\uBB38 \uC0DD\uC131/\uC0DD\uC131",
   "github.cmdPrDescription": "GitHub PR \uBCF8\uBB38 \uC0DD\uC131/\uC0DD\uC131 + tasks \uB3D9\uAE30\uD654 + merge \uC7AC\uC2DC\uB3C4",
@@ -478,7 +479,7 @@ var koContext = {
   "context.checkRequired": "[\uD655\uC778 \uD544\uC694] ",
   "context.checkPolicyHint": "\u2139\uFE0F  \uC0AC\uC6A9\uC790 \uD655\uC778 \uC815\uCC45\uC740 \uC138\uC158 \uC2DC\uC791(\uB610\uB294 context \uC555\uCD95/\uB9AC\uC14B \uC9C1\uD6C4)\uC5D0 1\uD68C \uD655\uC778\uD558\uACE0, \uC774\uD6C4\uC5D0\uB294 \uC815\uCC45/\uC124\uC815 \uBCC0\uACBD \uB610\uB294 \uC0AC\uC6A9\uC790 \uC0C8\uB85C\uACE0\uCE68 \uC694\uCCAD \uC2DC\uC5D0\uB9CC \uC7AC\uD655\uC778\uD558\uC138\uC694. (git push/merge/merge commit \uD3EC\uD568) [\uD655\uC778 \uD544\uC694]\uAC00 \uC788\uC73C\uBA74 \uB77C\uBCA8 \uD1A0\uD070 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC5D0 \uB9DE\uB294 \uC751\uB2F5\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589\uD558\uC138\uC694. (config: approval\uB85C \uC870\uC815 \uAC00\uB2A5)",
   "context.actionOptionHint": "\uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59: `A`, `A OK`, `A \uC9C4\uD589\uD574` \uC911 \uD558\uB098\uC758 \uD615\uC2DD\uC73C\uB85C \uC751\uB2F5",
-  "context.actionExplainHint": "CLI\uAC00 \uC900 \uC2B9\uC778 \uBB38\uAD6C\uB97C \uBA3C\uC800 \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uC138\uC694. \uCD94\uAC00 \uC124\uBA85\uC740 \uC0AC\uC6A9\uC790\uAC00 \uBB3C\uC744 \uB54C\uB9CC \uB367\uBD99\uC774\uACE0, \uC2B9\uC778 \uBB38\uAD6C \uC790\uCCB4\uB294 \uBC14\uAFB8\uC9C0 \uB9C8\uC138\uC694.",
+  "context.actionExplainHint": "\uC2B9\uC778 \uB300\uAE30 \uC0C1\uD0DC\uB77C\uBA74 `matchedFeature.currentSubstate*` \uAE30\uBC18 \uD604\uC7AC \uB2E8\uACC4 \uD55C \uC904 \uC694\uC57D\uC744 \uBA3C\uC800 \uBD99\uC77C \uC218 \uC788\uACE0, \uADF8 \uB2E4\uC74C CLI\uAC00 \uC900 \uC2B9\uC778 \uBB38\uAD6C\uB97C \uADF8\uB300\uB85C \uBCF4\uC5EC\uC8FC\uC138\uC694. \uCD94\uAC00 \uC124\uBA85\uC740 \uC0AC\uC6A9\uC790\uAC00 \uBB3C\uC744 \uB54C\uB9CC \uB367\uBD99\uC774\uACE0, \uC2B9\uC778 \uBB38\uAD6C \uC790\uCCB4\uB294 \uBC14\uAFB8\uC9C0 \uB9C8\uC138\uC694.",
   "context.finalLabelPrompt": "\uD604\uC7AC \uC120\uD0DD \uAC00\uB2A5\uD55C \uB77C\uBCA8: {labels}. \uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC73C\uB85C \uC751\uB2F5\uD558\uC138\uC694. (\uC608: `{example}`)",
   "context.finalLabelPromptWithRequest": "\uD604\uC7AC \uC120\uD0DD \uAC00\uB2A5\uD55C \uB77C\uBCA8: {labels}. \uB77C\uBCA8 \uC751\uB2F5 \uADDC\uCE59(`A`, `A OK`, `A \uC9C4\uD589\uD574`)\uC73C\uB85C \uC751\uB2F5\uD558\uC138\uC694. (\uC608: `{example}`) \uC694\uCCAD \uD14D\uC2A4\uD2B8\uAC00 \uD544\uC694\uD55C \uB77C\uBCA8\uC740 \uB2E4\uC74C \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD558\uC138\uC694: {requestExamples}",
   "context.suggestionHeader": "\uCD94\uCC9C \uB2E4\uC74C \uC120\uD0DD\uC9C0",
@@ -508,6 +509,7 @@ var koContext = {
   "context.actionDetail.tasksWriteCreate": "tasks.md\uB97C \uC0DD\uC131\uD558\uACE0 \uBB38\uC11C \uC0C1\uD0DC\uB97C Review\uB85C \uC124\uC815\uD558\uC138\uC694",
   "context.actionDetail.tasksWriteNeedAtLeastOne": "tasks.md\uC5D0 \uCD5C\uC18C 1\uAC1C \uC774\uC0C1\uC758 \uD0DC\uC2A4\uD06C\uB97C \uCD94\uAC00\uD558\uC138\uC694",
   "context.actionDetail.tasksWriteImprove": "tasks.md\uB97C \uBCF4\uC644\uD558\uACE0 \uBB38\uC11C \uC0C1\uD0DC\uB97C \uC815\uB82C\uD558\uC138\uC694",
+  "context.actionDetail.tasksWriteChangeSync": "\uCD94\uAC00 \uAD6C\uD604 \uC804\uC5D0 \uC0C8 \uC0AC\uC6A9\uC790 \uC694\uCCAD\uC744 tasks.md\uC5D0 \uBA3C\uC800 \uBC18\uC601\uD558\uC138\uC694",
   "context.actionDetail.tasksApprove": "tasks.md\uB97C \uC2B9\uC778\uD569\uB2C8\uB2E4",
   "context.actionDetail.issueCreate": "\uC774\uC288\uB97C \uC0DD\uC131\uD558\uACE0 tasks.md\uC758 \uC774\uC288 \uC815\uBCF4\uB97C \uB9DE\uCD94\uC138\uC694",
   "context.actionDetail.issueCreateAndWrite": "\uC774\uC288 \uCD08\uC548\uC744 \uBCF4\uC644\uD558\uACE0 \uB77C\uBCA8 \uC2B9\uC778(`A` \uB610\uB294 `A OK`) \uD6C4 \uC774\uC288\uB97C \uC0DD\uC131\uD574 \uBC88\uD638\uB97C \uB3D9\uAE30\uD654\uD558\uC138\uC694",
@@ -680,6 +682,7 @@ var koMessages = {
   featureScopeSplitTwo: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) \uAD8C\uC7A5 \uADDC\uCE59\uC0C1 40~79 \uD0DC\uC2A4\uD06C\uC774\uBA74\uC11C \uD558\uB4DC \uAE30\uC900 \uBBF8\uB9CC\uC774\uBA74 2\uAC1C \uC774\uC288 \uBD84\uD560\uC774 \uAE30\uBCF8\uC785\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C \uACB0\uD569\uB3C4/\uD30C\uC77C\uACB9\uCE68/\uD14C\uC2A4\uD2B8/\uBC30\uD3EC \uAE30\uC900\uC73C\uB85C \uBD84\uD560\uD558\uC138\uC694. \uAC01 \uC774\uC288\uC5D0\uB294 \uB2E4\uC74C \uD15C\uD50C\uB9BF\uC744 \uAE30\uB85D\uD558\uC138\uC694: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   featureScopeSplitFour: "Feature \uBC94\uC704\uAC00 \uD07D\uB2C8\uB2E4. (tasks: {taskCount}, decisions \uC904\uC218: {decisionsLineCount}) tasks >= {recommendFourTaskThreshold} \uB610\uB294 decisions \uC904\uC218 >= {recommendFourDecisionsThreshold}\uC774\uBA74 4\uAC1C \uC774\uC288 \uBD84\uD560\uC744 \uAC15\uD558\uAC8C \uAD8C\uC7A5\uD569\uB2C8\uB2E4. `{guideCommand}`\uB97C \uB530\uB77C 4\uAC1C\uC758 \uC5F0\uAD00 \uC774\uC288\uB85C \uBD84\uB9AC\uD558\uACE0 \uC758\uC874 \uC21C\uC11C\uB97C \uBA85\uC2DC\uD55C \uB4A4 PR\uC744 \uC21C\uCC28 \uBA38\uC9C0\uD558\uC138\uC694. \uAC01 \uC774\uC288 \uD15C\uD50C\uB9BF: \uBAA9\uD45C, \uD3EC\uD568 \uBC94\uC704, \uC81C\uC678 \uBC94\uC704, \uC120\uD589 \uC758\uC874\uC131, PR \uC644\uB8CC \uAE30\uC900.",
   userRequestReplan: "\uD604\uC7AC \uB2E8\uACC4\uC640 \uBCC4\uAC1C\uB85C \uC0AC\uC6A9\uC790\uAC00 \uC81C\uC548\uD55C \uC0C8 \uC694\uAD6C\uB97C \uBA3C\uC800 \uBC18\uC601\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uC694\uAD6C\uC0AC\uD56D\uC744 \uC694\uC57D\uD574 tasks.md\uC5D0 \uCD94\uAC00\uD558\uAC70\uB098 \uBCC4\uB3C4 Feature\uB85C \uBD84\uB9AC\uD55C \uB4A4, \uBB38\uC11C \uC0C1\uD0DC\uB97C \uB9DE\uCD94\uACE0 context\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+  changeRequestSync: 'tasks.md\uC5D0 \uC0C8 \uC0AC\uC6A9\uC790 \uC694\uCCAD\uC774 \uAE30\uB85D\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4: "{request}". \uCD94\uAC00 \uAD6C\uD604 \uC804\uC5D0 \uBA3C\uC800 tasks.md\uB97C \uAC31\uC2E0\uD558\uC138\uC694. \uC601\uD5A5\uBC1B\uB294 \uD0DC\uC2A4\uD06C\uB97C \uCD94\uAC00\uD558\uAC70\uB098 \uC7AC\uD0DC\uAE45\uD558\uACE0, \uC774 \uC694\uCCAD\uC774 \uC2E4\uC81C \uC0AC\uC6A9\uC790 \uB3D9\uC791\uC774\uB098 \uBC94\uC704\uB97C \uBC14\uAFB8\uBA74 decisions.md\uC640 spec/PRD \uCC38\uC870\uB3C4 \uD568\uAED8 \uB9DE\uCD94\uC138\uC694. \uB3D9\uAE30\uD654\uAC00 \uB05D\uB098\uBA74 `\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD` \uAC12\uC744 \uBE44\uC6B0\uACE0 context/flow\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.',
   docsUnmanagedNormalize: "lee-spec-kit \uBB38\uC11C \uD45C\uBA74 \uBC16\uC758 \uBB38\uC11C \uC5D4\uD2B8\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4: {paths}. Feature `{featureRef}`\uB97C \uACC4\uC18D \uC9C4\uD589\uD558\uAE30 \uC804\uC5D0 \uC774 \uBB38\uC11C\uB4E4\uC740 reference \uC785\uB825\uC73C\uB85C\uB9CC \uCDE8\uAE09\uD558\uC138\uC694. \uC0AC\uC6A9\uC790 \uBC94\uC704/acceptance\uB294 `spec.md`, \uC544\uD0A4\uD14D\uCC98/\uD30C\uC77C/\uD14C\uC2A4\uD2B8 \uB0B4\uC6A9\uC740 `plan.md`, \uC2E4\uD589 \uC791\uC5C5\uC740 `tasks.md`, \uADFC\uAC70/\uD2B8\uB808\uC774\uB4DC\uC624\uD504\uB294 `decisions.md`\uB85C \uC815\uADDC\uD654\uD55C \uB4A4 `npx lee-spec-kit context {featureRef}`\uB97C \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
   featureDone: "\uC6CC\uD06C\uD50C\uB85C\uC6B0 \uC694\uAD6C\uC0AC\uD56D\uACFC \uB85C\uCEEC \uC815\uB9AC\uAE4C\uC9C0 \uBAA8\uB450 \uB05D\uB0AC\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uC804\uD788 \uC885\uB8CC\uB418\uC5C8\uC2B5\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."
@@ -789,7 +792,7 @@ var enCli = {
   "doctor.issue.tasksEmpty": "tasks.md has no tasks.",
   "doctor.issue.tasksDocStatusUnset": "tasks.md Doc Status is not set. (Set it to Draft, Review, or Approved.)",
   "doctor.issue.tasksDocStatusMissing": "tasks.md is missing the Doc Status field. Add `- **Doc Status**: -` and `Values: Draft | Review | Approved`.",
-  "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent IDs like PRD-FR-001 in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
+  "doctor.issue.tasksPrdTagUnknown": "tasks.md uses PRD tags with no matching source definition: {ids}{extra}. Do not invent `PRD-*` IDs in tasks.md. Backfill IDs in docs/prd or the upstream requirements doc first, then align spec.md `PRD Refs` and task tags.",
   "doctor.issue.unmanagedDocsEntry": "Unmanaged docs entry detected outside the lee-spec-kit docs surface: {path}. Treat it as reference input only, normalize it into feature-local docs, or allowlist it in `.lee-spec-kit.json` `allowedDocsEntries`.",
   "doctor.issue.duplicateFeatureId": "Duplicate Feature ID detected: {id} ({count})",
   "doctor.issue.missingFeatureId": "Feature folder name is not in F001-... format. (Cannot extract ID)",
@@ -832,7 +835,7 @@ var enCli = {
   "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.nextSteps4": "  4. If you use Codex without repo-root AGENTS.md, install bootstrap: npx lee-spec-kit setup codex-bootstrap",
+  "init.log.nextSteps4": "  4. If you use Codex without repo-root AGENTS.md, you can optionally install the bootstrap helper: npx lee-spec-kit integrations codex",
   "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.)',
@@ -851,10 +854,10 @@ var enCli = {
   "idea.nextSteps1": "  1. Fill scope, PRD refs, and promotion notes",
   "idea.nextSteps2": "  2. Promote it with: npx lee-spec-kit feature <name> --idea {ideaId}",
   "idea.nextSteps3": "  3. Mark it dropped if it should not become a feature",
-  "setup.codexBootstrapInstalled": "\u2705 Codex bootstrap installed: {path}",
-  "setup.codexBootstrapAlreadyInstalled": "\u2705 Codex bootstrap already installed: {path}",
-  "setup.codexBootstrapRemoved": "\u2705 Codex bootstrap removed: {path}",
-  "setup.codexBootstrapAlreadyAbsent": "\u2705 Codex bootstrap is already absent: {path}",
+  "setup.codexBootstrapInstalled": "\u2705 Optional Codex bootstrap installed: {path}",
+  "setup.codexBootstrapAlreadyInstalled": "\u2705 Optional Codex bootstrap already installed: {path}",
+  "setup.codexBootstrapRemoved": "\u2705 Optional Codex bootstrap removed: {path}",
+  "setup.codexBootstrapAlreadyAbsent": "\u2705 Optional Codex bootstrap is already absent: {path}",
   "github.cmdGithubDescription": "GitHub workflow helpers (issue/pr templates, validation, merge retry)",
   "github.cmdIssueDescription": "Generate/create GitHub issue body from feature docs with validation",
   "github.cmdPrDescription": "Generate/create GitHub PR body with validation, tasks PR sync, and merge retry",
@@ -1055,7 +1058,7 @@ var enContext = {
   "context.checkRequired": "[CHECK required] ",
   "context.checkPolicyHint": "\u2139\uFE0F  Check user-approval policy once at session start (or right after context compression/reset); re-check only when policy/config changes or the user explicitly requests refresh. (includes git push/merge and merge commits). If you see [CHECK required], wait for a reply that follows label-token rules (`A`, `A OK`, `A proceed`) before proceeding (config: approval can override)",
   "context.actionOptionHint": "Label reply rules: answer as `A`, `A OK`, or `A proceed`",
-  "context.actionExplainHint": "Use the exact approval lines from the CLI first. Add extra explanation only if the user asks, and do not paraphrase the approval prompts.",
+  "context.actionExplainHint": "If approval is pending, you may add one brief current-stage recap from `matchedFeature.currentSubstate*`, then use the exact approval lines from the CLI. Add further explanation only if the user asks, and do not paraphrase the approval prompts.",
   "context.finalLabelPrompt": "Available labels now: {labels}. Reply using label-token rules (`A`, `A OK`, `A proceed`). (e.g. `{example}`)",
   "context.finalLabelPromptWithRequest": "Available labels now: {labels}. Reply using label-token rules (`A`, `A OK`, `A proceed`). (e.g. `{example}`) Labels that require a request must be replied as: {requestExamples}",
   "context.suggestionHeader": "Suggested Next Options",
@@ -1085,6 +1088,7 @@ var enContext = {
   "context.actionDetail.tasksWriteCreate": "Create tasks.md and set Doc Status to Review",
   "context.actionDetail.tasksWriteNeedAtLeastOne": "Add at least one task to tasks.md",
   "context.actionDetail.tasksWriteImprove": "Refine tasks.md and align Doc Status",
+  "context.actionDetail.tasksWriteChangeSync": "Sync the new user request into tasks.md before more implementation",
   "context.actionDetail.tasksApprove": "Approve tasks.md",
   "context.actionDetail.issueCreate": "Create the issue and sync issue fields in tasks.md",
   "context.actionDetail.issueCreateAndWrite": "Draft issue content, get explicit OK, then create and sync Issue",
@@ -1257,6 +1261,7 @@ var enMessages = {
   featureScopeSplitTwo: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Recommendation rule: 40~79 tasks and below the hard threshold usually maps to 2 issues. Follow `{guideCommand}` and split by coupling/file-overlap/test/deploy criteria. For each new issue, document this template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   featureScopeSplitFour: "Feature scope is large (tasks: {taskCount}, decisions lines: {decisionsLineCount}). Hard recommendation is 4 issues when tasks >= {recommendFourTaskThreshold} or decisions lines >= {recommendFourDecisionsThreshold}. Follow `{guideCommand}` and split into 4 linked issues with explicit dependency order and sequential PR merges. Use the per-issue template: Goal, Included Scope, Excluded Scope, Depends On, PR Done Criteria.",
   userRequestReplan: "You can pause this step and handle a newly requested user requirement first. Summarize it, add it to tasks.md or split it into a separate Feature, then align document statuses and rerun context.",
+  changeRequestSync: 'A pending user request is recorded in tasks.md: "{request}". Before more implementation, update tasks.md first. Add or retag the affected task, and if this changes shipped behavior or scope, sync decisions.md plus spec/PRD references as needed. Clear `Pending Change Request` after syncing, then rerun context/flow.',
   docsUnmanagedNormalize: "Unmanaged docs entries were found outside the lee-spec-kit docs surface: {paths}. Before continuing feature `{featureRef}`, treat them as reference inputs only. Normalize user-facing scope and acceptance into `spec.md`, architecture/file/test details into `plan.md`, executable work into `tasks.md`, and rationale/trade-offs into `decisions.md`, then rerun `npx lee-spec-kit context {featureRef}`.",
   featureDone: "All workflow requirements and local cleanup are complete. This feature is fully finished.",
   fallbackRerunContext: "Cannot determine status. Check the docs and run context again."
@@ -1757,10 +1762,10 @@ var DEFAULT_STALE_MS = 2 * 6e4;
 var RUNTIME_GIT_DIRNAME = "lee-spec-kit.runtime";
 var RUNTIME_TEMP_DIRNAME = "lee-spec-kit-runtime";
 function toScopeKey(value) {
-  return createHash("sha1").update(path15.resolve(value)).digest("hex").slice(0, 16);
+  return createHash("sha1").update(path16.resolve(value)).digest("hex").slice(0, 16);
 }
 function getTempRuntimeDir(scopePath) {
-  return path15.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
+  return path16.join(os.tmpdir(), RUNTIME_TEMP_DIRNAME, toScopeKey(scopePath));
 }
 function resolveGitRuntimeDir(cwd) {
   try {
@@ -1774,38 +1779,38 @@ function resolveGitRuntimeDir(cwd) {
       }
     ).trim();
     if (!out) return null;
-    return path15.isAbsolute(out) ? out : path15.resolve(cwd, out);
+    return path16.isAbsolute(out) ? out : path16.resolve(cwd, out);
   } catch {
     return null;
   }
 }
 function getRuntimeStateDir(cwd) {
-  const resolved = path15.resolve(cwd);
+  const resolved = path16.resolve(cwd);
   return resolveGitRuntimeDir(resolved) ?? getTempRuntimeDir(resolved);
 }
 function getDocsLockPath(docsDir) {
-  return path15.join(
+  return path16.join(
     getRuntimeStateDir(docsDir),
     "locks",
     `docs-${toScopeKey(docsDir)}.lock`
   );
 }
 function getInitLockPath(targetDir) {
-  return path15.join(
-    getRuntimeStateDir(path15.dirname(path15.resolve(targetDir))),
+  return path16.join(
+    getRuntimeStateDir(path16.dirname(path16.resolve(targetDir))),
     "locks",
     `init-${toScopeKey(targetDir)}.lock`
   );
 }
 function getApprovalTicketStorePath(docsDir) {
-  return path15.join(
+  return path16.join(
     getRuntimeStateDir(docsDir),
     "tickets",
     `approval-${toScopeKey(docsDir)}.json`
   );
 }
 function getProjectExecutionLockPath(cwd) {
-  return path15.join(getRuntimeStateDir(cwd), "locks", "project.lock");
+  return path16.join(getRuntimeStateDir(cwd), "locks", "project.lock");
 }
 async function isStaleLock(lockPath, staleMs) {
   try {
@@ -1846,7 +1851,7 @@ function isProcessAlive(pid) {
   }
 }
 async function tryAcquire(lockPath, owner) {
-  await fs.ensureDir(path15.dirname(lockPath));
+  await fs.ensureDir(path16.dirname(lockPath));
   try {
     const fd = await fs.open(lockPath, "wx");
     const payload = JSON.stringify(
@@ -1923,30 +1928,30 @@ var ENGINE_MANAGED_AGENT_FILES = [
   "pr-template.md"
 ];
 var ENGINE_MANAGED_AGENT_DIRS = ["skills"];
-var ENGINE_MANAGED_FEATURE_PATH = path15.join(
+var ENGINE_MANAGED_FEATURE_PATH = path16.join(
   "features",
   "feature-base"
 );
 async function pruneEngineManagedDocs(docsDir) {
   const removed = [];
   for (const file of ENGINE_MANAGED_AGENT_FILES) {
-    const target = path15.join(docsDir, "agents", file);
+    const target = path16.join(docsDir, "agents", file);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path15.relative(docsDir, target));
+      removed.push(path16.relative(docsDir, target));
     }
   }
   for (const dir of ENGINE_MANAGED_AGENT_DIRS) {
-    const target = path15.join(docsDir, "agents", dir);
+    const target = path16.join(docsDir, "agents", dir);
     if (await fs.pathExists(target)) {
       await fs.remove(target);
-      removed.push(path15.relative(docsDir, target));
+      removed.push(path16.relative(docsDir, target));
     }
   }
-  const featureBasePath = path15.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
+  const featureBasePath = path16.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
   if (await fs.pathExists(featureBasePath)) {
     await fs.remove(featureBasePath);
-    removed.push(path15.relative(docsDir, featureBasePath));
+    removed.push(path16.relative(docsDir, featureBasePath));
   }
   return removed;
 }
@@ -2027,25 +2032,24 @@ Auto-run continuity (main/sub-agent orchestration):
   3. Else run \`npx lee-spec-kit context --json-compact\` (fallback: \`--json\`) and continue from current \`actionOptions\`/\`autoRun\`.
 - Pause and report to user only when:
   - \`approvalRequest.required === true\`, or
-  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\`, \`AUTO_DELEGATED_HANDOFF\`, or \`AUTO_MANUAL_REQUIRED\`, or
+  - \`autoRun.reasonCode\` is \`AUTO_GATE_REACHED\`, \`AUTO_DELEGATED_HANDOFF\`, \`AUTO_MANUAL_REQUIRED\`, or \`AUTO_SELECTION_REQUIRED\`, or
   - command execution fails (non-zero/error), or
   - user explicitly asks to pause.
+- Special case: if \`matchedFeature.currentSubstateId === "change_request_sync"\` or \`matchedFeature.pendingChangeRequest\` is present, treat that \`AUTO_MANUAL_REQUIRED\` state as an internal docs-sync step first, not an immediate user-facing stop. Update \`tasks.md\` first, and if shipped behavior or scope changed, sync \`decisions.md\` plus \`spec.md\` / PRD refs as needed. Clear the pending change field after syncing, then continue with fresh \`context\`/\`flow\`. Only pause/report there if approval becomes required, execution fails, or the user explicitly asked to pause.
 
 User-facing output rule (state-aware):
 
 - Treat approval as a separate state.
-- Approval-waiting state means:
-  - \`context --json-compact\` (or \`context --json\`) includes one or more \`actionOptions\`, and
-  - you are explicitly waiting for user approval before execution.
+- Approval-waiting state means the latest \`context --json-compact\` / \`flow --json-compact\` (fallback: \`context --json\` / \`flow --json\`) shows \`approvalRequest.required === true\`.
+- Do not infer approval-waiting from conversation tone, action type, or whether \`actionOptions[]\` merely exist.
 
 In approval-waiting state:
 
-1. Show \`actionOptions[*].approvalPrompt\` lines (at minimum, the primary label line like \`A: ...\`) exactly as provided.
-2. End with \`approvalRequest.finalPrompt\` exactly as provided.
-3. Do not paraphrase or omit these lines.
-4. Prefer \`approvalRequest.userFacingLines\` as the source for user-facing approval text.
-5. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT.
-6. When \`matchedFeature.currentSubstateOwner="subagent"\` and \`agentOrchestration.subAgentHandoff.required=true\` with \`mode="command"\`, call \`spawn_agent\` first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, continue the delegated work immediately and do not re-open the same approval label.
+1. If \`matchedFeature.currentSubstateId\` is present, prepend one brief current-stage recap derived from \`matchedFeature.currentSubstateId/currentSubstateOwner/currentSubstatePhase\`.
+2. Then show \`approvalRequest.userFacingLines\` exactly as provided. If those lines are unavailable, fall back to \`actionOptions[*].approvalPrompt\` plus \`approvalRequest.finalPrompt\`.
+3. Do not paraphrase, reorder, or omit the CLI-provided approval lines.
+4. Prefer \`matchedFeature.currentSubstateOwner\` plus \`agentOrchestration.subAgentHandoff\` as the delegation SSOT.
+5. When \`matchedFeature.currentSubstateOwner="subagent"\` and \`agentOrchestration.subAgentHandoff.required=true\` with \`mode="command"\`, call \`spawn_agent\` first and do not execute the delegated command directly from the main agent. If the delegated command is handoff-only, continue the delegated work immediately and do not re-open the same approval label.
 
 In non-approval state (progress updates, analysis, tool execution logs, unrelated Q&A):
 
@@ -2056,10 +2060,11 @@ In non-approval state (progress updates, analysis, tool execution logs, unrelate
 If approval is still pending after answering an unrelated question:
 
 - First answer the question.
-- Then re-open approval using both:
-  - \`actionOptions[*].approvalPrompt\` (label meaning included), and
-  - \`approvalRequest.finalPrompt\` (format line).
-- Never output \`finalPrompt\` alone without the matching \`A: ...\` prompt.`;
+- Re-check the latest \`approvalRequest.required\`.
+- If it is still \`true\`, re-open approval with:
+  - one brief current-stage recap from \`matchedFeature.currentSubstateId/currentSubstateOwner/currentSubstatePhase\` when available, then
+  - the exact CLI-provided approval lines from \`approvalRequest.userFacingLines\` (fallback: \`actionOptions[*].approvalPrompt\` + \`approvalRequest.finalPrompt\`).
+- Never output \`finalPrompt\` alone without the matching \`A: ...\` prompt, and do not add custom label-summary wrappers such as \`Available labels:\`.`;
 function renderManagedSegment(lang, docsRepo) {
   return `${LEE_SPEC_KIT_AGENTS_BEGIN}
 ${CANONICAL_LEE_SPEC_KIT_AGENTS_TEXT}
@@ -2127,10 +2132,10 @@ function renderManagedBlock2() {
 function getCodexHome() {
   const explicit = String(process.env.CODEX_HOME || "").trim();
   if (explicit) return explicit;
-  return path15.join(os.homedir(), ".codex");
+  return path16.join(os.homedir(), ".codex");
 }
 function getCodexConfigPath() {
-  return path15.join(getCodexHome(), "config.toml");
+  return path16.join(getCodexHome(), "config.toml");
 }
 function contentIncludesRequiredBootstrap(content) {
   const matchesCurrent = REQUIRED_FALLBACKS.every((value) => content.includes(value)) && REQUIRED_COMPACT_LINES.every((line) => content.includes(line));
@@ -2149,7 +2154,7 @@ async function hasLeeSpecKitCodexBootstrap(filePath = getCodexConfigPath()) {
 async function upsertLeeSpecKitCodexBootstrap(filePath = getCodexConfigPath()) {
   const block = renderManagedBlock2();
   const segment = renderManagedSegment2();
-  await fs.ensureDir(path15.dirname(filePath));
+  await fs.ensureDir(path16.dirname(filePath));
   const exists = await fs.pathExists(filePath);
   if (!exists) {
     await fs.writeFile(filePath, block, "utf-8");
@@ -2283,37 +2288,24 @@ function validatePromptPathValue(value, lang) {
 function validatePromptUrlValue(value, lang) {
   return value.trim() ? true : tr(lang, "cli", "init.validation.enterUrl");
 }
-var DEFAULT_APPROVAL_REQUIRE_CHECK_CATEGORIES = [
-  "spec_approve",
-  "implementation_approve"
-];
-function createDefaultApprovalConfig() {
-  return {
-    mode: "category",
-    default: "skip",
-    requireCheckCategories: [...DEFAULT_APPROVAL_REQUIRE_CHECK_CATEGORIES]
-  };
-}
 function getAncestorDirs(startDir) {
   const dirs = [];
-  let current = path15.resolve(startDir);
+  let current = path16.resolve(startDir);
   while (true) {
     dirs.push(current);
-    const parent = path15.dirname(current);
+    const parent = path16.dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return dirs;
 }
 function hasWorkspaceBoundary(dir) {
-  return fs.existsSync(path15.join(dir, "package.json")) || fs.existsSync(path15.join(dir, ".git"));
+  return fs.existsSync(path16.join(dir, "package.json")) || fs.existsSync(path16.join(dir, ".git"));
 }
 function getSearchBaseDirs(cwd) {
   const ancestors = getAncestorDirs(cwd);
   const boundaryIndex = ancestors.findIndex(hasWorkspaceBoundary);
-  if (boundaryIndex === -1) {
-    return [ancestors[0]];
-  }
+  if (boundaryIndex === -1) return [ancestors[0]];
   return ancestors.slice(0, boundaryIndex + 1);
 }
 var FEATURE_FOLDER_PATTERN = /^F\d{3,}-/i;
@@ -2322,7 +2314,7 @@ function normalizeComponentKeys(value) {
   return Object.keys(value).map((key) => key.trim().toLowerCase()).filter(Boolean);
 }
 async function inferComponentsFromFeaturesDir(docsDir) {
-  const featuresPath = path15.join(docsDir, "features");
+  const featuresPath = path16.join(docsDir, "features");
   if (!await fs.pathExists(featuresPath)) return [];
   const entries = await fs.readdir(featuresPath, { withFileTypes: true });
   const inferred = entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name.trim().toLowerCase()).filter(
@@ -2330,24 +2322,42 @@ async function inferComponentsFromFeaturesDir(docsDir) {
   );
   return [...new Set(inferred)];
 }
-async function getConfig(cwd) {
+function toProjectConfig(docsDir, configFile, projectType, components) {
+  return {
+    schemaId: "lee-spec",
+    docsDir,
+    projectName: configFile.projectName,
+    projectType,
+    components: projectType === "multi" ? components : void 0,
+    lang: configFile.lang,
+    docsRepo: configFile.docsRepo,
+    pushDocs: configFile.pushDocs,
+    docsRemote: configFile.docsRemote,
+    projectRoot: configFile.projectRoot,
+    allowedDocsEntries: configFile.allowedDocsEntries,
+    pr: configFile.pr,
+    workflow: configFile.workflow,
+    approval: configFile.approval
+  };
+}
+async function detectLeeSpecProject(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
-    ...explicitDocsDir ? [path15.resolve(explicitDocsDir)] : [],
+    ...explicitDocsDir ? [path16.resolve(explicitDocsDir)] : [],
     ...getSearchBaseDirs(cwd)
   ];
   const visitedBaseDirs = /* @__PURE__ */ new Set();
   const visitedDocsDirs = /* @__PURE__ */ new Set();
   for (const baseDir of baseDirs) {
-    const resolvedBaseDir = path15.resolve(baseDir);
+    const resolvedBaseDir = path16.resolve(baseDir);
     if (visitedBaseDirs.has(resolvedBaseDir)) continue;
     visitedBaseDirs.add(resolvedBaseDir);
-    const possibleDocsDirs = [path15.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    const possibleDocsDirs = [path16.join(resolvedBaseDir, "docs"), resolvedBaseDir];
     for (const docsDir of possibleDocsDirs) {
-      const resolvedDocsDir = path15.resolve(docsDir);
+      const resolvedDocsDir = path16.resolve(docsDir);
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
-      const configPath = path15.join(resolvedDocsDir, ".lee-spec-kit.json");
+      const configPath = path16.join(resolvedDocsDir, ".lee-spec-kit.json");
       if (await fs.pathExists(configPath)) {
         try {
           const configFile = await fs.readJson(configPath);
@@ -2361,33 +2371,32 @@ async function getConfig(cwd) {
             Array.isArray(configFile.components) && configFile.components.length > 0 ? configFile.components : inferredComponents
           );
           return {
+            detected: true,
+            schemaId: "lee-spec",
+            detectionSource: "config",
             docsDir: resolvedDocsDir,
-            projectName: configFile.projectName,
-            projectType,
-            components: projectType === "multi" ? components : void 0,
-            lang: configFile.lang,
-            docsRepo: configFile.docsRepo,
-            pushDocs: configFile.pushDocs,
-            docsRemote: configFile.docsRemote,
-            projectRoot: configFile.projectRoot,
-            allowedDocsEntries: configFile.allowedDocsEntries,
-            pr: configFile.pr,
-            workflow: configFile.workflow,
-            approval: configFile.approval
+            configPath,
+            configFilePresent: true,
+            config: toProjectConfig(
+              resolvedDocsDir,
+              configFile,
+              projectType,
+              components
+            )
           };
         } catch {
         }
       }
-      const agentsPath = path15.join(resolvedDocsDir, "agents");
-      const featuresPath = path15.join(resolvedDocsDir, "features");
+      const agentsPath = path16.join(resolvedDocsDir, "agents");
+      const featuresPath = path16.join(resolvedDocsDir, "features");
       if (await fs.pathExists(agentsPath) && await fs.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 = [
-          path15.join(agentsPath, "custom.md"),
-          path15.join(agentsPath, "constitution.md"),
-          path15.join(agentsPath, "agents.md")
+          path16.join(agentsPath, "custom.md"),
+          path16.join(agentsPath, "constitution.md"),
+          path16.join(agentsPath, "agents.md")
         ];
         let lang = "en";
         for (const candidate of langProbeCandidates) {
@@ -2398,11 +2407,198 @@ async function getConfig(cwd) {
             break;
           }
         }
-        return { docsDir: resolvedDocsDir, projectType, components, lang };
+        return {
+          detected: true,
+          schemaId: "lee-spec",
+          detectionSource: "heuristic",
+          docsDir: resolvedDocsDir,
+          configPath: null,
+          configFilePresent: false,
+          config: {
+            schemaId: "lee-spec",
+            docsDir: resolvedDocsDir,
+            projectType,
+            components,
+            lang
+          }
+        };
       }
     }
   }
-  return null;
+  return {
+    detected: false,
+    schemaId: "lee-spec",
+    detectionSource: null,
+    docsDir: null,
+    configPath: null,
+    configFilePresent: false,
+    config: null
+  };
+}
+function resolveLeeSpecFeaturePaths(input) {
+  const featureFolderName = `${input.featureId}-${input.featureName}`;
+  const featuresDir = input.projectType === "multi" ? path16.join(input.docsDir, "features", input.component || "") : path16.join(input.docsDir, "features");
+  const featureDir = path16.join(featuresDir, featureFolderName);
+  return {
+    featureFolderName,
+    featuresDir,
+    featureDir,
+    featurePathFromDocs: path16.relative(input.docsDir, featureDir)
+  };
+}
+async function getNextLeeSpecFeatureId(docsDir, projectType, components) {
+  const featuresDir = path16.join(docsDir, "features");
+  let max = 0;
+  const scanDirs = [];
+  if (projectType === "multi") {
+    scanDirs.push(
+      ...components.map((component) => path16.join(featuresDir, component))
+    );
+  } else {
+    scanDirs.push(featuresDir);
+  }
+  for (const dir of scanDirs) {
+    if (!await fs.pathExists(dir)) continue;
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const match = entry.name.match(/^F(\d+)-/);
+      if (!match) continue;
+      const num = parseInt(match[1], 10);
+      if (num > max) max = num;
+    }
+  }
+  const next = max + 1;
+  const width = Math.max(3, String(next).length);
+  return `F${String(next).padStart(width, "0")}`;
+}
+function parseFeatureFolderName(folderName, component) {
+  const match = folderName.match(/^(F\d+)-(.+)$/);
+  if (!match) return null;
+  const featureRef = {
+    id: match[1],
+    slug: match[2],
+    folderName
+  };
+  if (component) {
+    featureRef.component = component;
+  }
+  return featureRef;
+}
+async function listLeeSpecFeatures(cwd) {
+  const detected = await detectLeeSpecProject(cwd);
+  const docsDir = detected.docsDir;
+  if (!docsDir) return [];
+  const featuresRoot = path16.join(docsDir, "features");
+  if (!await fs.pathExists(featuresRoot)) return [];
+  const refs = [];
+  const topLevelEntries = await fs.readdir(featuresRoot, { withFileTypes: true });
+  for (const entry of topLevelEntries) {
+    if (!entry.isDirectory()) continue;
+    const singleProjectFeature = parseFeatureFolderName(entry.name);
+    if (singleProjectFeature) {
+      refs.push(singleProjectFeature);
+      continue;
+    }
+    const component = entry.name.trim().toLowerCase();
+    if (!component) continue;
+    const componentDir = path16.join(featuresRoot, entry.name);
+    const componentEntries = await fs.readdir(componentDir, { withFileTypes: true });
+    for (const child of componentEntries) {
+      if (!child.isDirectory()) continue;
+      const featureRef = parseFeatureFolderName(child.name, component);
+      if (featureRef) refs.push(featureRef);
+    }
+  }
+  refs.sort((left, right) => {
+    const leftKey = `${left.id || ""}:${left.component || ""}:${left.folderName}`;
+    const rightKey = `${right.id || ""}:${right.component || ""}:${right.folderName}`;
+    return leftKey.localeCompare(rightKey);
+  });
+  return refs;
+}
+
+// src/adapters/schema/lee-spec-kit/index.ts
+var leeSpecSchemaAdapter = {
+  schemaId: "lee-spec",
+  async detect(cwd) {
+    const detection = await detectLeeSpecProject(cwd);
+    return {
+      detected: detection.detected,
+      docsDir: detection.docsDir,
+      schemaId: detection.schemaId,
+      detectionSource: detection.detectionSource,
+      config: detection.config,
+      configPath: detection.configPath,
+      configFilePresent: detection.configFilePresent
+    };
+  },
+  async listFeatures(cwd) {
+    return listLeeSpecFeatures(cwd);
+  },
+  async getNextFeatureId(input) {
+    return getNextLeeSpecFeatureId(
+      input.docsDir,
+      input.projectType,
+      input.components
+    );
+  },
+  resolveFeaturePaths(input) {
+    return resolveLeeSpecFeaturePaths(input);
+  }
+};
+
+// src/adapters/schema/index.ts
+var SCHEMA_ADAPTERS = [leeSpecSchemaAdapter];
+function createEmptyDetection() {
+  return {
+    detected: false,
+    docsDir: null,
+    schemaId: null,
+    detectionSource: null,
+    config: null,
+    configPath: null,
+    configFilePresent: false,
+    adapter: null
+  };
+}
+function getSchemaAdapterById(schemaId) {
+  if (!schemaId) return null;
+  return SCHEMA_ADAPTERS.find((adapter) => adapter.schemaId === schemaId) ?? null;
+}
+function getSchemaAdapterForConfig(config) {
+  return getSchemaAdapterById(config?.schemaId ?? null);
+}
+async function detectSchemaProject(cwd) {
+  for (const adapter of SCHEMA_ADAPTERS) {
+    const detection = await adapter.detect(cwd);
+    if (detection.detected) {
+      return {
+        ...detection,
+        adapter
+      };
+    }
+  }
+  return createEmptyDetection();
+}
+
+// src/config/load.ts
+async function getConfig(cwd) {
+  const detected = await detectSchemaProject(cwd);
+  return detected.config;
+}
+
+// src/config/types.ts
+var DEFAULT_APPROVAL_REQUIRE_CHECK_CATEGORIES = [
+  "spec_approve",
+  "implementation_approve"
+];
+function createDefaultApprovalConfig() {
+  return {
+    mode: "category",
+    default: "skip",
+    requireCheckCategories: [...DEFAULT_APPROVAL_REQUIRE_CHECK_CATEGORIES]
+  };
 }
 
 // src/commands/init.ts
@@ -2468,7 +2664,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path15.basename(cwd);
+  const defaultName = path16.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let components = parseComponentsOption(options.components);
@@ -2479,7 +2675,7 @@ async function runInit(options) {
   let docsRemote = options.docsRemote;
   let projectRoot;
   const componentProjectRoots = options.componentProjectRoots ? parseComponentProjectRootsOption(options.componentProjectRoots) : {};
-  const targetDir = path15.resolve(cwd, options.dir || "./docs");
+  const targetDir = path16.resolve(cwd, options.dir || "./docs");
   const skipPrompts = !!options.yes || !!options.nonInteractive;
   if (options.docsRepo && !["embedded", "standalone"].includes(options.docsRepo)) {
     throw createCliError(
@@ -2876,7 +3072,7 @@ async function runInit(options) {
       );
       console.log();
       const templatesDir = getTemplatesDir();
-      const commonPath = path15.join(templatesDir, lang, "common");
+      const commonPath = path16.join(templatesDir, lang, "common");
       if (!await fs.pathExists(commonPath)) {
         throw new Error(
           tr(lang, "cli", "init.error.templateNotFound", { path: commonPath })
@@ -2885,11 +3081,11 @@ async function runInit(options) {
       const fsAdapter = new DefaultFileSystemAdapter();
       await copyTemplates(fsAdapter, commonPath, targetDir);
       if (projectType === "multi") {
-        const featuresRoot = path15.join(targetDir, "features");
+        const featuresRoot = path16.join(targetDir, "features");
         for (const component of components) {
-          const componentDir = path15.join(featuresRoot, component);
+          const componentDir = path16.join(featuresRoot, component);
           await fs.ensureDir(componentDir);
-          const readmePath = path15.join(componentDir, "README.md");
+          const readmePath = path16.join(componentDir, "README.md");
           if (!await fs.pathExists(readmePath)) {
             await fs.writeFile(
               readmePath,
@@ -2916,6 +3112,7 @@ async function runInit(options) {
         createdAt: getLocalDateString(),
         docsRepo,
         workflow: {
+          preset: workflowMode,
           mode: workflowMode,
           requireWorktree: false,
           codeDirtyScope: "auto",
@@ -2948,20 +3145,20 @@ async function runInit(options) {
           config.projectRoot = projectRoot;
         }
       }
-      const configPath = path15.join(targetDir, ".lee-spec-kit.json");
+      const configPath = path16.join(targetDir, ".lee-spec-kit.json");
       await fs.writeJson(configPath, config, { spaces: 2 });
       const extraCommitPathsAbs = [];
       try {
         if (docsRepo === "embedded") {
           const repoRoot = getGitTopLevelOrNull(cwd) || cwd;
-          const agentsMdPath = path15.join(repoRoot, "AGENTS.md");
+          const agentsMdPath = path16.join(repoRoot, "AGENTS.md");
           const result = await upsertLeeSpecKitAgentsMd(agentsMdPath, {
             lang,
             docsRepo
           });
           if (result.changed) extraCommitPathsAbs.push(agentsMdPath);
         } else {
-          await upsertLeeSpecKitAgentsMd(path15.join(targetDir, "AGENTS.md"), {
+          await upsertLeeSpecKitAgentsMd(path16.join(targetDir, "AGENTS.md"), {
             lang,
             docsRepo
           });
@@ -2971,16 +3168,16 @@ async function runInit(options) {
           } else if (projectRoot && typeof projectRoot === "object") {
             roots.push(...Object.values(projectRoot));
           }
-          const resolvedCwd = path15.resolve(cwd);
+          const resolvedCwd = path16.resolve(cwd);
           for (const raw of roots) {
             const value = String(raw || "").trim();
             if (!value) continue;
-            const abs = path15.resolve(cwd, value);
-            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path15.sep}`)) {
+            const abs = path16.resolve(cwd, value);
+            if (abs === resolvedCwd || abs.startsWith(`${resolvedCwd}${path16.sep}`)) {
               if (await fs.pathExists(abs)) {
                 const stat = await fs.stat(abs);
                 if (stat.isDirectory()) {
-                  await upsertLeeSpecKitAgentsMd(path15.join(abs, "AGENTS.md"), {
+                  await upsertLeeSpecKitAgentsMd(path16.join(abs, "AGENTS.md"), {
                     lang,
                     docsRepo
                   });
@@ -3073,7 +3270,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       console.log(chalk9.blue(tr(lang, "cli", "init.log.gitInit")));
       runGitOrThrow(["init"], gitWorkdir);
     }
-    const relativePath = docsRepo === "standalone" ? "." : path15.relative(gitWorkdir, targetDir);
+    const relativePath = docsRepo === "standalone" ? "." : path16.relative(gitWorkdir, targetDir);
     const stagedBeforeAdd = getCachedStagedFiles(gitWorkdir);
     if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
       console.log(chalk9.yellow(tr(lang, "cli", "init.warn.stagedChangesSkip")));
@@ -3100,7 +3297,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote, ext
       console.log();
       return;
     }
-    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path15.relative(gitWorkdir, absPath)).map((p) => p.replace(/\\/g, "/").trim()).filter((p) => !!p && p !== "." && !p.startsWith("../"));
+    const extraRelativePaths = extraCommitPathsAbs.map((absPath) => path16.relative(gitWorkdir, absPath)).map((p) => p.replace(/\\/g, "/").trim()).filter((p) => !!p && p !== "." && !p.startsWith("../"));
     const pathsToStage = [relativePath, ...extraRelativePaths];
     for (const p of pathsToStage) {
       runGitOrThrow(["add", p], gitWorkdir);
@@ -3188,13 +3385,13 @@ async function patchMarkdownIfExists(filePath, transform) {
   await fs.writeFile(filePath, transform(content), "utf-8");
 }
 async function applyLocalWorkflowTemplateToFeatureDir(featureDir, lang) {
-  await patchMarkdownIfExists(path15.join(featureDir, "spec.md"), sanitizeSpecForLocal);
+  await patchMarkdownIfExists(path16.join(featureDir, "spec.md"), sanitizeSpecForLocal);
   await patchMarkdownIfExists(
-    path15.join(featureDir, "tasks.md"),
+    path16.join(featureDir, "tasks.md"),
     (content) => sanitizeTasksForLocal(content, lang)
   );
-  await fs.remove(path15.join(featureDir, "issue.md"));
-  await fs.remove(path15.join(featureDir, "pr.md"));
+  await fs.remove(path16.join(featureDir, "issue.md"));
+  await fs.remove(path16.join(featureDir, "pr.md"));
 }
 var IDEA_REF_PATTERN = /\b(I\d{3,}(?:-[A-Za-z0-9._-]+)?)\b/;
 var IDEA_PATH_PATTERN = /\b(?:\.\/)?docs\/ideas\/[^\s]+\.md\b/;
@@ -3206,7 +3403,7 @@ function extractExplicitIdeaRef(requestText) {
   return null;
 }
 async function resolveIdeaReference(docsDir, ref, lang) {
-  const ideasDir = path15.join(docsDir, "ideas");
+  const ideasDir = path16.join(docsDir, "ideas");
   const trimmedRef = ref.trim();
   if (!trimmedRef) {
     throw createCliError(
@@ -3215,7 +3412,7 @@ async function resolveIdeaReference(docsDir, ref, lang) {
     );
   }
   if (trimmedRef.includes("/") || trimmedRef.endsWith(".md")) {
-    const candidate = path15.resolve(process.cwd(), trimmedRef);
+    const candidate = path16.resolve(process.cwd(), trimmedRef);
     if (await fs.pathExists(candidate)) {
       return { path: candidate };
     }
@@ -3234,11 +3431,11 @@ async function resolveIdeaReference(docsDir, ref, lang) {
   const files = entries.filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith(".md")).map((entry) => entry.name);
   const exactName = `${trimmedRef}.md`;
   if (files.includes(exactName)) {
-    return { path: path15.join(ideasDir, exactName) };
+    return { path: path16.join(ideasDir, exactName) };
   }
   const byId = /^I\d{3,}$/.test(trimmedRef) ? files.filter((name) => name.startsWith(`${trimmedRef}-`)) : [];
   if (byId.length === 1) {
-    return { path: path15.join(ideasDir, byId[0]) };
+    return { path: path16.join(ideasDir, byId[0]) };
   }
   if (byId.length > 1) {
     throw createCliError(
@@ -3262,7 +3459,7 @@ async function readIdeaMetadataValue(ideaPath, label) {
 async function deriveFeatureNameFromIdea(ideaPath) {
   const ideaName = await readIdeaMetadataValue(ideaPath, "Idea Name");
   if (ideaName && ideaName !== "-") return ideaName;
-  const basename = path15.basename(ideaPath, ".md");
+  const basename = path16.basename(ideaPath, ".md");
   return basename.replace(/^I\d{3,}-/, "");
 }
 function escapeRegExp(value) {
@@ -3348,6 +3545,7 @@ async function runFeature(name, options) {
   }
   const { docsDir, projectType, lang } = config;
   const projectName = config.projectName;
+  const schemaAdapter = getSchemaAdapterForConfig(config);
   const configuredComponents = resolveProjectComponents(
     projectType,
     config.components
@@ -3410,27 +3608,38 @@ async function runFeature(name, options) {
         );
         featureId = options.id;
       } else {
-        featureId = await getNextFeatureId(
+        if (!schemaAdapter?.getNextFeatureId) {
+          throw createCliError(
+            "PRECONDITION_FAILED",
+            `Schema "${config.schemaId || "unknown"}" does not support feature ID allocation.`
+          );
+        }
+        featureId = await schemaAdapter.getNextFeatureId({
           docsDir,
           projectType,
-          configuredComponents
-        );
+          components: configuredComponents
+        });
       }
-      let featuresDir;
-      if (projectType === "multi") {
-        featuresDir = path15.join(docsDir, "features", component);
-      } else {
-        featuresDir = path15.join(docsDir, "features");
+      if (!schemaAdapter?.resolveFeaturePaths) {
+        throw createCliError(
+          "PRECONDITION_FAILED",
+          `Schema "${config.schemaId || "unknown"}" does not support feature path resolution.`
+        );
       }
-      const featureFolderName = `${featureId}-${name}`;
-      const featureDir = path15.join(featuresDir, featureFolderName);
+      const { featureFolderName, featureDir, featurePathFromDocs } = schemaAdapter.resolveFeaturePaths({
+        docsDir,
+        projectType,
+        component: projectType === "multi" ? component : void 0,
+        featureId,
+        featureName: name
+      });
       if (await fs.pathExists(featureDir)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "feature.folderExists", { path: featureDir })
         );
       }
-      const featureBasePath = path15.join(
+      const featureBasePath = path16.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -3477,8 +3686,8 @@ async function runFeature(name, options) {
       await replaceInFiles(fsAdapter, featureDir, replacements);
       if (linkedIdea) {
         await stampIdeaReferenceInSpec(
-          path15.join(featureDir, "spec.md"),
-          path15.relative(featureDir, linkedIdea.path)
+          path16.join(featureDir, "spec.md"),
+          path16.relative(featureDir, linkedIdea.path)
         );
         await markIdeaAsFeatureized(linkedIdea.path, featureFolderName);
       }
@@ -3506,7 +3715,7 @@ async function runFeature(name, options) {
         featureName: name,
         component: projectType === "multi" ? component : void 0,
         featurePath: featureDir,
-        featurePathFromDocs: path15.relative(docsDir, featureDir)
+        featurePathFromDocs
       };
     },
     { owner: "feature" }
@@ -3566,9 +3775,9 @@ function escapeRegExp2(value) {
 async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const candidates = [
-    ...explicitDocsDir ? [path15.resolve(explicitDocsDir)] : [],
-    path15.resolve(cwd, "docs"),
-    path15.resolve(cwd)
+    ...explicitDocsDir ? [path16.resolve(explicitDocsDir)] : [],
+    path16.resolve(cwd, "docs"),
+    path16.resolve(cwd)
   ];
   const endAt = Date.now() + timeoutMs;
   while (Date.now() < endAt) {
@@ -3594,33 +3803,6 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   }
   return getConfig(cwd);
 }
-async function getNextFeatureId(docsDir, projectType, components) {
-  const featuresDir = path15.join(docsDir, "features");
-  let max = 0;
-  const scanDirs = [];
-  if (projectType === "multi") {
-    scanDirs.push(
-      ...components.map((component) => path15.join(featuresDir, component))
-    );
-  } else {
-    scanDirs.push(featuresDir);
-  }
-  for (const dir of scanDirs) {
-    if (!await fs.pathExists(dir)) continue;
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const match = entry.name.match(/^F(\d+)-/);
-      if (match) {
-        const num = parseInt(match[1], 10);
-        if (num > max) max = num;
-      }
-    }
-  }
-  const next = max + 1;
-  const width = Math.max(3, String(next).length);
-  return `F${String(next).padStart(width, "0")}`;
-}
 function ideaCommand(program2) {
   program2.command("idea <name>").description("Create a new indexed idea document").option("--component <component>", "Component name (optional)").option("--id <id>", "Idea ID (default: auto)").option("-d, --desc <description>", "Idea description for the document").option("--non-interactive", "Reserved for parity with other generators").option("--json", "Output in JSON format for agents").action(async (name, options) => {
     try {
@@ -3701,16 +3883,16 @@ async function runIdea(name, options) {
     getDocsLockPath(docsDir),
     async () => {
       const ideaId = options.id ? validateProvidedIdeaId(options.id, lang) : await getNextIdeaId(docsDir);
-      const ideasDir = path15.join(docsDir, "ideas");
+      const ideasDir = path16.join(docsDir, "ideas");
       const ideaFileName = `${ideaId}-${name}.md`;
-      const ideaPath = path15.join(ideasDir, ideaFileName);
+      const ideaPath = path16.join(ideasDir, ideaFileName);
       if (await fs.pathExists(ideaPath)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "idea.fileExists", { path: ideaPath })
         );
       }
-      const templatePath = path15.join(
+      const templatePath = path16.join(
         getTemplatesDir(),
         lang,
         "common",
@@ -3748,7 +3930,7 @@ async function runIdea(name, options) {
         ideaName: name,
         component: component || void 0,
         ideaPath,
-        ideaPathFromDocs: path15.relative(docsDir, ideaPath)
+        ideaPathFromDocs: path16.relative(docsDir, ideaPath)
       };
     },
     { owner: "idea" }
@@ -3766,7 +3948,7 @@ function applyIdeaTemplate(template, values) {
   return template.replaceAll("{idea-id}", values.ideaId).replaceAll("{idea-name}", values.name).replaceAll("{YYYY-MM-DD}", values.created).replaceAll("{{description}}", values.description).replaceAll("{component}", values.component);
 }
 async function getNextIdeaId(docsDir) {
-  const ideasDir = path15.join(docsDir, "ideas");
+  const ideasDir = path16.join(docsDir, "ideas");
   let max = 0;
   if (await fs.pathExists(ideasDir)) {
     const entries = await fs.readdir(ideasDir, { withFileTypes: true });
@@ -3895,25 +4077,33 @@ var SUBAGENT_HANDOFF_CATEGORIES = [
   "pre_pr_review_run"
 ];
 
-// src/utils/workflow.ts
-var DEFAULT_PRE_PR_REVIEW_SKILLS = ["code-review-excellence"];
-var DEFAULT_PRE_PR_DECISION_ENUM = [
-  "approve",
-  "changes_requested",
-  "blocked"
-];
-function resolveWorkflowPolicy(workflow) {
-  const mode = workflow?.mode === "local" ? "local" : "github";
-  const policy = mode === "local" ? {
-    mode,
-    requireIssue: false,
-    requireBranch: false,
-    requireWorktree: false,
-    requirePr: false,
-    requireReview: false,
-    requireMerge: false
-  } : {
-    mode,
+// src/core/workflow/presets.ts
+function resolveWorkflowPreset(preset, mode) {
+  const normalizedPreset = preset === "local" || preset === "strict" || preset === "github" ? preset : void 0;
+  if (normalizedPreset === "local" || mode === "local") {
+    return {
+      mode: "local",
+      requireIssue: false,
+      requireBranch: false,
+      requireWorktree: false,
+      requirePr: false,
+      requireReview: false,
+      requireMerge: false
+    };
+  }
+  if (normalizedPreset === "strict") {
+    return {
+      mode: "github",
+      requireIssue: true,
+      requireBranch: true,
+      requireWorktree: true,
+      requirePr: true,
+      requireReview: true,
+      requireMerge: true
+    };
+  }
+  return {
+    mode: "github",
     requireIssue: true,
     requireBranch: true,
     requireWorktree: false,
@@ -3921,6 +4111,20 @@ function resolveWorkflowPolicy(workflow) {
     requireReview: true,
     requireMerge: true
   };
+}
+
+// src/core/workflow/policies.ts
+var DEFAULT_PRE_PR_REVIEW_SKILLS = ["code-review-excellence"];
+var DEFAULT_PRE_PR_DECISION_ENUM = [
+  "approve",
+  "changes_requested",
+  "blocked"
+];
+function resolveWorkflowPolicy(workflow) {
+  const policy = resolveWorkflowPreset(
+    workflow?.preset,
+    workflow?.mode
+  );
   if (typeof workflow?.requireIssue === "boolean") {
     policy.requireIssue = workflow.requireIssue;
   }
@@ -3986,18 +4190,9 @@ function normalizeDecisionEnumList(input) {
   for (const raw of input) {
     const value = String(raw || "").trim().toLowerCase();
     if (!value) continue;
-    if (value === "approve") {
-      deduped.add("approve");
-      continue;
-    }
-    if (value === "changes_requested") {
-      deduped.add("changes_requested");
-      continue;
-    }
-    if (value === "blocked") {
-      deduped.add("blocked");
-      continue;
-    }
+    if (value === "approve") deduped.add("approve");
+    if (value === "changes_requested") deduped.add("changes_requested");
+    if (value === "blocked") deduped.add("blocked");
   }
   return [...deduped];
 }
@@ -4034,6 +4229,15 @@ function resolvePrePrReviewPolicy(workflow) {
   };
 }
 
+// src/core/workflow/engine.ts
+function resolveWorkflowRuntime(workflow) {
+  return {
+    workflowPolicy: resolveWorkflowPolicy(workflow),
+    prePrReviewPolicy: resolvePrePrReviewPolicy(workflow),
+    taskCommitGatePolicy: resolveTaskCommitGatePolicy(workflow)
+  };
+}
+
 // src/utils/agent-orchestration.ts
 function getPrePrReviewPrompt(lang, skills, fallbackText) {
   if (lang === "ko") {
@@ -4083,6 +4287,9 @@ function isCompletionChecklistDone(feature) {
 function isTasksDocApproved(feature) {
   return !feature.docs.tasksDocStatusFieldExists || feature.tasksDocStatus === "Approved";
 }
+function hasPendingChangeRequest(feature) {
+  return typeof feature.pendingChangeRequest === "string" && feature.pendingChangeRequest.trim().length > 0;
+}
 function isImplementationDone(feature) {
   return feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isTasksDocApproved(feature);
 }
@@ -4207,7 +4414,7 @@ function isNonNegativeIntegerValue(value) {
 }
 function isLikelyCurrentPrePrReviewEvidence(evidencePath, feature) {
   try {
-    const raw = fs12.readFileSync(evidencePath, "utf-8");
+    const raw = fs13.readFileSync(evidencePath, "utf-8");
     const parsed = JSON.parse(raw);
     const evidenceFeature = (parsed.feature || "").toString().trim();
     if (evidenceFeature && evidenceFeature !== feature.folderName) {
@@ -4223,31 +4430,31 @@ function resolvePrePrReviewEvidencePath(feature) {
   const candidates = [];
   const explicit = (feature.prePrReview.evidence || "").trim();
   if (explicit && explicit !== "-") {
-    if (path15.isAbsolute(explicit)) {
+    if (path16.isAbsolute(explicit)) {
       candidates.push(explicit);
     } else {
-      candidates.push(path15.resolve(feature.path, explicit));
-      candidates.push(path15.resolve(docsRoot, explicit));
+      candidates.push(path16.resolve(feature.path, explicit));
+      candidates.push(path16.resolve(docsRoot, explicit));
       const normalizedExplicit = explicit.replace(/\\/g, "/");
       if (normalizedExplicit.startsWith("docs/")) {
         const withoutDocsPrefix = normalizedExplicit.slice("docs/".length);
         if (withoutDocsPrefix) {
-          candidates.push(path15.resolve(docsRoot, withoutDocsPrefix));
+          candidates.push(path16.resolve(docsRoot, withoutDocsPrefix));
         }
       }
     }
   }
-  candidates.push(path15.join(feature.path, "review-trace.json"));
-  candidates.push(path15.join(docsRoot, "review-trace.json"));
+  candidates.push(path16.join(feature.path, "review-trace.json"));
+  candidates.push(path16.join(docsRoot, "review-trace.json"));
   const seen = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
-    const abs = path15.resolve(candidate);
+    const abs = path16.resolve(candidate);
     if (seen.has(abs)) continue;
     seen.add(abs);
-    if (!fs12.existsSync(abs)) continue;
+    if (!fs13.existsSync(abs)) continue;
     if (!abs.toLowerCase().endsWith(".json")) continue;
     if (!isLikelyCurrentPrePrReviewEvidence(abs, feature)) continue;
-    const rel = path15.relative(docsRoot, abs).replace(/\\/g, "/");
+    const rel = path16.relative(docsRoot, abs).replace(/\\/g, "/");
     if (rel && !rel.startsWith("../")) {
       return rel;
     }
@@ -4288,8 +4495,8 @@ function getReviewFixCommitGuidance(feature, lang, options) {
 }
 function resolveManagedWorktreeCleanupPaths(projectGitCwd) {
   if (!projectGitCwd) return null;
-  const normalized = path15.resolve(projectGitCwd);
-  const marker = `${path15.sep}.worktrees${path15.sep}`;
+  const normalized = path16.resolve(projectGitCwd);
+  const marker = `${path16.sep}.worktrees${path16.sep}`;
   const markerIndex = normalized.lastIndexOf(marker);
   if (markerIndex <= 0) return null;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -4336,7 +4543,7 @@ function toTaskKey(rawTitle) {
 function countDoneTransitionsInLatestTasksCommit(ctx, feature) {
   const docsGitCwd = feature.git.docsGitCwd;
   const tasksRelativePath = normalizeGitRelativePath(
-    path15.join(feature.docs.featurePathFromDocs, "tasks.md")
+    path16.join(feature.docs.featurePathFromDocs, "tasks.md")
   );
   const diff = readGitText(ctx, docsGitCwd, [
     "diff",
@@ -4411,7 +4618,7 @@ function checkTaskCommitGate(ctx, feature) {
     return { pass: true };
   }
   const args = ["log", "-n", "1", "--pretty=%s", "--", "."];
-  const relativeDocsDir = path15.relative(projectGitCwd, feature.git.docsGitCwd);
+  const relativeDocsDir = path16.relative(projectGitCwd, feature.git.docsGitCwd);
   const normalizedDocsDir = normalizeGitRelativePath(relativeDocsDir);
   if (normalizedDocsDir && normalizedDocsDir !== "." && normalizedDocsDir !== ".." && !normalizedDocsDir.startsWith("../")) {
     args.push(`:(exclude)${normalizedDocsDir}/**`);
@@ -4448,11 +4655,23 @@ function getTaskCommitGateReasonText(lang, check) {
 }
 function getStepDefinitions(ctx) {
   const lang = ctx.config.lang;
-  const workflow = ctx.config.workflow;
-  const workflowPolicy = resolveWorkflowPolicy(workflow);
-  const prePrReviewPolicy = resolvePrePrReviewPolicy(workflow);
-  const taskCommitGatePolicy = resolveTaskCommitGatePolicy(workflow);
-  const isTaskExecuteCurrent = (f) => f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && isTasksDocApproved(f) && (!workflowPolicy.requireBranch || f.git.onExpectedBranch || f.tasks.done === f.tasks.total);
+  const {
+    workflowPolicy,
+    prePrReviewPolicy,
+    taskCommitGatePolicy
+  } = resolveWorkflowRuntime(ctx.config.workflow);
+  const isTaskExecuteCurrent = (f) => f.docs.tasksExists && f.tasks.total > 0 && (hasPendingChangeRequest(f) || f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && isTasksDocApproved(f) && (!workflowPolicy.requireBranch || f.git.onExpectedBranch || f.tasks.done === f.tasks.total);
+  const getChangeRequestSyncActions = (f) => [
+    {
+      type: "instruction",
+      category: "tasks_write",
+      requiresUserCheck: false,
+      uiDetailKey: "context.actionDetail.tasksWriteChangeSync",
+      message: tr(lang, "messages", "changeRequestSync", {
+        request: f.pendingChangeRequest || "-"
+      })
+    }
+  ];
   const isTaskExecuteWorktreeBlocked = (f) => isTaskExecuteCurrent(f) && workflowPolicy.requireWorktree && f.tasks.done < f.tasks.total && !!f.issueNumber && !f.git.projectInManagedWorktree;
   const isTaskExecuteFinalize = (f) => isTaskExecuteCurrent(f) && f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f);
   const isTaskExecuteCommitPending = (f) => isTaskExecuteCurrent(f) && (isTaskExecuteFinalize(f) && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges) || !!f.nextTodoTask && (f.git.docsHasCommitRequiredChanges || f.git.projectHasUncommittedChanges));
@@ -5253,6 +5472,14 @@ ${tr(lang, "messages", "prePrReviewDecisionReconfirm", {
         detail: (f) => f.tasks.total > 0 ? `(${f.tasks.done}/${f.tasks.total})` : ""
       },
       substates: [
+        {
+          id: "change_request_sync",
+          phase: "ready",
+          owner: "main",
+          category: "tasks_write",
+          when: (f) => isTaskExecuteCurrent(f) && hasPendingChangeRequest(f),
+          actions: (f) => getChangeRequestSyncActions(f)
+        },
         {
           id: "task_blocked",
           phase: "blocked",
@@ -6006,17 +6233,17 @@ function isGitPathIgnored(ctx, cwd, relativePath) {
   }
 }
 var GIT_WORKTREE_CACHE = /* @__PURE__ */ new Map();
-var WORKTREE_MARKER = `${path15.sep}.worktrees${path15.sep}`;
+var WORKTREE_MARKER = `${path16.sep}.worktrees${path16.sep}`;
 function resetContextGitCaches() {
   GIT_WORKTREE_CACHE.clear();
 }
 function isManagedWorktreePath(cwd) {
   if (!cwd) return false;
-  const normalized = path15.resolve(cwd);
+  const normalized = path16.resolve(cwd);
   return normalized.includes(WORKTREE_MARKER);
 }
 function resolveProjectRootFromGitCwd(cwd) {
-  const normalized = path15.resolve(cwd);
+  const normalized = path16.resolve(cwd);
   const markerIndex = normalized.lastIndexOf(WORKTREE_MARKER);
   if (markerIndex <= 0) return normalized;
   const projectRoot = normalized.slice(0, markerIndex);
@@ -6035,7 +6262,7 @@ function getGitTopLevel(ctx, cwd) {
 }
 function listGitWorktrees(ctx, cwd) {
   const topLevel = getGitTopLevel(ctx, cwd) || cwd;
-  const cacheKey = path15.resolve(topLevel);
+  const cacheKey = path16.resolve(topLevel);
   const cached = GIT_WORKTREE_CACHE.get(cacheKey);
   if (cached) return cached;
   try {
@@ -6164,6 +6391,15 @@ function extractFirstSpecValue(content, keys) {
   }
   return void 0;
 }
+function parsePendingChangeRequest(value) {
+  if (!value) return void 0;
+  const normalized = value.trim().replace(/\s+/g, " ");
+  if (!normalized) return void 0;
+  if (/^(?:-|#|none|n\/a|na|없음|미정)$/i.test(normalized)) {
+    return void 0;
+  }
+  return normalized;
+}
 function parseDocStatus(value) {
   if (!value) return void 0;
   const trimmed = value.trim();
@@ -6523,17 +6759,17 @@ function resolveLocalEvidencePathCandidates(rawValue, context) {
   if (!evidencePath) return [];
   if (/^https?:\/\//i.test(evidencePath)) return [];
   const candidates = /* @__PURE__ */ new Set();
-  if (path15.isAbsolute(evidencePath)) {
-    candidates.add(path15.resolve(evidencePath));
+  if (path16.isAbsolute(evidencePath)) {
+    candidates.add(path16.resolve(evidencePath));
   } else {
-    candidates.add(path15.resolve(context.featurePath, evidencePath));
-    candidates.add(path15.resolve(context.docsDir, evidencePath));
-    candidates.add(path15.resolve(path15.dirname(context.docsDir), evidencePath));
+    candidates.add(path16.resolve(context.featurePath, evidencePath));
+    candidates.add(path16.resolve(context.docsDir, evidencePath));
+    candidates.add(path16.resolve(path16.dirname(context.docsDir), evidencePath));
     const normalizedEvidencePath = evidencePath.replace(/\\/g, "/");
     if (normalizedEvidencePath.startsWith("docs/")) {
       const withoutDocsPrefix = normalizedEvidencePath.slice("docs/".length);
       if (withoutDocsPrefix) {
-        candidates.add(path15.resolve(context.docsDir, withoutDocsPrefix));
+        candidates.add(path16.resolve(context.docsDir, withoutDocsPrefix));
       }
     }
   }
@@ -6595,13 +6831,13 @@ function parsePrLink(value) {
   return trimmed;
 }
 function normalizeGitPath(value) {
-  return value.split(path15.sep).join("/");
+  return value.split(path16.sep).join("/");
 }
 function resolveProjectStatusPaths(projectGitCwd, docsDir) {
-  const relativeDocsDir = path15.relative(projectGitCwd, docsDir);
+  const relativeDocsDir = path16.relative(projectGitCwd, docsDir);
   if (!relativeDocsDir) return [];
-  if (path15.isAbsolute(relativeDocsDir)) return [];
-  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path15.sep}`)) {
+  if (path16.isAbsolute(relativeDocsDir)) return [];
+  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path16.sep}`)) {
     return [];
   }
   const normalizedDocsDir = normalizeGitPath(relativeDocsDir).replace(
@@ -6639,7 +6875,7 @@ function getExpectedWorktreeCandidates(projectGitCwd, issueNumber, slug, folderN
   const seen = /* @__PURE__ */ new Set();
   const out = [];
   for (const name of names) {
-    const candidate = path15.resolve(projectRoot, ".worktrees", name);
+    const candidate = path16.resolve(projectRoot, ".worktrees", name);
     if (seen.has(candidate)) continue;
     seen.add(candidate);
     out.push(candidate);
@@ -6653,7 +6889,7 @@ function resolveExistingExpectedWorktreePath(projectGitCwd, issueNumber, slug, f
     slug,
     folderName
   )) {
-    if (!fs12.existsSync(candidate)) continue;
+    if (!fs13.existsSync(candidate)) continue;
     return candidate;
   }
   return void 0;
@@ -6683,7 +6919,7 @@ function resolveFeatureWorktreePath(ctx, projectGitCwd, issueNumber, slug, folde
     slug,
     folderName
   )) {
-    if (!fs12.existsSync(candidate)) continue;
+    if (!fs13.existsSync(candidate)) continue;
     const branchName = getCurrentBranch(ctx, candidate);
     if (!expectedBranchesSet.has(branchName)) continue;
     return {
@@ -6824,10 +7060,10 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   const normalizedCandidates = uniqueNormalizedPaths(
     candidates.map((candidate) => {
       if (!candidate) return "";
-      if (!path15.isAbsolute(candidate)) return candidate;
-      const relative = path15.relative(projectGitCwd, candidate);
+      if (!path16.isAbsolute(candidate)) return candidate;
+      const relative = path16.relative(projectGitCwd, candidate);
       if (!relative) return "";
-      if (relative === ".." || relative.startsWith(`..${path15.sep}`))
+      if (relative === ".." || relative.startsWith(`..${path16.sep}`))
         return "";
       return relative;
     }).filter(Boolean)
@@ -6841,7 +7077,7 @@ async function resolveComponentStatusPaths(ctx, projectGitCwd, component, workfl
   if (cached) return [...cached];
   const existing = [];
   for (const candidate of normalizedCandidates) {
-    if (await ctx.fs.pathExists(path15.join(projectGitCwd, candidate))) {
+    if (await ctx.fs.pathExists(path16.join(projectGitCwd, candidate))) {
       existing.push(candidate);
     }
   }
@@ -6927,18 +7163,19 @@ function isPrePrReviewSatisfied2(feature, policy) {
 }
 async function parseFeature(ctx, featurePath, type, context, options) {
   const lang = options.lang;
-  const workflowPolicy = resolveWorkflowPolicy(options.workflow);
-  const prePrReviewPolicy = resolvePrePrReviewPolicy(options.workflow);
-  const folderName = path15.basename(featurePath);
+  const { workflowPolicy, prePrReviewPolicy } = resolveWorkflowRuntime(
+    options.workflow
+  );
+  const folderName = path16.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
   const slug = match?.[2] || folderName;
-  const specPath = path15.join(featurePath, "spec.md");
-  const planPath = path15.join(featurePath, "plan.md");
-  const tasksPath = path15.join(featurePath, "tasks.md");
-  const decisionsPath = path15.join(featurePath, "decisions.md");
-  const issueDocPath = path15.join(featurePath, "issue.md");
-  const prDocPath = path15.join(featurePath, "pr.md");
+  const specPath = path16.join(featurePath, "spec.md");
+  const planPath = path16.join(featurePath, "plan.md");
+  const tasksPath = path16.join(featurePath, "tasks.md");
+  const decisionsPath = path16.join(featurePath, "decisions.md");
+  const issueDocPath = path16.join(featurePath, "issue.md");
+  const prDocPath = path16.join(featurePath, "pr.md");
   let specStatus;
   let issueNumber;
   const specExists = await ctx.fs.pathExists(specPath);
@@ -6989,6 +7226,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   let lastDoneTask;
   let nextTodoTask;
   let tasksDocStatus;
+  let pendingChangeRequest;
   let tasksDocStatusFieldExists = false;
   let completionChecklist;
   let prePrReviewStatus;
@@ -7050,6 +7288,11 @@ async function parseFeature(ctx, featurePath, type, context, options) {
       "Doc Status"
     ]);
     tasksDocStatus = parseDocStatus(tasksDocStatusValue);
+    const pendingChangeRequestValue = extractFirstSpecValue(content, [
+      "Pending Change Request",
+      "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD"
+    ]);
+    pendingChangeRequest = parsePendingChangeRequest(pendingChangeRequestValue);
     const prValue = extractFirstSpecValue(content, ["PR", "Pull Request"]);
     prFieldExists = hasAnySpecKey(content, ["PR", "Pull Request"]);
     prLink = parsePrLink(prValue);
@@ -7200,7 +7443,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
   } else if (workflowPolicy.requireWorktree && tasksSummary.total > tasksSummary.done && !projectInManagedWorktree) {
     warnings.push(tr(lang, "warnings", "workflowWorktreeRequired"));
   }
-  const relativeFeaturePathFromDocs = path15.relative(
+  const relativeFeaturePathFromDocs = path16.relative(
     context.docsDir,
     featurePath
   );
@@ -7456,6 +7699,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
     folderName,
     type,
     path: featurePath,
+    pendingChangeRequest,
     completion: {
       implementationDone,
       workflowDone,
@@ -7566,7 +7810,7 @@ async function parseFeature(ctx, featurePath, type, context, options) {
 async function listFeatureDirs(ctx, rootDir) {
   const dirs = await listSubdirectories(ctx.fs, rootDir);
   return dirs.filter(
-    (value) => path15.basename(value).trim().toLowerCase() !== "feature-base"
+    (value) => path16.basename(value).trim().toLowerCase() !== "feature-base"
   );
 }
 function normalizeRelPath(value) {
@@ -7707,7 +7951,7 @@ async function scanFeatures(ctx) {
   if (config.projectType === "single") {
     const featureDirs = await listFeatureDirs(
       ctx,
-      path15.join(config.docsDir, "features")
+      path16.join(config.docsDir, "features")
     );
     componentFeatureDirs.set("single", featureDirs);
     allFeatureDirs.push(...featureDirs);
@@ -7719,14 +7963,14 @@ async function scanFeatures(ctx) {
     for (const component of components) {
       const componentDirs = await listFeatureDirs(
         ctx,
-        path15.join(config.docsDir, "features", component)
+        path16.join(config.docsDir, "features", component)
       );
       componentFeatureDirs.set(component, componentDirs);
       allFeatureDirs.push(...componentDirs);
     }
   }
   const relativeFeaturePaths = allFeatureDirs.map(
-    (dir) => normalizeRelPath(path15.relative(config.docsDir, dir))
+    (dir) => normalizeRelPath(path16.relative(config.docsDir, dir))
   );
   const docsGitMeta = buildDocsFeatureGitMeta(
     ctx,
@@ -7743,7 +7987,7 @@ async function scanFeatures(ctx) {
     const parsed = await Promise.all(
       target.dirs.map(async (dir) => {
         const relativeFeaturePathFromDocs = normalizeRelPath(
-          path15.relative(config.docsDir, dir)
+          path16.relative(config.docsDir, dir)
         );
         const docsMeta = docsGitMeta.get(relativeFeaturePathFromDocs);
         return parseFeature(
@@ -7813,13 +8057,13 @@ async function runStatus(options) {
     );
   }
   const { docsDir, projectType, projectName, lang } = ctx.config;
-  const featuresDir = path15.join(docsDir, "features");
+  const featuresDir = path16.join(docsDir, "features");
   const scan = await scanFeatures(ctx);
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   for (const f of scan.features) {
     const id = f.id || "UNKNOWN";
-    const relPath = path15.relative(docsDir, f.path);
+    const relPath = path16.relative(docsDir, f.path);
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(relPath);
     if (!f.docs.specExists || !f.docs.tasksExists) continue;
@@ -7910,7 +8154,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path15.join(featuresDir, "status.md");
+    const outputPath = path16.join(featuresDir, "status.md");
     const date = getLocalDateString();
     const content = [
       "# Feature Status",
@@ -7936,7 +8180,7 @@ function escapeRegExp4(value) {
 }
 async function getFeatureNameFromSpec(fsAdapter, featureDir, fallbackSlug, fallbackFolderName) {
   try {
-    const specPath = path15.join(featureDir, "spec.md");
+    const specPath = path16.join(featureDir, "spec.md");
     if (!await fsAdapter.pathExists(specPath)) return fallbackSlug;
     const content = await fsAdapter.readFile(specPath, "utf-8");
     const keys = ["\uAE30\uB2A5\uBA85", "Feature Name"];
@@ -8024,8 +8268,8 @@ async function runUpdate(options) {
       let updatedCount = 0;
       if (updateAgents) {
         console.log(chalk9.blue(tr(lang, "cli", "update.updatingAgents")));
-        const commonAgentsBase = path15.join(templatesDir, lang, "common", "agents");
-        const targetAgentsBase = path15.join(docsDir, "agents");
+        const commonAgentsBase = path16.join(templatesDir, lang, "common", "agents");
+        const targetAgentsBase = path16.join(docsDir, "agents");
         const commonAgents = commonAgentsBase;
         const targetAgents = targetAgentsBase;
         const featurePath = projectType === "multi" ? "docs/features/{component}" : "docs/features";
@@ -8118,21 +8362,21 @@ async function collectAgentsMdTargets(cwd, config) {
   const targets = /* @__PURE__ */ new Set();
   const docsRepo = config.docsRepo ?? "embedded";
   if (docsRepo === "embedded") {
-    const repoRoot = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || path15.resolve(config.docsDir, "..");
-    targets.add(path15.join(repoRoot, "AGENTS.md"));
+    const repoRoot = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || path16.resolve(config.docsDir, "..");
+    targets.add(path16.join(repoRoot, "AGENTS.md"));
     return [...targets];
   }
-  targets.add(path15.join(config.docsDir, "AGENTS.md"));
+  targets.add(path16.join(config.docsDir, "AGENTS.md"));
   const baseDir = getGitTopLevelOrNull2(cwd) || getGitTopLevelOrNull2(config.docsDir) || process.cwd();
   const rawRoots = typeof config.projectRoot === "string" ? [config.projectRoot] : config.projectRoot && typeof config.projectRoot === "object" ? Object.values(config.projectRoot) : [];
   for (const rawRoot of rawRoots) {
     const value = String(rawRoot || "").trim();
     if (!value) continue;
-    const resolved = path15.resolve(baseDir, value);
+    const resolved = path16.resolve(baseDir, value);
     if (!await fs.pathExists(resolved)) continue;
     const stat = await fs.stat(resolved);
     if (!stat.isDirectory()) continue;
-    targets.add(path15.join(resolved, "AGENTS.md"));
+    targets.add(path16.join(resolved, "AGENTS.md"));
   }
   return [...targets];
 }
@@ -8172,7 +8416,7 @@ function normalizeDecisionEnumList2(raw) {
   return [...deduped];
 }
 async function backfillMissingConfigDefaults(docsDir) {
-  const configPath = path15.join(docsDir, ".lee-spec-kit.json");
+  const configPath = path16.join(docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     return { changed: false, changedPaths: [] };
   }
@@ -8191,6 +8435,8 @@ async function backfillMissingConfigDefaults(docsDir) {
     changedPaths.push("workflow");
   }
   const workflow = raw.workflow;
+  const inferredPreset = workflow.mode === "local" ? "local" : "github";
+  setIfMissing(workflow, "preset", inferredPreset, "workflow.preset");
   setIfMissing(workflow, "mode", "github", "workflow.mode");
   setIfMissing(workflow, "requireWorktree", false, "workflow.requireWorktree");
   setIfMissing(workflow, "codeDirtyScope", "auto", "workflow.codeDirtyScope");
@@ -8299,8 +8545,8 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
   const files = await fs.readdir(sourceDir);
   let updatedCount = 0;
   for (const file of files) {
-    const sourcePath = path15.join(sourceDir, file);
-    const targetPath = path15.join(targetDir, file);
+    const sourcePath = path16.join(sourceDir, file);
+    const targetPath = path16.join(targetDir, file);
     const stat = await fs.stat(sourcePath);
     if (stat.isFile()) {
       if (protectedFiles.has(file)) {
@@ -8383,7 +8629,7 @@ function extractPorcelainPaths(line) {
 function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   const top = getGitTopLevel2(docsDir);
   if (!top) return null;
-  const rel = path15.relative(top, docsDir) || ".";
+  const rel = path16.relative(top, docsDir) || ".";
   try {
     const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
       cwd: top,
@@ -8395,7 +8641,7 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
     }
     const ignoredRelPaths = new Set(
       ignoredAbsPaths.map(
-        (absPath) => normalizeGitPath2(path15.relative(top, absPath) || ".")
+        (absPath) => normalizeGitPath2(path16.relative(top, absPath) || ".")
       )
     );
     const filtered = output.split("\n").filter((line) => {
@@ -8453,7 +8699,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runConfig(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path15.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path16.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   if (!config) {
     throw createCliError(
@@ -8461,7 +8707,7 @@ async function runConfig(options) {
       tr(DEFAULT_LANG, "cli", "common.configNotFound")
     );
   }
-  const configPath = path15.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path16.join(config.docsDir, ".lee-spec-kit.json");
   if (!options.projectRoot) {
     console.log();
     console.log(chalk9.blue(tr(config.lang, "cli", "config.currentTitle")));
@@ -8567,47 +8813,47 @@ var BUILTIN_DOC_DEFINITIONS = [
   {
     id: "agents",
     title: { ko: "\uC5D0\uC774\uC804\uD2B8 \uC6B4\uC601 \uADDC\uCE59", en: "Agent Operating Rules" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "agents.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "agents.md")
   },
   {
     id: "git-workflow",
     title: { ko: "Git \uC6CC\uD06C\uD50C\uB85C\uC6B0", en: "Git Workflow" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "git-workflow.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "git-workflow.md")
   },
   {
     id: "issue-doc",
     title: { ko: "Issue \uBB38\uC11C \uD15C\uD50C\uB9BF", en: "Issue Document Template" },
-    relativePath: (_, lang) => path15.join(lang, "common", "features", "feature-base", "issue.md")
+    relativePath: (_, lang) => path16.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) => path15.join(lang, "common", "features", "feature-base", "pr.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "features", "feature-base", "pr.md")
   },
   {
     id: "create-feature",
     title: { ko: "create-feature \uC2A4\uD0AC", en: "create-feature skill" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "skills", "create-feature.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "skills", "create-feature.md")
   },
   {
     id: "execute-task",
     title: { ko: "execute-task \uC2A4\uD0AC", en: "execute-task skill" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "skills", "execute-task.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "skills", "execute-task.md")
   },
   {
     id: "create-issue",
     title: { ko: "create-issue \uC2A4\uD0AC", en: "create-issue skill" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "skills", "create-issue.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "skills", "create-issue.md")
   },
   {
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "skills", "create-pr.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "skills", "create-pr.md")
   },
   {
     id: "split-feature",
     title: { ko: "feature \uBD84\uD560 \uAC00\uC774\uB4DC", en: "feature split guide" },
-    relativePath: (_, lang) => path15.join(lang, "common", "agents", "skills", "split-feature.md")
+    relativePath: (_, lang) => path16.join(lang, "common", "agents", "skills", "split-feature.md")
   }
 ];
 var DOC_FOLLOWUPS = {
@@ -8705,7 +8951,7 @@ function listBuiltinDocs(projectType, lang) {
       id: doc.id,
       title: doc.title[lang],
       relativePath,
-      absolutePath: path15.join(templatesDir, relativePath)
+      absolutePath: path16.join(templatesDir, relativePath)
     };
   });
 }
@@ -8759,7 +9005,7 @@ function toAllowedSet(values, extras) {
   );
 }
 function isDocLikeFile(name) {
-  return DOC_LIKE_FILE_EXTENSIONS.has(path15.extname(name).toLowerCase());
+  return DOC_LIKE_FILE_EXTENSIONS.has(path16.extname(name).toLowerCase());
 }
 async function collectUnmanagedDocsEntries(docsDir, allowed) {
   const allowedDirs = toAllowedSet(DEFAULT_MANAGED_DOC_DIRS, allowed?.dirs);
@@ -8775,7 +9021,7 @@ async function collectUnmanagedDocsEntries(docsDir, allowed) {
       unmanaged.push({
         name,
         kind: "dir",
-        absPath: path15.join(docsDir, name),
+        absPath: path16.join(docsDir, name),
         relPath: `docs/${name}`
       });
       continue;
@@ -8786,7 +9032,7 @@ async function collectUnmanagedDocsEntries(docsDir, allowed) {
     unmanaged.push({
       name,
       kind: "file",
-      absPath: path15.join(docsDir, name),
+      absPath: path16.join(docsDir, name),
       relPath: `docs/${name}`
     });
   }
@@ -9843,7 +10089,7 @@ async function loadApprovalTicketStore(storePath) {
   }
 }
 async function saveApprovalTicketStore(storePath, payload) {
-  await fs.ensureDir(path15.dirname(storePath));
+  await fs.ensureDir(path16.dirname(storePath));
   await fs.writeJson(storePath, payload, { spaces: 2 });
 }
 function pruneApprovalTickets(tickets, nowMs) {
@@ -9983,6 +10229,81 @@ async function consumeApprovalTicket(config, token, expected) {
 }
 
 // src/services/ActionExecutor.ts
+var PENDING_CHANGE_REQUEST_KEYS = [
+  "Pending Change Request",
+  "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD"
+];
+function escapeRegExp5(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function findSpecLineIndex(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:`,
+    "i"
+  );
+  return lines.findIndex((line) => re.test(line));
+}
+function replaceSpecLine(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp5(key));
+  const re = new RegExp(
+    `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`,
+    "i"
+  );
+  if (!re.test(line)) return line;
+  return line.replace(re, `$1${preferredKey}$2${value}`);
+}
+function computeSpecInsertIndex(lines, anchorKeys) {
+  const anchorIndex = findSpecLineIndex(lines, anchorKeys);
+  if (anchorIndex !== -1) {
+    let cursor = anchorIndex + 1;
+    while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
+      cursor += 1;
+    }
+    return cursor;
+  }
+  const sectionIndex = lines.findIndex(
+    (line) => /^\s*##\s+(Task List|태스크 목록)\s*$/.test(line)
+  );
+  if (sectionIndex !== -1) return sectionIndex;
+  return lines.length;
+}
+function upsertPendingChangeRequestLine(content, requestText, lang) {
+  const normalizedRequest = requestText.trim().replace(/\s+/g, " ");
+  const preferredKey = lang === "ko" ? "\uB300\uAE30 \uC911 \uBCC0\uACBD \uC694\uCCAD" : "Pending Change Request";
+  const lines = content.split("\n");
+  const index = findSpecLineIndex(lines, PENDING_CHANGE_REQUEST_KEYS);
+  if (index !== -1) {
+    lines[index] = replaceSpecLine(
+      lines[index],
+      PENDING_CHANGE_REQUEST_KEYS,
+      preferredKey,
+      normalizedRequest
+    );
+    return lines.join("\n");
+  }
+  const insertAt = computeSpecInsertIndex(lines, [
+    "Branch",
+    "\uBE0C\uB79C\uCE58",
+    "Issue",
+    "Issue Number",
+    "\uC774\uC288 \uBC88\uD638"
+  ]);
+  lines.splice(insertAt, 0, `- **${preferredKey}**: ${normalizedRequest}`);
+  return lines.join("\n");
+}
+async function persistPendingChangeRequest(featurePath, requestText, lang) {
+  const tasksPath = path16.join(featurePath, "tasks.md");
+  let content;
+  try {
+    content = await fs20.readFile(tasksPath, "utf-8");
+  } catch {
+    return;
+  }
+  const nextContent = upsertPendingChangeRequestLine(content, requestText, lang);
+  if (nextContent === content) return;
+  await fs20.writeFile(tasksPath, nextContent, "utf-8");
+}
 function executeCommandAction(cmd, jsonMode, cwd) {
   const shellPath = process.env.SHELL || (process.platform === "win32" ? process.env.ComSpec || "cmd.exe" : "/bin/sh");
   if (jsonMode) {
@@ -10123,6 +10444,17 @@ async function runApprovedOption(state, config, lang, featureName, selectionOpti
     action: freshSelected.action
   });
   const featureRef = freshState.matchedFeature.folderName;
+  if (selectedAction.category === "user_request_replan" && userRequest && freshState.matchedFeature.docs.tasksExists) {
+    await withFileLock(
+      getDocsLockPath(config.docsDir),
+      async () => persistPendingChangeRequest(
+        freshState.matchedFeature.path,
+        userRequest,
+        lang
+      ),
+      { owner: "context-approve:pending-change-request" }
+    );
+  }
   if (!options.execute) {
     const ticket = executeRequiresTicket ? await issueApprovalTicket(config, {
       contextVersion: freshState.contextVersion,
@@ -10387,9 +10719,11 @@ async function runContext(featureName, options) {
   const cwd = process.cwd();
   const config = await getConfig(cwd);
   const lang = config?.lang ?? "en";
-  const workflowPolicy = resolveWorkflowPolicy(config?.workflow);
-  const prePrReviewPolicy = resolvePrePrReviewPolicy(config?.workflow);
-  const taskCommitGatePolicy = resolveTaskCommitGatePolicy(config?.workflow);
+  const {
+    workflowPolicy,
+    prePrReviewPolicy,
+    taskCommitGatePolicy
+  } = resolveWorkflowRuntime(config?.workflow);
   if (!config) {
     throw createCliError(
       "CONFIG_NOT_FOUND",
@@ -10688,7 +11022,7 @@ async function runContext(featureName, options) {
       approvalRequest: {
         guidance: approvalGuidance.replace(
           "Before asking for approval, show only `actionOptions[].approvalPrompt` lines and `approvalRequest.finalPrompt` to the user.",
-          "User-facing output must include only approval prompts (`A: ...`) and `finalPrompt`."
+          "If approval is pending, you may prepend one brief current-stage recap derived from `matchedFeature.currentSubstate*`, then user-facing output must reuse the exact approval prompts (`A: ...`) and `finalPrompt`."
         ),
         required: approvalRequired,
         finalPrompt: finalApprovalPrompt,
@@ -10907,7 +11241,7 @@ async function runContext(featureName, options) {
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
-  console.log(`   \u2022 Path: ${path15.relative(cwd, f.path)}`);
+  console.log(`   \u2022 Path: ${path16.relative(cwd, f.path)}`);
   if (f.git.projectBranch) {
     console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
   }
@@ -11040,9 +11374,10 @@ function printChecklist(f, stepDefinitions) {
     console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
   });
 }
-var PRD_REQUIREMENT_ID_RE = /\bPRD-(?:FR|US|NFR)-\d+\b/gi;
+var PRD_REQUIREMENT_ID_EXACT_RE = /^PRD-[A-Z0-9]+(?:-[A-Z0-9]+)*$/i;
+var PRD_REQUIREMENT_ID_RE = /\bPRD-[A-Z0-9]+(?:-[A-Z0-9]+)*\b/gi;
 function isPrdRequirementId(value) {
-  return /^PRD-(?:FR|US|NFR)-\d+$/i.test(value.trim());
+  return PRD_REQUIREMENT_ID_EXACT_RE.test(value.trim());
 }
 function isNonPrdTag(value) {
   const trimmed = value.trim();
@@ -11059,7 +11394,7 @@ function extractTitleAfterId(line, id) {
   return cleaned ? cleaned : void 0;
 }
 async function scanPrdRequirements(fsAdapter, docsDir) {
-  const prdDir = path15.join(docsDir, "prd");
+  const prdDir = path16.join(docsDir, "prd");
   const files = await walkFiles(fsAdapter, prdDir, {
     extensions: [".md"],
     ignoreDirs: [".git", "node_modules", "dist", "tmp"]
@@ -11067,7 +11402,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
   const definitions = /* @__PURE__ */ new Map();
   const duplicates = [];
   for (const filePath of files) {
-    if (path15.basename(filePath).toLowerCase() === "readme.md") {
+    if (path16.basename(filePath).toLowerCase() === "readme.md") {
       continue;
     }
     let content = "";
@@ -11076,7 +11411,7 @@ async function scanPrdRequirements(fsAdapter, docsDir) {
     } catch {
       continue;
     }
-    const relFile = normalizeRelPath2(path15.relative(docsDir, filePath));
+    const relFile = normalizeRelPath2(path16.relative(docsDir, filePath));
     const lines = content.split(/\r?\n/);
     let inCodeBlock = false;
     for (let i = 0; i < lines.length; i += 1) {
@@ -11151,7 +11486,7 @@ var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
 ]);
 function formatPath(cwd, p) {
   if (!p) return "";
-  return path15.isAbsolute(p) ? path15.relative(cwd, p) : p;
+  return path16.isAbsolute(p) ? path16.relative(cwd, p) : p;
 }
 function detectPlaceholders(content) {
   const patterns = [
@@ -11310,7 +11645,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
     const placeholderContext = {
       projectName: config.projectName,
       featureName: f.slug,
-      featurePath: f.docs.featurePathFromDocs || path15.relative(config.docsDir, f.path),
+      featurePath: f.docs.featurePathFromDocs || path16.relative(config.docsDir, f.path),
       repoType: f.type,
       featureNumber
     };
@@ -11320,7 +11655,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       "tasks.md"
     ];
     for (const file of files) {
-      const fullPath = path15.join(f.path, file);
+      const fullPath = path16.join(f.path, file);
       if (!await fs.pathExists(fullPath)) continue;
       const original = await fs.readFile(fullPath, "utf-8");
       let next = original;
@@ -11373,7 +11708,7 @@ async function checkDocsStructure(config, cwd) {
   const issues = [];
   const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
   for (const dir of requiredDirs) {
-    const p = path15.join(config.docsDir, dir);
+    const p = path16.join(config.docsDir, dir);
     if (!await fs.pathExists(p)) {
       issues.push({
         level: "error",
@@ -11385,7 +11720,7 @@ async function checkDocsStructure(config, cwd) {
       });
     }
   }
-  const configPath = path15.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path16.join(config.docsDir, ".lee-spec-kit.json");
   if (!await fs.pathExists(configPath)) {
     issues.push({
       level: "warn",
@@ -11427,7 +11762,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   }
   const idMap = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const rel = f.docs.featurePathFromDocs || path15.relative(config.docsDir, f.path);
+    const rel = f.docs.featurePathFromDocs || path16.relative(config.docsDir, f.path);
     const id = f.id || "UNKNOWN";
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(rel);
@@ -11435,7 +11770,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 = path15.join(f.path, file);
+        const p = path16.join(f.path, file);
         if (!await fs.pathExists(p)) continue;
         const content = await fs.readFile(p, "utf-8");
         const placeholders = detectPlaceholders(content);
@@ -11450,7 +11785,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         });
       }
       if (decisionsPlaceholderMode !== "off") {
-        const decisionsPath = path15.join(f.path, "decisions.md");
+        const decisionsPath = path16.join(f.path, "decisions.md");
         if (await fs.pathExists(decisionsPath)) {
           const content = await fs.readFile(decisionsPath, "utf-8");
           const placeholders = detectPlaceholders(content);
@@ -11479,7 +11814,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, path15.join(f.path, "spec.md"))
+        path: formatPath(cwd, path16.join(f.path, "spec.md"))
       });
     }
     if (f.docs.planExists && !f.planStatus && !isInitialTemplateState) {
@@ -11487,7 +11822,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, path15.join(f.path, "plan.md"))
+        path: formatPath(cwd, path16.join(f.path, "plan.md"))
       });
     }
     if (f.docs.tasksExists && f.tasks.total === 0 && !isInitialTemplateState) {
@@ -11495,11 +11830,11 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_empty",
         message: tr(config.lang, "cli", "doctor.issue.tasksEmpty"),
-        path: formatPath(cwd, path15.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path16.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists) {
-      const tasksPath = path15.join(f.path, "tasks.md");
+      const tasksPath = path16.join(f.path, "tasks.md");
       const tasksContent = await fs.readFile(tasksPath, "utf-8");
       const unknownPrdTags = [...new Set(
         parseTaskLines(tasksContent).flatMap((task) => task.tags).filter((tag) => isPrdRequirementId(tag)).map((tag) => tag.trim().toUpperCase()).filter((tag) => !prdDefinitions.has(tag))
@@ -11521,7 +11856,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, path15.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path16.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && f.docs.tasksDocStatusFieldExists && !f.tasksDocStatus && !isInitialTemplateState) {
@@ -11529,7 +11864,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, path15.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path16.join(f.path, "tasks.md"))
       });
     }
   }
@@ -11553,7 +11888,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, path15.join(config.docsDir, p))
+      path: formatPath(cwd, path16.join(config.docsDir, p))
     });
   }
   return issues;
@@ -11700,7 +12035,7 @@ function doctorCommand(program2) {
       }
       console.log();
       console.log(chalk9.bold(tr(lang, "cli", "doctor.title")));
-      console.log(chalk9.gray(`- Docs: ${path15.relative(cwd, docsDir)}`));
+      console.log(chalk9.gray(`- Docs: ${path16.relative(cwd, docsDir)}`));
       console.log(chalk9.gray(`- Type: ${projectType}`));
       console.log(chalk9.gray(`- Lang: ${lang}`));
       console.log();
@@ -11881,7 +12216,7 @@ async function runView(featureName, options) {
   }
   console.log();
   console.log(chalk9.bold("\u{1F4CA} Workflow View"));
-  console.log(chalk9.gray(`- Docs: ${path15.relative(cwd, config.docsDir)}`));
+  console.log(chalk9.gray(`- Docs: ${path16.relative(cwd, config.docsDir)}`));
   console.log(
     chalk9.gray(
       `- Features: ${state.features.length} (open ${state.openFeatures.length} / done ${state.doneFeatures.length})`
@@ -11966,13 +12301,13 @@ function normalizeRunId(raw) {
   return value;
 }
 function getFlowRunBaseDir(cwd) {
-  return path15.join(getRuntimeStateDir(cwd), "flow-runs");
+  return path16.join(getRuntimeStateDir(cwd), "flow-runs");
 }
 function getFlowRunPath(cwd, runId) {
-  return path15.join(getFlowRunBaseDir(cwd), `${runId}.json`);
+  return path16.join(getFlowRunBaseDir(cwd), `${runId}.json`);
 }
 function getFlowRunLockPath(cwd, runId) {
-  return path15.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
+  return path16.join(getRuntimeStateDir(cwd), "locks", `flow-run-${runId}.lock`);
 }
 async function readFlowRunRecordUnsafe(cwd, runId) {
   const normalized = normalizeRunId(runId);
@@ -11998,7 +12333,7 @@ async function readFlowRunRecordUnsafe(cwd, runId) {
 }
 async function writeFlowRunRecord(cwd, record) {
   const filePath = getFlowRunPath(cwd, record.runId);
-  await fs.ensureDir(path15.dirname(filePath));
+  await fs.ensureDir(path16.dirname(filePath));
   await fs.writeJson(filePath, record, { spaces: 2 });
 }
 async function createFlowRunRecord(cwd, input) {
@@ -12167,8 +12502,13 @@ function toCompactStatusReport(report) {
   };
 }
 function buildAgentOrchestrationPolicy2(autoRun, featureRef) {
+  const resumableStatuses = /* @__PURE__ */ new Set([
+    "delegated_handoff",
+    "gate_reached",
+    "manual_required"
+  ]);
   const resumeCommand = autoRun?.run?.resumeCommand || autoRun?.resume?.flowCommand || null;
-  const handoffRequired = !!autoRun && !!resumeCommand;
+  const handoffRequired = !!autoRun && !!resumeCommand && resumableStatuses.has(autoRun.status);
   const verifyCacheKey = handoffRequired ? `${(featureRef || "unknown").toLowerCase()}|${Buffer$1.from(
     resumeCommand
   ).toString("base64").slice(0, 12)}` : "";
@@ -12424,7 +12764,10 @@ function resolveAutoMode(config, options, requestText) {
   if (requestText) {
     return resolveConfigDefaultAutoMode(config);
   }
-  return null;
+  if (options.approve || options.execute || options.resume) {
+    return null;
+  }
+  return resolveConfigDefaultAutoMode(config);
 }
 function toAutoReasonCode(status) {
   const map = {
@@ -12442,8 +12785,6 @@ function toAutoReasonCode(status) {
 }
 function isAutoRunFailureStatus(status) {
   return [
-    "manual_required",
-    "selection_required",
     "no_progress",
     "request_label_missing",
     "request_failed",
@@ -12455,10 +12796,10 @@ function toFlowRunStatus(status) {
     case "delegated_handoff":
     case "gate_reached":
     case "manual_required":
+    case "selection_required":
       return "paused";
     case "no_action_options":
       return "completed";
-    case "selection_required":
     case "no_progress":
     case "request_label_missing":
     case "request_failed":
@@ -12552,7 +12893,7 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
         executions,
         gate: null,
         manual: null,
-        error: "Auto-run requires a single matched feature. Specify the feature explicitly."
+        error: "Auto-run paused because a single matched feature is required before execution can continue."
       };
     }
     if (actionOptions.length === 0) {
@@ -12799,7 +13140,9 @@ async function runAutoUntilCategory(config, featureName, selectionOptions, until
 
 // src/commands/flow.ts
 function flowCommand(program2) {
-  program2.command("flow [feature-name]").description("Run combined workflow checks (context + status + doctor)").option("--json", "Output in JSON format for agents").option(
+  program2.command("flow [feature-name]").description(
+    "Run the default workflow auto-loop and pause at selection/approval/manual/resume boundaries"
+  ).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(
@@ -12979,14 +13322,6 @@ async function runFlow(featureName, options) {
       }
     }
   }
-  if (autoMode && !featureName) {
-    if (!resolvedFeatureName) {
-      throw createCliError(
-        "CONTEXT_SELECTION_REQUIRED",
-        "Auto mode requires explicit <feature-name> (e.g. F004)."
-      );
-    }
-  }
   if (options.startAuto && !autoMode) {
     throw createCliError(
       "INVALID_ARGUMENT",
@@ -13414,27 +13749,27 @@ function tg(lang, key, vars = {}) {
 function detectGithubCliLangSync(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const startDirs = [
-    explicitDocsDir ? path15.resolve(explicitDocsDir) : "",
-    path15.resolve(cwd)
+    explicitDocsDir ? path16.resolve(explicitDocsDir) : "",
+    path16.resolve(cwd)
   ].filter(Boolean);
   const scanOrder = [];
   const seen = /* @__PURE__ */ new Set();
   for (const start of startDirs) {
     let current = start;
     while (true) {
-      const abs = path15.resolve(current);
+      const abs = path16.resolve(current);
       if (!seen.has(abs)) {
         scanOrder.push(abs);
         seen.add(abs);
       }
-      const parent = path15.dirname(abs);
+      const parent = path16.dirname(abs);
       if (parent === abs) break;
       current = parent;
     }
   }
   for (const base of scanOrder) {
-    for (const docsDir of [path15.join(base, "docs"), base]) {
-      const configPath = path15.join(docsDir, ".lee-spec-kit.json");
+    for (const docsDir of [path16.join(base, "docs"), base]) {
+      const configPath = path16.join(docsDir, ".lee-spec-kit.json");
       if (fs.existsSync(configPath)) {
         try {
           const parsed = fs.readJsonSync(configPath);
@@ -13443,11 +13778,11 @@ function detectGithubCliLangSync(cwd) {
         } catch {
         }
       }
-      const agentsPath = path15.join(docsDir, "agents");
-      const featuresPath = path15.join(docsDir, "features");
+      const agentsPath = path16.join(docsDir, "agents");
+      const featuresPath = path16.join(docsDir, "features");
       if (!fs.existsSync(agentsPath) || !fs.existsSync(featuresPath)) continue;
       for (const probe of ["custom.md", "constitution.md", "agents.md"]) {
-        const file = path15.join(agentsPath, probe);
+        const file = path16.join(agentsPath, probe);
         if (!fs.existsSync(file)) continue;
         try {
           const content = fs.readFileSync(file, "utf-8");
@@ -13467,13 +13802,13 @@ function parseLabels(raw, lang) {
   }
   return [...new Set(labels)];
 }
-function escapeRegExp5(value) {
+function escapeRegExp6(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function extractDraftMetadataValue(content, keys) {
   for (const key of keys) {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp5(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp6(key)}\\*\\*\\s*:\\s*(.*?)\\s*$`,
       "mi"
     );
     const match = content.match(re);
@@ -13552,7 +13887,7 @@ async function prepareGithubBody(params) {
       };
     }
   }
-  await fs.ensureDir(path15.dirname(defaultBodyFile));
+  await fs.ensureDir(path16.dirname(defaultBodyFile));
   await fs.writeFile(defaultBodyFile, generatedBody, "utf-8");
   return {
     body: generatedBody,
@@ -13592,7 +13927,7 @@ function ensureSections(body, sections, kind, lang) {
   };
   const hasMetadataField = (field) => {
     const re = new RegExp(
-      `^\\s*-\\s*\\*\\*${escapeRegExp5(field)}\\*\\*\\s*:`,
+      `^\\s*-\\s*\\*\\*${escapeRegExp6(field)}\\*\\*\\s*:`,
       "m"
     );
     return re.test(body);
@@ -13622,7 +13957,7 @@ function ensureSections(body, sections, kind, lang) {
 }
 function ensureDocsExist(docsDir, relativePaths, lang) {
   const missing = relativePaths.filter(
-    (relativePath) => !fs.existsSync(path15.join(docsDir, relativePath))
+    (relativePath) => !fs.existsSync(path16.join(docsDir, relativePath))
   );
   if (missing.length > 0) {
     throw createCliError(
@@ -13632,18 +13967,18 @@ function ensureDocsExist(docsDir, relativePaths, lang) {
   }
 }
 function buildDefaultBodyFileName(kind, docsDir, component) {
-  const key = `${path15.resolve(docsDir)}::${component.trim().toLowerCase()}`;
+  const key = `${path16.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, lang) {
-  const selected = raw?.trim() || path15.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
+  const selected = raw?.trim() || path16.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
   assertValid(
     validatePathWithLang(selected, lang),
     `github.${kind}.bodyFile`,
     lang
   );
-  return path15.resolve(selected);
+  return path16.resolve(selected);
 }
 function toProjectRootDocsPath(relativePathFromDocs) {
   const normalized = relativePathFromDocs.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
@@ -14480,7 +14815,7 @@ function stripMarkdownCodeContexts(body) {
 function hasIssueClosingKeyword(body, issueNumber) {
   if (!issueNumber) return false;
   const cleaned = stripMarkdownCodeContexts(body);
-  const issue = escapeRegExp5(issueNumber);
+  const issue = escapeRegExp6(issueNumber);
   const closeKeywordRegex = new RegExp(
     `\\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)\\b\\s*(?:[a-zA-Z0-9_.-]+\\/)?#\\s*${issue}\\b`,
     "i"
@@ -14777,7 +15112,7 @@ function ensureCleanWorktree(cwd, lang) {
 function commitAndPushPaths(cwd, absPaths, message, lang, options) {
   const uniqueRelativePaths = [
     ...new Set(
-      absPaths.filter((absPath) => !!absPath && fs.existsSync(absPath)).map((absPath) => path15.relative(cwd, absPath) || absPath)
+      absPaths.filter((absPath) => !!absPath && fs.existsSync(absPath)).map((absPath) => path16.relative(cwd, absPath) || absPath)
     )
   ];
   if (uniqueRelativePaths.length === 0) return;
@@ -14973,15 +15308,15 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path15.join(config.docsDir, paths.specPath),
+          path16.join(config.docsDir, paths.specPath),
           "utf-8"
         );
         const planContent = await fs.readFile(
-          path15.join(config.docsDir, paths.planPath),
+          path16.join(config.docsDir, paths.planPath),
           "utf-8"
         );
         const tasksContent = await fs.readFile(
-          path15.join(config.docsDir, paths.tasksPath),
+          path16.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -15024,7 +15359,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path15.join(config.docsDir, paths.issuePath),
+          workflowDraftPath: path16.join(config.docsDir, paths.issuePath),
           generatedBody,
           requiredSections: getRequiredIssueSections(config.lang),
           kindLabel: tg(config.lang, "kindIssue"),
@@ -15040,7 +15375,7 @@ function githubCommand(program2) {
             `${feature.type}-issue-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path15.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path16.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -15089,12 +15424,12 @@ function githubCommand(program2) {
           const syncedIssueNumber = extractIssueNumberFromUrl(issueUrl);
           if (syncedIssueNumber) {
             const synced = syncTasksIssueMetadata(
-              path15.join(config.docsDir, paths.tasksPath),
+              path16.join(config.docsDir, paths.tasksPath),
               syncedIssueNumber,
               config.lang
             );
             const draftSynced = syncIssueDraftMetadata(
-              path15.join(config.docsDir, paths.issuePath),
+              path16.join(config.docsDir, paths.issuePath),
               syncedIssueNumber
             );
             syncChanged = synced.changed || draftSynced.changed;
@@ -15205,13 +15540,13 @@ function githubCommand(program2) {
           config.lang
         );
         const specContent = await fs.readFile(
-          path15.join(config.docsDir, paths.specPath),
+          path16.join(config.docsDir, paths.specPath),
           "utf-8"
         );
-        const planPath = path15.join(config.docsDir, paths.planPath);
+        const planPath = path16.join(config.docsDir, paths.planPath);
         const planContent = await fs.pathExists(planPath) ? await fs.readFile(planPath, "utf-8") : "";
         const tasksContent = await fs.readFile(
-          path15.join(config.docsDir, paths.tasksPath),
+          path16.join(config.docsDir, paths.tasksPath),
           "utf-8"
         );
         const overview = resolveOverviewFromSpec(
@@ -15259,7 +15594,7 @@ function githubCommand(program2) {
           create: options.create,
           explicitBodyFile,
           defaultBodyFile,
-          workflowDraftPath: path15.join(config.docsDir, paths.prPath),
+          workflowDraftPath: path16.join(config.docsDir, paths.prPath),
           generatedBody,
           requiredSections: getRequiredPrSections(config.lang),
           kindLabel: tg(config.lang, "kindPr"),
@@ -15277,7 +15612,7 @@ function githubCommand(program2) {
             `${feature.type}-pr-sanitized`,
             config.lang
           );
-          await fs.ensureDir(path15.dirname(sanitizedBodyFile));
+          await fs.ensureDir(path16.dirname(sanitizedBodyFile));
           await fs.writeFile(sanitizedBodyFile, body, "utf-8");
           bodyFile = sanitizedBodyFile;
         }
@@ -15319,7 +15654,7 @@ function githubCommand(program2) {
             if (preparedBody.source === "generated") {
               await fs.writeFile(bodyFile, body, "utf-8");
             } else {
-              await fs.ensureDir(path15.dirname(fallbackBodyFile));
+              await fs.ensureDir(path16.dirname(fallbackBodyFile));
               await fs.writeFile(fallbackBodyFile, body, "utf-8");
               bodyFile = fallbackBodyFile;
             }
@@ -15376,13 +15711,13 @@ function githubCommand(program2) {
         }
         if (prUrl && options.syncTasks !== false) {
           const syncedTasks = syncTasksPrMetadata(
-            path15.join(config.docsDir, paths.tasksPath),
+            path16.join(config.docsDir, paths.tasksPath),
             prUrl,
             "Review",
             config.lang
           );
           const syncedDraft = syncPrDraftMetadata(
-            path15.join(config.docsDir, paths.prPath),
+            path16.join(config.docsDir, paths.prPath),
             prUrl,
             "Review"
           );
@@ -15423,13 +15758,13 @@ function githubCommand(program2) {
           mergeAlreadyMerged = merged.alreadyMerged;
           if (prUrl && options.syncTasks !== false) {
             const mergedTasksSync = syncTasksPrMetadata(
-              path15.join(config.docsDir, paths.tasksPath),
+              path16.join(config.docsDir, paths.tasksPath),
               prUrl,
               "Approved",
               config.lang
             );
             const mergedDraftSync = syncPrDraftMetadata(
-              path15.join(config.docsDir, paths.prPath),
+              path16.join(config.docsDir, paths.prPath),
               prUrl,
               "Approved"
             );
@@ -15700,7 +16035,7 @@ function docsCommand(program2) {
         );
         return;
       }
-      const relativeFromCwd = path15.relative(process.cwd(), loaded.entry.absolutePath);
+      const relativeFromCwd = path16.relative(process.cwd(), loaded.entry.absolutePath);
       console.log();
       console.log(chalk9.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
       console.log(
@@ -15780,8 +16115,9 @@ function detectCommand(program2) {
 }
 async function runDetect(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path15.resolve(cwd, options.dir) : cwd;
-  const config = await getConfig(targetCwd);
+  const targetCwd = options.dir ? path16.resolve(cwd, options.dir) : cwd;
+  const detection = await detectSchemaProject(targetCwd);
+  const config = detection.config;
   const detected = !!config;
   const reasonCode = detected ? "PROJECT_DETECTED" : "PROJECT_NOT_DETECTED";
   if (options.json) {
@@ -15807,9 +16143,6 @@ async function runDetect(options) {
       );
       return;
     }
-    const configPath2 = path15.join(config.docsDir, ".lee-spec-kit.json");
-    const configFilePresent2 = await fs.pathExists(configPath2);
-    const detectionSource2 = configFilePresent2 ? "config" : "heuristic";
     console.log(
       JSON.stringify(
         {
@@ -15817,10 +16150,10 @@ async function runDetect(options) {
           reasonCode,
           isLeeSpecKitProject: true,
           targetCwd,
-          docsDir: config.docsDir,
-          configPath: configFilePresent2 ? configPath2 : null,
-          configFilePresent: configFilePresent2,
-          detectionSource: detectionSource2,
+          docsDir: detection.docsDir,
+          configPath: detection.configPath,
+          configFilePresent: detection.configFilePresent,
+          detectionSource: detection.detectionSource,
           projectType: config.projectType,
           lang: config.lang,
           projectName: config.projectName ?? null
@@ -15841,14 +16174,11 @@ async function runDetect(options) {
     console.log();
     return;
   }
-  const configPath = path15.join(config.docsDir, ".lee-spec-kit.json");
-  const configFilePresent = await fs.pathExists(configPath);
-  const detectionSource = configFilePresent ? "config" : "heuristic";
   console.log(chalk9.green(`- ${tr(lang, "cli", "detect.resultDetected")}`));
-  console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.labelDocsDir")}: ${config.docsDir}`));
+  console.log(chalk9.gray(`- ${tr(lang, "cli", "detect.labelDocsDir")}: ${detection.docsDir}`));
   console.log(
     chalk9.gray(
-      `- ${tr(lang, "cli", "detect.labelConfigPath")}: ${configFilePresent ? configPath : "-"}`
+      `- ${tr(lang, "cli", "detect.labelConfigPath")}: ${detection.configPath || "-"}`
     )
   );
   console.log(
@@ -15856,7 +16186,7 @@ async function runDetect(options) {
       `- ${tr(lang, "cli", "detect.labelSource")}: ${tr(
         lang,
         "cli",
-        detectionSource === "config" ? "detect.sourceConfig" : "detect.sourceHeuristic"
+        detection.detectionSource === "config" ? "detect.sourceConfig" : "detect.sourceHeuristic"
       )}`
     )
   );
@@ -15918,19 +16248,19 @@ function hasTemplateMarkers(content) {
   return patterns.some((pattern) => pattern.test(content));
 }
 async function countFeatureDirs(ctx, docsDir, projectType) {
-  const featuresRoot = path15.join(docsDir, "features");
+  const featuresRoot = path16.join(docsDir, "features");
   if (projectType === "single") {
     const dirs = await listSubdirectories(ctx.fs, featuresRoot);
-    return dirs.filter((value) => path15.basename(value) !== "feature-base").length;
+    return dirs.filter((value) => path16.basename(value) !== "feature-base").length;
   }
   const components = await listSubdirectories(ctx.fs, featuresRoot);
   let total = 0;
   for (const componentDir of components) {
-    const componentName = path15.basename(componentDir).trim().toLowerCase();
+    const componentName = path16.basename(componentDir).trim().toLowerCase();
     if (!componentName || componentName === "feature-base") continue;
     const dirs = await listSubdirectories(ctx.fs, componentDir);
     total += dirs.filter(
-      (value) => path15.basename(value) !== "feature-base"
+      (value) => path16.basename(value) !== "feature-base"
     ).length;
   }
   return total;
@@ -15942,7 +16272,7 @@ async function hasUserPrdFile(ctx, prdDir) {
     ignoreDirs: ["node_modules"]
   });
   return files.some(
-    (absolutePath) => path15.basename(absolutePath).toLowerCase() !== "readme.md"
+    (absolutePath) => path16.basename(absolutePath).toLowerCase() !== "readme.md"
   );
 }
 function finalizeChecks(checks) {
@@ -16111,7 +16441,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const constitutionPath = path15.join(docsDir, "agents", "constitution.md");
+  const constitutionPath = path16.join(docsDir, "agents", "constitution.md");
   if (!await fs.pathExists(constitutionPath)) {
     checks.push({
       id: "constitution_exists",
@@ -16153,7 +16483,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const customPath = path15.join(docsDir, "agents", "custom.md");
+  const customPath = path16.join(docsDir, "agents", "custom.md");
   if (await fs.pathExists(customPath)) {
     const content = await fs.readFile(customPath, "utf-8");
     if (hasTemplateMarkers(content)) {
@@ -16182,7 +16512,7 @@ async function runOnboardChecks(ctx) {
       });
     }
   }
-  const prdDir = path15.join(docsDir, "prd");
+  const prdDir = path16.join(docsDir, "prd");
   const featureCount = await countFeatureDirs(ctx, docsDir, config.projectType);
   const prdReady = await hasUserPrdFile(ctx, prdDir);
   if (!prdReady) {
@@ -16200,7 +16530,7 @@ async function runOnboardChecks(ctx) {
         "PRD is empty. If features already exist, fill PRD as soon as possible."
       ),
       path: prdDir,
-      suggestedCommand: `touch ${quotePath(path15.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
+      suggestedCommand: `touch ${quotePath(path16.join(prdDir, `${toSlug(config.projectName || "project")}-prd.md`))}`
     });
   } else {
     checks.push({
@@ -16638,7 +16968,7 @@ var PrePrReviewValidator = class {
     return result.evidence;
   }
   async validateEvidenceWithScope(evidencePath, projectRoot) {
-    const fullPath = path15.resolve(evidencePath);
+    const fullPath = path16.resolve(evidencePath);
     if (!await fs.pathExists(fullPath)) {
       throw createCliError(
         "INVALID_ARGUMENT",
@@ -16736,9 +17066,9 @@ var PrePrReviewValidator = class {
     ]);
     const reviewedFiles = new Set(
       normalizedEvidence.files.map(
-        (f) => path15.relative(
+        (f) => path16.relative(
           projectRoot,
-          path15.resolve(projectRoot, f.path)
+          path16.resolve(projectRoot, f.path)
         )
       ).map((entry) => normalizeGitPath3(entry)).filter(Boolean)
     );
@@ -16934,7 +17264,7 @@ var DEFAULT_EVIDENCE_FOR_ANY_MODE = {
   residualRisks: ["none"],
   commandsExecuted: []
 };
-function escapeRegExp6(value) {
+function escapeRegExp7(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function normalizeDecision(raw) {
@@ -16947,15 +17277,15 @@ function normalizeDecision(raw) {
   if (value === "blocked" || value === "block") return "blocked";
   return null;
 }
-function findSpecLineIndex(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+function findSpecLineIndex2(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
   );
   return lines.findIndex((line) => re.test(line));
 }
-function replaceSpecLine(line, keys, preferredKey, value) {
-  const escaped = keys.map((key) => escapeRegExp6(key));
+function replaceSpecLine2(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp7(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -16963,7 +17293,7 @@ function replaceSpecLine(line, keys, preferredKey, value) {
   return line.replace(re, `$1${preferredKey}$2${value}`);
 }
 function computeInsertIndex(lines, anchorKeys) {
-  const anchorIndex = findSpecLineIndex(lines, anchorKeys);
+  const anchorIndex = findSpecLineIndex2(lines, anchorKeys);
   if (anchorIndex !== -1) {
     let cursor = anchorIndex + 1;
     while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
@@ -16979,9 +17309,9 @@ function computeInsertIndex(lines, anchorKeys) {
 }
 function upsertSpecLine(content, keys, preferredKey, value, anchorKeys) {
   const lines = content.split("\n");
-  const index = findSpecLineIndex(lines, keys);
+  const index = findSpecLineIndex2(lines, keys);
   if (index !== -1) {
-    lines[index] = replaceSpecLine(lines[index], keys, preferredKey, value);
+    lines[index] = replaceSpecLine2(lines[index], keys, preferredKey, value);
     return lines.join("\n");
   }
   const insertAt = computeInsertIndex(lines, anchorKeys);
@@ -17199,7 +17529,7 @@ async function runPrePrReviewRun(featureName, options) {
   );
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -17308,7 +17638,7 @@ async function runPrePrReview(featureName, options) {
       `tasks.md not found for feature: ${feature.folderName}`
     );
   }
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   const tasksContent = await fs.readFile(tasksPath, "utf-8");
   const policy = resolvePrePrReviewPolicy(config.workflow);
   const preferred = getPreferredKeys(config.lang);
@@ -17406,7 +17736,7 @@ async function runPrePrReview(featureName, options) {
       }
     }
   }
-  const decisionsPath = path15.join(feature.path, "decisions.md");
+  const decisionsPath = path16.join(feature.path, "decisions.md");
   const decisionLogEntry = buildReportContent({
     folderName: feature.folderName,
     date,
@@ -17422,9 +17752,9 @@ async function runPrePrReview(featureName, options) {
     await fs.writeFile(decisionsPath, nextDecisions, "utf-8");
   }
   const decisionsPathFromDocs = normalizePathForDoc(
-    path15.join(feature.docs.featurePathFromDocs, "decisions.md")
+    path16.join(feature.docs.featurePathFromDocs, "decisions.md")
   );
-  const evidencePath = path15.basename(config.docsDir) === "docs" ? normalizePathForDoc(path15.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
+  const evidencePath = path16.basename(config.docsDir) === "docs" ? normalizePathForDoc(path16.join("docs", decisionsPathFromDocs)) : decisionsPathFromDocs;
   let nextTasks = tasksContent;
   nextTasks = upsertSpecLine(
     nextTasks,
@@ -17479,18 +17809,18 @@ async function runPrePrReview(featureName, options) {
   }
   console.log();
 }
-function escapeRegExp7(value) {
+function escapeRegExp8(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function findSpecLineIndex2(lines, keys) {
-  const escaped = keys.map((key) => escapeRegExp7(key));
+function findSpecLineIndex3(lines, keys) {
+  const escaped = keys.map((key) => escapeRegExp8(key));
   const re = new RegExp(
     `^\\s*-\\s*\\*\\*(?:${escaped.join("|")})\\*\\*\\s*:\\s*`
   );
   return lines.findIndex((line) => re.test(line));
 }
-function replaceSpecLine2(line, keys, preferredKey, value) {
-  const escaped = keys.map((key) => escapeRegExp7(key));
+function replaceSpecLine3(line, keys, preferredKey, value) {
+  const escaped = keys.map((key) => escapeRegExp8(key));
   const re = new RegExp(
     `^(\\s*-\\s*\\*\\*)(?:${escaped.join("|")})(\\*\\*\\s*:\\s*)(.*)$`
   );
@@ -17498,7 +17828,7 @@ function replaceSpecLine2(line, keys, preferredKey, value) {
   return line.replace(re, `$1${preferredKey}$2${value}`);
 }
 function computeInsertIndex2(lines, anchorKeys) {
-  const anchorIndex = findSpecLineIndex2(lines, anchorKeys);
+  const anchorIndex = findSpecLineIndex3(lines, anchorKeys);
   if (anchorIndex !== -1) {
     let cursor = anchorIndex + 1;
     while (cursor < lines.length && /^\s{2,}-\s+/.test(lines[cursor])) {
@@ -17514,9 +17844,9 @@ function computeInsertIndex2(lines, anchorKeys) {
 }
 function upsertSpecLine2(content, keys, preferredKey, value, anchorKeys) {
   const lines = content.split("\n");
-  const index = findSpecLineIndex2(lines, keys);
+  const index = findSpecLineIndex3(lines, keys);
   if (index !== -1) {
-    lines[index] = replaceSpecLine2(lines[index], keys, preferredKey, value);
+    lines[index] = replaceSpecLine3(lines[index], keys, preferredKey, value);
     return lines.join("\n");
   }
   const insertAt = computeInsertIndex2(lines, anchorKeys);
@@ -17565,7 +17895,7 @@ async function runCodeReviewRun(featureName, options) {
     );
   }
   const feature = state.matchedFeature;
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   let tasksUpdated = false;
   if (await fs.pathExists(tasksPath)) {
     const tasksContent = await fs.readFile(tasksPath, "utf-8");
@@ -17598,7 +17928,7 @@ async function runCodeReviewRun(featureName, options) {
     nextMainState: "code_review_running",
     tasksUpdated,
     tasksPath,
-    decisionsPath: path15.join(feature.path, "decisions.md"),
+    decisionsPath: path16.join(feature.path, "decisions.md"),
     prompt,
     recordedAt: getLocalDateString()
   };
@@ -17717,7 +18047,7 @@ async function runRequirements(options) {
   }
   for (const feature of scan.features) {
     if (!feature.docs.tasksExists) continue;
-    const tasksPath = path15.join(feature.path, "tasks.md");
+    const tasksPath = path16.join(feature.path, "tasks.md");
     let tasksContent = "";
     try {
       tasksContent = await ctx.fs.readFile(tasksPath, "utf-8");
@@ -17851,7 +18181,7 @@ async function runRequirements(options) {
   process.stdout.write(`${lines.join("\n")}
 `);
   if (options.write) {
-    const outputPath = path15.join(docsDir, "prd", "status.md");
+    const outputPath = path16.join(docsDir, "prd", "status.md");
     await ctx.fs.writeFile(outputPath, `${lines.join("\n")}
 `, "utf-8");
     console.log(chalk9.green(`\u2705 wrote: ${outputPath}`));
@@ -17965,8 +18295,8 @@ function parseTaskChecklist(lines, taskLineIndex) {
 function ensureTaskDetailsReady(lines, task) {
   const acceptance = parseTaskAcceptance(lines, task.index);
   const checklist = parseTaskChecklist(lines, task.index);
-  const acceptanceHasPlaceholder = !acceptance || acceptance.items.length === 0 || acceptance.placeholderCount > 0;
-  const checklistHasPlaceholder = !checklist || checklist.total === 0 || checklist.placeholderCount > 0;
+  const acceptanceHasPlaceholder = !!acceptance && (acceptance.items.length === 0 || acceptance.placeholderCount > 0);
+  const checklistHasPlaceholder = !!checklist && (checklist.total === 0 || checklist.placeholderCount > 0);
   if (acceptanceHasPlaceholder || checklistHasPlaceholder) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -18038,7 +18368,7 @@ async function resolveTaskRunContext(featureName, options) {
 }
 async function runTaskRun(featureName, options) {
   const { config, feature } = await resolveTaskRunContext(featureName, options);
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -18177,7 +18507,7 @@ async function resolveTaskCompleteContext(featureName, options) {
 }
 async function runTaskComplete(featureName, options) {
   const { feature } = await resolveTaskCompleteContext(featureName, options);
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -18295,7 +18625,7 @@ function normalizeTaskDetailItems(values, flagName) {
   }
   return normalized;
 }
-function escapeRegExp8(value) {
+function escapeRegExp9(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function findTaskListHeadingIndex(lines) {
@@ -18330,7 +18660,7 @@ function normalizeTaskRef(value) {
   if (!trimmed) {
     throw createCliError(
       "INVALID_ARGUMENT",
-      "`--ref` is required. Use `NON-PRD` or an existing `PRD-...` requirement ID."
+      "`--ref` is required. Use `NON-PRD` or an existing `PRD-*` requirement ID."
     );
   }
   if (isNonPrdTag(trimmed)) return "NON-PRD";
@@ -18338,14 +18668,14 @@ function normalizeTaskRef(value) {
   if (!isPrdRequirementId(normalized)) {
     throw createCliError(
       "INVALID_ARGUMENT",
-      "`--ref` must be `NON-PRD` or an existing `PRD-FR-001`-style requirement ID."
+      "`--ref` must be `NON-PRD` or an existing `PRD-*` requirement ID (for example `PRD-FR-001` or `PRD-SCOPE-V1-DESKTOP-EDITOR`)."
     );
   }
   return normalized;
 }
 function getNextTaskSequence(content, featureFolderName) {
   const taskIdPattern = new RegExp(
-    `\\bT-${escapeRegExp8(featureFolderName)}-(\\d+)\\b`,
+    `\\bT-${escapeRegExp9(featureFolderName)}-(\\d+)\\b`,
     "g"
   );
   let max = 0;
@@ -18408,7 +18738,7 @@ async function runTaskAdd(featureName, options) {
       );
     }
   }
-  const tasksPath = path15.join(feature.path, "tasks.md");
+  const tasksPath = path16.join(feature.path, "tasks.md");
   if (!await fs.pathExists(tasksPath)) {
     throw createCliError(
       "PRECONDITION_FAILED",
@@ -18475,7 +18805,7 @@ async function runTaskAdd(featureName, options) {
 }
 function taskCommand(program2) {
   const task = program2.command("task").description("Manage tasks");
-  task.command("add [feature-name]").description("Append a new task to the end of Task List").requiredOption("--title <title>", "Task title").requiredOption("--ref <ref>", "Requirement ref: NON-PRD or PRD-FR-001").option(
+  task.command("add [feature-name]").description("Append a new task to the end of Task List").requiredOption("--title <title>", "Task title").requiredOption("--ref <ref>", "Requirement ref: NON-PRD or existing PRD-* key").option(
     "--acceptance <text>",
     "Acceptance item. Repeat to add more than one.",
     collectRepeatableOption,
@@ -18511,10 +18841,9 @@ function taskCommand(program2) {
     }
   });
 }
-function setupCommand(program2) {
-  const setup = program2.command("setup").description("Developer environment setup helpers");
-  setup.command("codex-bootstrap").description(
-    "Install a small Codex global bootstrap that reads ./AGENTS.md or ./docs/AGENTS.md"
+function registerCodexIntegration(parent) {
+  parent.command("codex").alias("codex-bootstrap").description(
+    "Install or remove the optional Codex bootstrap that re-reads ./AGENTS.md or ./docs/AGENTS.md"
   ).option(
     "--remove",
     "Remove the lee-spec-kit managed Codex bootstrap block"
@@ -18547,6 +18876,10 @@ function setupCommand(program2) {
     }
   });
 }
+function integrationsCommand(program2) {
+  const integrations = program2.command("integrations").alias("setup").description("Optional developer integration helpers");
+  registerCodexIntegration(integrations);
+}
 function isBannerDisabled() {
   const v = (process.env.LEE_SPEC_KIT_NO_BANNER || "").trim();
   return v === "1";
@@ -18590,11 +18923,11 @@ ${version}
   }
   return `${ascii}${footer}`;
 }
-var CACHE_FILE = path15.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+var CACHE_FILE = path16.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path15.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path16.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       return pkg.version;
@@ -18698,7 +19031,7 @@ function shouldCheckForUpdates() {
 if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
-    const packageJsonPath = path15.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path16.join(__dirname$1, "..", "package.json");
     if (fs.existsSync(packageJsonPath)) {
       const pkg = fs.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);
@@ -18718,9 +19051,7 @@ function configureRootCommandSurface() {
   }
 }
 var cliVersion = getCliVersion();
-program.name("lee-spec-kit").description(
-  "Agent-guided development harness for spec-driven projects"
-).version(cliVersion).option("--no-banner", "Hide banner in help output");
+program.name("lee-spec-kit").description("Orchestration harness CLI for AI agent-driven development").version(cliVersion).option("--no-banner", "Hide banner in help output");
 if (shouldShowBanner()) {
   program.addHelpText("beforeAll", getBanner({ version: cliVersion }));
 }
@@ -18744,7 +19075,7 @@ taskRunCommand(program);
 taskCompleteCommand(program);
 taskCommand(program);
 requirementsCommand(program);
-setupCommand(program);
+integrationsCommand(program);
 configureRootCommandSurface();
 await program.parseAsync();
 //# sourceMappingURL=index.js.map