lee-spec-kit 0.6.3 → 0.6.5

package/dist/index.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-import path17 from 'path';
+import path18 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
-import fs15 from 'fs-extra';
+import fs14 from 'fs-extra';
 import prompts from 'prompts';
 import chalk6 from 'chalk';
 import { glob } from 'glob';
@@ -11,10 +11,10 @@ import { createHash } from 'crypto';
 import os from 'os';
 
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path17.dirname(getFilename());
+var getDirname = () => path18.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function copyTemplates(src, dest) {
-  await fs15.copy(src, dest, {
+  await fs14.copy(src, dest, {
     overwrite: true,
     errorOnExist: false
   });
@@ -30,22 +30,22 @@ function applyReplacements(content, replacements) {
 async function replaceInFiles(dir, replacements) {
   const files = await glob("**/*.md", { cwd: dir, absolute: true });
   for (const file of files) {
-    let content = await fs15.readFile(file, "utf-8");
+    let content = await fs14.readFile(file, "utf-8");
     content = applyReplacements(content, replacements);
-    await fs15.writeFile(file, content, "utf-8");
+    await fs14.writeFile(file, content, "utf-8");
   }
   const shFiles = await glob("**/*.sh", { cwd: dir, absolute: true });
   for (const file of shFiles) {
-    let content = await fs15.readFile(file, "utf-8");
+    let content = await fs14.readFile(file, "utf-8");
     content = applyReplacements(content, replacements);
-    await fs15.writeFile(file, content, "utf-8");
+    await fs14.writeFile(file, content, "utf-8");
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path17.dirname(__filename2);
+var __dirname2 = path18.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path17.resolve(__dirname2, "..");
-  return path17.join(rootDir, "templates");
+  const rootDir = path18.resolve(__dirname2, "..");
+  return path18.join(rootDir, "templates");
 }
 
 // src/utils/i18n.ts
@@ -134,6 +134,8 @@ var I18N = {
       "context.checkPolicyHint": "\u2139\uFE0F  \uC0AC\uC6A9\uC790 \uD655\uC778 \uC815\uCC45\uC740 `npx lee-spec-kit docs get agents --json`\uC73C\uB85C \uBA3C\uC800 \uD655\uC778\uD558\uC138\uC694. (git push/merge/merge commit \uD3EC\uD568) [\uD655\uC778 \uD544\uC694]\uAC00 \uC788\uC73C\uBA74 \uC0AC\uC6A9\uC790\uC5D0\uAC8C `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` (\uC608: `A`, `A OK`) \uC751\uB2F5\uC744 \uBC1B\uC740 \uB4A4 \uC9C4\uD589 (config: approval\uB85C \uC870\uC815 \uAC00\uB2A5)",
       "context.actionOptionHint": "\uC2B9\uC778 \uC751\uB2F5 \uD615\uC2DD: `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` (\uC608: `A`, `A OK`)",
       "context.actionExplainHint": "\uC2B9\uC778 \uC694\uCCAD \uC804, \uAC01 \uB77C\uBCA8\uC774 \uBB34\uC5C7\uC744 \uC2E4\uD589/\uBCC0\uACBD\uD558\uB294\uC9C0 \uD55C \uC904 \uC694\uC57D\uACFC \uD568\uAED8 \uC124\uBA85\uD558\uC138\uC694.",
+      "context.finalLabelPrompt": "\uD604\uC7AC \uC120\uD0DD \uAC00\uB2A5\uD55C \uB77C\uBCA8: {labels}. \uB9C8\uC9C0\uB9C9 \uC751\uB2F5\uC740 `<\uB77C\uBCA8>` \uB610\uB294 `<\uB77C\uBCA8> OK` \uD615\uC2DD\uC73C\uB85C \uBC1B\uC73C\uC138\uC694. (\uC608: {example})",
+      "context.finalLabelCommandHint": "\uB77C\uBCA8\uC744 \uBC1B\uC73C\uBA74 \uBC14\uB85C \uC2E4\uD589: {command}",
       "context.readBuiltinDocFirst": "\uBA3C\uC800 \uB0B4\uC7A5 \uBB38\uC11C\uB97C \uD655\uC778\uD558\uC138\uC694: {command}",
       "context.tipDocsCommitRules": "\uCEE4\uBC0B \uBA54\uC2DC\uC9C0 \uADDC\uCE59\uC740 `npx lee-spec-kit docs get git-workflow --json`\uC73C\uB85C \uD655\uC778\uD558\uC138\uC694.",
       "context.list.docsCommitNeeded": "\uBB38\uC11C \uCEE4\uBC0B \uD544\uC694",
@@ -218,6 +220,8 @@ var I18N = {
       "github.optPrMerge": "\uC7AC\uC2DC\uB3C4/\uD5E4\uB4DC \uAC31\uC2E0\uACFC \uD568\uAED8 PR merge \uC218\uD589",
       "github.optPrConfirm": "\uC6D0\uACA9 \uC791\uC5C5(--create/--merge)\uC6A9 \uBA85\uC2DC\uC801 \uC2B9\uC778 \uD1A0\uD070. \uC0AC\uC6A9\uAC12: OK",
       "github.optPrRetry": "merge \uC7AC\uC2DC\uB3C4 \uD69F\uC218 (\uAE30\uBCF8: 3)",
+      "github.optPrScreenshots": "PR \uC2A4\uD06C\uB9B0\uC0F7 \uC139\uC158 \uBAA8\uB4DC (auto|on|off, \uAE30\uBCF8: auto)",
+      "github.optPrMermaid": "PR Mermaid \uC139\uC158 \uBAA8\uB4DC (auto|on|off, \uAE30\uBCF8: auto)",
       "github.optPrNoSyncTasks": "tasks.md PR URL/PR \uC0C1\uD0DC \uB3D9\uAE30\uD654\uB97C \uAC74\uB108\uB700",
       "github.optPrCommitSync": "tasks.md \uB3D9\uAE30\uD654 \uBCC0\uACBD\uC744 \uC790\uB3D9 commit/push",
       "github.invalidRepoComponentMismatch": "`--repo`\uC640 `--component`\uB97C \uD568\uAED8 \uC4F8 \uB54C\uB294 \uAC19\uC740 \uAC12\uC744 \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4.",
@@ -227,6 +231,12 @@ var I18N = {
       "github.ghEmptyJson": "GitHub CLI JSON \uCD9C\uB825\uC774 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.",
       "github.ghInvalidJson": "GitHub CLI JSON \uD30C\uC2F1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4: {snippet}",
       "github.sectionsMissing": "{kind} \uBCF8\uBB38\uC5D0 \uD544\uC218 \uC139\uC158\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {sections}",
+      "github.todoPlaceholdersRemain": "{kind} \uBCF8\uBB38\uC5D0 TODO \uD56D\uBAA9\uC774 \uB0A8\uC544 \uC788\uC2B5\uB2C8\uB2E4. \uBAA9\uD45C/\uC644\uB8CC \uAE30\uC900 \uB4F1\uC744 \uCC44\uC6B4 \uB4A4 \uB2E4\uC2DC \uC2E4\uD589\uD558\uC138\uC694.",
+      "github.artifactModeInvalid": "`--{kind}` \uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {value}. \uD5C8\uC6A9\uAC12: auto,on,off",
+      "github.prScreenshotsSectionMissing": "PR \uBCF8\uBB38\uC5D0 \uD544\uC218 \uC139\uC158\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {section}",
+      "github.prScreenshotImageMissing": "PR \uBCF8\uBB38\uC758 `{section}` \uC139\uC158\uC5D0 \uC774\uBBF8\uC9C0 \uB9C8\uD06C\uB2E4\uC6B4(`![](...)`)\uC744 \uCD94\uAC00\uD558\uC138\uC694.",
+      "github.prMermaidSectionMissing": "PR \uBCF8\uBB38\uC5D0 \uD544\uC218 \uC139\uC158\uC774 \uC5C6\uC2B5\uB2C8\uB2E4: {section}",
+      "github.prMermaidBlockMissing": "PR \uBCF8\uBB38\uC758 `{section}` \uC139\uC158\uC5D0 ```mermaid \uCF54\uB4DC \uBE14\uB85D\uC744 \uCD94\uAC00\uD558\uC138\uC694.",
       "github.docsMissing": "\uAD00\uB828 \uBB38\uC11C \uACBD\uB85C\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4: {paths}",
       "github.noFeatures": "Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.",
       "github.multipleFeaturesMatched": "\uC5EC\uB7EC Feature\uAC00 \uB9E4\uCE6D\uB418\uC5C8\uC2B5\uB2C8\uB2E4. feature \uC774\uB984(slug | F001 | F001-slug)\uC744 \uBA85\uC2DC\uD558\uC138\uC694.",
@@ -383,7 +393,7 @@ var I18N = {
       tasksImprove: "tasks.md\uB97C \uBCF4\uC644\uD558\uACE0 \uBB38\uC11C \uC0C1\uD0DC\uB97C Review\uB85C \uBCC0\uACBD\uD558\uC138\uC694.",
       tasksApproval: "tasks.md \uB0B4\uC6A9\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uACF5\uC720\uD558\uACE0 \uC9C4\uD589 \uC2B9\uC778(`A` \uB610\uB294 `A OK` \uD615\uC2DD)\uC744 \uBC1B\uC73C\uC138\uC694. (\uC2B9\uC778 \uD6C4 \uBB38\uC11C \uC0C1\uD0DC\uB97C Approved\uB85C \uBCC0\uACBD)",
       docsCommitPlanning: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs(planning): {folderName} \uAE30\uD68D \uBB38\uC11C"',
-      issueCreateAndWrite: "`npx lee-spec-kit docs get create-issue --json`\uC73C\uB85C \uC808\uCC28\uB97C \uD655\uC778\uD55C \uB4A4, `npx lee-spec-kit github issue {featureRef} --json`\uC73C\uB85C \uCD08\uC548\uC744 \uC0DD\uC131\uD558\uC138\uC694. TODO\uB97C \uCC44\uC6B0\uACE0 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `--create --confirm OK`\uB85C \uC0DD\uC131\uD55C \uB2E4\uC74C, spec.md/tasks.md\uC758 \uC774\uC288 \uBC88\uD638\uB97C \uCC44\uC6B0\uACE0 \uBB38\uC11C \uCEE4\uBC0B\uC744 \uC900\uBE44\uD558\uC138\uC694.",
+      issueCreateAndWrite: "`npx lee-spec-kit docs get create-issue --json`\uC73C\uB85C \uC808\uCC28\uB97C \uD655\uC778\uD55C \uB4A4, `npx lee-spec-kit github issue {featureRef} --json`\uC73C\uB85C \uCD08\uC548\uC744 \uC0DD\uC131\uD558\uC138\uC694. \uBAA9\uD45C/\uC644\uB8CC \uAE30\uC900\uC744 \uAC80\uD1A0\xB7\uBCF4\uC644\uD558\uACE0 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `--create --confirm OK`\uB85C \uC0DD\uC131\uD55C \uB2E4\uC74C, spec.md/tasks.md\uC758 \uC774\uC288 \uBC88\uD638\uB97C \uCC44\uC6B0\uACE0 \uBB38\uC11C \uCEE4\uBC0B\uC744 \uC900\uBE44\uD558\uC138\uC694.",
       docsCommitIssueUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs(#{issueNumber}): {folderName} \uBB38\uC11C \uC5C5\uB370\uC774\uD2B8"',
       docsCommitUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs: {folderName} \uBB38\uC11C \uC5C5\uB370\uC774\uD2B8"',
       projectCommitIssueUpdate: 'cd "{projectGitCwd}" && git add -A && git commit -m "feat(#{issueNumber}): {folderName} \uAD6C\uD604 \uC5C5\uB370\uC774\uD2B8"',
@@ -400,7 +410,7 @@ var I18N = {
       prePrReviewRun: "PR \uC0DD\uC131 \uC804 \uC0AC\uC804 \uCF54\uB4DC\uB9AC\uBDF0\uB97C \uC9C4\uD589\uD558\uC138\uC694. \uC6B0\uC120\uC21C\uC704 \uC2A4\uD0AC: {skills} (\uC124\uCE58\uB41C \uB354 \uC801\uD569\uD55C \uC2A4\uD0AC\uC774 \uC788\uB2E4\uBA74 \uBA3C\uC800 \uC81C\uC548 \uD6C4 \uC0AC\uC6A9). \uC2A4\uD0AC\uC744 \uC4F8 \uC218 \uC5C6\uC73C\uBA74 `{fallback}` \uC815\uCC45\uC73C\uB85C \uC9C4\uD589\uD558\uACE0 `PR \uC804 \uB9AC\uBDF0`\uB97C Done\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694. Findings \uC815\uCC45: {findingsPolicy}",
       prePrReviewFindingsBlock: "\uC911\uC694 \uC774\uC288\uB294 \uC218\uC815/\uD569\uC758 \uD6C4\uC5D0\uB9CC PR \uC0DD\uC131",
       prePrReviewFindingsWarn: "\uB9AC\uC2A4\uD06C\uB97C \uACF5\uC720\uD558\uBA74 PR \uC0DD\uC131 \uC9C4\uD589 \uAC00\uB2A5",
-      prCreate: "`npx lee-spec-kit docs get create-pr --json`\uC73C\uB85C \uC808\uCC28\uB97C \uD655\uC778\uD55C \uB4A4, `npx lee-spec-kit github pr {featureRef} --json`\uC73C\uB85C \uCD08\uC548\uC744 \uC0DD\uC131\uD558\uC138\uC694. TODO\uB97C \uCC44\uC6B0\uACE0 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `--create --confirm OK`\uB85C \uC0DD\uC131\uD55C \uB2E4\uC74C tasks.md\uC5D0 PR \uB9C1\uD06C\uB97C \uAE30\uB85D\uD558\uC138\uC694.",
+      prCreate: "`npx lee-spec-kit docs get create-pr --json`\uC73C\uB85C \uC808\uCC28\uB97C \uD655\uC778\uD55C \uB4A4, `npx lee-spec-kit github pr {featureRef} --json`\uC73C\uB85C \uCD08\uC548\uC744 \uC0DD\uC131\uD558\uC138\uC694. \uBCC0\uACBD \uC0AC\uD56D/\uD14C\uC2A4\uD2B8 \uC139\uC158\uC744 \uAC80\uD1A0\xB7\uBCF4\uC644\uD558\uACE0 \uC0AC\uC6A9\uC790 \uC2B9\uC778(OK) \uD6C4 `--create --confirm OK`\uB85C \uC0DD\uC131\uD55C \uB2E4\uC74C tasks.md\uC5D0 PR \uB9C1\uD06C\uB97C \uAE30\uB85D\uD558\uC138\uC694.",
       prFillStatus: "tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694. (merge \uD6C4 Approved\uB85C \uC5C5\uB370\uC774\uD2B8)",
       prResolveReview: "\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD574\uACB0\uD558\uACE0 PR \uC0C1\uD0DC\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694. (PR \uC0C1\uD0DC: Review \u2192 Approved)",
       prRequestReview: "\uB9AC\uBDF0\uC5B4\uC5D0\uAC8C \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uACE0 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.",
@@ -500,6 +510,8 @@ var I18N = {
       "context.checkPolicyHint": "\u2139\uFE0F  Check user-approval policy first with `npx lee-spec-kit docs get agents --json` (includes git push/merge and merge commits). If you see [CHECK required], wait for `<label>` or `<label> OK` (e.g. `A`, `A OK`) before proceeding (config: approval can override)",
       "context.actionOptionHint": "Approval reply format: `<label>` or `<label> OK` (e.g. `A`, `A OK`)",
       "context.actionExplainHint": "Before requesting approval, explain what each label will run/change with a one-line summary.",
+      "context.finalLabelPrompt": "Available labels now: {labels}. End with a label request in `<label>` or `<label> OK` format. (e.g. {example})",
+      "context.finalLabelCommandHint": "When a label is provided, run immediately: {command}",
       "context.readBuiltinDocFirst": "Read built-in docs first: {command}",
       "context.tipDocsCommitRules": "Check commit message rules with `npx lee-spec-kit docs get git-workflow --json`.",
       "context.list.docsCommitNeeded": "Commit docs changes",
@@ -584,6 +596,8 @@ var I18N = {
       "github.optPrMerge": "Merge PR with retry and head-branch refresh",
       "github.optPrConfirm": "Explicit user approval token for remote operations (--create/--merge). Use: OK",
       "github.optPrRetry": "Retry count for merge (default: 3)",
+      "github.optPrScreenshots": "PR screenshots section mode (auto|on|off, default: auto)",
+      "github.optPrMermaid": "PR Mermaid section mode (auto|on|off, default: auto)",
       "github.optPrNoSyncTasks": "Do not sync PR URL/PR status into tasks.md",
       "github.optPrCommitSync": "Commit and push tasks.md metadata sync automatically",
       "github.invalidRepoComponentMismatch": "`--repo` and `--component` must reference the same value when both are provided.",
@@ -593,6 +607,12 @@ var I18N = {
       "github.ghEmptyJson": "GitHub CLI returned empty JSON output.",
       "github.ghInvalidJson": "GitHub CLI returned invalid JSON: {snippet}",
       "github.sectionsMissing": "{kind} body is missing required sections: {sections}",
+      "github.todoPlaceholdersRemain": "{kind} body still contains TODO placeholders. Fill goals/completion criteria before creating remotely.",
+      "github.artifactModeInvalid": "Invalid value for `--{kind}`: {value}. Allowed: auto,on,off",
+      "github.prScreenshotsSectionMissing": "PR body is missing required section: {section}",
+      "github.prScreenshotImageMissing": "Add image markdown (`![](...)`) to the `{section}` section in PR body.",
+      "github.prMermaidSectionMissing": "PR body is missing required section: {section}",
+      "github.prMermaidBlockMissing": "Add a ```mermaid code block to the `{section}` section in PR body.",
       "github.docsMissing": "Related document paths do not exist: {paths}",
       "github.noFeatures": "No features found.",
       "github.multipleFeaturesMatched": "Multiple features matched. Specify feature name (slug | F001 | F001-slug).",
@@ -749,7 +769,7 @@ var I18N = {
       tasksImprove: "Improve tasks.md and change Doc Status to Review.",
       tasksApproval: "Share tasks.md with the user and get progress approval (`A` or `A OK` format). (Then set Doc Status to Approved)",
       docsCommitPlanning: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs(planning): {folderName} planning docs"',
-      issueCreateAndWrite: "Review procedure with `npx lee-spec-kit docs get create-issue --json`, then generate a draft via `npx lee-spec-kit github issue {featureRef} --json`. Fill TODOs, get explicit user OK, run `--create --confirm OK`, then update issue number in spec.md/tasks.md and prepare a docs commit.",
+      issueCreateAndWrite: "Review procedure with `npx lee-spec-kit docs get create-issue --json`, then generate a draft via `npx lee-spec-kit github issue {featureRef} --json`. Refine goals/completion criteria, get explicit user OK, run `--create --confirm OK`, then update issue number in spec.md/tasks.md and prepare a docs commit.",
       docsCommitIssueUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs(#{issueNumber}): {folderName} docs update"',
       docsCommitUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs: {folderName} docs update"',
       projectCommitIssueUpdate: 'cd "{projectGitCwd}" && git add -A && git commit -m "feat(#{issueNumber}): {folderName} implementation update"',
@@ -766,7 +786,7 @@ var I18N = {
       prePrReviewRun: "Run a pre-PR code review before creating the PR. Preferred skills: {skills} (if a better installed skill fits this change, propose it first). If no skill can run, use `{fallback}` and set `Pre-PR Review` to Done in tasks.md. Findings policy: {findingsPolicy}",
       prePrReviewFindingsBlock: "major findings must be fixed/aligned before PR creation",
       prePrReviewFindingsWarn: "you may proceed after sharing the risks",
-      prCreate: "Review procedure with `npx lee-spec-kit docs get create-pr --json`, then generate a draft via `npx lee-spec-kit github pr {featureRef} --json`. Fill TODOs, get explicit user OK, run `--create --confirm OK`, then record the PR link in tasks.md.",
+      prCreate: "Review procedure with `npx lee-spec-kit docs get create-pr --json`, then generate a draft via `npx lee-spec-kit github pr {featureRef} --json`. Refine changes/tests sections, get explicit user OK, run `--create --confirm OK`, then record the PR link in tasks.md.",
       prFillStatus: "Set PR Status in tasks.md to Review/Approved. (After merge, update it to Approved.)",
       prResolveReview: "Resolve review comments and update PR Status. (PR Status: Review \u2192 Approved)",
       prRequestReview: "Request review and update PR Status to Review.",
@@ -1183,17 +1203,17 @@ function sleep(ms) {
   return new Promise((resolve) => globalThis.setTimeout(resolve, ms));
 }
 function getDocsLockPath(docsDir) {
-  return path17.join(docsDir, ".lee-spec-kit.lock");
+  return path18.join(docsDir, ".lee-spec-kit.lock");
 }
 function getInitLockPath(targetDir) {
-  return path17.join(
-    path17.dirname(targetDir),
-    `.lee-spec-kit.${path17.basename(targetDir)}.lock`
+  return path18.join(
+    path18.dirname(targetDir),
+    `.lee-spec-kit.${path18.basename(targetDir)}.lock`
   );
 }
 async function isStaleLock(lockPath, staleMs) {
   try {
-    const stat = await fs15.stat(lockPath);
+    const stat = await fs14.stat(lockPath);
     if (Date.now() - stat.mtimeMs <= staleMs) {
       return false;
     }
@@ -1208,7 +1228,7 @@ async function isStaleLock(lockPath, staleMs) {
 }
 async function readLockPayload(lockPath) {
   try {
-    const raw = await fs15.readFile(lockPath, "utf8");
+    const raw = await fs14.readFile(lockPath, "utf8");
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== "object") return null;
     return parsed;
@@ -1230,17 +1250,17 @@ function isProcessAlive(pid) {
   }
 }
 async function tryAcquire(lockPath, owner) {
-  await fs15.ensureDir(path17.dirname(lockPath));
+  await fs14.ensureDir(path18.dirname(lockPath));
   try {
-    const fd = await fs15.open(lockPath, "wx");
+    const fd = await fs14.open(lockPath, "wx");
     const payload = JSON.stringify(
       { pid: process.pid, owner: owner ?? "unknown", createdAt: (/* @__PURE__ */ new Date()).toISOString() },
       null,
       2
     );
-    await fs15.writeFile(fd, `${payload}
+    await fs14.writeFile(fd, `${payload}
 `, { encoding: "utf8" });
-    await fs15.close(fd);
+    await fs14.close(fd);
     return true;
   } catch (error) {
     if (error.code === "EEXIST") {
@@ -1254,9 +1274,9 @@ async function waitForLockRelease(lockPath, options = {}) {
   const pollMs = options.pollMs ?? DEFAULT_POLL_MS;
   const staleMs = options.staleMs ?? DEFAULT_STALE_MS;
   const startedAt = Date.now();
-  while (await fs15.pathExists(lockPath)) {
+  while (await fs14.pathExists(lockPath)) {
     if (await isStaleLock(lockPath, staleMs)) {
-      await fs15.remove(lockPath);
+      await fs14.remove(lockPath);
       break;
     }
     if (Date.now() - startedAt > timeoutMs) {
@@ -1274,7 +1294,7 @@ async function withFileLock(lockPath, task, options = {}) {
     const acquired = await tryAcquire(lockPath, options.owner);
     if (acquired) break;
     if (await isStaleLock(lockPath, staleMs)) {
-      await fs15.remove(lockPath);
+      await fs14.remove(lockPath);
       continue;
     }
     if (Date.now() - startedAt > timeoutMs) {
@@ -1288,7 +1308,7 @@ async function withFileLock(lockPath, task, options = {}) {
   try {
     return await task();
   } finally {
-    await fs15.remove(lockPath).catch(() => {
+    await fs14.remove(lockPath).catch(() => {
     });
   }
 }
@@ -1307,30 +1327,30 @@ var ENGINE_MANAGED_AGENT_FILES = [
   "pr-template.md"
 ];
 var ENGINE_MANAGED_AGENT_DIRS = ["skills"];
-var ENGINE_MANAGED_FEATURE_PATH = path17.join(
+var ENGINE_MANAGED_FEATURE_PATH = path18.join(
   "features",
   "feature-base"
 );
 async function pruneEngineManagedDocs(docsDir) {
   const removed = [];
   for (const file of ENGINE_MANAGED_AGENT_FILES) {
-    const target = path17.join(docsDir, "agents", file);
-    if (await fs15.pathExists(target)) {
-      await fs15.remove(target);
-      removed.push(path17.relative(docsDir, target));
+    const target = path18.join(docsDir, "agents", file);
+    if (await fs14.pathExists(target)) {
+      await fs14.remove(target);
+      removed.push(path18.relative(docsDir, target));
     }
   }
   for (const dir of ENGINE_MANAGED_AGENT_DIRS) {
-    const target = path17.join(docsDir, "agents", dir);
-    if (await fs15.pathExists(target)) {
-      await fs15.remove(target);
-      removed.push(path17.relative(docsDir, target));
+    const target = path18.join(docsDir, "agents", dir);
+    if (await fs14.pathExists(target)) {
+      await fs14.remove(target);
+      removed.push(path18.relative(docsDir, target));
     }
   }
-  const featureBasePath = path17.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
-  if (await fs15.pathExists(featureBasePath)) {
-    await fs15.remove(featureBasePath);
-    removed.push(path17.relative(docsDir, featureBasePath));
+  const featureBasePath = path18.join(docsDir, ENGINE_MANAGED_FEATURE_PATH);
+  if (await fs14.pathExists(featureBasePath)) {
+    await fs14.remove(featureBasePath);
+    removed.push(path18.relative(docsDir, featureBasePath));
   }
   return removed;
 }
@@ -1383,7 +1403,7 @@ ${tr(lang2, "cli", "common.canceled")}`)
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path17.basename(cwd);
+  const defaultName = path18.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let components = parseComponentsOption(options.components);
@@ -1393,7 +1413,7 @@ async function runInit(options) {
   let pushDocs = typeof options.pushDocs === "boolean" ? options.pushDocs : void 0;
   let docsRemote = options.docsRemote;
   let projectRoot;
-  const targetDir = path17.resolve(cwd, options.dir || "./docs");
+  const targetDir = path18.resolve(cwd, options.dir || "./docs");
   const skipPrompts = !!options.yes || !!options.nonInteractive;
   if (options.docsRepo && !["embedded", "standalone"].includes(options.docsRepo)) {
     throw createCliError(
@@ -1711,8 +1731,8 @@ async function runInit(options) {
   await withFileLock(
     initLockPath,
     async () => {
-      if (await fs15.pathExists(targetDir)) {
-        const files = await fs15.readdir(targetDir);
+      if (await fs14.pathExists(targetDir)) {
+        const files = await fs14.readdir(targetDir);
         if (files.length > 0) {
           if (options.force) {
           } else if (options.nonInteractive) {
@@ -1748,28 +1768,28 @@ async function runInit(options) {
       );
       console.log();
       const templatesDir = getTemplatesDir();
-      const commonPath = path17.join(templatesDir, lang, "common");
+      const commonPath = path18.join(templatesDir, lang, "common");
       const templateProjectType = toTemplateProjectType(projectType);
-      const typePath = path17.join(templatesDir, lang, templateProjectType);
-      if (await fs15.pathExists(commonPath)) {
+      const typePath = path18.join(templatesDir, lang, templateProjectType);
+      if (await fs14.pathExists(commonPath)) {
         await copyTemplates(commonPath, targetDir);
       }
-      if (!await fs15.pathExists(typePath)) {
+      if (!await fs14.pathExists(typePath)) {
         throw new Error(
           tr(lang, "cli", "init.error.templateNotFound", { path: typePath })
         );
       }
       await copyTemplates(typePath, targetDir);
       if (projectType === "multi" && !isDefaultFullstackComponents(components)) {
-        const featuresRoot = path17.join(targetDir, "features");
-        await fs15.remove(path17.join(featuresRoot, "fe"));
-        await fs15.remove(path17.join(featuresRoot, "be"));
+        const featuresRoot = path18.join(targetDir, "features");
+        await fs14.remove(path18.join(featuresRoot, "fe"));
+        await fs14.remove(path18.join(featuresRoot, "be"));
         for (const component of components) {
-          const componentDir = path17.join(featuresRoot, component);
-          await fs15.ensureDir(componentDir);
-          const readmePath = path17.join(componentDir, "README.md");
-          if (!await fs15.pathExists(readmePath)) {
-            await fs15.writeFile(
+          const componentDir = path18.join(featuresRoot, component);
+          await fs14.ensureDir(componentDir);
+          const readmePath = path18.join(componentDir, "README.md");
+          if (!await fs14.pathExists(readmePath)) {
+            await fs14.writeFile(
               readmePath,
               `# ${component.toUpperCase()} Features
 
@@ -1818,8 +1838,8 @@ Store ${component} feature specs here.
           config.projectRoot = projectRoot;
         }
       }
-      const configPath = path17.join(targetDir, ".lee-spec-kit.json");
-      await fs15.writeJson(configPath, config, { spaces: 2 });
+      const configPath = path18.join(targetDir, ".lee-spec-kit.json");
+      await fs14.writeJson(configPath, config, { spaces: 2 });
       console.log(chalk6.green(tr(lang, "cli", "init.log.docsCreated")));
       console.log();
       await initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote);
@@ -1887,7 +1907,7 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
       console.log(chalk6.blue(tr(lang, "cli", "init.log.gitInit")));
       runGit(["init"], cwd);
     }
-    const relativePath = path17.relative(cwd, targetDir);
+    const relativePath = path18.relative(cwd, targetDir);
     const stagedBeforeAdd = getCachedStagedFiles(cwd);
     if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
       console.log(
@@ -1944,17 +1964,17 @@ async function initGit(cwd, targetDir, docsRepo, lang, pushDocs, docsRemote) {
 }
 function getAncestorDirs(startDir) {
   const dirs = [];
-  let current = path17.resolve(startDir);
+  let current = path18.resolve(startDir);
   while (true) {
     dirs.push(current);
-    const parent = path17.dirname(current);
+    const parent = path18.dirname(current);
     if (parent === current) break;
     current = parent;
   }
   return dirs;
 }
 function hasWorkspaceBoundary(dir) {
-  return fs15.existsSync(path17.join(dir, "package.json")) || fs15.existsSync(path17.join(dir, ".git"));
+  return fs14.existsSync(path18.join(dir, "package.json")) || fs14.existsSync(path18.join(dir, ".git"));
 }
 function getSearchBaseDirs(cwd) {
   const ancestors = getAncestorDirs(cwd);
@@ -1967,24 +1987,24 @@ function getSearchBaseDirs(cwd) {
 async function getConfig(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const baseDirs = [
-    ...explicitDocsDir ? [path17.resolve(explicitDocsDir)] : [],
+    ...explicitDocsDir ? [path18.resolve(explicitDocsDir)] : [],
     ...getSearchBaseDirs(cwd)
   ];
   const visitedBaseDirs = /* @__PURE__ */ new Set();
   const visitedDocsDirs = /* @__PURE__ */ new Set();
   for (const baseDir of baseDirs) {
-    const resolvedBaseDir = path17.resolve(baseDir);
+    const resolvedBaseDir = path18.resolve(baseDir);
     if (visitedBaseDirs.has(resolvedBaseDir)) continue;
     visitedBaseDirs.add(resolvedBaseDir);
-    const possibleDocsDirs = [path17.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    const possibleDocsDirs = [path18.join(resolvedBaseDir, "docs"), resolvedBaseDir];
     for (const docsDir of possibleDocsDirs) {
-      const resolvedDocsDir = path17.resolve(docsDir);
+      const resolvedDocsDir = path18.resolve(docsDir);
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
-      const configPath = path17.join(resolvedDocsDir, ".lee-spec-kit.json");
-      if (await fs15.pathExists(configPath)) {
+      const configPath = path18.join(resolvedDocsDir, ".lee-spec-kit.json");
+      if (await fs14.pathExists(configPath)) {
         try {
-          const configFile = await fs15.readJson(configPath);
+          const configFile = await fs14.readJson(configPath);
           const projectType = normalizeProjectType(configFile.projectType);
           const components = resolveProjectComponents(
             projectType,
@@ -2007,22 +2027,22 @@ async function getConfig(cwd) {
         } catch {
         }
       }
-      const agentsPath = path17.join(resolvedDocsDir, "agents");
-      const featuresPath = path17.join(resolvedDocsDir, "features");
-      if (await fs15.pathExists(agentsPath) && await fs15.pathExists(featuresPath)) {
-        const bePath = path17.join(featuresPath, "be");
-        const fePath = path17.join(featuresPath, "fe");
-        const projectType = await fs15.pathExists(bePath) || await fs15.pathExists(fePath) ? "multi" : "single";
+      const agentsPath = path18.join(resolvedDocsDir, "agents");
+      const featuresPath = path18.join(resolvedDocsDir, "features");
+      if (await fs14.pathExists(agentsPath) && await fs14.pathExists(featuresPath)) {
+        const bePath = path18.join(featuresPath, "be");
+        const fePath = path18.join(featuresPath, "fe");
+        const projectType = await fs14.pathExists(bePath) || await fs14.pathExists(fePath) ? "multi" : "single";
         const components = projectType === "multi" ? resolveProjectComponents("multi", ["fe", "be"]) : void 0;
         const langProbeCandidates = [
-          path17.join(agentsPath, "custom.md"),
-          path17.join(agentsPath, "constitution.md"),
-          path17.join(agentsPath, "agents.md")
+          path18.join(agentsPath, "custom.md"),
+          path18.join(agentsPath, "constitution.md"),
+          path18.join(agentsPath, "agents.md")
         ];
         let lang = "en";
         for (const candidate of langProbeCandidates) {
-          if (!await fs15.pathExists(candidate)) continue;
-          const content = await fs15.readFile(candidate, "utf-8");
+          if (!await fs14.pathExists(candidate)) continue;
+          const content = await fs14.readFile(candidate, "utf-8");
           if (/[가-힣]/.test(content)) {
             lang = "ko";
             break;
@@ -2068,14 +2088,14 @@ function sanitizeTasksForLocal(content, lang) {
   return normalizeTrailingBlankLines(next);
 }
 async function patchMarkdownIfExists(filePath, transform) {
-  if (!await fs15.pathExists(filePath)) return;
-  const content = await fs15.readFile(filePath, "utf-8");
-  await fs15.writeFile(filePath, transform(content), "utf-8");
+  if (!await fs14.pathExists(filePath)) return;
+  const content = await fs14.readFile(filePath, "utf-8");
+  await fs14.writeFile(filePath, transform(content), "utf-8");
 }
 async function applyLocalWorkflowTemplateToFeatureDir(featureDir, lang) {
-  await patchMarkdownIfExists(path17.join(featureDir, "spec.md"), sanitizeSpecForLocal);
+  await patchMarkdownIfExists(path18.join(featureDir, "spec.md"), sanitizeSpecForLocal);
   await patchMarkdownIfExists(
-    path17.join(featureDir, "tasks.md"),
+    path18.join(featureDir, "tasks.md"),
     (content) => sanitizeTasksForLocal(content, lang)
   );
 }
@@ -2225,29 +2245,29 @@ async function runFeature(name, options) {
       }
       let featuresDir;
       if (projectType === "multi") {
-        featuresDir = path17.join(docsDir, "features", component);
+        featuresDir = path18.join(docsDir, "features", component);
       } else {
-        featuresDir = path17.join(docsDir, "features");
+        featuresDir = path18.join(docsDir, "features");
       }
       const featureFolderName = `${featureId}-${name}`;
-      const featureDir = path17.join(featuresDir, featureFolderName);
-      if (await fs15.pathExists(featureDir)) {
+      const featureDir = path18.join(featuresDir, featureFolderName);
+      if (await fs14.pathExists(featureDir)) {
         throw createCliError(
           "INVALID_ARGUMENT",
           tr(lang, "cli", "feature.folderExists", { path: featureDir })
         );
       }
-      const featureBasePath = path17.join(
+      const featureBasePath = path18.join(
         getTemplatesDir(),
         lang,
         toTemplateProjectType(projectType),
         "features",
         "feature-base"
       );
-      if (!await fs15.pathExists(featureBasePath)) {
+      if (!await fs14.pathExists(featureBasePath)) {
         throw createCliError("DOCS_NOT_FOUND", tr(lang, "cli", "feature.baseNotFound"));
       }
-      await fs15.copy(featureBasePath, featureDir);
+      await fs14.copy(featureBasePath, featureDir);
       const idNumber = featureId.replace("F", "");
       const repoName = projectType === "multi" ? `{{projectName}}-${component}` : "{{projectName}}";
       const replacements = {
@@ -2294,7 +2314,7 @@ async function runFeature(name, options) {
         featureName: name,
         component: projectType === "multi" ? component : void 0,
         featurePath: featureDir,
-        featurePathFromDocs: path17.relative(docsDir, featureDir)
+        featurePathFromDocs: path18.relative(docsDir, featureDir)
       };
     },
     { owner: "feature" }
@@ -2306,9 +2326,9 @@ function sleep2(ms) {
 async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
   const candidates = [
-    ...explicitDocsDir ? [path17.resolve(explicitDocsDir)] : [],
-    path17.resolve(cwd, "docs"),
-    path17.resolve(cwd)
+    ...explicitDocsDir ? [path18.resolve(explicitDocsDir)] : [],
+    path18.resolve(cwd, "docs"),
+    path18.resolve(cwd)
   ];
   const endAt = Date.now() + timeoutMs;
   while (Date.now() < endAt) {
@@ -2319,7 +2339,7 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
       const initLockPath = getInitLockPath(dir);
       const docsLockPath = getDocsLockPath(dir);
       for (const lockPath of [initLockPath, docsLockPath]) {
-        if (await fs15.pathExists(lockPath)) {
+        if (await fs14.pathExists(lockPath)) {
           sawLock = true;
           await waitForLockRelease(lockPath, {
             timeoutMs: Math.max(200, endAt - Date.now()),
@@ -2335,17 +2355,17 @@ async function waitForConfigAfterInit(cwd, timeoutMs = 8e3) {
   return getConfig(cwd);
 }
 async function getNextFeatureId(docsDir, projectType, components) {
-  const featuresDir = path17.join(docsDir, "features");
+  const featuresDir = path18.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "multi") {
-    scanDirs.push(...components.map((component) => path17.join(featuresDir, component)));
+    scanDirs.push(...components.map((component) => path18.join(featuresDir, component)));
   } else {
     scanDirs.push(featuresDir);
   }
   for (const dir of scanDirs) {
-    if (!await fs15.pathExists(dir)) continue;
-    const entries = await fs15.readdir(dir, { withFileTypes: true });
+    if (!await fs14.pathExists(dir)) continue;
+    const entries = await fs14.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       const match = entry.name.match(/^F(\d+)-/);
@@ -3113,6 +3133,59 @@ function getGitStatusPorcelain(cwd, relativePaths) {
     return void 0;
   }
 }
+function normalizeInputPath(value) {
+  return value.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/\/+$/, "");
+}
+function toUniqueNormalizedPaths(relativePaths) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const value of relativePaths) {
+    const normalized = normalizeInputPath(value);
+    if (!normalized) continue;
+    if (seen.has(normalized)) continue;
+    seen.add(normalized);
+    out.push(normalized);
+  }
+  return out;
+}
+function getTrackedGitPaths(cwd, relativePaths) {
+  const inputs = toUniqueNormalizedPaths(relativePaths);
+  if (inputs.length === 0) return /* @__PURE__ */ new Set();
+  try {
+    const out = execFileSync("git", ["ls-files", "--", ...inputs], {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    return new Set(
+      out.split("\n").map((line) => normalizeInputPath(line)).filter(Boolean)
+    );
+  } catch {
+    return void 0;
+  }
+}
+function getIgnoredGitPaths(cwd, relativePaths) {
+  const inputs = toUniqueNormalizedPaths(relativePaths);
+  if (inputs.length === 0) return /* @__PURE__ */ new Set();
+  try {
+    const out = execFileSync("git", ["check-ignore", "--stdin"], {
+      cwd,
+      encoding: "utf-8",
+      input: `${inputs.join("\n")}
+`,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    return new Set(
+      out.split("\n").map((line) => normalizeInputPath(line)).filter(Boolean)
+    );
+  } catch (error) {
+    if (error && typeof error === "object" && "status" in error) {
+      const status = error.status;
+      if (status === 1) return /* @__PURE__ */ new Set();
+    }
+    return void 0;
+  }
+}
 function getLastCommitForPath(cwd, relativePath) {
   try {
     const out = execSync(`git rev-list -n 1 HEAD -- "${relativePath}"`, {
@@ -3260,13 +3333,13 @@ function parsePrLink(value) {
   return trimmed;
 }
 function normalizeGitPath(value) {
-  return value.split(path17.sep).join("/");
+  return value.split(path18.sep).join("/");
 }
 function resolveProjectStatusPaths(projectGitCwd, docsDir) {
-  const relativeDocsDir = path17.relative(projectGitCwd, docsDir);
+  const relativeDocsDir = path18.relative(projectGitCwd, docsDir);
   if (!relativeDocsDir) return [];
-  if (path17.isAbsolute(relativeDocsDir)) return [];
-  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path17.sep}`)) {
+  if (path18.isAbsolute(relativeDocsDir)) return [];
+  if (relativeDocsDir === ".." || relativeDocsDir.startsWith(`..${path18.sep}`)) {
     return [];
   }
   const normalizedDocsDir = normalizeGitPath(relativeDocsDir).replace(/\/+$/, "");
@@ -3285,6 +3358,8 @@ function uniqueNormalizedPaths(values) {
   }
   return out;
 }
+var PROJECT_DIRTY_STATUS_CACHE = /* @__PURE__ */ new Map();
+var COMPONENT_STATUS_PATH_CACHE = /* @__PURE__ */ new Map();
 async function resolveComponentStatusPaths(projectGitCwd, component, workflow) {
   const configured = workflow?.componentPaths?.[component];
   const configuredCandidates = Array.isArray(configured) ? configured.map((value) => String(value).trim()).filter(Boolean) : [];
@@ -3298,19 +3373,27 @@ async function resolveComponentStatusPaths(projectGitCwd, component, workflow) {
   const normalizedCandidates = uniqueNormalizedPaths(
     candidates.map((candidate) => {
       if (!candidate) return "";
-      if (!path17.isAbsolute(candidate)) return candidate;
-      const relative = path17.relative(projectGitCwd, candidate);
+      if (!path18.isAbsolute(candidate)) return candidate;
+      const relative = path18.relative(projectGitCwd, candidate);
       if (!relative) return "";
-      if (relative === ".." || relative.startsWith(`..${path17.sep}`)) return "";
+      if (relative === ".." || relative.startsWith(`..${path18.sep}`)) return "";
       return relative;
     }).filter(Boolean)
   );
+  const cacheKey = JSON.stringify({
+    projectGitCwd,
+    component,
+    normalizedCandidates
+  });
+  const cached = COMPONENT_STATUS_PATH_CACHE.get(cacheKey);
+  if (cached) return [...cached];
   const existing = [];
   for (const candidate of normalizedCandidates) {
-    if (await fs15.pathExists(path17.join(projectGitCwd, candidate))) {
+    if (await fs14.pathExists(path18.join(projectGitCwd, candidate))) {
       existing.push(candidate);
     }
   }
+  COMPONENT_STATUS_PATH_CACHE.set(cacheKey, [...existing]);
   return existing;
 }
 function parseTasks(content) {
@@ -3370,31 +3453,31 @@ async function parseFeature(featurePath, type, context, options) {
   const lang = options.lang;
   const workflowPolicy = resolveWorkflowPolicy(options.workflow);
   const prePrReviewPolicy = resolvePrePrReviewPolicy(options.workflow);
-  const folderName = path17.basename(featurePath);
+  const folderName = path18.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
   const slug = match?.[2] || folderName;
-  const specPath = path17.join(featurePath, "spec.md");
-  const planPath = path17.join(featurePath, "plan.md");
-  const tasksPath = path17.join(featurePath, "tasks.md");
+  const specPath = path18.join(featurePath, "spec.md");
+  const planPath = path18.join(featurePath, "plan.md");
+  const tasksPath = path18.join(featurePath, "tasks.md");
   let specStatus;
   let issueNumber;
-  const specExists = await fs15.pathExists(specPath);
+  const specExists = await fs14.pathExists(specPath);
   if (specExists) {
-    const content = await fs15.readFile(specPath, "utf-8");
+    const content = await fs14.readFile(specPath, "utf-8");
     const statusValue = extractFirstSpecValue(content, ["\uC0C1\uD0DC", "Status"]);
     specStatus = parseDocStatus(statusValue);
     const issueValue = extractFirstSpecValue(content, ["\uC774\uC288 \uBC88\uD638", "Issue Number", "Issue"]);
     issueNumber = parseIssueNumber(issueValue);
   }
   let planStatus;
-  const planExists = await fs15.pathExists(planPath);
+  const planExists = await fs14.pathExists(planPath);
   if (planExists) {
-    const content = await fs15.readFile(planPath, "utf-8");
+    const content = await fs14.readFile(planPath, "utf-8");
     const statusValue = extractFirstSpecValue(content, ["\uC0C1\uD0DC", "Status"]);
     planStatus = parseDocStatus(statusValue);
   }
-  const tasksExists = await fs15.pathExists(tasksPath);
+  const tasksExists = await fs14.pathExists(tasksPath);
   const tasksSummary = { total: 0, todo: 0, doing: 0, done: 0 };
   let activeTask;
   let nextTodoTask;
@@ -3408,7 +3491,7 @@ async function parseFeature(featurePath, type, context, options) {
   let prStatusFieldExists = false;
   let prePrReviewFieldExists = false;
   if (tasksExists) {
-    const content = await fs15.readFile(tasksPath, "utf-8");
+    const content = await fs14.readFile(tasksPath, "utf-8");
     const { summary, activeTask: active, nextTodoTask: nextTodo } = parseTasks(content);
     tasksSummary.total = summary.total;
     tasksSummary.todo = summary.todo;
@@ -3450,44 +3533,77 @@ async function parseFeature(featurePath, type, context, options) {
     slug,
     folderName
   );
-  const relativeFeaturePathFromDocs = path17.relative(context.docsDir, featurePath);
-  const docsPathIgnored = isGitPathIgnored(
-    context.docsGitCwd,
-    relativeFeaturePathFromDocs
-  );
-  const docsStatus = getGitStatusPorcelain(context.docsGitCwd, [relativeFeaturePathFromDocs]);
-  const docsHasUncommittedChanges = docsStatus === void 0 ? true : docsStatus.trim().length > 0;
-  const dirtyScopePolicy = resolveCodeDirtyScopePolicy(options.workflow, options.projectType);
-  let projectStatusPaths = [];
-  if (context.projectGitCwd) {
-    if (dirtyScopePolicy === "component" && type !== "single") {
-      const componentStatusPaths = await resolveComponentStatusPaths(
-        context.projectGitCwd,
-        type,
-        options.workflow
-      );
-      projectStatusPaths = componentStatusPaths.length > 0 ? componentStatusPaths : resolveProjectStatusPaths(context.projectGitCwd, context.docsDir);
+  const relativeFeaturePathFromDocs = path18.relative(context.docsDir, featurePath);
+  const normalizedFeaturePathFromDocs = normalizeGitPath(relativeFeaturePathFromDocs);
+  const docsPathIgnored = typeof context.docsPathIgnored === "boolean" ? context.docsPathIgnored : isGitPathIgnored(context.docsGitCwd, normalizedFeaturePathFromDocs);
+  let docsHasUncommittedChanges = typeof context.docsHasUncommittedChanges === "boolean" ? context.docsHasUncommittedChanges : false;
+  let docsEverCommitted = typeof context.docsEverCommitted === "boolean" ? context.docsEverCommitted : false;
+  let docsGitUnavailable = !!context.docsGitUnavailable;
+  if (typeof context.docsHasUncommittedChanges !== "boolean") {
+    const docsStatus = getGitStatusPorcelain(context.docsGitCwd, [normalizedFeaturePathFromDocs]);
+    if (docsStatus === void 0) {
+      docsGitUnavailable = true;
+      docsHasUncommittedChanges = true;
     } else {
-      projectStatusPaths = resolveProjectStatusPaths(
+      docsHasUncommittedChanges = docsStatus.trim().length > 0;
+    }
+  }
+  if (typeof context.docsEverCommitted !== "boolean") {
+    const docsLastCommit = getLastCommitForPath(
+      context.docsGitCwd,
+      normalizedFeaturePathFromDocs
+    );
+    docsEverCommitted = !!docsLastCommit;
+  }
+  let projectHasUncommittedChanges = typeof context.projectHasUncommittedChanges === "boolean" ? context.projectHasUncommittedChanges : false;
+  let projectStatusUnavailable = !!context.projectStatusUnavailable;
+  if (typeof context.projectHasUncommittedChanges !== "boolean" && context.projectGitCwd) {
+    const dirtyScopePolicy = resolveCodeDirtyScopePolicy(options.workflow, options.projectType);
+    const projectCacheKey = JSON.stringify({
+      projectGitCwd: context.projectGitCwd,
+      docsDir: context.docsDir,
+      type,
+      dirtyScopePolicy,
+      componentPaths: options.workflow?.componentPaths?.[type] || []
+    });
+    const cachedStatus = PROJECT_DIRTY_STATUS_CACHE.get(projectCacheKey);
+    if (cachedStatus) {
+      projectHasUncommittedChanges = cachedStatus.hasUncommittedChanges;
+      projectStatusUnavailable = cachedStatus.statusUnavailable;
+    } else {
+      let projectStatusPaths = [];
+      if (dirtyScopePolicy === "component" && type !== "single") {
+        const componentStatusPaths = await resolveComponentStatusPaths(
+          context.projectGitCwd,
+          type,
+          options.workflow
+        );
+        projectStatusPaths = componentStatusPaths.length > 0 ? componentStatusPaths : resolveProjectStatusPaths(context.projectGitCwd, context.docsDir);
+      } else {
+        projectStatusPaths = resolveProjectStatusPaths(
+          context.projectGitCwd,
+          context.docsDir
+        );
+      }
+      const projectStatus = getGitStatusPorcelain(
         context.projectGitCwd,
-        context.docsDir
+        projectStatusPaths
       );
+      projectStatusUnavailable = projectStatus === void 0;
+      projectHasUncommittedChanges = projectStatus === void 0 ? false : projectStatus.trim().length > 0;
+      PROJECT_DIRTY_STATUS_CACHE.set(projectCacheKey, {
+        hasUncommittedChanges: projectHasUncommittedChanges,
+        statusUnavailable: projectStatusUnavailable
+      });
     }
   }
-  const projectStatus = context.projectGitCwd ? getGitStatusPorcelain(context.projectGitCwd, projectStatusPaths) : void 0;
-  const projectHasUncommittedChanges = projectStatus === void 0 ? false : projectStatus.trim().length > 0;
-  const docsLastCommit = getLastCommitForPath(
-    context.docsGitCwd,
-    relativeFeaturePathFromDocs
-  );
-  const docsEverCommitted = !!docsLastCommit;
-  if (docsStatus === void 0) {
+  if (docsGitUnavailable) {
     warnings.push(tr(lang, "warnings", "docsGitUnavailable"));
   }
   if (docsPathIgnored === true) {
     warnings.push(
       tr(lang, "warnings", "docsPathIgnored", {
-        path: relativeFeaturePathFromDocs
+        path: normalizedFeaturePathFromDocs
       })
     );
   }
@@ -3592,90 +3708,181 @@ async function parseFeature(featurePath, type, context, options) {
   );
   return { ...featureState, currentStep, actions, nextAction, warnings };
 }
+function normalizeRelPath(value) {
+  return value.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/\/+$/, "");
+}
+function parsePorcelainChangedPaths(porcelain) {
+  const changed = [];
+  for (const rawLine of porcelain.split("\n")) {
+    if (!rawLine.trim()) continue;
+    const payload = rawLine.slice(3).trim();
+    if (!payload) continue;
+    const pathCandidate = payload.includes(" -> ") ? payload.split(" -> ").at(-1) || "" : payload;
+    const normalized = normalizeRelPath(pathCandidate.replace(/^"+|"+$/g, ""));
+    if (!normalized) continue;
+    changed.push(normalized);
+  }
+  return changed;
+}
+function findFeaturePathPrefix(normalizedPath, relativeFeaturePaths) {
+  for (const featurePath of relativeFeaturePaths) {
+    if (normalizedPath === featurePath) return featurePath;
+    if (normalizedPath.startsWith(`${featurePath}/`)) return featurePath;
+    const nestedPrefix = `/${featurePath}`;
+    if (normalizedPath.endsWith(nestedPrefix)) return featurePath;
+    if (normalizedPath.includes(`${nestedPrefix}/`)) return featurePath;
+  }
+  return void 0;
+}
+function buildDefaultDocsFeatureGitMeta(relativeFeaturePaths) {
+  const map = /* @__PURE__ */ new Map();
+  for (const featurePath of relativeFeaturePaths) {
+    map.set(featurePath, {
+      docsPathIgnored: false,
+      docsHasUncommittedChanges: false,
+      docsEverCommitted: false,
+      docsGitUnavailable: false
+    });
+  }
+  return map;
+}
+function buildDocsFeatureGitMeta(docsGitCwd, relativeFeaturePaths) {
+  const normalizedFeaturePaths = relativeFeaturePaths.map(
+    (value) => normalizeRelPath(value)
+  );
+  const map = buildDefaultDocsFeatureGitMeta(normalizedFeaturePaths);
+  if (normalizedFeaturePaths.length === 0) return map;
+  const docsStatus = getGitStatusPorcelain(docsGitCwd, normalizedFeaturePaths);
+  if (docsStatus === void 0) {
+    for (const featurePath of normalizedFeaturePaths) {
+      const current = map.get(featurePath);
+      if (!current) continue;
+      current.docsGitUnavailable = true;
+      current.docsHasUncommittedChanges = true;
+    }
+  } else {
+    const changedPaths = parsePorcelainChangedPaths(docsStatus);
+    for (const changedPath of changedPaths) {
+      const featurePath = findFeaturePathPrefix(changedPath, normalizedFeaturePaths);
+      if (!featurePath) continue;
+      const current = map.get(featurePath);
+      if (!current) continue;
+      current.docsHasUncommittedChanges = true;
+    }
+  }
+  const trackedPaths = getTrackedGitPaths(docsGitCwd, normalizedFeaturePaths);
+  if (trackedPaths) {
+    for (const trackedPath of trackedPaths) {
+      const featurePath = findFeaturePathPrefix(
+        normalizeRelPath(trackedPath),
+        normalizedFeaturePaths
+      );
+      if (!featurePath) continue;
+      const current = map.get(featurePath);
+      if (!current) continue;
+      current.docsEverCommitted = true;
+    }
+  }
+  const ignoredPaths = getIgnoredGitPaths(docsGitCwd, normalizedFeaturePaths);
+  if (ignoredPaths) {
+    for (const ignoredPath of ignoredPaths) {
+      const featurePath = findFeaturePathPrefix(
+        normalizeRelPath(ignoredPath),
+        normalizedFeaturePaths
+      );
+      if (!featurePath) continue;
+      const current = map.get(featurePath);
+      if (!current) continue;
+      current.docsPathIgnored = true;
+    }
+  }
+  return map;
+}
 async function scanFeatures(config) {
   const features = [];
   const warnings = [];
   const stepDefinitions = getStepDefinitions(config.lang, config.workflow);
   const docsBranch = getCurrentBranch(config.docsDir);
   const projectBranches = {};
+  const projectGitCwds = {};
   let singleProject;
   if (config.projectType === "single") {
     singleProject = resolveProjectGitCwd(config, "single", config.lang);
     if (singleProject.warning) warnings.push(singleProject.warning);
     projectBranches.single = singleProject.cwd ? getCurrentBranch(singleProject.cwd) : "";
+    projectGitCwds.single = singleProject.cwd ?? void 0;
   } else {
     const components = resolveProjectComponents(config.projectType, config.components);
     for (const component of components) {
       const project = resolveProjectGitCwd(config, component, config.lang);
       if (project.warning) warnings.push(project.warning);
       projectBranches[component] = project.cwd ? getCurrentBranch(project.cwd) : "";
+      projectGitCwds[component] = project.cwd ?? void 0;
     }
   }
+  const allFeatureDirs = [];
+  const componentFeatureDirs = /* @__PURE__ */ new Map();
   if (config.projectType === "single") {
     const featureDirs = await glob("features/*/", {
       cwd: config.docsDir,
       absolute: true,
       ignore: ["**/feature-base/**"]
     });
-    for (const dir of featureDirs) {
-      if ((await fs15.stat(dir)).isDirectory()) {
-        features.push(
-          await parseFeature(
-            dir,
-            "single",
-            {
-              projectBranch: projectBranches.single,
-              docsBranch,
-              docsGitCwd: config.docsDir,
-              projectGitCwd: singleProject?.cwd ?? void 0,
-              docsDir: config.docsDir,
-              projectBranchAvailable: Boolean(singleProject?.cwd)
-            },
-            {
-              lang: config.lang,
-              stepDefinitions,
-              approval: config.approval,
-              workflow: config.workflow,
-              projectType: config.projectType
-            }
-          )
-        );
-      }
-    }
+    componentFeatureDirs.set("single", featureDirs);
+    allFeatureDirs.push(...featureDirs);
   } else {
     const components = resolveProjectComponents(config.projectType, config.components);
     for (const component of components) {
-      const project = resolveProjectGitCwd(config, component, config.lang);
       const componentDirs = await glob(`features/${component}/*/`, {
         cwd: config.docsDir,
         absolute: true
       });
-      for (const dir of componentDirs) {
-        if (!(await fs15.stat(dir)).isDirectory()) continue;
-        features.push(
-          await parseFeature(
-            dir,
-            component,
-            {
-              projectBranch: projectBranches[component] || "",
-              docsBranch,
-              docsGitCwd: config.docsDir,
-              projectGitCwd: project.cwd ?? void 0,
-              docsDir: config.docsDir,
-              projectBranchAvailable: Boolean(project.cwd)
-            },
-            {
-              lang: config.lang,
-              stepDefinitions,
-              approval: config.approval,
-              workflow: config.workflow,
-              projectType: config.projectType
-            }
-          )
-        );
-      }
+      componentFeatureDirs.set(component, componentDirs);
+      allFeatureDirs.push(...componentDirs);
     }
   }
+  const relativeFeaturePaths = allFeatureDirs.map(
+    (dir) => normalizeRelPath(path18.relative(config.docsDir, dir))
+  );
+  const docsGitMeta = buildDocsFeatureGitMeta(config.docsDir, relativeFeaturePaths);
+  const parseTargets = config.projectType === "single" ? [{ type: "single", dirs: componentFeatureDirs.get("single") || [] }] : resolveProjectComponents(config.projectType, config.components).map((component) => ({
+    type: component,
+    dirs: componentFeatureDirs.get(component) || []
+  }));
+  for (const target of parseTargets) {
+    const parsed = await Promise.all(
+      target.dirs.map(async (dir) => {
+        const relativeFeaturePathFromDocs = normalizeRelPath(
+          path18.relative(config.docsDir, dir)
+        );
+        const docsMeta = docsGitMeta.get(relativeFeaturePathFromDocs);
+        return parseFeature(
+          dir,
+          target.type,
+          {
+            projectBranch: projectBranches[target.type] || "",
+            docsBranch,
+            docsGitCwd: config.docsDir,
+            projectGitCwd: projectGitCwds[target.type],
+            docsDir: config.docsDir,
+            projectBranchAvailable: Boolean(projectGitCwds[target.type]),
+            docsPathIgnored: docsMeta?.docsPathIgnored,
+            docsHasUncommittedChanges: docsMeta?.docsHasUncommittedChanges,
+            docsEverCommitted: docsMeta?.docsEverCommitted,
+            docsGitUnavailable: docsMeta?.docsGitUnavailable
+          },
+          {
+            lang: config.lang,
+            stepDefinitions,
+            approval: config.approval,
+            workflow: config.workflow,
+            projectType: config.projectType
+          }
+        );
+      })
+    );
+    features.push(...parsed);
+  }
   return {
     features,
     branches: {
@@ -3715,13 +3922,13 @@ async function runStatus(options) {
     );
   }
   const { docsDir, projectType, projectName, lang } = config;
-  const featuresDir = path17.join(docsDir, "features");
+  const featuresDir = path18.join(docsDir, "features");
   const scan = await scanFeatures(config);
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   for (const f of scan.features) {
     const id = f.id || "UNKNOWN";
-    const relPath = path17.relative(docsDir, f.path);
+    const relPath = path18.relative(docsDir, f.path);
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(relPath);
     if (!f.docs.specExists || !f.docs.tasksExists) continue;
@@ -3802,7 +4009,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path17.join(featuresDir, "status.md");
+    const outputPath = path18.join(featuresDir, "status.md");
     const date = getLocalDateString();
     const content = [
       "# Feature Status",
@@ -3817,7 +4024,7 @@ async function runStatus(options) {
       ),
       ""
     ].join("\n");
-    await fs15.writeFile(outputPath, content, "utf-8");
+    await fs14.writeFile(outputPath, content, "utf-8");
     console.log(
       chalk6.green(
         tr(lang, "cli", "status.wrote", { path: outputPath })
@@ -3830,9 +4037,9 @@ function escapeRegExp2(value) {
 }
 async function getFeatureNameFromSpec(featureDir, fallbackSlug, fallbackFolderName) {
   try {
-    const specPath = path17.join(featureDir, "spec.md");
-    if (!await fs15.pathExists(specPath)) return fallbackSlug;
-    const content = await fs15.readFile(specPath, "utf-8");
+    const specPath = path18.join(featureDir, "spec.md");
+    if (!await fs14.pathExists(specPath)) return fallbackSlug;
+    const content = await fs14.readFile(specPath, "utf-8");
     const keys = ["\uAE30\uB2A5\uBA85", "Feature Name"];
     for (const key of keys) {
       const regex = new RegExp(
@@ -3911,17 +4118,17 @@ async function runUpdate(options) {
           console.log(chalk6.blue(tr(lang, "cli", "update.updatingAgents")));
         }
         if (agentsMode === "all") {
-          const commonAgentsBase = path17.join(templatesDir, lang, "common", "agents");
-          const typeAgentsBase = path17.join(
+          const commonAgentsBase = path18.join(templatesDir, lang, "common", "agents");
+          const typeAgentsBase = path18.join(
             templatesDir,
             lang,
             toTemplateProjectType(projectType),
             "agents"
           );
-          const targetAgentsBase = path17.join(docsDir, "agents");
-          const commonAgents = agentsMode === "skills" ? path17.join(commonAgentsBase, "skills") : commonAgentsBase;
-          const typeAgents = agentsMode === "skills" ? path17.join(typeAgentsBase, "skills") : typeAgentsBase;
-          const targetAgents = agentsMode === "skills" ? path17.join(targetAgentsBase, "skills") : targetAgentsBase;
+          const targetAgentsBase = path18.join(docsDir, "agents");
+          const commonAgents = agentsMode === "skills" ? path18.join(commonAgentsBase, "skills") : commonAgentsBase;
+          const typeAgents = agentsMode === "skills" ? path18.join(typeAgentsBase, "skills") : typeAgentsBase;
+          const targetAgents = agentsMode === "skills" ? path18.join(targetAgentsBase, "skills") : targetAgentsBase;
           const featurePath = projectType === "multi" ? isDefaultFullstackComponents(config.components || []) ? "docs/features/{be|fe}" : "docs/features/{component}" : "docs/features";
           const projectName = config.projectName ?? "{{projectName}}";
           const commonReplacements = {
@@ -3931,7 +4138,7 @@ async function runUpdate(options) {
           const typeReplacements = {
             "{{projectName}}": projectName
           };
-          if (await fs15.pathExists(commonAgents)) {
+          if (await fs14.pathExists(commonAgents)) {
             const count = await updateFolder(
               commonAgents,
               targetAgents,
@@ -3949,7 +4156,7 @@ async function runUpdate(options) {
             );
             updatedCount += count;
           }
-          if (await fs15.pathExists(typeAgents)) {
+          if (await fs14.pathExists(typeAgents)) {
             const count = await updateFolder(
               typeAgents,
               targetAgents,
@@ -3999,24 +4206,24 @@ async function runUpdate(options) {
 async function updateFolder(sourceDir, targetDir, force, replacements, lang = DEFAULT_LANG, options = {}) {
   const protectedFiles = options.protectedFiles ?? /* @__PURE__ */ new Set(["custom.md", "constitution.md"]);
   const skipDirectories = options.skipDirectories ?? /* @__PURE__ */ new Set();
-  await fs15.ensureDir(targetDir);
-  const files = await fs15.readdir(sourceDir);
+  await fs14.ensureDir(targetDir);
+  const files = await fs14.readdir(sourceDir);
   let updatedCount = 0;
   for (const file of files) {
-    const sourcePath = path17.join(sourceDir, file);
-    const targetPath = path17.join(targetDir, file);
-    const stat = await fs15.stat(sourcePath);
+    const sourcePath = path18.join(sourceDir, file);
+    const targetPath = path18.join(targetDir, file);
+    const stat = await fs14.stat(sourcePath);
     if (stat.isFile()) {
       if (protectedFiles.has(file)) {
         continue;
       }
-      let sourceContent = await fs15.readFile(sourcePath, "utf-8");
+      let sourceContent = await fs14.readFile(sourcePath, "utf-8");
       if (replacements) {
         sourceContent = applyReplacements(sourceContent, replacements);
       }
       let shouldUpdate = true;
-      if (await fs15.pathExists(targetPath)) {
-        const targetContent = await fs15.readFile(targetPath, "utf-8");
+      if (await fs14.pathExists(targetPath)) {
+        const targetContent = await fs14.readFile(targetPath, "utf-8");
         if (sourceContent === targetContent) {
           continue;
         }
@@ -4030,7 +4237,7 @@ async function updateFolder(sourceDir, targetDir, force, replacements, lang = DE
         }
       }
       if (shouldUpdate) {
-        await fs15.writeFile(targetPath, sourceContent);
+        await fs14.writeFile(targetPath, sourceContent);
         console.log(
           chalk6.gray(`  \u{1F4C4} ${tr(lang, "cli", "update.fileUpdated", { file })}`)
         );
@@ -4087,7 +4294,7 @@ function extractPorcelainPaths(line) {
 function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
   const top = getGitTopLevel2(docsDir);
   if (!top) return null;
-  const rel = path17.relative(top, docsDir) || ".";
+  const rel = path18.relative(top, docsDir) || ".";
   try {
     const output = execFileSync("git", ["status", "--porcelain=v1", "--", rel], {
       cwd: top,
@@ -4099,7 +4306,7 @@ function getDocsPorcelainStatus(docsDir, ignoredAbsPaths = []) {
     }
     const ignoredRelPaths = new Set(
       ignoredAbsPaths.map(
-        (absPath) => normalizeGitPath2(path17.relative(top, absPath) || ".")
+        (absPath) => normalizeGitPath2(path18.relative(top, absPath) || ".")
       )
     );
     const filtered = output.split("\n").filter((line) => {
@@ -4156,7 +4363,7 @@ ${tr(lang2, "cli", "common.canceled")}`));
 }
 async function runConfig(options) {
   const cwd = process.cwd();
-  const targetCwd = options.dir ? path17.resolve(cwd, options.dir) : cwd;
+  const targetCwd = options.dir ? path18.resolve(cwd, options.dir) : cwd;
   const config = await getConfig(targetCwd);
   if (!config) {
     throw createCliError(
@@ -4164,7 +4371,7 @@ async function runConfig(options) {
       tr(DEFAULT_LANG, "cli", "common.configNotFound")
     );
   }
-  const configPath = path17.join(config.docsDir, ".lee-spec-kit.json");
+  const configPath = path18.join(config.docsDir, ".lee-spec-kit.json");
   if (!options.projectRoot) {
     console.log();
     console.log(chalk6.blue(tr(config.lang, "cli", "config.currentTitle")));
@@ -4175,7 +4382,7 @@ async function runConfig(options) {
       )
     );
     console.log();
-    const configFile = await fs15.readJson(configPath);
+    const configFile = await fs14.readJson(configPath);
     console.log(JSON.stringify(configFile, null, 2));
     console.log();
     return;
@@ -4183,7 +4390,7 @@ async function runConfig(options) {
   await withFileLock(
     getDocsLockPath(config.docsDir),
     async () => {
-      const configFile = await fs15.readJson(configPath);
+      const configFile = await fs14.readJson(configPath);
       if (configFile.docsRepo !== "standalone") {
         console.log(
           chalk6.yellow(tr(config.lang, "cli", "config.projectRootStandaloneOnly"))
@@ -4262,7 +4469,7 @@ async function runConfig(options) {
           )
         );
       }
-      await fs15.writeJson(configPath, configFile, { spaces: 2 });
+      await fs14.writeJson(configPath, configFile, { spaces: 2 });
       console.log();
     },
     { owner: "config" }
@@ -4516,42 +4723,42 @@ var BUILTIN_DOC_DEFINITIONS = [
   {
     id: "agents",
     title: { ko: "\uC5D0\uC774\uC804\uD2B8 \uC6B4\uC601 \uADDC\uCE59", en: "Agent Operating Rules" },
-    relativePath: (projectType, lang) => path17.join(lang, toTemplateProjectType(projectType), "agents", "agents.md")
+    relativePath: (projectType, lang) => path18.join(lang, toTemplateProjectType(projectType), "agents", "agents.md")
   },
   {
     id: "git-workflow",
     title: { ko: "Git \uC6CC\uD06C\uD50C\uB85C\uC6B0", en: "Git Workflow" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "git-workflow.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "git-workflow.md")
   },
   {
     id: "issue-template",
     title: { ko: "Issue \uD15C\uD50C\uB9BF", en: "Issue Template" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "issue-template.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "issue-template.md")
   },
   {
     id: "pr-template",
     title: { ko: "PR \uD15C\uD50C\uB9BF", en: "PR Template" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "pr-template.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "pr-template.md")
   },
   {
     id: "create-feature",
     title: { ko: "create-feature \uC2A4\uD0AC", en: "create-feature skill" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "skills", "create-feature.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "skills", "create-feature.md")
   },
   {
     id: "execute-task",
     title: { ko: "execute-task \uC2A4\uD0AC", en: "execute-task skill" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "skills", "execute-task.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "skills", "execute-task.md")
   },
   {
     id: "create-issue",
     title: { ko: "create-issue \uC2A4\uD0AC", en: "create-issue skill" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "skills", "create-issue.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "skills", "create-issue.md")
   },
   {
     id: "create-pr",
     title: { ko: "create-pr \uC2A4\uD0AC", en: "create-pr skill" },
-    relativePath: (_, lang) => path17.join(lang, "common", "agents", "skills", "create-pr.md")
+    relativePath: (_, lang) => path18.join(lang, "common", "agents", "skills", "create-pr.md")
   }
 ];
 var DOC_FOLLOWUPS = {
@@ -4635,7 +4842,7 @@ function listBuiltinDocs(projectType, lang) {
       id: doc.id,
       title: doc.title[lang],
       relativePath,
-      absolutePath: path17.join(templatesDir, relativePath)
+      absolutePath: path18.join(templatesDir, relativePath)
     };
   });
 }
@@ -4644,7 +4851,7 @@ async function getBuiltinDoc(docId, projectType, lang) {
   if (!entry) {
     throw new Error(`Unknown builtin doc: ${docId}`);
   }
-  const content = await fs15.readFile(entry.absolutePath, "utf-8");
+  const content = await fs14.readFile(entry.absolutePath, "utf-8");
   const hash = createHash("sha256").update(content).digest("hex").slice(0, 12);
   return {
     entry,
@@ -4673,6 +4880,25 @@ function listLabels(actionOptions) {
   if (actionOptions.length === 0) return "-";
   return actionOptions.map((o) => o.label).join(", ");
 }
+function resolveFeatureRefForApproval(state, featureName) {
+  const raw = featureName?.trim() || state.matchedFeature?.folderName || "<slug|F001|F001-slug>";
+  return raw;
+}
+function buildApprovalCommand(state, featureName, selectedComponent, execute) {
+  const featureRef = resolveFeatureRefForApproval(state, featureName);
+  const componentArg = selectedComponent ? ` --component ${selectedComponent}` : "";
+  const executeArg = execute ? " --execute" : "";
+  return `npx lee-spec-kit context ${featureRef}${componentArg} --approve <LABEL>${executeArg}`;
+}
+function buildFinalApprovalPrompt(lang, actionOptions) {
+  if (actionOptions.length === 0) return "";
+  const labels = listLabels(actionOptions);
+  const example = actionOptions[0]?.label || "A";
+  return tr(lang, "cli", "context.finalLabelPrompt", {
+    labels,
+    example
+  });
+}
 function formatActionSummary2(action) {
   if (action.type === "command") {
     return `(${action.scope}) ${action.cmd}`;
@@ -4710,7 +4936,7 @@ function getCommandExecutionLockPath(action, config) {
   if (action.scope === "docs") {
     return getDocsLockPath(config.docsDir);
   }
-  return path17.join(action.cwd, ".lee-spec-kit.project.lock");
+  return path18.join(action.cwd, ".lee-spec-kit.project.lock");
 }
 function contextCommand(program2) {
   program2.command("context [feature-name]").description("Show current feature context and next actions").option("--json", "Output in JSON format for agents").option("--repo <repo>", "Component name for multi projects").option("--component <component>", "Component name for multi projects").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").option("--approve <reply>", "Approve one labeled option: A or A OK").option("--execute", "Execute approved option when it is a command").option(
@@ -4848,6 +5074,19 @@ async function runContext(featureName, options) {
   }
   if (options.json) {
     const primaryAction = state.actionOptions[0] ?? null;
+    const finalApprovalPrompt = buildFinalApprovalPrompt(lang, state.actionOptions);
+    const approveCommand = buildApprovalCommand(
+      state,
+      featureName,
+      selectedComponent,
+      false
+    );
+    const executeCommand = buildApprovalCommand(
+      state,
+      featureName,
+      selectedComponent,
+      true
+    );
     const result = {
       status: state.status,
       reasonCode: toReasonCode(state.status),
@@ -4888,6 +5127,10 @@ async function runContext(featureName, options) {
       },
       approvalRequest: {
         guidance: "Present each label with summary (e.g. `A: <summary>`) before asking for approval.",
+        finalPrompt: finalApprovalPrompt,
+        labels: state.actionOptions.map((o) => o.label),
+        approveCommand,
+        executeCommand,
         options: state.actionOptions.map((o) => ({
           label: o.label,
           summary: o.summary,
@@ -5087,7 +5330,7 @@ async function runContext(featureName, options) {
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
-  console.log(`   \u2022 Path: ${path17.relative(cwd, f.path)}`);
+  console.log(`   \u2022 Path: ${path18.relative(cwd, f.path)}`);
   if (f.git.projectBranch) {
     console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
   }
@@ -5151,6 +5394,23 @@ async function runContext(featureName, options) {
       );
     }
   }
+  if (actionOptions.length > 0) {
+    const finalApprovalPrompt = buildFinalApprovalPrompt(lang, actionOptions);
+    const executeCommand = buildApprovalCommand(
+      state,
+      featureName,
+      selectedComponent,
+      true
+    );
+    console.log(chalk6.cyan(`   \u21B3 ${finalApprovalPrompt}`));
+    console.log(
+      chalk6.gray(
+        `   \u21B3 ${tr(lang, "cli", "context.finalLabelCommandHint", {
+          command: executeCommand
+        })}`
+      )
+    );
+  }
   console.log();
 }
 async function runApprovedOption(state, config, lang, featureName, selectionOptions, options) {
@@ -5324,7 +5584,7 @@ var FIXABLE_ISSUE_CODES = /* @__PURE__ */ new Set([
 ]);
 function formatPath(cwd, p) {
   if (!p) return "";
-  return path17.isAbsolute(p) ? path17.relative(cwd, p) : p;
+  return path18.isAbsolute(p) ? path18.relative(cwd, p) : p;
 }
 function detectPlaceholders(content) {
   const patterns = [
@@ -5467,7 +5727,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
     const placeholderContext = {
       projectName: config.projectName,
       featureName: f.slug,
-      featurePath: f.docs.featurePathFromDocs || path17.relative(config.docsDir, f.path),
+      featurePath: f.docs.featurePathFromDocs || path18.relative(config.docsDir, f.path),
       repoType: f.type,
       featureNumber
     };
@@ -5477,9 +5737,9 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       "tasks.md"
     ];
     for (const file of files) {
-      const fullPath = path17.join(f.path, file);
-      if (!await fs15.pathExists(fullPath)) continue;
-      const original = await fs15.readFile(fullPath, "utf-8");
+      const fullPath = path18.join(f.path, file);
+      if (!await fs14.pathExists(fullPath)) continue;
+      const original = await fs14.readFile(fullPath, "utf-8");
       let next = original;
       const changes = [];
       const placeholderFix = applyPlaceholderFixes(next, placeholderContext, config.lang);
@@ -5503,7 +5763,7 @@ async function applyDoctorFixes(config, cwd, features, dryRun) {
       }
       if (next === original) continue;
       if (!dryRun) {
-        await fs15.writeFile(fullPath, next, "utf-8");
+        await fs14.writeFile(fullPath, next, "utf-8");
       }
       entries.push({
         path: formatPath(cwd, fullPath),
@@ -5522,8 +5782,8 @@ async function checkDocsStructure(config, cwd) {
   const issues = [];
   const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
   for (const dir of requiredDirs) {
-    const p = path17.join(config.docsDir, dir);
-    if (!await fs15.pathExists(p)) {
+    const p = path18.join(config.docsDir, dir);
+    if (!await fs14.pathExists(p)) {
       issues.push({
         level: "error",
         code: "missing_dir",
@@ -5532,8 +5792,8 @@ async function checkDocsStructure(config, cwd) {
       });
     }
   }
-  const configPath = path17.join(config.docsDir, ".lee-spec-kit.json");
-  if (!await fs15.pathExists(configPath)) {
+  const configPath = path18.join(config.docsDir, ".lee-spec-kit.json");
+  if (!await fs14.pathExists(configPath)) {
     issues.push({
       level: "warn",
       code: "missing_config",
@@ -5555,7 +5815,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
   }
   const idMap = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const rel = f.docs.featurePathFromDocs || path17.relative(config.docsDir, f.path);
+    const rel = f.docs.featurePathFromDocs || path18.relative(config.docsDir, f.path);
     const id = f.id || "UNKNOWN";
     if (!idMap.has(id)) idMap.set(id, []);
     idMap.get(id).push(rel);
@@ -5563,9 +5823,9 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
     if (!isInitialTemplateState) {
       const featureDocs = ["spec.md", "plan.md", "tasks.md"];
       for (const file of featureDocs) {
-        const p = path17.join(f.path, file);
-        if (!await fs15.pathExists(p)) continue;
-        const content = await fs15.readFile(p, "utf-8");
+        const p = path18.join(f.path, file);
+        if (!await fs14.pathExists(p)) continue;
+        const content = await fs14.readFile(p, "utf-8");
         const placeholders = detectPlaceholders(content);
         if (placeholders.length === 0) continue;
         issues.push({
@@ -5578,9 +5838,9 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         });
       }
       if (decisionsPlaceholderMode !== "off") {
-        const decisionsPath = path17.join(f.path, "decisions.md");
-        if (await fs15.pathExists(decisionsPath)) {
-          const content = await fs15.readFile(decisionsPath, "utf-8");
+        const decisionsPath = path18.join(f.path, "decisions.md");
+        if (await fs14.pathExists(decisionsPath)) {
+          const content = await fs14.readFile(decisionsPath, "utf-8");
           const placeholders = detectPlaceholders(content);
           if (placeholders.length > 0) {
             issues.push({
@@ -5607,7 +5867,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, path17.join(f.path, "spec.md"))
+        path: formatPath(cwd, path18.join(f.path, "spec.md"))
       });
     }
     if (f.docs.planExists && !f.planStatus && !isInitialTemplateState) {
@@ -5615,7 +5875,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, path17.join(f.path, "plan.md"))
+        path: formatPath(cwd, path18.join(f.path, "plan.md"))
       });
     }
     if (f.docs.tasksExists && f.tasks.total === 0 && !isInitialTemplateState) {
@@ -5623,7 +5883,7 @@ async function checkFeatures(config, cwd, features, decisionsPlaceholderMode) {
         level: "warn",
         code: "tasks_empty",
         message: tr(config.lang, "cli", "doctor.issue.tasksEmpty"),
-        path: formatPath(cwd, path17.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path18.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && !f.docs.tasksDocStatusFieldExists && !isInitialTemplateState) {
@@ -5631,7 +5891,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, path17.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path18.join(f.path, "tasks.md"))
       });
     }
     if (f.docs.tasksExists && f.docs.tasksDocStatusFieldExists && !f.tasksDocStatus && !isInitialTemplateState) {
@@ -5639,7 +5899,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, path17.join(f.path, "tasks.md"))
+        path: formatPath(cwd, path18.join(f.path, "tasks.md"))
       });
     }
   }
@@ -5663,7 +5923,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, path17.join(config.docsDir, p))
+      path: formatPath(cwd, path18.join(config.docsDir, p))
     });
   }
   return issues;
@@ -5785,7 +6045,7 @@ function doctorCommand(program2) {
       }
       console.log();
       console.log(chalk6.bold(tr(lang, "cli", "doctor.title")));
-      console.log(chalk6.gray(`- Docs: ${path17.relative(cwd, docsDir)}`));
+      console.log(chalk6.gray(`- Docs: ${path18.relative(cwd, docsDir)}`));
       console.log(chalk6.gray(`- Type: ${projectType}`));
       console.log(chalk6.gray(`- Lang: ${lang}`));
       console.log();
@@ -5964,7 +6224,7 @@ async function runView(featureName, options) {
   }
   console.log();
   console.log(chalk6.bold("\u{1F4CA} Workflow View"));
-  console.log(chalk6.gray(`- Docs: ${path17.relative(cwd, config.docsDir)}`));
+  console.log(chalk6.gray(`- Docs: ${path18.relative(cwd, config.docsDir)}`));
   console.log(
     chalk6.gray(
       `- Features: ${state.features.length} (open ${state.openFeatures.length} / done ${state.doneFeatures.length})`
@@ -6245,45 +6505,109 @@ async function runFlow(featureName, options) {
   console.log(chalk6.gray("Tip: add --approve <LABEL> [--execute] to run the selected atomic action."));
   console.log();
 }
+
+// src/utils/github-draft-contract.ts
+var ISSUE_CONTRACT = {
+  kind: "issue",
+  requiredSections: {
+    ko: ["\uAC1C\uC694", "\uBAA9\uD45C", "\uC644\uB8CC \uAE30\uC900", "\uAD00\uB828 \uBB38\uC11C", "\uB77C\uBCA8"],
+    en: ["Overview", "Goals", "Completion Criteria", "Related Documents", "Labels"]
+  },
+  artifacts: []
+};
+var PR_CONTRACT = {
+  kind: "pr",
+  requiredSections: {
+    ko: ["\uAC1C\uC694", "\uBCC0\uACBD \uC0AC\uD56D", "\uD14C\uC2A4\uD2B8", "\uAD00\uB828 \uBB38\uC11C"],
+    en: ["Overview", "Changes", "Tests", "Related Documents"]
+  },
+  artifacts: [
+    {
+      id: "screenshots",
+      headings: { ko: "\uC2A4\uD06C\uB9B0\uC0F7", en: "Screenshots" },
+      bodyRule: "image-markdown"
+    },
+    {
+      id: "mermaid",
+      headings: { ko: "\uC544\uD0A4\uD14D\uCC98 \uB2E4\uC774\uC5B4\uADF8\uB7A8", en: "Architecture Diagram" },
+      bodyRule: "mermaid-fence"
+    }
+  ]
+};
+var CONTRACTS = {
+  issue: ISSUE_CONTRACT,
+  pr: PR_CONTRACT
+};
+function getGithubDraftRequiredSections(kind, lang) {
+  return [...CONTRACTS[kind].requiredSections[lang]];
+}
+function getGithubDraftArtifactHeading(kind, artifactId, lang) {
+  const artifact = CONTRACTS[kind].artifacts.find((item) => item.id === artifactId);
+  if (!artifact) return null;
+  return artifact.headings[lang];
+}
+function getGithubDraftContractView(kind, lang) {
+  const definition = CONTRACTS[kind];
+  return {
+    kind: definition.kind,
+    requiredSections: [...definition.requiredSections[lang]],
+    artifacts: definition.artifacts.map((artifact) => ({
+      id: artifact.id,
+      section: artifact.headings[lang],
+      bodyRule: artifact.bodyRule
+    }))
+  };
+}
+function getGithubDraftContractForBuiltinDoc(docId, lang) {
+  if (docId === "create-issue" || docId === "issue-template") {
+    return getGithubDraftContractView("issue", lang);
+  }
+  if (docId === "create-pr" || docId === "pr-template") {
+    return getGithubDraftContractView("pr", lang);
+  }
+  return null;
+}
+
+// src/commands/github.ts
 function tg(lang, key, vars = {}) {
   return tr(lang, "cli", `github.${key}`, vars);
 }
 function detectGithubCliLangSync(cwd) {
   const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || "").trim();
-  const startDirs = [explicitDocsDir ? path17.resolve(explicitDocsDir) : "", path17.resolve(cwd)].filter(Boolean);
+  const startDirs = [explicitDocsDir ? path18.resolve(explicitDocsDir) : "", path18.resolve(cwd)].filter(Boolean);
   const scanOrder = [];
   const seen = /* @__PURE__ */ new Set();
   for (const start of startDirs) {
     let current = start;
     while (true) {
-      const abs = path17.resolve(current);
+      const abs = path18.resolve(current);
       if (!seen.has(abs)) {
         scanOrder.push(abs);
         seen.add(abs);
       }
-      const parent = path17.dirname(abs);
+      const parent = path18.dirname(abs);
       if (parent === abs) break;
       current = parent;
     }
   }
   for (const base of scanOrder) {
-    for (const docsDir of [path17.join(base, "docs"), base]) {
-      const configPath = path17.join(docsDir, ".lee-spec-kit.json");
-      if (fs15.existsSync(configPath)) {
+    for (const docsDir of [path18.join(base, "docs"), base]) {
+      const configPath = path18.join(docsDir, ".lee-spec-kit.json");
+      if (fs14.existsSync(configPath)) {
         try {
-          const parsed = fs15.readJsonSync(configPath);
+          const parsed = fs14.readJsonSync(configPath);
           if (parsed?.lang === "ko" || parsed?.lang === "en") return parsed.lang;
         } catch {
         }
       }
-      const agentsPath = path17.join(docsDir, "agents");
-      const featuresPath = path17.join(docsDir, "features");
-      if (!fs15.existsSync(agentsPath) || !fs15.existsSync(featuresPath)) continue;
+      const agentsPath = path18.join(docsDir, "agents");
+      const featuresPath = path18.join(docsDir, "features");
+      if (!fs14.existsSync(agentsPath) || !fs14.existsSync(featuresPath)) continue;
       for (const probe of ["custom.md", "constitution.md", "agents.md"]) {
-        const file = path17.join(agentsPath, probe);
-        if (!fs15.existsSync(file)) continue;
+        const file = path18.join(agentsPath, probe);
+        if (!fs14.existsSync(file)) continue;
         try {
-          const content = fs15.readFileSync(file, "utf-8");
+          const content = fs14.readFileSync(file, "utf-8");
           if (/[가-힣]/.test(content)) return "ko";
         } catch {
         }
@@ -6384,7 +6708,7 @@ function ensureSections(body, sections, kind, lang) {
 }
 function ensureDocsExist(docsDir, relativePaths, lang) {
   const missing = relativePaths.filter(
-    (relativePath) => !fs15.existsSync(path17.join(docsDir, relativePath))
+    (relativePath) => !fs14.existsSync(path18.join(docsDir, relativePath))
   );
   if (missing.length > 0) {
     throw createCliError(
@@ -6394,13 +6718,62 @@ function ensureDocsExist(docsDir, relativePaths, lang) {
   }
 }
 function buildDefaultBodyFileName(kind, docsDir, component) {
-  const key = `${path17.resolve(docsDir)}::${component.trim().toLowerCase()}`;
+  const key = `${path18.resolve(docsDir)}::${component.trim().toLowerCase()}`;
   const digest = createHash("sha1").update(key).digest("hex").slice(0, 12);
   return `lee-spec-kit.${digest}.${kind}.md`;
 }
 function toBodyFilePath(raw, kind, docsDir, component) {
-  const selected = raw?.trim() || path17.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
-  return path17.resolve(selected);
+  const selected = raw?.trim() || path18.join(os.tmpdir(), buildDefaultBodyFileName(kind, docsDir, component));
+  return path18.resolve(selected);
+}
+function toProjectRootDocsPath(relativePathFromDocs) {
+  const normalized = relativePathFromDocs.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
+  if (normalized.startsWith("docs/")) return normalized;
+  return `docs/${normalized}`;
+}
+function toBodyDocPaths(paths) {
+  return {
+    ...paths,
+    specPath: toProjectRootDocsPath(paths.specPath),
+    planPath: toProjectRootDocsPath(paths.planPath),
+    tasksPath: toProjectRootDocsPath(paths.tasksPath)
+  };
+}
+var TODO_PLACEHOLDER_PATTERN = /(^|\n)\s*-\s*\[[ xX]\]\s*TODO:/m;
+function ensureNoTodoPlaceholders(body, kind, lang) {
+  if (!TODO_PLACEHOLDER_PATTERN.test(body)) return;
+  throw createCliError(
+    "PRECONDITION_FAILED",
+    tg(lang, "todoPlaceholdersRemain", { kind })
+  );
+}
+function parsePrArtifactMode(raw, kind, lang) {
+  const value = (raw || "auto").trim().toLowerCase();
+  if (value === "auto" || value === "on" || value === "off") {
+    return value;
+  }
+  throw createCliError(
+    "INVALID_ARGUMENT",
+    tg(lang, "artifactModeInvalid", { kind, value })
+  );
+}
+function resolvePrArtifactPolicy(config, feature, options) {
+  const screenshotsMode = parsePrArtifactMode(
+    options.screenshots,
+    "screenshots",
+    config.lang
+  );
+  const mermaidMode = parsePrArtifactMode(
+    options.mermaid,
+    "mermaid",
+    config.lang
+  );
+  const includeScreenshots = screenshotsMode === "on" ? true : screenshotsMode === "off" ? false : config.pr?.screenshots?.upload ?? false;
+  const includeMermaid = mermaidMode === "on" ? true : mermaidMode === "off" ? false : feature.type === "be";
+  return {
+    includeScreenshots,
+    includeMermaid
+  };
 }
 async function resolveFeatureOrThrow(featureName, options, lang) {
   const config = await getConfig(process.cwd());
@@ -6440,27 +6813,38 @@ function getFeatureDocPaths(feature) {
 function normalizeHeading(value) {
   return value.trim().replace(/\s+/g, " ").toLowerCase();
 }
-function extractMarkdownSection(content, headings) {
+function extractMarkdownByHeadings(content, headings, levels) {
   const targets = new Set(headings.map((heading) => normalizeHeading(heading)));
   const lines = content.split("\n");
   let start = -1;
+  let startLevel = 0;
+  const levelSet = new Set(levels);
   for (let i = 0; i < lines.length; i++) {
-    const match = lines[i].match(/^\s*##\s+(.+?)\s*$/);
+    const match = lines[i].match(/^\s*(#{2,6})\s+(.+?)\s*$/);
     if (!match) continue;
-    if (!targets.has(normalizeHeading(match[1]))) continue;
+    const level = match[1].length;
+    if (!levelSet.has(level)) continue;
+    if (!targets.has(normalizeHeading(match[2]))) continue;
     start = i + 1;
+    startLevel = level;
     break;
   }
   if (start < 0) return void 0;
   let end = lines.length;
   for (let i = start; i < lines.length; i++) {
-    if (/^\s*##\s+/.test(lines[i])) {
+    const heading = lines[i].match(/^\s*(#{2,6})\s+(.+?)\s*$/);
+    if (!heading) continue;
+    const level = heading[1].length;
+    if (level <= startLevel) {
       end = i;
       break;
     }
   }
   return lines.slice(start, end).join("\n");
 }
+function extractMarkdownSection(content, headings) {
+  return extractMarkdownByHeadings(content, headings, [2]);
+}
 function isTemplateLine(line) {
   const trimmed = line.trim();
   if (!trimmed) return true;
@@ -6476,6 +6860,337 @@ function sanitizeOverviewSection(raw) {
   if (lines.length === 0) return void 0;
   return lines.slice(0, 5).join("\n");
 }
+function sanitizeDraftItem(raw) {
+  const trimmed = raw.replace(/^\s*-\s*\[[ xX]\]\s*/, "").replace(/^\s*-\s+/, "").replace(/^\s*###\s+/, "").trim();
+  const plain = trimmed.replace(/\*\*/g, "").trim();
+  if (!plain) return void 0;
+  if (isTemplateLine(plain)) return void 0;
+  if (/^todo:/i.test(plain)) return void 0;
+  if (/\{[^}]*\}/.test(plain)) return void 0;
+  if (/^(as a|i want|so that)\b/i.test(plain)) return void 0;
+  if (/^acceptance criteria:?$/i.test(plain)) return void 0;
+  return plain.replace(/\s+/g, " ");
+}
+function uniqItems(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const ordered = [];
+  for (const item of items) {
+    const normalized = item.trim().toLowerCase();
+    if (!normalized || seen.has(normalized)) continue;
+    seen.add(normalized);
+    ordered.push(item.trim());
+  }
+  return ordered;
+}
+function normalizeSemanticKey(value) {
+  return value.toLowerCase().replace(/[`'"(){}\[\].,:;!?/\\\-_|]/g, " ").replace(/\s+/g, " ").trim().replace(/\s/g, "");
+}
+function uniqItemsByContainment(items) {
+  const kept = [];
+  const keys = [];
+  for (const item of items) {
+    const clean = item.trim();
+    if (!clean) continue;
+    const key = normalizeSemanticKey(clean);
+    if (!key) continue;
+    let replaced = false;
+    for (let i = 0; i < keys.length; i++) {
+      const current = keys[i];
+      if (!current.includes(key) && !key.includes(current)) continue;
+      if (key.length > current.length) {
+        keys[i] = key;
+        kept[i] = clean;
+      }
+      replaced = true;
+      break;
+    }
+    if (!replaced) {
+      keys.push(key);
+      kept.push(clean);
+    }
+  }
+  return kept;
+}
+function extractSectionLines(raw) {
+  if (!raw) return [];
+  return uniqItems(
+    raw.split("\n").map((line) => sanitizeDraftItem(line)).filter((line) => !!line)
+  );
+}
+function extractSectionHeadings(raw) {
+  if (!raw) return [];
+  return uniqItems(
+    raw.split("\n").map((line) => line.match(/^\s*###\s+(.+?)\s*$/)?.[1] || "").map((line) => sanitizeDraftItem(line)).filter((line) => !!line).map((line) => line.replace(/^FR-\d+:\s*/i, "").trim())
+  );
+}
+function toChecklistLines(items) {
+  return items.map((item) => `- [ ] ${item}`).join("\n");
+}
+function extractChecklistItems(raw) {
+  if (!raw) return [];
+  return uniqItems(
+    raw.split("\n").map((line) => {
+      const match = line.match(/^\s*-\s*\[[ xX]\]\s+(.+?)\s*$/);
+      if (!match) return void 0;
+      return sanitizeDraftItem(match[1]);
+    }).filter((line) => !!line)
+  );
+}
+function extractTaskTitles(tasksContent) {
+  return uniqItems(
+    tasksContent.split("\n").map((line) => {
+      const match = line.match(
+        /^\s*-\s*\[(?:TODO|DOING|DONE)\][^\n]*?\s+(?:T-[A-Z0-9-]+\s+)?(.+?)\s*$/
+      );
+      if (!match) return void 0;
+      return sanitizeDraftItem(match[1]);
+    }).filter((line) => !!line)
+  );
+}
+function extractTasksAcceptanceItems(tasksContent) {
+  const lines = tasksContent.split("\n");
+  const accepted = [];
+  let inAcceptance = false;
+  for (const line of lines) {
+    if (/^\s*-\s*Acceptance\s*:\s*$/i.test(line)) {
+      inAcceptance = true;
+      continue;
+    }
+    if (inAcceptance && /^\s*-\s*Checklist\s*:\s*$/i.test(line)) {
+      inAcceptance = false;
+      continue;
+    }
+    if (!inAcceptance) continue;
+    const match = line.match(/^\s*-\s*\[[ xX]\]\s+(.+?)\s*$/) || line.match(/^\s*-\s+(.+?)\s*$/);
+    if (!match) continue;
+    const item = sanitizeDraftItem(match[1]);
+    if (!item) continue;
+    accepted.push(item);
+  }
+  return uniqItems(accepted);
+}
+function extractScopeItemsFromPlan(planContent, lang) {
+  const section = extractMarkdownSection(
+    planContent,
+    ["\uBC94\uC704(\uBA85\uD655\uD654)", "\uBC94\uC704", "Scope", "Scope Clarification"]
+  );
+  if (!section) return { include: [], exclude: [] };
+  const lines = section.split("\n");
+  const include = [];
+  const exclude = [];
+  let mode = null;
+  const includePatterns = lang === "ko" ? [/포함/] : [/in\s*scope/i, /^include$/i, /included/i];
+  const excludePatterns = lang === "ko" ? [/비포함/, /제외/] : [/out\s*of\s*scope/i, /^exclude$/i, /excluded/i];
+  for (const line of lines) {
+    const plain = line.replace(/\*\*/g, "").trim();
+    if (!plain) continue;
+    if (excludePatterns.some((re) => re.test(plain))) {
+      mode = "exclude";
+      continue;
+    }
+    if (includePatterns.some((re) => re.test(plain))) {
+      mode = "include";
+      continue;
+    }
+    const bullet = line.match(/^\s*-\s+(.+?)\s*$/)?.[1];
+    if (!bullet) continue;
+    const item = sanitizeDraftItem(bullet);
+    if (!item) continue;
+    if (mode === "include") {
+      include.push(item);
+    } else if (mode === "exclude") {
+      exclude.push(item);
+    }
+  }
+  return {
+    include: uniqItems(include),
+    exclude: uniqItems(exclude)
+  };
+}
+function getIssueGoalsAndCriteria(specContent, planContent, tasksContent, overview, lang) {
+  const purposeLines = extractSectionLines(
+    extractMarkdownSection(specContent, ["\uBAA9\uC801", "Purpose"])
+  );
+  const requirementHeadings = extractSectionHeadings(
+    extractMarkdownSection(specContent, ["\uAE30\uB2A5 \uC694\uAD6C\uC0AC\uD56D", "Functional Requirements"])
+  );
+  const userStoryChecklist = extractChecklistItems(
+    extractMarkdownSection(specContent, ["\uC0AC\uC6A9\uC790 \uC2A4\uD1A0\uB9AC", "User Stories"])
+  );
+  const tasksAcceptance = extractTasksAcceptanceItems(tasksContent);
+  const scopeFromPlan = extractScopeItemsFromPlan(planContent, lang);
+  const taskTitles = extractTaskTitles(tasksContent);
+  const goals = uniqItemsByContainment(uniqItems([
+    ...requirementHeadings,
+    ...scopeFromPlan.include,
+    ...purposeLines.slice(0, 1),
+    sanitizeDraftItem(overview) || ""
+  ])).slice(0, 5);
+  while (goals.length < 3) {
+    goals.push(
+      lang === "ko" ? goals.length === 0 ? "spec.md \uBAA9\uC801\uC5D0 \uB9DE\uCDB0 \uAD6C\uD604 \uBC94\uC704\uB97C \uD655\uC815\uD55C\uB2E4." : goals.length === 1 ? "\uD3EC\uD568/\uC81C\uC678 \uBC94\uC704\uB97C \uBA85\uD655\uD788 \uC815\uC758\uD558\uACE0 \uBB38\uC11C\uC640 \uAD6C\uD604\uC744 \uC77C\uCE58\uC2DC\uD0A8\uB2E4." : "\uAD00\uB828 \uD14C\uC2A4\uD2B8 \uBC0F \uAC80\uC99D \uACBD\uB85C\uB97C \uD3EC\uD568\uD574 \uAE30\uB2A5 \uC644\uC131\uB3C4\uB97C \uD655\uBCF4\uD55C\uB2E4." : goals.length === 0 ? "Define implementation scope aligned with spec.md purpose." : goals.length === 1 ? "Clarify in-scope and out-of-scope boundaries and keep docs/code aligned." : "Ensure feature completeness with concrete validation paths."
+    );
+  }
+  const criteria = uniqItemsByContainment(
+    uniqItems([...userStoryChecklist, ...tasksAcceptance])
+  ).slice(0, 6);
+  while (criteria.length < 4) {
+    criteria.push(
+      lang === "ko" ? criteria.length === 0 ? "\uD575\uC2EC \uC0AC\uC6A9\uC790 \uC2DC\uB098\uB9AC\uC624\uC5D0\uC11C \uBAA9\uD45C \uB3D9\uC791\uC774 \uC7AC\uD604\uB41C\uB2E4." : criteria.length === 1 ? "\uC694\uAD6C\uC0AC\uD56D\uBCC4 \uC218\uC6A9 \uAE30\uC900\uC774 \uBAA8\uB450 \uCDA9\uC871\uB41C\uB2E4." : criteria.length === 2 ? "\uAC80\uC99D \uBC29\uBC95(\uD14C\uC2A4\uD2B8/\uC218\uB3D9 \uC2DC\uB098\uB9AC\uC624)\uC744 \uAE30\uB85D\uD574 \uC644\uB8CC\uB97C \uD655\uC778\uD560 \uC218 \uC788\uB2E4." : "\uD68C\uADC0 \uC5C6\uC774 \uAE30\uC874 \uB3D9\uC791\uACFC\uC758 \uD638\uD658\uC131\uC744 \uC720\uC9C0\uD55C\uB2E4." : criteria.length === 0 ? "Core user scenarios reproduce expected behavior." : criteria.length === 1 ? "All requirement-level acceptance criteria are satisfied." : criteria.length === 2 ? "Validation method (tests/manual scenarios) is documented for completion checks." : "Compatibility is preserved without regressions."
+    );
+  }
+  const scope = uniqItemsByContainment(
+    uniqItems([...scopeFromPlan.include, ...taskTitles])
+  ).slice(0, 6);
+  return {
+    goals: goals.slice(0, 5),
+    criteria: criteria.slice(0, 6),
+    scope
+  };
+}
+function extractPlanChangeTargets(planContent, lang) {
+  const section = extractMarkdownSection(
+    planContent,
+    [
+      "\uBCC0\uACBD \uB300\uC0C1(\uC608\uC0C1)",
+      "\uBCC0\uACBD \uB300\uC0C1",
+      "Changed Files",
+      "Change Targets",
+      "Expected Changes"
+    ]
+  );
+  if (!section) return [];
+  const lines = section.split("\n");
+  const out = [];
+  let inCode = false;
+  for (const line of lines) {
+    if (/^\s*```/.test(line)) {
+      inCode = !inCode;
+      continue;
+    }
+    if (inCode) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      if (!/[\\/]/.test(trimmed)) continue;
+      out.push(
+        lang === "ko" ? `\`${trimmed}\` \uBCC0\uACBD` : `Update \`${trimmed}\``
+      );
+      continue;
+    }
+    const bullet = line.match(/^\s*-\s+(.+?)\s*$/)?.[1];
+    if (!bullet) continue;
+    const item = sanitizeDraftItem(bullet);
+    if (!item) continue;
+    out.push(item);
+  }
+  return uniqItemsByContainment(uniqItems(out));
+}
+function extractCommandsFromSection(raw) {
+  if (!raw) return [];
+  const commands = [];
+  for (const match of raw.matchAll(/`([^`]+)`/g)) {
+    const candidate = match[1].trim();
+    if (!candidate) continue;
+    if (/\{[^}]*\}/.test(candidate)) continue;
+    if (!/\b(pnpm|npm|yarn|bun|vitest|jest|tsx?|node)\b/.test(candidate)) continue;
+    commands.push(candidate);
+  }
+  for (const line of raw.split("\n")) {
+    const trimmed = line.trim().replace(/^-+\s*/, "");
+    if (!trimmed) continue;
+    if (!/\b(pnpm|npm|yarn|bun|vitest|jest|tsx?|node)\b/.test(trimmed)) continue;
+    if (/\{[^}]*\}/.test(trimmed)) continue;
+    commands.push(trimmed);
+  }
+  return uniqItems(commands);
+}
+function extractRecordedTestLines(tasksContent, planContent, lang) {
+  const section = extractMarkdownByHeadings(
+    tasksContent,
+    ["\uD14C\uC2A4\uD2B8 \uC2E4\uD589 \uAE30\uB85D", "Tests Run", "Test Run Log", "Test Execution Log"],
+    [3, 2]
+  );
+  const records = [];
+  if (section) {
+    for (const line of section.split("\n")) {
+      if (!line.trim().startsWith("|")) continue;
+      const cells = line.split("|").slice(1, -1).map((cell) => cell.trim().replace(/`/g, ""));
+      if (cells.length < 3) continue;
+      const [cmd, time, result] = cells;
+      if (!cmd || /^명령어$/i.test(cmd) || /^command$/i.test(cmd) || /^-+$/.test(cmd)) continue;
+      if (/\{[^}]*\}/.test(cmd) || /\{[^}]*\}/.test(result || "")) continue;
+      const renderedResult = result || (lang === "ko" ? "\uBBF8\uAE30\uB85D" : "not recorded");
+      const renderedTime = time && time !== "-" ? ` (${time})` : "";
+      records.push(`\`${cmd}\` \u2014 ${renderedResult}${renderedTime}`);
+    }
+    const lines = section.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const commandMatch = lines[i].match(/^\s*-\s*(?:명령어|Command)\s*:\s*`?([^`]+?)`?\s*$/i);
+      if (!commandMatch) continue;
+      const command = commandMatch[1].trim();
+      if (!command || /\{[^}]*\}/.test(command)) continue;
+      let result = "";
+      for (let j = i + 1; j < Math.min(lines.length, i + 5); j++) {
+        const resultMatch = lines[j].match(/^\s*-\s*(?:결과|Result)\s*:\s*(.+?)\s*$/i);
+        if (!resultMatch) continue;
+        result = resultMatch[1].replace(/`/g, "").trim();
+        break;
+      }
+      if (!result || /\{[^}]*\}/.test(result)) continue;
+      records.push(`\`${command}\` \u2014 ${result}`);
+    }
+  }
+  if (records.length > 0) {
+    return uniqItemsByContainment(uniqItems(records));
+  }
+  const plannedCommands = extractCommandsFromSection(
+    extractMarkdownByHeadings(
+      planContent,
+      ["\uAC80\uC99D \uBA85\uB839(\uC608\uC815)", "Validation Commands", "Verification Commands"],
+      [3, 2]
+    )
+  );
+  if (plannedCommands.length > 0) {
+    return plannedCommands.map(
+      (command) => lang === "ko" ? `\`${command}\` \u2014 \uC2E4\uD589 \uACB0\uACFC\uB97C \uAE30\uB85D\uD558\uC138\uC694.` : `\`${command}\` \u2014 record execution result.`
+    );
+  }
+  return [];
+}
+function getPrChangesAndTests(specContent, planContent, tasksContent, overview, lang) {
+  const requirementHeadings = extractSectionHeadings(
+    extractMarkdownSection(specContent, ["\uAE30\uB2A5 \uC694\uAD6C\uC0AC\uD56D", "Functional Requirements"])
+  );
+  const scopeFromPlan = extractScopeItemsFromPlan(planContent, lang).include;
+  const planTargets = extractPlanChangeTargets(planContent, lang);
+  const taskTitles = extractTaskTitles(tasksContent);
+  const changes = uniqItemsByContainment(
+    uniqItems([
+      ...taskTitles,
+      ...scopeFromPlan,
+      ...requirementHeadings,
+      ...planTargets,
+      sanitizeDraftItem(overview) || ""
+    ])
+  ).slice(0, 6);
+  while (changes.length < 3) {
+    changes.push(
+      lang === "ko" ? changes.length === 0 ? "\uD575\uC2EC \uAD6C\uD604 \uBCC0\uACBD \uC0AC\uD56D\uC744 \uC694\uC57D\uD574 \uBC18\uC601\uD55C\uB2E4." : changes.length === 1 ? "\uC601\uD5A5 \uBC94\uC704(\uD638\uD658\uC131/\uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD3EC\uD568)\uB97C \uBA85\uC2DC\uD55C\uB2E4." : "\uBB38\uC11C\uC640 \uAD6C\uD604 \uAC04 \uBD88\uC77C\uCE58\uAC00 \uC5C6\uB3C4\uB85D \uC815\uD569\uC131\uC744 \uC810\uAC80\uD55C\uB2E4." : changes.length === 0 ? "Summarize key implementation changes." : changes.length === 1 ? "Document impact scope (including compatibility/migration)." : "Verify document and implementation consistency."
+    );
+  }
+  const tests = uniqItemsByContainment(
+    uniqItems(extractRecordedTestLines(tasksContent, planContent, lang))
+  ).slice(0, 4);
+  while (tests.length < 2) {
+    tests.push(
+      lang === "ko" ? tests.length === 0 ? "\uAD00\uB828 \uD14C\uC2A4\uD2B8\uB97C \uC2E4\uD589\uD558\uACE0 \uACB0\uACFC\uB97C \uAE30\uB85D\uD55C\uB2E4." : "\uBBF8\uC2E4\uD589 \uD14C\uC2A4\uD2B8\uAC00 \uC788\uC73C\uBA74 \uC0AC\uC720\uC640 \uB9AC\uC2A4\uD06C\uB97C \uAE30\uB85D\uD55C\uB2E4." : tests.length === 0 ? "Run relevant tests and record results." : "If tests were not run, record rationale and risk."
+    );
+  }
+  return {
+    changes: changes.slice(0, 6),
+    tests: tests.slice(0, 4)
+  };
+}
 function resolveOverviewFromSpec(specContent, feature, lang) {
   const fromPurpose = sanitizeOverviewSection(
     extractMarkdownSection(specContent, ["\uBAA9\uC801", "Purpose"])
@@ -6487,7 +7202,112 @@ function resolveOverviewFromSpec(specContent, feature, lang) {
   if (fromOverview) return fromOverview;
   return lang === "ko" ? `\`${feature.folderName}\` \uAE30\uB2A5 \uAC1C\uC694\uB97C spec.md \uAE30\uC900\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694.` : `Summarize feature \`${feature.folderName}\` from spec.md.`;
 }
-function buildIssueBody(overview, labels, paths, lang) {
+function getPrScreenshotsHeading(lang) {
+  return getGithubDraftArtifactHeading("pr", "screenshots", lang) || (lang === "ko" ? "\uC2A4\uD06C\uB9B0\uC0F7" : "Screenshots");
+}
+function getPrMermaidHeading(lang) {
+  return getGithubDraftArtifactHeading("pr", "mermaid", lang) || (lang === "ko" ? "\uC544\uD0A4\uD14D\uCC98 \uB2E4\uC774\uC5B4\uADF8\uB7A8" : "Architecture Diagram");
+}
+function buildPrScreenshotsSection(lang) {
+  if (lang === "ko") {
+    return `
+## \uC2A4\uD06C\uB9B0\uC0F7
+
+- [ ] \uC5C5\uB85C\uB4DC\uD55C \uC2A4\uD06C\uB9B0\uC0F7 URL\uC744 \uD3EC\uD568\uD558\uC138\uC694. (\uC608: \`![](https://...)\`)
+`;
+  }
+  return `
+## Screenshots
+
+- [ ] Include uploaded screenshot URL(s). (e.g. \`![](https://...)\`)
+`;
+}
+function buildPrMermaidSection(lang) {
+  if (lang === "ko") {
+    return `
+## \uC544\uD0A4\uD14D\uCC98 \uB2E4\uC774\uC5B4\uADF8\uB7A8
+
+\`\`\`mermaid
+sequenceDiagram
+  participant Client
+  participant API
+  participant Service
+  participant DB
+  Client->>API: Request
+  API->>Service: Execute
+  Service->>DB: Query/Command
+  DB-->>Service: Result
+  Service-->>API: Response DTO
+  API-->>Client: Response
+\`\`\`
+`;
+  }
+  return `
+## Architecture Diagram
+
+\`\`\`mermaid
+sequenceDiagram
+  participant Client
+  participant API
+  participant Service
+  participant DB
+  Client->>API: Request
+  API->>Service: Execute
+  Service->>DB: Query/Command
+  DB-->>Service: Result
+  Service-->>API: Response DTO
+  API-->>Client: Response
+\`\`\`
+`;
+}
+function ensurePrArtifacts(body, policy, lang) {
+  if (policy.includeScreenshots) {
+    const heading = getPrScreenshotsHeading(lang);
+    const section = extractMarkdownByHeadings(body, [heading], [2]);
+    if (!section) {
+      throw createCliError(
+        "PRECONDITION_FAILED",
+        tg(lang, "prScreenshotsSectionMissing", { section: heading })
+      );
+    }
+    if (!/!\[[^\]]*]\((?!\s*\))[^)]+\)/m.test(section)) {
+      throw createCliError(
+        "PRECONDITION_FAILED",
+        tg(lang, "prScreenshotImageMissing", { section: heading })
+      );
+    }
+  }
+  if (policy.includeMermaid) {
+    const heading = getPrMermaidHeading(lang);
+    const section = extractMarkdownByHeadings(body, [heading], [2]);
+    if (!section) {
+      throw createCliError(
+        "PRECONDITION_FAILED",
+        tg(lang, "prMermaidSectionMissing", { section: heading })
+      );
+    }
+    if (!/```mermaid[\s\S]*?```/m.test(section)) {
+      throw createCliError(
+        "PRECONDITION_FAILED",
+        tg(lang, "prMermaidBlockMissing", { section: heading })
+      );
+    }
+  }
+}
+function buildIssueBody(specContent, planContent, tasksContent, overview, labels, paths, lang) {
+  const bodyPaths = toBodyDocPaths(paths);
+  const draft = getIssueGoalsAndCriteria(specContent, planContent, tasksContent, overview, lang);
+  const goals = toChecklistLines(draft.goals);
+  const criteria = toChecklistLines(draft.criteria);
+  const scopeSection = draft.scope.length > 0 ? lang === "ko" ? `
+## \uC791\uC5C5 \uBC94\uC704(\uC608\uC815)
+
+${draft.scope.map((item) => `- ${item}`).join("\n")}
+` : `
+## Planned Scope
+
+${draft.scope.map((item) => `- ${item}`).join("\n")}
+` : "";
   if (lang === "ko") {
     return `## \uAC1C\uC694
 
@@ -6495,19 +7315,18 @@ ${overview}
 
 ## \uBAA9\uD45C
 
-- [ ] TODO: spec.md \uBAA9\uC801/\uBC94\uC704\uB97C \uBC14\uD0D5\uC73C\uB85C \uBAA9\uD45C\uB97C \uC791\uC131\uD558\uC138\uC694.
-- [ ] TODO: \uAD6C\uD604 \uBC94\uC704(\uD3EC\uD568/\uC81C\uC678)\uB97C \uAD6C\uCCB4\uC801\uC73C\uB85C \uC791\uC131\uD558\uC138\uC694.
+${goals}
 
 ## \uC644\uB8CC \uAE30\uC900
 
-- [ ] TODO: \uAC80\uC99D \uAC00\uB2A5\uD55C \uC644\uB8CC \uAE30\uC900\uC744 \uC791\uC131\uD558\uC138\uC694.
-- [ ] TODO: \uC644\uB8CC \uD655\uC778 \uBC29\uBC95(\uD14C\uC2A4\uD2B8/\uC2DC\uB098\uB9AC\uC624)\uC744 \uC791\uC131\uD558\uC138\uC694.
+${criteria}
+${scopeSection}
 
 ## \uAD00\uB828 \uBB38\uC11C
 
-- **Spec**: \`${paths.specPath}\`
-- **Plan**: \`${paths.planPath}\`
-- **Tasks**: \`${paths.tasksPath}\`
+- **Spec**: \`${bodyPaths.specPath}\`
+- **Plan**: \`${bodyPaths.planPath}\`
+- **Tasks**: \`${bodyPaths.tasksPath}\`
 
 ## \uB77C\uBCA8
 
@@ -6520,29 +7339,40 @@ ${overview}
 
 ## Goals
 
-- [ ] TODO: Fill concrete goals based on spec.md.
-- [ ] TODO: Clarify in-scope and out-of-scope boundaries.
+${goals}
 
 ## Completion Criteria
 
-- [ ] TODO: Define verifiable completion criteria.
-- [ ] TODO: Add validation/test conditions for completion.
+${criteria}
+${scopeSection}
 
 ## Related Documents
 
-- **Spec**: \`${paths.specPath}\`
-- **Plan**: \`${paths.planPath}\`
-- **Tasks**: \`${paths.tasksPath}\`
+- **Spec**: \`${bodyPaths.specPath}\`
+- **Plan**: \`${bodyPaths.planPath}\`
+- **Tasks**: \`${bodyPaths.tasksPath}\`
 
 ## Labels
 
 ${labels.map((label) => `- \`${label}\``).join("\n")}
 `;
 }
-function buildPrBody(feature, overview, paths, lang) {
+function buildPrBody(feature, specContent, planContent, tasksContent, overview, paths, artifactPolicy, lang) {
+  const bodyPaths = toBodyDocPaths(paths);
   const closes = feature.issueNumber ? `
 Closes #${feature.issueNumber}
 ` : "\n";
+  const draft = getPrChangesAndTests(
+    specContent,
+    planContent,
+    tasksContent,
+    overview,
+    lang
+  );
+  const changes = toChecklistLines(draft.changes);
+  const tests = toChecklistLines(draft.tests);
+  const screenshotsSection = artifactPolicy.includeScreenshots ? buildPrScreenshotsSection(lang) : "";
+  const mermaidSection = artifactPolicy.includeMermaid ? buildPrMermaidSection(lang) : "";
   if (lang === "ko") {
     return `## \uAC1C\uC694
 
@@ -6550,20 +7380,20 @@ ${overview}
 
 ## \uBCC0\uACBD \uC0AC\uD56D
 
-- [ ] TODO: \uD575\uC2EC \uCF54\uB4DC \uBCC0\uACBD \uC0AC\uD56D\uC744 \uC694\uC57D\uD558\uC138\uC694.
-- [ ] TODO: \uC601\uD5A5 \uBC94\uC704/\uD638\uD658\uC131(\uB9C8\uC774\uADF8\uB808\uC774\uC158 \uD3EC\uD568)\uC744 \uC791\uC131\uD558\uC138\uC694.
+${changes}
 
 ## \uD14C\uC2A4\uD2B8
 
 ### \uC2E4\uD589\uD55C \uD14C\uC2A4\uD2B8
 
-- [ ] TODO: \`<\uC2E4\uD589\uD55C \uD14C\uC2A4\uD2B8 \uBA85\uB839\uC5B4>\` \u2014 PASS/FAIL
-- [ ] TODO: \uBBF8\uC2E4\uD589 \uD14C\uC2A4\uD2B8\uAC00 \uC788\uB2E4\uBA74 \uC0AC\uC720\uB97C \uC791\uC131\uD558\uC138\uC694.
+${tests}
+${screenshotsSection}
+${mermaidSection}
 
 ## \uAD00\uB828 \uBB38\uC11C
 
-- **Spec**: \`${paths.specPath}\`
-- **Tasks**: \`${paths.tasksPath}\`${closes}`;
+- **Spec**: \`${bodyPaths.specPath}\`
+- **Tasks**: \`${bodyPaths.tasksPath}\`${closes}`;
   }
   return `## Overview
 
@@ -6571,26 +7401,26 @@ ${overview}
 
 ## Changes
 
-- [ ] TODO: Summarize key code changes in this PR.
-- [ ] TODO: Describe impact/scope (including migration if any).
+${changes}
 
 ## Tests
 
 ### Tests Run
 
-- [ ] TODO: \`<test command>\` \u2014 PASS/FAIL
-- [ ] TODO: If tests were not run, explain why.
+${tests}
+${screenshotsSection}
+${mermaidSection}
 
 ## Related Documents
 
-- **Spec**: \`${paths.specPath}\`
-- **Tasks**: \`${paths.tasksPath}\`${closes}`;
+- **Spec**: \`${bodyPaths.specPath}\`
+- **Tasks**: \`${bodyPaths.tasksPath}\`${closes}`;
 }
 function getRequiredIssueSections(lang) {
-  return lang === "ko" ? ["\uAC1C\uC694", "\uBAA9\uD45C", "\uC644\uB8CC \uAE30\uC900", "\uAD00\uB828 \uBB38\uC11C", "\uB77C\uBCA8"] : ["Overview", "Goals", "Completion Criteria", "Related Documents", "Labels"];
+  return getGithubDraftRequiredSections("issue", lang);
 }
 function getRequiredPrSections(lang) {
-  return lang === "ko" ? ["\uAC1C\uC694", "\uBCC0\uACBD \uC0AC\uD56D", "\uD14C\uC2A4\uD2B8", "\uAD00\uB828 \uBB38\uC11C"] : ["Overview", "Changes", "Tests", "Related Documents"];
+  return getGithubDraftRequiredSections("pr", lang);
 }
 function replaceListField(content, keys, value) {
   for (const key of keys) {
@@ -6621,10 +7451,10 @@ function insertFieldInGithubIssueSection(content, key, value) {
   return { content: lines.join("\n"), changed: true };
 }
 function syncTasksPrMetadata(tasksPath, prUrl, nextStatus, lang) {
-  if (!fs15.existsSync(tasksPath)) {
+  if (!fs14.existsSync(tasksPath)) {
     throw createCliError("DOCS_NOT_FOUND", tg(lang, "tasksNotFound", { path: tasksPath }));
   }
-  const original = fs15.readFileSync(tasksPath, "utf-8");
+  const original = fs14.readFileSync(tasksPath, "utf-8");
   let next = original;
   let changed = false;
   const prReplaced = replaceListField(next, ["PR", "Pull Request"], prUrl);
@@ -6648,7 +7478,7 @@ function syncTasksPrMetadata(tasksPath, prUrl, nextStatus, lang) {
     changed = changed || inserted.changed;
   }
   if (changed) {
-    fs15.writeFileSync(tasksPath, next, "utf-8");
+    fs14.writeFileSync(tasksPath, next, "utf-8");
   }
   return { changed, path: tasksPath };
 }
@@ -6676,7 +7506,7 @@ function ensureCleanWorktree(cwd, lang) {
   }
 }
 function commitAndPushPath(cwd, absPath, message, lang) {
-  const relativePath = path17.relative(cwd, absPath) || absPath;
+  const relativePath = path18.relative(cwd, absPath) || absPath;
   const status = runProcessOrThrow(
     "git",
     ["status", "--porcelain=v1", "--", relativePath],
@@ -6808,15 +7638,25 @@ function githubCommand(program2) {
         [paths.specPath, paths.planPath, paths.tasksPath],
         config.lang
       );
-      const specContent = await fs15.readFile(path17.join(config.docsDir, paths.specPath), "utf-8");
+      const specContent = await fs14.readFile(path18.join(config.docsDir, paths.specPath), "utf-8");
+      const planContent = await fs14.readFile(path18.join(config.docsDir, paths.planPath), "utf-8");
+      const tasksContent = await fs14.readFile(path18.join(config.docsDir, paths.tasksPath), "utf-8");
       const overview = resolveOverviewFromSpec(specContent, feature, config.lang);
       const title = options.title?.trim() || tg(config.lang, "issueDefaultTitle", {
         slug: feature.slug,
         folder: feature.folderName
       });
-      const body = buildIssueBody(overview, labels, paths, config.lang);
+      const generatedBody = buildIssueBody(
+        specContent,
+        planContent,
+        tasksContent,
+        overview,
+        labels,
+        paths,
+        config.lang
+      );
       ensureSections(
-        body,
+        generatedBody,
         getRequiredIssueSections(config.lang),
         tg(config.lang, "kindIssue"),
         config.lang
@@ -6827,10 +7667,23 @@ function githubCommand(program2) {
         config.docsDir,
         feature.type
       );
-      await fs15.ensureDir(path17.dirname(bodyFile));
-      await fs15.writeFile(bodyFile, body, "utf-8");
+      const explicitBodyFile = (options.bodyFile || "").trim();
+      let body = generatedBody;
+      if (options.create && explicitBodyFile && await fs14.pathExists(bodyFile)) {
+        body = await fs14.readFile(bodyFile, "utf-8");
+        ensureSections(
+          body,
+          getRequiredIssueSections(config.lang),
+          tg(config.lang, "kindIssue"),
+          config.lang
+        );
+      } else {
+        await fs14.ensureDir(path18.dirname(bodyFile));
+        await fs14.writeFile(bodyFile, generatedBody, "utf-8");
+      }
       let issueUrl;
       if (options.create) {
+        ensureNoTodoPlaceholders(body, tg(config.lang, "kindIssue"), config.lang);
         assertRemoteApproval(
           options.confirm,
           tg(config.lang, "operationIssueCreate"),
@@ -6914,7 +7767,7 @@ function githubCommand(program2) {
   github.command("pr [feature-name]").description(tg(commandLang, "cmdPrDescription")).option("--json", tg(commandLang, "optJson")).option("--repo <repo>", tg(commandLang, "optRepo")).option("--component <component>", tg(commandLang, "optComponent")).option("--title <title>", tg(commandLang, "optPrTitle")).option("--labels <labels>", tg(commandLang, "optLabels")).option("--body-file <path>", tg(commandLang, "optPrBodyFile")).option("--assignee <assignee>", tg(commandLang, "optPrAssignee")).option("--base <branch>", tg(commandLang, "optPrBase"), "main").option("--create", tg(commandLang, "optPrCreate")).option("--pr <ref>", tg(commandLang, "optPrRef")).option("--merge", tg(commandLang, "optPrMerge")).option(
     "--confirm <reply>",
     tg(commandLang, "optPrConfirm")
-  ).option("--retry <count>", tg(commandLang, "optPrRetry")).option("--no-sync-tasks", tg(commandLang, "optPrNoSyncTasks")).option("--commit-sync", tg(commandLang, "optPrCommitSync")).action(async (featureName, options) => {
+  ).option("--retry <count>", tg(commandLang, "optPrRetry")).option("--screenshots <mode>", tg(commandLang, "optPrScreenshots"), "auto").option("--mermaid <mode>", tg(commandLang, "optPrMermaid"), "auto").option("--no-sync-tasks", tg(commandLang, "optPrNoSyncTasks")).option("--commit-sync", tg(commandLang, "optPrCommitSync")).action(async (featureName, options) => {
     try {
       const selectedComponent = resolveComponentOption4(options, commandLang);
       const { config, feature } = await resolveFeatureOrThrow(featureName, {
@@ -6923,7 +7776,10 @@ function githubCommand(program2) {
       const labels = parseLabels(options.labels, config.lang);
       const paths = getFeatureDocPaths(feature);
       ensureDocsExist(config.docsDir, [paths.specPath, paths.tasksPath], config.lang);
-      const specContent = await fs15.readFile(path17.join(config.docsDir, paths.specPath), "utf-8");
+      const specContent = await fs14.readFile(path18.join(config.docsDir, paths.specPath), "utf-8");
+      const planPath = path18.join(config.docsDir, paths.planPath);
+      const planContent = await fs14.pathExists(planPath) ? await fs14.readFile(planPath, "utf-8") : "";
+      const tasksContent = await fs14.readFile(path18.join(config.docsDir, paths.tasksPath), "utf-8");
       const overview = resolveOverviewFromSpec(specContent, feature, config.lang);
       const defaultTitle = feature.issueNumber ? tg(config.lang, "prDefaultTitleWithIssue", {
         issue: feature.issueNumber,
@@ -6932,9 +7788,19 @@ function githubCommand(program2) {
         slug: feature.slug
       });
       const title = options.title?.trim() || defaultTitle;
-      const body = buildPrBody(feature, overview, paths, config.lang);
+      const artifactPolicy = resolvePrArtifactPolicy(config, feature, options);
+      const generatedBody = buildPrBody(
+        feature,
+        specContent,
+        planContent,
+        tasksContent,
+        overview,
+        paths,
+        artifactPolicy,
+        config.lang
+      );
       ensureSections(
-        body,
+        generatedBody,
         getRequiredPrSections(config.lang),
         tg(config.lang, "kindPr"),
         config.lang
@@ -6945,13 +7811,27 @@ function githubCommand(program2) {
         config.docsDir,
         feature.type
       );
-      await fs15.ensureDir(path17.dirname(bodyFile));
-      await fs15.writeFile(bodyFile, body, "utf-8");
+      const explicitBodyFile = (options.bodyFile || "").trim();
+      let body = generatedBody;
+      if (options.create && explicitBodyFile && await fs14.pathExists(bodyFile)) {
+        body = await fs14.readFile(bodyFile, "utf-8");
+        ensureSections(
+          body,
+          getRequiredPrSections(config.lang),
+          tg(config.lang, "kindPr"),
+          config.lang
+        );
+      } else {
+        await fs14.ensureDir(path18.dirname(bodyFile));
+        await fs14.writeFile(bodyFile, generatedBody, "utf-8");
+      }
       const retryCount = toRetryCount(options.retry, config.lang);
       let prUrl = options.pr?.trim() || "";
       let mergedAttempts;
       let syncChanged = false;
       if (options.create) {
+        ensureNoTodoPlaceholders(body, tg(config.lang, "kindPr"), config.lang);
+        ensurePrArtifacts(body, artifactPolicy, config.lang);
         assertRemoteApproval(
           options.confirm,
           tg(config.lang, "operationPrCreate"),
@@ -6995,7 +7875,7 @@ function githubCommand(program2) {
       }
       if (prUrl && options.syncTasks !== false) {
         const synced = syncTasksPrMetadata(
-          path17.join(config.docsDir, paths.tasksPath),
+          path18.join(config.docsDir, paths.tasksPath),
           prUrl,
           "Review",
           config.lang
@@ -7046,6 +7926,10 @@ function githubCommand(program2) {
               labels,
               body,
               bodyFile,
+              artifactPolicy: {
+                screenshots: artifactPolicy.includeScreenshots,
+                mermaid: artifactPolicy.includeMermaid
+              },
               prUrl: prUrl || void 0,
               syncChanged,
               merged: !!options.merge,
@@ -7187,6 +8071,7 @@ function docsCommand(program2) {
         id,
         command: toBuiltinDocCommand(id)
       }));
+      const contract = getGithubDraftContractForBuiltinDoc(docId, config.lang);
       if (options.json) {
         console.log(
           JSON.stringify(
@@ -7202,7 +8087,8 @@ function docsCommand(program2) {
                 hash: loaded.hash,
                 content: loaded.content
               },
-              requiredDocs: followups
+              requiredDocs: followups,
+              contract: contract || void 0
             },
             null,
             2
@@ -7210,7 +8096,7 @@ function docsCommand(program2) {
         );
         return;
       }
-      const relativeFromCwd = path17.relative(process.cwd(), loaded.entry.absolutePath);
+      const relativeFromCwd = path18.relative(process.cwd(), loaded.entry.absolutePath);
       console.log();
       console.log(chalk6.bold(`\u{1F4C4} ${loaded.entry.id}: ${loaded.entry.title}`));
       console.log(
@@ -7300,13 +8186,13 @@ ${version}
   }
   return `${ascii}${footer}`;
 }
-var CACHE_FILE = path17.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+var CACHE_FILE = path18.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path17.join(__dirname$1, "..", "package.json");
-    if (fs15.existsSync(packageJsonPath)) {
-      const pkg = fs15.readJsonSync(packageJsonPath);
+    const packageJsonPath = path18.join(__dirname$1, "..", "package.json");
+    if (fs14.existsSync(packageJsonPath)) {
+      const pkg = fs14.readJsonSync(packageJsonPath);
       return pkg.version;
     }
   } catch {
@@ -7315,8 +8201,8 @@ function getCurrentVersion() {
 }
 function readCache() {
   try {
-    if (fs15.existsSync(CACHE_FILE)) {
-      return fs15.readJsonSync(CACHE_FILE);
+    if (fs14.existsSync(CACHE_FILE)) {
+      return fs14.readJsonSync(CACHE_FILE);
     }
   } catch {
   }
@@ -7404,9 +8290,9 @@ function shouldCheckForUpdates() {
 if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
-    const packageJsonPath = path17.join(__dirname$1, "..", "package.json");
-    if (fs15.existsSync(packageJsonPath)) {
-      const pkg = fs15.readJsonSync(packageJsonPath);
+    const packageJsonPath = path18.join(__dirname$1, "..", "package.json");
+    if (fs14.existsSync(packageJsonPath)) {
+      const pkg = fs14.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);
     }
   } catch {