lee-spec-kit 0.6.16 → 0.6.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.6.16",
+  "version": "0.6.18",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {
@@ -49,13 +49,18 @@
     "eslint-config-prettier": "^10.1.8",
     "prettier": "^3.7.4",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "lint": "eslint src",
-    "test:race": "pnpm build && node --test tests/race.test.mjs",
+    "lint:test": "eslint tests",
+    "typecheck": "tsc --noEmit",
+    "typecheck:test": "tsc -p tsconfig.tests.json --noEmit",
+    "test": "pnpm build && vitest run",
+    "test:race": "pnpm build && vitest run tests/race.test.mjs",
     "format": "prettier --write ."
   }
 }

package/templates/en/common/README.md

@@ -5,11 +5,14 @@ This documentation is organized by feature to help agents quickly understand the
 ## 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
+npx lee-spec-kit context --json-compact
 ```
 
 - Apply lee-spec-kit workflow only when `isLeeSpecKitProject: true`.
@@ -20,7 +23,8 @@ npx lee-spec-kit context --json
 
 - 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`).
+- 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
 

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/git-workflow.md

@@ -82,9 +82,16 @@ main
 ### Branch Creation
 
 ```bash
-git checkout -b feat/{issue-number}-{feature-name}
+# Default (recommended): create dedicated worktree + branch
+mkdir -p .worktrees
+git worktree add -b feat/{issue-number}-{feature-name} .worktrees/feat-{issue-number}-{feature-name}
+
+# If branch already exists, attach worktree only
+git worktree add .worktrees/feat-{issue-number}-{feature-name} feat/{issue-number}-{feature-name}
 ```
 
+> Continue implementation from the created worktree path (`.worktrees/feat-{issue-number}-{feature-name}`).
+
 ### Document Commit Rules (Continuous Sync)
 
 > 🔄 **Docs synchronization is mandatory when Project code changes.**

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

@@ -5,11 +5,14 @@
 ## 에이전트 세션 시작 체크리스트
 
 ```bash
+# (최초 1회 권장) 초기 온보딩 점검
+npx lee-spec-kit onboard --strict
+
 # 1) 프로젝트 감지
 npx lee-spec-kit detect --json
 
 # 2) 감지 성공 시 컨텍스트 조회
-npx lee-spec-kit context --json
+npx lee-spec-kit context --json-compact
 ```
 
 - `isLeeSpecKitProject: true`일 때만 lee-spec-kit 워크플로우를 적용합니다.
@@ -20,7 +23,8 @@ npx lee-spec-kit context --json
 
 - 코드 프로젝트 스캐폴딩(예: Next.js/NestJS) 후 `lee-spec-kit init`을 실행하세요.
 - 그 다음 `detect --json`으로 감지 결과를 확인하고, `feature`/`context` 순서로 진행하세요.
-- 위 순서는 기본값인 `docsRepo: embedded` 기준입니다. `standalone`이면 docs 레포 경로 기준(`--dir` 또는 `LEE_SPEC_KIT_DOCS_DIR`)으로 실행하세요.
+- 대부분의 경우(기본값: 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/git-workflow.md

@@ -82,9 +82,16 @@ main
 ### 브랜치 생성
 
 ```bash
-git checkout -b feat/{issue-number}-{feature-name}
+# 기본(권장): 전용 worktree + 브랜치 생성
+mkdir -p .worktrees
+git worktree add -b feat/{issue-number}-{feature-name} .worktrees/feat-{issue-number}-{feature-name}
+
+# 이미 브랜치가 존재하면 worktree만 연결
+git worktree add .worktrees/feat-{issue-number}-{feature-name} feat/{issue-number}-{feature-name}
 ```
 
+> 이후 작업은 생성된 worktree 경로(`.worktrees/feat-{issue-number}-{feature-name}`)에서 진행하세요.
+
 ### 문서 커밋 규칙 (Continuous Sync)
 
 > 🔄 **Project 코드 변경 시 Docs 동기화는 필수입니다.**

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`