lee-spec-kit 0.2.1 → 0.2.3

package/package.json

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

package/templates/en/common/agents/constitution.md

@@ -1,7 +1,9 @@
 # {{projectName}} Constitution
 
-Core principles and technical decision guidelines for the project.
-All development decisions should be based on this document.
+> ⚠️ **Replace `{{projectName}}` and `{{date}}` with actual project name and date.**
+
+Core principles and technical decision guidelines for this project.
+All development decisions are based on this document.
 
 > **📌 Document Scope**
 >

package/templates/en/common/agents/git-workflow.md

@@ -85,21 +85,29 @@ main
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### Document Commit Timing (docs repo)
+### Document Commit Rules (Continuous Sync)
 
-| 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`  |
+> 🔄 **Docs synchronization is mandatory when Project code changes.**
 
-> ⚠️ Do not commit when creating Feature folder.
+| Situation                 | Rule                                                                  |
+| ------------------------- | --------------------------------------------------------------------- |
+| **Project + Docs Change** | Must commit Docs **together with Project commit** (Maintain Sync)     |
+| **Docs Only Change**      | If only docs changed (e.g., `custom.md` update), **commit Docs only** |
 
-### Merge Strategy
+#### Standalone Mode Commit Guide
 
-| Situation      | Merge Method     |
-| -------------- | ---------------- |
-| Normal Feature | Squash and Merge |
-| Urgent Hotfix  | Squash and Merge |
+1. **Project Commit** (If code changed)
+
+   ```bash
+   git commit -m "feat(#123): implement feature"
+   ```
+
+2. **Docs Commit** (If docs changed - **Run in Docs Repo**)
+   ```bash
+   git commit -m "docs(#123): update feature docs"
+   ```
+
+> 💡 **Core Rule**: At task completion, **all changed repositories** must be committed.
 
 ---
 

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

@@ -36,14 +36,30 @@ In GitHub Issues, use different link formats **based on file location**:
    [react-i18next](https://react.i18next.com/)
    ```
 
-3. **Local documents** (no URL available): **Path from project root**
+3. **Files within project repo**: Use full URL (clickable)
+   - **Merged documents/code**: Use `main` branch
+     ```markdown
+     [filename](https://github.com/{owner}/{repo}/blob/main/path/to/file)
+     ```
+   - **In-progress documents** (not merged yet): Use **Feature branch**
+     ```markdown
+     [filename](https://github.com/{owner}/{repo}/blob/{feat-branch}/path/to/file)
+     ```
+
+4. **External documents (with public URL)**: Use **absolute URL**
+
+   ```markdown
+   [react-i18next](https://react.i18next.com/)
+   ```
+
+5. **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`
+   - **Spec**: `docs/features/{be|fe}/F001-feature-name/spec.md`
+   - **Tasks**: `docs/features/{be|fe}/F001-feature-name/tasks.md`
    ```
 
 > ⚠️ Local documents are not clickable on GitHub, so use **bold label + code block path** format instead of markdown links.
@@ -69,7 +85,7 @@ In GitHub Issues, use different link formats **based on file location**:
 
 ## Related Documents
 
-- **Spec**: `{{featurePath}}/F{number}-{feature-name}/spec.md`
+- **Spec**: `docs/features/{be|fe}/F{number}-{feature-name}/spec.md`
 
 ## Labels
 

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

@@ -58,8 +58,8 @@ For file links within the repo in PR body, **always use current branch name**:
 
 ## Related Documents
 
-- **Spec**: `{{featurePath}}/F{number}-{feature-name}/spec.md`
-- **Tasks**: `{{featurePath}}/F{number}-{feature-name}/tasks.md`
+- **Spec**: `docs/features/{be|fe}/F{number}-{feature-name}/spec.md`
+- **Tasks**: `docs/features/{be|fe}/F{number}-{feature-name}/tasks.md`
 
 Closes #{issue-number}
 ```
@@ -85,9 +85,25 @@ gh pr create \
 | Situation      | Merge Method     |
 | -------------- | ---------------- |
 | Normal Feature | Squash and Merge |
-| Urgent Hotfix  | Merge or Rebase  |
+| Urgent Hotfix  | Squash and Merge |
 | Docs update    | Squash and Merge |
 
+### Merge Execution
+
+After all reviews are resolved:
+
+```bash
+# Update main before merge
+git checkout main
+git pull
+
+# Squash and Merge
+gh pr merge --squash --delete-branch
+
+# Update main after merge
+git pull
+```
+
 ---
 
 ## Label Rules

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

@@ -37,7 +37,15 @@ Share full spec.md content with user and wait for **explicit approval (OK)**
 
 → See `skills/create-issue.md`
 
-### 5. Pre-Commit Checklist
+### 5. Create Branch
+
+```bash
+git checkout -b feat/{issue-number}-{feature-name}
+```
+
+> ⚠️ **Do NOT work on main branch.** Always create a branch after issue creation.
+
+### 6. Pre-Commit Checklist
 
 > ⚠️ **Before committing, verify:**
 
@@ -45,6 +53,20 @@ Share full spec.md content with user and wait for **explicit approval (OK)**
 - [ ] Issue number in tasks.md (`- **Issue**: #{issue}`)
 - [ ] Branch name in tasks.md (`feat/{issue-number}-{feature-name}`)
 
+### 7. Commit Documents
+
+> 🚨 **User Approval Required**
+
+After spec/plan/tasks approval, commit the **entire Feature folder**:
+
+```bash
+git add docs/features/{be|fe}/F{number}-{feature-name}/
+git commit -m "docs(#{issue}): F{number} planning complete"
+```
+
+> 📁 **Included files**: spec.md, plan.md, tasks.md, decisions.md (include even if empty)
+> ⚠️ **Standalone mode**: Switch to Docs repo before committing.
+
 ---
 
 ## Reference Documents

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

@@ -27,21 +27,21 @@ Guide for creating Pull Requests.
 
 ### 2. Test Verification
 
-> 🚨 **Cannot create PR if tests fail**
+> 🚨 **PR cannot be created if tests fail**
 
-1. Run related test commands (e.g., `npm test`, `pnpm test`)
+1. Run relevant test commands (e.g., `npm test`, `pnpm test`); if no tests exist, request them from the user
 2. Check results (PASS/FAIL)
-3. Record **execution results** in PR body "Tests" section
-4. Check boxes **only for items that actually passed**
+3. Record **execution results** in the "Tests" section of PR body
+4. All checkboxes must be checked
 
 ### 3. Request User Approval
 
 > 🚨 **User Approval Required**
 
-Before creating PR, share and wait for approval:
+Before creating PR, share the following **in a code block** and wait for **explicit approval (OK)**:
 
 - Title
-- Body (including test results)
+- Full body (`pr-template.md` format)
 - Labels
 
 ### 4. Create PR

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

@@ -20,25 +20,33 @@ 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]` |
+| Timing              | Status Transition    |
+| ------------------- | -------------------- |
+| On start            | `[TODO]` → `[DOING]` |
+| After user approval | `[DOING]` → `[DONE]` |
+
+> ⚠️ Even after work is complete, **stay in `[DOING]` until user approval**
 
 Record date (YYYY-MM-DD) with each status change
 
-### 4. Commit After Task Completion
+### 4. Commit After Task Completion (Docs Sync)
 
 > 🚨 **User Approval Required**
 
 Before committing, share and wait for approval:
 
-- Commit message
+- Commit message (Applicable repositories)
 - Files to be included
 
 ```bash
+# 1. Project Commit (If code changed)
+git add .
+git commit -m "{type}(#{issue}): {task description}"
+
+# 2. Docs Commit (If docs changed)
+# For Standalone mode, move to docs repo
 git add .
-git commit -m "{type}(#{issue-number}): {task description}"
+git commit -m "docs(#{issue}): {task description} update docs"
 ```
 
 ---

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

@@ -59,11 +59,16 @@ Operating rules for AI code assistants to perform consistent code generation and
 docs/
 ├── README.md           # Documentation guide
 ├── agents/             # Agent operating rules
-│   ├── agents.md
-│   ├── constitution.md
-│   ├── git-workflow.md
+│   ├── agents.md       # Main rules (this file)
+│   ├── constitution.md # Project principles
+│   ├── git-workflow.md # Git automation
 │   ├── issue-template.md
-│   └── pr-template.md
+│   ├── pr-template.md
+│   └── skills/         # Step-by-step guides
+│       ├── create-feature.md
+│       ├── create-issue.md
+│       ├── create-pr.md
+│       └── execute-task.md
 ├── prd/                # Product requirements
 ├── features/           # Feature documentation
 │   ├── be/             # Backend Features

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

@@ -52,18 +52,23 @@ Operating rules for AI code assistants to perform consistent code generation and
 
 ```
 docs/
-├── README.md
-├── agents/
-│   ├── agents.md
-│   ├── constitution.md
-│   ├── git-workflow.md
+├── README.md           # Documentation guide
+├── agents/             # Agent operating rules
+│   ├── agents.md       # Main rules (this file)
+│   ├── constitution.md # Project principles
+│   ├── git-workflow.md # Git automation
 │   ├── issue-template.md
-│   └── pr-template.md
-├── prd/
-├── features/
-│   ├── feature-base/
+│   ├── pr-template.md
+│   └── skills/         # Step-by-step guides
+│       ├── create-feature.md
+│       ├── create-issue.md
+│       ├── create-pr.md
+│       └── execute-task.md
+├── prd/                # Product requirements
+├── features/           # Feature documentation
+│   ├── feature-base/   # Template
 │   └── F00X-{name}/
-└── scripts/
+└── scripts/            # Utilities
 ```
 
 ---

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

@@ -1,5 +1,7 @@
 # {{projectName}} Constitution
 
+> ⚠️ **`{{projectName}}`과 `{{date}}`는 프로젝트 이름과 날짜로 교체하세요.**
+
 프로젝트의 핵심 원칙과 기술 결정 가이드라인입니다.
 모든 개발 결정은 이 문서를 기준으로 합니다.
 

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

@@ -85,21 +85,29 @@ main
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-### 문서 커밋 시점 (docs 레포)
+### 문서 커밋 규칙 (Continuous Sync)
 
-| 커밋 시점                              | 포함 내용                          | 커밋 메시지 예시                               |
-| -------------------------------------- | ---------------------------------- | ---------------------------------------------- |
-| 계획 완료 시 (spec+plan+tasks 승인 후) | `F{번호}-{기능명}/` 폴더 전체      | `docs(#{이슈번호}): F{번호} spec, plan, tasks` |
-| Feature 완료 시 (모든 태스크 완료 후)  | `F{번호}-{기능명}/` 폴더 변경 사항 | `docs(#{이슈번호}): F{번호} Feature 완료`      |
+> 🔄 **Project 코드 변경 시 Docs 동기화는 필수입니다.**
 
-> ⚠️ Feature 폴더 생성 시점에는 커밋하지 않습니다.
+| 상황                    | 규칙                                                     |
+| ----------------------- | -------------------------------------------------------- |
+| **Project + Docs 변경** | 프로젝트 커밋 시 Docs도 **반드시 함께 커밋** (Sync 유지) |
+| **Docs만 변경**         | `custom.md` 수정 등 문서만 변경된 경우 **Docs만 커밋**   |
 
-### 머지 전략
+#### Standalone 모드 커밋 가이드
 
-| 상황         | 머지 방식        |
-| ------------ | ---------------- |
-| 일반 Feature | Squash and Merge |
-| 긴급 Hotfix  | Squash and Merge |
+1. **Project 커밋** (코드 변경사항이 있는 경우)
+
+   ```bash
+   git commit -m "feat(#123): 기능 구현"
+   ```
+
+2. **Docs 커밋** (문서 변경사항이 있는 경우 - **Docs 레포에서 실행**)
+   ```bash
+   git commit -m "docs(#123): 기능 구현 문서 업데이트"
+   ```
+
+> 💡 **Core Rule**: 태스크 완료 시점에는 **변경된 모든 레포지토리**가 커밋되어야 합니다.
 
 ---
 

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

@@ -42,8 +42,8 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
    > 형식: `- **{레이블}**: \`{경로}\``
 
    ```markdown
-   - **Spec**: `{{featurePath}}/F001-feature-name/spec.md`
-   - **Tasks**: `{{featurePath}}/F001-feature-name/tasks.md`
+   - **Spec**: `docs/features/{be|fe}/F001-feature-name/spec.md`
+   - **Tasks**: `docs/features/{be|fe}/F001-feature-name/tasks.md`
    ```
 
 > ⚠️ 로컬 문서는 GitHub에서 클릭되지 않으므로, 마크다운 링크 대신 **볼드 레이블 + 코드블록 경로** 형식을 사용합니다.
@@ -69,7 +69,7 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
 
 ## 관련 문서
 
-- **Spec**: `{{featurePath}}/F{번호}-{기능명}/spec.md`
+- **Spec**: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
 
 ## 라벨
 

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

@@ -56,8 +56,8 @@ PR 본문에서 레포 내 파일 링크는 **반드시 현재 브랜치명을
 
 ## 관련 문서
 
-- **Spec**: `{{featurePath}}/F{번호}-{기능명}/spec.md`
-- **Tasks**: `{{featurePath}}/F{번호}-{기능명}/tasks.md`
+- **Spec**: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
+- **Tasks**: `docs/features/{be|fe}/F{번호}-{기능명}/tasks.md`
 
 Closes #{이슈번호}
 ```
@@ -80,11 +80,27 @@ gh pr create \
 
 ## 머지 규칙
 
-| 상황         | 머지 방식         |
-| ------------ | ----------------- |
-| 일반 Feature | Squash and Merge  |
-| 긴급 Hotfix  | Merge 또는 Rebase |
-| 문서 수정    | Squash and Merge  |
+| 상황         | 머지 방식        |
+| ------------ | ---------------- |
+| 일반 Feature | Squash and Merge |
+| 긴급 Hotfix  | Squash and Merge |
+| 문서 수정    | Squash and Merge |
+
+### 머지 실행
+
+모든 리뷰 해결 시:
+
+```bash
+# 머지 전 main 최신화
+git checkout main
+git pull
+
+# Squash and Merge
+gh pr merge --squash --delete-branch
+
+# 머지 후 main 최신화
+git pull
+```
 
 ---
 

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

@@ -37,7 +37,15 @@ spec.md 전문을 사용자에게 공유하고 **명시적 승인(OK)** 대기
 
 → `skills/create-issue.md` 참조
 
-### 5. 문서 커밋 전 확인
+### 5. 브랜치 생성
+
+```bash
+git checkout -b feat/{이슈번호}-{기능명}
+```
+
+> ⚠️ **main 브랜치에서 작업하지 마세요.** Issue 생성 후 반드시 브랜치를 생성합니다.
+
+### 6. 문서 커밋 전 확인
 
 > ⚠️ **커밋 전 체크리스트**
 
@@ -45,6 +53,20 @@ spec.md 전문을 사용자에게 공유하고 **명시적 승인(OK)** 대기
 - [ ] tasks.md에 이슈번호 반영 (`- **Issue**: #{이슈번호}`)
 - [ ] tasks.md에 브랜치명 반영 (`feat/{이슈번호}-{기능명}`)
 
+### 7. 문서 커밋
+
+> 🚨 **사용자 확인 필수**
+
+spec/plan/tasks 승인 후 **Feature 폴더 전체**를 커밋:
+
+```bash
+git add docs/features/{be|fe}/F{번호}-{기능명}/
+git commit -m "docs(#{이슈번호}): F{번호} 계획 완료"
+```
+
+> 📁 **포함 파일**: spec.md, plan.md, tasks.md, decisions.md (비어있어도 포함)
+> ⚠️ **Standalone 모드**: Docs 레포로 이동 후 커밋하세요.
+
 ---
 
 ## 참조 문서

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

@@ -29,19 +29,19 @@ Pull Request를 생성할 때 따르는 가이드입니다.
 
 > 🚨 **테스트 미통과 시 PR 생성 불가**
 
-1. 관련 테스트 명령어 실행 (예: `npm test`, `pnpm test`)
+1. 작업과 관련된 테스트 명령어 실행 (예: `npm test`, `pnpm test`), 테스트가 없는 경우 사용자에게 요청
 2. 결과 확인 (PASS/FAIL)
 3. PR 본문 "테스트" 섹션에 **실행 결과** 기록
-4. 체크박스는 **실제 통과한 항목만** 체크
+4. 모든 체크박스가 체크되어야 함
 
 ### 3. 사용자 확인 요청
 
 > 🚨 **사용자 확인 필수**
 
-PR 생성 전 다음 내용을 공유하고 승인 대기:
+PR 생성 전 다음 내용을 **코드블록으로** 사용자에게 공유하고 **명시적 승인(OK)** 대기:
 
 - 제목
-- 본문 (테스트 결과 포함)
+- 본문 전체 (`pr-template.md` 형식)
 - 라벨
 
 ### 4. PR 생성

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

@@ -20,25 +20,33 @@ tasks.md의 태스크를 실행할 때 따르는 가이드입니다.
 
 ### 3. 상태 전환
 
-| 시점    | 상태 전환            |
-| ------- | -------------------- |
-| 시작 시 | `[TODO]` → `[DOING]` |
-| 완료 시 | `[DOING]` → `[DONE]` |
+| 시점           | 상태 전환            |
+| -------------- | -------------------- |
+| 시작 시        | `[TODO]` → `[DOING]` |
+| 사용자 승인 후 | `[DOING]` → `[DONE]` |
+
+> ⚠️ 작업이 완료되어도 **사용자 승인 전까지는 `[DOING]` 상태 유지**
 
 상태 전환 시 날짜도 함께 기록 (YYYY-MM-DD)
 
-### 4. 태스크 완료 후 커밋
+### 4. 태스크 완료 후 커밋 (Docs Sync)
 
 > 🚨 **사용자 확인 필수**
 
 커밋 생성 전 다음 내용을 공유하고 승인 대기:
 
-- 커밋 메시지
+- 커밋 메시지 (해당되는 레포지토리)
 - 포함될 파일 목록
 
 ```bash
+# 1. Project 커밋 (코드 변경사항이 있는 경우)
 git add .
 git commit -m "{type}(#{이슈번호}): {태스크 설명}"
+
+# 2. Docs 커밋 (Docs 변경사항이 있는 경우)
+# Standalone 모드인 경우 Docs 레포로 이동하여 실행
+git add .
+git commit -m "docs(#{이슈번호}): {태스크 설명} 문서 업데이트"
 ```
 
 ---

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

@@ -63,7 +63,12 @@ docs/
 │   ├── constitution.md # 프로젝트 원칙
 │   ├── git-workflow.md # Git 자동화
 │   ├── issue-template.md
-│   └── pr-template.md
+│   ├── pr-template.md
+│   └── skills/         # 단계별 가이드
+│       ├── create-feature.md
+│       ├── create-issue.md
+│       ├── create-pr.md
+│       └── execute-task.md
 ├── prd/                # 제품 요구사항
 ├── features/           # 기능별 문서
 │   ├── be/             # Backend Features

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

@@ -58,19 +58,18 @@
 docs/
 ├── README.md           # 문서 안내
 ├── agents/             # 에이전트 운영 규칙
-│   ├── agents.md
-│   ├── constitution.md
-│   ├── git-workflow.md
+│   ├── agents.md       # 메인 규칙 (이 파일)
+│   ├── constitution.md # 프로젝트 원칙
+│   ├── git-workflow.md # Git 자동화
 │   ├── issue-template.md
 │   ├── pr-template.md
-│   └── skills/         # 프로세스별 가이드
+│   └── skills/         # 단계별 가이드
 │       ├── create-feature.md
 │       ├── create-issue.md
 │       ├── create-pr.md
 │       └── execute-task.md
 ├── prd/                # 제품 요구사항
 ├── features/           # 기능별 문서
-│   ├── feature-base/   # 템플릿
 │   └── F00X-{name}/    # 개별 기능
 └── scripts/            # 유틸리티
 ```