lee-spec-kit 0.1.7 → 0.2.0

package/dist/index.js

@@ -2,13 +2,13 @@
 import { program } from 'commander';
 import prompts from 'prompts';
 import chalk from 'chalk';
-import path3 from 'path';
-import fs3 from 'fs-extra';
+import path6 from 'path';
+import fs6 from 'fs-extra';
 import { glob } from 'glob';
 import { fileURLToPath } from 'url';
 
 async function copyTemplates(src, dest) {
-  await fs3.copy(src, dest, {
+  await fs6.copy(src, dest, {
     overwrite: true,
     errorOnExist: false
   });
@@ -16,26 +16,26 @@ 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 fs3.readFile(file, "utf-8");
+    let content = await fs6.readFile(file, "utf-8");
     for (const [search, replace] of Object.entries(replacements)) {
       content = content.replaceAll(search, replace);
     }
-    await fs3.writeFile(file, content, "utf-8");
+    await fs6.writeFile(file, content, "utf-8");
   }
   const shFiles = await glob("**/*.sh", { cwd: dir, absolute: true });
   for (const file of shFiles) {
-    let content = await fs3.readFile(file, "utf-8");
+    let content = await fs6.readFile(file, "utf-8");
     for (const [search, replace] of Object.entries(replacements)) {
       content = content.replaceAll(search, replace);
     }
-    await fs3.writeFile(file, content, "utf-8");
+    await fs6.writeFile(file, content, "utf-8");
   }
 }
 var __filename2 = fileURLToPath(import.meta.url);
-var __dirname2 = path3.dirname(__filename2);
+var __dirname2 = path6.dirname(__filename2);
 function getTemplatesDir() {
-  const rootDir = path3.resolve(__dirname2, "..");
-  return path3.join(rootDir, "templates");
+  const rootDir = path6.resolve(__dirname2, "..");
+  return path6.join(rootDir, "templates");
 }
 
 // src/utils/validation.ts
@@ -150,11 +150,11 @@ function initCommand(program2) {
 }
 async function runInit(options) {
   const cwd = process.cwd();
-  const defaultName = path3.basename(cwd);
+  const defaultName = path6.basename(cwd);
   let projectName = options.name || defaultName;
   let projectType = options.type;
   let lang = options.lang || "ko";
-  const targetDir = path3.resolve(cwd, options.dir || "./docs");
+  const targetDir = path6.resolve(cwd, options.dir || "./docs");
   if (!options.yes) {
     const response = await prompts(
       [
@@ -209,8 +209,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 fs3.pathExists(targetDir)) {
-    const files = await fs3.readdir(targetDir);
+  if (await fs6.pathExists(targetDir)) {
+    const files = await fs6.readdir(targetDir);
     if (files.length > 0) {
       const { overwrite } = await prompts({
         type: "confirm",
@@ -232,14 +232,20 @@ async function runInit(options) {
   console.log(chalk.gray(`  \uACBD\uB85C: ${targetDir}`));
   console.log();
   const templatesDir = getTemplatesDir();
-  const templatePath = path3.join(templatesDir, lang, projectType);
-  if (!await fs3.pathExists(templatePath)) {
-    throw new Error(`\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${templatePath}`);
+  const commonPath = path6.join(templatesDir, lang, "common");
+  const typePath = path6.join(templatesDir, lang, projectType);
+  if (await fs6.pathExists(commonPath)) {
+    await copyTemplates(commonPath, targetDir);
   }
-  await copyTemplates(templatePath, targetDir);
+  if (!await fs6.pathExists(typePath)) {
+    throw new Error(`\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${typePath}`);
+  }
+  await copyTemplates(typePath, targetDir);
+  const featurePath = projectType === "fullstack" ? "docs/features/{be|fe}" : "docs/features";
   const replacements = {
     "{{projectName}}": projectName,
-    "{{date}}": (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+    "{{date}}": (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+    "{{featurePath}}": featurePath
   };
   await replaceInFiles(targetDir, replacements);
   const config = {
@@ -248,8 +254,8 @@ async function runInit(options) {
     lang,
     createdAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
   };
-  const configPath = path3.join(targetDir, ".lee-spec-kit.json");
-  await fs3.writeJson(configPath, config, { spaces: 2 });
+  const configPath = path6.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);
@@ -273,7 +279,7 @@ async function initGit(cwd, targetDir) {
       console.log(chalk.blue("\u{1F4E6} Git \uCD08\uAE30\uD654 \uC911..."));
       execSync("git init", { cwd, stdio: "ignore" });
     }
-    const relativePath = path3.relative(cwd, targetDir);
+    const relativePath = path6.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,
@@ -290,15 +296,15 @@ async function initGit(cwd, targetDir) {
 }
 async function getConfig(cwd) {
   const possibleDirs = [
-    path3.join(cwd, "docs"),
+    path6.join(cwd, "docs"),
     cwd
     // 이미 docs 폴더 안에 있을 수 있음
   ];
   for (const docsDir of possibleDirs) {
-    const configPath = path3.join(docsDir, ".lee-spec-kit.json");
-    if (await fs3.pathExists(configPath)) {
+    const configPath = path6.join(docsDir, ".lee-spec-kit.json");
+    if (await fs6.pathExists(configPath)) {
       try {
-        const configFile = await fs3.readJson(configPath);
+        const configFile = await fs6.readJson(configPath);
         return {
           docsDir,
           projectName: configFile.projectName,
@@ -308,16 +314,16 @@ async function getConfig(cwd) {
       } catch {
       }
     }
-    const agentsPath = path3.join(docsDir, "agents");
-    const featuresPath = path3.join(docsDir, "features");
-    if (await fs3.pathExists(agentsPath) && await fs3.pathExists(featuresPath)) {
-      const bePath = path3.join(featuresPath, "be");
-      const fePath = path3.join(featuresPath, "fe");
-      const projectType = await fs3.pathExists(bePath) || await fs3.pathExists(fePath) ? "fullstack" : "single";
-      const agentsMdPath = path3.join(agentsPath, "agents.md");
+    const agentsPath = path6.join(docsDir, "agents");
+    const featuresPath = path6.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 projectType = await fs6.pathExists(bePath) || await fs6.pathExists(fePath) ? "fullstack" : "single";
+      const agentsMdPath = path6.join(agentsPath, "agents.md");
       let lang = "ko";
-      if (await fs3.pathExists(agentsMdPath)) {
-        const content = await fs3.readFile(agentsMdPath, "utf-8");
+      if (await fs6.pathExists(agentsMdPath)) {
+        const content = await fs6.readFile(agentsMdPath, "utf-8");
         if (!/[가-힣]/.test(content)) {
           lang = "en";
         }
@@ -386,22 +392,22 @@ async function runFeature(name, options) {
   }
   let featuresDir;
   if (projectType === "fullstack" && repo) {
-    featuresDir = path3.join(docsDir, "features", repo);
+    featuresDir = path6.join(docsDir, "features", repo);
   } else {
-    featuresDir = path3.join(docsDir, "features");
+    featuresDir = path6.join(docsDir, "features");
   }
   const featureFolderName = `${featureId}-${name}`;
-  const featureDir = path3.join(featuresDir, featureFolderName);
-  if (await fs3.pathExists(featureDir)) {
+  const featureDir = path6.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 = path3.join(docsDir, "features", "feature-base");
-  if (!await fs3.pathExists(featureBasePath)) {
+  const featureBasePath = path6.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);
   }
-  await fs3.copy(featureBasePath, featureDir);
+  await fs6.copy(featureBasePath, featureDir);
   const idNumber = featureId.replace("F", "");
   const repoName = projectType === "fullstack" && repo ? `{{projectName}}-${repo}` : "{{projectName}}";
   const replacements = {
@@ -432,18 +438,18 @@ async function runFeature(name, options) {
   console.log();
 }
 async function getNextFeatureId(docsDir, projectType) {
-  const featuresDir = path3.join(docsDir, "features");
+  const featuresDir = path6.join(docsDir, "features");
   let max = 0;
   const scanDirs = [];
   if (projectType === "fullstack") {
-    scanDirs.push(path3.join(featuresDir, "be"));
-    scanDirs.push(path3.join(featuresDir, "fe"));
+    scanDirs.push(path6.join(featuresDir, "be"));
+    scanDirs.push(path6.join(featuresDir, "fe"));
   } else {
     scanDirs.push(featuresDir);
   }
   for (const dir of scanDirs) {
-    if (!await fs3.pathExists(dir)) continue;
-    const entries = await fs3.readdir(dir, { withFileTypes: true });
+    if (!await fs6.pathExists(dir)) continue;
+    const entries = await fs6.readdir(dir, { withFileTypes: true });
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       const match = entry.name.match(/^F(\d+)-/);
@@ -477,29 +483,29 @@ async function runStatus(options) {
     process.exit(1);
   }
   const { docsDir, projectType } = config;
-  const featuresDir = path3.join(docsDir, "features");
+  const featuresDir = path6.join(docsDir, "features");
   const features = [];
   const idMap = /* @__PURE__ */ new Map();
   const scopes = projectType === "fullstack" ? ["be", "fe"] : [""];
   for (const scope of scopes) {
-    const scanDir = scope ? path3.join(featuresDir, scope) : featuresDir;
-    if (!await fs3.pathExists(scanDir)) continue;
-    const entries = await fs3.readdir(scanDir, { withFileTypes: true });
+    const scanDir = scope ? path6.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 = path3.join(scanDir, entry.name);
-      const specPath = path3.join(featureDir, "spec.md");
-      const tasksPath = path3.join(featureDir, "tasks.md");
-      if (!await fs3.pathExists(specPath)) continue;
-      if (!await fs3.pathExists(tasksPath)) continue;
-      const specContent = await fs3.readFile(specPath, "utf-8");
-      const tasksContent = await fs3.readFile(tasksPath, "utf-8");
+      const featureDir = path6.join(scanDir, entry.name);
+      const specPath = path6.join(featureDir, "spec.md");
+      const tasksPath = path6.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 = path3.relative(docsDir, featureDir);
+      const relPath = path6.relative(docsDir, featureDir);
       if (!idMap.has(id)) {
         idMap.set(id, []);
       }
@@ -569,7 +575,7 @@ async function runStatus(options) {
   }
   console.log();
   if (options.write) {
-    const outputPath = path3.join(featuresDir, "status.md");
+    const outputPath = path6.join(featuresDir, "status.md");
     const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const content = [
       "# Feature Status",
@@ -584,7 +590,7 @@ async function runStatus(options) {
       ),
       ""
     ].join("\n");
-    await fs3.writeFile(outputPath, content, "utf-8");
+    await fs6.writeFile(outputPath, content, "utf-8");
     console.log(chalk.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
   }
 }
@@ -611,6 +617,128 @@ function countTasks(content) {
   }
   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(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        process.exit(0);
+      }
+      console.error(chalk.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runUpdate(options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.error(
+      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+    );
+    process.exit(1);
+  }
+  const { docsDir, projectType, lang } = config;
+  const templatesDir = getTemplatesDir();
+  const sourceDir = path6.join(templatesDir, lang, projectType);
+  const updateAgents = options.agents || !options.agents && !options.templates;
+  const updateTemplates = options.templates || !options.agents && !options.templates;
+  console.log(chalk.blue("\u{1F4E6} \uD15C\uD50C\uB9BF \uC5C5\uB370\uC774\uD2B8\uB97C \uC2DC\uC791\uD569\uB2C8\uB2E4..."));
+  console.log(chalk.gray(`  - \uC5B8\uC5B4: ${lang}`));
+  console.log(chalk.gray(`  - \uD0C0\uC785: ${projectType}`));
+  console.log();
+  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 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(chalk.green(`  \u2705 agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+  }
+  if (updateTemplates) {
+    console.log(chalk.blue("\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911..."));
+    const sourceFeatureBase = path6.join(sourceDir, "features", "feature-base");
+    const targetFeatureBase = path6.join(docsDir, "features", "feature-base");
+    if (await fs6.pathExists(sourceFeatureBase)) {
+      const count = await updateFolder(
+        sourceFeatureBase,
+        targetFeatureBase,
+        options.force
+      );
+      updatedCount += count;
+      console.log(chalk.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
+    }
+  }
+  console.log();
+  console.log(chalk.green(`\u2705 \uCD1D ${updatedCount}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!`));
+}
+async function updateFolder(sourceDir, targetDir, force, replacements) {
+  await fs6.ensureDir(targetDir);
+  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 stat = await fs6.stat(sourcePath);
+    if (stat.isFile()) {
+      if (file === "custom.md") {
+        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(
+            chalk.yellow(`  \u26A0\uFE0F ${file} - \uBCC0\uACBD \uAC10\uC9C0 (--force\uB85C \uB36E\uC5B4\uC4F0\uAE30)`)
+          );
+          shouldUpdate = false;
+        }
+      }
+      if (shouldUpdate) {
+        await fs6.writeFile(targetPath, sourceContent);
+        console.log(chalk.gray(`  \u{1F4C4} ${file} \uC5C5\uB370\uC774\uD2B8`));
+        updatedCount++;
+      }
+    } else if (stat.isDirectory()) {
+      const subCount = await updateFolder(
+        sourcePath,
+        targetPath,
+        force,
+        replacements
+      );
+      updatedCount += subCount;
+    }
+  }
+  return updatedCount;
+}
 
 // src/index.ts
 program.name("lee-spec-kit").description(
@@ -619,4 +747,5 @@ program.name("lee-spec-kit").description(
 initCommand(program);
 featureCommand(program);
 statusCommand(program);
+updateCommand(program);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.1.7",
+  "version": "0.2.0",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {
@@ -12,6 +12,13 @@
     "dist",
     "templates"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "format": "prettier --write .",
+    "prepublishOnly": "pnpm build"
+  },
   "keywords": [
     "docs",
     "template",
@@ -49,10 +56,5 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src",
-    "format": "prettier --write ."
-  }
-}
+  "packageManager": "pnpm@10.7.0"
+}

package/templates/en/common/agents/custom.md

@@ -0,0 +1,29 @@
+# Custom Rules
+
+> ⚠️ This document contains **user-defined rules**.
+> It is NOT affected by `npx lee-spec-kit update`.
+> **Rules in this document take precedence over all other agent rules.**
+
+---
+
+## Project-Specific Rules
+
+(Write your project-specific rules here)
+
+---
+
+## Additional Language/Code Rules
+
+(Override default rules or add additional rules here)
+
+---
+
+## Custom Workflows
+
+(Write project-specific workflows here)
+
+---
+
+## Other
+
+(Write other rules here)

package/templates/en/{fullstack → common}/agents/git-workflow.md

@@ -37,6 +37,11 @@ main
 | `refactor` | Refactoring   |
 | `docs`     | Documentation |
 
+**Examples:**
+
+- `feat/123-user-auth`
+- `fix/456-login-error`
+
 ---
 
 ## Commit Convention
@@ -65,50 +70,36 @@ main
 
 ## Automation Workflow
 
-### 1. Feature Start
-
-```bash
-# 1. Create GitHub Issue (Feature = Issue)
-# 2. Create branch
-git checkout -b feat/{issue-number}-{feature-name}
-```
-
-### 2. Document Writing and Commit
+> 📖 Refer to `skills/` folder for step-by-step guides.
 
-| Document     | Commit Timing           | Commit Message Example         |
-| ------------ | ----------------------- | ------------------------------ |
-| spec.md      | After user approval     | `docs(#123): write spec`       |
-| plan.md      | After user approval     | `docs(#123): write plan`       |
-| tasks.md     | After user approval     | `docs(#123): break down tasks` |
-| decisions.md | Included in task commit | (no separate commit)           |
+| Workflow       | Guide                      |
+| -------------- | -------------------------- |
+| Feature Start  | `skills/create-feature.md` |
+| Issue Creation | `skills/create-issue.md`   |
+| Task Execution | `skills/execute-task.md`   |
+| PR Creation    | `skills/create-pr.md`      |
 
-> 📌 **Do not commit when creating Feature folder.**
-> Commit each document individually **after user approval**.
-
-### 3. Auto Commit on Task Completion
+### Branch Creation
 
 ```bash
-git add .
-git commit -m "{type}(#{issue}): {task-description}"
+git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### 4. Create PR on Feature Completion
+### Document Commit Timing (docs repo)
 
-```bash
-git push origin feat/{issue-number}-{feature-name}
-gh pr create --title "feat(#{issue}): {feature-title}" \
-  --body "Closes #{issue}" \
-  --base main
-```
+| Commit Timing                                     | Included Content                    | Commit Message Example                        |
+| ------------------------------------------------- | ----------------------------------- | --------------------------------------------- |
+| When planning complete (spec+plan+tasks approved) | `F{number}-{feature-name}/` folder  | `docs(#{issue}): F{number} spec, plan, tasks` |
+| When Feature complete (all tasks done)            | `F{number}-{feature-name}/` changes | `docs(#{issue}): F{number} Feature complete`  |
 
-### 5. Merge
+> ⚠️ Do not commit when creating Feature folder.
 
-```bash
-git checkout main
-git pull
-gh pr merge --squash --delete-branch
-git pull
-```
+### Merge Strategy
+
+| Situation      | Merge Method     |
+| -------------- | ---------------- |
+| Normal Feature | Squash and Merge |
+| Urgent Hotfix  | Squash and Merge |
 
 ---
 

package/templates/en/{single → common}/agents/issue-template.md

@@ -36,12 +36,17 @@ In GitHub Issues, use different link formats **based on file location**:
    [react-i18next](https://react.i18next.com/)
    ```
 
-3. **External/local documents** (no URL available): Use **relative path as text only**
-   ```text
-   ../docs/features/F001-feature-name/spec.md
+3. **Local documents** (no URL available): **Path from project root**
+
+   > 📁 Local documents use paths **from project root**.
+   > Format: `- **{Label}**: \`{path}\``
+
+   ```markdown
+   - **Spec**: `{{featurePath}}/F001-feature-name/spec.md`
+   - **Tasks**: `{{featurePath}}/F001-feature-name/tasks.md`
    ```
 
-> ⚠️ Local documents are not clickable on GitHub, so provide path text only.
+> ⚠️ Local documents are not clickable on GitHub, so use **bold label + code block path** format instead of markdown links.
 
 ---
 
@@ -64,7 +69,7 @@ In GitHub Issues, use different link formats **based on file location**:
 
 ## Related Documents
 
-- Spec: `docs/features/F{number}-{feature-name}/spec.md`
+- **Spec**: `{{featurePath}}/F{number}-{feature-name}/spec.md`
 
 ## Labels
 

package/templates/en/{single → common}/agents/pr-template.md

@@ -42,17 +42,24 @@ For file links within the repo in PR body, **always use current branch name**:
 
 ## Tests
 
+> ⚠️ **Check only after running tests. Do NOT check items that were not executed.**
+
 - [ ] Unit tests passed
 - [ ] Integration tests completed
 
+### Execution Results
+
+- Command: `{test command executed}`
+- Result: `{PASS/FAIL summary}`
+
 ## Screenshots (for UI changes)
 
 {Attach if applicable}
 
 ## Related Documents
 
-- Spec: `docs/features/F{number}-{feature-name}/spec.md`
-- Tasks: `docs/features/F{number}-{feature-name}/tasks.md`
+- **Spec**: `{{featurePath}}/F{number}-{feature-name}/spec.md`
+- **Tasks**: `{{featurePath}}/F{number}-{feature-name}/tasks.md`
 
 Closes #{issue-number}
 ```

package/templates/en/common/agents/skills/create-feature.md

@@ -0,0 +1,53 @@
+# New Feature Creation Process
+
+Step-by-step guide for adding a new Feature.
+
+---
+
+## Steps
+
+### 1. Create Feature Folder
+
+```bash
+npx lee-spec-kit feature <name> -d "<description>"
+```
+
+- `<name>`: Feature name (lowercase, hyphens allowed)
+- `-d`: Feature description (auto-filled in spec.md)
+
+**Example:**
+
+```bash
+npx lee-spec-kit feature user-auth -d "User authentication and session management"
+```
+
+### 2. Write spec.md
+
+- **What**: Clearly describe what the feature does
+- **Why**: Explain why this feature is needed
+- ❌ Do NOT include tech stack (covered in plan.md)
+
+### 3. Request User Approval
+
+> 🚨 **User Approval Required**
+
+Share full spec.md content with user and wait for **explicit approval (OK)**
+
+### 4. Create GitHub Issue
+
+→ See `skills/create-issue.md`
+
+### 5. Pre-Commit Checklist
+
+> ⚠️ **Before committing, verify:**
+
+- [ ] Issue number in spec.md (`- **Issue Number**: #{issue}`)
+- [ ] Issue number in tasks.md (`- **Issue**: #{issue}`)
+- [ ] Branch name in tasks.md (`feat/{issue-number}-{feature-name}`)
+
+---
+
+## Reference Documents
+
+- **Feature Template**: `features/feature-base/`
+- **Issue Creation Guide**: `skills/create-issue.md`