lee-spec-kit 0.1.2 → 0.1.5

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에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
+
 ---
 
 ## 이슈 본문 템플릿
@@ -58,3 +85,12 @@ F{번호}: {기능명} ({짧은 설명})
 | `backend`       | BE 관련       |
 | `frontend`      | FE 관련       |
 | `priority:high` | 높은 우선순위 |
+
+---
+
+## 본문 입력 규칙 (셸 실행 방지)
+
+- 이슈 본문은 **`--body-file` 사용을 기본**으로 한다.
+- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
+- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
+  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.

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 본문 템플릿
 
@@ -69,3 +78,12 @@ gh pr create \
 | 일반 Feature | Squash and Merge  |
 | 긴급 Hotfix  | Merge 또는 Rebase |
 | 문서 수정    | Squash and Merge  |
+
+---
+
+## 본문 입력 규칙 (셸 실행 방지)
+
+- PR 본문은 **`--body-file` 사용을 기본**으로 한다.
+- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
+- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
+  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.

package/templates/ko/fullstack/features/README.md

@@ -29,10 +29,10 @@ features/
 
 ```bash
 # Backend Feature
-lee-spec-kit feature --repo be user-auth
+npx lee-spec-kit feature --repo be user-auth
 
 # Frontend Feature
-lee-spec-kit feature --repo fe user-profile
+npx lee-spec-kit feature --repo fe user-profile
 ```
 
 > 💡 CLI는 `feature-base/`에서 템플릿을 복사하고 ID를 자동 채번합니다.
@@ -55,13 +55,13 @@ lee-spec-kit feature --repo fe user-profile
 Feature 진행 상태는 CLI로 한 번에 확인합니다.
 
 ```bash
-lee-spec-kit status
+npx lee-spec-kit status
 ```
 
 파일로 저장:
 
 ```bash
-lee-spec-kit status --write
+npx lee-spec-kit status --write
 ```
 
 ---

package/templates/ko/fullstack/features/be/README.md

@@ -2,4 +2,4 @@
 
 이 폴더에 Backend Feature들이 생성됩니다.
 
-`lee-spec-kit feature --repo be <name>` 명령어로 새 Feature를 생성하세요.
+`npx lee-spec-kit feature --repo be <name>` 명령어로 새 Feature를 생성하세요.

package/templates/ko/fullstack/features/fe/README.md

@@ -2,4 +2,4 @@
 
 이 폴더에 Frontend Feature들이 생성됩니다.
 
-`lee-spec-kit feature --repo fe <name>` 명령어로 새 Feature를 생성하세요.
+`npx lee-spec-kit feature --repo fe <name>` 명령어로 새 Feature를 생성하세요.

package/templates/ko/fullstack/prd/README.md

@@ -2,6 +2,11 @@
 
 이 폴더에는 제품 요구사항 문서를 작성합니다.
 
+> **📌 문서 범위**
+>
+> - **이 폴더**: 제품 요구사항, 비즈니스 로직, 사용자 스토리
+> - **Constitution**: 기술 스택, 아키텍처 원칙, 코드 품질, 보안 원칙 → `agents/constitution.md`
+
 ## 작성 가이드
 
 1. 프로젝트 개요와 목표를 정의하세요

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

@@ -57,7 +57,7 @@ docs/
 
 ### 1. 새 기능 추가 요청
 
-1. 새 기능 폴더 생성: `lee-spec-kit feature <name>`
+1. 새 기능 폴더 생성: `npx lee-spec-kit feature <name>`
 2. `spec.md` 작성 - 무엇을, 왜 만드는지
 3. 사용자에게 스펙 초안 확인 요청
 4. GitHub Issue 생성

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

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

package/templates/ko/single/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/single/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에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
+
 ---
 
 ## 이슈 본문 템플릿
@@ -58,3 +85,12 @@ F{번호}: {기능명} ({짧은 설명})
 | `backend`       | BE 관련       |
 | `frontend`      | FE 관련       |
 | `priority:high` | 높은 우선순위 |
+
+---
+
+## 본문 입력 규칙 (셸 실행 방지)
+
+- 이슈 본문은 **`--body-file` 사용을 기본**으로 한다.
+- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
+- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
+  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.

package/templates/ko/single/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 본문 템플릿
 
@@ -69,3 +78,12 @@ gh pr create \
 | 일반 Feature | Squash and Merge  |
 | 긴급 Hotfix  | Merge 또는 Rebase |
 | 문서 수정    | Squash and Merge  |
+
+---
+
+## 본문 입력 규칙 (셸 실행 방지)
+
+- PR 본문은 **`--body-file` 사용을 기본**으로 한다.
+- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
+- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
+  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.

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

@@ -22,7 +22,7 @@ features/
 ## 새 기능 생성
 
 ```bash
-lee-spec-kit feature user-auth
+npx lee-spec-kit feature user-auth
 ```
 
 > 💡 CLI는 `feature-base/`에서 템플릿을 복사하고 ID를 자동 채번합니다.
@@ -41,7 +41,7 @@ lee-spec-kit feature user-auth
 ## 상태 확인
 
 ```bash
-lee-spec-kit status
+npx lee-spec-kit status
 ```
 
 ---

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

@@ -2,6 +2,11 @@
 
 이 폴더에는 제품 요구사항 문서를 작성합니다.
 
+> **📌 문서 범위**
+>
+> - **이 폴더**: 제품 요구사항, 비즈니스 로직, 사용자 스토리
+> - **Constitution**: 기술 스택, 아키텍처 원칙, 코드 품질, 보안 원칙 → `agents/constitution.md`
+
 ## 작성 가이드
 
 1. 프로젝트 개요와 목표를 정의하세요