lee-spec-kit 0.1.3 → 0.1.5

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에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
+
 ---
 
 ## 이슈 본문 템플릿

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 본문 템플릿
 

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. 프로젝트 개요와 목표를 정의하세요