lee-spec-kit 0.1.3 → 0.1.5

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

@@ -1,97 +1,99 @@
-# Git 워크플로우 가이드
+# Git Workflow Guide
 
-에이전트가 Git/GitHub 작업을 자동화하기 위한 규칙입니다.
+Rules for AI agents to automate Git/GitHub operations.
 
 ---
 
-## 핵심 개념
+## Core Concepts
 
-| 개념      | GitHub 매핑  | 설명                    |
-| --------- | ------------ | ----------------------- |
-| Feature   | GitHub Issue | 기능 단위 작업          |
-| 태스크    | Commit       | 개별 구현 단위          |
-| 기능 완료 | Pull Request | Feature 완료 시 PR 생성 |
+| Concept          | GitHub Mapping | Description                     |
+| ---------------- | -------------- | ------------------------------- |
+| Feature          | GitHub Issue   | Feature-level work unit         |
+| Task             | Commit         | Individual implementation unit  |
+| Feature Complete | Pull Request   | Create PR on feature completion |
 
 ---
 
-## 브랜치 전략
+## Branch Strategy
 
 ```
 main
- └── feat/123-feature-name    # Issue #123 기반 브랜치
-      ├── commit 1: feat(#123): 기능 구현
-      ├── commit 2: test(#123): 테스트 작성
-      └── commit 3: docs(#123): 문서 업데이트
+ └── feat/123-feature-name    # Branch based on Issue #123
+      ├── commit 1: feat(#123): implement feature
+      ├── commit 2: test(#123): add tests
+      └── commit 3: docs(#123): update docs
 ```
 
-### 브랜치 네이밍
+### Branch Naming
 
 ```
 {type}/{issue-number}-{feature-name}
 ```
 
-| Type       | 설명      |
-| ---------- | --------- |
-| `feat`     | 새 기능   |
-| `fix`      | 버그 수정 |
-| `refactor` | 리팩토링  |
-| `docs`     | 문서      |
+| Type       | Description   |
+| ---------- | ------------- |
+| `feat`     | New feature   |
+| `fix`      | Bug fix       |
+| `refactor` | Refactoring   |
+| `docs`     | Documentation |
 
-**예시:**
+**Examples:**
 
 - `feat/123-user-auth`
 - `fix/456-login-error`
 
 ---
 
-## 커밋 컨벤션
+## Commit Convention
 
-### 형식
+> 📖 Type and Description follow [Udacity Git Commit Message Style Guide](https://udacity.github.io/git-styleguide/).
+
+### Format
 
 ```
 {type}(#{issue}): {description}
 ```
 
-### Type 목록
+### Type List
 
-| Type       | 설명        | 예시                                |
-| ---------- | ----------- | ----------------------------------- |
-| `feat`     | 새 기능     | `feat(#123): 사용자 인증 구현`      |
-| `fix`      | 버그 수정   | `fix(#123): 로그인 오류 수정`       |
-| `refactor` | 리팩토링    | `refactor(#123): 인증 로직 분리`    |
-| `test`     | 테스트      | `test(#123): 인증 단위 테스트 추가` |
-| `docs`     | 문서        | `docs(#123): 스펙 명확화`           |
-| `style`    | 코드 스타일 | `style(#123): 린트 오류 수정`       |
-| `chore`    | 기타        | `chore(#123): 의존성 업데이트`      |
+| Type       | Description   | Example                               |
+| ---------- | ------------- | ------------------------------------- |
+| `feat`     | New feature   | `feat(#123): implement user auth`     |
+| `fix`      | Bug fix       | `fix(#123): fix login error`          |
+| `refactor` | Refactoring   | `refactor(#123): separate auth logic` |
+| `test`     | Tests         | `test(#123): add auth unit tests`     |
+| `docs`     | Documentation | `docs(#123): clarify spec`            |
+| `style`    | Code style    | `style(#123): fix lint errors`        |
+| `chore`    | Other         | `chore(#123): update dependencies`    |
 
 ---
 
-## 자동화 워크플로우
+## Automation Workflow
 
-### 1. Feature 시작
+### 1. Feature Start
 
 ```bash
-# 1. GitHub Issue 생성 (Feature = Issue)
-# 2. 브랜치 생성
+# 1. Create GitHub Issue (Feature = Issue)
+# 2. Create branch
 git checkout -b feat/{issue-number}-{feature-name}
 ```
 
-> `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
+> When creating/modifying issues/PRs with `gh`, share the title/body/labels first and **wait for user confirmation (OK)** before proceeding.
 
-### 2. 태스크 완료 시 자동 커밋
+### 2. Auto Commit on Task Completion
 
-태스크 하나가 완료되면:
+When a task is completed:
 
 ```bash
 git add .
 git commit -m "{type}(#{issue}): {task-description}"
 ```
 
-> `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
+> Before running `git commit`, share the commit message and file list first and **wait for user confirmation (OK)** before proceeding.
 
-### 3. Feature 완료 시 PR 생성
+### 3. Create PR on Feature Completion
 
-모든 태스크 완료 시:
+When all tasks are completed:
 
 ```bash
 git push origin feat/{issue-number}-{feature-name}
@@ -100,58 +102,58 @@ gh pr create --title "feat(#{issue}): {feature-title}" \
   --base main
 ```
 
-### 4. 머지
+### 4. Merge
 
-모든 리뷰 해결 시:
+When all reviews are resolved:
 
 ```bash
-# 머지 전 main 최신화
+# Update main before merge
 git checkout main
 git pull
 
 # Squash and Merge
 gh pr merge --squash --delete-branch
 
-# 머지 후 main 최신화
+# Update main after merge
 git pull
 ```
 
 ---
 
-## 에이전트 자동화 규칙
+## Agent Automation Rules
 
-### 태스크 완료 시
+### On Task Completion
 
 ```
-1. 코드 변경 완료
-2. tasks.md 상태 [DOING] → [DONE] 업데이트 (docs)
+1. Complete code changes
+2. Update tasks.md status [DOING] → [DONE] (docs)
 3. git add .
 4. git commit -m "{type}(#{issue}): {description}"
-5. 다음 태스크 진행
+5. Proceed to next task
 ```
 
-### Feature 완료 시
+### On Feature Completion
 
 ```
-1. 모든 태스크 [DONE] 확인
+1. Verify all tasks [DONE]
 2. git push origin {branch}
 3. gh pr create
-4. 리뷰 대기
-5. 리뷰 코멘트 수정
+4. Wait for review
+5. Address review comments
 6. gh pr merge --squash
 ```
 
 ---
 
-## GitHub 설정 요구사항
+## GitHub Setup Requirements
 
-### 필수
+### Required
 
-- [ ] GitHub CLI (`gh`) 설치 및 인증
+- [ ] GitHub CLI (`gh`) installed and authenticated
 - [ ] Branch protection rules (main)
   - Require PR before merging
 
-### 권장
+### Recommended
 
 - [ ] Auto-delete head branches
 - [ ] Squash merging only

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

@@ -1,62 +1,89 @@
-# GitHub Issue 템플릿 가이드
+# GitHub Issue Template Guide
 
-에이전트가 GitHub Issue를 생성할 때 참조하는 템플릿입니다.
+A template for AI agents to create GitHub Issues.
 
 ---
 
-## 이슈 생성 규칙
+## Issue Creation Rules
 
-### 제목 형식
+### Title Format
 
 ```text
-F{번호}: {기능명} ({짧은 설명})
+F{number}: {feature-name} ({short description})
 ```
 
-예: `F001: user-auth (사용자 인증 기능)`
+Example: `F001: user-auth (User authentication feature)`
 
-> "짧은 설명"은 한 줄로 의도를 전달할 수 있을 정도로만 작성합니다.
+> Keep the "short description" concise enough to convey the intent in one line.
+
+### Link Format (Important!)
+
+In GitHub Issues, use different link formats **based on file location**:
+
+1. **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)
+     ```
+
+2. **External documents (with public URL)**: Use **absolute URL**
+
+   ```markdown
+   [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
+   ```
+
+> ⚠️ Local documents are not clickable on GitHub, so provide path text only.
 
 ---
 
-## 이슈 본문 템플릿
+## Issue Body Template
 
 ```markdown
-## 개요
+## Overview
 
-{기능에 대한 간략한 설명}
+{Brief description of the feature}
 
-## 목표
+## Goals
 
-- {목표 1}
-- {목표 2}
+- {Goal 1}
+- {Goal 2}
 
-## 완료 조건
+## Completion Criteria
 
-- [ ] {조건 1}
-- [ ] {조건 2}
+- [ ] {Criterion 1}
+- [ ] {Criterion 2}
 
-## 관련 문서
+## Related Documents
 
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
+- Spec: `docs/features/F{number}-{feature-name}/spec.md`
 
-## 라벨
+## Labels
 
-- `enhancement` (새 기능)
-- `bug` (버그 수정)
-- `documentation` (문서)
+- `enhancement` (New feature)
+- `bug` (Bug fix)
+- `documentation` (Documentation)
 ```
 
 ---
 
-## 라벨 규칙
+## Label Rules
 
-| 라벨            | 용도          |
+| Label           | Usage         |
 | --------------- | ------------- |
-| `enhancement`   | 새 기능       |
-| `bug`           | 버그 수정     |
-| `documentation` | 문서 작업     |
-| `backend`       | BE 관련       |
-| `frontend`      | FE 관련       |
+| `enhancement`   | New feature   |
+| `bug`           | Bug fix       |
+| `documentation` | Documentation |
+| `backend`       | BE related    |
+| `frontend`      | FE related    |
 | `priority:high` | High priority |
 
 ---

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

@@ -1,74 +1,85 @@
-# GitHub PR 템플릿 가이드
+# GitHub PR Template Guide
 
-에이전트가 Pull Request를 생성할 때 참조하는 템플릿입니다.
+A template for AI agents to create Pull Requests.
 
 ---
 
-## PR 생성 규칙
+## PR Creation Rules
 
-### 제목 형식
+### Title Format
 
 ```text
-feat(#{이슈번호}): {기능명}
+feat(#{issue-number}): {feature-name}
 ```
 
-예: `feat(#1): 사용자 인증 구현`
+Example: `feat(#1): Implement user authentication`
+
+### Link Format (Important!)
+
+For file links within the repo in PR body, **always use current branch name**:
+
+```markdown
+[filename](https://github.com/{owner}/{repo}/blob/{branch-name}/docs/path/to/file.md)
+```
+
+> ⚠️ `main` branch links will return 404 until merged!
+> Always use the **current feature branch name** (e.g., `feat/5-feature-name`).
 
 ---
 
-## PR 본문 템플릿
+## PR Body Template
 
 ```markdown
-## 개요
+## Overview
 
-{변경 사항에 대한 간략한 설명}
+{Brief description of changes}
 
-## 변경 사항
+## Changes
 
-- {변경 1}
-- {변경 2}
-- {변경 3}
+- {Change 1}
+- {Change 2}
+- {Change 3}
 
-## 테스트
+## Tests
 
-- [ ] 유닛 테스트 통과
-- [ ] 통합 테스트 완료
+- [ ] Unit tests passed
+- [ ] Integration tests completed
 
-## 스크린샷 (UI 변경 시)
+## Screenshots (for UI changes)
 
-{있으면 첨부}
+{Attach if applicable}
 
-## 관련 문서
+## Related Documents
 
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
-- Tasks: `docs/features/{be|fe}/F{번호}-{기능명}/tasks.md`
+- Spec: `docs/features/F{number}-{feature-name}/spec.md`
+- Tasks: `docs/features/F{number}-{feature-name}/tasks.md`
 
-Closes #{이슈번호}
+Closes #{issue-number}
 ```
 
 ---
 
-## PR 생성 명령어
+## PR Creation Command
 
 ```bash
-# 현재 브랜치명 확인
+# Check current branch name
 BRANCH=$(git branch --show-current)
 
 gh pr create \
-  --title "feat(#{issue}): {기능명}" \
+  --title "feat(#{issue}): {feature-name}" \
   --body-file /tmp/pr-body.md \
   --base main
 ```
 
 ---
 
-## 머지 규칙
+## Merge Rules
 
-| 상황         | 머지 방식         |
-| ------------ | ----------------- |
-| 일반 Feature | Squash and Merge  |
-| 긴급 Hotfix  | Merge 또는 Rebase |
-| Docs update  | Squash and Merge  |
+| Situation      | Merge Method     |
+| -------------- | ---------------- |
+| Normal Feature | Squash and Merge |
+| Urgent Hotfix  | Merge or Rebase  |
+| Docs update    | Squash and Merge |
 
 ---
 

package/templates/en/single/features/README.md

@@ -22,7 +22,7 @@ features/
 ## Creating New Features
 
 ```bash
-lee-spec-kit feature user-auth
+npx lee-spec-kit feature user-auth
 ```
 
 > 💡 CLI copies templates from `feature-base/` and auto-assigns IDs.
@@ -41,7 +41,7 @@ lee-spec-kit feature user-auth
 ## Status Check
 
 ```bash
-lee-spec-kit status
+npx lee-spec-kit status
 ```
 
 ---

package/templates/en/single/features/feature-base/plan.md

@@ -1,4 +1,4 @@
-# Implementation Plan: {기능명}
+# Implementation Plan: {feature-name}
 
 > Write after spec is approved.
 
@@ -6,7 +6,7 @@
 
 ## Overview
 
-- **Feature ID**: F{번호}
+- **Feature ID**: F{number}
 - **Target Repo**: {{projectName}}
 - **Created**: YYYY-MM-DD
 - **Status**: Draft | Review | Approved

package/templates/en/single/features/feature-base/spec.md

@@ -1,4 +1,4 @@
-# Feature Spec: {기능명}
+# Feature Spec: {feature-name}
 
 > Tech stack is covered in plan.md.
 
@@ -6,10 +6,10 @@
 
 ## Overview
 
-- **Feature ID**: F{번호}
-- **Feature Name**: {기능명}
+- **Feature ID**: F{number}
+- **Feature Name**: {feature-name}
 - **Target Repo**: {{projectName}}
-- **Issue Number**: #{이슈번호}
+- **Issue Number**: #{issue-number}
 - **Created**: YYYY-MM-DD
 - **Status**: Draft | Review | Approved
 

package/templates/en/single/features/feature-base/tasks.md

@@ -1,4 +1,4 @@
-# Tasks: {기능명}
+# Tasks: {feature-name}
 
 ## Task Rules
 
@@ -10,8 +10,8 @@
 ## GitHub Issue
 
 - **Repo**: {{projectName}}
-- **Issue**: #{이슈번호}
-- **Branch**: `feat/{이슈번호}-{기능명}`
+- **Issue**: #{issue-number}
+- **Branch**: `feat/{issue-number}-{feature-name}`
 
 ---
 
@@ -19,7 +19,7 @@
 
 ### Phase 1: {Phase Name}
 
-- [TODO][P1] T-F{번호}-01 {Task Title}
+- [TODO][P1] T-F{number}-01 {Task Title}
   - Acceptance:
     - (verification condition)
   - Checklist:

package/templates/en/single/prd/README.md

@@ -1,15 +1,20 @@
 # PRD (Product Requirements Document)
 
-이 폴더에는 제품 요구사항 문서를 작성합니다.
+This folder contains product requirements documents.
 
-## 작성 가이드
+> **📌 Document Scope**
+>
+> - **This folder**: Product requirements, business logic, user stories
+> - **Constitution**: Tech stack, architecture principles, code quality, security principles → `agents/constitution.md`
 
-1. 프로젝트 개요와 목표를 정의하세요
-2. 주요 기능과 사용자 스토리를 작성하세요
-3. 기술 아키텍처 개요를 포함하세요
+## Writing Guide
 
-## 예시 파일
+1. Define project overview and goals
+2. Write main features and user stories
+3. Include technical architecture overview
 
-- `{project-name}-prd.md` - 메인 PRD 문서
-- `backend-overview.md` - 백엔드 아키텍처 (선택)
-- `frontend-overview.md` - 프론트엔드 아키텍처 (선택)
+## Example Files
+
+- `{project-name}-prd.md` - Main PRD document
+- `backend-overview.md` - Backend architecture (optional)
+- `frontend-overview.md` - Frontend architecture (optional)

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

@@ -66,7 +66,7 @@ docs/
 ### 1. 새 기능 추가 요청
 
 1. 대상 레포 확인 (BE 또는 FE)
-2. 새 기능 폴더 생성: `lee-spec-kit feature <name>` 또는 `docs/features/README.md` 참조
+2. 새 기능 폴더 생성: `npx lee-spec-kit feature <name>` 또는 `docs/features/README.md` 참조
 3. `spec.md` 작성 - 무엇을, 왜 만드는지 (기술 스택 X)
 4. 사용자에게 스펙 초안 확인 요청
 5. GitHub Issue 생성 (`agents/issue-template.md` 참조)

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

@@ -3,6 +3,11 @@
 프로젝트의 핵심 원칙과 기술 결정 가이드라인입니다.
 모든 개발 결정은 이 문서를 기준으로 합니다.
 
+> **📌 문서 범위**
+>
+> - **이 문서**: 기술 스택, 아키텍처 원칙, 코드 품질, 보안 원칙
+> - **PRD**: 제품 요구사항, 비즈니스 로직, 사용자 스토리 → `prd/*.md`
+
 ---
 
 ## 프로젝트 미션

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

@@ -46,6 +46,8 @@ main
 
 ## 커밋 컨벤션
 
+> 📖 Type과 Description은 [Udacity Git Commit Message Style Guide](https://udacity.github.io/git-styleguide/)를 따릅니다.
+
 ### 형식
 
 ```

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

@@ -16,6 +16,33 @@ F{번호}: {기능명} ({짧은 설명})
 
 > "짧은 설명"은 한 줄로 의도를 전달할 수 있을 정도로만 작성합니다.
 
+### 링크 형식 (중요!)
+
+GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
+
+1. **프로젝트 레포 내 파일**: 전체 URL 사용 (클릭 가능)
+   - **일반 문서/코드** (이미 머지됨): `main` 브랜치
+     ```markdown
+     [파일명](https://github.com/{owner}/{repo}/blob/main/path/to/file)
+     ```
+   - **개발 중인 문서** (아직 머지 안 됨): **Feature 브랜치**
+     ```markdown
+     [파일명](https://github.com/{owner}/{repo}/blob/{feat-branch}/path/to/file)
+     ```
+
+2. **외부 문서 (공개 URL 있음)**: **절대 URL로 링크**
+
+   ```markdown
+   [react-i18next](https://react.i18next.com/)
+   ```
+
+3. **외부/로컬 문서** (docs 레포 등, URL 없음): **상대 경로 텍스트로만 표기**
+   ```text
+   ../docs/features/F001-feature-name/spec.md
+   ```
+
+> ⚠️ 로컬 문서는 GitHub에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
+
 ---
 
 ## 이슈 본문 템플릿

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

@@ -14,7 +14,16 @@ feat(#{이슈번호}): {기능명}
 
 예: `feat(#1): 사용자 인증 구현`
 
----
+### 링크 형식 (중요!)
+
+PR 본문에서 레포 내 파일 링크는 **반드시 현재 브랜치명을 사용**:
+
+```markdown
+[파일명](https://github.com/{owner}/{repo}/blob/{브랜치명}/docs/path/to/file.md)
+```
+
+> ⚠️ `main` 브랜치 링크는 머지 전까지 404가 발생합니다!
+> 반드시 **현재 피처 브랜치명** (예: `feat/5-feature-name`)을 사용하세요.
 
 ## PR 본문 템플릿