lee-spec-kit 0.1.8 → 0.2.0

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

@@ -1,170 +0,0 @@
-# Git 워크플로우 가이드
-
-에이전트가 Git/GitHub 작업을 자동화하기 위한 규칙입니다.
-
----
-
-## 핵심 개념
-
-| 개념      | GitHub 매핑  | 설명                    |
-| --------- | ------------ | ----------------------- |
-| Feature   | GitHub Issue | 기능 단위 작업          |
-| 태스크    | Commit       | 개별 구현 단위          |
-| 기능 완료 | Pull Request | Feature 완료 시 PR 생성 |
-
----
-
-## 브랜치 전략
-
-```
-main
- └── feat/123-feature-name    # Issue #123 기반 브랜치
-      ├── commit 1: feat(#123): 기능 구현
-      ├── commit 2: test(#123): 테스트 작성
-      └── commit 3: docs(#123): 문서 업데이트
-```
-
-### 브랜치 네이밍
-
-```
-{type}/{issue-number}-{feature-name}
-```
-
-| Type       | 설명      |
-| ---------- | --------- |
-| `feat`     | 새 기능   |
-| `fix`      | 버그 수정 |
-| `refactor` | 리팩토링  |
-| `docs`     | 문서      |
-
-**예시:**
-
-- `feat/123-user-auth`
-- `fix/456-login-error`
-
----
-
-## 커밋 컨벤션
-
-> 📖 Type과 Description은 [Udacity Git Commit Message Style Guide](https://udacity.github.io/git-styleguide/)를 따릅니다.
-
-### 형식
-
-```
-{type}(#{issue}): {description}
-```
-
-### Type 목록
-
-| Type       | 설명        | 예시                                |
-| ---------- | ----------- | ----------------------------------- |
-| `feat`     | 새 기능     | `feat(#123): 사용자 인증 구현`      |
-| `fix`      | 버그 수정   | `fix(#123): 로그인 오류 수정`       |
-| `refactor` | 리팩토링    | `refactor(#123): 인증 로직 분리`    |
-| `test`     | 테스트      | `test(#123): 인증 단위 테스트 추가` |
-| `docs`     | 문서        | `docs(#123): 스펙 명확화`           |
-| `style`    | 코드 스타일 | `style(#123): 린트 오류 수정`       |
-| `chore`    | 기타        | `chore(#123): 의존성 업데이트`      |
-
----
-
-## 자동화 워크플로우
-
-### 1. Feature 시작
-
-```bash
-# 1. GitHub Issue 생성 (Feature = Issue)
-# 2. 브랜치 생성
-git checkout -b feat/{issue-number}-{feature-name}
-```
-
-> `gh`로 이슈/PR 생성·수정 시 작성할 제목/본문/라벨을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
-
-### 2. 문서 커밋 (docs 레포)
-
-> 📌 docs 폴더는 별도 git으로 관리되므로 프로젝트와 분리된 커밋 전략을 사용합니다.
-
-| #   | 커밋 시점                                  | 포함 문서                     | 커밋 메시지 예시                     |
-| --- | ------------------------------------------ | ----------------------------- | ------------------------------------ |
-| 1   | **계획 완료 시** (spec+plan+tasks 승인 후) | spec.md, plan.md, tasks.md    | `docs(#123): spec, plan, tasks 작성` |
-| 2   | **Feature 완료 시** (모든 태스크 완료 후)  | tasks.md (상태), decisions.md | `docs(#123): Feature 완료`           |
-
-> ⚠️ **Feature 폴더 생성 시점**에는 커밋하지 않습니다.
-
-### 3. 태스크 완료 시 자동 커밋
-
-태스크 하나가 완료되면:
-
-```bash
-git add .
-git commit -m "{type}(#{issue}): {task-description}"
-```
-
-> `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
-
-### 4. Feature 완료 시 PR 생성
-
-모든 태스크 완료 시:
-
-```bash
-git push origin feat/{issue-number}-{feature-name}
-gh pr create --title "feat(#{issue}): {feature-title}" \
-  --body "Closes #{issue}" \
-  --base main
-```
-
-### 5. 머지
-
-모든 리뷰 해결 시:
-
-```bash
-# 머지 전 main 최신화
-git checkout main
-git pull
-
-# Squash and Merge
-gh pr merge --squash --delete-branch
-
-# 머지 후 main 최신화
-git pull
-```
-
----
-
-## 에이전트 자동화 규칙
-
-### 태스크 완료 시
-
-```
-1. 코드 변경 완료
-2. tasks.md 상태 [DOING] → [DONE] 업데이트 (docs)
-3. git add .
-4. git commit -m "{type}(#{issue}): {description}"
-5. 다음 태스크 진행
-```
-
-### Feature 완료 시
-
-```
-1. 모든 태스크 [DONE] 확인
-2. git push origin {branch}
-3. gh pr create
-4. 리뷰 대기
-5. 리뷰 코멘트 수정
-6. gh pr merge --squash
-```
-
----
-
-## GitHub 설정 요구사항
-
-### 필수
-
-- [ ] GitHub CLI (`gh`) 설치 및 인증
-- [ ] Branch protection rules (main)
-  - Require PR before merging
-
-### 권장
-
-- [ ] Auto-delete head branches
-- [ ] Squash merging only

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

@@ -1,114 +0,0 @@
-# GitHub Issue 템플릿 가이드
-
-에이전트가 GitHub Issue를 생성할 때 참조하는 템플릿입니다.
-
----
-
-## 이슈 생성 규칙
-
-### 제목 형식
-
-```text
-F{번호}: {기능명} ({짧은 설명})
-```
-
-예: `F001: user-auth (사용자 인증 기능)`
-
-> "짧은 설명"은 한 줄로 의도를 전달할 수 있을 정도로만 작성합니다.
-
-### 링크 형식 (중요!)
-
-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에서 클릭되지 않으므로, 링크 대신 경로 텍스트만 제공합니다.
-
----
-
-## 이슈 본문 템플릿
-
-```markdown
-## 개요
-
-{기능에 대한 간략한 설명}
-
-## 목표
-
-- {목표 1}
-- {목표 2}
-
-## 완료 조건
-
-- [ ] {조건 1}
-- [ ] {조건 2}
-
-## 관련 문서
-
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
-
-## 라벨
-
-- `enhancement` (새 기능)
-- `bug` (버그 수정)
-- `documentation` (문서)
-```
-
----
-
-## 라벨 규칙
-
-| 라벨            | 용도          |
-| --------------- | ------------- |
-| `enhancement`   | 새 기능       |
-| `bug`           | 버그 수정     |
-| `documentation` | 문서 작업     |
-| `backend`       | BE 관련       |
-| `frontend`      | FE 관련       |
-| `priority:high` | 높은 우선순위 |
-
-> ⚠️ 라벨이 존재하지 않으면 먼저 생성합니다:
->
-> ```bash
-> gh label create "라벨명" --description "설명" --color "색상코드"
-> ```
-
----
-
-## Assignee 규칙
-
-- 기본값: 본인 할당 (`--assignee @me`)
-- 다른 담당자 지정 시 **사용자에게 확인** 후 진행
-- 예시:
-  ```bash
-  gh issue create --assignee @me ...
-  gh issue create --assignee username ...
-  ```
-
----
-
-## 본문 입력 규칙 (셸 실행 방지)
-
-- 이슈 본문은 **`--body-file` 사용을 기본**으로 한다.
-- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
-- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
-  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.

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

@@ -1,110 +0,0 @@
-# GitHub PR 템플릿 가이드
-
-에이전트가 Pull Request를 생성할 때 참조하는 템플릿입니다.
-
----
-
-## PR 생성 규칙
-
-### 제목 형식
-
-```text
-feat(#{이슈번호}): {기능명}
-```
-
-예: `feat(#1): 사용자 인증 구현`
-
-### 링크 형식 (중요!)
-
-PR 본문에서 레포 내 파일 링크는 **반드시 현재 브랜치명을 사용**:
-
-```markdown
-[파일명](https://github.com/{owner}/{repo}/blob/{브랜치명}/docs/path/to/file.md)
-```
-
-> ⚠️ `main` 브랜치 링크는 머지 전까지 404가 발생합니다!
-> 반드시 **현재 피처 브랜치명** (예: `feat/5-feature-name`)을 사용하세요.
-
-## PR 본문 템플릿
-
-```markdown
-## 개요
-
-{변경 사항에 대한 간략한 설명}
-
-## 변경 사항
-
-- {변경 1}
-- {변경 2}
-- {변경 3}
-
-## 테스트
-
-- [ ] 유닛 테스트 통과
-- [ ] 통합 테스트 완료
-
-## 스크린샷 (UI 변경 시)
-
-{있으면 첨부}
-
-## 관련 문서
-
-- Spec: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
-- Tasks: `docs/features/{be|fe}/F{번호}-{기능명}/tasks.md`
-
-Closes #{이슈번호}
-```
-
----
-
-## PR 생성 명령어
-
-```bash
-# 현재 브랜치명 확인
-BRANCH=$(git branch --show-current)
-
-gh pr create \
-  --title "feat(#{issue}): {기능명}" \
-  --body-file /tmp/pr-body.md \
-  --base main
-```
-
----
-
-## 머지 규칙
-
-| 상황         | 머지 방식         |
-| ------------ | ----------------- |
-| 일반 Feature | Squash and Merge  |
-| 긴급 Hotfix  | Merge 또는 Rebase |
-| 문서 수정    | Squash and Merge  |
-
----
-
-## 라벨 규칙
-
-- PR 생성 시 적절한 라벨 지정 (`--label`)
-- 라벨이 존재하지 않으면 먼저 생성:
-  ```bash
-  gh label create "라벨명" --description "설명" --color "색상코드"
-  ```
-
----
-
-## Assignee 규칙
-
-- 기본값: 본인 할당 (`--assignee @me`)
-- 리뷰어 지정 시 `--reviewer` 옵션 사용
-- 예시:
-  ```bash
-  gh pr create --assignee @me --reviewer reviewer-username ...
-  ```
-
----
-
-## 본문 입력 규칙 (셸 실행 방지)
-
-- PR 본문은 **`--body-file` 사용을 기본**으로 한다.
-- 백틱(`)이나 `$()`가 포함된 본문을 `"..."`에 직접 넣으면 **셸에서 명령치환**될 수 있다.
-- 여러 줄 본문은 `cat <<'EOF'` 형식의 **싱글 쿼트 heredoc**을 사용하고,
-  필요한 변수는 **플레이스홀더 → sed 치환**으로 처리한다.