lee-spec-kit 0.5.1 → 0.6.0

package/README.en.md

@@ -203,9 +203,13 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 `--json` output includes:
 
 - `reasonCode`: status reason code (`SINGLE_MATCHED`, `MULTIPLE_ACTIVE_FEATURES`, etc.)
+- `operationType`: action nature (`local` | `remote` | `manual`)
 - `actionOptions`: maps labels to atomic actions plus `summary`/`approvalPrompt` for user-facing label explanation
+- `primaryActionLabel` / `primaryActionType` / `primaryActionCategory` / `primaryActionOperationType`: metadata for the first atomic action
+- `selectionFallback`: fallback used when branch auto-detection does not match (`none` | `open_features` | `all_features` | `done_features`)
 - `workflowPolicy`: current completion policy (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
-- `checkPolicy`: approval validation policy (`token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, ...)
+- `prePrReviewPolicy`: pre-PR review policy (`enabled`, `skills`, `fallback`, `blockOnFindings`)
+- `checkPolicy`: approval validation policy (`hint`, `policyOnly`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, ...)
 
 Error payloads (`status: "error"`) include `reasonCode` and labeled `suggestions` (`A/B/C`) (e.g. `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`).
 
@@ -332,6 +336,9 @@ npx lee-spec-kit update --templates
 npx lee-spec-kit update --force
 ```
 
+> `agents/skills` and `features/feature-base` are now CLI-managed (SSOT).  
+> `update --skills` and `update --templates` are used to clean up legacy copied files in existing docs trees.
+
 ## Configuration
 
 ### `.lee-spec-kit.json`
@@ -345,7 +352,11 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
   "lang": "en",
   "createdAt": "YYYY-MM-DD",
   "docsRepo": "embedded",
-  "workflow": { "mode": "github", "codeDirtyScope": "auto" },
+  "workflow": {
+    "mode": "github",
+    "codeDirtyScope": "auto",
+    "prePrReview": { "skills": ["code-review-excellence"] }
+  },
   "pr": { "screenshots": { "upload": false } },
   "approval": { "mode": "builtin" }
 }
@@ -362,7 +373,7 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
 | `pushDocs`    | (standalone only) whether to manage/push docs repo as a separate git repo |
 | `docsRemote`  | (standalone + pushDocs) docs repo remote URL |
 | `projectRoot` | (standalone only) project repo path (single: string, multi: `{ [component]: path }`) |
-| `workflow`    | (optional) workflow completion policy (`github`/`local`, `codeDirtyScope`) |
+| `workflow`    | (optional) workflow completion policy (`github`/`local`, `codeDirtyScope`, `prePrReview`) |
 | `pr`          | (optional) PR artifacts policy (e.g. screenshot upload) |
 | `approval`    | (optional) Override CHECK-required policy in `context` output (for automation/semi-auto) |
 
@@ -400,12 +411,25 @@ Running `init` creates `.lee-spec-kit.json` in your docs root (default: `docs/`)
   - `auto`: `single => repo`, `multi => component`
   - `workflow.componentPaths` (optional): explicit per-component paths for component-scoped checks (e.g. `"web": ["apps/web", "packages/web-ui"]`)
   - backward compatibility: if omitted, runtime defaults to `repo`
+- `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"`)
+  - `blockOnFindings` (optional): require major findings to be resolved/aligned before PR creation (default: `true`)
 
 Example:
 
 ```json
 {
-  "workflow": { "mode": "local", "codeDirtyScope": "auto" }
+  "workflow": {
+    "mode": "github",
+    "codeDirtyScope": "auto",
+    "prePrReview": {
+      "skills": ["code-review-excellence"],
+      "fallback": "builtin-checklist",
+      "blockOnFindings": true
+    }
+  }
 }
 ```
 
@@ -503,4 +527,4 @@ For the full code list and meanings, see `errors.en.md` (English) or `errors.md`
 
 See the Korean README for the full tree examples and workflow details: `README.md`.
 
-Note: generated docs include `agents/custom.md`, `agents/skills/`, and `scripts/` by default.
+Note: generated docs keep project-scoped policy docs (`agents/custom.md`, `agents/constitution.md`) and do not sync CLI-managed docs (`agents.md`, `agents/skills/*`, `git-workflow.md`, `issue-template.md`, `pr-template.md`, `features/feature-base/*`).

package/README.md

@@ -222,12 +222,16 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 - `reasonCode`: 상태 이유 코드 (`SINGLE_MATCHED`, `MULTIPLE_ACTIVE_FEATURES` 등)
 - `type: "command"`: `scope`(project|docs), `cwd`, `cmd` 제공 (복사하여 붙여넣기 가능한 형태로 `cd ... && git ...` 형태로 출력)
 - `type: "instruction"`: 사람이 수행해야 하는 안내 메시지
+- `operationType`: 액션 성격 (`local` | `remote` | `manual`)
 - `actionOptions`: `label`(`A`, `B`, `C`...)과 해당 `action` 매핑 + `summary`/`approvalPrompt`(라벨 설명 템플릿)
+- `primaryActionLabel`/`primaryActionType`/`primaryActionCategory`/`primaryActionOperationType`: 첫 번째 원자 액션의 요약 메타데이터
+- `selectionFallback`: 자동 감지 실패 시 사용된 폴백 (`none` | `open_features` | `all_features` | `done_features`)
 - `category`: 액션 분류 (자동화/반자동용 `approval.mode: "category"`에서 사용)
 - `requiresUserCheck`: 사용자 확인 필요 여부 (에이전트는 **사용자 응답을 `<라벨>` 또는 `<라벨> OK` 형식(예: `A`, `A OK`)으로 제한**하는 것을 권장 / 설정의 `approval`로 오버라이드 가능)
 - `workflowPolicy`: 현재 완료 조건 정책 (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
+- `prePrReviewPolicy`: pre-PR 리뷰 정책 (`enabled`, `skills`, `fallback`, `blockOnFindings`)
 
-또한 `checkPolicy`가 포함되어, 에이전트가 사용자 확인 정책을 적용할 때 참고할 수 있습니다. (`docPath`, `hint`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, `config`)
+또한 `checkPolicy`가 포함되어, 에이전트가 사용자 확인 정책을 적용할 때 참고할 수 있습니다. (`docPath`, `hint`, `policyOnly`, `token: "<LABEL>"`, `acceptedTokens`, `tokenPattern`, `validLabels`, `requireExplanationBeforeApproval`, `requiredExplanationFields`, `contextVersion`, `config`)
 
 오류 응답(`status: "error"`)에는 `reasonCode`와 `suggestions`(라벨형 다음 동작: `A/B/C`)가 포함됩니다. (예: `INVALID_APPROVAL`, `CONTEXT_STALE`, `EXECUTION_FAILED`, `EXECUTION_NOT_COMMAND`)
 
@@ -384,6 +388,9 @@ npx lee-spec-kit update --templates
 npx lee-spec-kit update --force
 ```
 
+> `agents/skills`와 `features/feature-base`는 CLI 내장(SSOT)으로 관리됩니다.  
+> `update --skills`, `update --templates`는 기존 프로젝트의 레거시 복사본을 정리하는 용도로 동작합니다.
+
 ## 설정 파일
 
 ### `.lee-spec-kit.json`
@@ -397,7 +404,11 @@ npx lee-spec-kit update --force
   "lang": "ko",
   "createdAt": "YYYY-MM-DD",
   "docsRepo": "embedded",
-  "workflow": { "mode": "github", "codeDirtyScope": "auto" },
+  "workflow": {
+    "mode": "github",
+    "codeDirtyScope": "auto",
+    "prePrReview": { "skills": ["code-review-excellence"] }
+  },
   "pr": { "screenshots": { "upload": false } },
   "approval": { "mode": "builtin" }
 }
@@ -414,7 +425,7 @@ npx lee-spec-kit update --force
 | `pushDocs`    | (standalone만) docs 레포를 별도 Git으로 관리/푸시할지 여부 |
 | `docsRemote`  | (standalone+pushDocs) docs 레포 remote URL |
 | `projectRoot` | (standalone만) 프로젝트 레포지토리 경로 (single: string, multi: `{ [component]: path }`) |
-| `workflow`    | (선택) 워크플로우 요구사항 정책 (`github`/`local`, `codeDirtyScope`) |
+| `workflow`    | (선택) 워크플로우 요구사항 정책 (`github`/`local`, `codeDirtyScope`, `prePrReview`) |
 | `pr`          | (선택) PR 결과물 정책 (예: 스크린샷 업로드 여부) |
 | `approval`    | (선택) `context` 출력의 `[확인 필요]`/`requiresUserCheck` 정책 오버라이드 (자동화/반자동용) |
 
@@ -452,12 +463,25 @@ npx lee-spec-kit update --force
   - `auto`: `single => repo`, `multi => component`
   - `workflow.componentPaths`(선택): component 판정 경로를 컴포넌트별로 명시 (예: `"web": ["apps/web", "packages/web-ui"]`)
   - 하위 호환: 값이 없으면 기존 동작인 `repo`로 처리
+- `workflow.prePrReview`:
+  - `enabled` (선택): pre-PR 리뷰 단계를 강제할지 여부 (기본: `requirePr`와 동일)
+  - `skills` (선택): 우선순위 스킬 목록 (기본: `["code-review-excellence"]`)
+  - `fallback` (선택): 스킬 미사용 시 폴백 정책 (기본: `"builtin-checklist"`)
+  - `blockOnFindings` (선택): 주요 이슈 발견 시 PR 생성 전 해결/합의를 요구할지 여부 (기본: `true`)
 
 예시:
 
 ```json
 {
-  "workflow": { "mode": "local", "codeDirtyScope": "auto" }
+  "workflow": {
+    "mode": "github",
+    "codeDirtyScope": "auto",
+    "prePrReview": {
+      "skills": ["code-review-excellence"],
+      "fallback": "builtin-checklist",
+      "blockOnFindings": true
+    }
+  }
 }
 ```
 
@@ -588,13 +612,8 @@ npx lee-spec-kit config --project-root /new/fe/path --repo fe --non-interactive
 docs/
 ├── README.md
 ├── agents/
-│   ├── agents.md           # 에이전트 운영 규칙
 │   ├── constitution.md     # 프로젝트 원칙
 │   ├── custom.md           # 프로젝트별 추가 규칙
-│   ├── git-workflow.md     # Git 자동화 규칙
-│   ├── issue-template.md
-│   ├── pr-template.md
-│   └── skills/             # 에이전트 실행 가이드
 ├── designs/                # 디자인 참고 자료
 ├── ideas/                  # 아이디어/To-do (Feature 승격 전)
 ├── prd/
@@ -603,7 +622,6 @@ docs/
 │   └── README.md
 └── features/
     ├── README.md
-    ├── feature-base/       # 공용 템플릿
     ├── be/                 # Backend Features
     └── fe/                 # Frontend Features
 ```
@@ -614,14 +632,13 @@ docs/
 docs/
 ├── README.md
 ├── agents/
+│   ├── constitution.md
 │   ├── custom.md
-│   └── skills/
 ├── designs/
 ├── ideas/
 ├── prd/
 ├── scripts/
 └── features/
-    ├── feature-base/
     └── F001-feature/       # 개별 기능
 ```