lee-spec-kit 0.1.7 → 0.2.0

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`

package/templates/en/common/agents/skills/execute-task.md

@@ -0,0 +1,86 @@
+# Task Execution Process
+
+Guide for executing tasks from tasks.md.
+
+---
+
+## Steps
+
+### 1. Check Task
+
+- Find next task in `tasks.md`
+- Select task with `[TODO]` status
+- ⚠️ **Verify current branch matches Feature branch** (`feat/{issue-number}-{feature-name}`)
+
+### 2. Share Execution Plan
+
+> 🚨 **User Approval Required**
+
+Share execution plan with user before starting and wait for approval
+
+### 3. Update Status
+
+| Timing      | Status Transition    |
+| ----------- | -------------------- |
+| On start    | `[TODO]` → `[DOING]` |
+| On complete | `[DOING]` → `[DONE]` |
+
+Record date (YYYY-MM-DD) with each status change
+
+### 4. Commit After Task Completion
+
+> 🚨 **User Approval Required**
+
+Before committing, share and wait for approval:
+
+- Commit message
+- Files to be included
+
+```bash
+git add .
+git commit -m "{type}(#{issue-number}): {task description}"
+```
+
+---
+
+## Handling Requests Outside tasks.md
+
+When user requests work not in tasks.md:
+
+1. Ask if it 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)
+
+---
+
+## 🚨 Never Modify Completed Tasks
+
+> ⚠️ **Tasks in `[DONE]` status must NEVER be modified.**
+
+### Principle
+
+- Completed tasks are preserved for **history/record purposes**
+- If modifications are needed, **add a new task**
+
+### When Modifications Are Needed
+
+1. Keep the existing task as-is
+2. Add new task: `T{next-number}: {modification description}`
+3. Perform changes in the new task
+
+**Example:**
+
+```markdown
+## Tasks
+
+- [DONE] T001: Implement user authentication (2026-01-05)
+- [DONE] T002: Create login page (2026-01-06)
+- [TODO] T003: Fix T002 - Add password validation ← New task for modifications
+```
+
+---
+
+## Reference Documents
+
+- **Git Workflow**: `git-workflow.md`
+- **Commit Convention**: `git-workflow.md` > "Commit Convention" section

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`
@@ -47,35 +75,20 @@ docs/
 
 ## Request Type Processes
 
-### 1. New Feature Request
-
-1. Identify target repo (BE or FE)
-2. Create feature folder: `npx lee-spec-kit feature <name>`
-3. Write `spec.md` - what and why (no tech stack)
-4. Request spec review from user
-5. Create GitHub Issue
-
-### 2. Spec to Plan
-
-1. Verify spec is clear
-2. Write `plan.md` - tech stack, architecture, file structure
-3. **Record key decisions in `decisions.md`** (required)
-4. Decompose into tasks after user approval
-
-### 3. Task Execution
-
-1. Write tasks in `tasks.md`
-2. Execute after user approval
-3. Transition status: `[TODO]` → `[DOING]` → `[DONE]`
-4. Commit immediately after task completion
+> 📖 Refer to `skills/` folder for detailed process guides.
 
-### 4. Handling Requests Outside Tasks
+| Process        | Guide                      |
+| -------------- | -------------------------- |
+| New Feature    | `skills/create-feature.md` |
+| GitHub Issue   | `skills/create-issue.md`   |
+| Pull Request   | `skills/create-pr.md`      |
+| Task Execution | `skills/execute-task.md`   |
 
-> When user requests **work not in tasks.md**:
+### Additional Rules (Fullstack)
 
-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)
+- **Identify target repo**: Determine BE or FE before feature creation
+- **Write plan.md**: Tech stack and architecture decisions after spec approval
+- **Record in decisions.md**: Document all major technical decisions
 
 ---
 

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`
@@ -42,27 +70,14 @@ docs/
 
 ## Request Type Processes
 
-### 1. New Feature Request
-
-1. Create feature folder: `npx lee-spec-kit feature <name>`
-2. Write `spec.md` - what and why
-3. Request spec review
-4. Create GitHub Issue
-
-### 2. Task Execution
-
-1. Write tasks in `tasks.md`
-2. Execute after approval
-3. Status transition: `[TODO]` → `[DOING]` → `[DONE]`
-4. Commit on task completion
-
-### 3. Handling Requests Outside Tasks
-
-> When user requests **work not in tasks.md**:
+> 📖 Refer to `skills/` folder for detailed process guides.
 
-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)
+| Process        | Guide                      |
+| -------------- | -------------------------- |
+| New Feature    | `skills/create-feature.md` |
+| GitHub Issue   | `skills/create-issue.md`   |
+| Pull Request   | `skills/create-pr.md`      |
+| Task Execution | `skills/execute-task.md`   |
 
 ---
 

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

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

package/templates/ko/{single → common}/agents/git-workflow.md

@@ -70,90 +70,36 @@ main
 
 ## 자동화 워크플로우
 
-### 1. Feature 시작
+> 📖 단계별 상세 가이드는 `skills/` 폴더를 참조하세요.
 
-```bash
-# 1. GitHub Issue 생성 (Feature = Issue)
-# 2. 브랜치 생성
-git checkout -b feat/{issue-number}-{feature-name}
-```
-
-> `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
-
-### 2. 문서 작성 및 커밋
-
-| 문서         | 커밋 시점          | 커밋 메시지 예시         |
-| ------------ | ------------------ | ------------------------ |
-| spec.md      | 사용자 승인 후     | `docs(#123): spec 작성`  |
-| plan.md      | 사용자 승인 후     | `docs(#123): plan 작성`  |
-| tasks.md     | 사용자 승인 후     | `docs(#123): tasks 분해` |
-| decisions.md | 태스크 커밋에 포함 | (별도 커밋 없음)         |
-
-> 📌 **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
-> 각 문서가 **사용자 승인**을 받은 후 개별 커밋합니다.
-
-### 3. 태스크 완료 시 자동 커밋
-
-태스크 하나가 완료되면:
-
-```bash
-git add .
-git commit -m "{type}(#{issue}): {task-description}"
-```
-
-> `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
-
-### 4. Feature 완료 시 PR 생성
+| 워크플로우   | 가이드                     |
+| ------------ | -------------------------- |
+| Feature 시작 | `skills/create-feature.md` |
+| Issue 생성   | `skills/create-issue.md`   |
+| 태스크 실행  | `skills/execute-task.md`   |
+| PR 생성      | `skills/create-pr.md`      |
 
-모든 태스크 완료 시:
+### 브랜치 생성
 
 ```bash
-git push origin feat/{issue-number}-{feature-name}
-gh pr create --title "feat(#{issue}): {feature-title}" \
-  --body "Closes #{issue}" \
-  --base main
-```
-
-### 5. 머지
-
-모든 리뷰 해결 시:
-
-```bash
-# 머지 전 main 최신화
-git checkout main
-git pull
-
-# Squash and Merge
-gh pr merge --squash --delete-branch
-
-# 머지 후 main 최신화
-git pull
+git checkout -b feat/{issue-number}-{feature-name}
 ```
 
----
+### 문서 커밋 시점 (docs 레포)
 
-## 에이전트 자동화 규칙
+| 커밋 시점                              | 포함 내용                          | 커밋 메시지 예시                               |
+| -------------------------------------- | ---------------------------------- | ---------------------------------------------- |
+| 계획 완료 시 (spec+plan+tasks 승인 후) | `F{번호}-{기능명}/` 폴더 전체      | `docs(#{이슈번호}): F{번호} spec, plan, tasks` |
+| Feature 완료 시 (모든 태스크 완료 후)  | `F{번호}-{기능명}/` 폴더 변경 사항 | `docs(#{이슈번호}): F{번호} Feature 완료`      |
 
-### 태스크 완료 시
+> ⚠️ Feature 폴더 생성 시점에는 커밋하지 않습니다.
 
-```
-1. 코드 변경 완료
-2. tasks.md 상태 [DOING] → [DONE] 업데이트 (docs)
-3. git add .
-4. git commit -m "{type}(#{issue}): {description}"
-5. 다음 태스크 진행
-```
+### 머지 전략
 
-### Feature 완료 시
-
-```
-1. 모든 태스크 [DONE] 확인
-2. git push origin {branch}
-3. gh pr create
-4. 리뷰 대기
-5. 리뷰 코멘트 수정
-6. gh pr merge --squash
-```
+| 상황         | 머지 방식        |
+| ------------ | ---------------- |
+| 일반 Feature | Squash and Merge |
+| 긴급 Hotfix  | Squash and Merge |
 
 ---
 

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

@@ -36,12 +36,17 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
    [react-i18next](https://react.i18next.com/)
    ```
 
-3. **외부/로컬 문서** (docs 레포 등, URL 없음): **상대 경로 텍스트로만 표기**
-   ```text
-   ../docs/features/F001-feature-name/spec.md
+3. **로컬 문서** (docs 레포 등, URL 없음): **프로젝트 루트 기준 경로**
+
+   > 📁 로컬 문서는 **프로젝트 루트 기준** 경로로 작성합니다.
+   > 형식: `- **{레이블}**: \`{경로}\``
+
+   ```markdown
+   - **Spec**: `{{featurePath}}/F001-feature-name/spec.md`
+   - **Tasks**: `{{featurePath}}/F001-feature-name/tasks.md`
    ```
 
-> ⚠️ 로컬 문서는 GitHub에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
+> ⚠️ 로컬 문서는 GitHub에서 클릭되지 않으므로, 마크다운 링크 대신 **볼드 레이블 + 코드블록 경로** 형식을 사용합니다.
 
 ---
 
@@ -64,7 +69,7 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
 
 ## 관련 문서
 
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
+- **Spec**: `{{featurePath}}/F{번호}-{기능명}/spec.md`
 
 ## 라벨
 

package/templates/ko/{fullstack → common}/agents/pr-template.md

@@ -40,17 +40,24 @@ PR 본문에서 레포 내 파일 링크는 **반드시 현재 브랜치명을
 
 ## 테스트
 
+> ⚠️ **실제 테스트 실행 후 체크하세요. 미실행 항목은 체크하지 마세요.**
+
 - [ ] 유닛 테스트 통과
 - [ ] 통합 테스트 완료
 
+### 실행 결과
+
+- 명령어: `{실행한 테스트 명령어}`
+- 결과: `{PASS/FAIL 요약}`
+
 ## 스크린샷 (UI 변경 시)
 
 {있으면 첨부}
 
 ## 관련 문서
 
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
-- Tasks: `docs/features/{be|fe}/F{번호}-{기능명}/tasks.md`
+- **Spec**: `{{featurePath}}/F{번호}-{기능명}/spec.md`
+- **Tasks**: `{{featurePath}}/F{번호}-{기능명}/tasks.md`
 
 Closes #{이슈번호}
 ```

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

@@ -0,0 +1,53 @@
+# 새 기능 추가 프로세스
+
+새 기능(Feature)을 추가할 때 따르는 단계별 가이드입니다.
+
+---
+
+## 단계
+
+### 1. Feature 폴더 생성
+
+```bash
+npx lee-spec-kit feature <name> -d "<설명>"
+```
+
+- `<name>`: 기능 이름 (영문, 하이픈 사용)
+- `-d`: 기능 설명 (spec.md에 자동 반영)
+
+**예시:**
+
+```bash
+npx lee-spec-kit feature user-auth -d "사용자 인증 및 세션 관리"
+```
+
+### 2. spec.md 작성
+
+- **무엇을**: 기능이 무엇인지 명확히 기술
+- **왜**: 이 기능이 필요한 이유
+- ❌ 기술 스택은 작성하지 않음 (plan.md에서 다룸)
+
+### 3. 사용자 확인 요청
+
+> 🚨 **사용자 확인 필수**
+
+spec.md 전문을 사용자에게 공유하고 **명시적 승인(OK)** 대기
+
+### 4. GitHub Issue 생성
+
+→ `skills/create-issue.md` 참조
+
+### 5. 문서 커밋 전 확인
+
+> ⚠️ **커밋 전 체크리스트**
+
+- [ ] spec.md에 이슈번호 반영 (`- **이슈 번호**: #{이슈번호}`)
+- [ ] tasks.md에 이슈번호 반영 (`- **Issue**: #{이슈번호}`)
+- [ ] tasks.md에 브랜치명 반영 (`feat/{이슈번호}-{기능명}`)
+
+---
+
+## 참조 문서
+
+- **Feature 템플릿**: `features/feature-base/`
+- **Issue 생성 가이드**: `skills/create-issue.md`