lee-spec-kit 0.6.8 → 0.6.10

package/package.json

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

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

@@ -51,6 +51,18 @@ Reply format: "<LABEL>" or "<LABEL> OK"
 
 ---
 
+## 📚 Built-in Docs Read Policy (MUST)
+
+- Use `docs get` once per session start (or right after context compression/reset).
+- Do not re-read the same doc again in the same session.
+- From `requiredDocs[*].command`, fetch only docs not yet read in this session.
+- You may re-read only when:
+  - user explicitly asks for policy refresh
+  - policy/config changed (for example after `update`)
+  - session restarted or context was compressed/reset
+
+---
+
 ## Required References
 
 - Highest-priority custom rules: `/docs/agents/custom.md`

package/templates/en/common/agents/git-workflow.md

@@ -70,7 +70,7 @@ main
 
 ## Automation Workflow
 
-> 📖 Read each step guide first with `docs get`.
+> 📖 Read step guides via `docs get`, but do not re-read the same doc in the same session. (Re-read only after session/compression reset, policy/config changes, or explicit user refresh request.)
 
 | Workflow       | Guide                                              |
 | -------------- | -------------------------------------------------- |

package/templates/en/common/agents/issue-template.md

@@ -58,8 +58,8 @@ In GitHub Issues, use different link formats **based on file location**:
    > Format: `- **{Label}**: \`{path}\``
 
    ```markdown
-   - **Spec**: `docs/features/{be|fe}/F001-feature-name/spec.md`
-   - **Tasks**: `docs/features/{be|fe}/F001-feature-name/tasks.md`
+   - **Spec**: `docs/features/{component}/F001-feature-name/spec.md`
+   - **Tasks**: `docs/features/{component}/F001-feature-name/tasks.md`
    ```
 
 > ⚠️ Local documents are not clickable on GitHub, so use **bold label + code block path** format instead of markdown links.
@@ -85,7 +85,7 @@ In GitHub Issues, use different link formats **based on file location**:
 
 ## Related Documents
 
-- **Spec**: `docs/features/{be|fe}/F{number}-{feature-name}/spec.md`
+- **Spec**: `docs/features/{component}/F{number}-{feature-name}/spec.md`
 
 ## Labels
 

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

@@ -15,10 +15,10 @@ Guide for creating GitHub Issues.
 
 ### 1. Prepare Issue Draft
 
-> 📖 **Read procedure/template via `docs get` first, then generate a draft and treat it as the source of truth.**
+> 📖 **If not read in this session, read procedure/template via `docs get`; do not re-read the same doc in the same session, then generate a draft and treat it as the source of truth.**
 
 ```bash
-# 1) Read procedure + template policy
+# 1) Read procedure + template policy (only docs not read in this session)
 npx lee-spec-kit docs get create-issue --json
 npx lee-spec-kit docs get issue-template --json
 

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

@@ -17,10 +17,10 @@ Guide for creating Pull Requests.
 
 ### 1. Prepare PR Body Template
 
-> 📖 **Read procedure/template via `docs get` first, then generate a body template and treat it as the source of truth.**
+> 📖 **If not read in this session, read procedure/template via `docs get`; do not re-read the same doc in the same session, then generate a body template and treat it as the source of truth.**
 
 ```bash
-# 1) Read procedure + template policy
+# 1) Read procedure + template policy (only docs not read in this session)
 npx lee-spec-kit docs get create-pr --json
 npx lee-spec-kit docs get pr-template --json
 

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

@@ -27,7 +27,7 @@ features/
 npx lee-spec-kit feature user-auth
 
 # Multi project
-npx lee-spec-kit feature --component fe user-profile
+npx lee-spec-kit feature --component app user-profile
 ```
 
 > 💡 CLI copies templates from `feature-base/` and auto-assigns IDs.

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

@@ -7,7 +7,7 @@
 ## Overview
 
 - **Feature ID**: F{number}
-- **Target Repo**: {{projectName}}-{be|fe}
+- **Target Repo**: {{projectName}}-{component}
 - **Created**: {YYYY-MM-DD}
 - **Status**: Review | Approved
 

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

@@ -8,7 +8,7 @@
 
 - **Feature ID**: F{number}
 - **Feature Name**: {feature-name}
-- **Target Repo**: {{projectName}}-{be|fe}
+- **Target Repo**: {{projectName}}-{component}
 - **Issue Number**: #{issue-number}
 - **Created**: {YYYY-MM-DD}
 - **Status**: Review | Approved

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

@@ -13,7 +13,7 @@
 ## GitHub Issue
 
 - **Doc Status**: Review | Approved
-- **Repo**: {{projectName}}-{be|fe}
+- **Repo**: {{projectName}}-{component}
 - **Issue**: #{issue-number}
 - **Branch**: `feat/{issue-number}-{feature-name}`
 - **PR**: -

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

@@ -14,7 +14,7 @@ Core rule: once an idea becomes a Feature, the SSOT moves to `docs/features/`.
 - Put at least these at the top:
   - Goal / context
   - Rough scope (what’s in/out)
-  - Target repo (optional): `be` / `fe` / `both`
+  - Target component (optional): `api` / `app` / `worker` / `all`
 
 ---
 

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

@@ -51,6 +51,18 @@ B: <detail>
 
 ---
 
+## 📚 내장 문서 조회 규칙 (MUST)
+
+- `docs get`은 세션 시작(또는 context 압축/리셋 직후) 기준으로 1회 확인합니다.
+- 같은 세션에서 이미 읽은 동일 문서는 다시 읽지 않습니다.
+- 현재 액션의 `requiredDocs[*].command` 중 이번 세션에 아직 읽지 않은 문서만 추가 조회합니다.
+- 아래 경우에는 예외적으로 재조회할 수 있습니다:
+  - 사용자가 정책 새로고침을 요청한 경우
+  - `update` 실행 등으로 정책/설정이 변경된 경우
+  - 세션이 새로 시작되었거나 context 압축/리셋이 발생한 경우
+
+---
+
 ## 필수 참조
 
 - 최우선 규칙: `/docs/agents/custom.md`

package/templates/ko/common/agents/git-workflow.md

@@ -70,7 +70,7 @@ main
 
 ## 자동화 워크플로우
 
-> 📖 단계별 상세 가이드는 `docs get` 명령으로 먼저 확인하세요.
+> 📖 단계별 상세 가이드는 `docs get`으로 확인하되, 같은 세션에서 이미 읽은 동일 문서는 다시 호출하지 마세요. (세션 시작/압축 후, 정책·설정 변경, 사용자 새로고침 요청 시에만 재조회)
 
 | 워크플로우   | 가이드                                             |
 | ------------ | -------------------------------------------------- |

package/templates/ko/common/agents/issue-template.md

@@ -42,8 +42,8 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
    > 형식: `- **{레이블}**: \`{경로}\``
 
    ```markdown
-   - **Spec**: `docs/features/{be|fe}/F001-feature-name/spec.md`
-   - **Tasks**: `docs/features/{be|fe}/F001-feature-name/tasks.md`
+   - **Spec**: `docs/features/{component}/F001-feature-name/spec.md`
+   - **Tasks**: `docs/features/{component}/F001-feature-name/tasks.md`
    ```
 
 > ⚠️ 로컬 문서는 GitHub에서 클릭되지 않으므로, 마크다운 링크 대신 **볼드 레이블 + 코드블록 경로** 형식을 사용합니다.
@@ -69,7 +69,7 @@ GitHub Issue에서 링크는 **파일 위치에 따라** 다르게 작성:
 
 ## 관련 문서
 
-- **Spec**: `docs/features/{be|fe}/F{번호}-{기능명}/spec.md`
+- **Spec**: `docs/features/{component}/F{번호}-{기능명}/spec.md`
 
 ## 라벨
 

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

@@ -15,10 +15,10 @@ GitHub Issue를 생성할 때 따르는 가이드입니다.
 
 ### 1. 이슈 초안 작성
 
-> 📖 **먼저 `docs get`으로 절차/템플릿을 읽고, 초안을 생성해 기준으로 사용하세요.**
+> 📖 **이번 세션에 아직 읽지 않았다면 `docs get`으로 절차/템플릿을 읽고, 이미 읽은 동일 문서는 재호출하지 않은 채 초안을 생성해 기준으로 사용하세요.**
 
 ```bash
-# 1) 절차/템플릿 정책 확인
+# 1) 절차/템플릿 정책 확인 (이번 세션 미확인 문서만)
 npx lee-spec-kit docs get create-issue --json
 npx lee-spec-kit docs get issue-template --json
 

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

@@ -17,10 +17,10 @@ Pull Request를 생성할 때 따르는 가이드입니다.
 
 ### 1. PR 본문 템플릿 준비
 
-> 📖 **먼저 `docs get`으로 절차/템플릿을 읽고, 본문 템플릿을 생성해 기준으로 사용하세요.**
+> 📖 **이번 세션에 아직 읽지 않았다면 `docs get`으로 절차/템플릿을 읽고, 이미 읽은 동일 문서는 재호출하지 않은 채 본문 템플릿을 생성해 기준으로 사용하세요.**
 
 ```bash
-# 1) 절차/템플릿 정책 확인
+# 1) 절차/템플릿 정책 확인 (이번 세션 미확인 문서만)
 npx lee-spec-kit docs get create-pr --json
 npx lee-spec-kit docs get pr-template --json
 

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

@@ -27,7 +27,7 @@ features/
 npx lee-spec-kit feature user-auth
 
 # Multi 프로젝트
-npx lee-spec-kit feature --component fe user-profile
+npx lee-spec-kit feature --component app user-profile
 ```
 
 > 💡 CLI는 `feature-base/`에서 템플릿을 복사하고 ID를 자동 채번합니다.

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

@@ -7,7 +7,7 @@
 ## 개요
 
 - **기능 ID**: F{번호}
-- **대상 레포**: {{projectName}}-{be|fe}
+- **대상 레포**: {{projectName}}-{component}
 - **작성일**: {YYYY-MM-DD}
 - **상태**: Review | Approved
 

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

@@ -8,7 +8,7 @@
 
 - **기능 ID**: F{번호}
 - **기능명**: {기능명}
-- **대상 레포**: {{projectName}}-{be|fe}
+- **대상 레포**: {{projectName}}-{component}
 - **이슈 번호**: #{이슈번호}
 - **작성일**: {YYYY-MM-DD}
 - **상태**: Review | Approved

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

@@ -13,7 +13,7 @@
 ## GitHub Issue
 
 - **문서 상태**: Review | Approved
-- **레포**: {{projectName}}-{be|fe}
+- **레포**: {{projectName}}-{component}
 - **Issue**: #{이슈번호}
 - **브랜치**: `feat/{이슈번호}-{기능명}`
 - **PR**: -

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

@@ -14,7 +14,7 @@ Feature로 발전하기 전의 아이디어 / To-do / 실험 기록을 모아두
 - 상단에 최소한 아래 메타 정보를 둡니다:
   - 목적/배경
   - 대략 범위(뭘 할지/안 할지)
-  - 대상 레포(필요 시): `be` / `fe` / `both`
+  - 대상 컴포넌트(필요 시): `api` / `app` / `worker` / `all`
 
 ---