lee-spec-kit 0.4.2 → 0.4.3

package/dist/index.js

@@ -2,18 +2,18 @@
 import path4 from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
-import fs6 from 'fs-extra';
+import fs8 from 'fs-extra';
 import prompts from 'prompts';
 import chalk6 from 'chalk';
 import { glob } from 'glob';
-import { spawn, execSync } from 'child_process';
+import { spawn, execSync, execFileSync } from 'child_process';
 import os from 'os';
 
 var getFilename = () => fileURLToPath(import.meta.url);
 var getDirname = () => path4.dirname(getFilename());
 var __dirname$1 = /* @__PURE__ */ getDirname();
 async function copyTemplates(src, dest) {
-  await fs6.copy(src, dest, {
+  await fs8.copy(src, dest, {
     overwrite: true,
     errorOnExist: false
   });
@@ -21,19 +21,19 @@ async function copyTemplates(src, dest) {
 async function replaceInFiles(dir, replacements) {
   const files = await glob("**/*.md", { cwd: dir, absolute: true });
   for (const file of files) {
-    let content = await fs6.readFile(file, "utf-8");
+    let content = await fs8.readFile(file, "utf-8");
     for (const [search, replace] of Object.entries(replacements)) {
       content = content.replaceAll(search, replace);
     }
-    await fs6.writeFile(file, content, "utf-8");
+    await fs8.writeFile(file, content, "utf-8");
   }
   const shFiles = await glob("**/*.sh", { cwd: dir, absolute: true });
   for (const file of shFiles) {
-    let content = await fs6.readFile(file, "utf-8");
+    let content = await fs8.readFile(file, "utf-8");
     for (const [search, replace] of Object.entries(replacements)) {
       content = content.replaceAll(search, replace);
     }
-    await fs6.writeFile(file, content, "utf-8");
+    await fs8.writeFile(file, content, "utf-8");
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
@@ -358,8 +358,8 @@ async function runInit(options) {
   assertValid(validateSafeName(projectName), "\uD504\uB85C\uC81D\uD2B8 \uC774\uB984");
   assertValid(validateProjectType(projectType), "\uD504\uB85C\uC81D\uD2B8 \uD0C0\uC785");
   assertValid(validateLanguage(lang), "\uC5B8\uC5B4");
-  if (await fs6.pathExists(targetDir)) {
-    const files = await fs6.readdir(targetDir);
+  if (await fs8.pathExists(targetDir)) {
+    const files = await fs8.readdir(targetDir);
     if (files.length > 0) {
       const { overwrite } = await prompts({
         type: "confirm",
@@ -383,10 +383,10 @@ async function runInit(options) {
   const templatesDir = getTemplatesDir();
   const commonPath = path4.join(templatesDir, lang, "common");
   const typePath = path4.join(templatesDir, lang, projectType);
-  if (await fs6.pathExists(commonPath)) {
+  if (await fs8.pathExists(commonPath)) {
     await copyTemplates(commonPath, targetDir);
   }
-  if (!await fs6.pathExists(typePath)) {
+  if (!await fs8.pathExists(typePath)) {
     throw new Error(`\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${typePath}`);
   }
   await copyTemplates(typePath, targetDir);
@@ -414,7 +414,7 @@ async function runInit(options) {
     }
   }
   const configPath = path4.join(targetDir, ".lee-spec-kit.json");
-  await fs6.writeJson(configPath, config, { spaces: 2 });
+  await fs8.writeJson(configPath, config, { spaces: 2 });
   console.log(chalk6.green("\u2705 docs \uAD6C\uC870 \uC0DD\uC131 \uC644\uB8CC!"));
   console.log();
   await initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote);
@@ -427,28 +427,49 @@ async function runInit(options) {
 }
 async function initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote) {
   try {
+    const runGit = (args, workdir) => {
+      execFileSync("git", args, { cwd: workdir, stdio: "ignore" });
+    };
+    const getCachedStagedFiles = (workdir) => {
+      try {
+        const out = execFileSync("git", ["diff", "--cached", "--name-only"], {
+          cwd: workdir,
+          encoding: "utf-8",
+          stdio: ["ignore", "pipe", "ignore"]
+        }).trim();
+        if (!out) return [];
+        return out.split("\n").map((s) => s.trim()).filter(Boolean);
+      } catch {
+        return null;
+      }
+    };
     try {
-      execSync("git rev-parse --is-inside-work-tree", {
-        cwd,
-        stdio: "ignore"
-      });
+      runGit(["rev-parse", "--is-inside-work-tree"], cwd);
       console.log(chalk6.blue("\u{1F4E6} Git \uB808\uD3EC\uC9C0\uD1A0\uB9AC \uAC10\uC9C0, docs \uCEE4\uBC0B \uC911..."));
     } catch {
       console.log(chalk6.blue("\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911..."));
-      execSync("git init", { cwd, stdio: "ignore" });
+      runGit(["init"], cwd);
     }
     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,
-      stdio: "ignore"
-    });
+    const stagedBeforeAdd = getCachedStagedFiles(cwd);
+    if (relativePath === "." && stagedBeforeAdd && stagedBeforeAdd.length > 0) {
+      console.log(
+        chalk6.yellow(
+          '\u26A0\uFE0F  \uD604\uC7AC Git index\uC5D0 \uC774\uBBF8 stage\uB41C \uBCC0\uACBD\uC774 \uC788\uC2B5\uB2C8\uB2E4. (--dir "." \uC778 \uACBD\uC6B0 \uCEE4\uBC0B \uBC94\uC704\uB97C \uC548\uC804\uD558\uAC8C \uC81C\uD55C\uD560 \uC218 \uC5C6\uC5B4 \uC790\uB3D9 \uCEE4\uBC0B\uC744 \uAC74\uB108\uB701\uB2C8\uB2E4)'
+        )
+      );
+      console.log(chalk6.gray("    \uC218\uB3D9\uC73C\uB85C \uBCC0\uACBD \uB0B4\uC6A9\uC744 \uD655\uC778\uD55C \uB4A4 \uCEE4\uBC0B\uD574\uC8FC\uC138\uC694."));
+      console.log();
+      return;
+    }
+    runGit(["add", relativePath], cwd);
+    runGit(
+      ["commit", "-m", "init: docs \uAD6C\uC870 \uCD08\uAE30\uD654 (lee-spec-kit)", "--", relativePath],
+      cwd
+    );
     if (docsRepo === "standalone" && pushDocs && docsRemote) {
       try {
-        execSync(`git remote add origin "${docsRemote}"`, {
-          cwd,
-          stdio: "ignore"
-        });
+        runGit(["remote", "add", "origin", docsRemote], cwd);
         console.log(chalk6.green(`\u2705 Git remote \uC124\uC815 \uC644\uB8CC: ${docsRemote}`));
       } catch {
         console.log(chalk6.yellow("\u26A0\uFE0F  Git remote\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4."));
@@ -492,9 +513,9 @@ async function getConfig(cwd) {
       if (visitedDocsDirs.has(resolvedDocsDir)) continue;
       visitedDocsDirs.add(resolvedDocsDir);
       const configPath = path4.join(resolvedDocsDir, ".lee-spec-kit.json");
-      if (await fs6.pathExists(configPath)) {
+      if (await fs8.pathExists(configPath)) {
         try {
-          const configFile = await fs6.readJson(configPath);
+          const configFile = await fs8.readJson(configPath);
           return {
             docsDir: resolvedDocsDir,
             projectName: configFile.projectName,
@@ -510,14 +531,14 @@ async function getConfig(cwd) {
       }
       const agentsPath = path4.join(resolvedDocsDir, "agents");
       const featuresPath = path4.join(resolvedDocsDir, "features");
-      if (await fs6.pathExists(agentsPath) && await fs6.pathExists(featuresPath)) {
+      if (await fs8.pathExists(agentsPath) && await fs8.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 projectType = await fs8.pathExists(bePath) || await fs8.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 (await fs8.pathExists(agentsMdPath)) {
+          const content = await fs8.readFile(agentsMdPath, "utf-8");
           if (!/[가-힣]/.test(content)) {
             lang = "en";
           }
@@ -593,26 +614,31 @@ async function runFeature(name, options) {
   }
   const featureFolderName = `${featureId}-${name}`;
   const featureDir = path4.join(featuresDir, featureFolderName);
-  if (await fs6.pathExists(featureDir)) {
+  if (await fs8.pathExists(featureDir)) {
     console.error(chalk6.red(`\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uD3F4\uB354\uC785\uB2C8\uB2E4: ${featureDir}`));
     process.exit(1);
   }
   const featureBasePath = path4.join(docsDir, "features", "feature-base");
-  if (!await fs6.pathExists(featureBasePath)) {
+  if (!await fs8.pathExists(featureBasePath)) {
     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);
+  await fs8.copy(featureBasePath, featureDir);
   const idNumber = featureId.replace("F", "");
   const repoName = projectType === "fullstack" && repo ? `{{projectName}}-${repo}` : "{{projectName}}";
   const replacements = {
+    // ko placeholders
     "{\uAE30\uB2A5\uBA85}": name,
     "{\uBC88\uD638}": idNumber,
     "YYYY-MM-DD": (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
     "{be|fe}": repo || "",
-    "git-dungeon-{be|fe}": repoName,
     "{\uC774\uC288\uBC88\uD638}": "",
-    "{{description}}": options.desc || ""
+    "{{description}}": options.desc || "",
+    // en placeholders
+    "{feature-name}": name,
+    "{number}": idNumber,
+    "{issue-number}": "",
+    "{{projectName}}-{be|fe}": repoName
   };
   if (lang === "en") {
     replacements["\uAE30\uB2A5 ID"] = "Feature ID";
@@ -643,394 +669,20 @@ async function getNextFeatureId(docsDir, projectType) {
     scanDirs.push(featuresDir);
   }
   for (const dir of scanDirs) {
-    if (!await fs6.pathExists(dir)) continue;
-    const entries = await fs6.readdir(dir, { withFileTypes: true });
+    if (!await fs8.pathExists(dir)) continue;
+    const entries = await fs8.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
-      const match = entry.name.match(/^F(\d+)-/);
-      if (match) {
-        const num = parseInt(match[1], 10);
-        if (num > max) max = num;
-      }
-    }
-  }
-  const next = max + 1;
-  const width = Math.max(3, String(next).length);
-  return `F${String(next).padStart(width, "0")}`;
-}
-function statusCommand(program2) {
-  program2.command("status").description("Show feature status").option("-w, --write", "Write status.md file").option("-s, --strict", "Fail on missing/duplicate feature IDs").action(async (options) => {
-    try {
-      await runStatus(options);
-    } catch (error) {
-      console.error(chalk6.red("\uC624\uB958:"), error);
-      process.exit(1);
-    }
-  });
-}
-async function runStatus(options) {
-  const cwd = process.cwd();
-  const config = await getConfig(cwd);
-  if (!config) {
-    console.error(
-      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 = 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 ? 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 = 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");
-      const tasksContent = await fs6.readFile(tasksPath, "utf-8");
-      const id = extractSpecValue(specContent, "\uAE30\uB2A5 ID") || extractSpecValue(specContent, "Feature ID") || "UNKNOWN";
-      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 = path4.relative(docsDir, featureDir);
-      if (!idMap.has(id)) {
-        idMap.set(id, []);
-      }
-      idMap.get(id).push(relPath);
-      const { total, done, doing, todo } = countTasks(tasksContent);
-      let status = "TODO";
-      if (total > 0 && done === total) {
-        status = "DONE";
-      } else if (doing > 0) {
-        status = "DOING";
-      } else if (todo > 0) {
-        status = "TODO";
-      } else if (total === 0) {
-        status = "NO_TASKS";
-      }
-      features.push({
-        id,
-        name,
-        repo,
-        issue,
-        status,
-        progress: `${done}/${total}`,
-        path: relPath
-      });
-    }
-  }
-  if (features.length === 0) {
-    console.log(chalk6.yellow("Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
-    return;
-  }
-  if (options.strict) {
-    const duplicates = [...idMap.entries()].filter(
-      ([, paths]) => paths.length > 1
-    );
-    if (duplicates.length > 0) {
-      console.error(chalk6.red("\uC911\uBCF5 Feature ID \uBC1C\uACAC:"));
-      for (const [id, paths] of duplicates) {
-        console.error(chalk6.red(`  ${id}:`));
-        for (const p of paths) {
-          console.error(chalk6.red(`    - ${p}`));
-        }
-      }
-      process.exit(1);
-    }
-    const unknowns = [...idMap.entries()].filter(([id]) => id === "UNKNOWN");
-    if (unknowns.length > 0) {
-      console.error(chalk6.red("Feature ID\uAC00 \uC5C6\uB294 \uD56D\uBAA9:"));
-      for (const [, paths] of unknowns) {
-        for (const p of paths) {
-          console.error(chalk6.red(`  - ${p}`));
-        }
-      }
-      process.exit(1);
-    }
-  }
-  features.sort((a, b) => a.id.localeCompare(b.id));
-  const header = "| ID | Name | Repo | Issue | Status | Progress | Path |";
-  const separator = "| --- | --- | --- | --- | --- | --- | --- |";
-  console.log();
-  console.log(header);
-  console.log(separator);
-  for (const f of features) {
-    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 = path4.join(featuresDir, "status.md");
-    const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
-    const content = [
-      "# Feature Status",
-      "",
-      `- Generated: ${date}`,
-      "- Source: `tasks.md`, `spec.md`",
-      "",
-      header,
-      separator,
-      ...features.map(
-        (f) => `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${f.status} | ${f.progress} | ${f.path} |`
-      ),
-      ""
-    ].join("\n");
-    await fs6.writeFile(outputPath, content, "utf-8");
-    console.log(chalk6.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
-  }
-}
-function extractSpecValue(content, key) {
-  const regex = new RegExp(`^- \\*\\*${key}\\*\\*:\\s*(.*)$`, "m");
-  const match = content.match(regex);
-  return match ? match[1].trim() : "";
-}
-function countTasks(content) {
-  let total = 0;
-  let done = 0;
-  let doing = 0;
-  let todo = 0;
-  const lines = content.split("\n");
-  for (const line of lines) {
-    const match = line.match(/^- \[([A-Z]+)\]/);
-    if (match) {
-      total++;
-      const status = match[1];
-      if (status === "DONE") done++;
-      else if (status === "DOING" || status === "REVIEW") doing++;
-      else if (status === "TODO") todo++;
-    }
-  }
-  return { total, done, doing, todo };
-}
-function updateCommand(program2) {
-  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--templates", "Update feature-base/ folder only").option("-f, --force", "Force overwrite without confirmation").action(async (options) => {
-    try {
-      await runUpdate(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 runUpdate(options) {
-  const cwd = process.cwd();
-  const config = await getConfig(cwd);
-  if (!config) {
-    console.error(
-      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 = path4.join(templatesDir, lang, projectType);
-  const updateAgents = options.agents || !options.agents && !options.templates;
-  const updateTemplates = options.templates || !options.agents && !options.templates;
-  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(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
-    };
-    if (await fs6.pathExists(commonAgents)) {
-      const count = await updateFolder(
-        commonAgents,
-        targetAgents,
-        options.force,
-        replacements
-      );
-      updatedCount += count;
-    }
-    if (await fs6.pathExists(typeAgents)) {
-      const count = await updateFolder(typeAgents, targetAgents, options.force);
-      updatedCount += count;
-    }
-    console.log(chalk6.green(`  \u2705 agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
-  }
-  if (updateTemplates) {
-    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,
-        targetFeatureBase,
-        options.force
-      );
-      updatedCount += count;
-      console.log(chalk6.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
-    }
-  }
-  console.log();
-  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 = path4.join(sourceDir, file);
-    const targetPath = path4.join(targetDir, file);
-    const stat = await fs6.stat(sourcePath);
-    if (stat.isFile()) {
-      if (protectedFiles.has(file)) {
-        continue;
-      }
-      let sourceContent = await fs6.readFile(sourcePath, "utf-8");
-      if (replacements) {
-        for (const [key, value] of Object.entries(replacements)) {
-          sourceContent = sourceContent.replaceAll(key, value);
-        }
-      }
-      let shouldUpdate = true;
-      if (await fs6.pathExists(targetPath)) {
-        const targetContent = await fs6.readFile(targetPath, "utf-8");
-        if (sourceContent === targetContent) {
-          continue;
-        }
-        if (!force) {
-          console.log(
-            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(chalk6.gray(`  \u{1F4C4} ${file} \uC5C5\uB370\uC774\uD2B8`));
-        updatedCount++;
-      }
-    } else if (stat.isDirectory()) {
-      const subCount = await updateFolder(
-        sourcePath,
-        targetPath,
-        force,
-        replacements
-      );
-      updatedCount += subCount;
-    }
-  }
-  return updatedCount;
-}
-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}`)
-    );
+      const match = entry.name.match(/^F(\d+)-/);
+      if (match) {
+        const num = parseInt(match[1], 10);
+        if (num > max) max = num;
+      }
+    }
   }
-  await fs6.writeJson(configPath, configFile, { spaces: 2 });
-  console.log();
+  const next = max + 1;
+  const width = Math.max(3, String(next).length);
+  return `F${String(next).padStart(width, "0")}`;
 }
 
 // src/utils/context/i18n.ts
@@ -1078,6 +730,7 @@ var I18N = {
       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)",
+      prFillStatus: "tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694. (merge \uD6C4 Approved\uB85C \uC5C5\uB370\uC774\uD2B8)",
       prResolveReview: "\uB9AC\uBDF0 \uCF54\uBA58\uD2B8\uB97C \uD574\uACB0\uD558\uACE0 PR \uC0C1\uD0DC\uB97C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694. (PR \uC0C1\uD0DC: Review \u2192 Approved)",
       prRequestReview: "\uB9AC\uBDF0\uC5B4\uC5D0\uAC8C \uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uACE0 PR \uC0C1\uD0DC\uB97C Review\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.",
       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.",
@@ -1086,7 +739,12 @@ var I18N = {
     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."
+      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.",
+      workflowSpecNotApproved: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC spec.md \uC0C1\uD0DC\uAC00 Approved\uAC00 \uC544\uB2D9\uB2C8\uB2E4. (spec.md\uC758 \uC0C1\uD0DC\uB97C Approved\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.)",
+      workflowPlanNotApproved: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC plan.md \uC0C1\uD0DC\uAC00 Approved\uAC00 \uC544\uB2D9\uB2C8\uB2E4. (plan.md\uC758 \uC0C1\uD0DC\uB97C Approved\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.)",
+      workflowPrLinkMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC PR \uB9C1\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (tasks.md\uC758 PR \uD544\uB4DC\uB97C \uCC44\uC6B0\uC138\uC694.)",
+      workflowPrStatusMissing: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC PR \uC0C1\uD0DC\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4. (tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Draft/Review/Approved \uC911 \uD558\uB098\uB85C \uC124\uC815\uD558\uC138\uC694.)",
+      workflowPrStatusNotApproved: "\uC644\uB8CC \uC0C1\uD0DC\uC774\uC9C0\uB9CC PR \uC0C1\uD0DC\uAC00 Approved\uAC00 \uC544\uB2D9\uB2C8\uB2E4. (merge \uD6C4 tasks.md\uC758 PR \uC0C1\uD0DC\uB97C Approved\uB85C \uC5C5\uB370\uC774\uD2B8\uD558\uC138\uC694.)"
     }
   },
   en: {
@@ -1126,6 +784,7 @@ var I18N = {
       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)",
+      prFillStatus: "Set PR Status in tasks.md to Draft/Review/Approved. (After merge, update to Approved)",
       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.",
@@ -1134,7 +793,12 @@ var I18N = {
     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."
+      legacyTasksPrFields: "Legacy tasks.md format detected. Add `PR` and `PR Status` fields before PR steps.",
+      workflowSpecNotApproved: "Implementation is done but spec.md Status is not Approved. (Update spec.md Status to Approved.)",
+      workflowPlanNotApproved: "Implementation is done but plan.md Status is not Approved. (Update plan.md Status to Approved.)",
+      workflowPrLinkMissing: "Implementation is done but PR link is missing. (Fill the PR field in tasks.md.)",
+      workflowPrStatusMissing: "Implementation is done but PR Status is missing. (Set PR Status to Draft/Review/Approved in tasks.md.)",
+      workflowPrStatusNotApproved: "Implementation is done but PR Status is not Approved. (After merge, update PR Status to Approved in tasks.md.)"
     }
   }
 };
@@ -1147,11 +811,14 @@ function tr(lang, category, key, vars = {}) {
 function isCompletionChecklistDone(feature) {
   return !!feature.completionChecklist && feature.completionChecklist.total > 0 && feature.completionChecklist.checked === feature.completionChecklist.total;
 }
+function isImplementationDone(feature) {
+  return feature.docs.tasksExists && feature.tasks.total > 0 && feature.tasks.total === feature.tasks.done && isCompletionChecklistDone(feature);
+}
 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";
+  return feature.specStatus === "Approved" && feature.planStatus === "Approved" && 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 [
@@ -1323,7 +990,7 @@ function getStepDefinitions(lang) {
       name: tr(lang, "steps", "branchCreate"),
       checklist: { done: (f) => f.git.onExpectedBranch },
       current: {
-        when: (f) => !!f.issueNumber && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
+        when: (f) => !!f.issueNumber && !isImplementationDone(f) && !isFeatureDone(f) && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
         actions: (f) => {
           if (!f.git.projectBranchAvailable || !f.git.projectGitCwd) {
             return [
@@ -1444,6 +1111,15 @@ function getStepDefinitions(lang) {
       current: {
         when: (f) => isPrMetadataConfigured(f) && !!f.pr.link && f.pr.status !== "Approved",
         actions: (f) => {
+          if (!f.pr.status) {
+            return [
+              {
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "prFillStatus")
+              }
+            ];
+          }
           if (f.pr.status === "Review") {
             return [
               {
@@ -1589,7 +1265,7 @@ function isExpectedFeatureBranch(branchName, issueNumber, slug, folderName) {
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-function extractSpecValue2(content, key) {
+function extractSpecValue(content, key) {
   const regex = new RegExp(
     `^\\s*-\\s*\\*\\*${escapeRegExp(key)}\\*\\*\\s*:\\s*(.*)$`,
     "m"
@@ -1599,7 +1275,7 @@ function extractSpecValue2(content, key) {
 }
 function extractFirstSpecValue(content, keys) {
   for (const key of keys) {
-    const value = extractSpecValue2(content, key);
+    const value = extractSpecValue(content, key);
     if (value) return value;
   }
   return void 0;
@@ -1669,6 +1345,12 @@ function parseCompletionChecklist(content) {
   }
   return total > 0 ? { total, checked } : void 0;
 }
+function isCompletionChecklistDone2(feature) {
+  return !!feature.completionChecklist && feature.completionChecklist.total > 0 && feature.completionChecklist.checked === feature.completionChecklist.total;
+}
+function isPrMetadataConfigured2(feature) {
+  return feature.docs.prFieldExists && feature.docs.prStatusFieldExists;
+}
 async function parseFeature(featurePath, type, context, options) {
   const lang = options.lang;
   const folderName = path4.basename(featurePath);
@@ -1680,22 +1362,22 @@ async function parseFeature(featurePath, type, context, options) {
   const tasksPath = path4.join(featurePath, "tasks.md");
   let specStatus;
   let issueNumber;
-  const specExists = await fs6.pathExists(specPath);
+  const specExists = await fs8.pathExists(specPath);
   if (specExists) {
-    const content = await fs6.readFile(specPath, "utf-8");
+    const content = await fs8.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);
+  const planExists = await fs8.pathExists(planPath);
   if (planExists) {
-    const content = await fs6.readFile(planPath, "utf-8");
+    const content = await fs8.readFile(planPath, "utf-8");
     const statusValue = extractFirstSpecValue(content, ["\uC0C1\uD0DC", "Status"]);
     planStatus = parseDocStatus(statusValue);
   }
-  const tasksExists = await fs6.pathExists(tasksPath);
+  const tasksExists = await fs8.pathExists(tasksPath);
   const tasksSummary = { total: 0, todo: 0, doing: 0, done: 0 };
   let activeTask;
   let nextTodoTask;
@@ -1705,7 +1387,7 @@ async function parseFeature(featurePath, type, context, options) {
   let prFieldExists = false;
   let prStatusFieldExists = false;
   if (tasksExists) {
-    const content = await fs6.readFile(tasksPath, "utf-8");
+    const content = await fs8.readFile(tasksPath, "utf-8");
     const { summary, activeTask: active, nextTodoTask: nextTodo } = parseTasks(content);
     tasksSummary.total = summary.total;
     tasksSummary.todo = summary.todo;
@@ -1744,12 +1426,33 @@ async function parseFeature(featurePath, type, context, options) {
   if (tasksExists && (!prFieldExists || !prStatusFieldExists)) {
     warnings.push(tr(lang, "warnings", "legacyTasksPrFields"));
   }
+  const implementationDone = tasksExists && tasksSummary.total > 0 && tasksSummary.total === tasksSummary.done && isCompletionChecklistDone2({ completionChecklist });
+  const workflowDone = implementationDone && specStatus === "Approved" && planStatus === "Approved" && isPrMetadataConfigured2({ docs: { prFieldExists, prStatusFieldExists } }) && !!prLink && prStatus === "Approved";
+  if (implementationDone && !workflowDone) {
+    if (specStatus !== "Approved") {
+      warnings.push(tr(lang, "warnings", "workflowSpecNotApproved"));
+    }
+    if (planStatus !== "Approved") {
+      warnings.push(tr(lang, "warnings", "workflowPlanNotApproved"));
+    }
+    if (prFieldExists && prStatusFieldExists) {
+      if (!prLink) warnings.push(tr(lang, "warnings", "workflowPrLinkMissing"));
+      if (!prStatus) warnings.push(tr(lang, "warnings", "workflowPrStatusMissing"));
+      if (prStatus && prStatus !== "Approved") {
+        warnings.push(tr(lang, "warnings", "workflowPrStatusNotApproved"));
+      }
+    }
+  }
   const featureState = {
     id,
     slug,
     folderName,
     type,
     path: featurePath,
+    completion: {
+      implementationDone,
+      workflowDone
+    },
     issueNumber,
     specStatus,
     planStatus,
@@ -1815,7 +1518,7 @@ async function scanFeatures(config) {
       ignore: ["**/feature-base/**"]
     });
     for (const dir of featureDirs) {
-      if ((await fs6.stat(dir)).isDirectory()) {
+      if ((await fs8.stat(dir)).isDirectory()) {
         features.push(
           await parseFeature(
             dir,
@@ -1832,62 +1535,421 @@ async function scanFeatures(config) {
           )
         );
       }
-    }
-  } 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 }
-          )
-        );
+    }
+  } 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 fs8.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 fs8.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/status.ts
+function statusCommand(program2) {
+  program2.command("status").description("Show feature status").option("-w, --write", "Write status.md file").option("-s, --strict", "Fail on missing/duplicate feature IDs").action(async (options) => {
+    try {
+      await runStatus(options);
+    } catch (error) {
+      console.error(chalk6.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runStatus(options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.error(
+      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, projectName } = config;
+  const featuresDir = path4.join(docsDir, "features");
+  const scan = await scanFeatures(config);
+  const features = [];
+  const idMap = /* @__PURE__ */ new Map();
+  for (const f of scan.features) {
+    if (!f.docs.specExists || !f.docs.tasksExists) continue;
+    const id = f.id || "UNKNOWN";
+    const name = await getFeatureNameFromSpec(f.path, f.slug, f.folderName);
+    const repo = projectType === "fullstack" ? `${projectName ?? "{{projectName}}"}-${f.type === "single" ? "" : f.type}`.replace(
+      /-$/,
+      ""
+    ) : projectName ?? "{{projectName}}";
+    const issue = f.issueNumber ? `#${f.issueNumber}` : "-";
+    const relPath = path4.relative(docsDir, f.path);
+    if (!idMap.has(id)) idMap.set(id, []);
+    idMap.get(id).push(relPath);
+    const total = f.tasks.total;
+    const done = f.tasks.done;
+    const doing = f.tasks.doing;
+    const todo = f.tasks.todo;
+    let status = "TODO";
+    if (total > 0 && done === total) status = "DONE";
+    else if (doing > 0) status = "DOING";
+    else if (todo > 0) status = "TODO";
+    else if (total === 0) status = "NO_TASKS";
+    features.push({
+      id,
+      name,
+      repo,
+      issue,
+      status,
+      progress: `${done}/${total}`,
+      path: relPath
+    });
+  }
+  if (features.length === 0) {
+    console.log(chalk6.yellow("Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    return;
+  }
+  if (options.strict) {
+    const duplicates = [...idMap.entries()].filter(
+      ([, paths]) => paths.length > 1
+    );
+    if (duplicates.length > 0) {
+      console.error(chalk6.red("\uC911\uBCF5 Feature ID \uBC1C\uACAC:"));
+      for (const [id, paths] of duplicates) {
+        console.error(chalk6.red(`  ${id}:`));
+        for (const p of paths) {
+          console.error(chalk6.red(`    - ${p}`));
+        }
+      }
+      process.exit(1);
+    }
+    const unknowns = [...idMap.entries()].filter(([id]) => id === "UNKNOWN");
+    if (unknowns.length > 0) {
+      console.error(chalk6.red("Feature ID\uAC00 \uC5C6\uB294 \uD56D\uBAA9:"));
+      for (const [, paths] of unknowns) {
+        for (const p of paths) {
+          console.error(chalk6.red(`  - ${p}`));
+        }
+      }
+      process.exit(1);
+    }
+  }
+  features.sort((a, b) => a.id.localeCompare(b.id));
+  const header = "| ID | Name | Repo | Issue | Status | Progress | Path |";
+  const separator = "| --- | --- | --- | --- | --- | --- | --- |";
+  console.log();
+  console.log(header);
+  console.log(separator);
+  for (const f of features) {
+    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 = path4.join(featuresDir, "status.md");
+    const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const content = [
+      "# Feature Status",
+      "",
+      `- Generated: ${date}`,
+      "- Source: `tasks.md`, `spec.md`",
+      "",
+      header,
+      separator,
+      ...features.map(
+        (f) => `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${f.status} | ${f.progress} | ${f.path} |`
+      ),
+      ""
+    ].join("\n");
+    await fs8.writeFile(outputPath, content, "utf-8");
+    console.log(chalk6.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
+  }
+}
+function escapeRegExp2(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+async function getFeatureNameFromSpec(featureDir, fallbackSlug, fallbackFolderName) {
+  try {
+    const specPath = path4.join(featureDir, "spec.md");
+    if (!await fs8.pathExists(specPath)) return fallbackSlug;
+    const content = await fs8.readFile(specPath, "utf-8");
+    const keys = ["\uAE30\uB2A5\uBA85", "Feature Name"];
+    for (const key of keys) {
+      const regex = new RegExp(
+        `^\\s*-\\s*\\*\\*${escapeRegExp2(key)}\\*\\*\\s*:\\s*(.*)$`,
+        "m"
+      );
+      const match = content.match(regex);
+      const value = match?.[1]?.trim();
+      if (value) return value;
+    }
+  } catch {
+  }
+  return fallbackSlug || fallbackFolderName;
+}
+function updateCommand(program2) {
+  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--templates", "Update feature-base/ folder only").option("-f, --force", "Force overwrite without confirmation").action(async (options) => {
+    try {
+      await runUpdate(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 runUpdate(options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.error(
+      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 = path4.join(templatesDir, lang, projectType);
+  const updateAgents = options.agents || !options.agents && !options.templates;
+  const updateTemplates = options.templates || !options.agents && !options.templates;
+  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(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
+    };
+    if (await fs8.pathExists(commonAgents)) {
+      const count = await updateFolder(
+        commonAgents,
+        targetAgents,
+        options.force,
+        replacements
+      );
+      updatedCount += count;
+    }
+    if (await fs8.pathExists(typeAgents)) {
+      const count = await updateFolder(typeAgents, targetAgents, options.force);
+      updatedCount += count;
+    }
+    console.log(chalk6.green(`  \u2705 agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+  }
+  if (updateTemplates) {
+    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 fs8.pathExists(sourceFeatureBase)) {
+      const count = await updateFolder(
+        sourceFeatureBase,
+        targetFeatureBase,
+        options.force
+      );
+      updatedCount += count;
+      console.log(chalk6.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+    }
+  }
+  console.log();
+  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 fs8.ensureDir(targetDir);
+  const files = await fs8.readdir(sourceDir);
+  let updatedCount = 0;
+  for (const file of files) {
+    const sourcePath = path4.join(sourceDir, file);
+    const targetPath = path4.join(targetDir, file);
+    const stat = await fs8.stat(sourcePath);
+    if (stat.isFile()) {
+      if (protectedFiles.has(file)) {
+        continue;
+      }
+      let sourceContent = await fs8.readFile(sourcePath, "utf-8");
+      if (replacements) {
+        for (const [key, value] of Object.entries(replacements)) {
+          sourceContent = sourceContent.replaceAll(key, value);
+        }
+      }
+      let shouldUpdate = true;
+      if (await fs8.pathExists(targetPath)) {
+        const targetContent = await fs8.readFile(targetPath, "utf-8");
+        if (sourceContent === targetContent) {
+          continue;
+        }
+        if (!force) {
+          console.log(
+            chalk6.yellow(`  \u26A0\uFE0F ${file} - \uBCC0\uACBD \uAC10\uC9C0 (--force\uB85C \uB36E\uC5B4\uC4F0\uAE30)`)
+          );
+          shouldUpdate = false;
+        }
+      }
+      if (shouldUpdate) {
+        await fs8.writeFile(targetPath, sourceContent);
+        console.log(chalk6.gray(`  \u{1F4C4} ${file} \uC5C5\uB370\uC774\uD2B8`));
+        updatedCount++;
       }
+    } else if (stat.isDirectory()) {
+      const subCount = await updateFolder(
+        sourcePath,
+        targetPath,
+        force,
+        replacements
+      );
+      updatedCount += subCount;
     }
-    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 updatedCount;
+}
+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);
   }
-  return {
-    features,
-    branches: {
-      docs: docsBranch,
-      project: config.projectType === "single" ? { single: projectBranches.single } : { fe: projectBranches.fe, be: projectBranches.be }
-    },
-    warnings
-  };
+  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 fs8.readJson(configPath);
+    console.log(JSON.stringify(configFile2, null, 2));
+    console.log();
+    return;
+  }
+  const configFile = await fs8.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 fs8.writeJson(configPath, configFile, { spaces: 2 });
+  console.log();
 }
-
-// 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(
+  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").option("--all", "Include completed features when auto-detecting").option("--done", "Show completed (workflow-done) features only").action(
     async (featureName, options) => {
       try {
         await runContext(featureName, options);
@@ -1933,12 +1995,22 @@ async function runContext(featureName, options) {
   const stepDefinitions = getStepDefinitions(lang);
   const stepsMap = getStepsMap(lang);
   const { features, branches, warnings } = await scanFeatures(config);
+  const doneFeatures = features.filter((f2) => f2.completion.workflowDone);
+  const openFeatures = features.filter((f2) => !f2.completion.workflowDone);
+  const inProgressFeatures = openFeatures.filter(
+    (f2) => !f2.completion.implementationDone
+  );
+  const readyToCloseFeatures = openFeatures.filter(
+    (f2) => f2.completion.implementationDone
+  );
   let targetFeatures = [];
+  let selectionMode = "explicit";
   if (featureName) {
     targetFeatures = features.filter((f2) => matchesFeatureSelector(f2, featureName));
     if (options.repo) {
       targetFeatures = targetFeatures.filter((f2) => f2.type === options.repo);
     }
+    selectionMode = "explicit";
   } else {
     if (config.projectType === "single") {
       const branchName = branches.project.single || "";
@@ -1960,15 +2032,33 @@ async function runContext(featureName, options) {
       ) : [];
       targetFeatures = [...feMatches, ...beMatches];
     }
-    if (targetFeatures.length === 0) targetFeatures = features;
+    if (targetFeatures.length > 0) {
+      selectionMode = "branch";
+    } else if (options.all) {
+      targetFeatures = features;
+      selectionMode = "all";
+    } else if (options.done) {
+      targetFeatures = doneFeatures;
+      selectionMode = "done";
+    } else {
+      targetFeatures = openFeatures;
+      selectionMode = "open";
+    }
   }
   if (options.json) {
+    const isNoOpen = selectionMode === "open" && features.length > 0 && openFeatures.length === 0;
     const result = {
-      status: features.length === 0 ? "no_features" : targetFeatures.length === 1 ? "single_matched" : targetFeatures.length > 1 ? "multiple_active" : "no_match",
+      status: features.length === 0 ? "no_features" : isNoOpen ? "no_open" : targetFeatures.length === 1 ? "single_matched" : targetFeatures.length > 1 ? "multiple_active" : "no_match",
+      selectionMode,
       branches,
       warnings,
       matchedFeature: targetFeatures.length === 1 ? targetFeatures[0] : null,
       candidates: targetFeatures.length > 1 ? targetFeatures : [],
+      // "Completed" now means workflow-done.
+      completedCandidates: selectionMode === "open" ? doneFeatures : [],
+      openCandidates: selectionMode === "open" ? openFeatures : [],
+      inProgressCandidates: selectionMode === "open" ? inProgressFeatures : [],
+      readyToCloseCandidates: selectionMode === "open" ? readyToCloseFeatures : [],
       actions: targetFeatures.length === 1 ? targetFeatures[0].actions : [],
       recommendation: ""
     };
@@ -2024,22 +2114,53 @@ async function runContext(featureName, options) {
     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})`) : "";
+    if (selectionMode === "open") {
       console.log(
-        `   \u2022 ${chalk6.bold(f2.folderName)} ${typeStr} - ${chalk6.yellow(stepName2)}`
+        chalk6.gray(
+          `   (\uBE0C\uB79C\uCE58\uB85C Feature\uB97C \uD2B9\uC815\uD558\uC9C0 \uBABB\uD574 \uBBF8\uC644\uB8CC Feature\uB9CC \uD45C\uC2DC\uD569\uB2C8\uB2E4. \uC9C4\uD589 \uC911: ${inProgressFeatures.length}\uAC1C / \uC885\uB8CC \uB300\uAE30: ${readyToCloseFeatures.length}\uAC1C / \uC644\uB8CC: ${doneFeatures.length}\uAC1C)`
+        )
       );
-    });
+      console.log();
+    }
+    if (selectionMode === "open") {
+      console.log(chalk6.blue(`\u{1F539} In Progress (${inProgressFeatures.length})`));
+      inProgressFeatures.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.blue(`\u{1F538} Ready To Close (${readyToCloseFeatures.length})`));
+      readyToCloseFeatures.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)}`
+        );
+      });
+    } else {
+      const title = selectionMode === "all" ? `\u{1F539} ${targetFeatures.length} Features:` : selectionMode === "done" ? `\u{1F539} ${targetFeatures.length} Done Features:` : `\u{1F539} ${targetFeatures.length} Features Detected:`;
+      console.log(chalk6.blue(title));
+      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]")
     );
+    if (selectionMode === "open") {
+      console.log(chalk6.gray("   $ npx lee-spec-kit context --all   # \uC804\uCCB4 \uBCF4\uAE30"));
+      console.log(chalk6.gray("   $ npx lee-spec-kit context --done  # \uC644\uB8CC\uB9CC \uBCF4\uAE30"));
+    }
     console.log();
     return;
   }
@@ -2049,6 +2170,9 @@ async function runContext(featureName, options) {
   console.log(
     `\u{1F539} Feature: ${chalk6.bold(f.folderName)} ${config.projectType === "fullstack" ? chalk6.cyan(`(${f.type})`) : ""}`
   );
+  console.log(
+    `   \u2022 Completion: ${f.completion.implementationDone ? chalk6.green("Implementation \u2705") : chalk6.gray("Implementation \u25EF")} / ${f.completion.workflowDone ? chalk6.green("Workflow \u2705") : chalk6.yellow("Workflow \u25EF")}`
+  );
   if (f.issueNumber) {
     console.log(`   \u2022 Issue: #${f.issueNumber}`);
   }
@@ -2116,13 +2240,276 @@ function printChecklist(f, stepDefinitions) {
     console.log(`   ${mark} ${definition.step}. ${label} ${detail}`);
   });
 }
+function msg(lang, ko, en) {
+  return lang === "en" ? en : ko;
+}
+function formatPath(cwd, p) {
+  if (!p) return "";
+  return path4.isAbsolute(p) ? path4.relative(cwd, p) : p;
+}
+function detectPlaceholders(content) {
+  const patterns = [
+    { key: "{{projectName}}", re: /\{\{projectName\}\}/g },
+    { key: "{{date}}", re: /\{\{date\}\}/g },
+    { key: "{{featurePath}}", re: /\{\{featurePath\}\}/g },
+    { key: "{{description}}", re: /\{\{description\}\}/g },
+    { key: "{\uAE30\uB2A5\uBA85}", re: /\{기능명\}/g },
+    { key: "{\uBC88\uD638}", re: /\{번호\}/g },
+    { key: "{\uC774\uC288\uBC88\uD638}", re: /\{이슈번호\}/g },
+    { key: "{feature-name}", re: /\{feature-name\}/g },
+    { key: "{number}", re: /\{number\}/g },
+    { key: "{issue-number}", re: /\{issue-number\}/g },
+    { key: "{be|fe}", re: /\{be\|fe\}/g },
+    { key: "YYYY-MM-DD", re: /\bYYYY-MM-DD\b/g }
+  ];
+  const hits = [];
+  for (const { key, re } of patterns) {
+    if (re.test(content)) hits.push(key);
+  }
+  return hits;
+}
+async function checkDocsStructure(config, cwd) {
+  const issues = [];
+  const requiredDirs = ["agents", "features", "prd", "designs", "ideas"];
+  for (const dir of requiredDirs) {
+    const p = path4.join(config.docsDir, dir);
+    if (!await fs8.pathExists(p)) {
+      issues.push({
+        level: "error",
+        code: "missing_dir",
+        message: msg(
+          config.lang,
+          `\uD544\uC218 \uD3F4\uB354\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4: ${dir}`,
+          `Missing required directory: ${dir}`
+        ),
+        path: formatPath(cwd, p)
+      });
+    }
+  }
+  const configPath = path4.join(config.docsDir, ".lee-spec-kit.json");
+  if (!await fs8.pathExists(configPath)) {
+    issues.push({
+      level: "warn",
+      code: "missing_config",
+      message: msg(
+        config.lang,
+        "\uC124\uC815 \uD30C\uC77C(.lee-spec-kit.json)\uC774 \uC5C6\uC2B5\uB2C8\uB2E4. \uC77C\uBD80 \uAE30\uB2A5\uC774 \uD3F4\uB354 \uAD6C\uC870 \uCD94\uC815\uC73C\uB85C \uB3D9\uC791\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.",
+        "Missing .lee-spec-kit.json. Some commands may rely on folder-structure heuristics."
+      ),
+      path: formatPath(cwd, configPath)
+    });
+  }
+  return issues;
+}
+async function checkFeatures(config, cwd, features) {
+  const issues = [];
+  if (features.length === 0) {
+    issues.push({
+      level: "warn",
+      code: "no_features",
+      message: msg(
+        config.lang,
+        "Feature \uD3F4\uB354\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4. (feature-base\uB9CC \uC874\uC7AC\uD558\uAC70\uB098 \uC544\uC9C1 feature\uB97C \uB9CC\uB4E4\uC9C0 \uC54A\uC558\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.)",
+        "No feature folders found. (Only feature-base exists, or no features created yet.)"
+      )
+    });
+    return issues;
+  }
+  const idMap = /* @__PURE__ */ new Map();
+  for (const f of features) {
+    const rel = f.docs.featurePathFromDocs || path4.relative(config.docsDir, f.path);
+    const id = f.id || "UNKNOWN";
+    if (!idMap.has(id)) idMap.set(id, []);
+    idMap.get(id).push(rel);
+    const featureDocs = ["spec.md", "plan.md", "tasks.md", "decisions.md"];
+    for (const file of featureDocs) {
+      const p = path4.join(f.path, file);
+      if (!await fs8.pathExists(p)) continue;
+      const content = await fs8.readFile(p, "utf-8");
+      const placeholders = detectPlaceholders(content);
+      if (placeholders.length === 0) continue;
+      issues.push({
+        level: "warn",
+        code: "placeholder_left",
+        message: msg(
+          config.lang,
+          `\uD50C\uB808\uC774\uC2A4\uD640\uB354\uAC00 \uB0A8\uC544\uC788\uC2B5\uB2C8\uB2E4: ${placeholders.join(", ")}`,
+          `Leftover placeholders detected: ${placeholders.join(", ")}`
+        ),
+        path: formatPath(cwd, p)
+      });
+    }
+    if (!f.docs.specExists) {
+      issues.push({
+        level: "warn",
+        code: "missing_spec",
+        message: msg(
+          config.lang,
+          "spec.md\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+          "Missing spec.md."
+        ),
+        path: formatPath(cwd, f.path)
+      });
+    } else if (!f.specStatus) {
+      issues.push({
+        level: "warn",
+        code: "spec_status_unset",
+        message: msg(
+          config.lang,
+          "spec.md\uC758 Status(\uC0C1\uD0DC)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uD15C\uD50C\uB9BF \uADF8\uB300\uB85C\uC77C \uC218 \uC788\uC74C)",
+          "spec.md Status is not set. (May still be a template)"
+        ),
+        path: formatPath(cwd, path4.join(f.path, "spec.md"))
+      });
+    }
+    if (f.docs.planExists && !f.planStatus) {
+      issues.push({
+        level: "warn",
+        code: "plan_status_unset",
+        message: msg(
+          config.lang,
+          "plan.md\uC758 Status(\uC0C1\uD0DC)\uAC00 \uC124\uC815\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4. (\uD15C\uD50C\uB9BF \uADF8\uB300\uB85C\uC77C \uC218 \uC788\uC74C)",
+          "plan.md Status is not set. (May still be a template)"
+        ),
+        path: formatPath(cwd, path4.join(f.path, "plan.md"))
+      });
+    }
+    if (f.docs.tasksExists && f.tasks.total === 0) {
+      issues.push({
+        level: "warn",
+        code: "tasks_empty",
+        message: msg(
+          config.lang,
+          "tasks.md\uC5D0 \uD0DC\uC2A4\uD06C\uAC00 \uC5C6\uC2B5\uB2C8\uB2E4.",
+          "tasks.md has no tasks."
+        ),
+        path: formatPath(cwd, path4.join(f.path, "tasks.md"))
+      });
+    }
+  }
+  const duplicates = [...idMap.entries()].filter(
+    ([id, paths]) => id !== "UNKNOWN" && paths.length > 1
+  );
+  for (const [id, paths] of duplicates) {
+    issues.push({
+      level: "warn",
+      code: "duplicate_feature_id",
+      message: msg(
+        config.lang,
+        `\uC911\uBCF5 Feature ID \uAC10\uC9C0: ${id} (${paths.length}\uAC1C)`,
+        `Duplicate Feature ID detected: ${id} (${paths.length})`
+      ),
+      path: formatPath(cwd, paths[0])
+    });
+  }
+  const unknowns = idMap.get("UNKNOWN") || [];
+  for (const p of unknowns) {
+    issues.push({
+      level: "warn",
+      code: "missing_feature_id",
+      message: msg(
+        config.lang,
+        "Feature \uD3F4\uB354\uBA85\uC774 F001-... \uD615\uC2DD\uC774 \uC544\uB2D9\uB2C8\uB2E4. (ID\uB97C \uCD94\uCD9C\uD560 \uC218 \uC5C6\uC74C)",
+        "Feature folder name is not in F001-... format. (Cannot extract ID)"
+      ),
+      path: formatPath(cwd, path4.join(config.docsDir, p))
+    });
+  }
+  return issues;
+}
+function doctorCommand(program2) {
+  program2.command("doctor").description("Validate docs structure and feature metadata").option("--json", "Output in JSON format for agents").option("-s, --strict", "Exit with non-zero code when issues are found").action(async (options) => {
+    const cwd = process.cwd();
+    const config = await getConfig(cwd);
+    if (!config) {
+      const message = "\uC124\uC815 \uD30C\uC77C\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD574\uC8FC\uC138\uC694.";
+      if (options.json) {
+        console.log(JSON.stringify({ status: "error", error: message }, null, 2));
+      } else {
+        console.error(chalk6.red("\uC624\uB958:"), message);
+      }
+      process.exit(1);
+    }
+    const { docsDir, projectType, lang } = config;
+    const { features, branches, warnings } = await scanFeatures(config);
+    const issues = [];
+    issues.push(...await checkDocsStructure({ docsDir, lang }, cwd));
+    issues.push(...await checkFeatures({ docsDir, lang }, cwd, features));
+    const hasIssues = issues.length > 0;
+    const hasErrors = issues.some((i) => i.level === "error");
+    const exitCode = options.strict && hasIssues ? 1 : 0;
+    if (options.json) {
+      console.log(
+        JSON.stringify(
+          {
+            status: hasErrors ? "error" : hasIssues ? "warn" : "ok",
+            meta: { docsDir, projectType, lang },
+            branches,
+            warnings,
+            counts: {
+              features: features.length,
+              issues: issues.length,
+              errors: issues.filter((i) => i.level === "error").length,
+              warnings: issues.filter((i) => i.level === "warn").length
+            },
+            issues
+          },
+          null,
+          2
+        )
+      );
+      process.exit(exitCode);
+    }
+    console.log();
+    console.log(chalk6.bold("\u{1F50E} Docs Doctor"));
+    console.log(chalk6.gray(`- Docs: ${path4.relative(cwd, docsDir)}`));
+    console.log(chalk6.gray(`- Type: ${projectType}`));
+    console.log(chalk6.gray(`- Lang: ${lang}`));
+    console.log();
+    if (warnings.length > 0) {
+      console.log(chalk6.yellow("\u26A0\uFE0F  Environment warnings:"));
+      warnings.forEach((w) => console.log(chalk6.yellow(`  - ${w}`)));
+      console.log();
+    }
+    if (!hasIssues) {
+      console.log(chalk6.green("\u2705 \uBB38\uC81C\uB97C \uCC3E\uC9C0 \uBABB\uD588\uC2B5\uB2C8\uB2E4."));
+      console.log();
+      process.exit(0);
+    }
+    const errors = issues.filter((i) => i.level === "error");
+    const warns = issues.filter((i) => i.level === "warn");
+    if (errors.length > 0) {
+      console.log(chalk6.red(`\u274C Errors (${errors.length})`));
+      errors.forEach(
+        (i) => console.log(chalk6.red(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`))
+      );
+      console.log();
+    }
+    if (warns.length > 0) {
+      console.log(chalk6.yellow(`\u26A0\uFE0F  Warnings (${warns.length})`));
+      warns.forEach(
+        (i) => console.log(
+          chalk6.yellow(`  - ${i.message}${i.path ? ` (${i.path})` : ""}`)
+        )
+      );
+      console.log();
+    }
+    console.log(
+      chalk6.gray(
+        `Tip: \uC5D0\uC774\uC804\uD2B8\uC6A9 JSON \uCD9C\uB825: npx lee-spec-kit doctor --json${options.strict ? " --strict" : ""}`
+      )
+    );
+    console.log();
+    process.exit(exitCode);
+  });
+}
 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 = path4.join(__dirname$1, "..", "package.json");
-    if (fs6.existsSync(packageJsonPath)) {
-      const pkg = fs6.readJsonSync(packageJsonPath);
+    if (fs8.existsSync(packageJsonPath)) {
+      const pkg = fs8.readJsonSync(packageJsonPath);
       return pkg.version;
     }
   } catch {
@@ -2131,8 +2518,8 @@ function getCurrentVersion() {
 }
 function readCache() {
   try {
-    if (fs6.existsSync(CACHE_FILE)) {
-      return fs6.readJsonSync(CACHE_FILE);
+    if (fs8.existsSync(CACHE_FILE)) {
+      return fs8.readJsonSync(CACHE_FILE);
     }
   } catch {
   }
@@ -2196,12 +2583,23 @@ function checkForUpdates() {
 }
 
 // src/index.ts
-checkForUpdates();
+function shouldCheckForUpdates() {
+  const argv = process.argv.slice(2);
+  const hasJsonFlag = argv.includes("--json");
+  const isHelpOrVersion = argv.includes("--help") || argv.includes("-h") || argv.includes("--version") || argv.includes("-V");
+  const disabledByEnv = (process.env.LSK_NO_UPDATE_CHECK || "").trim() === "1" || (process.env.LEE_SPEC_KIT_NO_UPDATE_CHECK || "").trim() === "1";
+  if (hasJsonFlag) return false;
+  if (!process.stdout.isTTY) return false;
+  if (isHelpOrVersion) return false;
+  if (disabledByEnv) return false;
+  return true;
+}
+if (shouldCheckForUpdates()) checkForUpdates();
 function getCliVersion() {
   try {
     const packageJsonPath = path4.join(__dirname$1, "..", "package.json");
-    if (fs6.existsSync(packageJsonPath)) {
-      const pkg = fs6.readJsonSync(packageJsonPath);
+    if (fs8.existsSync(packageJsonPath)) {
+      const pkg = fs8.readJsonSync(packageJsonPath);
       if (pkg?.version) return String(pkg.version);
     }
   } catch {
@@ -2217,4 +2615,5 @@ statusCommand(program);
 updateCommand(program);
 configCommand(program);
 contextCommand(program);
-program.parse();
+doctorCommand(program);
+await program.parseAsync();