lee-spec-kit 0.2.3 → 0.3.0

package/templates/ko/common/agents/skills/create-feature.md

@@ -1,75 +1,70 @@
-# 새 기능 추가 프로세스
+# 기능 구현 프로세스: CLI 주도형
 
-새 기능(Feature)을 추가할 때 따르는 단계별 가이드입니다.
+이 문서는 새 기능(Feature)을 추가할 때 따르는 **유일한 규칙**입니다.
+에이전트는 자신의 판단을 신뢰하지 않고, 오직 **CLI 도구의 지시**에 따라 행동합니다.
 
 ---
 
-## 단계
+## 🔄 The Loop (무한 반복)
 
-### 1. Feature 폴더 생성
+Feature 구현이 완료될 때까지(문서 커밋까지) 다음 과정을 **계속 반복**하세요.
 
-```bash
-npx lee-spec-kit feature <name> -d "<설명>"
-```
+### 1단계: 상태 확인
 
-- `<name>`: 기능 이름 (영문, 하이픈 사용)
-- `-d`: 기능 설명 (spec.md에 자동 반영)
-
-**예시:**
+작업을 시작하거나 한 단계를 마칠 때마다 **반드시** 아래 명령어를 실행합니다.
 
 ```bash
-npx lee-spec-kit feature user-auth -d "사용자 인증 및 세션 관리"
+npx lee-spec-kit context
 ```
 
-### 2. spec.md 작성
-
-- **무엇을**: 기능이 무엇인지 명확히 기술
-- **왜**: 이 기능이 필요한 이유
-- ❌ 기술 스택은 작성하지 않음 (plan.md에서 다룸)
+### 2단계: 지시 수행 (Next Action)
 
-### 3. 사용자 확인 요청
+CLI가 출력하는 **`👉 Next Action` 메시지를 읽고, 그 지시만 정확히 수행**합니다.
 
-> 🚨 **사용자 확인 필수**
+- **승인 대기(Review)** 상태라면 사용자에게 공유하고 멈춥니다.
+- CLI가 파일 작성을 지시하면 해당 파일을 작성합니다.
+- CLI가 이슈 생성을 지시하면 이슈를 생성합니다.
+- CLI가 명령어를 출력하면 **그대로 복사해 실행**합니다. (standalone 환경에서도 레포 경로가 포함될 수 있습니다)
 
-spec.md 전문을 사용자에게 공유하고 **명시적 승인(OK)** 대기
+### 3단계: 반복
 
-### 4. GitHub Issue 생성
+지시된 행동을 완료했다면, **즉시 1단계로 돌아가** 다시 `context`를 확인합니다.
 
-→ `skills/create-issue.md` 참조
+---
 
-### 5. 브랜치 생성
+## 🛑 절대 금지 사항 (Strict Rules)
 
-```bash
-git checkout -b feat/{이슈번호}-{기능명}
-```
+1. **앞서가지 않기**: CLI가 "Spec 작성"을 지시했는데 "Plan 작성"까지 한 번에 하지 마세요.
+2. **건너뛰지 않기**: "이슈 생성" 단계를 귀찮아서 생략하거나 가짜 번호를 넣지 마세요.
+3. **스스로 판단 금지**: "이 정도면 됐겠지?"라고 생각하지 말고 CLI에게 물어보세요.
 
-> ⚠️ **main 브랜치에서 작업하지 마세요.** Issue 생성 후 반드시 브랜치를 생성합니다.
+---
 
-### 6. 문서 커밋 전 확인
+## 참조: CLI가 안내하는 10단계 (참조용)
 
-> ⚠️ **커밋 전 체크리스트**
+> ⚠️ 이 단계를 외워서 실행하지 마세요. **참조용**일 뿐입니다. 항상 CLI를 믿으세요.
 
-- [ ] spec.md에 이슈번호 반영 (`- **이슈 번호**: #{이슈번호}`)
-- [ ] tasks.md에 이슈번호 반영 (`- **Issue**: #{이슈번호}`)
-- [ ] tasks.md에 브랜치명 반영 (`feat/{이슈번호}-{기능명}`)
+1. **Feature 폴더 생성**: `npx lee-spec-kit feature ...`
+2. **spec.md 작성**: 기능 정의 (Status: Draft)
+3. **spec.md 승인**: 사용자 검토 및 승인 (Status: Approved)
+4. **GitHub Issue 생성**: 이슈 번호 발급
+5. **브랜치 생성**: `git checkout -b feat/...`
+6. **plan.md 작성**: 구현 계획 (Status: Draft)
+7. **plan.md 승인**: 사용자 검토 및 승인 (Status: Approved)
+8. **tasks.md 작성/실행**: 태스크 분해 및 진행
+9. **문서 커밋 전 확인**: 최종 점검
+10. **문서 커밋**: Docs Sync
 
-### 7. 문서 커밋
+---
 
-> 🚨 **사용자 확인 필수**
+## 시작하기
 
-spec/plan/tasks 승인 후 **Feature 폴더 전체**를 커밋:
+아직 기능 폴더가 없다면, 먼저 폴더를 생성하고 루프를 시작하세요:
 
 ```bash
-git add docs/features/{be|fe}/F{번호}-{기능명}/
-git commit -m "docs(#{이슈번호}): F{번호} 계획 완료"
-```
-
-> 📁 **포함 파일**: spec.md, plan.md, tasks.md, decisions.md (비어있어도 포함)
-> ⚠️ **Standalone 모드**: Docs 레포로 이동 후 커밋하세요.
-
----
-
-## 참조 문서
+# 1. 생성
+npx lee-spec-kit feature <name> -d "<설명>"
 
-- **Feature 템플릿**: `features/feature-base/`
-- **Issue 생성 가이드**: `skills/create-issue.md`
+# 2. 루프 진입
+npx lee-spec-kit context
+```

package/templates/ko/common/agents/skills/create-pr.md

@@ -7,6 +7,7 @@ Pull Request를 생성할 때 따르는 가이드입니다.
 ## 사전 조건
 
 - [ ] 모든 태스크 `[DONE]` 상태
+- [ ] `tasks.md`의 "완료 조건" 체크리스트 모두 체크
 - [ ] 변경 사항 커밋 완료
 - [ ] 브랜치 푸시 완료
 

package/templates/ko/common/agents/skills/execute-task.md

@@ -1,94 +1,60 @@
-# 태스크 실행 프로세스
+# 태스크 실행 프로세스: CLI 주도형
 
-tasks.md의 태스크를 실행할 때 따르는 가이드입니다.
+기능 구현(tasks.md) 단계에서 태스크를 하나씩 실행할 때 따르는 가이드입니다.
+에이전트는 자신의 판단을 신뢰하지 않고, 오직 **CLI 도구의 지시**에 따라 행동합니다.
 
 ---
 
-## 단계
+## 🔄 The Execution Loop (실행 반복)
 
-### 1. 태스크 확인
+모든 태스크가 완료될 때까지(`[DONE]`) 다음 과정을 **계속 반복**하세요.
 
-- `tasks.md`에서 다음 실행할 태스크 확인
-- 상태가 `[TODO]`인 태스크 선택
-- ⚠️ **현재 브랜치가 해당 Feature 브랜치인지 확인** (`feat/{이슈번호}-{기능명}`)
+### 1단계: 할 일 확인 (Check)
 
-### 2. 실행 계획 공유
-
-> 🚨 **사용자 확인 필수**
-
-태스크 시작 전 실행 계획을 사용자에게 공유하고 승인 대기
-
-### 3. 상태 전환
-
-| 시점           | 상태 전환            |
-| -------------- | -------------------- |
-| 시작 시        | `[TODO]` → `[DOING]` |
-| 사용자 승인 후 | `[DOING]` → `[DONE]` |
-
-> ⚠️ 작업이 완료되어도 **사용자 승인 전까지는 `[DOING]` 상태 유지**
-
-상태 전환 시 날짜도 함께 기록 (YYYY-MM-DD)
-
-### 4. 태스크 완료 후 커밋 (Docs Sync)
-
-> 🚨 **사용자 확인 필수**
-
-커밋 생성 전 다음 내용을 공유하고 승인 대기:
-
-- 커밋 메시지 (해당되는 레포지토리)
-- 포함될 파일 목록
+작업을 시작하거나 하나를 마칠 때마다 **반드시** 아래 명령어를 실행합니다.
 
 ```bash
-# 1. Project 커밋 (코드 변경사항이 있는 경우)
-git add .
-git commit -m "{type}(#{이슈번호}): {태스크 설명}"
-
-# 2. Docs 커밋 (Docs 변경사항이 있는 경우)
-# Standalone 모드인 경우 Docs 레포로 이동하여 실행
-git add .
-git commit -m "docs(#{이슈번호}): {태스크 설명} 문서 업데이트"
+npx lee-spec-kit context
 ```
 
----
+### 2단계: 태스크 수행 (Action)
 
-## tasks.md에 없는 요청 처리
+CLI가 가리키는 **Active Task** 또는 **Next Action**을 수행합니다.
 
-사용자가 tasks.md에 없는 작업을 요청하면:
+- **[DOING] 상태인 태스크가 있다면**: 해당 태스크를 최우선으로 완료하세요.
+- **[DOING]이 없다면**: CLI가 추천하는 다음 태스크(`[TODO]`)를 시작(`[DOING]`)하세요.
+- **완료 조건(Acceptance)을 검증**하고, 테스트를 통과해야만 완료(`[DONE]`) 처리합니다.
+- CLI가 명령어를 출력하면 **그대로 복사해 실행**합니다. (standalone 환경에서도 레포 경로가 포함될 수 있습니다)
 
-1. tasks.md에 반영할지 사용자에게 확인
-2. 승인 시: tasks.md에 추가 후 실행
-3. 거부 시: 임시 작업으로 진행 (커밋에는 포함)
+### 3단계: 기록 및 반복 (Record & Loop)
 
----
+1. 작업이 끝나면 해당 태스크의 상태를 `[DONE]`으로 변경하고, `Acceptance/Checklist` 항목을 `[x]`로 체크합니다.
+2. 커밋을 생성합니다 (코드 커밋 + 문서 커밋).
+3. **즉시 1단계로 돌아가** 다음 할 일을 CLI에게 물어봅니다.
 
-## 🚨 완료된 태스크 수정 금지
+---
 
-> ⚠️ **`[DONE]` 상태의 태스크는 절대 수정하지 않습니다.**
+## 🛑 절대 금지 사항 (Strict Rules)
 
-### 원칙
+1. **병렬 처리 금지**: 한 번에 하나의 태스크만 `[DOING]`으로 만드세요.
+2. **임의 건너뛰기 금지**: CLI가 가리키는 순서대로 진행하세요.
+3. **완료된 태스크 수정 금지**: 이미 `[DONE]` 된 태스크는 절대 건드리지 마세요. 수정이 필요하면 새 태스크를 추가하세요.
 
-- 완료된 태스크는 **히스토리/기록 용도**로 보존
-- 수정이 필요한 경우 **새 태스크를 추가**하여 진행
+---
 
-### 수정이 필요한 경우
+## 참조: 태스크 상태 전환 규칙
 
-1. 기존 태스크는 그대로 유지
-2. 새 태스크를 추가: `T{다음번호}: {수정 내용}`
-3. 새 태스크에서 변경 작업 진행
+> ⚠️ 직접 판단하지 말고 CLI가 시키는 대로 하세요.
 
-**예시:**
+1. **[TODO] → [DOING]**: 작업 시작 시 표시
+2. **[DOING] → [DONE]**: 테스트 통과 및 사용자 승인 후 표시
 
 ```markdown
-## Tasks
-
-- [DONE] T001: 사용자 인증 구현 (2026-01-05)
-- [DONE] T002: 로그인 페이지 작성 (2026-01-06)
-- [TODO] T003: T002 수정 - 비밀번호 유효성 검사 추가 ← 수정 필요 시 새 태스크 추가
+- [DONE] T-01: 로그인 UI (완료됨)
+- [DOING] T-02: API 연동 (현재 작업 중)
+- [TODO] T-03: 에러 처리 (대기 중)
 ```
 
----
-
-## 참조 문서
+## 비상시 대처 (Emergency)
 
-- **Git 워크플로우**: `git-workflow.md`
-- **커밋 컨벤션**: `git-workflow.md` > "커밋 컨벤션" 섹션
+만약 CLI가 이상한 태스크를 가리키거나 멈춘다면, 사용자가 직접 `tasks.md`를 수동으로 수정하도록 요청하세요. 에이전트가 임의로 판단하지 마세요.

package/templates/ko/common/designs/README.md

@@ -0,0 +1,29 @@
+# Designs
+
+프로젝트에서 참고할 디자인 리소스를 모아두는 폴더입니다.
+
+(예: Figma 링크, 참고 화면, 디자인 시스템 규칙, UI 가이드)
+
+---
+
+## 포함 대상
+
+- 화면/플로우 참고 자료 (Figma, 이미지, 링크)
+- 컴포넌트/패턴 가이드 (버튼, 폼, 네비게이션 등)
+- 브랜드/타이포/컬러 토큰 등 UI 규칙
+
+---
+
+## 작성 규칙
+
+- 외부 링크는 가능한 한 **원본 URL + 요약(또는 캡처)**를 함께 남깁니다.
+- 파일명은 kebab-case 사용 (예: `auth-flow.md`, `design-system.md`)
+- 이미지/첨부 파일이 필요하면 `assets/` 폴더를 생성하여 관리합니다.
+
+---
+
+## 참조 방법
+
+Feature 문서에서 디자인을 참조할 때는 상대경로보다 **프로젝트 루트 기준 경로**를 권장합니다.
+
+- 예: `docs/designs/auth-flow.md`

package/templates/ko/common/ideas/README.md

@@ -0,0 +1,30 @@
+# Ideas
+
+Feature로 발전하기 전의 아이디어 / To-do / 실험 기록을 모아두는 폴더입니다.
+
+핵심 원칙: **Feature로 승격되면 SSOT는 `docs/features/`로 이동**합니다.
+
+---
+
+## 작성 규칙
+
+- 1 아이디어 = 1 파일 (kebab-case 권장)
+  - 예: `login-rate-limit.md`
+  - 예: `admin-dashboard-metrics.md`
+- 상단에 최소한 아래 메타 정보를 둡니다:
+  - 목적/배경
+  - 대략 범위(뭘 할지/안 할지)
+  - 대상 레포(필요 시): `be` / `fe` / `both`
+
+---
+
+## 승격/정리 규칙 (Idea → Feature)
+
+1. `npx lee-spec-kit feature <name>`로 Feature 폴더 생성
+2. 새 Feature의 `spec.md` 또는 `tasks.md`에 아이디어 문서 경로를 남깁니다
+   - 예: `docs/ideas/login-rate-limit.md`
+3. 아이디어 문서는 **목록에서 제거**합니다 (둘 중 하나 선택):
+   - **권장**: `docs/ideas/archive/`로 이동 후 상단에 `Status: Converted`, `Feature: F00X-...` 기록
+   - 또는: 완전히 삭제 (히스토리가 필요 없을 때만)
+
+> 💡 완전 삭제 대신 archive를 권장합니다: “왜 이 Feature가 생겼는지” 추적에 도움이 됩니다.

package/templates/ko/fullstack/README.md

@@ -8,5 +8,50 @@
 | ------------------- | -------------------- | ------------------------------------------------------------- |
 | `docs/agents/`      | 에이전트 운영 규칙   | `agents.md`, `constitution.md`, `git-workflow.md`             |
 | `docs/prd/`         | 제품 요구사항        | 프로젝트별 작성                                               |
+| `docs/designs/`     | 디자인 참고 자료     | `README.md` (링크/가이드/레퍼런스)                            |
+| `docs/ideas/`       | 아이디어/To-do        | `README.md` (Idea → Feature 승격 규칙)                        |
 | `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` |
+
+---
+
+## CLI 설정 파일 (`.lee-spec-kit.json`)
+
+`lee-spec-kit init`을 실행하면 문서 루트(기본: `docs/`)에 `.lee-spec-kit.json`이 생성됩니다.
+
+- `lee-spec-kit feature`, `status`, `update`에서 문서 위치/프로젝트 타입/언어를 감지하는 용도로 사용됩니다.
+- `docsRepo`, `pushDocs`, `docsRemote`는 `/docs/agents/git-workflow.md`의 **Docs Push 규칙**을 위한 메타데이터입니다. (자동 push는 하지 않습니다)
+
+### 필드
+
+- `projectName` (string): 프로젝트 이름
+- `projectType` ("single" | "fullstack"): 프로젝트 타입
+- `lang` ("ko" | "en"): 문서 언어
+- `createdAt` (string, YYYY-MM-DD): 생성 날짜
+- `docsRepo` ("embedded" | "standalone"): Docs 관리 방식
+- `pushDocs` (boolean, optional): `docsRepo: "standalone"`일 때만 생성 (원격 push 여부)
+- `docsRemote` (string, optional): `pushDocs: true`일 때만 생성 (원격 레포 URL)
+
+### 예시
+
+```json
+{
+  "projectName": "{{projectName}}",
+  "projectType": "fullstack",
+  "lang": "ko",
+  "createdAt": "{{date}}",
+  "docsRepo": "embedded"
+}
+```
+
+```json
+{
+  "projectName": "{{projectName}}",
+  "projectType": "fullstack",
+  "lang": "ko",
+  "createdAt": "{{date}}",
+  "docsRepo": "standalone",
+  "pushDocs": true,
+  "docsRemote": "git@github.com:org/{{projectName}}-docs.git"
+}
+```

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

@@ -33,6 +33,8 @@
 
 ### 핵심 문서
 
+> 🚨 **반드시 핵심 문서를 모두 읽고 이해한 후에만 작업을 진행합니다.**
+
 > ⚠️ **`custom.md`의 규칙은 다른 모든 규칙보다 우선합니다.**
 
 - **🔴 커스텀 규칙 (최우선)**: `/docs/agents/custom.md`
@@ -70,6 +72,8 @@ docs/
 │       ├── create-pr.md
 │       └── execute-task.md
 ├── prd/                # 제품 요구사항
+├── designs/            # 디자인 참고 자료
+├── ideas/              # 아이디어/To-do (Feature 승격 전)
 ├── features/           # 기능별 문서
 │   ├── be/             # Backend Features
 │   │   └── F00X-{name}/

package/templates/ko/fullstack/features/feature-base/tasks.md

@@ -29,5 +29,12 @@
 
 ## 완료 조건
 
-- [ ] 모든 태스크 [DONE]
-- [ ] 모든 테스트 통과
+> ⚠️ 아래 항목은 **최종 확인 체크리스트**입니다. 실제로 확인/실행한 뒤에만 체크하세요.
+
+- [ ] 모든 태스크가 `[DONE]`이며, 각 태스크의 `Acceptance` 검증 및 `Checklist` 체크 완료
+- [ ] 테스트 실행 및 통과 (아래에 명령어/결과 기록)
+
+### 테스트 실행 기록
+
+- 명령어: `{실행한 테스트 명령어}`
+- 결과: `{PASS/FAIL 요약}`

package/templates/ko/single/README.md

@@ -8,4 +8,49 @@
 | ---------------- | ------------------ | ------------------------------------------------------------- |
 | `docs/agents/`   | 에이전트 운영 규칙 | `agents.md`, `constitution.md`, `git-workflow.md`             |
 | `docs/prd/`      | 제품 요구사항      | 프로젝트별 작성                                               |
+| `docs/designs/`  | 디자인 참고 자료   | `README.md` (링크/가이드/레퍼런스)                            |
+| `docs/ideas/`    | 아이디어/To-do      | `README.md` (Idea → Feature 승격 규칙)                        |
 | `docs/features/` | 기능별 문서        | `{feature-id}/spec.md`, `plan.md`, `tasks.md`, `decisions.md` |
+
+---
+
+## CLI 설정 파일 (`.lee-spec-kit.json`)
+
+`lee-spec-kit init`을 실행하면 문서 루트(기본: `docs/`)에 `.lee-spec-kit.json`이 생성됩니다.
+
+- `lee-spec-kit feature`, `status`, `update`에서 문서 위치/프로젝트 타입/언어를 감지하는 용도로 사용됩니다.
+- `docsRepo`, `pushDocs`, `docsRemote`는 `/docs/agents/git-workflow.md`의 **Docs Push 규칙**을 위한 메타데이터입니다. (자동 push는 하지 않습니다)
+
+### 필드
+
+- `projectName` (string): 프로젝트 이름
+- `projectType` ("single" | "fullstack"): 프로젝트 타입
+- `lang` ("ko" | "en"): 문서 언어
+- `createdAt` (string, YYYY-MM-DD): 생성 날짜
+- `docsRepo` ("embedded" | "standalone"): Docs 관리 방식
+- `pushDocs` (boolean, optional): `docsRepo: "standalone"`일 때만 생성 (원격 push 여부)
+- `docsRemote` (string, optional): `pushDocs: true`일 때만 생성 (원격 레포 URL)
+
+### 예시
+
+```json
+{
+  "projectName": "{{projectName}}",
+  "projectType": "single",
+  "lang": "ko",
+  "createdAt": "{{date}}",
+  "docsRepo": "embedded"
+}
+```
+
+```json
+{
+  "projectName": "{{projectName}}",
+  "projectType": "single",
+  "lang": "ko",
+  "createdAt": "{{date}}",
+  "docsRepo": "standalone",
+  "pushDocs": true,
+  "docsRemote": "git@github.com:org/{{projectName}}-docs.git"
+}
+```

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

@@ -33,6 +33,8 @@
 
 ### 핵심 문서
 
+> 🚨 **반드시 핵심 문서를 모두 읽고 이해한 후에만 작업을 진행합니다.**
+
 > ⚠️ **`custom.md`의 규칙은 다른 모든 규칙보다 우선합니다.**
 
 - **🔴 커스텀 규칙 (최우선)**: `/docs/agents/custom.md`
@@ -69,6 +71,8 @@ docs/
 │       ├── create-pr.md
 │       └── execute-task.md
 ├── prd/                # 제품 요구사항
+├── designs/            # 디자인 참고 자료
+├── ideas/              # 아이디어/To-do (Feature 승격 전)
 ├── features/           # 기능별 문서
 │   └── F00X-{name}/    # 개별 기능
 └── scripts/            # 유틸리티

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

@@ -29,5 +29,12 @@
 
 ## 완료 조건
 
-- [ ] 모든 태스크 [DONE]
-- [ ] 모든 테스트 통과
+> ⚠️ 아래 항목은 **최종 확인 체크리스트**입니다. 실제로 확인/실행한 뒤에만 체크하세요.
+
+- [ ] 모든 태스크가 `[DONE]`이며, 각 태스크의 `Acceptance` 검증 및 `Checklist` 체크 완료
+- [ ] 테스트 실행 및 통과 (아래에 명령어/결과 기록)
+
+### 테스트 실행 기록
+
+- 명령어: `{실행한 테스트 명령어}`
+- 결과: `{PASS/FAIL 요약}`