lee-spec-kit 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "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**
 >
@@ -42,33 +44,19 @@ All development decisions should be based on this document.
 
 ## Architecture Principles
 
-### 1. Feature-Centric Management
-
-- Manage new features in `docs/features/F00X/` structure
-- Develop by **feature unit** (FE/BE separate)
-- spec → plan → tasks → decisions workflow
-
-### 2. (Additional Principles)
-
-(Write project-specific architecture principles here)
+> (Write project-specific architecture principles here. e.g., layer structure, dependency rules)
 
 ---
 
 ## Code Quality Standards
 
-- TypeScript strict mode required
-- ESLint + Prettier required
-- Major business logic test coverage **80%+**
-- Components follow **Single Responsibility Principle**
-- Minimize code duplication
+> (Write project code quality standards here. e.g., test coverage, lint rules)
 
 ---
 
 ## Security Principles
 
-- Manage secrets via environment variables (no repo commits)
-- **Minimal data collection** for user data
-- CORS only for allowed origins
+> (Write project security principles here. e.g., authentication method, data encryption)
 
 ---
 

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

@@ -109,13 +109,6 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > 💡 **Core Rule**: At task completion, **all changed repositories** must be committed.
 
-### Merge Strategy
-
-| Situation      | Merge Method     |
-| -------------- | ---------------- |
-| Normal Feature | Squash and Merge |
-| Urgent Hotfix  | Squash and Merge |
-
 ---
 
 ## Docs Push Rules

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,10 +20,13 @@ 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    | Checkbox          |
+| ------------------- | -------------------- | ----------------- |
+| On start            | `[TODO]` → `[DOING]` | `[ ]` (No change) |
+| After user approval | `[DOING]` → `[DONE]` | **`[x]` (Check)** |
+
+> ⚠️ Even after work is complete, **stay in `[DOING]` until user approval**
+> ⚠️ When switching to `[DONE]`, **must also check the checkbox**.
 
 Record date (YYYY-MM-DD) with each status change
 

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}}`는 프로젝트 이름과 날짜로 교체하세요.**
+
 프로젝트의 핵심 원칙과 기술 결정 가이드라인입니다.
 모든 개발 결정은 이 문서를 기준으로 합니다.
 
@@ -42,33 +44,19 @@
 
 ## 아키텍처 원칙
 
-### 1. Feature 중심 관리
-
-- 새 기능은 `docs/features/F00X/` 구조로 관리
-- FE/BE 분리하여 **기능 단위**로 개발
-- spec → plan → tasks → decisions 워크플로우
-
-### 2. (추가 원칙)
-
-(프로젝트별 아키텍처 원칙을 작성하세요)
+> (프로젝트별 아키텍처 원칙을 작성하세요. 예: 레이어 구조, 의존성 규칙 등)
 
 ---
 
 ## 코드 품질 기준
 
-- TypeScript strict mode 필수
-- ESLint + Prettier 필수
-- 주요 비즈니스 로직 테스트 커버리지 **80%+**
-- 컴포넌트는 **단일 책임 원칙**
-- 중복 코드 최소화
+> (프로젝트의 코드 품질 기준을 작성하세요. 예: 테스트 커버리지, 린트 규칙 등)
 
 ---
 
 ## 보안 원칙
 
-- 환경 변수로 시크릿 관리 (저장소 커밋 금지)
-- 사용자 데이터 **최소 수집**
-- CORS는 허용 오리진만 설정
+> (프로젝트의 보안 원칙을 작성하세요. 예: 인증 방식, 데이터 암호화 등)
 
 ---
 

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

@@ -109,13 +109,6 @@ git checkout -b feat/{issue-number}-{feature-name}
 
 > 💡 **Core Rule**: 태스크 완료 시점에는 **변경된 모든 레포지토리**가 커밋되어야 합니다.
 
-### 머지 전략
-
-| 상황         | 머지 방식        |
-| ------------ | ---------------- |
-| 일반 Feature | Squash and Merge |
-| 긴급 Hotfix  | Squash and Merge |
-
 ---
 
 ## Docs Push 규칙

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,10 +20,13 @@ tasks.md의 태스크를 실행할 때 따르는 가이드입니다.
 
 ### 3. 상태 전환
 
-| 시점    | 상태 전환            |
-| ------- | -------------------- |
-| 시작 시 | `[TODO]` → `[DOING]` |
-| 완료 시 | `[DOING]` → `[DONE]` |
+| 시점           | 상태 전환            | 체크박스          |
+| -------------- | -------------------- | ----------------- |
+| 시작 시        | `[TODO]` → `[DOING]` | `[ ]` (변경 없음) |
+| 사용자 승인 후 | `[DOING]` → `[DONE]` | **`[x]` (체크)**  |
+
+> ⚠️ 작업이 완료되어도 **사용자 승인 전까지는 `[DOING]` 상태 유지**
+> ⚠️ `[DONE]` 상태 전환 시 **체크박스도 반드시 체크**합니다.
 
 상태 전환 시 날짜도 함께 기록 (YYYY-MM-DD)
 

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/            # 유틸리티
 ```