lee-spec-kit 0.6.14 → 0.6.16

package/README.en.md

@@ -56,6 +56,44 @@ npx lee-spec-kit status
 npx lee-spec-kit doctor
 ```
 
+## New Project Start Order
+
+For a brand-new project, scaffold the **codebase first**, then initialize docs.
+This sequence assumes the default `docsRepo: embedded` mode.
+
+```bash
+# 0) Create/init the code project first (example: Next.js)
+npx create-next-app@latest my-app
+cd my-app
+
+# 1) Initialize docs structure
+npx lee-spec-kit init
+
+# 2) Detect project (agent entrypoint)
+npx lee-spec-kit detect --json
+
+# 3) Create feature and start workflow
+npx lee-spec-kit feature user-auth
+npx lee-spec-kit context --json
+```
+
+- Apply lee-spec-kit workflow only when `detect --json` returns `isLeeSpecKitProject: true`.
+- If `isLeeSpecKitProject: false`, continue with normal non-lee-spec-kit workflow.
+- If you use `standalone` docs, run commands against the docs repo location (`--dir` or `LEE_SPEC_KIT_DOCS_DIR`).
+
+## Agent Kickoff Prompt
+
+You can paste the following as an agent session-start instruction.
+
+```text
+Start procedure:
+1) Run npx lee-spec-kit detect --json
+2) If isLeeSpecKitProject === true, run npx lee-spec-kit context --json
+3) If actionOptions exist, show approvalPrompt and finalPrompt exactly as provided, then wait for user approval (<LABEL> or <LABEL> OK)
+4) Do not execute before approval; execute requiresUserCheck=true actions only after approval
+5) If isLeeSpecKitProject === false, skip lee-spec-kit-specific flow and continue with normal workflow
+```
+
 ## Features
 
 ### 📁 Project initialization
@@ -472,7 +510,8 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
 - `workflow.prePrReview`:
   - `enabled` (optional): enforce pre-PR review stage (default: same as `requirePr`)
   - `skills` (optional): preferred skill names in priority order (default: `["code-review-excellence"]`)
-  - `fallback` (optional): fallback policy when no skill can run (default: `"builtin-checklist"`)
+  - `fallback` (optional): baseline review policy (default: `"builtin-checklist"`)
+    - Use the `Pre-PR Baseline Checklist` section in `docs get create-pr --json` as the single source of truth
   - `blockOnFindings` (optional): require major findings to be resolved/aligned before PR creation (default: `true`)
   - `minorPolicy` (optional): minor findings policy (`warn` | `block`, default: `warn`)
 

package/README.md

@@ -37,6 +37,8 @@
 ## 목차
 
 - [Quick Start](#quick-start)
+- [신규 프로젝트 시작 순서](#신규-프로젝트-시작-순서)
+- [에이전트 킥오프 프롬프트](#에이전트-킥오프-프롬프트)
 - [주요 기능](#주요-기능)
 - [사용법](#사용법)
 - [설정 파일](#설정-파일)
@@ -69,6 +71,44 @@ npx lee-spec-kit status
 npx lee-spec-kit doctor
 ```
 
+## 신규 프로젝트 시작 순서
+
+신규 프로젝트에서는 **코드 스캐폴딩을 먼저** 하고, 그 다음 docs를 초기화하세요.
+이 순서는 기본값인 `docsRepo: embedded` 기준입니다.
+
+```bash
+# 0. 코드 프로젝트 생성/초기화 (예: Next.js)
+npx create-next-app@latest my-app
+cd my-app
+
+# 1. docs 구조 초기화
+npx lee-spec-kit init
+
+# 2. 감지 확인 (에이전트 시작점)
+npx lee-spec-kit detect --json
+
+# 3. Feature 생성 후 작업 시작
+npx lee-spec-kit feature user-auth
+npx lee-spec-kit context --json
+```
+
+- `detect --json` 결과가 `isLeeSpecKitProject: true`일 때 lee-spec-kit 워크플로우를 적용하세요.
+- `isLeeSpecKitProject: false`면 일반 프로젝트 워크플로우로 진행하세요.
+- `standalone`으로 docs를 분리한 경우에는 docs 레포 위치(`--dir` 또는 `LEE_SPEC_KIT_DOCS_DIR`) 기준으로 실행하세요.
+
+## 에이전트 킥오프 프롬프트
+
+아래 프롬프트를 에이전트 시작 메시지로 그대로 사용할 수 있습니다.
+
+```text
+작업 시작 절차:
+1) npx lee-spec-kit detect --json
+2) isLeeSpecKitProject === true 이면 npx lee-spec-kit context --json 실행
+3) actionOptions가 있으면 approvalPrompt와 finalPrompt를 그대로 사용자에게 제시하고 승인(<LABEL> 또는 <LABEL> OK) 대기
+4) 승인 전에는 실행하지 말고, requiresUserCheck=true 액션은 승인 후에만 실행
+5) isLeeSpecKitProject === false 이면 lee-spec-kit 전용 절차를 건너뛰고 일반 워크플로우로 진행
+```
+
 ## 주요 기능
 
 ### 📁 프로젝트 초기화
@@ -518,7 +558,8 @@ npx lee-spec-kit update --force
 - `workflow.prePrReview`:
   - `enabled` (선택): pre-PR 리뷰 단계를 강제할지 여부 (기본: `requirePr`와 동일)
   - `skills` (선택): 우선순위 스킬 목록 (기본: `["code-review-excellence"]`)
-  - `fallback` (선택): 스킬 미사용 시 폴백 정책 (기본: `"builtin-checklist"`)
+  - `fallback` (선택): 기본 베이스라인 정책 (기본: `"builtin-checklist"`)
+    - 상세 기준은 `docs get create-pr --json`의 `Pre-PR 기본 체크리스트` 섹션을 단일 기준으로 사용
   - `blockOnFindings` (선택): 주요 이슈 발견 시 PR 생성 전 해결/합의를 요구할지 여부 (기본: `true`)
   - `minorPolicy` (선택): minor 이슈 정책 (`warn` | `block`, 기본: `warn`)