lee-spec-kit 0.6.15 → 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

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 전용 절차를 건너뛰고 일반 워크플로우로 진행
+```
+
 ## 주요 기능
 
 ### 📁 프로젝트 초기화

package/dist/index.js

@@ -8475,11 +8475,7 @@ function parsePrArtifactMode(raw, kind, lang) {
     tg(lang, "artifactModeInvalid", { kind, value })
   );
 }
-function isMermaidPreferredComponent(component) {
-  const normalized = (component || "").trim().toLowerCase();
-  return ["be", "backend", "api", "server", "core"].includes(normalized);
-}
-function resolvePrArtifactPolicy(config, feature, options) {
+function resolvePrArtifactPolicy(config, options) {
   const screenshotsMode = parsePrArtifactMode(
     options.screenshots,
     "screenshots",
@@ -8491,7 +8487,7 @@ function resolvePrArtifactPolicy(config, feature, options) {
     config.lang
   );
   const includeScreenshots = screenshotsMode === "on" ? true : screenshotsMode === "off" ? false : config.pr?.screenshots?.upload ?? false;
-  const includeMermaid = mermaidMode === "on" ? true : mermaidMode === "off" ? false : isMermaidPreferredComponent(feature.type);
+  const includeMermaid = mermaidMode === "on" ? true : mermaidMode === "off" ? false : true;
   return {
     includeScreenshots,
     includeMermaid
@@ -9545,7 +9541,7 @@ function githubCommand(program2) {
         slug: feature.slug
       });
       const title = options.title?.trim() || defaultTitle;
-      const artifactPolicy = resolvePrArtifactPolicy(config, feature, options);
+      const artifactPolicy = resolvePrArtifactPolicy(config, options);
       const generatedBody = buildPrBody(
         feature,
         specContent,

package/package.json

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

package/templates/en/common/README.md

@@ -2,6 +2,26 @@
 
 This documentation is organized by feature to help agents quickly understand the project.
 
+## Agent Session Start Checklist
+
+```bash
+# 1) Detect project
+npx lee-spec-kit detect --json
+
+# 2) If detected, read context first
+npx lee-spec-kit context --json
+```
+
+- 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`.
+- This sequence assumes default `docsRepo: embedded`. For `standalone`, run against the docs repo path (`--dir` or `LEE_SPEC_KIT_DOCS_DIR`).
+
 ## Directory Structure
 
 | Path              | Purpose               | Key Documents |

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/ko/common/README.md

@@ -2,6 +2,26 @@
 
 에이전트가 프로젝트 전반을 빠르게 파악할 수 있도록 문서를 기능별로 분리해 두었습니다.
 
+## 에이전트 세션 시작 체크리스트
+
+```bash
+# 1) 프로젝트 감지
+npx lee-spec-kit detect --json
+
+# 2) 감지 성공 시 컨텍스트 조회
+npx lee-spec-kit context --json
+```
+
+- `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` 순서로 진행하세요.
+- 위 순서는 기본값인 `docsRepo: embedded` 기준입니다. `standalone`이면 docs 레포 경로 기준(`--dir` 또는 `LEE_SPEC_KIT_DOCS_DIR`)으로 실행하세요.
+
 ## 상위 구조 요약
 
 | 경로             | 목적               | 핵심 문서/역할 |

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` 전환