lee-spec-kit 0.3.0 → 0.4.1

package/dist/index.js

@@ -887,6 +887,7 @@ async function runUpdate(options) {
   console.log(chalk6.green(`\u2705 \uCD1D ${updatedCount}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!`));
 }
 async function updateFolder(sourceDir, targetDir, force, replacements) {
+  const protectedFiles = /* @__PURE__ */ new Set(["custom.md", "constitution.md"]);
   await fs6.ensureDir(targetDir);
   const files = await fs6.readdir(sourceDir);
   let updatedCount = 0;
@@ -895,7 +896,7 @@ async function updateFolder(sourceDir, targetDir, force, replacements) {
     const targetPath = path4.join(targetDir, file);
     const stat = await fs6.stat(sourcePath);
     if (stat.isFile()) {
-      if (file === "custom.md") {
+      if (protectedFiles.has(file)) {
         continue;
       }
       let sourceContent = await fs6.readFile(sourcePath, "utf-8");
@@ -1031,189 +1032,458 @@ async function runConfig(options) {
   await fs6.writeJson(configPath, configFile, { spaces: 2 });
   console.log();
 }
-function isCompletionChecklistDone(feature) {
-  return !!feature.completionChecklist && feature.completionChecklist.total > 0 && feature.completionChecklist.checked === feature.completionChecklist.total;
+
+// src/utils/context/i18n.ts
+function formatTemplate(template, vars) {
+  return template.replace(/\{(\w+)\}/g, (_, key) => {
+    const value = vars[key];
+    return value === void 0 ? `{${key}}` : String(value);
+  });
 }
-var STEP_DEFINITIONS = [
-  {
-    step: 1,
-    name: "Feature \uD3F4\uB354 \uC0DD\uC131",
-    checklist: { done: () => true }
-  },
-  {
-    step: 2,
-    name: "spec.md \uC791\uC131",
-    checklist: { done: (f) => f.specStatus === "Review" || f.specStatus === "Approved" },
-    current: {
-      when: (f) => !f.docs.specExists || !f.specStatus || f.specStatus === "Draft",
-      actions: (f) => [
-        {
-          type: "instruction",
-          message: !f.docs.specExists ? "spec.md \uD30C\uC77C\uC744 \uC791\uC131\uD558\uC138\uC694. (\uC0C1\uD0DC: Draft\uBD80\uD130 \uC2DC\uC791)" : "spec.md\uB97C \uC791\uC131/\uBCF4\uC644\uD558\uACE0, Status\uB97C Review\uB85C \uBCC0\uACBD\uD55C \uB4A4 \uC0AC\uC6A9\uC790 \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uC138\uC694."
-        }
-      ]
-    }
-  },
-  {
-    step: 3,
-    name: "spec.md \uC2B9\uC778",
-    checklist: { done: (f) => f.specStatus === "Approved" },
-    current: {
-      when: (f) => f.specStatus === "Review",
-      actions: () => [
-        {
-          type: "instruction",
-          message: "\uC0AC\uC6A9\uC790\uC5D0\uAC8C spec.md\uB97C \uACF5\uC720\uD558\uACE0 \uBA85\uC2DC\uC801 \uC2B9\uC778(Approved)\uC744 \uBC1B\uC73C\uC138\uC694."
-        }
-      ]
+var I18N = {
+  ko: {
+    steps: {
+      featureFolder: "Feature \uD3F4\uB354 \uC0DD\uC131",
+      specWrite: "spec.md \uC791\uC131",
+      specApprove: "spec.md \uC2B9\uC778",
+      planWrite: "plan.md \uC791\uC131",
+      planApprove: "plan.md \uC2B9\uC778",
+      tasksWrite: "tasks.md \uC791\uC131",
+      docsCommitPlanning: "\uBB38\uC11C \uCEE4\uBC0B(\uAE30\uD68D)",
+      issueCreate: "GitHub Issue \uC0DD\uC131",
+      branchCreate: "\uBE0C\uB79C\uCE58 \uC0DD\uC131",
+      tasksExecute: "\uD0DC\uC2A4\uD06C \uC2E4\uD589",
+      prCreate: "PR \uC0DD\uC131",
+      codeReview: "\uCF54\uB4DC \uB9AC\uBDF0",
+      featureDone: "Feature \uC644\uB8CC"
+    },
+    messages: {
+      specCreate: "spec.md \uD15C\uD50C\uB9BF\uC744 \uBCF5\uC0AC\uD574 \uC791\uC131\uD558\uC138\uC694. (features/feature-base/spec.md \uCC38\uACE0)",
+      specImprove: "spec.md\uB97C \uBCF4\uC644\uD558\uACE0 \uC0C1\uD0DC\uB97C Review\uB85C \uBCC0\uACBD\uD558\uC138\uC694.",
+      specApproval: "spec.md \uB0B4\uC6A9\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uACF5\uC720\uD558\uACE0 \uC2B9\uC778(OK)\uC744 \uBC1B\uC73C\uC138\uC694.",
+      planCreate: "plan.md \uD15C\uD50C\uB9BF\uC744 \uBCF5\uC0AC\uD574 \uC791\uC131\uD558\uC138\uC694. (features/feature-base/plan.md \uCC38\uACE0)",
+      planImprove: "plan.md\uB97C \uBCF4\uC644\uD558\uACE0 \uC0C1\uD0DC\uB97C Review\uB85C \uBCC0\uACBD\uD558\uC138\uC694.",
+      planApproval: "plan.md \uB0B4\uC6A9\uC744 \uC0AC\uC6A9\uC790\uC5D0\uAC8C \uACF5\uC720\uD558\uACE0 \uC2B9\uC778(OK)\uC744 \uBC1B\uC73C\uC138\uC694.",
+      tasksCreate: "tasks.md \uD15C\uD50C\uB9BF\uC744 \uBCF5\uC0AC\uD574 \uD0DC\uC2A4\uD06C\uB97C \uC791\uC131\uD558\uC138\uC694. (features/feature-base/tasks.md \uCC38\uACE0)",
+      tasksNeedAtLeastOne: "tasks.md\uC5D0 \uCD5C\uC18C 1\uAC1C \uC774\uC0C1\uC758 \uD0DC\uC2A4\uD06C\uB97C \uC791\uC131\uD558\uC138\uC694.",
+      docsCommitPlanning: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs({folderName}): \uAE30\uD68D \uBB38\uC11C \uC791\uC131"',
+      issueCreateAndWrite: "GitHub Issue\uB97C \uC0DD\uC131\uD55C \uB4A4, spec.md/tasks.md\uC758 \uC774\uC288 \uBC88\uD638\uB97C \uCC44\uC6B0\uACE0 \uBB38\uC11C \uCEE4\uBC0B\uC744 \uC900\uBE44\uD558\uC138\uC694. (skills/create-issue.md \uCC38\uACE0)",
+      docsCommitIssueUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs({folderName}): \uC774\uC288 #{issueNumber} \uBC18\uC601"',
+      standaloneNeedsProjectRoot: "standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot \uC124\uC815\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)",
+      createBranch: 'cd "{projectGitCwd}" && git checkout -b feat/{issueNumber}-{slug}',
+      tasksAllDoneButNoChecklist: '\uBAA8\uB4E0 \uD0DC\uC2A4\uD06C\uAC00 DONE\uC774\uC9C0\uB9CC \uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8 \uC139\uC158\uC744 \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. tasks.md\uC758 "\uC644\uB8CC \uC870\uAC74" \uC139\uC158\uC744 \uCD94\uAC00/\uD655\uC778\uD558\uC138\uC694.',
+      tasksAllDoneButChecklist: "\uBAA8\uB4E0 \uD0DC\uC2A4\uD06C\uAC00 DONE\uC774\uC9C0\uB9CC \uC644\uB8CC \uC870\uAC74 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uAC00 \uC644\uC804\uD788 \uCCB4\uD06C\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. ({checked}/{total})",
+      finishDoingTask: '\uD604\uC7AC DOING/REVIEW \uC911\uC778 \uD0DC\uC2A4\uD06C\uB97C \uC644\uB8CC\uD558\uC138\uC694: "{title}" ({done}/{total}) (skills/execute-task.md \uCC38\uACE0)',
+      startNextTodoTask: '\uB2E4\uC74C TODO \uD0DC\uC2A4\uD06C\uB97C \uC2DC\uC791\uD558\uC138\uC694: "{title}" ({done}/{total}) (skills/execute-task.md \uCC38\uACE0)',
+      checkTaskStatuses: "\uD0DC\uC2A4\uD06C \uC0C1\uD0DC\uB97C \uD655\uC778\uD558\uC138\uC694. ({done}/{total}) (skills/execute-task.md \uCC38\uACE0)",
+      prLegacyAsk: "tasks.md\uC5D0 PR/PR \uC0C1\uD0DC \uD544\uB4DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. \uD15C\uD50C\uB9BF\uC744 \uCD5C\uC2E0 \uD3EC\uB9F7\uC73C\uB85C \uC5C5\uB370\uC774\uD2B8\uD560\uAE4C\uC694? (OK \uD544\uC694)",
+      prCreate: "PR\uC744 \uC0DD\uC131\uD558\uACE0 tasks.md\uC5D0 PR \uB9C1\uD06C\uB97C \uAE30\uB85D\uD558\uC138\uC694. (skills/create-pr.md \uCC38\uACE0)",
+      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.",
+      featureDone: "PR\uC774 Approved\uC774\uACE0 \uBAA8\uB4E0 \uD0DC\uC2A4\uD06C/\uC644\uB8CC \uC870\uAC74\uC774 \uCDA9\uC871\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uC774 Feature\uB294 \uC644\uB8CC \uC0C1\uD0DC\uC785\uB2C8\uB2E4.",
+      fallbackRerunContext: "\uC0C1\uD0DC\uB97C \uD310\uBCC4\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBB38\uC11C\uB97C \uD655\uC778\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uC2E4\uD589\uD558\uC138\uC694."
+    },
+    warnings: {
+      projectBranchUnavailable: "\uD504\uB85C\uC81D\uD2B8 \uBE0C\uB79C\uCE58\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (standalone \uBAA8\uB4DC\uC5D0\uC11C\uB294 projectRoot\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.)",
+      docsGitUnavailable: "docs \uB808\uD3EC\uC758 git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (\uB808\uD3EC \uC704\uCE58 / git init \uD655\uC778)",
+      legacyTasksPrFields: "\uAD6C\uBC84\uC804 tasks.md \uD3EC\uB9F7\uC785\uB2C8\uB2E4. PR \uB2E8\uACC4 \uC804\uC5D0 `PR` \uBC0F `PR \uC0C1\uD0DC` \uD544\uB4DC\uB97C \uCD94\uAC00\uD558\uC138\uC694."
     }
   },
-  {
-    step: 4,
-    name: "GitHub Issue \uC0DD\uC131",
-    checklist: { done: (f) => !!f.issueNumber },
-    current: {
-      when: (f) => f.specStatus === "Approved" && !f.issueNumber,
-      actions: () => [
-        {
-          type: "instruction",
-          message: "GitHub Issue\uB97C \uC0DD\uC131\uD558\uACE0 spec.md\uC758 **\uC774\uC288 \uBC88\uD638**\uC5D0 #\uBC88\uD638\uB97C \uAE30\uC785\uD558\uC138\uC694."
-        }
-      ]
+  en: {
+    steps: {
+      featureFolder: "Create feature folder",
+      specWrite: "Write spec.md",
+      specApprove: "Approve spec.md",
+      planWrite: "Write plan.md",
+      planApprove: "Approve plan.md",
+      tasksWrite: "Write tasks.md",
+      docsCommitPlanning: "Commit planning docs",
+      issueCreate: "Create GitHub Issue",
+      branchCreate: "Create branch",
+      tasksExecute: "Execute tasks",
+      prCreate: "Create PR",
+      codeReview: "Code review",
+      featureDone: "Feature done"
+    },
+    messages: {
+      specCreate: "Copy the spec.md template and write it. (See features/feature-base/spec.md)",
+      specImprove: "Improve spec.md and set Status to Review.",
+      specApproval: "Share spec.md with the user and get approval (OK).",
+      planCreate: "Copy the plan.md template and write it. (See features/feature-base/plan.md)",
+      planImprove: "Improve plan.md and set Status to Review.",
+      planApproval: "Share plan.md with the user and get approval (OK).",
+      tasksCreate: "Copy the tasks.md template and write tasks. (See features/feature-base/tasks.md)",
+      tasksNeedAtLeastOne: "Add at least one task to tasks.md.",
+      docsCommitPlanning: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs({folderName}): planning docs"',
+      issueCreateAndWrite: "Create a GitHub Issue, then fill in the issue number in spec.md/tasks.md and prepare to commit docs. (See skills/create-issue.md)",
+      docsCommitIssueUpdate: 'cd "{docsGitCwd}" && git add "{featurePath}" && git commit -m "docs({folderName}): issue #{issueNumber}"',
+      standaloneNeedsProjectRoot: "In standalone mode, projectRoot is required. (npx lee-spec-kit config --project-root ...)",
+      createBranch: 'cd "{projectGitCwd}" && git checkout -b feat/{issueNumber}-{slug}',
+      tasksAllDoneButNoChecklist: 'All tasks are DONE but no completion checklist section was found. Add/verify the "Completion Criteria" section in tasks.md.',
+      tasksAllDoneButChecklist: "All tasks are DONE but the completion checklist is not fully checked. ({checked}/{total})",
+      finishDoingTask: 'Finish the active DOING/REVIEW task: "{title}" ({done}/{total}) (See skills/execute-task.md)',
+      startNextTodoTask: 'Start the next TODO task: "{title}" ({done}/{total}) (See skills/execute-task.md)',
+      checkTaskStatuses: "Check task statuses. ({done}/{total}) (See skills/execute-task.md)",
+      prLegacyAsk: "Legacy tasks.md format detected (missing PR/PR Status fields). Update to the latest format? (OK required)",
+      prCreate: "Create a PR and record the PR link in tasks.md. (See skills/create-pr.md)",
+      prResolveReview: "Resolve review comments and update PR status. (PR Status: Review \u2192 Approved)",
+      prRequestReview: "Request reviews and update PR status to Review.",
+      featureDone: "PR is Approved and all tasks/completion criteria are satisfied. This feature is done.",
+      fallbackRerunContext: "Unable to determine current state. Verify docs and run context again."
+    },
+    warnings: {
+      projectBranchUnavailable: "Cannot determine project branch. (In standalone mode, projectRoot is required.)",
+      docsGitUnavailable: "Cannot read git status for the docs repo. (Check repo location / git init.)",
+      legacyTasksPrFields: "Legacy tasks.md format detected. Add `PR` and `PR Status` fields before PR steps."
     }
-  },
-  {
-    step: 5,
-    name: "\uBE0C\uB79C\uCE58 \uC0DD\uC131",
-    checklist: { done: (f) => f.git.onExpectedBranch },
-    current: {
-      when: (f) => !!f.issueNumber && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
-      actions: (f) => {
-        if (!f.git.projectBranchAvailable || !f.git.projectGitCwd) {
+  }
+};
+function tr(lang, category, key, vars = {}) {
+  const template = I18N[lang][category][key] ?? I18N.ko[category][key] ?? `${category}.${key}`;
+  return formatTemplate(template, vars);
+}
+
+// src/utils/context/steps.ts
+function isCompletionChecklistDone(feature) {
+  return !!feature.completionChecklist && feature.completionChecklist.total > 0 && feature.completionChecklist.checked === feature.completionChecklist.total;
+}
+function isPrMetadataConfigured(feature) {
+  return feature.docs.prFieldExists && feature.docs.prStatusFieldExists;
+}
+function isFeatureDone(feature) {
+  return feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature) && isPrMetadataConfigured(feature) && !!feature.pr.link && feature.pr.status === "Approved";
+}
+function getStepDefinitions(lang) {
+  return [
+    {
+      step: 1,
+      name: tr(lang, "steps", "featureFolder"),
+      checklist: { done: () => true }
+    },
+    {
+      step: 2,
+      name: tr(lang, "steps", "specWrite"),
+      checklist: {
+        done: (f) => f.specStatus === "Review" || f.specStatus === "Approved"
+      },
+      current: {
+        when: (f) => !f.docs.specExists || !f.specStatus || f.specStatus === "Draft",
+        actions: (f) => [
+          {
+            type: "instruction",
+            message: !f.docs.specExists ? tr(lang, "messages", "specCreate") : tr(lang, "messages", "specImprove")
+          }
+        ]
+      }
+    },
+    {
+      step: 3,
+      name: tr(lang, "steps", "specApprove"),
+      checklist: { done: (f) => f.specStatus === "Approved" },
+      current: {
+        when: (f) => f.specStatus === "Review",
+        actions: () => [
+          {
+            type: "instruction",
+            requiresUserOk: true,
+            message: tr(lang, "messages", "specApproval")
+          }
+        ]
+      }
+    },
+    {
+      step: 4,
+      name: tr(lang, "steps", "planWrite"),
+      checklist: {
+        done: (f) => f.planStatus === "Review" || f.planStatus === "Approved"
+      },
+      current: {
+        when: (f) => f.specStatus === "Approved" && (!f.docs.planExists || !f.planStatus || f.planStatus === "Draft"),
+        actions: (f) => [
+          {
+            type: "instruction",
+            message: !f.docs.planExists ? tr(lang, "messages", "planCreate") : tr(lang, "messages", "planImprove")
+          }
+        ]
+      }
+    },
+    {
+      step: 5,
+      name: tr(lang, "steps", "planApprove"),
+      checklist: { done: (f) => f.planStatus === "Approved" },
+      current: {
+        when: (f) => f.planStatus === "Review",
+        actions: () => [
+          {
+            type: "instruction",
+            requiresUserOk: true,
+            message: tr(lang, "messages", "planApproval")
+          }
+        ]
+      }
+    },
+    {
+      step: 6,
+      name: tr(lang, "steps", "tasksWrite"),
+      checklist: {
+        done: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.docs.prFieldExists && f.docs.prStatusFieldExists,
+        detail: (f) => f.tasks.total > 0 ? `(${f.tasks.total})` : ""
+      },
+      current: {
+        when: (f) => f.planStatus === "Approved" && (!f.docs.tasksExists || f.tasks.total === 0 || f.docs.tasksExists && f.tasks.total > 0 && (!f.docs.prFieldExists || !f.docs.prStatusFieldExists)),
+        actions: (f) => {
+          if (f.docs.tasksExists && f.tasks.total > 0 && (!f.docs.prFieldExists || !f.docs.prStatusFieldExists)) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "prLegacyAsk")
+              }
+            ];
+          }
+          if (!f.docs.tasksExists) {
+            return [
+              {
+                type: "instruction",
+                message: tr(lang, "messages", "tasksCreate")
+              }
+            ];
+          }
           return [
             {
               type: "instruction",
-              message: "standalone \uBAA8\uB4DC\uB77C\uBA74 projectRoot\uB97C \uC124\uC815\uD55C \uB4A4 \uB2E4\uC2DC context\uB97C \uD655\uC778\uD558\uC138\uC694. (npx lee-spec-kit config --project-root ...)"
+              message: tr(lang, "messages", "tasksNeedAtLeastOne")
             }
           ];
         }
-        return [
+      }
+    },
+    {
+      step: 7,
+      name: tr(lang, "steps", "docsCommitPlanning"),
+      checklist: {
+        done: (f) => f.issueNumber ? true : f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && !f.git.docsHasUncommittedChanges
+      },
+      current: {
+        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && !f.issueNumber && f.git.docsHasUncommittedChanges,
+        actions: (f) => [
           {
             type: "command",
-            scope: "project",
-            cwd: f.git.projectGitCwd,
-            cmd: `git -C "${f.git.projectGitCwd}" checkout -b feat/${f.issueNumber}-${f.slug}`
+            requiresUserOk: true,
+            scope: "docs",
+            cwd: f.git.docsGitCwd,
+            cmd: tr(lang, "messages", "docsCommitPlanning", {
+              docsGitCwd: f.git.docsGitCwd,
+              featurePath: f.docs.featurePathFromDocs,
+              folderName: f.folderName
+            })
           }
-        ];
+        ]
       }
-    }
-  },
-  {
-    step: 6,
-    name: "plan.md \uC791\uC131",
-    checklist: { done: (f) => f.planStatus === "Review" || f.planStatus === "Approved" },
-    current: {
-      when: (f) => f.git.onExpectedBranch && (!f.docs.planExists || !f.planStatus || f.planStatus === "Draft"),
-      actions: (f) => [
-        {
-          type: "instruction",
-          message: !f.docs.planExists ? "plan.md\uB97C \uC791\uC131\uD558\uC138\uC694. (\uC0C1\uD0DC: Draft\uBD80\uD130 \uC2DC\uC791)" : "plan.md\uB97C \uC791\uC131/\uBCF4\uC644\uD558\uACE0, Status\uB97C Review\uB85C \uBCC0\uACBD\uD55C \uB4A4 \uC0AC\uC6A9\uC790 \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uC138\uC694."
-        }
-      ]
-    }
-  },
-  {
-    step: 7,
-    name: "plan.md \uC2B9\uC778",
-    checklist: { done: (f) => f.planStatus === "Approved" },
-    current: {
-      when: (f) => f.planStatus === "Review",
-      actions: () => [
-        {
-          type: "instruction",
-          message: "\uC0AC\uC6A9\uC790\uC5D0\uAC8C plan.md\uB97C \uACF5\uC720\uD558\uACE0 \uBA85\uC2DC\uC801 \uC2B9\uC778(Approved)\uC744 \uBC1B\uC73C\uC138\uC694."
-        }
-      ]
-    }
-  },
-  {
-    step: 8,
-    name: "tasks.md \uC791\uC131/\uC2E4\uD589",
-    checklist: {
-      done: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done,
-      detail: (f) => f.tasks.total > 0 ? `(${f.tasks.done}/${f.tasks.total})` : ""
     },
-    current: {
-      when: (f) => f.planStatus === "Approved" && (!f.docs.tasksExists || f.tasks.total === 0 || f.tasks.done < f.tasks.total),
-      actions: (f) => {
-        let message = "";
-        if (!f.docs.tasksExists) {
-          message = "tasks.md\uB97C \uC791\uC131\uD558\uC138\uC694. (\uAC01 \uD0DC\uC2A4\uD06C \uC0C1\uD0DC: [TODO])";
-          return [{ type: "instruction", message }];
-        }
-        if (f.tasks.total === 0) {
-          message = "tasks.md\uC5D0 \uCD5C\uC18C 1\uAC1C \uC774\uC0C1\uC758 \uD0DC\uC2A4\uD06C\uB97C \uC791\uC131\uD558\uC138\uC694.";
-          return [{ type: "instruction", message }];
-        }
-        if (f.activeTask) {
-          message = `[DOING] \uD0DC\uC2A4\uD06C\uB97C \uC644\uB8CC\uD558\uC138\uC694: ${f.activeTask.title} (\uC9C4\uD589\uB960: ${f.tasks.done}/${f.tasks.total})`;
-          return [{ type: "instruction", message }];
+    {
+      step: 8,
+      name: tr(lang, "steps", "issueCreate"),
+      checklist: {
+        done: (f) => !!f.issueNumber && !f.git.docsHasUncommittedChanges
+      },
+      current: {
+        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.specStatus === "Approved" && f.planStatus === "Approved" && (!f.issueNumber || f.git.docsHasUncommittedChanges),
+        actions: (f) => {
+          if (!f.issueNumber) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "issueCreateAndWrite")
+              }
+            ];
+          }
+          return [
+            {
+              type: "command",
+              requiresUserOk: true,
+              scope: "docs",
+              cwd: f.git.docsGitCwd,
+              cmd: tr(lang, "messages", "docsCommitIssueUpdate", {
+                docsGitCwd: f.git.docsGitCwd,
+                featurePath: f.docs.featurePathFromDocs,
+                issueNumber: f.issueNumber,
+                folderName: f.folderName
+              })
+            }
+          ];
         }
-        if (f.nextTodoTask) {
-          message = `\uB2E4\uC74C \uD0DC\uC2A4\uD06C\uB97C [DOING]\uC73C\uB85C \uBCC0\uACBD\uD558\uACE0 \uC2DC\uC791\uD558\uC138\uC694: ${f.nextTodoTask.title} (\uC9C4\uD589\uB960: ${f.tasks.done}/${f.tasks.total})`;
-          return [{ type: "instruction", message }];
+      }
+    },
+    {
+      step: 9,
+      name: tr(lang, "steps", "branchCreate"),
+      checklist: { done: (f) => f.git.onExpectedBranch },
+      current: {
+        when: (f) => !!f.issueNumber && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
+        actions: (f) => {
+          if (!f.git.projectBranchAvailable || !f.git.projectGitCwd) {
+            return [
+              {
+                type: "instruction",
+                message: tr(lang, "messages", "standaloneNeedsProjectRoot")
+              }
+            ];
+          }
+          return [
+            {
+              type: "command",
+              scope: "project",
+              cwd: f.git.projectGitCwd,
+              cmd: tr(lang, "messages", "createBranch", {
+                projectGitCwd: f.git.projectGitCwd,
+                issueNumber: f.issueNumber,
+                slug: f.slug
+              })
+            }
+          ];
         }
-        message = `tasks.md\uC758 \uD0DC\uC2A4\uD06C \uC0C1\uD0DC([TODO]/[DOING]/[DONE])\uB97C \uD655\uC778\uD558\uC138\uC694. (\uC9C4\uD589\uB960: ${f.tasks.done}/${f.tasks.total})`;
-        return [{ type: "instruction", message }];
       }
-    }
-  },
-  {
-    step: 9,
-    name: "\uBB38\uC11C \uCEE4\uBC0B \uC804 \uD655\uC778",
-    checklist: {
-      done: (f) => isCompletionChecklistDone(f),
-      detail: (f) => f.completionChecklist ? `(${f.completionChecklist.checked}/${f.completionChecklist.total})` : ""
     },
-    current: {
-      when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f),
-      actions: (f) => [
-        {
-          type: "instruction",
-          message: !f.completionChecklist ? '\uBAA8\uB4E0 \uD0DC\uC2A4\uD06C\uAC00 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. tasks.md\uC5D0 "\uC644\uB8CC \uC870\uAC74" \uCCB4\uD06C\uB9AC\uC2A4\uD2B8\uB97C \uCD94\uAC00/\uD655\uC778\uD55C \uB4A4 \uC9C4\uD589\uD558\uC138\uC694.' : `\uBB38\uC11C \uCEE4\uBC0B \uC804 \uCCB4\uD06C\uB9AC\uC2A4\uD2B8(\uC644\uB8CC \uC870\uAC74)\uB97C \uC2E4\uC81C\uB85C \uD655\uC778\uD558\uACE0 \uCCB4\uD06C\uD558\uC138\uC694. (${f.completionChecklist.checked}/${f.completionChecklist.total})`
+    {
+      step: 10,
+      name: tr(lang, "steps", "tasksExecute"),
+      checklist: {
+        done: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && isCompletionChecklistDone(f),
+        detail: (f) => f.tasks.total > 0 ? `(${f.tasks.done}/${f.tasks.total})` : ""
+      },
+      current: {
+        when: (f) => f.git.onExpectedBranch && f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)),
+        actions: (f) => {
+          if (f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f)) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: !f.completionChecklist ? tr(lang, "messages", "tasksAllDoneButNoChecklist") : tr(lang, "messages", "tasksAllDoneButChecklist", {
+                  checked: f.completionChecklist.checked,
+                  total: f.completionChecklist.total
+                })
+              }
+            ];
+          }
+          if (f.activeTask) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "finishDoingTask", {
+                  title: f.activeTask.title,
+                  done: f.tasks.done,
+                  total: f.tasks.total
+                })
+              }
+            ];
+          }
+          if (f.nextTodoTask) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "startNextTodoTask", {
+                  title: f.nextTodoTask.title,
+                  done: f.tasks.done,
+                  total: f.tasks.total
+                })
+              }
+            ];
+          }
+          return [
+            {
+              type: "instruction",
+              requiresUserOk: true,
+              message: tr(lang, "messages", "checkTaskStatuses", {
+                done: f.tasks.done,
+                total: f.tasks.total
+              })
+            }
+          ];
         }
-      ]
-    }
-  },
-  {
-    step: 10,
-    name: "\uBB38\uC11C \uCEE4\uBC0B",
-    checklist: {
-      done: (f) => isCompletionChecklistDone(f) && !f.git.docsHasUncommittedChanges
+      }
     },
-    current: {
-      when: (f) => isCompletionChecklistDone(f),
-      actions: (f) => f.git.docsHasUncommittedChanges ? [
-        {
-          type: "command",
-          scope: "docs",
-          cwd: f.git.docsGitCwd,
-          cmd: `git -C "${f.git.docsGitCwd}" add "${f.docs.featurePathFromDocs}" && git -C "${f.git.docsGitCwd}" commit -m "docs(#${f.issueNumber ?? "<issue>"}): ${f.folderName} \uBB38\uC11C \uC5C5\uB370\uC774\uD2B8"`
+    {
+      step: 11,
+      name: tr(lang, "steps", "prCreate"),
+      checklist: { done: (f) => isPrMetadataConfigured(f) && !!f.pr.link },
+      current: {
+        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && f.tasks.total === f.tasks.done && isCompletionChecklistDone(f) && (!isPrMetadataConfigured(f) || !f.pr.link),
+        actions: (f) => {
+          if (!isPrMetadataConfigured(f)) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "prLegacyAsk")
+              }
+            ];
+          }
+          return [
+            {
+              type: "instruction",
+              requiresUserOk: true,
+              message: tr(lang, "messages", "prCreate")
+            }
+          ];
         }
-      ] : [
-        {
-          type: "instruction",
-          message: "\uBB38\uC11C \uCEE4\uBC0B\uC774 \uC644\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4. \uB2E4\uC74C Feature\uB85C \uC774\uB3D9\uD558\uC138\uC694."
+      }
+    },
+    {
+      step: 12,
+      name: tr(lang, "steps", "codeReview"),
+      checklist: {
+        done: (f) => isPrMetadataConfigured(f) && f.pr.status === "Approved"
+      },
+      current: {
+        when: (f) => isPrMetadataConfigured(f) && !!f.pr.link && f.pr.status !== "Approved",
+        actions: (f) => {
+          if (f.pr.status === "Review") {
+            return [
+              {
+                type: "instruction",
+                message: tr(lang, "messages", "prResolveReview")
+              }
+            ];
+          }
+          return [
+            {
+              type: "instruction",
+              message: tr(lang, "messages", "prRequestReview")
+            }
+          ];
         }
-      ]
+      }
+    },
+    {
+      step: 13,
+      name: tr(lang, "steps", "featureDone"),
+      checklist: { done: (f) => isFeatureDone(f) },
+      current: {
+        when: (f) => isFeatureDone(f),
+        actions: () => [
+          {
+            type: "instruction",
+            message: tr(lang, "messages", "featureDone")
+          }
+        ]
+      }
     }
-  }
-];
-var STEPS = Object.fromEntries(
-  STEP_DEFINITIONS.map((d) => [d.step, d.name])
-);
-function resolveFeatureProgress(feature) {
-  const ordered = [...STEP_DEFINITIONS].sort((a, b) => a.step - b.step);
+  ];
+}
+function getStepsMap(lang) {
+  return Object.fromEntries(getStepDefinitions(lang).map((d) => [d.step, d.name]));
+}
+getStepDefinitions("ko");
+getStepsMap("ko");
+
+// src/utils/context/progress.ts
+function resolveFeatureProgress(feature, stepDefinitions, lang) {
+  const ordered = [...stepDefinitions].sort((a, b) => a.step - b.step);
   for (const definition of ordered) {
     if (!definition.current) continue;
     if (definition.current.when(feature)) {
@@ -1229,9 +1499,12 @@ function resolveFeatureProgress(feature) {
   return {
     currentStep: lastStep?.step ?? 10,
     actions: [
-      { type: "instruction", message: "npx lee-spec-kit context\uB85C \uC0C1\uD0DC\uB97C \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694." }
+      {
+        type: "instruction",
+        message: tr(lang, "messages", "fallbackRerunContext")
+      }
     ],
-    nextAction: "npx lee-spec-kit context\uB85C \uC0C1\uD0DC\uB97C \uB2E4\uC2DC \uD655\uC778\uD558\uC138\uC694."
+    nextAction: tr(lang, "messages", "fallbackRerunContext")
   };
 }
 function getCurrentBranch(cwd) {
@@ -1245,6 +1518,72 @@ function getCurrentBranch(cwd) {
     return "";
   }
 }
+function getGitStatusPorcelain(cwd, relativePaths) {
+  try {
+    const args = relativePaths.length > 0 ? ` -- ${relativePaths.map((p) => `"${p}"`).join(" ")}` : "";
+    return execSync(`git status --porcelain=v1${args}`, {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+  } catch {
+    return void 0;
+  }
+}
+function getGitTopLevel(cwd) {
+  try {
+    return execSync("git rev-parse --show-toplevel", {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    return null;
+  }
+}
+function resolveProjectGitCwd(config, repo) {
+  const docsRepo = config.docsRepo;
+  if (docsRepo !== "standalone") {
+    const topLevel = getGitTopLevel(process.cwd());
+    return { cwd: topLevel || process.cwd() };
+  }
+  if (!config.projectRoot) {
+    return {
+      cwd: null,
+      warning: "standalone \uBAA8\uB4DC\uC785\uB2C8\uB2E4. projectRoot\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC544 \uD504\uB85C\uC81D\uD2B8 \uBE0C\uB79C\uCE58 \uD655\uC778\uC774 \uBD88\uAC00\uB2A5\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)"
+    };
+  }
+  if (config.projectType === "fullstack") {
+    if (typeof config.projectRoot === "string") {
+      return {
+        cwd: null,
+        warning: 'fullstack standalone \uBAA8\uB4DC\uC778\uB370 projectRoot \uD615\uD0DC\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (\uC608: { "fe": "...", "be": "..." })'
+      };
+    }
+    const root = config.projectRoot[repo];
+    if (!root) {
+      return {
+        cwd: null,
+        warning: `projectRoot.${repo}\uAC00 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ... --repo ${repo})`
+      };
+    }
+    return { cwd: getGitTopLevel(root) || root };
+  }
+  if (typeof config.projectRoot !== "string") {
+    return {
+      cwd: null,
+      warning: 'single standalone \uBAA8\uB4DC\uC778\uB370 projectRoot \uD615\uD0DC\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (\uC608: "/path/to/project")'
+    };
+  }
+  return { cwd: getGitTopLevel(config.projectRoot) || config.projectRoot };
+}
+function isExpectedFeatureBranch(branchName, issueNumber, slug, folderName) {
+  if (!branchName || !issueNumber) return false;
+  const match = branchName.match(new RegExp(`^feat\\/${issueNumber}-(.+)$`));
+  if (!match) return false;
+  const rest = match[1];
+  return rest === slug || rest === folderName;
+}
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -1279,15 +1618,21 @@ function parseIssueNumber(value) {
   const match = value.match(/#?(\d+)/);
   return match ? match[1] : void 0;
 }
+function parsePrLink(value) {
+  if (!value) return void 0;
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  if (trimmed === "#" || trimmed === "-") return void 0;
+  if (trimmed.includes("{") || trimmed.includes("}")) return void 0;
+  return trimmed;
+}
 function parseTasks(content) {
   const summary = { total: 0, todo: 0, doing: 0, done: 0 };
   let activeTask;
   let nextTodoTask;
   const lines = content.split("\n");
   for (const line of lines) {
-    const match = line.match(
-      /^\s*-\s*\[([A-Z]+)\]((?:\[[^\]]+\])*)\s*(.+?)\s*$/
-    );
+    const match = line.match(/^\s*-\s*\[([A-Z]+)\]((?:\[[^\]]+\])*)\s*(.+?)\s*$/);
     if (!match) continue;
     const status = match[1].toUpperCase();
     const title = match[3].trim();
@@ -1322,73 +1667,8 @@ function parseCompletionChecklist(content) {
   }
   return total > 0 ? { total, checked } : void 0;
 }
-function getGitStatusPorcelain(cwd, relativePaths) {
-  try {
-    const args = relativePaths.length > 0 ? ` -- ${relativePaths.map((p) => `"${p}"`).join(" ")}` : "";
-    return execSync(`git status --porcelain=v1${args}`, {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-  } catch {
-    return void 0;
-  }
-}
-function getGitTopLevel(cwd) {
-  try {
-    return execSync("git rev-parse --show-toplevel", {
-      cwd,
-      encoding: "utf-8",
-      stdio: ["ignore", "pipe", "pipe"]
-    }).trim();
-  } catch {
-    return null;
-  }
-}
-function resolveProjectGitCwd(config, repo) {
-  const docsRepo = config.docsRepo;
-  if (docsRepo !== "standalone") {
-    const topLevel = getGitTopLevel(process.cwd());
-    return { cwd: topLevel || process.cwd() };
-  }
-  if (!config.projectRoot) {
-    return {
-      cwd: null,
-      warning: "standalone \uBAA8\uB4DC\uC785\uB2C8\uB2E4. projectRoot\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC544 \uD504\uB85C\uC81D\uD2B8 \uBE0C\uB79C\uCE58 \uD655\uC778\uC774 \uBD88\uAC00\uB2A5\uD569\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ...)"
-    };
-  }
-  if (config.projectType === "fullstack") {
-    if (typeof config.projectRoot === "string") {
-      return {
-        cwd: null,
-        warning: 'fullstack standalone \uBAA8\uB4DC\uC778\uB370 projectRoot \uD615\uD0DC\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (\uC608: { "fe": "...", "be": "..." })'
-      };
-    }
-    const root = config.projectRoot[repo];
-    if (!root) {
-      return {
-        cwd: null,
-        warning: `projectRoot.${repo}\uAC00 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4. (npx lee-spec-kit config --project-root ... --repo ${repo})`
-      };
-    }
-    return { cwd: getGitTopLevel(root) || root };
-  }
-  if (typeof config.projectRoot !== "string") {
-    return {
-      cwd: null,
-      warning: 'single standalone \uBAA8\uB4DC\uC778\uB370 projectRoot \uD615\uD0DC\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. (\uC608: "/path/to/project")'
-    };
-  }
-  return { cwd: getGitTopLevel(config.projectRoot) || config.projectRoot };
-}
-function isExpectedFeatureBranch(branchName, issueNumber, slug, folderName) {
-  if (!branchName || !issueNumber) return false;
-  const match = branchName.match(new RegExp(`^feat\\/${issueNumber}-(.+)$`));
-  if (!match) return false;
-  const rest = match[1];
-  return rest === slug || rest === folderName;
-}
-async function parseFeature(featurePath, type, context) {
+async function parseFeature(featurePath, type, context, options) {
+  const lang = options.lang;
   const folderName = path4.basename(featurePath);
   const match = folderName.match(/^(F\d+)-(.+)$/);
   const id = match?.[1];
@@ -1403,11 +1683,7 @@ async function parseFeature(featurePath, type, context) {
     const content = await fs6.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"
-    ]);
+    const issueValue = extractFirstSpecValue(content, ["\uC774\uC288 \uBC88\uD638", "Issue Number", "Issue"]);
     issueNumber = parseIssueNumber(issueValue);
   }
   let planStatus;
@@ -1422,6 +1698,10 @@ async function parseFeature(featurePath, type, context) {
   let activeTask;
   let nextTodoTask;
   let completionChecklist;
+  let prLink;
+  let prStatus;
+  let prFieldExists = false;
+  let prStatusFieldExists = false;
   if (tasksExists) {
     const content = await fs6.readFile(tasksPath, "utf-8");
     const { summary, activeTask: active, nextTodoTask: nextTodo } = parseTasks(content);
@@ -1432,12 +1712,20 @@ async function parseFeature(featurePath, type, context) {
     activeTask = active;
     nextTodoTask = nextTodo;
     completionChecklist = parseCompletionChecklist(content);
+    if (!issueNumber) {
+      const issueValue = extractFirstSpecValue(content, ["\uC774\uC288 \uBC88\uD638", "Issue Number", "Issue"]);
+      issueNumber = parseIssueNumber(issueValue);
+    }
+    const prValue = extractFirstSpecValue(content, ["PR", "Pull Request"]);
+    prFieldExists = prValue !== void 0;
+    prLink = parsePrLink(prValue);
+    const prStatusValue = extractFirstSpecValue(content, ["PR \uC0C1\uD0DC", "PR Status"]);
+    prStatusFieldExists = prStatusValue !== void 0;
+    prStatus = parseDocStatus(prStatusValue);
   }
   const warnings = [];
   if (context.projectBranchAvailable === false) {
-    warnings.push(
-      "\uD504\uB85C\uC81D\uD2B8 \uBE0C\uB79C\uCE58\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (standalone \uBAA8\uB4DC\uB77C\uBA74 projectRoot \uC124\uC815\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.)"
-    );
+    warnings.push(tr(lang, "warnings", "projectBranchUnavailable"));
   }
   const onExpectedBranch = isExpectedFeatureBranch(
     context.projectBranch,
@@ -1446,14 +1734,13 @@ async function parseFeature(featurePath, type, context) {
     folderName
   );
   const relativeFeaturePathFromDocs = path4.relative(context.docsDir, featurePath);
-  const docsStatus = getGitStatusPorcelain(context.docsGitCwd, [
-    relativeFeaturePathFromDocs
-  ]);
+  const docsStatus = getGitStatusPorcelain(context.docsGitCwd, [relativeFeaturePathFromDocs]);
   const docsHasUncommittedChanges = docsStatus === void 0 ? true : docsStatus.trim().length > 0;
   if (docsStatus === void 0) {
-    warnings.push(
-      "docs \uB808\uD3EC\uC5D0\uC11C git \uC0C1\uD0DC\uB97C \uD655\uC778\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. (git \uCD08\uAE30\uD654/\uB808\uD3EC \uC704\uCE58\uB97C \uD655\uC778\uD558\uC138\uC694.)"
-    );
+    warnings.push(tr(lang, "warnings", "docsGitUnavailable"));
+  }
+  if (tasksExists && (!prFieldExists || !prStatusFieldExists)) {
+    warnings.push(tr(lang, "warnings", "legacyTasksPrFields"));
   }
   const featureState = {
     id,
@@ -1468,6 +1755,7 @@ async function parseFeature(featurePath, type, context) {
     activeTask,
     nextTodoTask,
     completionChecklist,
+    pr: { link: prLink, status: prStatus },
     git: {
       docsBranch: context.docsBranch,
       projectBranch: context.projectBranch,
@@ -1481,21 +1769,22 @@ async function parseFeature(featurePath, type, context) {
       featurePathFromDocs: relativeFeaturePathFromDocs,
       specExists,
       planExists,
-      tasksExists
+      tasksExists,
+      prFieldExists,
+      prStatusFieldExists
     }
   };
-  const { currentStep, actions, nextAction } = resolveFeatureProgress(featureState);
-  return {
-    ...featureState,
-    currentStep,
-    actions,
-    nextAction,
-    warnings
-  };
+  const { currentStep, actions, nextAction } = resolveFeatureProgress(
+    featureState,
+    options.stepDefinitions,
+    lang
+  );
+  return { ...featureState, currentStep, actions, nextAction, warnings };
 }
 async function scanFeatures(config) {
   const features = [];
   const warnings = [];
+  const stepDefinitions = getStepDefinitions(config.lang);
   const docsBranch = getCurrentBranch(config.docsDir);
   const projectBranches = {
     single: "",
@@ -1526,51 +1815,60 @@ async function scanFeatures(config) {
     for (const dir of featureDirs) {
       if ((await fs6.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)
-          })
+          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 }
+          )
         );
       }
     }
   } else {
-    const feDirs = await glob("features/fe/*/", {
-      cwd: config.docsDir,
-      absolute: true
-    });
-    const beDirs = await glob("features/be/*/", {
-      cwd: config.docsDir,
-      absolute: true
-    });
+    const feDirs = await glob("features/fe/*/", { cwd: config.docsDir, absolute: true });
+    const beDirs = await glob("features/be/*/", { cwd: config.docsDir, absolute: true });
     for (const dir of feDirs) {
       if ((await fs6.stat(dir)).isDirectory()) {
         features.push(
-          await parseFeature(dir, "fe", {
-            projectBranch: projectBranches.fe,
-            docsBranch,
-            docsGitCwd: config.docsDir,
-            projectGitCwd: feProject?.cwd ?? void 0,
-            docsDir: config.docsDir,
-            projectBranchAvailable: Boolean(feProject?.cwd)
-          })
+          await parseFeature(
+            dir,
+            "fe",
+            {
+              projectBranch: projectBranches.fe,
+              docsBranch,
+              docsGitCwd: config.docsDir,
+              projectGitCwd: feProject?.cwd ?? void 0,
+              docsDir: config.docsDir,
+              projectBranchAvailable: Boolean(feProject?.cwd)
+            },
+            { lang: config.lang, stepDefinitions }
+          )
         );
       }
     }
     for (const dir of beDirs) {
       if ((await fs6.stat(dir)).isDirectory()) {
         features.push(
-          await parseFeature(dir, "be", {
-            projectBranch: projectBranches.be,
-            docsBranch,
-            docsGitCwd: config.docsDir,
-            projectGitCwd: beProject?.cwd ?? void 0,
-            docsDir: config.docsDir,
-            projectBranchAvailable: Boolean(beProject?.cwd)
-          })
+          await parseFeature(
+            dir,
+            "be",
+            {
+              projectBranch: projectBranches.be,
+              docsBranch,
+              docsGitCwd: config.docsDir,
+              projectGitCwd: beProject?.cwd ?? void 0,
+              docsDir: config.docsDir,
+              projectBranchAvailable: Boolean(beProject?.cwd)
+            },
+            { lang: config.lang, stepDefinitions }
+          )
         );
       }
     }
@@ -1579,9 +1877,7 @@ async function scanFeatures(config) {
     features,
     branches: {
       docs: docsBranch,
-      project: {
-        ...config.projectType === "single" ? { single: projectBranches.single } : { fe: projectBranches.fe, be: projectBranches.be }
-      }
+      project: config.projectType === "single" ? { single: projectBranches.single } : { fe: projectBranches.fe, be: projectBranches.be }
     },
     warnings
   };
@@ -1628,9 +1924,12 @@ function detectFromBranch(branchName, features) {
 async function runContext(featureName, options) {
   const cwd = process.cwd();
   const config = await getConfig(cwd);
+  const lang = config?.lang ?? "ko";
   if (!config) {
     throw new Error("\uC124\uC815 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.");
   }
+  const stepDefinitions = getStepDefinitions(lang);
+  const stepsMap = getStepsMap(lang);
   const { features, branches, warnings } = await scanFeatures(config);
   let targetFeatures = [];
   if (featureName) {
@@ -1728,7 +2027,7 @@ async function runContext(featureName, options) {
     );
     console.log();
     targetFeatures.forEach((f2) => {
-      const stepName2 = STEPS[f2.currentStep] || "Unknown";
+      const stepName2 = stepsMap[f2.currentStep] || "Unknown";
       const typeStr = config.projectType === "fullstack" ? chalk6.cyan(`(${f2.type})`) : "";
       console.log(
         `   \u2022 ${chalk6.bold(f2.folderName)} ${typeStr} - ${chalk6.yellow(stepName2)}`
@@ -1743,7 +2042,8 @@ async function runContext(featureName, options) {
     return;
   }
   const f = targetFeatures[0];
-  const stepName = STEPS[f.currentStep] || "Unknown";
+  const stepName = stepsMap[f.currentStep] || "Unknown";
+  const okTag = (requiresUserOk) => requiresUserOk ? chalk6.yellow(lang === "ko" ? "[OK \uD544\uC694] " : "[OK required] ") : "";
   console.log(
     `\u{1F539} Feature: ${chalk6.bold(f.folderName)} ${config.projectType === "fullstack" ? chalk6.cyan(`(${f.type})`) : ""}`
   );
@@ -1762,12 +2062,12 @@ async function runContext(featureName, options) {
     console.log(
       `   \u2022 Active Task: ${chalk6.yellow(`[${f.activeTask.status}]`)} ${f.activeTask.title}`
     );
-  } else if (f.nextTodoTask && f.currentStep === 8) {
+  } else if (f.nextTodoTask && f.currentStep === 10) {
     console.log(
       `   \u2022 Next TODO: ${chalk6.gray(`[${f.nextTodoTask.status}]`)} ${f.nextTodoTask.title}`
     );
   }
-  printChecklist(f);
+  printChecklist(f, stepDefinitions);
   if (f.warnings.length > 0) {
     console.log();
     console.log(chalk6.yellow("\u26A0\uFE0F  Feature Warnings:"));
@@ -1784,10 +2084,12 @@ async function runContext(featureName, options) {
     const action = f.actions[0];
     if (action.type === "command") {
       console.log(
-        `\u{1F449} Next Action (${chalk6.cyan(action.scope)}): ${chalk6.green(chalk6.bold(action.cmd))}`
+        `\u{1F449} Next Action (${chalk6.cyan(action.scope)}): ${okTag(action.requiresUserOk)}${chalk6.green(chalk6.bold(action.cmd))}`
       );
     } else {
-      console.log(`\u{1F449} Next Action: ${chalk6.green(chalk6.bold(action.message))}`);
+      console.log(
+        `\u{1F449} Next Action: ${okTag(action.requiresUserOk)}${chalk6.green(chalk6.bold(action.message))}`
+      );
     }
     console.log();
     return;
@@ -1795,15 +2097,15 @@ async function runContext(featureName, options) {
   console.log(chalk6.green(chalk6.bold("\u{1F449} Next Actions:")));
   f.actions.forEach((action) => {
     if (action.type === "command") {
-      console.log(`   \u2022 (${action.scope}) ${action.cmd}`);
+      console.log(`   \u2022 (${action.scope}) ${okTag(action.requiresUserOk)}${action.cmd}`);
     } else {
-      console.log(`   \u2022 ${action.message}`);
+      console.log(`   \u2022 ${okTag(action.requiresUserOk)}${action.message}`);
     }
   });
   console.log();
 }
-function printChecklist(f) {
-  const checklistSteps = [...STEP_DEFINITIONS].sort((a, b) => a.step - b.step);
+function printChecklist(f, stepDefinitions) {
+  const checklistSteps = [...stepDefinitions].sort((a, b) => a.step - b.step);
   checklistSteps.forEach((definition) => {
     const done = definition.checklist.done(f);
     const detail = definition.checklist.detail?.(f) ?? "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.3.0",
+  "version": "0.4.1",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {

package/templates/en/fullstack/features/feature-base/tasks.md

@@ -12,6 +12,8 @@
 - **Repo**: {{projectName}}-{be|fe}
 - **Issue**: #{issue-number}
 - **Branch**: `feat/{issue-number}-{feature-name}`
+- **PR**: #
+- **PR Status**: Draft | Review | Approved
 
 ---
 

package/templates/en/single/features/feature-base/tasks.md

@@ -12,6 +12,8 @@
 - **Repo**: {{projectName}}
 - **Issue**: #{issue-number}
 - **Branch**: `feat/{issue-number}-{feature-name}`
+- **PR**: #
+- **PR Status**: Draft | Review | Approved
 
 ---
 

package/templates/ko/fullstack/features/feature-base/tasks.md

@@ -12,6 +12,8 @@
 - **레포**: {{projectName}}-{be|fe}
 - **Issue**: #{이슈번호}
 - **브랜치**: `feat/{이슈번호}-{기능명}`
+- **PR**: #
+- **PR 상태**: Draft | Review | Approved
 
 ---
 

package/templates/ko/single/features/feature-base/tasks.md

@@ -12,6 +12,8 @@
 - **레포**: {{projectName}}
 - **Issue**: #{이슈번호}
 - **브랜치**: `feat/{이슈번호}-{기능명}`
+- **PR**: #
+- **PR 상태**: Draft | Review | Approved
 
 ---