lee-spec-kit 0.2.0 → 0.2.1

package/dist/index.js

@@ -1,12 +1,17 @@
 #!/usr/bin/env node
+import path7 from 'path';
+import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import prompts from 'prompts';
 import chalk from 'chalk';
-import path6 from 'path';
 import fs6 from 'fs-extra';
 import { glob } from 'glob';
-import { fileURLToPath } from 'url';
+import { spawn, execSync } from 'child_process';
+import os from 'os';
 
+var getFilename = () => fileURLToPath(import.meta.url);
+var getDirname = () => path7.dirname(getFilename());
+var __dirname$1 = /* @__PURE__ */ getDirname();
 async function copyTemplates(src, dest) {
   await fs6.copy(src, dest, {
     overwrite: true,
@@ -32,10 +37,10 @@ async function replaceInFiles(dir, replacements) {
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path6.dirname(__filename2);
+var __dirname2 = path7.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path6.resolve(__dirname2, "..");
-  return path6.join(rootDir, "templates");
+  const rootDir = path7.resolve(__dirname2, "..");
+  return path7.join(rootDir, "templates");
 }
 
 // src/utils/validation.ts
@@ -132,8 +137,17 @@ function assertValid(result, context) {
     throw new Error(message);
   }
 }
-
-// src/commands/init.ts
+function checkGitRepo(cwd) {
+  try {
+    execSync("git rev-parse --is-inside-work-tree", {
+      cwd,
+      stdio: "ignore"
+    });
+    return true;
+  } catch {
+    return false;
+  }
+}
 function initCommand(program2) {
   program2.command("init").description("Initialize project documentation structure").option("-n, --name <name>", "Project name (default: current folder name)").option("-t, --type <type>", "Project type: single | fullstack").option("-l, --lang <lang>", "Language: ko | en (default: ko)").option("-d, --dir <dir>", "Target directory (default: ./docs)", "./docs").option("-y, --yes", "Skip prompts and use defaults").action(async (options) => {
     try {
@@ -150,12 +164,36 @@ function initCommand(program2) {
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path6.basename(cwd);
+  const defaultName = path7.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let lang = options.lang || "ko";
-  const targetDir = path6.resolve(cwd, options.dir || "./docs");
+  let docsRepo = "embedded";
+  let pushDocs;
+  let docsRemote;
+  const targetDir = path7.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}`));
+    if (isInsideGitRepo) {
+      console.log(chalk.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(
+        chalk.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,")
+      );
+      console.log(chalk.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();
     const response = await prompts(
       [
         {
@@ -191,6 +229,24 @@ async function runInit(options) {
             { title: "English (en)", value: "en" }
           ],
           initial: 0
+        },
+        {
+          type: "select",
+          name: "docsRepo",
+          message: "Docs \uAD00\uB9AC \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:",
+          choices: [
+            {
+              title: "embedded - \uD504\uB85C\uC81D\uD2B8 \uB0B4 \uD3EC\uD568 (./docs)",
+              value: "embedded",
+              description: "\uD504\uB85C\uC81D\uD2B8\uC640 \uD568\uAED8 push\uB429\uB2C8\uB2E4"
+            },
+            {
+              title: "standalone - \uBCC4\uB3C4 \uB3C5\uB9BD \uB808\uD3EC",
+              value: "standalone",
+              description: "push \uC5EC\uBD80\uB97C \uBCC4\uB3C4\uB85C \uC124\uC815\uD569\uB2C8\uB2E4"
+            }
+          ],
+          initial: 0
         }
       ],
       {
@@ -202,6 +258,53 @@ async function runInit(options) {
     projectName = response.projectName || projectName;
     projectType = response.projectType || projectType;
     lang = response.lang || lang;
+    docsRepo = response.docsRepo || "embedded";
+    if (docsRepo === "standalone") {
+      const standaloneResponse = await prompts(
+        [
+          {
+            type: "select",
+            name: "pushDocs",
+            message: "Docs push \uBC29\uC2DD\uC744 \uC120\uD0DD\uD558\uC138\uC694:",
+            choices: [
+              {
+                title: "local - \uB85C\uCEEC\uC5D0\uC11C\uB9CC \uAD00\uB9AC (push \uC548 \uD568)",
+                value: false
+              },
+              {
+                title: "remote - \uC6D0\uACA9\uC5D0\uB3C4 push",
+                value: true
+              }
+            ],
+            initial: 0
+          }
+        ],
+        {
+          onCancel: () => {
+            throw new Error("canceled");
+          }
+        }
+      );
+      pushDocs = standaloneResponse.pushDocs;
+      if (pushDocs === true) {
+        const remoteResponse = await prompts(
+          [
+            {
+              type: "text",
+              name: "docsRemote",
+              message: "\uC6D0\uACA9 \uB808\uD3EC URL\uC744 \uC785\uB825\uD558\uC138\uC694:",
+              validate: (value) => value.trim() ? true : "URL\uC744 \uC785\uB825\uD574\uC8FC\uC138\uC694"
+            }
+          ],
+          {
+            onCancel: () => {
+              throw new Error("canceled");
+            }
+          }
+        );
+        docsRemote = remoteResponse.docsRemote;
+      }
+    }
   }
   if (!projectType) {
     projectType = "single";
@@ -232,8 +335,8 @@ async function runInit(options) {
   console.log(chalk.gray(`  \uACBD\uB85C: ${targetDir}`));
   console.log();
   const templatesDir = getTemplatesDir();
-  const commonPath = path6.join(templatesDir, lang, "common");
-  const typePath = path6.join(templatesDir, lang, projectType);
+  const commonPath = path7.join(templatesDir, lang, "common");
+  const typePath = path7.join(templatesDir, lang, projectType);
   if (await fs6.pathExists(commonPath)) {
     await copyTemplates(commonPath, targetDir);
   }
@@ -252,13 +355,20 @@ async function runInit(options) {
     projectName,
     projectType,
     lang,
-    createdAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+    createdAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+    docsRepo
   };
-  const configPath = path6.join(targetDir, ".lee-spec-kit.json");
+  if (docsRepo === "standalone") {
+    config.pushDocs = pushDocs;
+    if (pushDocs && docsRemote) {
+      config.docsRemote = docsRemote;
+    }
+  }
+  const configPath = path7.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();
-  await initGit(cwd, targetDir);
+  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(
@@ -266,8 +376,7 @@ async function runInit(options) {
   );
   console.log();
 }
-async function initGit(cwd, targetDir) {
-  const { execSync } = await import('child_process');
+async function initGit(cwd, targetDir, docsRepo, pushDocs, docsRemote) {
   try {
     try {
       execSync("git rev-parse --is-inside-work-tree", {
@@ -279,12 +388,23 @@ async function initGit(cwd, targetDir) {
       console.log(chalk.blue("\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911..."));
       execSync("git init", { cwd, stdio: "ignore" });
     }
-    const relativePath = path6.relative(cwd, targetDir);
+    const relativePath = path7.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"
     });
+    if (docsRepo === "standalone" && pushDocs && docsRemote) {
+      try {
+        execSync(`git remote add origin "${docsRemote}"`, {
+          cwd,
+          stdio: "ignore"
+        });
+        console.log(chalk.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(chalk.green("\u2705 Git \uCD08\uAE30 \uCEE4\uBC0B \uC644\uB8CC!"));
     console.log();
   } catch (error) {
@@ -296,12 +416,12 @@ async function initGit(cwd, targetDir) {
 }
 async function getConfig(cwd) {
   const possibleDirs = [
-    path6.join(cwd, "docs"),
+    path7.join(cwd, "docs"),
     cwd
     // 이미 docs 폴더 안에 있을 수 있음
   ];
   for (const docsDir of possibleDirs) {
-    const configPath = path6.join(docsDir, ".lee-spec-kit.json");
+    const configPath = path7.join(docsDir, ".lee-spec-kit.json");
     if (await fs6.pathExists(configPath)) {
       try {
         const configFile = await fs6.readJson(configPath);
@@ -309,18 +429,21 @@ async function getConfig(cwd) {
           docsDir,
           projectName: configFile.projectName,
           projectType: configFile.projectType,
-          lang: configFile.lang
+          lang: configFile.lang,
+          docsRepo: configFile.docsRepo,
+          pushDocs: configFile.pushDocs,
+          docsRemote: configFile.docsRemote
         };
       } catch {
       }
     }
-    const agentsPath = path6.join(docsDir, "agents");
-    const featuresPath = path6.join(docsDir, "features");
+    const agentsPath = path7.join(docsDir, "agents");
+    const featuresPath = path7.join(docsDir, "features");
     if (await fs6.pathExists(agentsPath) && await fs6.pathExists(featuresPath)) {
-      const bePath = path6.join(featuresPath, "be");
-      const fePath = path6.join(featuresPath, "fe");
+      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 = path6.join(agentsPath, "agents.md");
+      const agentsMdPath = path7.join(agentsPath, "agents.md");
       let lang = "ko";
       if (await fs6.pathExists(agentsMdPath)) {
         const content = await fs6.readFile(agentsMdPath, "utf-8");
@@ -392,17 +515,17 @@ async function runFeature(name, options) {
   }
   let featuresDir;
   if (projectType === "fullstack" && repo) {
-    featuresDir = path6.join(docsDir, "features", repo);
+    featuresDir = path7.join(docsDir, "features", repo);
   } else {
-    featuresDir = path6.join(docsDir, "features");
+    featuresDir = path7.join(docsDir, "features");
   }
   const featureFolderName = `${featureId}-${name}`;
-  const featureDir = path6.join(featuresDir, featureFolderName);
+  const featureDir = path7.join(featuresDir, featureFolderName);
   if (await fs6.pathExists(featureDir)) {
     console.error(chalk.red(`\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uD3F4\uB354\uC785\uB2C8\uB2E4: ${featureDir}`));
     process.exit(1);
   }
-  const featureBasePath = path6.join(docsDir, "features", "feature-base");
+  const featureBasePath = path7.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."));
     process.exit(1);
@@ -438,12 +561,12 @@ async function runFeature(name, options) {
   console.log();
 }
 async function getNextFeatureId(docsDir, projectType) {
-  const featuresDir = path6.join(docsDir, "features");
+  const featuresDir = path7.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "fullstack") {
-    scanDirs.push(path6.join(featuresDir, "be"));
-    scanDirs.push(path6.join(featuresDir, "fe"));
+    scanDirs.push(path7.join(featuresDir, "be"));
+    scanDirs.push(path7.join(featuresDir, "fe"));
   } else {
     scanDirs.push(featuresDir);
   }
@@ -483,20 +606,20 @@ async function runStatus(options) {
     process.exit(1);
   }
   const { docsDir, projectType } = config;
-  const featuresDir = path6.join(docsDir, "features");
+  const featuresDir = path7.join(docsDir, "features");
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   const scopes = projectType === "fullstack" ? ["be", "fe"] : [""];
   for (const scope of scopes) {
-    const scanDir = scope ? path6.join(featuresDir, scope) : featuresDir;
+    const scanDir = scope ? path7.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 = path6.join(scanDir, entry.name);
-      const specPath = path6.join(featureDir, "spec.md");
-      const tasksPath = path6.join(featureDir, "tasks.md");
+      const featureDir = path7.join(scanDir, entry.name);
+      const specPath = path7.join(featureDir, "spec.md");
+      const tasksPath = path7.join(featureDir, "tasks.md");
       if (!await fs6.pathExists(specPath)) continue;
       if (!await fs6.pathExists(tasksPath)) continue;
       const specContent = await fs6.readFile(specPath, "utf-8");
@@ -505,7 +628,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 = path6.relative(docsDir, featureDir);
+      const relPath = path7.relative(docsDir, featureDir);
       if (!idMap.has(id)) {
         idMap.set(id, []);
       }
@@ -575,7 +698,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path6.join(featuresDir, "status.md");
+    const outputPath = path7.join(featuresDir, "status.md");
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const content = [
       "# Feature Status",
@@ -642,7 +765,7 @@ async function runUpdate(options) {
   }
   const { docsDir, projectType, lang } = config;
   const templatesDir = getTemplatesDir();
-  const sourceDir = path6.join(templatesDir, lang, projectType);
+  const sourceDir = path7.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..."));
@@ -652,9 +775,9 @@ async function runUpdate(options) {
   let updatedCount = 0;
   if (updateAgents) {
     console.log(chalk.blue("\u{1F4C1} agents/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
-    const commonAgents = path6.join(templatesDir, lang, "common", "agents");
-    const typeAgents = path6.join(templatesDir, lang, projectType, "agents");
-    const targetAgents = path6.join(docsDir, "agents");
+    const commonAgents = path7.join(templatesDir, lang, "common", "agents");
+    const typeAgents = path7.join(templatesDir, lang, projectType, "agents");
+    const targetAgents = path7.join(docsDir, "agents");
     const featurePath = projectType === "fullstack" ? "docs/features/{be|fe}" : "docs/features";
     const replacements = {
       "{{featurePath}}": featurePath
@@ -676,8 +799,8 @@ async function runUpdate(options) {
   }
   if (updateTemplates) {
     console.log(chalk.blue("\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
-    const sourceFeatureBase = path6.join(sourceDir, "features", "feature-base");
-    const targetFeatureBase = path6.join(docsDir, "features", "feature-base");
+    const sourceFeatureBase = path7.join(sourceDir, "features", "feature-base");
+    const targetFeatureBase = path7.join(docsDir, "features", "feature-base");
     if (await fs6.pathExists(sourceFeatureBase)) {
       const count = await updateFolder(
         sourceFeatureBase,
@@ -696,8 +819,8 @@ async function updateFolder(sourceDir, targetDir, force, replacements) {
   const files = await fs6.readdir(sourceDir);
   let updatedCount = 0;
   for (const file of files) {
-    const sourcePath = path6.join(sourceDir, file);
-    const targetPath = path6.join(targetDir, file);
+    const sourcePath = path7.join(sourceDir, file);
+    const targetPath = path7.join(targetDir, file);
     const stat = await fs6.stat(sourcePath);
     if (stat.isFile()) {
       if (file === "custom.md") {
@@ -739,11 +862,90 @@ async function updateFolder(sourceDir, targetDir, force, replacements) {
   }
   return updatedCount;
 }
+var CACHE_FILE = path7.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");
+    if (fs6.existsSync(packageJsonPath)) {
+      const pkg = fs6.readJsonSync(packageJsonPath);
+      return pkg.version;
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
+function readCache() {
+  try {
+    if (fs6.existsSync(CACHE_FILE)) {
+      return fs6.readJsonSync(CACHE_FILE);
+    }
+  } catch {
+  }
+  return null;
+}
+function isNewerVersion(current, latest) {
+  const currentParts = current.split(".").map(Number);
+  const latestParts = latest.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((latestParts[i] || 0) > (currentParts[i] || 0)) return true;
+    if ((latestParts[i] || 0) < (currentParts[i] || 0)) return false;
+  }
+  return false;
+}
+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})`)
+  );
+  console.log(chalk.gray("   \uC5C5\uB370\uC774\uD2B8: npm update -g lee-spec-kit"));
+  console.log();
+}
+function spawnBackgroundVersionCheck() {
+  const script = `
+    const fs = require('fs');
+    const path = require('path');
+    const os = require('os');
+    
+    const CACHE_FILE = path.join(os.homedir(), '.lee-spec-kit-version-cache.json');
+    
+    fetch('https://registry.npmjs.org/lee-spec-kit/latest')
+      .then(res => res.json())
+      .then(data => {
+        const cache = { lastCheck: Date.now(), latestVersion: data.version };
+        fs.writeFileSync(CACHE_FILE, JSON.stringify(cache));
+      })
+      .catch(() => {});
+  `;
+  const child = spawn("node", ["-e", script], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+}
+function checkForUpdates() {
+  try {
+    const cache = readCache();
+    const now = Date.now();
+    if (cache && now - cache.lastCheck < CHECK_INTERVAL) {
+      if (cache.latestVersion) {
+        const currentVersion = getCurrentVersion();
+        if (isNewerVersion(currentVersion, cache.latestVersion)) {
+          printUpdateNotice(currentVersion, cache.latestVersion);
+        }
+      }
+      return;
+    }
+    spawnBackgroundVersionCheck();
+  } catch {
+  }
+}
 
 // src/index.ts
+checkForUpdates();
 program.name("lee-spec-kit").description(
   "Project documentation structure generator for AI-assisted development"
-).version("0.1.0");
+).version("0.2.0");
 initCommand(program);
 featureCommand(program);
 statusCommand(program);

package/package.json

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

package/templates/en/common/agents/git-workflow.md

@@ -103,6 +103,24 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 ---
 
+## Docs Push Rules
+
+> Refer to the `docsRepo` setting in `.lee-spec-kit.json`.
+
+| Setting                                      | Behavior                        |
+| -------------------------------------------- | ------------------------------- |
+| `docsRepo: "embedded"`                       | docs included with project push |
+| `docsRepo: "standalone"` + `pushDocs: false` | docs commit only, no push       |
+| `docsRepo: "standalone"` + `pushDocs: true`  | push docs changes separately    |
+
+### Standalone Mode Notes
+
+- If `pushDocs: false`, docs changes are **committed locally only**
+- If `pushDocs: true`, **push separately** after docs changes
+- Project repo and docs repo are separate, **manage each independently**
+
+---
+
 ## GitHub Setup Requirements
 
 ### Required

package/templates/ko/common/agents/git-workflow.md

@@ -103,6 +103,24 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 ---
 
+## Docs Push 규칙
+
+> `.lee-spec-kit.json`의 `docsRepo` 설정을 참조합니다.
+
+| 설정                                         | 동작                              |
+| -------------------------------------------- | --------------------------------- |
+| `docsRepo: "embedded"`                       | 프로젝트 push 시 docs도 함께 포함 |
+| `docsRepo: "standalone"` + `pushDocs: false` | docs는 커밋만, push 안 함         |
+| `docsRepo: "standalone"` + `pushDocs: true`  | docs 변경 시 별도 push 진행       |
+
+### Standalone 모드 주의사항
+
+- `pushDocs: false`인 경우 docs 변경사항은 **로컬에만 커밋**
+- `pushDocs: true`인 경우 docs 변경 후 **별도로 push** 필요
+- 프로젝트 레포와 docs 레포가 분리되어 있으므로 **각각 관리**
+
+---
+
 ## GitHub 설정 요구사항
 
 ### 필수