lee-spec-kit 0.1.7 → 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";
         }
@@ -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 = {
@@ -442,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+)-/);
@@ -483,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}}");
@@ -584,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`));
   }
 }
@@ -611,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(
@@ -619,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.7",
+  "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`

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,17 +73,16 @@ main
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### 2. Document Writing and Commit
+### 2. Document Commit (docs repo)
 
-| 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)           |
+> 📌 The docs folder is managed as a separate git, so a separate commit strategy is used.
 
-> 📌 **Do not commit when creating Feature folder.**
-> Commit each document individually **after user approval**.
+| #   | 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
 

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`

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,17 +80,16 @@ 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. Document Writing and Commit
+### 2. Document Commit (docs repo)
 
-| 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)           |
+> 📌 The docs folder is managed as a separate git, so a separate commit strategy is used.
 
-> 📌 **Do not commit when creating Feature folder.**
-> Commit each document individually **after user approval**.
+| #   | 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
 

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`

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,17 +80,16 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 문서 작성 및 커밋
+### 2. 문서 커밋 (docs 레포)
 
-| 문서         | 커밋 시점          | 커밋 메시지 예시         |
-| ------------ | ------------------ | ------------------------ |
-| spec.md      | 사용자 승인 후     | `docs(#123): spec 작성`  |
-| plan.md      | 사용자 승인 후     | `docs(#123): plan 작성`  |
-| tasks.md     | 사용자 승인 후     | `docs(#123): tasks 분해` |
-| decisions.md | 태스크 커밋에 포함 | (별도 커밋 없음)         |
+> 📌 docs 폴더는 별도 git으로 관리되므로 프로젝트와 분리된 커밋 전략을 사용합니다.
 
-> 📌 **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
-> 각 문서가 **사용자 승인**을 받은 후 개별 커밋합니다.
+| #   | 커밋 시점                                  | 포함 문서                     | 커밋 메시지 예시                     |
+| --- | ------------------------------------------ | ----------------------------- | ------------------------------------ |
+| 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. 태스크 완료 시 자동 커밋
 

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`

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,17 +80,16 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 문서 작성 및 커밋
+### 2. 문서 커밋 (docs 레포)
 
-| 문서         | 커밋 시점          | 커밋 메시지 예시         |
-| ------------ | ------------------ | ------------------------ |
-| spec.md      | 사용자 승인 후     | `docs(#123): spec 작성`  |
-| plan.md      | 사용자 승인 후     | `docs(#123): plan 작성`  |
-| tasks.md     | 사용자 승인 후     | `docs(#123): tasks 분해` |
-| decisions.md | 태스크 커밋에 포함 | (별도 커밋 없음)         |
+> 📌 docs 폴더는 별도 git으로 관리되므로 프로젝트와 분리된 커밋 전략을 사용합니다.
 
-> 📌 **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
-> 각 문서가 **사용자 승인**을 받은 후 개별 커밋합니다.
+| #   | 커밋 시점                                  | 포함 문서                     | 커밋 메시지 예시                     |
+| --- | ------------------------------------------ | ----------------------------- | ------------------------------------ |
+| 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. 태스크 완료 시 자동 커밋