lee-spec-kit 0.6.23 → 0.6.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.6.23",
+  "version": "0.6.25",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {

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

@@ -22,9 +22,10 @@ Always run this checklist in Pre-PR review. Treat it as the minimum baseline, th
 2. Inspect regression, exception handling, critical/security risks, side effects, user flow impact, and release readiness.
 3. Check maintainability: split oversized functions/files when needed, reuse/integrate existing code where appropriate, and remove obsolete code.
 4. Run related test/verification commands (or explicitly record why they were not run).
-5. Update `Pre-PR Evidence` with concrete proof (review links, logs, or doc paths).
-6. Update `Pre-PR Decision` as `decision: ...` (or `결정: ...`) to capture key review decisions.
-7. Set `Pre-PR Review` to `Done` only after the checklist is completed.
+5. Run `npx lee-spec-kit pre-pr-review <feature-ref>` to generate review evidence and sync `Pre-PR Findings/Evidence/Decision`.
+6. `Pre-PR Evidence` should point to a real existing path. (default: `workflow.prePrReview.evidenceMode=path_required`)
+7. `Pre-PR Decision` must use `decision: approve|changes_requested|blocked ...` (or `결정: ...`).
+8. Ensure the final decision is `approve` before moving to PR creation.
 
 ---
 

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

@@ -20,7 +20,11 @@ npx lee-spec-kit context
 Execute exactly one option from `👉 Next Options (Atomic)` as printed by the CLI.
 
 - If the CLI points to an active task, focus on that task only.
-- Treat the task state/approval rules in `tasks.md` **"Task Rules"** as SSOT (e.g. when OK is required for `[TODO]→[DOING]`, `[DOING]→[DONE]`).
+- Treat task state transitions in `tasks.md` **"Task Rules"** as SSOT.
+- Treat `approvalRequest.required` from `context --json` as SSOT for approval waiting.
+  - `false`: continue without label approval.
+  - `true`: wait for label-token approval (`A`, `A OK`) before execution.
+- If `context --json` exposes `autoRun.available=true`, you may use `autoRun.command` to continue automatically until approval-required categories are reached.
 - If the CLI prints commands, copy/paste them. (In standalone setups commands may include `git -C ...` and scopes like `project`/`docs`.)
 - Follow user-facing response format (including the final status/label block in every reply) from `agents.md` **"Label Response Contract (SSOT)"**.
 - For approved command options, default to `npx lee-spec-kit flow <slug|F001|F001-slug> --approve <LABEL> --execute` and avoid split `context --approve` / `context --execute --ticket` runs across turns.
@@ -62,7 +66,7 @@ Use the feature’s `decisions.md` template format as final SSOT. (Context/Const
 ### Step 3.5: Commit per task (important)
 
 - Complete **only one task at a time** (do not batch-finish multiple tasks in one commit).
-- After you share the outcome/verification and get approval (OK), mark the task `[DONE]` (and update any checklist items), then create commits (code commit + docs commit) so each task has its own history.
+- After you share the outcome/verification, mark the task `[DONE]` (and update any checklist items). If approval is required (`approvalRequest.required=true`), wait for OK first. Then create commits (code commit + docs commit) so each task has its own history.
 - In `tasks.md` test logs, keep one entry per test command and update its date/result on reruns (do not keep appending duplicates). Use `YYYY-MM-DD` in local date.
 - If `context` shows `[CHECK required]`, for commits/push/merge, **share the commit message + included files and wait for explicit OK** before running the commands.
 - Once all tasks are `[DONE]`, share the "Completion Criteria" checklist with the user and get **final approval (OK)**, then check it (especially the **Final user approval (OK) received** item).

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

@@ -69,8 +69,9 @@ npx lee-spec-kit status --write
 | PR doc status | `Status` in `pr.md` | `Draft` \| `Ready` |
 | PR review status | `PR Status` in `tasks.md` | `Review` \| `Approved` |
 | Pre-PR review status | `Pre-PR Review` in `tasks.md` | `Pending` \| `Done` |
+| Pre-PR review findings | `Pre-PR Findings` in `tasks.md` | `major=<n>, minor=<n>` |
 | Pre-PR review evidence | `Pre-PR Evidence` in `tasks.md` | evidence link/log/doc path |
-| Pre-PR review decision | `Pre-PR Decision` in `tasks.md` | `decision: ...` (or `결정: ...`) |
+| Pre-PR review decision | `Pre-PR Decision` in `tasks.md` | `decision: approve\|changes_requested\|blocked ...` |
 | PR review evidence | `PR Review Evidence` in `tasks.md` | evidence link/log/doc path |
 | PR review decision | `PR Review Decision` in `tasks.md` | `decision: ...` (or `결정: ...`) |
 

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

@@ -24,10 +24,13 @@
 - **Pre-PR Review**: -
   - Values: Pending | Done
   - Mark `Done` after pre-PR review is completed
+- **Pre-PR Findings**: -
+  - Format: `major=<n>, minor=<n>`
 - **Pre-PR Evidence**: -
-  - Example: review note link, log path, or docs path
+  - Example: review report doc path (must exist)
 - **Pre-PR Decision**: -
-  - Record your key review decision as `decision: ...` (or `결정: ...`)
+  - Format: `decision: approve|changes_requested|blocked ...` (or `결정: ...`)
+  - PR creation requires final decision `approve`
   - Follow `agents/skills/create-pr.md` (`Pre-PR Baseline Checklist`) as the default baseline
 - **PR Review Evidence**: -
   - Example: resolved/aligned comment link, verification log, or docs path

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

@@ -22,9 +22,10 @@ Pre-PR 리뷰에서 항상 수행하는 최소 기준입니다. 가능한 경우
 2. 회귀/예외 처리, 크리티컬·보안 리스크, 사이드 이펙트, 사용자 흐름 영향, 배포 준비도를 점검합니다.
 3. 유지보수성을 점검합니다: 큰 함수/파일은 필요 시 분리하고, 기존 코드 재사용·통합 가능성을 확인하며, 불필요해진 코드를 정리합니다.
 4. 관련 테스트/검증 명령을 실행합니다. 실행하지 못했다면 사유를 명시합니다.
-5. `PR 전 리뷰 Evidence`에 실제 근거(리뷰 링크, 로그, 문서 경로)를 기록합니다.
-6. `PR 전 리뷰 Decision`을 `결정: ...`(또는 `decision: ...`) 형식으로 기록해 핵심 판단 근거를 남깁니다.
-7. 체크리스트 완료 후에만 `PR 전 리뷰`를 `Done`으로 변경합니다.
+5. `npx lee-spec-kit pre-pr-review <feature-ref>`를 실행해 리뷰 리포트를 생성하고 `PR 전 리뷰 Findings/Evidence/Decision`을 동기화합니다.
+6. `PR 전 리뷰 Evidence`는 실제 존재하는 문서 경로를 사용합니다. (`workflow.prePrReview.evidenceMode=path_required` 기본)
+7. `PR 전 리뷰 Decision`은 `결정: approve|changes_requested|blocked ...` (또는 `decision: ...`) 형식을 사용합니다.
+8. PR 생성 단계로 이동하기 전 최종 Decision이 `approve`인지 확인합니다.
 
 ---
 

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

@@ -22,7 +22,9 @@ npx lee-spec-kit context
 CLI가 가리키는 **Active Task** 또는 **`👉 Next Options (Atomic)`의 단일 옵션**을 수행합니다.
 
 - **[DOING] 상태인 태스크가 있다면**: 해당 태스크를 최우선으로 완료하세요.
-- 태스크 상태 전환/승인 규칙은 `tasks.md`의 **"태스크 규칙"** 섹션을 SSOT로 따릅니다. (예: `[TODO]→[DOING]`, `[DOING]→[DONE]` 시점의 OK)
+- 태스크 상태 전환 규칙은 `tasks.md`의 **"태스크 규칙"** 섹션을 SSOT로 따릅니다.
+- 승인 대기 여부는 `context --json`의 `approvalRequest.required`를 SSOT로 따릅니다. `false`면 라벨 승인 없이 진행하고, `true`면 라벨 규칙(`A`, `A OK`)으로 승인 후 진행합니다.
+- `context --json`에 `autoRun.available=true`가 있으면 `autoRun.command`를 사용해 승인 필요 카테고리 전까지 자동 진행할 수 있습니다.
 - CLI가 명령어를 출력하면 **그대로 복사해 실행**합니다. (standalone 환경에서도 레포 경로가 포함될 수 있습니다)
 - 사용자 응답 포맷(매 응답 말미의 상태/라벨 표시 포함)은 `agents.md`의 **"라벨 응답 계약 (SSOT)"** 을 따릅니다.
 - 승인된 command 옵션 실행은 `npx lee-spec-kit flow <slug|F001|F001-slug> --approve <LABEL> --execute`를 기본으로 사용하고, `context --approve`와 `context --execute --ticket` 분리 실행은 지양합니다.
@@ -58,7 +60,7 @@ CLI가 가리키는 **Active Task** 또는 **`👉 Next Options (Atomic)`의 단
 
 #### 3-2) 태스크/체크리스트 업데이트 + 커밋
 
-1. 작업이 끝나면 결과/검증을 사용자에게 공유해 승인(OK)을 받은 뒤, 해당 태스크의 상태를 `[DONE]`으로 변경하고 `Acceptance/Checklist` 항목을 `[x]`로 체크합니다.
+1. 작업이 끝나면 결과/검증을 공유하고, 승인 대기(`approvalRequest.required=true`) 상태라면 승인(OK) 후 `[DONE]`으로 변경합니다. 이후 `Acceptance/Checklist` 항목을 `[x]`로 체크합니다.
 2. **한 번에 하나의 태스크만** `[DONE]` 처리합니다. (태스크 2개 이상을 한 번에 완료/커밋으로 묶지 않기)
 3. `tasks.md`의 테스트 실행 기록은 명령어별 1개 행만 유지하고, 같은 명령어 재실행 시 날짜/결과를 갱신합니다. (중복 누적 금지, 날짜 형식: 로컬 `YYYY-MM-DD`)
 4. 커밋을 생성합니다 (코드 커밋 + 문서 커밋). 태스크 단위로 커밋이 남아야 합니다.

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

@@ -69,8 +69,9 @@ npx lee-spec-kit status --write
 | PR 문서 상태 | `pr.md`의 `상태` | `Draft` \| `Ready` |
 | PR 리뷰 상태 | `tasks.md`의 `PR 상태` | `Review` \| `Approved` |
 | Pre-PR 리뷰 상태 | `tasks.md`의 `PR 전 리뷰` | `Pending` \| `Done` |
+| Pre-PR 리뷰 Findings | `tasks.md`의 `PR 전 리뷰 Findings` | `major=<n>, minor=<n>` |
 | Pre-PR 리뷰 Evidence | `tasks.md`의 `PR 전 리뷰 Evidence` | 근거 링크/로그/문서 경로 |
-| Pre-PR 리뷰 Decision | `tasks.md`의 `PR 전 리뷰 Decision` | `결정: ...` (또는 `decision: ...`) |
+| Pre-PR 리뷰 Decision | `tasks.md`의 `PR 전 리뷰 Decision` | `결정: approve|changes_requested|blocked ...` |
 | PR 리뷰 Evidence | `tasks.md`의 `PR 리뷰 Evidence` | 근거 링크/로그/문서 경로 |
 | PR 리뷰 Decision | `tasks.md`의 `PR 리뷰 Decision` | `결정: ...` (또는 `decision: ...`) |
 

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

@@ -24,10 +24,13 @@
 - **PR 전 리뷰**: -
   - 값: Pending | Done
   - 사전 코드리뷰 완료 후 `Done`으로 변경
+- **PR 전 리뷰 Findings**: -
+  - 형식: `major=<n>, minor=<n>`
 - **PR 전 리뷰 Evidence**: -
-  - 예: 리뷰 노트 링크, 로그 경로, 문서 경로
+  - 예: 리뷰 리포트 문서 경로(실제 존재 경로)
 - **PR 전 리뷰 Decision**: -
-  - 핵심 판단 근거를 `결정: ...`(또는 `decision: ...`) 형식으로 기록
+  - 형식: `결정: approve|changes_requested|blocked ...` (또는 `decision: ...`)
+  - PR 생성 전 최종 통과 기준은 `approve`
   - 기본 베이스라인으로 `agents/skills/create-pr.md`(`Pre-PR 기본 체크리스트`) 기준을 따르세요
 - **PR 리뷰 Evidence**: -
   - 예: 해결/합의한 코멘트 링크, 검증 로그, 관련 문서 경로