lee-spec-kit 0.2.4 → 0.4.0

package/dist/index.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
-import path7 from 'path';
+import path4 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
-import prompts from 'prompts';
-import chalk from 'chalk';
 import fs6 from 'fs-extra';
+import prompts from 'prompts';
+import chalk6 from 'chalk';
 import { glob } from 'glob';
 import { spawn, execSync } from 'child_process';
 import os from 'os';
 
 var getFilename = () => fileURLToPath(import.meta.url);
-var getDirname = () => path7.dirname(getFilename());
+var getDirname = () => path4.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function copyTemplates(src, dest) {
   await fs6.copy(src, dest, {
@@ -37,10 +37,10 @@ async function replaceInFiles(dir, replacements) {
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path7.dirname(__filename2);
+var __dirname2 = path4.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path7.resolve(__dirname2, "..");
-  return path7.join(rootDir, "templates");
+  const rootDir = path4.resolve(__dirname2, "..");
+  return path4.join(rootDir, "templates");
 }
 
 // src/utils/validation.ts
@@ -63,7 +63,7 @@ function validateSafeName(name) {
   if (name.includes("\0")) {
     return { valid: false, error: "\uC774\uB984\uC5D0 null \uBB38\uC790\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4." };
   }
-  const safePattern = /^[\w가-힣\-]+$/;
+  const safePattern = /^[\w가-힣-]+$/;
   if (!safePattern.test(name)) {
     return {
       valid: false,
@@ -154,44 +154,45 @@ function initCommand(program2) {
       await runInit(options);
     } catch (error) {
       if (error instanceof Error && error.message === "canceled") {
-        console.log(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        console.log(chalk6.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
         process.exit(0);
       }
-      console.error(chalk.red("\uC624\uB958:"), error);
+      console.error(chalk6.red("\uC624\uB958:"), error);
       process.exit(1);
     }
   });
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path7.basename(cwd);
+  const defaultName = path4.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let lang = options.lang || "ko";
   let docsRepo = "embedded";
   let pushDocs;
   let docsRemote;
-  const targetDir = path7.resolve(cwd, options.dir || "./docs");
+  let projectRoot;
+  const targetDir = path4.resolve(cwd, options.dir || "./docs");
   const isInsideGitRepo = checkGitRepo(cwd);
   if (!options.yes) {
     console.log();
-    console.log(chalk.blue(`\u{1F4CD} \uD604\uC7AC \uC704\uCE58: ${cwd}`));
+    console.log(chalk6.blue(`\u{1F4CD} \uD604\uC7AC \uC704\uCE58: ${cwd}`));
     if (isInsideGitRepo) {
-      console.log(chalk.green("\u2705 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0\uB428"));
+      console.log(chalk6.green("\u2705 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0\uB428"));
       console.log();
-      console.log(chalk.gray("\uD604\uC7AC \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8 \uB0B4\uC5D0\uC11C \uC2E4\uD589\uD558\uACE0 \uACC4\uC2ED\uB2C8\uB2E4."));
+      console.log(chalk6.gray("\uD604\uC7AC \uD504\uB85C\uC81D\uD2B8 \uB8E8\uD2B8 \uB0B4\uC5D0\uC11C \uC2E4\uD589\uD558\uACE0 \uACC4\uC2ED\uB2C8\uB2E4."));
       console.log(
-        chalk.gray(
+        chalk6.gray(
           "\u2022 embedded: \uC5EC\uAE30\uC5D0 ./docs \uD3F4\uB354\uB97C \uC0DD\uC131\uD569\uB2C8\uB2E4. \uD504\uB85C\uC81D\uD2B8\uC640 \uD568\uAED8 \uAD00\uB9AC\uB429\uB2C8\uB2E4."
         )
       );
       console.log(
-        chalk.gray("\u2022 standalone: \uBCC4\uB3C4 \uD3F4\uB354\uC5D0\uC11C \uB3C5\uB9BD docs \uB808\uD3EC\uB85C \uAD00\uB9AC\uD558\uB824\uBA74,")
+        chalk6.gray("\u2022 standalone: \uBCC4\uB3C4 \uD3F4\uB354\uC5D0\uC11C \uB3C5\uB9BD docs \uB808\uD3EC\uB85C \uAD00\uB9AC\uD558\uB824\uBA74,")
       );
-      console.log(chalk.gray("  \uD574\uB2F9 \uD3F4\uB354\uB85C \uC774\uB3D9 \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD574\uC8FC\uC138\uC694."));
+      console.log(chalk6.gray("  \uD574\uB2F9 \uD3F4\uB354\uB85C \uC774\uB3D9 \uD6C4 \uB2E4\uC2DC \uC2E4\uD589\uD574\uC8FC\uC138\uC694."));
     } else {
-      console.log(chalk.yellow("\u26A0\uFE0F  Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4."));
-      console.log(chalk.gray("\uC0C8\uB85C\uC6B4 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uC0DD\uC131\uB429\uB2C8\uB2E4."));
+      console.log(chalk6.yellow("\u26A0\uFE0F  Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uAC10\uC9C0\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4."));
+      console.log(chalk6.gray("\uC0C8\uB85C\uC6B4 Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uAC00 \uC0DD\uC131\uB429\uB2C8\uB2E4."));
     }
     console.log();
     const response = await prompts(
@@ -260,6 +261,51 @@ async function runInit(options) {
     lang = response.lang || lang;
     docsRepo = response.docsRepo || "embedded";
     if (docsRepo === "standalone") {
+      const resolvedType = projectType || response.projectType || "single";
+      if (resolvedType === "fullstack") {
+        const projectRootResponse = await prompts(
+          [
+            {
+              type: "text",
+              name: "feRoot",
+              message: "Frontend \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uACBD\uB85C\uB97C \uC785\uB825\uD558\uC138\uC694:",
+              validate: (value) => value.trim() ? true : "\uACBD\uB85C\uB97C \uC785\uB825\uD574\uC8FC\uC138\uC694"
+            },
+            {
+              type: "text",
+              name: "beRoot",
+              message: "Backend \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uACBD\uB85C\uB97C \uC785\uB825\uD558\uC138\uC694:",
+              validate: (value) => value.trim() ? true : "\uACBD\uB85C\uB97C \uC785\uB825\uD574\uC8FC\uC138\uC694"
+            }
+          ],
+          {
+            onCancel: () => {
+              throw new Error("canceled");
+            }
+          }
+        );
+        projectRoot = {
+          fe: projectRootResponse.feRoot,
+          be: projectRootResponse.beRoot
+        };
+      } else {
+        const projectRootResponse = await prompts(
+          [
+            {
+              type: "text",
+              name: "projectRoot",
+              message: "\uD504\uB85C\uC81D\uD2B8 \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uACBD\uB85C\uB97C \uC785\uB825\uD558\uC138\uC694:",
+              validate: (value) => value.trim() ? true : "\uACBD\uB85C\uB97C \uC785\uB825\uD574\uC8FC\uC138\uC694"
+            }
+          ],
+          {
+            onCancel: () => {
+              throw new Error("canceled");
+            }
+          }
+        );
+        projectRoot = projectRootResponse.projectRoot;
+      }
       const standaloneResponse = await prompts(
         [
           {
@@ -322,21 +368,21 @@ async function runInit(options) {
         initial: false
       });
       if (!overwrite) {
-        console.log(chalk.yellow("\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        console.log(chalk6.yellow("\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
         return;
       }
     }
   }
   console.log();
-  console.log(chalk.blue("\u{1F4C1} docs \uAD6C\uC870 \uC0DD\uC131 \uC911..."));
-  console.log(chalk.gray(`  \uD504\uB85C\uC81D\uD2B8: ${projectName}`));
-  console.log(chalk.gray(`  \uD0C0\uC785: ${projectType}`));
-  console.log(chalk.gray(`  \uC5B8\uC5B4: ${lang}`));
-  console.log(chalk.gray(`  \uACBD\uB85C: ${targetDir}`));
+  console.log(chalk6.blue("\u{1F4C1} docs \uAD6C\uC870 \uC0DD\uC131 \uC911..."));
+  console.log(chalk6.gray(`  \uD504\uB85C\uC81D\uD2B8: ${projectName}`));
+  console.log(chalk6.gray(`  \uD0C0\uC785: ${projectType}`));
+  console.log(chalk6.gray(`  \uC5B8\uC5B4: ${lang}`));
+  console.log(chalk6.gray(`  \uACBD\uB85C: ${targetDir}`));
   console.log();
   const templatesDir = getTemplatesDir();
-  const commonPath = path7.join(templatesDir, lang, "common");
-  const typePath = path7.join(templatesDir, lang, projectType);
+  const commonPath = path4.join(templatesDir, lang, "common");
+  const typePath = path4.join(templatesDir, lang, projectType);
   if (await fs6.pathExists(commonPath)) {
     await copyTemplates(commonPath, targetDir);
   }
@@ -363,16 +409,19 @@ async function runInit(options) {
     if (pushDocs && docsRemote) {
       config.docsRemote = docsRemote;
     }
+    if (projectRoot) {
+      config.projectRoot = projectRoot;
+    }
   }
-  const configPath = path7.join(targetDir, ".lee-spec-kit.json");
+  const configPath = path4.join(targetDir, ".lee-spec-kit.json");
   await fs6.writeJson(configPath, config, { spaces: 2 });
-  console.log(chalk.green("\u2705 docs \uAD6C\uC870 \uC0DD\uC131 \uC644\uB8CC!"));
+  console.log(chalk6.green("\u2705 docs \uAD6C\uC870 \uC0DD\uC131 \uC644\uB8CC!"));
   console.log();
   await initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote);
-  console.log(chalk.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
-  console.log(chalk.gray(`  1. ${targetDir}/prd/README.md \uC791\uC131`));
+  console.log(chalk6.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
+  console.log(chalk6.gray(`  1. ${targetDir}/prd/README.md \uC791\uC131`));
   console.log(
-    chalk.gray("  2. npx lee-spec-kit feature <name> \uC73C\uB85C \uAE30\uB2A5 \uCD94\uAC00")
+    chalk6.gray("  2. npx lee-spec-kit feature <name> \uC73C\uB85C \uAE30\uB2A5 \uCD94\uAC00")
   );
   console.log();
 }
@@ -383,12 +432,12 @@ async function initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote) {
         cwd,
         stdio: "ignore"
       });
-      console.log(chalk.blue("\u{1F4E6} Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0, docs \uCEE4\uBC0B \uC911..."));
+      console.log(chalk6.blue("\u{1F4E6} Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0, docs \uCEE4\uBC0B \uC911..."));
     } catch {
-      console.log(chalk.blue("\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911..."));
+      console.log(chalk6.blue("\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911..."));
       execSync("git init", { cwd, stdio: "ignore" });
     }
-    const relativePath = path7.relative(cwd, targetDir);
+    const relativePath = path4.relative(cwd, targetDir);
     execSync(`git add "${relativePath}"`, { cwd, stdio: "ignore" });
     execSync('git commit -m "init: docs \uAD6C\uC870 \uCD08\uAE30\uD654 (lee-spec-kit)"', {
       cwd,
@@ -400,58 +449,81 @@ async function initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote) {
           cwd,
           stdio: "ignore"
         });
-        console.log(chalk.green(`\u2705 Git remote \uC124\uC815 \uC644\uB8CC: ${docsRemote}`));
+        console.log(chalk6.green(`\u2705 Git remote \uC124\uC815 \uC644\uB8CC: ${docsRemote}`));
       } catch {
-        console.log(chalk.yellow("\u26A0\uFE0F  Git remote\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4."));
+        console.log(chalk6.yellow("\u26A0\uFE0F  Git remote\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4."));
       }
     }
-    console.log(chalk.green("\u2705 Git \uCD08\uAE30 \uCEE4\uBC0B \uC644\uB8CC!"));
+    console.log(chalk6.green("\u2705 Git \uCD08\uAE30 \uCEE4\uBC0B \uC644\uB8CC!"));
     console.log();
-  } catch (error) {
+  } catch {
     console.log(
-      chalk.yellow("\u26A0\uFE0F  Git \uCD08\uAE30\uD654\uB97C \uAC74\uB108\uB701\uB2C8\uB2E4 (\uC218\uB3D9\uC73C\uB85C \uCEE4\uBC0B\uD574\uC8FC\uC138\uC694)")
+      chalk6.yellow("\u26A0\uFE0F  Git \uCD08\uAE30\uD654\uB97C \uAC74\uB108\uB701\uB2C8\uB2E4 (\uC218\uB3D9\uC73C\uB85C \uCEE4\uBC0B\uD574\uC8FC\uC138\uC694)")
     );
     console.log();
   }
 }
+function getAncestorDirs(startDir) {
+  const dirs = [];
+  let current = path4.resolve(startDir);
+  while (true) {
+    dirs.push(current);
+    const parent = path4.dirname(current);
+    if (parent === current) break;
+    current = parent;
+  }
+  return dirs;
+}
 async function getConfig(cwd) {
-  const possibleDirs = [
-    path7.join(cwd, "docs"),
-    cwd
-    // 이미 docs 폴더 안에 있을 수 있음
+  const explicitDocsDir = (process.env.LEE_SPEC_KIT_DOCS_DIR || process.env.LSK_DOCS_DIR || "").trim();
+  const baseDirs = [
+    ...explicitDocsDir ? [path4.resolve(explicitDocsDir)] : [],
+    ...getAncestorDirs(cwd)
   ];
-  for (const docsDir of possibleDirs) {
-    const configPath = path7.join(docsDir, ".lee-spec-kit.json");
-    if (await fs6.pathExists(configPath)) {
-      try {
-        const configFile = await fs6.readJson(configPath);
-        return {
-          docsDir,
-          projectName: configFile.projectName,
-          projectType: configFile.projectType,
-          lang: configFile.lang,
-          docsRepo: configFile.docsRepo,
-          pushDocs: configFile.pushDocs,
-          docsRemote: configFile.docsRemote
-        };
-      } catch {
+  const visitedBaseDirs = /* @__PURE__ */ new Set();
+  const visitedDocsDirs = /* @__PURE__ */ new Set();
+  for (const baseDir of baseDirs) {
+    const resolvedBaseDir = path4.resolve(baseDir);
+    if (visitedBaseDirs.has(resolvedBaseDir)) continue;
+    visitedBaseDirs.add(resolvedBaseDir);
+    const possibleDocsDirs = [path4.join(resolvedBaseDir, "docs"), resolvedBaseDir];
+    for (const docsDir of possibleDocsDirs) {
+      const resolvedDocsDir = path4.resolve(docsDir);
+      if (visitedDocsDirs.has(resolvedDocsDir)) continue;
+      visitedDocsDirs.add(resolvedDocsDir);
+      const configPath = path4.join(resolvedDocsDir, ".lee-spec-kit.json");
+      if (await fs6.pathExists(configPath)) {
+        try {
+          const configFile = await fs6.readJson(configPath);
+          return {
+            docsDir: resolvedDocsDir,
+            projectName: configFile.projectName,
+            projectType: configFile.projectType,
+            lang: configFile.lang,
+            docsRepo: configFile.docsRepo,
+            pushDocs: configFile.pushDocs,
+            docsRemote: configFile.docsRemote,
+            projectRoot: configFile.projectRoot
+          };
+        } catch {
+        }
       }
-    }
-    const agentsPath = path7.join(docsDir, "agents");
-    const featuresPath = path7.join(docsDir, "features");
-    if (await fs6.pathExists(agentsPath) && await fs6.pathExists(featuresPath)) {
-      const bePath = path7.join(featuresPath, "be");
-      const fePath = path7.join(featuresPath, "fe");
-      const projectType = await fs6.pathExists(bePath) || await fs6.pathExists(fePath) ? "fullstack" : "single";
-      const agentsMdPath = path7.join(agentsPath, "agents.md");
-      let lang = "ko";
-      if (await fs6.pathExists(agentsMdPath)) {
-        const content = await fs6.readFile(agentsMdPath, "utf-8");
-        if (!/[가-힣]/.test(content)) {
-          lang = "en";
+      const agentsPath = path4.join(resolvedDocsDir, "agents");
+      const featuresPath = path4.join(resolvedDocsDir, "features");
+      if (await fs6.pathExists(agentsPath) && await fs6.pathExists(featuresPath)) {
+        const bePath = path4.join(featuresPath, "be");
+        const fePath = path4.join(featuresPath, "fe");
+        const projectType = await fs6.pathExists(bePath) || await fs6.pathExists(fePath) ? "fullstack" : "single";
+        const agentsMdPath = path4.join(agentsPath, "agents.md");
+        let lang = "ko";
+        if (await fs6.pathExists(agentsMdPath)) {
+          const content = await fs6.readFile(agentsMdPath, "utf-8");
+          if (!/[가-힣]/.test(content)) {
+            lang = "en";
+          }
         }
+        return { docsDir: resolvedDocsDir, projectType, lang };
       }
-      return { docsDir, projectType, lang };
     }
   }
   return null;
@@ -464,10 +536,10 @@ function featureCommand(program2) {
       await runFeature(name, options);
     } catch (error) {
       if (error instanceof Error && error.message === "canceled") {
-        console.log(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        console.log(chalk6.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
         process.exit(0);
       }
-      console.error(chalk.red("\uC624\uB958:"), error);
+      console.error(chalk6.red("\uC624\uB958:"), error);
       process.exit(1);
     }
   });
@@ -477,7 +549,7 @@ async function runFeature(name, options) {
   const config = await getConfig(cwd);
   if (!config) {
     console.error(
-      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+      chalk6.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
     );
     process.exit(1);
   }
@@ -515,19 +587,19 @@ async function runFeature(name, options) {
   }
   let featuresDir;
   if (projectType === "fullstack" && repo) {
-    featuresDir = path7.join(docsDir, "features", repo);
+    featuresDir = path4.join(docsDir, "features", repo);
   } else {
-    featuresDir = path7.join(docsDir, "features");
+    featuresDir = path4.join(docsDir, "features");
   }
   const featureFolderName = `${featureId}-${name}`;
-  const featureDir = path7.join(featuresDir, featureFolderName);
+  const featureDir = path4.join(featuresDir, featureFolderName);
   if (await fs6.pathExists(featureDir)) {
-    console.error(chalk.red(`\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uD3F4\uB354\uC785\uB2C8\uB2E4: ${featureDir}`));
+    console.error(chalk6.red(`\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uD3F4\uB354\uC785\uB2C8\uB2E4: ${featureDir}`));
     process.exit(1);
   }
-  const featureBasePath = path7.join(docsDir, "features", "feature-base");
+  const featureBasePath = path4.join(docsDir, "features", "feature-base");
   if (!await fs6.pathExists(featureBasePath)) {
-    console.error(chalk.red("feature-base \uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.error(chalk6.red("feature-base \uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     process.exit(1);
   }
   await fs6.copy(featureBasePath, featureDir);
@@ -552,21 +624,21 @@ async function runFeature(name, options) {
   }
   await replaceInFiles(featureDir, replacements);
   console.log();
-  console.log(chalk.green(`\u2705 Feature \uD3F4\uB354 \uC0DD\uC131 \uC644\uB8CC: ${featureDir}`));
+  console.log(chalk6.green(`\u2705 Feature \uD3F4\uB354 \uC0DD\uC131 \uC644\uB8CC: ${featureDir}`));
   console.log();
-  console.log(chalk.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
-  console.log(chalk.gray(`  1. ${featureDir}/spec.md \uC791\uC131`));
-  console.log(chalk.gray("  2. \uC0AC\uC6A9\uC790 \uB9AC\uBDF0 \uC694\uCCAD"));
-  console.log(chalk.gray("  3. \uC2B9\uC778 \uD6C4 plan.md \uC791\uC131"));
+  console.log(chalk6.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
+  console.log(chalk6.gray(`  1. ${featureDir}/spec.md \uC791\uC131`));
+  console.log(chalk6.gray("  2. \uC0AC\uC6A9\uC790 \uB9AC\uBDF0 \uC694\uCCAD"));
+  console.log(chalk6.gray("  3. \uC2B9\uC778 \uD6C4 plan.md \uC791\uC131"));
   console.log();
 }
 async function getNextFeatureId(docsDir, projectType) {
-  const featuresDir = path7.join(docsDir, "features");
+  const featuresDir = path4.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "fullstack") {
-    scanDirs.push(path7.join(featuresDir, "be"));
-    scanDirs.push(path7.join(featuresDir, "fe"));
+    scanDirs.push(path4.join(featuresDir, "be"));
+    scanDirs.push(path4.join(featuresDir, "fe"));
   } else {
     scanDirs.push(featuresDir);
   }
@@ -591,7 +663,7 @@ function statusCommand(program2) {
     try {
       await runStatus(options);
     } catch (error) {
-      console.error(chalk.red("\uC624\uB958:"), error);
+      console.error(chalk6.red("\uC624\uB958:"), error);
       process.exit(1);
     }
   });
@@ -601,25 +673,25 @@ async function runStatus(options) {
   const config = await getConfig(cwd);
   if (!config) {
     console.error(
-      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+      chalk6.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
     );
     process.exit(1);
   }
   const { docsDir, projectType } = config;
-  const featuresDir = path7.join(docsDir, "features");
+  const featuresDir = path4.join(docsDir, "features");
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   const scopes = projectType === "fullstack" ? ["be", "fe"] : [""];
   for (const scope of scopes) {
-    const scanDir = scope ? path7.join(featuresDir, scope) : featuresDir;
+    const scanDir = scope ? path4.join(featuresDir, scope) : featuresDir;
     if (!await fs6.pathExists(scanDir)) continue;
     const entries = await fs6.readdir(scanDir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (entry.name === "feature-base") continue;
-      const featureDir = path7.join(scanDir, entry.name);
-      const specPath = path7.join(featureDir, "spec.md");
-      const tasksPath = path7.join(featureDir, "tasks.md");
+      const featureDir = path4.join(scanDir, entry.name);
+      const specPath = path4.join(featureDir, "spec.md");
+      const tasksPath = path4.join(featureDir, "tasks.md");
       if (!await fs6.pathExists(specPath)) continue;
       if (!await fs6.pathExists(tasksPath)) continue;
       const specContent = await fs6.readFile(specPath, "utf-8");
@@ -628,7 +700,7 @@ async function runStatus(options) {
       const name = extractSpecValue(specContent, "\uAE30\uB2A5\uBA85") || extractSpecValue(specContent, "Feature Name") || entry.name;
       const repo = extractSpecValue(specContent, "\uB300\uC0C1 \uB808\uD3EC") || extractSpecValue(specContent, "Target Repo") || (scope ? `{{projectName}}-${scope}` : "{{projectName}}");
       const issue = extractSpecValue(specContent, "\uC774\uC288 \uBC88\uD638") || extractSpecValue(specContent, "Issue Number") || "-";
-      const relPath = path7.relative(docsDir, featureDir);
+      const relPath = path4.relative(docsDir, featureDir);
       if (!idMap.has(id)) {
         idMap.set(id, []);
       }
@@ -656,7 +728,7 @@ async function runStatus(options) {
     }
   }
   if (features.length === 0) {
-    console.log(chalk.yellow("Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log(chalk6.yellow("Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
     return;
   }
   if (options.strict) {
@@ -664,21 +736,21 @@ async function runStatus(options) {
       ([, paths]) => paths.length > 1
     );
     if (duplicates.length > 0) {
-      console.error(chalk.red("\uC911\uBCF5 Feature ID \uBC1C\uACAC:"));
+      console.error(chalk6.red("\uC911\uBCF5 Feature ID \uBC1C\uACAC:"));
       for (const [id, paths] of duplicates) {
-        console.error(chalk.red(`  ${id}:`));
+        console.error(chalk6.red(`  ${id}:`));
         for (const p of paths) {
-          console.error(chalk.red(`    - ${p}`));
+          console.error(chalk6.red(`    - ${p}`));
         }
       }
       process.exit(1);
     }
     const unknowns = [...idMap.entries()].filter(([id]) => id === "UNKNOWN");
     if (unknowns.length > 0) {
-      console.error(chalk.red("Feature ID\uAC00 \uC5C6\uB294 \uD56D\uBAA9:"));
+      console.error(chalk6.red("Feature ID\uAC00 \uC5C6\uB294 \uD56D\uBAA9:"));
       for (const [, paths] of unknowns) {
         for (const p of paths) {
-          console.error(chalk.red(`  - ${p}`));
+          console.error(chalk6.red(`  - ${p}`));
         }
       }
       process.exit(1);
@@ -691,14 +763,14 @@ async function runStatus(options) {
   console.log(header);
   console.log(separator);
   for (const f of features) {
-    const statusColor = f.status === "DONE" ? chalk.green : f.status === "DOING" ? chalk.yellow : chalk.gray;
+    const statusColor = f.status === "DONE" ? chalk6.green : f.status === "DOING" ? chalk6.yellow : chalk6.gray;
     console.log(
       `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${statusColor(f.status)} | ${f.progress} | ${f.path} |`
     );
   }
   console.log();
   if (options.write) {
-    const outputPath = path7.join(featuresDir, "status.md");
+    const outputPath = path4.join(featuresDir, "status.md");
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const content = [
       "# Feature Status",
@@ -714,7 +786,7 @@ async function runStatus(options) {
       ""
     ].join("\n");
     await fs6.writeFile(outputPath, content, "utf-8");
-    console.log(chalk.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
+    console.log(chalk6.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
   }
 }
 function extractSpecValue(content, key) {
@@ -746,10 +818,10 @@ function updateCommand(program2) {
       await runUpdate(options);
     } catch (error) {
       if (error instanceof Error && error.message === "canceled") {
-        console.log(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        console.log(chalk6.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
         process.exit(0);
       }
-      console.error(chalk.red("\uC624\uB958:"), error);
+      console.error(chalk6.red("\uC624\uB958:"), error);
       process.exit(1);
     }
   });
@@ -759,25 +831,25 @@ async function runUpdate(options) {
   const config = await getConfig(cwd);
   if (!config) {
     console.error(
-      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+      chalk6.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
     );
     process.exit(1);
   }
   const { docsDir, projectType, lang } = config;
   const templatesDir = getTemplatesDir();
-  const sourceDir = path7.join(templatesDir, lang, projectType);
+  const sourceDir = path4.join(templatesDir, lang, projectType);
   const updateAgents = options.agents || !options.agents && !options.templates;
   const updateTemplates = options.templates || !options.agents && !options.templates;
-  console.log(chalk.blue("\u{1F4E6} \uD15C\uD50C\uB9BF \uC5C5\uB370\uC774\uD2B8\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4..."));
-  console.log(chalk.gray(`  - \uC5B8\uC5B4: ${lang}`));
-  console.log(chalk.gray(`  - \uD0C0\uC785: ${projectType}`));
+  console.log(chalk6.blue("\u{1F4E6} \uD15C\uD50C\uB9BF \uC5C5\uB370\uC774\uD2B8\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4..."));
+  console.log(chalk6.gray(`  - \uC5B8\uC5B4: ${lang}`));
+  console.log(chalk6.gray(`  - \uD0C0\uC785: ${projectType}`));
   console.log();
   let updatedCount = 0;
   if (updateAgents) {
-    console.log(chalk.blue("\u{1F4C1} agents/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
-    const commonAgents = path7.join(templatesDir, lang, "common", "agents");
-    const typeAgents = path7.join(templatesDir, lang, projectType, "agents");
-    const targetAgents = path7.join(docsDir, "agents");
+    console.log(chalk6.blue("\u{1F4C1} agents/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
+    const commonAgents = path4.join(templatesDir, lang, "common", "agents");
+    const typeAgents = path4.join(templatesDir, lang, projectType, "agents");
+    const targetAgents = path4.join(docsDir, "agents");
     const featurePath = projectType === "fullstack" ? "docs/features/{be|fe}" : "docs/features";
     const replacements = {
       "{{featurePath}}": featurePath
@@ -795,12 +867,12 @@ async function runUpdate(options) {
       const count = await updateFolder(typeAgents, targetAgents, options.force);
       updatedCount += count;
     }
-    console.log(chalk.green(`  \u2705 agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+    console.log(chalk6.green(`  \u2705 agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
   }
   if (updateTemplates) {
-    console.log(chalk.blue("\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
-    const sourceFeatureBase = path7.join(sourceDir, "features", "feature-base");
-    const targetFeatureBase = path7.join(docsDir, "features", "feature-base");
+    console.log(chalk6.blue("\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
+    const sourceFeatureBase = path4.join(sourceDir, "features", "feature-base");
+    const targetFeatureBase = path4.join(docsDir, "features", "feature-base");
     if (await fs6.pathExists(sourceFeatureBase)) {
       const count = await updateFolder(
         sourceFeatureBase,
@@ -808,22 +880,23 @@ async function runUpdate(options) {
         options.force
       );
       updatedCount += count;
-      console.log(chalk.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+      console.log(chalk6.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
     }
   }
   console.log();
-  console.log(chalk.green(`\u2705 \uCD1D ${updatedCount}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!`));
+  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;
   for (const file of files) {
-    const sourcePath = path7.join(sourceDir, file);
-    const targetPath = path7.join(targetDir, file);
+    const sourcePath = path4.join(sourceDir, file);
+    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");
@@ -840,14 +913,14 @@ async function updateFolder(sourceDir, targetDir, force, replacements) {
         }
         if (!force) {
           console.log(
-            chalk.yellow(`  \u26A0\uFE0F ${file} - \uBCC0\uACBD \uAC10\uC9C0 (--force\uB85C \uB36E\uC5B4\uC4F0\uAE30)`)
+            chalk6.yellow(`  \u26A0\uFE0F ${file} - \uBCC0\uACBD \uAC10\uC9C0 (--force\uB85C \uB36E\uC5B4\uC4F0\uAE30)`)
           );
           shouldUpdate = false;
         }
       }
       if (shouldUpdate) {
         await fs6.writeFile(targetPath, sourceContent);
-        console.log(chalk.gray(`  \u{1F4C4} ${file} \uC5C5\uB370\uC774\uD2B8`));
+        console.log(chalk6.gray(`  \u{1F4C4} ${file} \uC5C5\uB370\uC774\uD2B8`));
         updatedCount++;
       }
     } else if (stat.isDirectory()) {
@@ -862,11 +935,1181 @@ async function updateFolder(sourceDir, targetDir, force, replacements) {
   }
   return updatedCount;
 }
-var CACHE_FILE = path7.join(os.homedir(), ".lee-spec-kit-version-cache.json");
+function configCommand(program2) {
+  program2.command("config").description("View or modify project configuration").option("--project-root <path>", "Set project root path").option("--repo <repo>", "Repository type for fullstack: fe | be").action(async (options) => {
+    try {
+      await runConfig(options);
+    } catch (error) {
+      if (error instanceof Error && error.message === "canceled") {
+        console.log(chalk6.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        process.exit(0);
+      }
+      console.error(chalk6.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runConfig(options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.log(
+      chalk6.red("\uC124\uC815 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.")
+    );
+    process.exit(1);
+  }
+  const configPath = path4.join(config.docsDir, ".lee-spec-kit.json");
+  if (!options.projectRoot) {
+    console.log();
+    console.log(chalk6.blue("\u{1F4CB} \uD604\uC7AC \uC124\uC815:"));
+    console.log();
+    console.log(chalk6.gray(`  \uACBD\uB85C: ${configPath}`));
+    console.log();
+    const configFile2 = await fs6.readJson(configPath);
+    console.log(JSON.stringify(configFile2, null, 2));
+    console.log();
+    return;
+  }
+  const configFile = await fs6.readJson(configPath);
+  if (configFile.docsRepo !== "standalone") {
+    console.log(
+      chalk6.yellow("\u26A0\uFE0F  projectRoot\uB294 standalone \uBAA8\uB4DC\uC5D0\uC11C\uB9CC \uC124\uC815 \uAC00\uB2A5\uD569\uB2C8\uB2E4.")
+    );
+    return;
+  }
+  const projectType = configFile.projectType;
+  if (projectType === "fullstack") {
+    if (!options.repo) {
+      const response = await prompts(
+        [
+          {
+            type: "select",
+            name: "repo",
+            message: "\uC218\uC815\uD560 \uB808\uD3EC\uC9C0\uD1A0\uB9AC\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
+            choices: [
+              { title: "Frontend (fe)", value: "fe" },
+              { title: "Backend (be)", value: "be" }
+            ]
+          }
+        ],
+        {
+          onCancel: () => {
+            throw new Error("canceled");
+          }
+        }
+      );
+      options.repo = response.repo;
+    }
+    if (!options.repo || !["fe", "be"].includes(options.repo)) {
+      console.log(
+        chalk6.red(
+          "Fullstack \uD504\uB85C\uC81D\uD2B8\uB294 --repo fe \uB610\uB294 --repo be\uB97C \uC9C0\uC815\uD574\uC57C \uD569\uB2C8\uB2E4."
+        )
+      );
+      return;
+    }
+    const currentRoot = configFile.projectRoot || { fe: "", be: "" };
+    if (typeof currentRoot === "string") {
+      configFile.projectRoot = {
+        fe: options.repo === "fe" ? options.projectRoot : "",
+        be: options.repo === "be" ? options.projectRoot : ""
+      };
+    } else {
+      currentRoot[options.repo] = options.projectRoot;
+      configFile.projectRoot = currentRoot;
+    }
+    console.log(
+      chalk6.green(
+        `\u2705 ${options.repo.toUpperCase()} projectRoot \uC124\uC815 \uC644\uB8CC: ${options.projectRoot}`
+      )
+    );
+  } else {
+    configFile.projectRoot = options.projectRoot;
+    console.log(
+      chalk6.green(`\u2705 projectRoot \uC124\uC815 \uC644\uB8CC: ${options.projectRoot}`)
+    );
+  }
+  await fs6.writeJson(configPath, configFile, { spaces: 2 });
+  console.log();
+}
+
+// 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 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."
+    }
+  },
+  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."
+    }
+  }
+};
+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,
+        detail: (f) => f.tasks.total > 0 ? `(${f.tasks.total})` : ""
+      },
+      current: {
+        when: (f) => f.planStatus === "Approved" && (!f.docs.tasksExists || f.tasks.total === 0),
+        actions: (f) => {
+          if (!f.docs.tasksExists) {
+            return [
+              {
+                type: "instruction",
+                message: tr(lang, "messages", "tasksCreate")
+              }
+            ];
+          }
+          return [
+            {
+              type: "instruction",
+              message: tr(lang, "messages", "tasksNeedAtLeastOne")
+            }
+          ];
+        }
+      }
+    },
+    {
+      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",
+            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: 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
+              })
+            }
+          ];
+        }
+      }
+    },
+    {
+      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
+              })
+            }
+          ];
+        }
+      }
+    },
+    {
+      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: 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")
+            }
+          ];
+        }
+      }
+    },
+    {
+      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")
+          }
+        ]
+      }
+    }
+  ];
+}
+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)) {
+      const actions = definition.current.actions(feature);
+      return {
+        currentStep: definition.step,
+        actions,
+        nextAction: actions.map((a) => a.type === "command" ? a.cmd : a.message).join("\n")
+      };
+    }
+  }
+  const lastStep = ordered[ordered.length - 1];
+  return {
+    currentStep: lastStep?.step ?? 10,
+    actions: [
+      {
+        type: "instruction",
+        message: tr(lang, "messages", "fallbackRerunContext")
+      }
+    ],
+    nextAction: tr(lang, "messages", "fallbackRerunContext")
+  };
+}
+function getCurrentBranch(cwd) {
+  try {
+    return execSync("git rev-parse --abbrev-ref HEAD", {
+      cwd,
+      encoding: "utf-8",
+      stdio: ["ignore", "pipe", "pipe"]
+    }).trim();
+  } catch {
+    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, "\\$&");
+}
+function extractSpecValue2(content, key) {
+  const regex = new RegExp(
+    `^\\s*-\\s*\\*\\*${escapeRegExp(key)}\\*\\*\\s*:\\s*(.*)$`,
+    "m"
+  );
+  const match = content.match(regex);
+  return match ? match[1].trim() : void 0;
+}
+function extractFirstSpecValue(content, keys) {
+  for (const key of keys) {
+    const value = extractSpecValue2(content, key);
+    if (value) return value;
+  }
+  return void 0;
+}
+function parseDocStatus(value) {
+  if (!value) return void 0;
+  const trimmed = value.trim();
+  if (trimmed.includes("|")) return void 0;
+  const match = trimmed.match(/\b(Draft|Review|Approved)\b/i);
+  if (!match) return void 0;
+  const normalized = match[1].toLowerCase();
+  if (normalized === "draft") return "Draft";
+  if (normalized === "review") return "Review";
+  return "Approved";
+}
+function parseIssueNumber(value) {
+  if (!value) return void 0;
+  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*$/);
+    if (!match) continue;
+    const status = match[1].toUpperCase();
+    const title = match[3].trim();
+    summary.total++;
+    if (status === "DONE") summary.done++;
+    else if (status === "DOING" || status === "REVIEW") summary.doing++;
+    else if (status === "TODO") summary.todo++;
+    if (!activeTask && (status === "DOING" || status === "REVIEW")) {
+      activeTask = { status, title };
+    }
+    if (!nextTodoTask && status === "TODO") {
+      nextTodoTask = { status: "TODO", title };
+    }
+  }
+  return { summary, activeTask, nextTodoTask };
+}
+function parseCompletionChecklist(content) {
+  const lines = content.split("\n");
+  const startIndex = lines.findIndex(
+    (line) => /^\s*##\s+(완료 조건|Completion Criteria)\s*$/.test(line)
+  );
+  if (startIndex === -1) return void 0;
+  let total = 0;
+  let checked = 0;
+  for (let i = startIndex + 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (/^\s*##\s+/.test(line)) break;
+    const match = line.match(/^\s*-\s*\[([ xX])\]\s+/);
+    if (!match) continue;
+    total++;
+    if (match[1].toLowerCase() === "x") checked++;
+  }
+  return total > 0 ? { total, checked } : void 0;
+}
+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];
+  const slug = match?.[2] || folderName;
+  const specPath = path4.join(featurePath, "spec.md");
+  const planPath = path4.join(featurePath, "plan.md");
+  const tasksPath = path4.join(featurePath, "tasks.md");
+  let specStatus;
+  let issueNumber;
+  const specExists = await fs6.pathExists(specPath);
+  if (specExists) {
+    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"]);
+    issueNumber = parseIssueNumber(issueValue);
+  }
+  let planStatus;
+  const planExists = await fs6.pathExists(planPath);
+  if (planExists) {
+    const content = await fs6.readFile(planPath, "utf-8");
+    const statusValue = extractFirstSpecValue(content, ["\uC0C1\uD0DC", "Status"]);
+    planStatus = parseDocStatus(statusValue);
+  }
+  const tasksExists = await fs6.pathExists(tasksPath);
+  const tasksSummary = { total: 0, todo: 0, doing: 0, done: 0 };
+  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);
+    tasksSummary.total = summary.total;
+    tasksSummary.todo = summary.todo;
+    tasksSummary.doing = summary.doing;
+    tasksSummary.done = summary.done;
+    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(tr(lang, "warnings", "projectBranchUnavailable"));
+  }
+  const onExpectedBranch = isExpectedFeatureBranch(
+    context.projectBranch,
+    issueNumber,
+    slug,
+    folderName
+  );
+  const relativeFeaturePathFromDocs = path4.relative(context.docsDir, featurePath);
+  const docsStatus = getGitStatusPorcelain(context.docsGitCwd, [relativeFeaturePathFromDocs]);
+  const docsHasUncommittedChanges = docsStatus === void 0 ? true : docsStatus.trim().length > 0;
+  if (docsStatus === void 0) {
+    warnings.push(tr(lang, "warnings", "docsGitUnavailable"));
+  }
+  if (tasksExists && (!prFieldExists || !prStatusFieldExists)) {
+    warnings.push(tr(lang, "warnings", "legacyTasksPrFields"));
+  }
+  const featureState = {
+    id,
+    slug,
+    folderName,
+    type,
+    path: featurePath,
+    issueNumber,
+    specStatus,
+    planStatus,
+    tasks: tasksSummary,
+    activeTask,
+    nextTodoTask,
+    completionChecklist,
+    pr: { link: prLink, status: prStatus },
+    git: {
+      docsBranch: context.docsBranch,
+      projectBranch: context.projectBranch,
+      projectBranchAvailable: context.projectBranchAvailable,
+      docsGitCwd: context.docsGitCwd,
+      projectGitCwd: context.projectGitCwd,
+      onExpectedBranch,
+      docsHasUncommittedChanges
+    },
+    docs: {
+      featurePathFromDocs: relativeFeaturePathFromDocs,
+      specExists,
+      planExists,
+      tasksExists,
+      prFieldExists,
+      prStatusFieldExists
+    }
+  };
+  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: "",
+    fe: "",
+    be: ""
+  };
+  let singleProject;
+  let feProject;
+  let beProject;
+  if (config.projectType === "single") {
+    singleProject = resolveProjectGitCwd(config, "single");
+    if (singleProject.warning) warnings.push(singleProject.warning);
+    projectBranches.single = singleProject.cwd ? getCurrentBranch(singleProject.cwd) : "";
+  } else {
+    feProject = resolveProjectGitCwd(config, "fe");
+    beProject = resolveProjectGitCwd(config, "be");
+    if (feProject.warning) warnings.push(feProject.warning);
+    if (beProject.warning) warnings.push(beProject.warning);
+    projectBranches.fe = feProject.cwd ? getCurrentBranch(feProject.cwd) : "";
+    projectBranches.be = beProject.cwd ? getCurrentBranch(beProject.cwd) : "";
+  }
+  if (config.projectType === "single") {
+    const featureDirs = await glob("features/*/", {
+      cwd: config.docsDir,
+      absolute: true,
+      ignore: ["**/feature-base/**"]
+    });
+    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)
+            },
+            { 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 });
+    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)
+            },
+            { 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)
+            },
+            { lang: config.lang, stepDefinitions }
+          )
+        );
+      }
+    }
+  }
+  return {
+    features,
+    branches: {
+      docs: docsBranch,
+      project: config.projectType === "single" ? { single: projectBranches.single } : { fe: projectBranches.fe, be: projectBranches.be }
+    },
+    warnings
+  };
+}
+
+// src/commands/context.ts
+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>", "Repository type for fullstack: fe | be").action(
+    async (featureName, options) => {
+      try {
+        await runContext(featureName, options);
+      } catch (error) {
+        if (options.json) {
+          console.log(
+            JSON.stringify({
+              status: "error",
+              error: error instanceof Error ? error.message : String(error)
+            })
+          );
+        } else {
+          console.error(chalk6.red("\uC624\uB958:"), error);
+        }
+        process.exit(1);
+      }
+    }
+  );
+}
+function matchesFeatureSelector(f, selector) {
+  const s = selector.trim();
+  if (!s) return false;
+  if (f.folderName.toLowerCase() === s.toLowerCase()) return true;
+  if (f.slug.toLowerCase() === s.toLowerCase()) return true;
+  if (f.id && f.id.toLowerCase() === s.toLowerCase()) return true;
+  return false;
+}
+function detectFromBranch(branchName, features) {
+  const match = branchName.match(/^feat\/\d+-(.+)$/);
+  if (!match) return [];
+  const detected = match[1];
+  return features.filter(
+    (f) => f.slug.toLowerCase() === detected.toLowerCase() || f.folderName.toLowerCase() === detected.toLowerCase()
+  );
+}
+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) {
+    targetFeatures = features.filter((f2) => matchesFeatureSelector(f2, featureName));
+    if (options.repo) {
+      targetFeatures = targetFeatures.filter((f2) => f2.type === options.repo);
+    }
+  } else {
+    if (config.projectType === "single") {
+      const branchName = branches.project.single || "";
+      targetFeatures = detectFromBranch(branchName, features);
+    } else if (options.repo) {
+      const branchName = branches.project[options.repo] || "";
+      targetFeatures = detectFromBranch(
+        branchName,
+        features.filter((f2) => f2.type === options.repo)
+      );
+    } else {
+      const feMatches = branches.project.fe ? detectFromBranch(
+        branches.project.fe,
+        features.filter((f2) => f2.type === "fe")
+      ) : [];
+      const beMatches = branches.project.be ? detectFromBranch(
+        branches.project.be,
+        features.filter((f2) => f2.type === "be")
+      ) : [];
+      targetFeatures = [...feMatches, ...beMatches];
+    }
+    if (targetFeatures.length === 0) targetFeatures = features;
+  }
+  if (options.json) {
+    const result = {
+      status: features.length === 0 ? "no_features" : targetFeatures.length === 1 ? "single_matched" : targetFeatures.length > 1 ? "multiple_active" : "no_match",
+      branches,
+      warnings,
+      matchedFeature: targetFeatures.length === 1 ? targetFeatures[0] : null,
+      candidates: targetFeatures.length > 1 ? targetFeatures : [],
+      actions: targetFeatures.length === 1 ? targetFeatures[0].actions : [],
+      recommendation: ""
+    };
+    if (result.status === "multiple_active") {
+      result.recommendation = "Multiple features detected. Please specify feature name (slug | F001 | F001-slug) or use --repo.";
+    } else if (result.status === "no_features") {
+      result.recommendation = "No features found. Create a feature first.";
+    } else if (result.status === "no_match") {
+      result.recommendation = "No features found.";
+    } else {
+      result.recommendation = targetFeatures[0].nextAction;
+    }
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log();
+  console.log(chalk6.bold("\u{1F4CD} Current Context Check"));
+  if (config.projectType === "single") {
+    if (branches.project.single) {
+      console.log(
+        chalk6.gray(`   (Detected from Project Branch: ${branches.project.single})`)
+      );
+    }
+  } else if (options.repo) {
+    const branchName = branches.project[options.repo] || "";
+    if (branchName) {
+      console.log(
+        chalk6.gray(
+          `   (Detected from Project Branch: ${options.repo.toUpperCase()} ${branchName})`
+        )
+      );
+    }
+  } else if (branches.project.fe || branches.project.be) {
+    const parts = [
+      branches.project.fe ? `FE ${branches.project.fe}` : null,
+      branches.project.be ? `BE ${branches.project.be}` : null
+    ].filter(Boolean);
+    console.log(chalk6.gray(`   (Detected from Project Branch: ${parts.join(" / ")})`));
+  }
+  if (config.docsRepo === "standalone" && branches.docs) {
+    console.log(chalk6.gray(`   (Docs Branch: ${branches.docs})`));
+  }
+  console.log(chalk6.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+  console.log();
+  if (features.length === 0) {
+    console.log(chalk6.yellow("\u26A0\uFE0F  \uC9C4\uD589 \uC911\uC778 Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    console.log();
+    return;
+  }
+  if (warnings.length > 0) {
+    console.log(chalk6.yellow("\u26A0\uFE0F  \uD658\uACBD \uACBD\uACE0:"));
+    warnings.forEach((w) => console.log(chalk6.yellow(`   - ${w}`)));
+    console.log();
+  }
+  if (targetFeatures.length > 1) {
+    console.log(
+      chalk6.blue(`\u{1F539} ${targetFeatures.length} Active Features Detected:`)
+    );
+    console.log();
+    targetFeatures.forEach((f2) => {
+      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)}`
+      );
+    });
+    console.log();
+    console.log(chalk6.gray("Tip: \uD2B9\uC815 Feature\uC758 \uC0C1\uC138 \uC815\uBCF4\uB97C \uBCF4\uB824\uBA74:"));
+    console.log(
+      chalk6.gray("   $ npx lee-spec-kit context <slug|F001|F001-slug> [--repo fe|be]")
+    );
+    console.log();
+    return;
+  }
+  const f = targetFeatures[0];
+  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})`) : ""}`
+  );
+  if (f.issueNumber) {
+    console.log(`   \u2022 Issue: #${f.issueNumber}`);
+  }
+  console.log(`   \u2022 Path: ${path4.relative(cwd, f.path)}`);
+  if (f.git.projectBranch) {
+    console.log(`   \u2022 Project Branch: ${f.git.projectBranch}`);
+  }
+  console.log();
+  console.log(
+    `\u{1F539} Progress: ${chalk6.yellow(`Step ${f.currentStep}. ${stepName}`)}`
+  );
+  if (f.activeTask) {
+    console.log(
+      `   \u2022 Active Task: ${chalk6.yellow(`[${f.activeTask.status}]`)} ${f.activeTask.title}`
+    );
+  } else if (f.nextTodoTask && f.currentStep === 10) {
+    console.log(
+      `   \u2022 Next TODO: ${chalk6.gray(`[${f.nextTodoTask.status}]`)} ${f.nextTodoTask.title}`
+    );
+  }
+  printChecklist(f, stepDefinitions);
+  if (f.warnings.length > 0) {
+    console.log();
+    console.log(chalk6.yellow("\u26A0\uFE0F  Feature Warnings:"));
+    f.warnings.forEach((w) => console.log(chalk6.yellow(`   - ${w}`)));
+  }
+  console.log();
+  console.log(chalk6.gray("\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501"));
+  if (!f.actions || f.actions.length === 0) {
+    console.log(`\u{1F449} Next Action: ${chalk6.green(chalk6.bold(f.nextAction))}`);
+    console.log();
+    return;
+  }
+  if (f.actions.length === 1) {
+    const action = f.actions[0];
+    if (action.type === "command") {
+      console.log(
+        `\u{1F449} Next Action (${chalk6.cyan(action.scope)}): ${okTag(action.requiresUserOk)}${chalk6.green(chalk6.bold(action.cmd))}`
+      );
+    } else {
+      console.log(
+        `\u{1F449} Next Action: ${okTag(action.requiresUserOk)}${chalk6.green(chalk6.bold(action.message))}`
+      );
+    }
+    console.log();
+    return;
+  }
+  console.log(chalk6.green(chalk6.bold("\u{1F449} Next Actions:")));
+  f.actions.forEach((action) => {
+    if (action.type === "command") {
+      console.log(`   \u2022 (${action.scope}) ${okTag(action.requiresUserOk)}${action.cmd}`);
+    } else {
+      console.log(`   \u2022 ${okTag(action.requiresUserOk)}${action.message}`);
+    }
+  });
+  console.log();
+}
+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) ?? "";
+    const mark = done ? chalk6.green("\u2705") : chalk6.gray("\u25EF");
+    const label = definition.step === f.currentStep ? chalk6.bold(definition.name) : definition.name;
+    console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
+  });
+}
+var CACHE_FILE = path4.join(os.homedir(), ".lee-spec-kit-version-cache.json");
 var CHECK_INTERVAL = 24 * 60 * 60 * 1e3;
 function getCurrentVersion() {
   try {
-    const packageJsonPath = path7.join(__dirname$1, "..", "package.json");
+    const packageJsonPath = path4.join(__dirname$1, "..", "package.json");
     if (fs6.existsSync(packageJsonPath)) {
       const pkg = fs6.readJsonSync(packageJsonPath);
       return pkg.version;
@@ -896,9 +2139,9 @@ function isNewerVersion(current, latest) {
 function printUpdateNotice(current, latest) {
   console.log();
   console.log(
-    chalk.yellow(`\u{1F4E6} lee-spec-kit v${latest} \uC0AC\uC6A9 \uAC00\uB2A5 (\uD604\uC7AC: v${current})`)
+    chalk6.yellow(`\u{1F4E6} lee-spec-kit v${latest} \uC0AC\uC6A9 \uAC00\uB2A5 (\uD604\uC7AC: v${current})`)
   );
-  console.log(chalk.gray("   \uC5C5\uB370\uC774\uD2B8: npm update -g lee-spec-kit"));
+  console.log(chalk6.gray("   \uC5C5\uB370\uC774\uD2B8: npm update -g lee-spec-kit"));
   console.log();
 }
 function spawnBackgroundVersionCheck() {
@@ -943,11 +2186,24 @@ function checkForUpdates() {
 
 // src/index.ts
 checkForUpdates();
+function getCliVersion() {
+  try {
+    const packageJsonPath = path4.join(__dirname$1, "..", "package.json");
+    if (fs6.existsSync(packageJsonPath)) {
+      const pkg = fs6.readJsonSync(packageJsonPath);
+      if (pkg?.version) return String(pkg.version);
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
 program.name("lee-spec-kit").description(
   "Project documentation structure generator for AI-assisted development"
-).version("0.2.0");
+).version(getCliVersion());
 initCommand(program);
 featureCommand(program);
 statusCommand(program);
 updateCommand(program);
+configCommand(program);
+contextCommand(program);
 program.parse();