lee-spec-kit 0.6.15 → 0.6.17

package/package.json

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

package/templates/en/common/README.md

@@ -2,6 +2,30 @@
 
 This documentation is organized by feature to help agents quickly understand the project.
 
+## Agent Session Start Checklist
+
+```bash
+# (recommended once at start) run onboarding checks
+npx lee-spec-kit onboard --strict
+
+# 1) Detect project
+npx lee-spec-kit detect --json
+
+# 2) If detected, read context first
+npx lee-spec-kit context --json-compact
+```
+
+- Apply lee-spec-kit workflow only when `isLeeSpecKitProject: true`.
+- When `actionOptions` exist, show `approvalPrompt`/`finalPrompt` exactly as provided and wait for user approval (`<LABEL>` or `<LABEL> OK`) before execution.
+- If `isLeeSpecKitProject: false`, skip lee-spec-kit-specific flow and continue with normal workflow.
+
+## New Project Start Order
+
+- Scaffold the code project first (for example Next.js/NestJS), then run `lee-spec-kit init`.
+- After that, verify detection with `detect --json`, then continue with `feature` and `context`.
+- In most cases (default: embedded), the steps above are all you need.
+- Choose standalone only when docs are managed separately from the code repo. In that case, prefer running init from a parent workspace folder (for example `workspace/docs`, `workspace/project`) and set both docs/project paths together. (e.g. `npx lee-spec-kit init --docs-repo standalone --dir ./docs --project-root ./project`)
+
 ## Directory Structure
 
 | Path              | Purpose               | Key Documents |

package/templates/en/common/agents/agents.md

@@ -33,7 +33,7 @@ Prohibited:
 ## 🧾 Label Response Contract (SSOT)
 
 - End **every user-facing reply** with current status + available labels.
-- Use the latest `npx lee-spec-kit context --json` (or `flow --json`) as source.
+- Use the latest `npx lee-spec-kit context --json-compact` as the default source (fallback: `context --json` or `flow --json` when full detail is required).
 - Use `actionOptions[].detail` or command `cmd` **verbatim**. Do not paraphrase.
 - Even when the user asks something else, append the same label block at the end if executable labels exist.
 - If no executable labels exist, print `Available labels: none` and guide re-check with `npx lee-spec-kit context`.

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

@@ -74,8 +74,9 @@ Include the artifacts in the PR body.
 
 > - If this includes UI changes, include **screenshots**.
 > - If this includes logic/structure changes, include a **diagram**.
+> - `--mermaid auto` includes a diagram by default; use `--mermaid off` only when no logic/structure change exists.
 
-#### UI changes (Frontend PR)
+#### UI changes
 
 - Default is `pr.screenshots.upload: false`. If you need upload/URL inclusion, enable it in `.lee-spec-kit.json`.
 - If `.lee-spec-kit.json` has `pr.screenshots.upload: false`, **do not upload/include URLs**, and **do not include a "Screenshots" section** in the PR body.
@@ -135,9 +136,10 @@ gh release upload "$TAG" /tmp/lee-spec-kit/pr-assets/* --clobber
 echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
 ```
 
-#### Logic/structure changes (Backend PR)
+#### Logic/structure changes
 
 - Write a Mermaid **`sequenceDiagram`** in the PR body and keep it aligned with the generated body template format.
+- Apply this rule based on change type (logic/structure), not by frontend/backend classification.
 
 ### 4. Request User Approval + Move to `Ready`
 

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

@@ -22,12 +22,8 @@
 - [ ] (verifiable criterion 1)
 - [ ] (verifiable criterion 2)
 
-## Out of Scope
-
-- (what this issue does not cover)
-
 ## Related Docs
 
-- Spec: `./spec.md`
-- Plan: `./plan.md`
-- Tasks: `./tasks.md`
+- Spec: `docs/.../spec.md`
+- Plan: `docs/.../plan.md`
+- Tasks: `docs/.../tasks.md`

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

@@ -27,6 +27,6 @@
 
 ## Related Docs
 
-- Spec: `./spec.md`
-- Tasks: `./tasks.md`
-- Decisions: `./decisions.md`
+- Spec: `docs/.../spec.md`
+- Tasks: `docs/.../tasks.md`
+- Decisions: `docs/.../decisions.md`

package/templates/ko/common/README.md

@@ -2,6 +2,30 @@
 
 에이전트가 프로젝트 전반을 빠르게 파악할 수 있도록 문서를 기능별로 분리해 두었습니다.
 
+## 에이전트 세션 시작 체크리스트
+
+```bash
+# (최초 1회 권장) 초기 온보딩 점검
+npx lee-spec-kit onboard --strict
+
+# 1) 프로젝트 감지
+npx lee-spec-kit detect --json
+
+# 2) 감지 성공 시 컨텍스트 조회
+npx lee-spec-kit context --json-compact
+```
+
+- `isLeeSpecKitProject: true`일 때만 lee-spec-kit 워크플로우를 적용합니다.
+- `actionOptions`가 있으면 `approvalPrompt`/`finalPrompt`를 그대로 사용자에게 보여주고 승인(`<LABEL>` 또는 `<LABEL> OK`)을 받은 뒤 실행합니다.
+- `isLeeSpecKitProject: false`면 lee-spec-kit 전용 절차를 건너뛰고 일반 워크플로우로 진행합니다.
+
+## 신규 프로젝트 시작 순서
+
+- 코드 프로젝트 스캐폴딩(예: Next.js/NestJS) 후 `lee-spec-kit init`을 실행하세요.
+- 그 다음 `detect --json`으로 감지 결과를 확인하고, `feature`/`context` 순서로 진행하세요.
+- 대부분의 경우(기본값: embedded) 위 순서만 따르면 됩니다.
+- docs를 코드 저장소와 분리해 운영할 때만 standalone을 선택하세요. 이때는 상위 워크스페이스 폴더(예: `workspace/docs`, `workspace/project`)에서 `init`을 실행해 docs/project 경로를 함께 지정하는 방식을 권장합니다. (예: `npx lee-spec-kit init --docs-repo standalone --dir ./docs --project-root ./project`)
+
 ## 상위 구조 요약
 
 | 경로             | 목적               | 핵심 문서/역할 |

package/templates/ko/common/agents/agents.md

@@ -33,7 +33,7 @@
 ## 🧾 라벨 응답 계약 (SSOT)
 
 - 사용자에게 보내는 **모든 응답의 마지막**에 현재 상태 + 선택 가능한 라벨을 표시합니다.
-- 기준 데이터는 최신 `npx lee-spec-kit context --json`(또는 `flow --json`)입니다.
+- 기준 데이터는 최신 `npx lee-spec-kit context --json-compact`를 기본으로 사용하고, 상세 필드가 필요할 때만 `context --json`(또는 `flow --json`)을 사용합니다.
 - 라벨 설명은 `actionOptions[].detail` 또는 command `cmd`를 **원문 그대로** 사용합니다. (요약/의역 금지)
 - 사용자가 다른 질문을 하더라도, 실행 가능한 라벨이 있으면 응답 마지막에 동일 블록을 다시 표시합니다.
 - 실행 가능한 라벨이 없으면 `선택 가능: 없음` + `npx lee-spec-kit context` 재확인을 안내합니다.

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

@@ -74,8 +74,9 @@ PR 본문에 결과물을 포함합니다.
 
 > - UI 변경에 해당된다면 **스크린샷을** 포함하세요.
 > - 로직/구조 변경에 해당된다면 **다이어그램을** 포함하세요.
+> - `--mermaid auto`는 기본적으로 다이어그램을 포함합니다. 로직/구조 변경이 전혀 없는 경우에만 `--mermaid off`를 사용하세요.
 
-#### UI 변경 (프론트엔드 PR)
+#### UI 변경
 
 - 기본값은 `pr.screenshots.upload: false`입니다. 업로드/URL 포함이 필요하다면 `.lee-spec-kit.json`에서 `true`로 켜세요.
 - `.lee-spec-kit.json`에서 `pr.screenshots.upload: false`라면 **업로드/URL 포함을 하지 않으며**, PR 본문에서도 **"스크린샷" 섹션을 만들지 않습니다.**
@@ -135,9 +136,10 @@ gh release upload "$TAG" /tmp/lee-spec-kit/pr-assets/* --clobber
 echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
 ```
 
-#### 로직/구조 변경 (백엔드 PR)
+#### 로직/구조 변경
 
 - PR 본문에 Mermaid **`sequenceDiagram`**을 작성하고, 생성된 본문 템플릿 형식과 일치하게 유지합니다.
+- 이 기준은 프론트/백엔드 구분이 아니라 변경 유형(로직/구조) 기준으로 적용합니다.
 
 ### 4. 사용자 확인 요청 + `Ready` 전환
 

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

@@ -22,12 +22,8 @@
 - [ ] (검증 가능한 완료 기준 1)
 - [ ] (검증 가능한 완료 기준 2)
 
-## 제외 범위
-
-- (이번 이슈에서 다루지 않는 내용)
-
 ## 관련 문서
 
-- Spec: `./spec.md`
-- Plan: `./plan.md`
-- Tasks: `./tasks.md`
+- Spec: `docs/.../spec.md`
+- Plan: `docs/.../plan.md`
+- Tasks: `docs/.../tasks.md`

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

@@ -27,6 +27,6 @@
 
 ## 관련 문서
 
-- Spec: `./spec.md`
-- Tasks: `./tasks.md`
-- Decisions: `./decisions.md`
+- Spec: `docs/.../spec.md`
+- Tasks: `docs/.../tasks.md`
+- Decisions: `docs/.../decisions.md`