lee-spec-kit 0.1.0

package/templates/en/single/agents/agents.md

@@ -0,0 +1,74 @@
+# Agents Guide
+
+Operating rules for AI code assistants to perform consistent code generation and refactoring.
+
+---
+
+## Reference Documents
+
+### Core Documents
+
+- **Project Principles**: `/docs/agents/constitution.md`
+- **Git Workflow**: `/docs/agents/git-workflow.md`
+- **Issue Template**: `/docs/agents/issue-template.md`
+- **PR Template**: `/docs/agents/pr-template.md`
+
+### Features
+
+- **Feature Docs**: `/docs/features/{feature-id}/`
+- **Template (SSOT)**: `/docs/features/feature-base/`
+
+---
+
+## 📁 Standard docs Structure
+
+```
+docs/
+├── README.md
+├── agents/
+│   ├── agents.md
+│   ├── constitution.md
+│   ├── git-workflow.md
+│   ├── issue-template.md
+│   └── pr-template.md
+├── prd/
+├── features/
+│   ├── feature-base/
+│   └── F00X-{name}/
+└── scripts/
+```
+
+---
+
+## Request Type Processes
+
+### 1. New Feature Request
+
+1. Create feature folder: `lee-spec-kit feature <name>`
+2. Write `spec.md` - what and why
+3. Request spec review
+4. Create GitHub Issue
+
+### 2. Task Execution
+
+1. Write tasks in `tasks.md`
+2. Execute after approval
+3. Status transition: `[TODO]` → `[DOING]` → `[DONE]`
+4. Commit on task completion
+
+---
+
+## 📋 ADR (Architecture Decision Records)
+
+> `decisions.md` is a **required** document for recording technical decisions.
+
+### Format
+
+```markdown
+## D{number}: {Decision Title} ({YYYY-MM-DD})
+
+- **Context**: Problem situation or background
+- **Options**: Alternatives considered
+- **Decision**: Final choice
+- **Rationale**: Reason for choice
+```

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

@@ -0,0 +1,75 @@
+# {{projectName}} Constitution
+
+프로젝트의 핵심 원칙과 기술 결정 가이드라인입니다.
+모든 개발 결정은 이 문서를 기준으로 합니다.
+
+---
+
+## 프로젝트 미션
+
+> (프로젝트의 미션을 작성하세요)
+
+---
+
+## 기술 스택
+
+### Backend
+
+| 기술         | 버전   | 이유        |
+| ------------ | ------ | ----------- |
+| (예: NestJS) | (버전) | (선택 이유) |
+
+### Frontend
+
+| 기술        | 버전   | 이유        |
+| ----------- | ------ | ----------- |
+| (예: React) | (버전) | (선택 이유) |
+
+### 공통
+
+| 기술              | 버전   | 이유        |
+| ----------------- | ------ | ----------- |
+| TypeScript        | strict | 타입 안전성 |
+| ESLint + Prettier | -      | 코드 품질   |
+| pnpm              | -      | 패키지 관리 |
+
+---
+
+## 아키텍처 원칙
+
+### 1. Feature 중심 관리
+
+- 새 기능은 `docs/features/F00X/` 구조로 관리
+- FE/BE 분리하여 **기능 단위**로 개발
+- spec → plan → tasks → decisions 워크플로우
+
+### 2. (추가 원칙)
+
+(프로젝트별 아키텍처 원칙을 작성하세요)
+
+---
+
+## 코드 품질 기준
+
+- TypeScript strict mode 필수
+- ESLint + Prettier 필수
+- 주요 비즈니스 로직 테스트 커버리지 **80%+**
+- 컴포넌트는 **단일 책임 원칙**
+- 중복 코드 최소화
+
+---
+
+## 보안 원칙
+
+- 환경 변수로 시크릿 관리 (저장소 커밋 금지)
+- 사용자 데이터 **최소 수집**
+- CORS는 허용 오리진만 설정
+
+---
+
+## 언어/코드 규칙
+
+- **답변**: 한국어
+- **코드/파일명**: 영어
+- **주석/커밋**: 한국어
+- **날짜/시간**: 사용자 PC 시스템 시간 기준 (예: `{{date}}`)

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

@@ -0,0 +1,157 @@
+# 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}(#{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. 태스크 완료 시 자동 커밋
+
+태스크 하나가 완료되면:
+
+```bash
+git add .
+git commit -m "{type}(#{issue}): {task-description}"
+```
+
+> `git commit` 실행 전 커밋 메시지와 포함될 파일 목록을 먼저 공유하고 **반드시** 사용자 확인(OK) 후 진행합니다.
+
+### 3. Feature 완료 시 PR 생성
+
+모든 태스크 완료 시:
+
+```bash
+git push origin feat/{issue-number}-{feature-name}
+gh pr create --title "feat(#{issue}): {feature-title}" \
+  --body "Closes #{issue}" \
+  --base main
+```
+
+### 4. 머지
+
+모든 리뷰 해결 시:
+
+```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/en/single/agents/issue-template.md

@@ -0,0 +1,60 @@
+# GitHub Issue 템플릿 가이드
+
+에이전트가 GitHub Issue를 생성할 때 참조하는 템플릿입니다.
+
+---
+
+## 이슈 생성 규칙
+
+### 제목 형식
+
+```text
+F{번호}: {기능명} ({짧은 설명})
+```
+
+예: `F001: user-auth (사용자 인증 기능)`
+
+> "짧은 설명"은 한 줄로 의도를 전달할 수 있을 정도로만 작성합니다.
+
+---
+
+## 이슈 본문 템플릿
+
+```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` | 높은 우선순위 |

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

@@ -0,0 +1,71 @@
+# GitHub PR 템플릿 가이드
+
+에이전트가 Pull Request를 생성할 때 참조하는 템플릿입니다.
+
+---
+
+## PR 생성 규칙
+
+### 제목 형식
+
+```text
+feat(#{이슈번호}): {기능명}
+```
+
+예: `feat(#1): 사용자 인증 구현`
+
+---
+
+## 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  |

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

@@ -0,0 +1,56 @@
+# Features Guide
+
+Folder for managing feature specs, plans, and tasks.
+
+---
+
+## Folder Structure
+
+```
+features/
+├── README.md           # This file
+├── feature-base/       # Shared template
+│   ├── spec.md
+│   ├── plan.md
+│   ├── tasks.md
+│   └── decisions.md
+└── F00X-{name}/        # Individual features
+```
+
+---
+
+## Creating New Features
+
+```bash
+lee-spec-kit feature user-auth
+```
+
+> 💡 CLI copies templates from `feature-base/` and auto-assigns IDs.
+
+---
+
+## Feature ID Rules
+
+- `F{number}-{feature-name}` (e.g., F001-user-auth)
+- Minimum **3-digit padding** for numbers
+- Feature names in kebab-case
+- **Feature = Issue**: Each Feature corresponds to one GitHub Issue
+
+---
+
+## Status Check
+
+```bash
+lee-spec-kit status
+```
+
+---
+
+## File Roles
+
+| File           | Role                      | When to Write       |
+| -------------- | ------------------------- | ------------------- |
+| `spec.md`      | **What and Why**          | Feature definition  |
+| `plan.md`      | **How** (technical)       | After spec approval |
+| `tasks.md`     | Work items                | After plan approval |
+| `decisions.md` | Technical decisions (ADR) | During development  |

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

@@ -0,0 +1,15 @@
+# Decisions Log
+
+Record technical decisions and their rationale.
+
+> Format: `D{number}: {Decision Title} ({YYYY-MM-DD})`
+
+---
+
+## D001: {Decision Title} ({YYYY-MM-DD})
+
+- **Context**: Problem situation or background
+- **Options**: Alternatives considered
+- **Decision**: Final choice
+- **Rationale**: Reason for choice
+- **Consequences**: Results and impact (optional)

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

@@ -0,0 +1,48 @@
+# Implementation Plan: {기능명}
+
+> Write after spec is approved.
+
+---
+
+## Overview
+
+- **Feature ID**: F{번호}
+- **Target Repo**: {{projectName}}
+- **Created**: YYYY-MM-DD
+- **Status**: Draft | Review | Approved
+
+---
+
+## Tech Stack
+
+| Category | Choice | Reason |
+| -------- | ------ | ------ |
+
+---
+
+## Architecture
+
+(Component structure, data flow)
+
+---
+
+## File Structure
+
+```
+src/
+├── ...
+```
+
+---
+
+## Test Strategy
+
+- **Unit Tests**:
+- **Integration Tests**:
+
+---
+
+## Related Documents
+
+- Spec: [spec.md](./spec.md)
+- Decisions: [decisions.md](./decisions.md)

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

@@ -0,0 +1,55 @@
+# Feature Spec: {기능명}
+
+> Tech stack is covered in plan.md.
+
+---
+
+## Overview
+
+- **Feature ID**: F{번호}
+- **Feature Name**: {기능명}
+- **Target Repo**: {{projectName}}
+- **Issue Number**: #{이슈번호}
+- **Created**: YYYY-MM-DD
+- **Status**: Draft | Review | Approved
+
+---
+
+## Purpose
+
+(Why is this feature needed? What problem does it solve?)
+
+---
+
+## User Stories
+
+### US-1: {Story Title}
+
+**As a** {user type}
+**I want** {desired action}
+**So that** {reason/value}
+
+**Acceptance Criteria:**
+
+- [ ] (verification condition)
+
+---
+
+## Functional Requirements
+
+### FR-1: {Requirement Title}
+
+(Detailed description)
+
+---
+
+## Non-Functional Requirements
+
+- **Performance**:
+- **Security**:
+
+---
+
+## Related Documents
+
+- PRD: `../../prd/`

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

@@ -0,0 +1,33 @@
+# Tasks: {기능명}
+
+## Task Rules
+
+- **Status**: `[TODO]` → `[DOING]` → `[DONE]`
+- **Priority**: P0(urgent) > P1(high) > P2(medium) > P3(low)
+
+---
+
+## GitHub Issue
+
+- **Repo**: {{projectName}}
+- **Issue**: #{이슈번호}
+- **Branch**: `feat/{이슈번호}-{기능명}`
+
+---
+
+## Task List
+
+### Phase 1: {Phase Name}
+
+- [TODO][P1] T-F{번호}-01 {Task Title}
+  - Acceptance:
+    - (verification condition)
+  - Checklist:
+    - [ ] (subtask)
+
+---
+
+## Completion Criteria
+
+- [ ] All tasks [DONE]
+- [ ] All tests passing

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

@@ -0,0 +1,15 @@
+# PRD (Product Requirements Document)
+
+이 폴더에는 제품 요구사항 문서를 작성합니다.
+
+## 작성 가이드
+
+1. 프로젝트 개요와 목표를 정의하세요
+2. 주요 기능과 사용자 스토리를 작성하세요
+3. 기술 아키텍처 개요를 포함하세요
+
+## 예시 파일
+
+- `{project-name}-prd.md` - 메인 PRD 문서
+- `backend-overview.md` - 백엔드 아키텍처 (선택)
+- `frontend-overview.md` - 프론트엔드 아키텍처 (선택)

package/templates/ko/fullstack/README.md

@@ -0,0 +1,12 @@
+# {{projectName}} 문서 구조 가이드
+
+에이전트가 프로젝트 전반을 빠르게 파악할 수 있도록 문서를 기능별로 분리해 두었습니다.
+
+## 상위 구조 요약
+
+| 경로                | 목적                 | 핵심 문서/역할                                                |
+| ------------------- | -------------------- | ------------------------------------------------------------- |
+| `docs/agents/`      | 에이전트 운영 규칙   | `agents.md`, `constitution.md`, `git-workflow.md`             |
+| `docs/prd/`         | 제품 요구사항        | 프로젝트별 작성                                               |
+| `docs/features/be/` | Backend 기능별 문서  | `{feature-id}/spec.md`, `plan.md`, `tasks.md`, `decisions.md` |
+| `docs/features/fe/` | Frontend 기능별 문서 | `{feature-id}/spec.md`, `plan.md`, `tasks.md`, `decisions.md` |