lee-spec-kit 0.1.5 → 0.1.8

package/dist/index.js

@@ -3,12 +3,12 @@ import { program } from 'commander';
 import prompts from 'prompts';
 import chalk from 'chalk';
 import path3 from 'path';
-import fs3 from 'fs-extra';
+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,19 +16,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 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);
@@ -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",
@@ -233,7 +233,7 @@ async function runInit(options) {
   console.log();
   const templatesDir = getTemplatesDir();
   const templatePath = path3.join(templatesDir, lang, projectType);
-  if (!await fs3.pathExists(templatePath)) {
+  if (!await fs6.pathExists(templatePath)) {
     throw new Error(`\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${templatePath}`);
   }
   await copyTemplates(templatePath, targetDir);
@@ -249,7 +249,7 @@ async function runInit(options) {
     createdAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
   };
   const configPath = path3.join(targetDir, ".lee-spec-kit.json");
-  await fs3.writeJson(configPath, config, { spaces: 2 });
+  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);
@@ -296,9 +296,9 @@ async function getConfig(cwd) {
   ];
   for (const docsDir of possibleDirs) {
     const configPath = path3.join(docsDir, ".lee-spec-kit.json");
-    if (await fs3.pathExists(configPath)) {
+    if (await fs6.pathExists(configPath)) {
       try {
-        const configFile = await fs3.readJson(configPath);
+        const configFile = await fs6.readJson(configPath);
         return {
           docsDir,
           projectName: configFile.projectName,
@@ -310,14 +310,14 @@ async function getConfig(cwd) {
     }
     const agentsPath = path3.join(docsDir, "agents");
     const featuresPath = path3.join(docsDir, "features");
-    if (await fs3.pathExists(agentsPath) && await fs3.pathExists(featuresPath)) {
+    if (await fs6.pathExists(agentsPath) && await fs6.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 projectType = await fs6.pathExists(bePath) || await fs6.pathExists(fePath) ? "fullstack" : "single";
       const agentsMdPath = path3.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";
         }
@@ -330,7 +330,7 @@ async function getConfig(cwd) {
 
 // src/commands/feature.ts
 function featureCommand(program2) {
-  program2.command("feature <name>").description("Create a new feature folder").option("-r, --repo <repo>", "Repository type: be | fe (fullstack only)").option("--id <id>", "Feature ID (default: auto)").action(async (name, options) => {
+  program2.command("feature <name>").description("Create a new feature folder").option("-r, --repo <repo>", "Repository type: be | fe (fullstack only)").option("--id <id>", "Feature ID (default: auto)").option("-d, --desc <description>", "Feature description for spec.md").action(async (name, options) => {
     try {
       await runFeature(name, options);
     } catch (error) {
@@ -392,16 +392,16 @@ async function runFeature(name, options) {
   }
   const featureFolderName = `${featureId}-${name}`;
   const featureDir = path3.join(featuresDir, featureFolderName);
-  if (await fs3.pathExists(featureDir)) {
+  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)) {
+  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 = {
@@ -410,7 +410,8 @@ async function runFeature(name, options) {
     "YYYY-MM-DD": (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
     "{be|fe}": repo || "",
     "git-dungeon-{be|fe}": repoName,
-    "{\uC774\uC288\uBC88\uD638}": ""
+    "{\uC774\uC288\uBC88\uD638}": "",
+    "{{description}}": options.desc || ""
   };
   if (lang === "en") {
     replacements["\uAE30\uB2A5 ID"] = "Feature ID";
@@ -441,8 +442,8 @@ async function getNextFeatureId(docsDir, projectType) {
     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+)-/);
@@ -482,18 +483,18 @@ async function runStatus(options) {
   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 });
+    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");
+      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}}");
@@ -583,7 +584,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`));
   }
 }
@@ -610,6 +611,108 @@ 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 = path3.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 sourceAgents = path3.join(sourceDir, "agents");
+    const targetAgents = path3.join(docsDir, "agents");
+    if (await fs6.pathExists(sourceAgents)) {
+      const count = await updateFolder(
+        sourceAgents,
+        targetAgents,
+        options.force
+      );
+      updatedCount += count;
+      console.log(chalk.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \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 = path3.join(sourceDir, "features", "feature-base");
+    const targetFeatureBase = path3.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) {
+  await fs6.ensureDir(targetDir);
+  const files = await fs6.readdir(sourceDir);
+  let updatedCount = 0;
+  for (const file of files) {
+    const sourcePath = path3.join(sourceDir, file);
+    const targetPath = path3.join(targetDir, file);
+    const stat = await fs6.stat(sourcePath);
+    if (stat.isFile()) {
+      if (file === "custom.md") {
+        continue;
+      }
+      const sourceContent = await fs6.readFile(sourcePath, "utf-8");
+      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);
+      updatedCount += subCount;
+    }
+  }
+  return updatedCount;
+}
 
 // src/index.ts
 program.name("lee-spec-kit").description(
@@ -618,4 +721,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.5",
+  "version": "0.1.8",
   "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/fullstack/agents/agents.md

@@ -4,10 +4,38 @@ Operating rules for AI code assistants to perform consistent code generation and
 
 ---
 
+## 🚨 User Approval Required (MUST)
+
+> ⚠️ **The following actions require explicit user approval (OK) before proceeding.**
+> **If approval is not given, stop immediately and request confirmation.**
+
+| Action                | When to Confirm          | What to Share             |
+| --------------------- | ------------------------ | ------------------------- |
+| Spec Writing          | After writing `spec.md`  | Full spec content         |
+| Task Execution        | Before each task         | Execution plan            |
+| Commit Creation       | Before `git commit`      | Commit message, file list |
+| Issue Creation        | Before `gh issue create` | Title, body, labels       |
+| PR Creation           | Before `gh pr create`    | Title, body, labels       |
+| Assignee Change       | When assigning others    | Target username           |
+| Remote Git Operations | Before `push`, `merge`   | Branch, changes           |
+
+### Approval Process
+
+1. **Share** action details with user first
+2. **Wait** for explicit user approval (OK)
+3. **Execute** only after approval
+
+> 🚫 **Prohibited**: Proceeding without user response
+
+---
+
 ## Reference Documents
 
 ### Core Documents
 
+> ⚠️ **Rules in `custom.md` take precedence over all other rules.**
+
+- **🔴 Custom Rules (Highest Priority)**: `/docs/agents/custom.md`
 - **Project Principles**: `/docs/agents/constitution.md`
 - **Git Workflow**: `/docs/agents/git-workflow.md`
 - **Issue Template**: `/docs/agents/issue-template.md`
@@ -69,6 +97,14 @@ docs/
 3. Transition status: `[TODO]` → `[DOING]` → `[DONE]`
 4. Commit immediately after task completion
 
+### 4. Handling Requests Outside Tasks
+
+> When user requests **work not in tasks.md**:
+
+1. Ask user if this should be **added to tasks.md**
+2. If approved: Add to tasks.md then execute
+3. If declined: Proceed as temporary work (still included in commit)
+
 ---
 
 ## 📋 ADR (Architecture Decision Records)

package/templates/en/fullstack/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/agents/git-workflow.md

@@ -73,14 +73,25 @@ main
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### 2. Auto Commit on Task Completion
+### 2. Document Commit (docs repo)
+
+> 📌 The docs folder is managed as a separate git, so a separate commit strategy is used.
+
+| #   | Commit Timing                                            | Included Documents              | Commit Message Example          |
+| --- | -------------------------------------------------------- | ------------------------------- | ------------------------------- |
+| 1   | **When planning is complete** (spec+plan+tasks approved) | spec.md, plan.md, tasks.md      | `docs(#123): spec, plan, tasks` |
+| 2   | **When Feature is complete** (all tasks done)            | tasks.md (status), decisions.md | `docs(#123): Feature complete`  |
+
+> ⚠️ **Do not commit when creating Feature folder.**
+
+### 3. Auto Commit on Task Completion
 
 ```bash
 git add .
 git commit -m "{type}(#{issue}): {task-description}"
 ```
 
-### 3. Create PR on Feature Completion
+### 4. Create PR on Feature Completion
 
 ```bash
 git push origin feat/{issue-number}-{feature-name}
@@ -89,7 +100,7 @@ gh pr create --title "feat(#{issue}): {feature-title}" \
   --base main
 ```
 
-### 4. Merge
+### 5. Merge
 
 ```bash
 git checkout main

package/templates/en/fullstack/agents/issue-template.md

@@ -82,6 +82,24 @@ In GitHub Issues, use different link formats **based on file location**:
 | `frontend`      | FE related    |
 | `priority:high` | High priority |
 
+> ⚠️ If a label does not exist, create it first:
+>
+> ```bash
+> gh label create "label-name" --description "description" --color "color-code"
+> ```
+
+---
+
+## Assignee Rules
+
+- Default: Self-assign (`--assignee @me`)
+- When assigning others, **confirm with user** first
+- Examples:
+  ```bash
+  gh issue create --assignee @me ...
+  gh issue create --assignee username ...
+  ```
+
 ---
 
 ## Body Input Rules (Shell Execution Prevention)

package/templates/en/fullstack/agents/pr-template.md

@@ -67,6 +67,27 @@ Closes #{issue-number}
 
 ---
 
+## Label Rules
+
+- Specify appropriate labels when creating PR (`--label`)
+- If a label does not exist, create it first:
+  ```bash
+  gh label create "label-name" --description "description" --color "color-code"
+  ```
+
+---
+
+## Assignee Rules
+
+- Default: Self-assign (`--assignee @me`)
+- Use `--reviewer` option to specify reviewers
+- Examples:
+  ```bash
+  gh pr create --assignee @me --reviewer reviewer-username ...
+  ```
+
+---
+
 ## Body Input Rules (Shell Execution Prevention)
 
 - PR body should use **`--body-file` by default**.

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

@@ -17,6 +17,8 @@
 
 ## Purpose
 
+{{description}}
+
 (Why is this feature needed? What problem does it solve?)
 
 ---

package/templates/en/single/agents/agents.md

@@ -4,10 +4,38 @@ Operating rules for AI code assistants to perform consistent code generation and
 
 ---
 
+## 🚨 User Approval Required (MUST)
+
+> ⚠️ **The following actions require explicit user approval (OK) before proceeding.**
+> **If approval is not given, stop immediately and request confirmation.**
+
+| Action                | When to Confirm          | What to Share             |
+| --------------------- | ------------------------ | ------------------------- |
+| Spec Writing          | After writing `spec.md`  | Full spec content         |
+| Task Execution        | Before each task         | Execution plan            |
+| Commit Creation       | Before `git commit`      | Commit message, file list |
+| Issue Creation        | Before `gh issue create` | Title, body, labels       |
+| PR Creation           | Before `gh pr create`    | Title, body, labels       |
+| Assignee Change       | When assigning others    | Target username           |
+| Remote Git Operations | Before `push`, `merge`   | Branch, changes           |
+
+### Approval Process
+
+1. **Share** action details with user first
+2. **Wait** for explicit user approval (OK)
+3. **Execute** only after approval
+
+> 🚫 **Prohibited**: Proceeding without user response
+
+---
+
 ## Reference Documents
 
 ### Core Documents
 
+> ⚠️ **Rules in `custom.md` take precedence over all other rules.**
+
+- **🔴 Custom Rules (Highest Priority)**: `/docs/agents/custom.md`
 - **Project Principles**: `/docs/agents/constitution.md`
 - **Git Workflow**: `/docs/agents/git-workflow.md`
 - **Issue Template**: `/docs/agents/issue-template.md`
@@ -56,6 +84,14 @@ docs/
 3. Status transition: `[TODO]` → `[DOING]` → `[DONE]`
 4. Commit on task completion
 
+### 3. Handling Requests Outside Tasks
+
+> When user requests **work not in tasks.md**:
+
+1. Ask user if this should be **added to tasks.md**
+2. If approved: Add to tasks.md then execute
+3. If declined: Proceed as temporary work (still included in commit)
+
 ---
 
 ## 📋 ADR (Architecture Decision Records)

package/templates/en/single/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/single/agents/git-workflow.md

@@ -80,7 +80,18 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > When creating/modifying issues/PRs with `gh`, share the title/body/labels first and **wait for user confirmation (OK)** before proceeding.
 
-### 2. Auto Commit on Task Completion
+### 2. Document Commit (docs repo)
+
+> 📌 The docs folder is managed as a separate git, so a separate commit strategy is used.
+
+| #   | Commit Timing                                            | Included Documents              | Commit Message Example          |
+| --- | -------------------------------------------------------- | ------------------------------- | ------------------------------- |
+| 1   | **When planning is complete** (spec+plan+tasks approved) | spec.md, plan.md, tasks.md      | `docs(#123): spec, plan, tasks` |
+| 2   | **When Feature is complete** (all tasks done)            | tasks.md (status), decisions.md | `docs(#123): Feature complete`  |
+
+> ⚠️ **Do not commit when creating Feature folder.**
+
+### 3. Auto Commit on Task Completion
 
 When a task is completed:
 
@@ -91,7 +102,7 @@ git commit -m "{type}(#{issue}): {task-description}"
 
 > Before running `git commit`, share the commit message and file list first and **wait for user confirmation (OK)** before proceeding.
 
-### 3. Create PR on Feature Completion
+### 4. Create PR on Feature Completion
 
 When all tasks are completed:
 
@@ -102,7 +113,7 @@ gh pr create --title "feat(#{issue}): {feature-title}" \
   --base main
 ```
 
-### 4. Merge
+### 5. Merge
 
 When all reviews are resolved:
 

package/templates/en/single/agents/issue-template.md

@@ -86,6 +86,24 @@ In GitHub Issues, use different link formats **based on file location**:
 | `frontend`      | FE related    |
 | `priority:high` | High priority |
 
+> ⚠️ If a label does not exist, create it first:
+>
+> ```bash
+> gh label create "label-name" --description "description" --color "color-code"
+> ```
+
+---
+
+## Assignee Rules
+
+- Default: Self-assign (`--assignee @me`)
+- When assigning others, **confirm with user** first
+- Examples:
+  ```bash
+  gh issue create --assignee @me ...
+  gh issue create --assignee username ...
+  ```
+
 ---
 
 ## Body Input Rules (Shell Execution Prevention)
@@ -94,3 +112,5 @@ In GitHub Issues, use different link formats **based on file location**:
 - If the body contains backticks (`) or `$()`and is placed directly in`"..."`, it may be **interpreted by the shell**.
 - For multi-line bodies, use **single-quoted heredoc** like `cat <<'EOF'`,
   and handle variables via **placeholder → sed substitution**.
+
+  and handle variables via **placeholder → sed substitution**.

package/templates/en/single/agents/pr-template.md

@@ -83,6 +83,27 @@ gh pr create \
 
 ---
 
+## Label Rules
+
+- Specify appropriate labels when creating PR (`--label`)
+- If a label does not exist, create it first:
+  ```bash
+  gh label create "label-name" --description "description" --color "color-code"
+  ```
+
+---
+
+## Assignee Rules
+
+- Default: Self-assign (`--assignee @me`)
+- Use `--reviewer` option to specify reviewers
+- Examples:
+  ```bash
+  gh pr create --assignee @me --reviewer reviewer-username ...
+  ```
+
+---
+
 ## Body Input Rules (Shell Execution Prevention)
 
 - PR body should use **`--body-file` by default**.

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

@@ -17,6 +17,8 @@
 
 ## Purpose
 
+{{description}}
+
 (Why is this feature needed? What problem does it solve?)
 
 ---

package/templates/ko/fullstack/agents/agents.md

@@ -4,10 +4,38 @@
 
 ---
 
+## 🚨 사용자 확인 필수 규칙 (MUST)
+
+> ⚠️ **아래 작업은 반드시 사용자의 명시적 승인(OK)을 받은 후에만 진행합니다.**
+> **확인 없이 진행 시 작업을 즉시 중단해야 합니다.**
+
+| 작업          | 확인 시점            | 공유 내용                   |
+| ------------- | -------------------- | --------------------------- |
+| 스펙 작성     | `spec.md` 작성 후    | 스펙 내용 전문              |
+| 태스크 실행   | 각 태스크 시작 전    | 실행 계획                   |
+| 커밋 생성     | `git commit` 전      | 커밋 메시지, 포함 파일 목록 |
+| 이슈 생성     | `gh issue create` 전 | 제목, 본문, 라벨            |
+| PR 생성       | `gh pr create` 전    | 제목, 본문, 라벨            |
+| Assignee 변경 | 본인 외 지정 시      | 대상 사용자명               |
+| Git 원격 작업 | `push`, `merge` 전   | 브랜치, 변경 사항           |
+
+### 확인 프로세스
+
+1. 작업 내용을 사용자에게 **먼저 공유**
+2. 사용자의 **명시적 승인(OK)** 대기
+3. 승인 후에만 실행
+
+> 🚫 **금지 사항**: 사용자 응답 없이 임의로 진행하는 것
+
+---
+
 ## 참조 문서
 
 ### 핵심 문서
 
+> ⚠️ **`custom.md`의 규칙은 다른 모든 규칙보다 우선합니다.**
+
+- **🔴 커스텀 규칙 (최우선)**: `/docs/agents/custom.md`
 - **프로젝트 원칙**: `/docs/agents/constitution.md`
 - **Git 워크플로우**: `/docs/agents/git-workflow.md`
 - **이슈 템플릿**: `/docs/agents/issue-template.md`
@@ -92,6 +120,14 @@ docs/
 1. 분석 리포트 작성 (현재 상태, 문제점, 제안, 영향)
 2. 변경 필요시 새 기능/태스크 생성 권장
 
+### 5. 태스크 외 요청 처리
+
+> 사용자가 **tasks.md에 없는 작업**을 요청하면:
+
+1. 해당 작업을 **tasks.md에 반영할지** 사용자에게 확인
+2. 승인 시: tasks.md에 추가 후 실행
+3. 거부 시: 임시 작업으로 진행 (커밋에는 포함)
+
 ---
 
 ## 📋 ADR (Architecture Decision Records) 규칙

package/templates/ko/fullstack/agents/custom.md

@@ -0,0 +1,29 @@
+# Custom Rules
+
+> ⚠️ 이 문서는 **사용자 정의 규칙**입니다.
+> `npx lee-spec-kit update`의 영향을 받지 않습니다.
+> **이 문서의 규칙은 다른 모든 agents 규칙보다 우선합니다.**
+
+---
+
+## 프로젝트 특화 규칙
+
+(여기에 프로젝트만의 규칙을 작성하세요)
+
+---
+
+## 추가 언어/코드 규칙
+
+(기본 규칙을 오버라이드하거나 추가 규칙을 작성하세요)
+
+---
+
+## 커스텀 워크플로우
+
+(프로젝트만의 워크플로우가 있다면 작성하세요)
+
+---
+
+## 기타
+
+(기타 규칙을 작성하세요)

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

@@ -80,7 +80,18 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 태스크 완료 시 자동 커밋
+### 2. 문서 커밋 (docs 레포)
+
+> 📌 docs 폴더는 별도 git으로 관리되므로 프로젝트와 분리된 커밋 전략을 사용합니다.
+
+| #   | 커밋 시점                                  | 포함 문서                     | 커밋 메시지 예시                     |
+| --- | ------------------------------------------ | ----------------------------- | ------------------------------------ |
+| 1   | **계획 완료 시** (spec+plan+tasks 승인 후) | spec.md, plan.md, tasks.md    | `docs(#123): spec, plan, tasks 작성` |
+| 2   | **Feature 완료 시** (모든 태스크 완료 후)  | tasks.md (상태), decisions.md | `docs(#123): Feature 완료`           |
+
+> ⚠️ **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
+
+### 3. 태스크 완료 시 자동 커밋
 
 태스크 하나가 완료되면:
 
@@ -91,7 +102,7 @@ git commit -m "{type}(#{issue}): {task-description}"
 
 > `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 3. Feature 완료 시 PR 생성
+### 4. Feature 완료 시 PR 생성
 
 모든 태스크 완료 시:
 
@@ -102,7 +113,7 @@ gh pr create --title "feat(#{issue}): {feature-title}" \
   --base main
 ```
 
-### 4. 머지
+### 5. 머지
 
 모든 리뷰 해결 시:
 

package/templates/ko/fullstack/agents/issue-template.md

@@ -86,6 +86,24 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
 | `frontend`      | FE 관련       |
 | `priority:high` | 높은 우선순위 |
 
+> ⚠️ 라벨이 존재하지 않으면 먼저 생성합니다:
+>
+> ```bash
+> gh label create "라벨명" --description "설명" --color "색상코드"
+> ```
+
+---
+
+## Assignee 규칙
+
+- 기본값: 본인 할당 (`--assignee @me`)
+- 다른 담당자 지정 시 **사용자에게 확인** 후 진행
+- 예시:
+  ```bash
+  gh issue create --assignee @me ...
+  gh issue create --assignee username ...
+  ```
+
 ---
 
 ## 본문 입력 규칙 (셸 실행 방지)

package/templates/ko/fullstack/agents/pr-template.md

@@ -81,6 +81,27 @@ gh pr create \
 
 ---
 
+## 라벨 규칙
+
+- PR 생성 시 적절한 라벨 지정 (`--label`)
+- 라벨이 존재하지 않으면 먼저 생성:
+  ```bash
+  gh label create "라벨명" --description "설명" --color "색상코드"
+  ```
+
+---
+
+## Assignee 규칙
+
+- 기본값: 본인 할당 (`--assignee @me`)
+- 리뷰어 지정 시 `--reviewer` 옵션 사용
+- 예시:
+  ```bash
+  gh pr create --assignee @me --reviewer reviewer-username ...
+  ```
+
+---
+
 ## 본문 입력 규칙 (셸 실행 방지)
 
 - PR 본문은 **`--body-file` 사용을 기본**으로 한다.

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

@@ -17,6 +17,8 @@
 
 ## 목적
 
+{{description}}
+
 (이 기능이 왜 필요한지, 어떤 문제를 해결하는지)
 
 ---

package/templates/ko/single/agents/agents.md

@@ -4,10 +4,38 @@
 
 ---
 
+## 🚨 사용자 확인 필수 규칙 (MUST)
+
+> ⚠️ **아래 작업은 반드시 사용자의 명시적 승인(OK)을 받은 후에만 진행합니다.**
+> **확인 없이 진행 시 작업을 즉시 중단해야 합니다.**
+
+| 작업          | 확인 시점            | 공유 내용                   |
+| ------------- | -------------------- | --------------------------- |
+| 스펙 작성     | `spec.md` 작성 후    | 스펙 내용 전문              |
+| 태스크 실행   | 각 태스크 시작 전    | 실행 계획                   |
+| 커밋 생성     | `git commit` 전      | 커밋 메시지, 포함 파일 목록 |
+| 이슈 생성     | `gh issue create` 전 | 제목, 본문, 라벨            |
+| PR 생성       | `gh pr create` 전    | 제목, 본문, 라벨            |
+| Assignee 변경 | 본인 외 지정 시      | 대상 사용자명               |
+| Git 원격 작업 | `push`, `merge` 전   | 브랜치, 변경 사항           |
+
+### 확인 프로세스
+
+1. 작업 내용을 사용자에게 **먼저 공유**
+2. 사용자의 **명시적 승인(OK)** 대기
+3. 승인 후에만 실행
+
+> 🚫 **금지 사항**: 사용자 응답 없이 임의로 진행하는 것
+
+---
+
 ## 참조 문서
 
 ### 핵심 문서
 
+> ⚠️ **`custom.md`의 규칙은 다른 모든 규칙보다 우선합니다.**
+
+- **🔴 커스텀 규칙 (최우선)**: `/docs/agents/custom.md`
 - **프로젝트 원칙**: `/docs/agents/constitution.md`
 - **Git 워크플로우**: `/docs/agents/git-workflow.md`
 - **이슈 템플릿**: `/docs/agents/issue-template.md`
@@ -69,6 +97,14 @@ docs/
 3. 상태 전환: `[TODO]` → `[DOING]` → `[DONE]`
 4. 태스크 완료 직후 커밋
 
+### 3. 태스크 외 요청 처리
+
+> 사용자가 **tasks.md에 없는 작업**을 요청하면:
+
+1. 해당 작업을 **tasks.md에 반영할지** 사용자에게 확인
+2. 승인 시: tasks.md에 추가 후 실행
+3. 거부 시: 임시 작업으로 진행 (커밋에는 포함)
+
 ---
 
 ## 📋 ADR (Architecture Decision Records) 규칙

package/templates/ko/single/agents/custom.md

@@ -0,0 +1,29 @@
+# Custom Rules
+
+> ⚠️ 이 문서는 **사용자 정의 규칙**입니다.
+> `npx lee-spec-kit update`의 영향을 받지 않습니다.
+> **이 문서의 규칙은 다른 모든 agents 규칙보다 우선합니다.**
+
+---
+
+## 프로젝트 특화 규칙
+
+(여기에 프로젝트만의 규칙을 작성하세요)
+
+---
+
+## 추가 언어/코드 규칙
+
+(기본 규칙을 오버라이드하거나 추가 규칙을 작성하세요)
+
+---
+
+## 커스텀 워크플로우
+
+(프로젝트만의 워크플로우가 있다면 작성하세요)
+
+---
+
+## 기타
+
+(기타 규칙을 작성하세요)

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

@@ -80,7 +80,18 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 태스크 완료 시 자동 커밋
+### 2. 문서 커밋 (docs 레포)
+
+> 📌 docs 폴더는 별도 git으로 관리되므로 프로젝트와 분리된 커밋 전략을 사용합니다.
+
+| #   | 커밋 시점                                  | 포함 문서                     | 커밋 메시지 예시                     |
+| --- | ------------------------------------------ | ----------------------------- | ------------------------------------ |
+| 1   | **계획 완료 시** (spec+plan+tasks 승인 후) | spec.md, plan.md, tasks.md    | `docs(#123): spec, plan, tasks 작성` |
+| 2   | **Feature 완료 시** (모든 태스크 완료 후)  | tasks.md (상태), decisions.md | `docs(#123): Feature 완료`           |
+
+> ⚠️ **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
+
+### 3. 태스크 완료 시 자동 커밋
 
 태스크 하나가 완료되면:
 
@@ -91,7 +102,7 @@ git commit -m "{type}(#{issue}): {task-description}"
 
 > `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 3. Feature 완료 시 PR 생성
+### 4. Feature 완료 시 PR 생성
 
 모든 태스크 완료 시:
 
@@ -102,7 +113,7 @@ gh pr create --title "feat(#{issue}): {feature-title}" \
   --base main
 ```
 
-### 4. 머지
+### 5. 머지
 
 모든 리뷰 해결 시:
 

package/templates/ko/single/agents/issue-template.md

@@ -86,6 +86,24 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
 | `frontend`      | FE 관련       |
 | `priority:high` | 높은 우선순위 |
 
+> ⚠️ 라벨이 존재하지 않으면 먼저 생성합니다:
+>
+> ```bash
+> gh label create "라벨명" --description "설명" --color "색상코드"
+> ```
+
+---
+
+## Assignee 규칙
+
+- 기본값: 본인 할당 (`--assignee @me`)
+- 다른 담당자 지정 시 **사용자에게 확인** 후 진행
+- 예시:
+  ```bash
+  gh issue create --assignee @me ...
+  gh issue create --assignee username ...
+  ```
+
 ---
 
 ## 본문 입력 규칙 (셸 실행 방지)

package/templates/ko/single/agents/pr-template.md

@@ -81,6 +81,27 @@ gh pr create \
 
 ---
 
+## 라벨 규칙
+
+- PR 생성 시 적절한 라벨 지정 (`--label`)
+- 라벨이 존재하지 않으면 먼저 생성:
+  ```bash
+  gh label create "라벨명" --description "설명" --color "색상코드"
+  ```
+
+---
+
+## Assignee 규칙
+
+- 기본값: 본인 할당 (`--assignee @me`)
+- 리뷰어 지정 시 `--reviewer` 옵션 사용
+- 예시:
+  ```bash
+  gh pr create --assignee @me --reviewer reviewer-username ...
+  ```
+
+---
+
 ## 본문 입력 규칙 (셸 실행 방지)
 
 - PR 본문은 **`--body-file` 사용을 기본**으로 한다.

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

@@ -17,6 +17,8 @@
 
 ## 목적
 
+{{description}}
+
 (이 기능이 왜 필요한지, 어떤 문제를 해결하는지)
 
 ---