lee-spec-kit 0.6.2 → 0.6.4

package/README.en.md

@@ -209,10 +209,30 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 - `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`)
 - `prePrReviewPolicy`: pre-PR review policy (`enabled`, `skills`, `fallback`, `blockOnFindings`)
+- `requiredDocs`: CLI built-in docs to read before the current action (`id`, `command`)
 - `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`).
 
+### Built-in Docs
+
+If you do not restore `agents.md` into project docs, fetch CLI-managed guides directly:
+`docs get create-issue|issue-template|create-pr|pr-template --json` also returns `contract` (required sections / artifact rules).
+
+```bash
+# list built-in docs
+npx lee-spec-kit docs list --json
+
+# root agent guide
+npx lee-spec-kit docs get agents --json
+
+# issue/PR procedure + templates
+npx lee-spec-kit docs get create-issue --json
+npx lee-spec-kit docs get issue-template --json
+npx lee-spec-kit docs get create-pr --json
+npx lee-spec-kit docs get pr-template --json
+```
+
 ### View
 
 ```bash
@@ -266,15 +286,20 @@ npx lee-spec-kit github issue F001 --create --confirm OK --labels enhancement,fr
 # Generate PR body
 npx lee-spec-kit github pr F001
 
+# Generate PR body (force screenshots/Mermaid sections)
+npx lee-spec-kit github pr F001 --screenshots on --mermaid on
+
 # Generate + create PR + sync tasks.md metadata + merge with retry
 npx lee-spec-kit github pr F001 --create --merge --confirm OK --labels enhancement,frontend
 ```
 
 Key points:
 - Issue/PR helpers validate required body sections and related docs paths.
+- `--json` output includes both `body` (inline markdown) and `bodyFile` (file path).
 - Labels are validated (at least one required).
 - `--create`/`--merge` are remote operations and require `--confirm OK`.
 - PR helper can sync `tasks.md` PR URL/PR Status automatically (`--no-sync-tasks` to skip).
+- PR artifact sections are controlled by `--screenshots (auto|on|off)` and `--mermaid (auto|on|off)`.
 - Merge includes retry and automatic head-branch refresh (fetch/rebase/force-push) on out-of-date failures.
 
 ### Status

package/README.md

@@ -230,11 +230,31 @@ npx lee-spec-kit context F001 --approve A --execute --execute-strict
 - `requiresUserCheck`: 사용자 확인 필요 여부 (에이전트는 **사용자 응답을 `<라벨>` 또는 `<라벨> OK` 형식(예: `A`, `A OK`)으로 제한**하는 것을 권장 / 설정의 `approval`로 오버라이드 가능)
 - `workflowPolicy`: 현재 완료 조건 정책 (`mode`, `requireIssue`, `requireBranch`, `requirePr`, `requireReview`)
 - `prePrReviewPolicy`: pre-PR 리뷰 정책 (`enabled`, `skills`, `fallback`, `blockOnFindings`)
+- `requiredDocs`: 현재 액션 전에 읽어야 할 CLI 내장 문서 목록 (`id`, `command`)
 
 또한 `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`)
 
+### CLI 내장 문서 조회
+
+`agents.md`를 프로젝트에 복구하지 않는 환경에서는 아래 명령으로 내장 가이드를 직접 조회할 수 있습니다.
+`docs get create-issue|issue-template|create-pr|pr-template --json` 응답에는 `contract`(필수 섹션/아티팩트 규칙)도 포함됩니다.
+
+```bash
+# 조회 가능한 내장 문서 목록
+npx lee-spec-kit docs list --json
+
+# 루트 가이드
+npx lee-spec-kit docs get agents --json
+
+# 이슈/PR 절차 + 템플릿
+npx lee-spec-kit docs get create-issue --json
+npx lee-spec-kit docs get issue-template --json
+npx lee-spec-kit docs get create-pr --json
+npx lee-spec-kit docs get pr-template --json
+```
+
 ### View 대시보드
 
 ```bash
@@ -288,15 +308,20 @@ npx lee-spec-kit github issue F001 --create --confirm OK --labels enhancement,fr
 # PR 본문 생성
 npx lee-spec-kit github pr F001
 
+# PR 본문 생성 (스크린샷/Mermaid 섹션 강제 포함)
+npx lee-spec-kit github pr F001 --screenshots on --mermaid on
+
 # PR 본문 생성 + PR 생성 + tasks.md 메타데이터 동기화 + merge 재시도
 npx lee-spec-kit github pr F001 --create --merge --confirm OK --labels enhancement,frontend
 ```
 
 핵심 동작:
 - Issue/PR helper는 필수 섹션과 관련 문서 경로를 검증합니다.
+- `--json` 출력에는 `body`(본문 문자열)와 `bodyFile`(파일 경로)가 함께 제공됩니다.
 - 라벨은 최소 1개 이상 필수입니다.
 - `--create`/`--merge`는 원격 작업이므로 `--confirm OK`가 필요합니다.
 - PR helper는 기본적으로 `tasks.md`의 `PR`/`PR Status`를 동기화합니다. (`--no-sync-tasks`로 비활성화)
+- PR helper의 아티팩트 섹션은 `--screenshots (auto|on|off)`, `--mermaid (auto|on|off)`로 제어할 수 있습니다.
 - merge 시 head 브랜치가 뒤쳐진 경우 fetch/rebase/force-push 후 재시도합니다.
 
 ### 상태 확인