lee-spec-kit 0.6.1 β†’ 0.6.3

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.
Files changed (28) hide show
  1. package/README.en.md +23 -2
  2. package/README.md +23 -2
  3. package/dist/index.js +1450 -737
  4. package/package.json +1 -1
  5. package/templates/en/common/agents/git-workflow.md +8 -8
  6. package/templates/en/common/agents/pr-template.md +1 -1
  7. package/templates/en/common/agents/skills/create-issue.md +24 -6
  8. package/templates/en/common/agents/skills/create-pr.md +25 -7
  9. package/templates/en/fullstack/README.md +2 -2
  10. package/templates/en/fullstack/agents/agents.md +18 -21
  11. package/templates/en/fullstack/features/feature-base/plan.md +1 -1
  12. package/templates/en/fullstack/features/feature-base/spec.md +1 -1
  13. package/templates/en/single/README.md +2 -2
  14. package/templates/en/single/agents/agents.md +18 -22
  15. package/templates/en/single/features/feature-base/plan.md +1 -1
  16. package/templates/en/single/features/feature-base/spec.md +1 -1
  17. package/templates/ko/common/agents/git-workflow.md +8 -8
  18. package/templates/ko/common/agents/pr-template.md +1 -1
  19. package/templates/ko/common/agents/skills/create-issue.md +24 -6
  20. package/templates/ko/common/agents/skills/create-pr.md +25 -7
  21. package/templates/ko/fullstack/README.md +2 -2
  22. package/templates/ko/fullstack/agents/agents.md +18 -21
  23. package/templates/ko/fullstack/features/feature-base/plan.md +1 -1
  24. package/templates/ko/fullstack/features/feature-base/spec.md +1 -1
  25. package/templates/ko/single/README.md +2 -2
  26. package/templates/ko/single/agents/agents.md +18 -21
  27. package/templates/ko/single/features/feature-base/plan.md +1 -1
  28. package/templates/ko/single/features/feature-base/spec.md +1 -1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "lee-spec-kit",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "description": "Project documentation structure generator for AI-assisted development",
5
5
  "type": "module",
6
6
  "bin": {
@@ -70,14 +70,14 @@ main
70
70
 
71
71
  ## Automation Workflow
72
72
 
73
- > πŸ“– Refer to `skills/` folder for step-by-step guides.
74
-
75
- | Workflow | Guide |
76
- | -------------- | -------------------------- |
77
- | Feature Start | `skills/create-feature.md` |
78
- | Issue Creation | `skills/create-issue.md` |
79
- | Task Execution | `skills/execute-task.md` |
80
- | PR Creation | `skills/create-pr.md` |
73
+ > πŸ“– Read each step guide first with `docs get`.
74
+
75
+ | Workflow | Guide |
76
+ | -------------- | -------------------------------------------------- |
77
+ | Feature Start | `npx lee-spec-kit docs get create-feature --json` |
78
+ | Issue Creation | `npx lee-spec-kit docs get create-issue --json` |
79
+ | Task Execution | `npx lee-spec-kit docs get execute-task --json` |
80
+ | PR Creation | `npx lee-spec-kit docs get create-pr --json` |
81
81
 
82
82
  ### Branch Creation
83
83
 
@@ -65,7 +65,7 @@ For file links within the repo in PR body, **always use current branch name**:
65
65
  ## Screenshots (Frontend / UI changes)
66
66
 
67
67
  <!-- If there are no UI changes, or if screenshot upload is disabled (e.g. `.lee-spec-kit.json` has `pr.screenshots.upload: false`), remove this section. -->
68
- > If you follow the Release assets upload flow in `skills/create-pr.md`, you can include images in the PR body without committing files to your branch.
68
+ > If you follow the Release assets upload flow in `npx lee-spec-kit docs get create-pr --json`, you can include images in the PR body without committing files to your branch.
69
69
 
70
70
  {Screenshot markdown (e.g. ![](URL))}
71
71
 
@@ -13,9 +13,22 @@ Guide for creating GitHub Issues.
13
13
 
14
14
  ## Steps
15
15
 
16
- ### 1. Prepare Issue Content
16
+ ### 1. Prepare Issue Draft
17
17
 
18
- > πŸ“– **Always refer to `issue-template.md`**
18
+ > πŸ“– **Read procedure/template via `docs get` first, then generate a draft and treat it as the source of truth.**
19
+
20
+ ```bash
21
+ # 1) Read procedure + template policy
22
+ npx lee-spec-kit docs get create-issue --json
23
+ npx lee-spec-kit docs get issue-template --json
24
+
25
+ # 2) Generate draft body (no remote action)
26
+ npx lee-spec-kit github issue F001 --json
27
+ ```
28
+
29
+ Use `docs get issue-template --json` output as the section policy,
30
+ and `github issue --json` output `body` as the first draft to review/share.
31
+ If needed, use `bodyFile` as the filesystem source.
19
32
 
20
33
  | Item | Format |
21
34
  | -------- | ------------------------------------------- |
@@ -28,12 +41,14 @@ Guide for creating GitHub Issues.
28
41
 
29
42
  > 🚨 **User Approval Required**
30
43
 
31
- Before creating issue, share and wait for approval:
44
+ Before creating issue, share and wait for explicit approval (OK):
32
45
 
33
46
  - Title
34
- - Body
47
+ - Full body draft (from `body`)
35
48
  - Labels
36
49
 
50
+ Also fill all `TODO` items in Goals/Completion Criteria before creating.
51
+
37
52
  ### 3. Create Issue
38
53
 
39
54
  ```bash
@@ -42,11 +57,14 @@ gh issue create \
42
57
  --body-file /tmp/issue-body.md \
43
58
  --assignee @me \
44
59
  --label enhancement
60
+
61
+ # Or via lee-spec-kit helper (requires explicit confirmation)
62
+ npx lee-spec-kit github issue F001 --create --confirm OK --labels enhancement
45
63
  ```
46
64
 
47
65
  ---
48
66
 
49
67
  ## Reference Documents
50
68
 
51
- - **Issue Template**: `issue-template.md`
52
- - **Link Format Rules**: `issue-template.md` > "Link Format" section
69
+ - **Draft generator**: `npx lee-spec-kit github issue <feature-name>`
70
+ - **Approval rule**: share title/body/labels first, then run `--create --confirm OK`
@@ -15,9 +15,22 @@ Guide for creating Pull Requests.
15
15
 
16
16
  ## Steps
17
17
 
18
- ### 1. Prepare PR Content
18
+ ### 1. Prepare PR Draft
19
19
 
20
- > πŸ“– **Always refer to `pr-template.md`**
20
+ > πŸ“– **Read procedure/template via `docs get` first, then generate a draft and treat it as the source of truth.**
21
+
22
+ ```bash
23
+ # 1) Read procedure + template policy
24
+ npx lee-spec-kit docs get create-pr --json
25
+ npx lee-spec-kit docs get pr-template --json
26
+
27
+ # 2) Generate draft body (no remote action)
28
+ npx lee-spec-kit github pr F001 --json
29
+ ```
30
+
31
+ Use `docs get pr-template --json` output as the section policy,
32
+ and `github pr --json` output `body` as the first PR draft body.
33
+ If needed, use `bodyFile` as the filesystem source.
21
34
 
22
35
  | Item | Format |
23
36
  | -------- | ---------------------------------- |
@@ -34,7 +47,7 @@ Guide for creating Pull Requests.
34
47
 
35
48
  1. Run relevant test commands (e.g., `npm test`, `pnpm test`); if no tests exist, request them from the user
36
49
  2. Check results (PASS/FAIL)
37
- 3. In the PR body "Tests" section, follow `pr-template.md` rules as-is. (add/check only what you actually ran)
50
+ 3. In the PR body "Tests" section, keep only what you actually ran in the generated draft body
38
51
  4. If you didn’t run any tests, request/confirm with the user before creating the PR
39
52
 
40
53
  ### 3. Prepare Screenshots / Diagrams (Include in PR Body)
@@ -106,7 +119,7 @@ echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
106
119
 
107
120
  #### Logic/structure changes (Backend PR)
108
121
 
109
- - Write a Mermaid **`sequenceDiagram`** in the PR body (follow the "Architecture Diagram" rules in `pr-template.md` as-is).
122
+ - Write a Mermaid **`sequenceDiagram`** in the PR body and keep it aligned with the generated draft format.
110
123
 
111
124
  ### 4. Request User Approval
112
125
 
@@ -115,9 +128,11 @@ echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
115
128
  Before creating PR, share the following **in a code block** and wait for **explicit approval (OK)**:
116
129
 
117
130
  - Title
118
- - Full body (`pr-template.md` format)
131
+ - Full body draft (from `body`)
119
132
  - Labels (at least 1; cannot be empty)
120
133
 
134
+ Before approval/create, fill all `TODO` items in the generated draft.
135
+
121
136
  ### 5. Create PR
122
137
 
123
138
  ```bash
@@ -127,6 +142,9 @@ gh pr create \
127
142
  --label "{label1,label2}" \
128
143
  --assignee @me \
129
144
  --base main
145
+
146
+ # Or via lee-spec-kit helper (requires explicit confirmation)
147
+ npx lee-spec-kit github pr F001 --create --confirm OK --labels enhancement
130
148
  ```
131
149
 
132
150
  ---
@@ -168,5 +186,5 @@ Use **current branch name** for file links in PR body:
168
186
 
169
187
  ## Reference Documents
170
188
 
171
- - **PR Template**: `pr-template.md`
172
- - **Git Workflow**: `git-workflow.md`
189
+ - **Draft generator**: `npx lee-spec-kit github pr <feature-name>`
190
+ - **Approval rule**: share title/body/labels first, then run `--create --confirm OK`
@@ -6,7 +6,7 @@ This documentation is organized by feature to help agents quickly understand the
6
6
 
7
7
  | Path | Purpose | Key Documents |
8
8
  | ------------------- | --------------------- | ------------------------------------------------------------- |
9
- | `docs/agents/` | Agent operating rules | `agents.md`, `constitution.md`, `git-workflow.md` |
9
+ | `docs/agents/` | Agent operating rules | `custom.md`, `constitution.md` (engine-managed guides are fetched via `npx lee-spec-kit docs get <doc-id> --json`) |
10
10
  | `docs/prd/` | Product requirements | Project-specific |
11
11
  | `docs/designs/` | Design references | `README.md` (links/guidelines/references) |
12
12
  | `docs/ideas/` | Ideas / to-dos | `README.md` (Idea β†’ Feature promotion rules) |
@@ -20,7 +20,7 @@ This documentation is organized by feature to help agents quickly understand the
20
20
  When you run `lee-spec-kit init`, it creates `.lee-spec-kit.json` in the docs root (default: `docs/`).
21
21
 
22
22
  - Used by `lee-spec-kit feature`, `status`, and `update` to detect docs location / project type / language.
23
- - `docsRepo`, `pushDocs`, `docsRemote` are metadata for the **Docs Push rules** in `/docs/agents/git-workflow.md` (the CLI does not auto-push).
23
+ - `docsRepo`, `pushDocs`, `docsRemote` are metadata for the CLI-managed **Docs Push policy** (the CLI does not auto-push).
24
24
 
25
25
  ### Fields
26
26
 
@@ -40,9 +40,10 @@ Operating rules for AI code assistants to perform consistent code generation and
40
40
 
41
41
  - **πŸ”΄ Custom Rules (Highest Priority)**: `/docs/agents/custom.md`
42
42
  - **Project Principles**: `/docs/agents/constitution.md`
43
- - **Git Workflow**: `/docs/agents/git-workflow.md`
44
- - **Issue Template**: `/docs/agents/issue-template.md`
45
- - **PR Template**: `/docs/agents/pr-template.md`
43
+ - **Agent Root Guide**: `npx lee-spec-kit docs get agents --json`
44
+ - **Git Workflow**: `npx lee-spec-kit docs get git-workflow --json`
45
+ - **Issue Procedure/Template**: `npx lee-spec-kit docs get create-issue --json` β†’ `npx lee-spec-kit docs get issue-template --json`
46
+ - **PR Procedure/Template**: `npx lee-spec-kit docs get create-pr --json` β†’ `npx lee-spec-kit docs get pr-template --json`
46
47
 
47
48
  ### PRD
48
49
 
@@ -52,7 +53,7 @@ Operating rules for AI code assistants to perform consistent code generation and
52
53
 
53
54
  - **BE Features**: `/docs/features/be/{feature-id}/`
54
55
  - **FE Features**: `/docs/features/fe/{feature-id}/`
55
- - **Template (SSOT)**: `/docs/features/feature-base/`
56
+ - **Template (SSOT)**: docs generated via `npx lee-spec-kit feature <name>`
56
57
 
57
58
  ---
58
59
 
@@ -62,16 +63,12 @@ Operating rules for AI code assistants to perform consistent code generation and
62
63
  docs/
63
64
  β”œβ”€β”€ README.md # Documentation guide
64
65
  β”œβ”€β”€ agents/ # Agent operating rules
65
- β”‚ β”œβ”€β”€ agents.md # Main rules (this file)
66
- β”‚ β”œβ”€β”€ constitution.md # Project principles
67
- β”‚ β”œβ”€β”€ git-workflow.md # Git automation
68
- β”‚ β”œβ”€β”€ issue-template.md
69
- β”‚ β”œβ”€β”€ pr-template.md
70
- β”‚ └── skills/ # Step-by-step guides
71
- β”‚ β”œβ”€β”€ create-feature.md
72
- β”‚ β”œβ”€β”€ create-issue.md
73
- β”‚ β”œβ”€β”€ create-pr.md
74
- β”‚ └── execute-task.md
66
+ β”‚ β”œβ”€β”€ custom.md # Project-specific custom rules
67
+ β”‚ └── constitution.md # Project principles
68
+ β”‚
69
+ β”‚ # Engine-managed policy guides are not synced into project docs.
70
+ β”‚ # - list: npx lee-spec-kit docs list --json
71
+ β”‚ # - example: npx lee-spec-kit docs get git-workflow --json
75
72
  β”œβ”€β”€ prd/ # Product requirements
76
73
  β”œβ”€β”€ designs/ # Design references
77
74
  β”œβ”€β”€ ideas/ # Pre-feature ideas / to-dos
@@ -85,14 +82,14 @@ docs/
85
82
 
86
83
  ## Request Type Processes
87
84
 
88
- > πŸ“– Refer to `skills/` folder for detailed process guides.
85
+ > πŸ“– Read each process guide first with `docs get`.
89
86
 
90
- | Process | Guide |
91
- | -------------- | -------------------------- |
92
- | New Feature | `skills/create-feature.md` |
93
- | GitHub Issue | `skills/create-issue.md` |
94
- | Pull Request | `skills/create-pr.md` |
95
- | Task Execution | `skills/execute-task.md` |
87
+ | Process | Guide |
88
+ | -------------- | ------------------------------------- |
89
+ | New Feature | `npx lee-spec-kit docs get create-feature --json` |
90
+ | GitHub Issue | `npx lee-spec-kit docs get create-issue --json` |
91
+ | Pull Request | `npx lee-spec-kit docs get create-pr --json` |
92
+ | Task Execution | `npx lee-spec-kit docs get execute-task --json` |
96
93
 
97
94
  ### Additional Rules (Fullstack)
98
95
 
@@ -8,7 +8,7 @@
8
8
 
9
9
  - **Feature ID**: F{number}
10
10
  - **Target Repo**: {{projectName}}-{be|fe}
11
- - **Created**: YYYY-MM-DD
11
+ - **Created**: {YYYY-MM-DD}
12
12
  - **Status**: Review | Approved
13
13
 
14
14
  ---
@@ -10,7 +10,7 @@
10
10
  - **Feature Name**: {feature-name}
11
11
  - **Target Repo**: {{projectName}}-{be|fe}
12
12
  - **Issue Number**: #{issue-number}
13
- - **Created**: YYYY-MM-DD
13
+ - **Created**: {YYYY-MM-DD}
14
14
  - **Status**: Review | Approved
15
15
 
16
16
  ---
@@ -6,7 +6,7 @@ This documentation is organized by feature to help agents quickly understand the
6
6
 
7
7
  | Path | Purpose | Key Documents |
8
8
  | ---------------- | --------------------- | ------------------------------------------------------------- |
9
- | `docs/agents/` | Agent operating rules | `agents.md`, `constitution.md`, `git-workflow.md` |
9
+ | `docs/agents/` | Agent operating rules | `custom.md`, `constitution.md` (engine-managed guides are fetched via `npx lee-spec-kit docs get <doc-id> --json`) |
10
10
  | `docs/prd/` | Product requirements | Project-specific |
11
11
  | `docs/designs/` | Design references | `README.md` (links/guidelines/references) |
12
12
  | `docs/ideas/` | Ideas / to-dos | `README.md` (Idea β†’ Feature promotion rules) |
@@ -19,7 +19,7 @@ This documentation is organized by feature to help agents quickly understand the
19
19
  When you run `lee-spec-kit init`, it creates `.lee-spec-kit.json` in the docs root (default: `docs/`).
20
20
 
21
21
  - Used by `lee-spec-kit feature`, `status`, and `update` to detect docs location / project type / language.
22
- - `docsRepo`, `pushDocs`, `docsRemote` are metadata for the **Docs Push rules** in `/docs/agents/git-workflow.md` (the CLI does not auto-push).
22
+ - `docsRepo`, `pushDocs`, `docsRemote` are metadata for the CLI-managed **Docs Push policy** (the CLI does not auto-push).
23
23
 
24
24
  ### Fields
25
25
 
@@ -40,14 +40,15 @@ Operating rules for AI code assistants to perform consistent code generation and
40
40
 
41
41
  - **πŸ”΄ Custom Rules (Highest Priority)**: `/docs/agents/custom.md`
42
42
  - **Project Principles**: `/docs/agents/constitution.md`
43
- - **Git Workflow**: `/docs/agents/git-workflow.md`
44
- - **Issue Template**: `/docs/agents/issue-template.md`
45
- - **PR Template**: `/docs/agents/pr-template.md`
43
+ - **Agent Root Guide**: `npx lee-spec-kit docs get agents --json`
44
+ - **Git Workflow**: `npx lee-spec-kit docs get git-workflow --json`
45
+ - **Issue Procedure/Template**: `npx lee-spec-kit docs get create-issue --json` β†’ `npx lee-spec-kit docs get issue-template --json`
46
+ - **PR Procedure/Template**: `npx lee-spec-kit docs get create-pr --json` β†’ `npx lee-spec-kit docs get pr-template --json`
46
47
 
47
48
  ### Features
48
49
 
49
50
  - **Feature Docs**: `/docs/features/{feature-id}/`
50
- - **Template (SSOT)**: `/docs/features/feature-base/`
51
+ - **Template (SSOT)**: docs generated via `npx lee-spec-kit feature <name>`
51
52
 
52
53
  ---
53
54
 
@@ -57,21 +58,16 @@ Operating rules for AI code assistants to perform consistent code generation and
57
58
  docs/
58
59
  β”œβ”€β”€ README.md # Documentation guide
59
60
  β”œβ”€β”€ agents/ # Agent operating rules
60
- β”‚ β”œβ”€β”€ agents.md # Main rules (this file)
61
- β”‚ β”œβ”€β”€ constitution.md # Project principles
62
- β”‚ β”œβ”€β”€ git-workflow.md # Git automation
63
- β”‚ β”œβ”€β”€ issue-template.md
64
- β”‚ β”œβ”€β”€ pr-template.md
65
- β”‚ └── skills/ # Step-by-step guides
66
- β”‚ β”œβ”€β”€ create-feature.md
67
- β”‚ β”œβ”€β”€ create-issue.md
68
- β”‚ β”œβ”€β”€ create-pr.md
69
- β”‚ └── execute-task.md
61
+ β”‚ β”œβ”€β”€ custom.md # Project-specific custom rules
62
+ β”‚ └── constitution.md # Project principles
63
+ β”‚
64
+ β”‚ # Engine-managed policy guides are not synced into project docs.
65
+ β”‚ # - list: npx lee-spec-kit docs list --json
66
+ β”‚ # - example: npx lee-spec-kit docs get git-workflow --json
70
67
  β”œβ”€β”€ prd/ # Product requirements
71
68
  β”œβ”€β”€ designs/ # Design references
72
69
  β”œβ”€β”€ ideas/ # Pre-feature ideas / to-dos
73
70
  β”œβ”€β”€ features/ # Feature documentation
74
- β”‚ β”œβ”€β”€ feature-base/ # Template
75
71
  β”‚ └── F00X-{name}/
76
72
  └── scripts/ # Utilities
77
73
  ```
@@ -80,14 +76,14 @@ docs/
80
76
 
81
77
  ## Request Type Processes
82
78
 
83
- > πŸ“– Refer to `skills/` folder for detailed process guides.
79
+ > πŸ“– Read each process guide first with `docs get`.
84
80
 
85
- | Process | Guide |
86
- | -------------- | -------------------------- |
87
- | New Feature | `skills/create-feature.md` |
88
- | GitHub Issue | `skills/create-issue.md` |
89
- | Pull Request | `skills/create-pr.md` |
90
- | Task Execution | `skills/execute-task.md` |
81
+ | Process | Guide |
82
+ | -------------- | ------------------------------------- |
83
+ | New Feature | `npx lee-spec-kit docs get create-feature --json` |
84
+ | GitHub Issue | `npx lee-spec-kit docs get create-issue --json` |
85
+ | Pull Request | `npx lee-spec-kit docs get create-pr --json` |
86
+ | Task Execution | `npx lee-spec-kit docs get execute-task --json` |
91
87
 
92
88
  ---
93
89
 
@@ -8,7 +8,7 @@
8
8
 
9
9
  - **Feature ID**: F{number}
10
10
  - **Target Repo**: {{projectName}}
11
- - **Created**: YYYY-MM-DD
11
+ - **Created**: {YYYY-MM-DD}
12
12
  - **Status**: Review | Approved
13
13
 
14
14
  ---
@@ -10,7 +10,7 @@
10
10
  - **Feature Name**: {feature-name}
11
11
  - **Target Repo**: {{projectName}}
12
12
  - **Issue Number**: #{issue-number}
13
- - **Created**: YYYY-MM-DD
13
+ - **Created**: {YYYY-MM-DD}
14
14
  - **Status**: Review | Approved
15
15
 
16
16
  ---
@@ -70,14 +70,14 @@ main
70
70
 
71
71
  ## μžλ™ν™” μ›Œν¬ν”Œλ‘œμš°
72
72
 
73
- > πŸ“– 단계별 상세 κ°€μ΄λ“œλŠ” `skills/` 폴더λ₯Ό μ°Έμ‘°ν•˜μ„Έμš”.
74
-
75
- | μ›Œν¬ν”Œλ‘œμš° | κ°€μ΄λ“œ |
76
- | ------------ | -------------------------- |
77
- | Feature μ‹œμž‘ | `skills/create-feature.md` |
78
- | Issue 생성 | `skills/create-issue.md` |
79
- | νƒœμŠ€ν¬ μ‹€ν–‰ | `skills/execute-task.md` |
80
- | PR 생성 | `skills/create-pr.md` |
73
+ > πŸ“– 단계별 상세 κ°€μ΄λ“œλŠ” `docs get` λͺ…λ ΉμœΌλ‘œ λ¨Όμ € ν™•μΈν•˜μ„Έμš”.
74
+
75
+ | μ›Œν¬ν”Œλ‘œμš° | κ°€μ΄λ“œ |
76
+ | ------------ | -------------------------------------------------- |
77
+ | Feature μ‹œμž‘ | `npx lee-spec-kit docs get create-feature --json` |
78
+ | Issue 생성 | `npx lee-spec-kit docs get create-issue --json` |
79
+ | νƒœμŠ€ν¬ μ‹€ν–‰ | `npx lee-spec-kit docs get execute-task --json` |
80
+ | PR 생성 | `npx lee-spec-kit docs get create-pr --json` |
81
81
 
82
82
  ### 브랜치 생성
83
83
 
@@ -63,7 +63,7 @@ PR λ³Έλ¬Έμ—μ„œ 레포 λ‚΄ 파일 λ§ν¬λŠ” **λ°˜λ“œμ‹œ ν˜„μž¬ 브랜치λͺ…을
63
63
  ## μŠ€ν¬λ¦°μƒ· (ν”„λ‘ νŠΈμ—”λ“œ / UI λ³€κ²½ μ‹œ)
64
64
 
65
65
  <!-- UI 변경이 μ•„λ‹ˆκ±°λ‚˜, μŠ€ν¬λ¦°μƒ·μ„ μ—…λ‘œλ“œν•˜μ§€ μ•Šμ•˜λ‹€λ©΄(예: `.lee-spec-kit.json`의 `pr.screenshots.upload: false`) 이 μ„Ήμ…˜μ€ μ œκ±°ν•˜μ„Έμš”. -->
66
- > `skills/create-pr.md`의 Release assets μ—…λ‘œλ“œ 절차λ₯Ό μ‚¬μš©ν•˜λ©΄ λΈŒλžœμΉ˜μ— νŒŒμΌμ„ μ»€λ°‹ν•˜μ§€ μ•Šκ³ λ„ 이미지λ₯Ό 본문에 포함할 수 μžˆμŠ΅λ‹ˆλ‹€.
66
+ > `npx lee-spec-kit docs get create-pr --json`의 Release assets μ—…λ‘œλ“œ 절차λ₯Ό μ‚¬μš©ν•˜λ©΄ λΈŒλžœμΉ˜μ— νŒŒμΌμ„ μ»€λ°‹ν•˜μ§€ μ•Šκ³ λ„ 이미지λ₯Ό 본문에 포함할 수 μžˆμŠ΅λ‹ˆλ‹€.
67
67
 
68
68
  {μŠ€ν¬λ¦°μƒ· λ§ˆν¬λ‹€μš΄ (예: ![](URL))}
69
69
 
@@ -13,9 +13,22 @@ GitHub Issueλ₯Ό 생성할 λ•Œ λ”°λ₯΄λŠ” κ°€μ΄λ“œμž…λ‹ˆλ‹€.
13
13
 
14
14
  ## 단계
15
15
 
16
- ### 1. 이슈 λ‚΄μš© μž‘μ„±
16
+ ### 1. 이슈 μ΄ˆμ•ˆ μž‘μ„±
17
17
 
18
- > πŸ“– **`issue-template.md`λ₯Ό λ°˜λ“œμ‹œ μ°Έμ‘°ν•˜μ„Έμš”.**
18
+ > πŸ“– **λ¨Όμ € `docs get`으둜 절차/ν…œν”Œλ¦Ώμ„ 읽고, μ΄ˆμ•ˆμ„ 생성해 κΈ°μ€€μœΌλ‘œ μ‚¬μš©ν•˜μ„Έμš”.**
19
+
20
+ ```bash
21
+ # 1) 절차/ν…œν”Œλ¦Ώ μ •μ±… 확인
22
+ npx lee-spec-kit docs get create-issue --json
23
+ npx lee-spec-kit docs get issue-template --json
24
+
25
+ # 2) μ΄ˆμ•ˆ λ³Έλ¬Έ 생성 (원격 μž‘μ—… μ•„λ‹˜)
26
+ npx lee-spec-kit github issue F001 --json
27
+ ```
28
+
29
+ `docs get issue-template --json` 좜λ ₯은 μ„Ήμ…˜ μ •μ±…μœΌλ‘œ 보고,
30
+ `github issue --json`의 `body`λ₯Ό μš°μ„  λ³Έλ¬Έ μ΄ˆμ•ˆμœΌλ‘œ μ‚¬μš©ν•˜μ„Έμš”.
31
+ ν•„μš”ν•˜λ©΄ `bodyFile` 경둜 νŒŒμΌμ„ ν•¨κ»˜ μ°Έκ³ ν•˜μ„Έμš”.
19
32
 
20
33
  | ν•­λͺ© | ν˜•μ‹ |
21
34
  | ------ | ---------------------------------------- |
@@ -28,12 +41,14 @@ GitHub Issueλ₯Ό 생성할 λ•Œ λ”°λ₯΄λŠ” κ°€μ΄λ“œμž…λ‹ˆλ‹€.
28
41
 
29
42
  > 🚨 **μ‚¬μš©μž 확인 ν•„μˆ˜**
30
43
 
31
- 이슈 생성 μ „ λ‹€μŒ λ‚΄μš©μ„ κ³΅μœ ν•˜κ³  승인 λŒ€κΈ°:
44
+ 이슈 생성 μ „ λ‹€μŒ λ‚΄μš©μ„ κ³΅μœ ν•˜κ³  λͺ…μ‹œμ  승인(OK) λŒ€κΈ°:
32
45
 
33
46
  - 제λͺ©
34
- - λ³Έλ¬Έ
47
+ - λ³Έλ¬Έ 전체 μ΄ˆμ•ˆ (`body` κΈ°μ€€)
35
48
  - 라벨
36
49
 
50
+ 생성 μ „ λͺ©ν‘œ/μ™„λ£Œ κΈ°μ€€ μ„Ήμ…˜μ˜ `TODO` ν•­λͺ©μ„ λͺ¨λ‘ μ±„μš°μ„Έμš”.
51
+
37
52
  ### 3. 이슈 생성
38
53
 
39
54
  ```bash
@@ -42,11 +57,14 @@ gh issue create \
42
57
  --body-file /tmp/issue-body.md \
43
58
  --assignee @me \
44
59
  --label enhancement
60
+
61
+ # λ˜λŠ” lee-spec-kit helper μ‚¬μš© (λͺ…μ‹œμ  승인 ν•„μš”)
62
+ npx lee-spec-kit github issue F001 --create --confirm OK --labels enhancement
45
63
  ```
46
64
 
47
65
  ---
48
66
 
49
67
  ## μ°Έμ‘° λ¬Έμ„œ
50
68
 
51
- - **이슈 ν…œν”Œλ¦Ώ**: `issue-template.md`
52
- - **링크 ν˜•μ‹ κ·œμΉ™**: `issue-template.md` > "링크 ν˜•μ‹" μ„Ήμ…˜
69
+ - **μ΄ˆμ•ˆ 생성기**: `npx lee-spec-kit github issue <feature-name>`
70
+ - **승인 κ·œμΉ™**: 제λͺ©/λ³Έλ¬Έ/라벨 곡유 ν›„ `--create --confirm OK` μ‹€ν–‰
@@ -15,9 +15,22 @@ Pull Requestλ₯Ό 생성할 λ•Œ λ”°λ₯΄λŠ” κ°€μ΄λ“œμž…λ‹ˆλ‹€.
15
15
 
16
16
  ## 단계
17
17
 
18
- ### 1. PR λ‚΄μš© μž‘μ„±
18
+ ### 1. PR μ΄ˆμ•ˆ μž‘μ„±
19
19
 
20
- > πŸ“– **`pr-template.md`λ₯Ό λ°˜λ“œμ‹œ μ°Έμ‘°ν•˜μ„Έμš”.**
20
+ > πŸ“– **λ¨Όμ € `docs get`으둜 절차/ν…œν”Œλ¦Ώμ„ 읽고, μ΄ˆμ•ˆμ„ 생성해 κΈ°μ€€μœΌλ‘œ μ‚¬μš©ν•˜μ„Έμš”.**
21
+
22
+ ```bash
23
+ # 1) 절차/ν…œν”Œλ¦Ώ μ •μ±… 확인
24
+ npx lee-spec-kit docs get create-pr --json
25
+ npx lee-spec-kit docs get pr-template --json
26
+
27
+ # 2) μ΄ˆμ•ˆ λ³Έλ¬Έ 생성 (원격 μž‘μ—… μ•„λ‹˜)
28
+ npx lee-spec-kit github pr F001 --json
29
+ ```
30
+
31
+ `docs get pr-template --json` 좜λ ₯은 μ„Ήμ…˜ μ •μ±…μœΌλ‘œ 보고,
32
+ `github pr --json`의 `body`λ₯Ό μš°μ„  PR μ΄ˆμ•ˆ 본문으둜 μ‚¬μš©ν•˜μ„Έμš”.
33
+ ν•„μš”ν•˜λ©΄ `bodyFile` 경둜 νŒŒμΌμ„ ν•¨κ»˜ μ°Έκ³ ν•˜μ„Έμš”.
21
34
 
22
35
  | ν•­λͺ© | ν˜•μ‹ |
23
36
  | ------ | ---------------------------------- |
@@ -34,7 +47,7 @@ Pull Requestλ₯Ό 생성할 λ•Œ λ”°λ₯΄λŠ” κ°€μ΄λ“œμž…λ‹ˆλ‹€.
34
47
 
35
48
  1. μž‘μ—…κ³Ό κ΄€λ ¨λœ ν…ŒμŠ€νŠΈ λͺ…λ Ήμ–΄ μ‹€ν–‰ (예: `npm test`, `pnpm test`), ν…ŒμŠ€νŠΈκ°€ μ—†λŠ” 경우 μ‚¬μš©μžμ—κ²Œ μš”μ²­
36
49
  2. κ²°κ³Ό 확인 (PASS/FAIL)
37
- 3. PR λ³Έλ¬Έ "ν…ŒμŠ€νŠΈ" μ„Ήμ…˜μ€ `pr-template.md`의 κ·œμΉ™μ„ κ·ΈλŒ€λ‘œ λ”°λ¦…λ‹ˆλ‹€. (μ‹€ν–‰ν•œ ν…ŒμŠ€νŠΈλ§Œ μΆ”κ°€/체크)
50
+ 3. PR λ³Έλ¬Έ "ν…ŒμŠ€νŠΈ" μ„Ήμ…˜μ€ μƒμ„±λœ μ΄ˆμ•ˆ κΈ°μ€€μœΌλ‘œ, μ‹€μ œ μ‹€ν–‰ν•œ ν…ŒμŠ€νŠΈλ§Œ λ°˜μ˜ν•©λ‹ˆλ‹€.
38
51
  4. ν…ŒμŠ€νŠΈλ₯Ό μ‹€ν–‰ν•˜μ§€ μ•Šμ•˜λ‹€λ©΄, PR 생성 전에 μ‚¬μš©μžμ—κ²Œ μš”μ²­/ν™•μΈν•©λ‹ˆλ‹€.
39
52
 
40
53
  ### 3. μŠ€ν¬λ¦°μƒ·/λ‹€μ΄μ–΄κ·Έλž¨ μž‘μ„± (PR 본문에 포함)
@@ -106,7 +119,7 @@ echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
106
119
 
107
120
  #### 둜직/ꡬ쑰 λ³€κ²½ (λ°±μ—”λ“œ PR)
108
121
 
109
- - PR 본문에 Mermaid **`sequenceDiagram`**을 μž‘μ„±ν•©λ‹ˆλ‹€. (`pr-template.md`의 "μ•„ν‚€ν…μ²˜ λ‹€μ΄μ–΄κ·Έλž¨" μ„Ήμ…˜ κ·œμΉ™μ„ κ·ΈλŒ€λ‘œ λ”°λ₯΄μ„Έμš”)
122
+ - PR 본문에 Mermaid **`sequenceDiagram`**을 μž‘μ„±ν•˜κ³ , μƒμ„±λœ μ΄ˆμ•ˆ ν˜•μ‹κ³Ό μΌμΉ˜ν•˜κ²Œ μœ μ§€ν•©λ‹ˆλ‹€.
110
123
 
111
124
  ### 4. μ‚¬μš©μž 확인 μš”μ²­
112
125
 
@@ -115,9 +128,11 @@ echo \"![](https://github.com/${REPO}/releases/download/${TAG}/ui-1.png)\"
115
128
  PR 생성 μ „ λ‹€μŒ λ‚΄μš©μ„ **μ½”λ“œλΈ”λ‘μœΌλ‘œ** μ‚¬μš©μžμ—κ²Œ κ³΅μœ ν•˜κ³  **λͺ…μ‹œμ  승인(OK)** λŒ€κΈ°:
116
129
 
117
130
  - 제λͺ©
118
- - λ³Έλ¬Έ 전체 (`pr-template.md` ν˜•μ‹)
131
+ - λ³Έλ¬Έ 전체 μ΄ˆμ•ˆ (`body` κΈ°μ€€)
119
132
  - 라벨(μ΅œμ†Œ 1개, λΉ„μ›Œλ‘˜ 수 μ—†μŒ)
120
133
 
134
+ 승인/생성 전에 μƒμ„±λœ μ΄ˆμ•ˆμ˜ `TODO` ν•­λͺ©μ„ λͺ¨λ‘ μ±„μš°μ„Έμš”.
135
+
121
136
  ### 5. PR 생성
122
137
 
123
138
  ```bash
@@ -127,6 +142,9 @@ gh pr create \
127
142
  --label "{라벨1,라벨2}" \
128
143
  --assignee @me \
129
144
  --base main
145
+
146
+ # λ˜λŠ” lee-spec-kit helper μ‚¬μš© (λͺ…μ‹œμ  승인 ν•„μš”)
147
+ npx lee-spec-kit github pr F001 --create --confirm OK --labels enhancement
130
148
  ```
131
149
 
132
150
  ---
@@ -168,5 +186,5 @@ PR 본문의 파일 λ§ν¬λŠ” **ν˜„μž¬ 브랜치λͺ…**을 μ‚¬μš©:
168
186
 
169
187
  ## μ°Έμ‘° λ¬Έμ„œ
170
188
 
171
- - **PR ν…œν”Œλ¦Ώ**: `pr-template.md`
172
- - **Git μ›Œν¬ν”Œλ‘œμš°**: `git-workflow.md`
189
+ - **μ΄ˆμ•ˆ 생성기**: `npx lee-spec-kit github pr <feature-name>`
190
+ - **승인 κ·œμΉ™**: 제λͺ©/λ³Έλ¬Έ/라벨 곡유 ν›„ `--create --confirm OK` μ‹€ν–‰
@@ -6,7 +6,7 @@
6
6
 
7
7
  | 경둜 | λͺ©μ  | 핡심 λ¬Έμ„œ/μ—­ν•  |
8
8
  | ------------------- | -------------------- | ------------------------------------------------------------- |
9
- | `docs/agents/` | μ—μ΄μ „νŠΈ 운영 κ·œμΉ™ | `agents.md`, `constitution.md`, `git-workflow.md` |
9
+ | `docs/agents/` | μ—μ΄μ „νŠΈ 운영 κ·œμΉ™ | `custom.md`, `constitution.md` (μ—”μ§„ 쒅속 κ°€μ΄λ“œλŠ” `npx lee-spec-kit docs get <doc-id> --json`으둜 쑰회) |
10
10
  | `docs/prd/` | μ œν’ˆ μš”κ΅¬μ‚¬ν•­ | ν”„λ‘œμ νŠΈλ³„ μž‘μ„± |
11
11
  | `docs/designs/` | λ””μžμΈ μ°Έκ³  자료 | `README.md` (링크/κ°€μ΄λ“œ/레퍼런슀) |
12
12
  | `docs/ideas/` | 아이디어/To-do | `README.md` (Idea β†’ Feature 승격 κ·œμΉ™) |
@@ -20,7 +20,7 @@
20
20
  `lee-spec-kit init`을 μ‹€ν–‰ν•˜λ©΄ λ¬Έμ„œ 루트(κΈ°λ³Έ: `docs/`)에 `.lee-spec-kit.json`이 μƒμ„±λ©λ‹ˆλ‹€.
21
21
 
22
22
  - `lee-spec-kit feature`, `status`, `update`μ—μ„œ λ¬Έμ„œ μœ„μΉ˜/ν”„λ‘œμ νŠΈ νƒ€μž…/μ–Έμ–΄λ₯Ό κ°μ§€ν•˜λŠ” μš©λ„λ‘œ μ‚¬μš©λ©λ‹ˆλ‹€.
23
- - `docsRepo`, `pushDocs`, `docsRemote`λŠ” `/docs/agents/git-workflow.md`의 **Docs Push κ·œμΉ™**을 μœ„ν•œ λ©”νƒ€λ°μ΄ν„°μž…λ‹ˆλ‹€. (μžλ™ pushλŠ” ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€)
23
+ - `docsRepo`, `pushDocs`, `docsRemote`λŠ” CLI 관리 **Docs Push μ •μ±…**을 μœ„ν•œ λ©”νƒ€λ°μ΄ν„°μž…λ‹ˆλ‹€. (μžλ™ pushλŠ” ν•˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€)
24
24
 
25
25
  ### ν•„λ“œ
26
26
 
@@ -40,9 +40,10 @@
40
40
 
41
41
  - **πŸ”΄ μ»€μŠ€ν…€ κ·œμΉ™ (μ΅œμš°μ„ )**: `/docs/agents/custom.md`
42
42
  - **ν”„λ‘œμ νŠΈ 원칙**: `/docs/agents/constitution.md`
43
- - **Git μ›Œν¬ν”Œλ‘œμš°**: `/docs/agents/git-workflow.md`
44
- - **이슈 ν…œν”Œλ¦Ώ**: `/docs/agents/issue-template.md`
45
- - **PR ν…œν”Œλ¦Ώ**: `/docs/agents/pr-template.md`
43
+ - **μ—μ΄μ „νŠΈ 루트 κ°€μ΄λ“œ**: `npx lee-spec-kit docs get agents --json`
44
+ - **Git μ›Œν¬ν”Œλ‘œμš°**: `npx lee-spec-kit docs get git-workflow --json`
45
+ - **이슈 절차/ν…œν”Œλ¦Ώ**: `npx lee-spec-kit docs get create-issue --json` β†’ `npx lee-spec-kit docs get issue-template --json`
46
+ - **PR 절차/ν…œν”Œλ¦Ώ**: `npx lee-spec-kit docs get create-pr --json` β†’ `npx lee-spec-kit docs get pr-template --json`
46
47
 
47
48
  ### PRD
48
49
 
@@ -52,7 +53,7 @@
52
53
 
53
54
  - **BE κΈ°λŠ₯**: `/docs/features/be/{feature-id}/`
54
55
  - **FE κΈ°λŠ₯**: `/docs/features/fe/{feature-id}/`
55
- - **ν…œν”Œλ¦Ώ (SSOT)**: `/docs/features/feature-base/` (spec, plan, tasks, decisions)
56
+ - **ν…œν”Œλ¦Ώ (SSOT)**: `npx lee-spec-kit feature <name>`둜 μƒμ„±λœ λ¬Έμ„œ ꡬ쑰 (spec, plan, tasks, decisions)
56
57
 
57
58
  ---
58
59
 
@@ -62,16 +63,12 @@
62
63
  docs/
63
64
  β”œβ”€β”€ README.md # λ¬Έμ„œ μ•ˆλ‚΄
64
65
  β”œβ”€β”€ agents/ # μ—μ΄μ „νŠΈ 운영 κ·œμΉ™
65
- β”‚ β”œβ”€β”€ agents.md # 메인 κ·œμΉ™ (이 파일)
66
- β”‚ β”œβ”€β”€ constitution.md # ν”„λ‘œμ νŠΈ 원칙
67
- β”‚ β”œβ”€β”€ git-workflow.md # Git μžλ™ν™”
68
- β”‚ β”œβ”€β”€ issue-template.md
69
- β”‚ β”œβ”€β”€ pr-template.md
70
- β”‚ └── skills/ # 단계별 κ°€μ΄λ“œ
71
- β”‚ β”œβ”€β”€ create-feature.md
72
- β”‚ β”œβ”€β”€ create-issue.md
73
- β”‚ β”œβ”€β”€ create-pr.md
74
- β”‚ └── execute-task.md
66
+ β”‚ β”œβ”€β”€ custom.md # ν”„λ‘œμ νŠΈλ³„ μ»€μŠ€ν…€ κ·œμΉ™
67
+ β”‚ └── constitution.md # ν”„λ‘œμ νŠΈ 원칙
68
+ β”‚
69
+ β”‚ # μ—”μ§„ 쒅속 κ°€μ΄λ“œλŠ” ν”„λ‘œμ νŠΈ docs에 λ™κΈ°ν™”λ˜μ§€ μ•ŠμŠ΅λ‹ˆλ‹€.
70
+ β”‚ # - 쑰회: npx lee-spec-kit docs list --json
71
+ β”‚ # - μ˜ˆμ‹œ: npx lee-spec-kit docs get git-workflow --json
75
72
  β”œβ”€β”€ prd/ # μ œν’ˆ μš”κ΅¬μ‚¬ν•­
76
73
  β”œβ”€β”€ designs/ # λ””μžμΈ μ°Έκ³  자료
77
74
  β”œβ”€β”€ ideas/ # 아이디어/To-do (Feature 승격 μ „)
@@ -101,14 +98,14 @@ docs/
101
98
 
102
99
  ## μš”μ²­ μœ ν˜•λ³„ ν”„λ‘œμ„ΈμŠ€
103
100
 
104
- > πŸ“– 각 ν”„λ‘œμ„ΈμŠ€μ˜ 상세 κ°€μ΄λ“œλŠ” `skills/` 폴더λ₯Ό μ°Έμ‘°ν•˜μ„Έμš”.
101
+ > πŸ“– 각 ν”„λ‘œμ„ΈμŠ€μ˜ 상세 κ°€μ΄λ“œλŠ” `docs get` λͺ…λ ΉμœΌλ‘œ λ¨Όμ € μ‘°νšŒν•˜μ„Έμš”.
105
102
 
106
- | ν”„λ‘œμ„ΈμŠ€ | κ°€μ΄λ“œ |
107
- | ----------------- | -------------------------- |
108
- | μƒˆ κΈ°λŠ₯ μΆ”κ°€ | `skills/create-feature.md` |
109
- | GitHub Issue 생성 | `skills/create-issue.md` |
110
- | Pull Request 생성 | `skills/create-pr.md` |
111
- | νƒœμŠ€ν¬ μ‹€ν–‰ | `skills/execute-task.md` |
103
+ | ν”„λ‘œμ„ΈμŠ€ | κ°€μ΄λ“œ |
104
+ | ----------------- | --------------------------------- |
105
+ | μƒˆ κΈ°λŠ₯ μΆ”κ°€ | `npx lee-spec-kit docs get create-feature --json` |
106
+ | GitHub Issue 생성 | `npx lee-spec-kit docs get create-issue --json` |
107
+ | Pull Request 생성 | `npx lee-spec-kit docs get create-pr --json` |
108
+ | νƒœμŠ€ν¬ μ‹€ν–‰ | `npx lee-spec-kit docs get execute-task --json` |
112
109
 
113
110
  ### μΆ”κ°€ κ·œμΉ™ (Fullstack)
114
111