lee-spec-kit 0.6.27 โ†’ 0.6.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lee-spec-kit",
3
- "version": "0.6.27",
3
+ "version": "0.6.29",
4
4
  "description": "Project documentation structure generator for AI-assisted development",
5
5
  "type": "module",
6
6
  "bin": {
@@ -42,6 +42,7 @@ Prohibited:
42
42
  - If user input does not contain a valid label, do not execute; request label selection again.
43
43
  - For approved command options, prefer one-shot `flow --approve <LABEL> --execute`; do not split `context --approve` and `context --execute --ticket` across turns/sessions.
44
44
  - If `agentOrchestration.currentActionShouldDelegate=true` and the selected option is `actionType="command"`, delegation is mandatory: call `spawn_agent` first. Do not execute that command directly from the main agent.
45
+ - If `agentOrchestration.autoRunShouldDelegate=true`, delegate auto loops (`autoRun.command`, `flow --auto-*`) to a sub-agent.
45
46
  - Main-agent fallback is allowed only when sub-agent execution is unavailable (for example: tool not available, spawn failed, or sub-agent failed before command execution).
46
47
  - When fallback is used, report a one-line fallback reason to the user before running the command in the main agent.
47
48
 
@@ -42,7 +42,7 @@ Use `issue.md` status (`Draft | Ready`) as the actual workflow state.
42
42
 
43
43
  > ๐Ÿšจ **User Approval Required**
44
44
 
45
- Share the `issue.md` draft and wait for explicit approval (OK):
45
+ Share the `issue.md` draft and wait for label approval (`A` or `A OK`):
46
46
 
47
47
  - Title
48
48
  - Full body draft (from `issue.md`)
@@ -24,8 +24,10 @@ Always run this checklist in Pre-PR review. Treat it as the minimum baseline, th
24
24
  4. Run related test/verification commands (or explicitly record why they were not run).
25
25
  5. Run `npx lee-spec-kit pre-pr-review <feature-ref>` to record review notes in `decisions.md` and sync `Pre-PR Evidence/Decision`.
26
26
  6. `Pre-PR Evidence` should point to a real existing path. (default: `workflow.prePrReview.evidenceMode=path_required`)
27
- 7. `Pre-PR Decision` must use `decision: approve|changes_requested|blocked ...` (or `๊ฒฐ์ •: ...`).
28
- 8. Ensure the final decision is `approve` before moving to PR creation.
27
+ 7. In `decisions.md`, include a `Pre-PR Review Log` section with non-placeholder `Summary` and `Decision` entries.
28
+ 8. In code-review stage, keep `PR Review Evidence/Decision` aligned with `decisions.md` by adding a `PR Review Log` section with `Summary` and `Decision`.
29
+ 9. `Pre-PR Decision` must use `decision: approve|changes_requested|blocked ...` (or `๊ฒฐ์ •: ...`).
30
+ 10. Ensure the final decision is `approve` before moving to PR creation.
29
31
 
30
32
  ---
31
33
 
@@ -26,6 +26,7 @@ Execute exactly one option from `๐Ÿ‘‰ Next Options (Atomic)` as printed by the C
26
26
  - `true`: wait for label-token approval (`A`, `A OK`) before execution.
27
27
  - Default execution model is **main-agent orchestration + selective sub-agent execution**. Keep short steps (spec/plan/tasks approvals, issue/PR metadata sync) in the main agent, and delegate long-running loops (`task_execute`, `code_review`, `review_fix_commit`, `pre_pr_review`, auto-run) to a sub-agent.
28
28
  - When `agentOrchestration.currentActionShouldDelegate=true` and the selected option is `actionType="command"`, delegation is mandatory: call `spawn_agent` first and do not execute the command directly from the main agent.
29
+ - When `agentOrchestration.autoRunShouldDelegate=true`, delegate auto loops (`autoRun.command`, `flow --auto-*`) to a sub-agent.
29
30
  - Main-agent fallback is allowed only when sub-agent execution is unavailable (for example: tool not available, spawn failed, or sub-agent failed before command execution). Before fallback execution, report a one-line fallback reason to the user.
30
31
  - If `context --json-compact` exposes `autoRun.available=true`, you may use `autoRun.command` to continue automatically until approval-required categories are reached.
31
32
  - For long-running auto execution, start with `flow <feature> --auto-... --start-auto --json-compact` and prefer `autoRun.run.resumeCommand` (`flow --resume <RUN_ID>`) after interruption/compression (`--json` only when full-detail debugging fields are required).
@@ -31,7 +31,7 @@
31
31
  - PR creation requires final decision `approve`
32
32
  - Follow `agents/skills/create-pr.md` (`Pre-PR Baseline Checklist`) as the default baseline
33
33
  - **PR Review Evidence**: -
34
- - Example: resolved/aligned comment link, verification log, or docs path
34
+ - Example: `summary: ...` (or `์š”์•ฝ: ...`), or `docs/features/F001-foo/decisions.md` with `PR Review Log`
35
35
  - **PR Review Decision**: -
36
36
  - Record why/how review comments were addressed as `decision: ...` (or `๊ฒฐ์ •: ...`)
37
37
 
@@ -42,6 +42,7 @@
42
42
  - ์‚ฌ์šฉ์ž ์ž…๋ ฅ์— ์œ ํšจ ๋ผ๋ฒจ์ด ์—†์œผ๋ฉด ์‹คํ–‰ํ•˜์ง€ ๋ง๊ณ  ๋ผ๋ฒจ ์„ ํƒ์„ ๋‹ค์‹œ ์š”์ฒญํ•ฉ๋‹ˆ๋‹ค.
43
43
  - ์Šน์ธ๋œ command ์˜ต์…˜ ์‹คํ–‰์€ `flow --approve <LABEL> --execute` 1ํšŒ ํ˜ธ์ถœ์„ ๊ธฐ๋ณธ์œผ๋กœ ํ•˜๋ฉฐ, `context --approve`์™€ `context --execute --ticket`๋ฅผ ํ„ด/์„ธ์…˜ ์‚ฌ์ด๋กœ ๋ถ„๋ฆฌํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
44
44
  - `agentOrchestration.currentActionShouldDelegate=true`์ด๊ณ  ์„ ํƒํ•œ ์˜ต์…˜์ด `actionType="command"`๋ฉด ์œ„์ž„์ด ํ•„์ˆ˜์ž…๋‹ˆ๋‹ค. ๋จผ์ € `spawn_agent`๋ฅผ ํ˜ธ์ถœํ•˜๊ณ , ํ•ด๋‹น ๋ช…๋ น์„ ๋ฉ”์ธ ์—์ด์ „ํŠธ์—์„œ ์ง์ ‘ ์‹คํ–‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
45
+ - `agentOrchestration.autoRunShouldDelegate=true`๋ฉด auto ๋ฃจํ”„(`autoRun.command`, `flow --auto-*`)๋ฅผ ์„œ๋ธŒ ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.
45
46
  - ๋ฉ”์ธ ์—์ด์ „ํŠธ fallback์€ ์„œ๋ธŒ ์—์ด์ „ํŠธ ์‹คํ–‰์ด ๋ถˆ๊ฐ€๋Šฅํ•œ ๊ฒฝ์šฐ(์˜ˆ: ๋„๊ตฌ ๋ฏธ์ง€์›, spawn ์‹คํŒจ, ๋ช…๋ น ์‹คํ–‰ ์ „ ์„œ๋ธŒ ์—์ด์ „ํŠธ ์‹คํŒจ)์—๋งŒ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค.
46
47
  - fallback์„ ์‚ฌ์šฉํ•  ๋•Œ๋Š” ๋ฉ”์ธ ์‹คํ–‰ ์ „์— fallback ์‚ฌ์œ ๋ฅผ ์‚ฌ์šฉ์ž์—๊ฒŒ ํ•œ ์ค„๋กœ ๋จผ์ € ์•Œ๋ฆฝ๋‹ˆ๋‹ค.
47
48
 
@@ -42,7 +42,7 @@ npx lee-spec-kit github issue F001 --json
42
42
 
43
43
  > ๐Ÿšจ **์‚ฌ์šฉ์ž ํ™•์ธ ํ•„์ˆ˜**
44
44
 
45
- `issue.md` ์ดˆ์•ˆ ๊ธฐ์ค€์œผ๋กœ ๋‹ค์Œ ๋‚ด์šฉ์„ ๊ณต์œ ํ•˜๊ณ  ๋ช…์‹œ์  ์Šน์ธ(OK) ๋Œ€๊ธฐ:
45
+ `issue.md` ์ดˆ์•ˆ ๊ธฐ์ค€์œผ๋กœ ๋‹ค์Œ ๋‚ด์šฉ์„ ๊ณต์œ ํ•˜๊ณ  ๋ผ๋ฒจ ์Šน์ธ(`A` ๋˜๋Š” `A OK`) ๋Œ€๊ธฐ:
46
46
 
47
47
  - ์ œ๋ชฉ
48
48
  - ๋ณธ๋ฌธ ์ „์ฒด ์ดˆ์•ˆ (`issue.md` ๊ธฐ์ค€)
@@ -24,8 +24,10 @@ Pre-PR ๋ฆฌ๋ทฐ์—์„œ ํ•ญ์ƒ ์ˆ˜ํ–‰ํ•˜๋Š” ์ตœ์†Œ ๊ธฐ์ค€์ž…๋‹ˆ๋‹ค. ๊ฐ€๋Šฅํ•œ ๊ฒฝ์šฐ
24
24
  4. ๊ด€๋ จ ํ…Œ์ŠคํŠธ/๊ฒ€์ฆ ๋ช…๋ น์„ ์‹คํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์‹คํ–‰ํ•˜์ง€ ๋ชปํ–ˆ๋‹ค๋ฉด ์‚ฌ์œ ๋ฅผ ๋ช…์‹œํ•ฉ๋‹ˆ๋‹ค.
25
25
  5. `npx lee-spec-kit pre-pr-review <feature-ref>`๋ฅผ ์‹คํ–‰ํ•ด ๋ฆฌ๋ทฐ ๋‚ด์šฉ์„ `decisions.md`์— ๊ธฐ๋กํ•˜๊ณ  `PR ์ „ ๋ฆฌ๋ทฐ Evidence/Decision`์„ ๋™๊ธฐํ™”ํ•ฉ๋‹ˆ๋‹ค.
26
26
  6. `PR ์ „ ๋ฆฌ๋ทฐ Evidence`๋Š” ์‹ค์ œ ์กด์žฌํ•˜๋Š” ๋ฌธ์„œ ๊ฒฝ๋กœ๋ฅผ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. (`workflow.prePrReview.evidenceMode=path_required` ๊ธฐ๋ณธ)
27
- 7. `PR ์ „ ๋ฆฌ๋ทฐ Decision`์€ `๊ฒฐ์ •: approve|changes_requested|blocked ...` (๋˜๋Š” `decision: ...`) ํ˜•์‹์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
28
- 8. PR ์ƒ์„ฑ ๋‹จ๊ณ„๋กœ ์ด๋™ํ•˜๊ธฐ ์ „ ์ตœ์ข… Decision์ด `approve`์ธ์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
27
+ 7. `decisions.md`์— `Pre-PR Review Log`(๋˜๋Š” `PR ์ „ ๋ฆฌ๋ทฐ ๋กœ๊ทธ`) ์„น์…˜์„ ๋‘๊ณ  `Summary`/`Decision`์„ placeholder ์—†์ด ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค.
28
+ 8. ์ฝ”๋“œ๋ฆฌ๋ทฐ ๋‹จ๊ณ„์—์„œ๋„ `PR ๋ฆฌ๋ทฐ Evidence/Decision`๊ณผ `decisions.md`๋ฅผ ๋™๊ธฐํ™”ํ•˜๊ณ  `PR Review Log`(๋˜๋Š” `PR ๋ฆฌ๋ทฐ ๋กœ๊ทธ`)์˜ `Summary`/`Decision`์„ ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค.
29
+ 9. `PR ์ „ ๋ฆฌ๋ทฐ Decision`์€ `๊ฒฐ์ •: approve|changes_requested|blocked ...` (๋˜๋Š” `decision: ...`) ํ˜•์‹์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค.
30
+ 10. PR ์ƒ์„ฑ ๋‹จ๊ณ„๋กœ ์ด๋™ํ•˜๊ธฐ ์ „ ์ตœ์ข… Decision์ด `approve`์ธ์ง€ ํ™•์ธํ•ฉ๋‹ˆ๋‹ค.
29
31
 
30
32
  ---
31
33
 
@@ -26,6 +26,7 @@ CLI๊ฐ€ ๊ฐ€๋ฆฌํ‚ค๋Š” **Active Task** ๋˜๋Š” **`๐Ÿ‘‰ Next Options (Atomic)`์˜ ๋‹จ
26
26
  - ์Šน์ธ ๋Œ€๊ธฐ ์—ฌ๋ถ€๋Š” `context --json-compact`์˜ `approvalRequest.required`๋ฅผ SSOT๋กœ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค. (`--json`์€ ์ƒ์„ธ ๋””๋ฒ„๊น…์ด ํ•„์š”ํ•  ๋•Œ๋งŒ ์‚ฌ์šฉ) `false`๋ฉด ๋ผ๋ฒจ ์Šน์ธ ์—†์ด ์ง„ํ–‰ํ•˜๊ณ , `true`๋ฉด ๋ผ๋ฒจ ๊ทœ์น™(`A`, `A OK`)์œผ๋กœ ์Šน์ธ ํ›„ ์ง„ํ–‰ํ•ฉ๋‹ˆ๋‹ค.
27
27
  - ๊ธฐ๋ณธ ์‹คํ–‰ ๋ชจ๋ธ์€ **๋ฉ”์ธ ์—์ด์ „ํŠธ ์˜ค์ผ€์ŠคํŠธ๋ ˆ์ด์…˜ + ์„ ํƒ์  ์„œ๋ธŒ ์—์ด์ „ํŠธ ์‹คํ–‰**์ž…๋‹ˆ๋‹ค. ์งง์€ ๋‹จ๊ณ„(spec/plan/tasks ์Šน์ธ, ์ด์Šˆ/PR ๋ฉ”ํƒ€ ๋™๊ธฐํ™” ๋“ฑ)๋Š” ๋ฉ”์ธ ์—์ด์ „ํŠธ๊ฐ€ ์ง์ ‘ ์ฒ˜๋ฆฌํ•˜๊ณ , ์žฅ์‹œ๊ฐ„ ๋ฃจํ”„(`task_execute`, `code_review`, `review_fix_commit`, `pre_pr_review`, auto-run)๋Š” ์„œ๋ธŒ ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.
28
28
  - `agentOrchestration.currentActionShouldDelegate=true`์ด๊ณ  ์„ ํƒํ•œ ์˜ต์…˜์ด `actionType="command"`๋ฉด ์œ„์ž„์ด ํ•„์ˆ˜์ž…๋‹ˆ๋‹ค. ๋จผ์ € `spawn_agent`๋ฅผ ํ˜ธ์ถœํ•˜๊ณ , ํ•ด๋‹น ๋ช…๋ น์„ ๋ฉ”์ธ ์—์ด์ „ํŠธ์—์„œ ์ง์ ‘ ์‹คํ–‰ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
29
+ - `agentOrchestration.autoRunShouldDelegate=true`๋ฉด auto ๋ฃจํ”„(`autoRun.command`, `flow --auto-*`)๋ฅผ ์„œ๋ธŒ ์—์ด์ „ํŠธ์— ์œ„์ž„ํ•ฉ๋‹ˆ๋‹ค.
29
30
  - ๋ฉ”์ธ ์—์ด์ „ํŠธ fallback์€ ์„œ๋ธŒ ์—์ด์ „ํŠธ ์‹คํ–‰์ด ๋ถˆ๊ฐ€๋Šฅํ•œ ๊ฒฝ์šฐ(์˜ˆ: ๋„๊ตฌ ๋ฏธ์ง€์›, spawn ์‹คํŒจ, ๋ช…๋ น ์‹คํ–‰ ์ „ ์„œ๋ธŒ ์—์ด์ „ํŠธ ์‹คํŒจ)์—๋งŒ ํ—ˆ์šฉํ•ฉ๋‹ˆ๋‹ค. fallback ์‹คํ–‰ ์ „์—๋Š” ์‚ฌ์œ ๋ฅผ ์‚ฌ์šฉ์ž์—๊ฒŒ ํ•œ ์ค„๋กœ ๋จผ์ € ์•Œ๋ฆฝ๋‹ˆ๋‹ค.
30
31
  - `context --json-compact`์— `autoRun.available=true`๊ฐ€ ์žˆ์œผ๋ฉด `autoRun.command`๋ฅผ ์‚ฌ์šฉํ•ด ์Šน์ธ ํ•„์š” ์นดํ…Œ๊ณ ๋ฆฌ ์ „๊นŒ์ง€ ์ž๋™ ์ง„ํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
31
32
  - ์žฅ์‹œ๊ฐ„ ์ž๋™ ์‹คํ–‰์ด ํ•„์š”ํ•˜๋ฉด `flow <feature> --auto-... --start-auto --json-compact`์œผ๋กœ run id๋ฅผ ์ƒ์„ฑํ•˜๊ณ , ์ค‘๋‹จ/์••์ถ• ํ›„์—๋Š” `autoRun.run.resumeCommand`(`flow --resume <RUN_ID>`)๋ฅผ ์šฐ์„  ์‚ฌ์šฉํ•ด ์žฌ๊ฐœํ•ฉ๋‹ˆ๋‹ค. (์ƒ์„ธ ๋””๋ฒ„๊น… ํ•„๋“œ๊ฐ€ ํ•„์š”ํ•  ๋•Œ๋งŒ `--json`)
@@ -31,7 +31,7 @@
31
31
  - PR ์ƒ์„ฑ ์ „ ์ตœ์ข… ํ†ต๊ณผ ๊ธฐ์ค€์€ `approve`
32
32
  - ๊ธฐ๋ณธ ๋ฒ ์ด์Šค๋ผ์ธ์œผ๋กœ `agents/skills/create-pr.md`(`Pre-PR ๊ธฐ๋ณธ ์ฒดํฌ๋ฆฌ์ŠคํŠธ`) ๊ธฐ์ค€์„ ๋”ฐ๋ฅด์„ธ์š”
33
33
  - **PR ๋ฆฌ๋ทฐ Evidence**: -
34
- - ์˜ˆ: ํ•ด๊ฒฐ/ํ•ฉ์˜ํ•œ ์ฝ”๋ฉ˜ํŠธ ๋งํฌ, ๊ฒ€์ฆ ๋กœ๊ทธ, ๊ด€๋ จ ๋ฌธ์„œ ๊ฒฝ๋กœ
34
+ - ์˜ˆ: `์š”์•ฝ: ...`(๋˜๋Š” `summary: ...`), ๋˜๋Š” `PR Review Log`๊ฐ€ ์žˆ๋Š” `docs/features/F001-foo/decisions.md`
35
35
  - **PR ๋ฆฌ๋ทฐ Decision**: -
36
36
  - ๋ฆฌ๋ทฐ ์ง€์ ์‚ฌํ•ญ์„ ์™œ/์–ด๋–ป๊ฒŒ ๋ฐ˜์˜ํ–ˆ๋Š”์ง€ `๊ฒฐ์ •: ...`(๋˜๋Š” `decision: ...`) ํ˜•์‹์œผ๋กœ ๊ธฐ๋ก
37
37