lee-spec-kit 0.1.8 → 0.2.0

package/dist/index.js

@@ -2,7 +2,7 @@
 import { program } from 'commander';
 import prompts from 'prompts';
 import chalk from 'chalk';
-import path3 from 'path';
+import path6 from 'path';
 import fs6 from 'fs-extra';
 import { glob } from 'glob';
 import { fileURLToPath } from 'url';
@@ -32,10 +32,10 @@ async function replaceInFiles(dir, replacements) {
   }
 }
 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(
       [
@@ -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 fs6.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,7 +254,7 @@ async function runInit(options) {
     lang,
     createdAt: (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
   };
-  const configPath = path3.join(targetDir, ".lee-spec-kit.json");
+  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();
@@ -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,12 +296,12 @@ 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");
+    const configPath = path6.join(docsDir, ".lee-spec-kit.json");
     if (await fs6.pathExists(configPath)) {
       try {
         const configFile = await fs6.readJson(configPath);
@@ -308,13 +314,13 @@ async function getConfig(cwd) {
       } catch {
       }
     }
-    const agentsPath = path3.join(docsDir, "agents");
-    const featuresPath = path3.join(docsDir, "features");
+    const agentsPath = path6.join(docsDir, "agents");
+    const featuresPath = path6.join(docsDir, "features");
     if (await fs6.pathExists(agentsPath) && await fs6.pathExists(featuresPath)) {
-      const bePath = path3.join(featuresPath, "be");
-      const fePath = path3.join(featuresPath, "fe");
+      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 = path3.join(agentsPath, "agents.md");
+      const agentsMdPath = path6.join(agentsPath, "agents.md");
       let lang = "ko";
       if (await fs6.pathExists(agentsMdPath)) {
         const content = await fs6.readFile(agentsMdPath, "utf-8");
@@ -386,17 +392,17 @@ 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);
+  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");
+  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);
@@ -432,12 +438,12 @@ 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);
   }
@@ -477,20 +483,20 @@ 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;
+    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");
+      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");
@@ -499,7 +505,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 = 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",
@@ -636,7 +642,7 @@ async function runUpdate(options) {
   }
   const { docsDir, projectType, lang } = config;
   const templatesDir = getTemplatesDir();
-  const sourceDir = path3.join(templatesDir, lang, projectType);
+  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..."));
@@ -646,22 +652,32 @@ async function runUpdate(options) {
   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 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(
-        sourceAgents,
+        commonAgents,
         targetAgents,
-        options.force
+        options.force,
+        replacements
       );
       updatedCount += count;
-      console.log(chalk.green(`  \u2705 ${count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC`));
     }
+    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 = path3.join(sourceDir, "features", "feature-base");
-    const targetFeatureBase = path3.join(docsDir, "features", "feature-base");
+    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,
@@ -675,19 +691,24 @@ async function runUpdate(options) {
   console.log();
   console.log(chalk.green(`\u2705 \uCD1D ${updatedCount}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!`));
 }
-async function updateFolder(sourceDir, targetDir, force) {
+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 = path3.join(sourceDir, file);
-    const targetPath = path3.join(targetDir, file);
+    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;
       }
-      const sourceContent = await fs6.readFile(sourcePath, "utf-8");
+      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");
@@ -707,7 +728,12 @@ async function updateFolder(sourceDir, targetDir, force) {
         updatedCount++;
       }
     } else if (stat.isDirectory()) {
-      const subCount = await updateFolder(sourcePath, targetPath, force);
+      const subCount = await updateFolder(
+        sourcePath,
+        targetPath,
+        force,
+        replacements
+      );
       updatedCount += subCount;
     }
   }

package/package.json

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

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,49 +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 Commit (docs repo)
-
-> 📌 The docs folder is managed as a separate git, so a separate commit strategy is used.
+> 📖 Refer to `skills/` folder for step-by-step guides.
 
-| #   | 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`  |
+| 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.**
-
-### 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`

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

@@ -0,0 +1,52 @@
+# GitHub Issue Creation Process
+
+Guide for creating GitHub Issues.
+
+---
+
+## Prerequisites
+
+- [ ] `spec.md` completed
+- [ ] User approval received
+
+---
+
+## Steps
+
+### 1. Prepare Issue Content
+
+> 📖 **Always refer to `issue-template.md`**
+
+| Item     | Format                                      |
+| -------- | ------------------------------------------- |
+| Title    | `F{number}: {feature-name} ({description})` |
+| Body     | Overview, Goals, Criteria, Related docs     |
+| Labels   | `enhancement`, `bug`, `documentation`, etc. |
+| Assignee | `@me` (default)                             |
+
+### 2. Request User Approval
+
+> 🚨 **User Approval Required**
+
+Before creating issue, share and wait for approval:
+
+- Title
+- Body
+- Labels
+
+### 3. Create Issue
+
+```bash
+gh issue create \
+  --title "F{number}: {feature-name} ({description})" \
+  --body-file /tmp/issue-body.md \
+  --assignee @me \
+  --label enhancement
+```
+
+---
+
+## Reference Documents
+
+- **Issue Template**: `issue-template.md`
+- **Link Format Rules**: `issue-template.md` > "Link Format" section

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

@@ -0,0 +1,97 @@
+# Pull Request Creation Process
+
+Guide for creating Pull Requests.
+
+---
+
+## Prerequisites
+
+- [ ] All tasks in `[DONE]` state
+- [ ] Changes committed
+- [ ] Branch pushed
+
+---
+
+## Steps
+
+### 1. Prepare PR Content
+
+> 📖 **Always refer to `pr-template.md`**
+
+| Item     | Format                             |
+| -------- | ---------------------------------- |
+| Title    | `feat(#{issue-number}): {feature}` |
+| Body     | Overview, Changes, Tests, Docs     |
+| Labels   | Appropriate labels                 |
+| Assignee | `@me` (default)                    |
+
+### 2. Test Verification
+
+> 🚨 **Cannot create PR if tests fail**
+
+1. Run related test commands (e.g., `npm test`, `pnpm test`)
+2. Check results (PASS/FAIL)
+3. Record **execution results** in PR body "Tests" section
+4. Check boxes **only for items that actually passed**
+
+### 3. Request User Approval
+
+> 🚨 **User Approval Required**
+
+Before creating PR, share and wait for approval:
+
+- Title
+- Body (including test results)
+- Labels
+
+### 4. Create PR
+
+```bash
+gh pr create \
+  --title "feat(#{issue-number}): {feature}" \
+  --body-file /tmp/pr-body.md \
+  --assignee @me \
+  --base main
+```
+
+---
+
+## Important Notes
+
+### Link Format
+
+Use **current branch name** for file links in PR body:
+
+```markdown
+[filename](https://github.com/{owner}/{repo}/blob/{branch-name}/path/to/file)
+```
+
+> ⚠️ `main` branch links will return 404 until merged!
+
+---
+
+## Code Review Modification Guidelines
+
+> 📋 **Criteria for deciding whether to add a task when modifications are needed from review feedback**
+
+### No task needed (Minor changes)
+
+- Typo/code style fixes
+- Variable/function name changes
+- Comment additions/modifications
+- Lint error fixes
+
+### Task needed (Major changes)
+
+- Logic/algorithm changes
+- New file/function additions
+- API signature changes
+- Test case additions
+- Requires changes to spec.md or plan.md
+
+---
+
+## Reference Documents
+
+- **PR Template**: `pr-template.md`
+- **Git Workflow**: `git-workflow.md`