lee-spec-kit 0.1.5 → 0.1.7

package/dist/index.js

@@ -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) {
@@ -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";

package/package.json

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

package/templates/en/fullstack/agents/agents.md

@@ -69,6 +69,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/git-workflow.md

@@ -73,14 +73,26 @@ main
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### 2. Auto Commit on Task Completion
+### 2. Document Writing and Commit
+
+| 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)           |
+
+> 📌 **Do not commit when creating Feature folder.**
+> Commit each document individually **after user approval**.
+
+### 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 +101,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

@@ -56,6 +56,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/git-workflow.md

@@ -80,7 +80,19 @@ 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 Writing and Commit
+
+| 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)           |
+
+> 📌 **Do not commit when creating Feature folder.**
+> Commit each document individually **after user approval**.
+
+### 3. Auto Commit on Task Completion
 
 When a task is completed:
 
@@ -91,7 +103,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 +114,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

@@ -92,6 +92,14 @@ docs/
 1. 분석 리포트 작성 (현재 상태, 문제점, 제안, 영향)
 2. 변경 필요시 새 기능/태스크 생성 권장
 
+### 5. 태스크 외 요청 처리
+
+> 사용자가 **tasks.md에 없는 작업**을 요청하면:
+
+1. 해당 작업을 **tasks.md에 반영할지** 사용자에게 확인
+2. 승인 시: tasks.md에 추가 후 실행
+3. 거부 시: 임시 작업으로 진행 (커밋에는 포함)
+
 ---
 
 ## 📋 ADR (Architecture Decision Records) 규칙

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

@@ -80,7 +80,19 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 태스크 완료 시 자동 커밋
+### 2. 문서 작성 및 커밋
+
+| 문서         | 커밋 시점          | 커밋 메시지 예시         |
+| ------------ | ------------------ | ------------------------ |
+| spec.md      | 사용자 승인 후     | `docs(#123): spec 작성`  |
+| plan.md      | 사용자 승인 후     | `docs(#123): plan 작성`  |
+| tasks.md     | 사용자 승인 후     | `docs(#123): tasks 분해` |
+| decisions.md | 태스크 커밋에 포함 | (별도 커밋 없음)         |
+
+> 📌 **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
+> 각 문서가 **사용자 승인**을 받은 후 개별 커밋합니다.
+
+### 3. 태스크 완료 시 자동 커밋
 
 태스크 하나가 완료되면:
 
@@ -91,7 +103,7 @@ git commit -m "{type}(#{issue}): {task-description}"
 
 > `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 3. Feature 완료 시 PR 생성
+### 4. Feature 완료 시 PR 생성
 
 모든 태스크 완료 시:
 
@@ -102,7 +114,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

@@ -69,6 +69,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/git-workflow.md

@@ -80,7 +80,19 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 2. 태스크 완료 시 자동 커밋
+### 2. 문서 작성 및 커밋
+
+| 문서         | 커밋 시점          | 커밋 메시지 예시         |
+| ------------ | ------------------ | ------------------------ |
+| spec.md      | 사용자 승인 후     | `docs(#123): spec 작성`  |
+| plan.md      | 사용자 승인 후     | `docs(#123): plan 작성`  |
+| tasks.md     | 사용자 승인 후     | `docs(#123): tasks 분해` |
+| decisions.md | 태스크 커밋에 포함 | (별도 커밋 없음)         |
+
+> 📌 **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
+> 각 문서가 **사용자 승인**을 받은 후 개별 커밋합니다.
+
+### 3. 태스크 완료 시 자동 커밋
 
 태스크 하나가 완료되면:
 
@@ -91,7 +103,7 @@ git commit -m "{type}(#{issue}): {task-description}"
 
 > `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
 
-### 3. Feature 완료 시 PR 생성
+### 4. Feature 완료 시 PR 생성
 
 모든 태스크 완료 시:
 
@@ -102,7 +114,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}}
+
 (이 기능이 왜 필요한지, 어떤 문제를 해결하는지)
 
 ---