@silbaram/artifact-driven-agent 0.1.9 → 0.2.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 (222) hide show
  1. package/README.md +296 -25
  2. package/ai-dev-team/.ada-status.template.json +10 -10
  3. package/ai-dev-team/README.md +39 -44
  4. package/ai-dev-team/artifacts/api.md +2 -212
  5. package/ai-dev-team/artifacts/features/_template/api.md +19 -19
  6. package/ai-dev-team/artifacts/features/_template/review.md +14 -14
  7. package/ai-dev-team/artifacts/features/_template/spec.md +28 -28
  8. package/ai-dev-team/artifacts/features/_template/ui.md +14 -14
  9. package/ai-dev-team/artifacts/improvement-reports/IMP-0000-template.md +57 -57
  10. package/ai-dev-team/artifacts/project.md +2 -193
  11. package/ai-dev-team/artifacts/rfc/RFC-0000-template.md +49 -49
  12. package/core/artifacts/decision.md +72 -72
  13. package/core/artifacts/plan.md +187 -187
  14. package/core/artifacts/project.md +193 -193
  15. package/core/artifacts/sprints/_template/docs/release-notes.md +37 -37
  16. package/core/artifacts/sprints/_template/meta.md +54 -54
  17. package/core/artifacts/sprints/_template/retrospective.md +50 -50
  18. package/core/artifacts/sprints/_template/review-reports/review-template.md +49 -49
  19. package/core/artifacts/sprints/_template/tasks/task-template.md +43 -43
  20. package/core/docs-templates/mkdocs/docs/architecture/overview.md +29 -29
  21. package/core/docs-templates/mkdocs/docs/changelog.md +36 -36
  22. package/core/docs-templates/mkdocs/docs/contributing/contributing.md +60 -60
  23. package/core/docs-templates/mkdocs/docs/getting-started/configuration.md +51 -51
  24. package/core/docs-templates/mkdocs/docs/getting-started/installation.md +41 -41
  25. package/core/docs-templates/mkdocs/docs/getting-started/quick-start.md +56 -56
  26. package/core/docs-templates/mkdocs/docs/guides/api-reference.md +83 -83
  27. package/core/docs-templates/mkdocs/docs/index.md +32 -32
  28. package/core/docs-templates/mkdocs/mkdocs.yml +86 -86
  29. package/core/roles/analyzer.md +265 -265
  30. package/core/roles/developer.md +6 -1
  31. package/core/roles/documenter.md +226 -715
  32. package/core/roles/improver.md +461 -461
  33. package/core/roles/manager.md +574 -544
  34. package/core/roles/planner.md +398 -398
  35. package/core/roles/reviewer.md +294 -294
  36. package/core/rules/document-priority.md +198 -198
  37. package/core/rules/escalation.md +172 -172
  38. package/core/rules/iteration.md +236 -236
  39. package/core/rules/rfc.md +31 -31
  40. package/core/rules/rollback.md +218 -218
  41. package/core/skills/_template/SKILL.md +50 -0
  42. package/core/skills/clean-code/SKILL.md +177 -0
  43. package/core/skills/code-review-checklist/SKILL.md +125 -0
  44. package/core/skills/error-handling/SKILL.md +155 -0
  45. package/core/skills/talk-game-dot-design/SKILL.md +85 -0
  46. package/core/skills/talk-game-dot-design/references/asset-specs.md +57 -0
  47. package/core/skills/talk-game-dot-design/references/review-checklist.md +34 -0
  48. package/core/skills/task-writing/SKILL.md +166 -0
  49. package/core/skills/testing-patterns/SKILL.md +140 -0
  50. package/dist/bin/cli.d.ts +2 -0
  51. package/dist/bin/cli.js +121 -0
  52. package/dist/bin/cli.js.map +1 -0
  53. package/dist/src/commands/config.d.ts +4 -0
  54. package/dist/src/commands/config.js +427 -0
  55. package/dist/src/commands/config.js.map +1 -0
  56. package/dist/src/commands/docs.d.ts +12 -0
  57. package/dist/src/commands/docs.js +453 -0
  58. package/dist/src/commands/docs.js.map +1 -0
  59. package/dist/src/commands/interactive.d.ts +4 -0
  60. package/dist/src/commands/interactive.js +380 -0
  61. package/dist/src/commands/interactive.js.map +1 -0
  62. package/dist/src/commands/logs.d.ts +1 -0
  63. package/dist/src/commands/logs.js +76 -0
  64. package/dist/src/commands/logs.js.map +1 -0
  65. package/dist/src/commands/monitor.d.ts +6 -0
  66. package/dist/src/commands/monitor.js +216 -0
  67. package/dist/src/commands/monitor.js.map +1 -0
  68. package/dist/src/commands/reset.d.ts +4 -0
  69. package/dist/src/commands/reset.js +57 -0
  70. package/dist/src/commands/reset.js.map +1 -0
  71. package/dist/src/commands/run.d.ts +45 -0
  72. package/dist/src/commands/run.js +421 -0
  73. package/dist/src/commands/run.js.map +1 -0
  74. package/dist/src/commands/sessions.d.ts +5 -0
  75. package/dist/src/commands/sessions.js +563 -0
  76. package/dist/src/commands/sessions.js.map +1 -0
  77. package/dist/src/commands/setup.d.ts +1 -0
  78. package/dist/src/commands/setup.js +132 -0
  79. package/dist/src/commands/setup.js.map +1 -0
  80. package/dist/src/commands/skills.d.ts +4 -0
  81. package/dist/src/commands/skills.js +748 -0
  82. package/dist/src/commands/skills.js.map +1 -0
  83. package/dist/src/commands/sprint.d.ts +4 -0
  84. package/dist/src/commands/sprint.js +434 -0
  85. package/dist/src/commands/sprint.js.map +1 -0
  86. package/dist/src/commands/status.d.ts +1 -0
  87. package/dist/src/commands/status.js +97 -0
  88. package/dist/src/commands/status.js.map +1 -0
  89. package/dist/src/commands/upgrade.d.ts +6 -0
  90. package/dist/src/commands/upgrade.js +350 -0
  91. package/dist/src/commands/upgrade.js.map +1 -0
  92. package/dist/src/commands/validate.d.ts +8 -0
  93. package/dist/src/commands/validate.js +260 -0
  94. package/dist/src/commands/validate.js.map +1 -0
  95. package/dist/src/commands/validate.test.d.ts +1 -0
  96. package/dist/src/commands/validate.test.js +74 -0
  97. package/dist/src/commands/validate.test.js.map +1 -0
  98. package/{src/index.js → dist/src/index.d.ts} +1 -3
  99. package/dist/src/index.js +15 -0
  100. package/dist/src/index.js.map +1 -0
  101. package/dist/src/types/common.d.ts +31 -0
  102. package/dist/src/types/common.js +2 -0
  103. package/dist/src/types/common.js.map +1 -0
  104. package/dist/src/types/config.d.ts +46 -0
  105. package/dist/src/types/config.js +2 -0
  106. package/dist/src/types/config.js.map +1 -0
  107. package/dist/src/types/index.d.ts +53 -0
  108. package/dist/src/types/index.js +2 -0
  109. package/dist/src/types/index.js.map +1 -0
  110. package/dist/src/types/session.d.ts +87 -0
  111. package/dist/src/types/session.js +2 -0
  112. package/dist/src/types/session.js.map +1 -0
  113. package/dist/src/types/task.d.ts +32 -0
  114. package/dist/src/types/task.js +2 -0
  115. package/dist/src/types/task.js.map +1 -0
  116. package/dist/src/ui/dashboard.d.ts +9 -0
  117. package/dist/src/ui/dashboard.js +468 -0
  118. package/dist/src/ui/dashboard.js.map +1 -0
  119. package/dist/src/ui/keyHandler.d.ts +47 -0
  120. package/dist/src/ui/keyHandler.js +132 -0
  121. package/dist/src/ui/keyHandler.js.map +1 -0
  122. package/dist/src/ui/quickActions.d.ts +25 -0
  123. package/dist/src/ui/quickActions.js +106 -0
  124. package/dist/src/ui/quickActions.js.map +1 -0
  125. package/dist/src/utils/config.d.ts +33 -0
  126. package/dist/src/utils/config.js +135 -0
  127. package/dist/src/utils/config.js.map +1 -0
  128. package/dist/src/utils/files.d.ts +84 -0
  129. package/dist/src/utils/files.js +202 -0
  130. package/dist/src/utils/files.js.map +1 -0
  131. package/dist/src/utils/promptBuilder.d.ts +39 -0
  132. package/dist/src/utils/promptBuilder.js +726 -0
  133. package/dist/src/utils/promptBuilder.js.map +1 -0
  134. package/dist/src/utils/sessionState.d.ts +83 -0
  135. package/dist/src/utils/sessionState.js +466 -0
  136. package/dist/src/utils/sessionState.js.map +1 -0
  137. package/dist/src/utils/sessionState.process.test.d.ts +1 -0
  138. package/dist/src/utils/sessionState.process.test.js +93 -0
  139. package/dist/src/utils/sessionState.process.test.js.map +1 -0
  140. package/dist/src/utils/sessionState.test.d.ts +1 -0
  141. package/dist/src/utils/sessionState.test.js +150 -0
  142. package/dist/src/utils/sessionState.test.js.map +1 -0
  143. package/dist/src/utils/sprintUtils.d.ts +13 -0
  144. package/dist/src/utils/sprintUtils.js +129 -0
  145. package/dist/src/utils/sprintUtils.js.map +1 -0
  146. package/dist/src/utils/taskParser.d.ts +9 -0
  147. package/dist/src/utils/taskParser.js +122 -0
  148. package/dist/src/utils/taskParser.js.map +1 -0
  149. package/dist/src/utils/taskParser.test.d.ts +1 -0
  150. package/dist/src/utils/taskParser.test.js +69 -0
  151. package/dist/src/utils/taskParser.test.js.map +1 -0
  152. package/package.json +62 -47
  153. package/templates/cli/artifacts/commands.md +262 -262
  154. package/templates/cli/artifacts/output-format.md +298 -298
  155. package/templates/cli/rules/command-change.md +225 -225
  156. package/templates/game/artifacts/assets.md +148 -148
  157. package/templates/game/artifacts/game-systems.md +217 -217
  158. package/templates/game/artifacts/hud.md +199 -199
  159. package/templates/game/rules/system-change.md +184 -184
  160. package/templates/library/artifacts/changelog.md +84 -84
  161. package/templates/library/artifacts/examples.md +157 -157
  162. package/templates/library/artifacts/public-api.md +197 -197
  163. package/templates/library/rules/versioning.md +186 -186
  164. package/templates/web-dev/artifacts/api.md +212 -212
  165. package/templates/web-dev/artifacts/ui.md +104 -104
  166. package/templates/web-dev/rules/api-change.md +198 -198
  167. package/ai-dev-team/.ada-status.json +0 -10
  168. package/ai-dev-team/.ada-version +0 -6
  169. package/ai-dev-team/.current-template +0 -1
  170. package/ai-dev-team/.gitkeep +0 -0
  171. package/ai-dev-team/.sessions/logs/20260124-014551-00f04724.log +0 -5
  172. package/ai-dev-team/.sessions/logs/20260124-014623-cb2b1d44.log +0 -5
  173. package/ai-dev-team/artifacts/.gitkeep +0 -0
  174. package/ai-dev-team/artifacts/decision.md +0 -72
  175. package/ai-dev-team/artifacts/plan.md +0 -187
  176. package/ai-dev-team/artifacts/sprints/_template/docs/release-notes.md +0 -37
  177. package/ai-dev-team/artifacts/sprints/_template/meta.md +0 -54
  178. package/ai-dev-team/artifacts/sprints/_template/retrospective.md +0 -50
  179. package/ai-dev-team/artifacts/sprints/_template/review-reports/review-template.md +0 -49
  180. package/ai-dev-team/artifacts/sprints/_template/tasks/task-template.md +0 -43
  181. package/ai-dev-team/artifacts/ui.md +0 -104
  182. package/ai-dev-team/roles/.gitkeep +0 -0
  183. package/ai-dev-team/roles/analyzer.md +0 -265
  184. package/ai-dev-team/roles/developer.md +0 -222
  185. package/ai-dev-team/roles/documenter.md +0 -715
  186. package/ai-dev-team/roles/improver.md +0 -461
  187. package/ai-dev-team/roles/manager.md +0 -544
  188. package/ai-dev-team/roles/planner.md +0 -398
  189. package/ai-dev-team/roles/reviewer.md +0 -294
  190. package/ai-dev-team/rules/.gitkeep +0 -0
  191. package/ai-dev-team/rules/api-change.md +0 -198
  192. package/ai-dev-team/rules/document-priority.md +0 -199
  193. package/ai-dev-team/rules/escalation.md +0 -172
  194. package/ai-dev-team/rules/iteration.md +0 -236
  195. package/ai-dev-team/rules/rfc.md +0 -31
  196. package/ai-dev-team/rules/rollback.md +0 -218
  197. package/bin/cli.js +0 -127
  198. package/src/commands/config.js +0 -371
  199. package/src/commands/docs.js +0 -502
  200. package/src/commands/interactive.js +0 -392
  201. package/src/commands/logs.js +0 -81
  202. package/src/commands/monitor.js +0 -236
  203. package/src/commands/reset.js +0 -66
  204. package/src/commands/run.js +0 -739
  205. package/src/commands/sessions.js +0 -646
  206. package/src/commands/setup.js +0 -149
  207. package/src/commands/sprint.js +0 -503
  208. package/src/commands/status.js +0 -109
  209. package/src/commands/upgrade.js +0 -416
  210. package/src/commands/validate.js +0 -289
  211. package/src/commands/validate.test.js +0 -84
  212. package/src/ui/dashboard.js +0 -518
  213. package/src/ui/keyHandler.js +0 -147
  214. package/src/ui/quickActions.js +0 -111
  215. package/src/utils/config.js +0 -74
  216. package/src/utils/files.js +0 -201
  217. package/src/utils/sessionState.js +0 -513
  218. package/src/utils/sessionState.process.test.js +0 -101
  219. package/src/utils/sessionState.test.js +0 -183
  220. package/src/utils/sprintUtils.js +0 -134
  221. package/src/utils/taskParser.js +0 -134
  222. package/src/utils/taskParser.test.js +0 -76
@@ -1,193 +1,193 @@
1
- # Project Standards (Frozen)
2
-
3
- > 🔒 이 문서는 **Frozen** 상태입니다.
4
- > 변경 시 RFC(Request for Change) 절차 필수.
5
- > 모든 개발자는 이 문서의 규칙을 따릅니다.
6
-
7
- **작성 주체:** 사용자와 팀이 함께 프로젝트 초기에 작성합니다.
8
- **작성 시점:** plan.md 확정 후, 개발 시작 전에 작성하여 Frozen 상태로 전환합니다.
9
-
10
- ---
11
-
12
- ## ✅ 문서 완성도 체크리스트
13
-
14
- > ⚠️ 모든 필수 항목이 체크되어야 Frozen 상태로 전환 가능
15
-
16
- ### 필수 섹션 (Required)
17
- - [ ] 프로젝트 규모 정의 완료 (S/M/L)
18
- - [ ] 기술 스택 전체 항목 결정됨
19
- - [ ] 프로젝트 구조 정의됨
20
- - [ ] 명명 규칙 정의됨
21
- - [ ] 품질 기준 정의됨
22
-
23
- ### 품질 체크 (Quality)
24
- - [ ] 모든 기술 선택에 근거 명시됨
25
- - [ ] 버전 번호가 구체적으로 명시됨 (예: "1.x" 금지, "1.21.0" 필요)
26
- - [ ] 금지 사항이 명확히 정의됨
27
-
28
- ### 연결성 체크 (Linkage)
29
- - [ ] plan.md의 비기능 요구사항과 일관성 확인됨
30
-
31
- ---
32
-
33
- ## ⚠️ Frozen 문서 변경 절차 (RFC)
34
-
35
- > 이 문서가 Frozen 상태가 된 후에는 아래 절차로만 변경 가능
36
-
37
- ### RFC 절차
38
- 1. `rfc/` 디렉토리에 변경 제안서 작성
39
- - 파일명: `RFC-NNNN-<title>.md`
40
- 2. RFC 문서에 포함할 내용:
41
- - 변경 사유
42
- - 영향 범위 분석
43
- - 대안 검토
44
- - 롤백 계획
45
- 3. Manager 승인
46
- 4. decision.md에 기록
47
- 5. project.md 업데이트
48
-
49
- ### RFC 없이 변경 가능한 항목
50
- - 오타 수정
51
- - 예시 추가 (규칙 변경 없이)
52
- - 설명 보완 (의미 변경 없이)
53
-
54
- ---
55
-
56
- ## 0. 프로젝트 규모 정의 (Mandatory)
57
-
58
- | 항목 | 값 |
59
- |------|-----|
60
- | 규모 | S / M / L |
61
- | 판단 근거 | [근거] |
62
- | 핵심 기능 수 | N개 |
63
- | 예상 복잡도 | 낮음 / 중간 / 높음 |
64
-
65
- ---
66
-
67
- ## 1. 선택 요약 (Decision Summary)
68
-
69
- > 프로젝트 기술 스택 및 아키텍처 선택 사항
70
-
71
- | 항목 | 선택 | 근거 |
72
- |------|------|------|
73
- | [항목1] | [선택] | [근거] |
74
- | [항목2] | [선택] | [근거] |
75
-
76
- ---
77
-
78
- ## 2. 기술 스택 (Frozen)
79
-
80
- | 영역 | 선택 | 버전 | 비고 |
81
- |------|------|------|------|
82
- | 언어 | [선택] | [버전] | - |
83
- | 프레임워크 | [선택] | [버전] | - |
84
- | 데이터 저장 | [선택] | [버전] | - |
85
- | 테스트 | [선택] | [버전] | - |
86
- | 빌드 | [선택] | [버전] | - |
87
-
88
- ---
89
-
90
- ## 3. 아키텍처 규칙
91
-
92
- ### 3.1 프로젝트 구조
93
-
94
- ```
95
- src/
96
- ├── [디렉토리]/
97
- │ └── [설명]
98
- ├── [디렉토리]/
99
- │ └── [설명]
100
- └── [디렉토리]/
101
- └── [설명]
102
- ```
103
-
104
- ### 3.2 명명 규칙
105
-
106
- | 대상 | 규칙 | 예시 |
107
- |------|------|------|
108
- | 파일 | [규칙] | [예시] |
109
- | 클래스/구조체 | [규칙] | [예시] |
110
- | 함수/메서드 | [규칙] | [예시] |
111
- | 변수 | [규칙] | [예시] |
112
-
113
- ### 3.3 코드 스타일
114
-
115
- - 들여쓰기: [스페이스/탭, 개수]
116
- - 최대 줄 길이: [N자]
117
- - 린트 도구: [도구명]
118
- - 포매터: [도구명]
119
-
120
- ---
121
-
122
- ## 4. 품질 기준
123
-
124
- ### 4.1 테스트
125
-
126
- | 항목 | 기준 |
127
- |------|------|
128
- | 테스트 프레임워크 | [선택] |
129
- | 최소 커버리지 | [N%] |
130
- | 필수 테스트 유형 | [단위/통합/E2E] |
131
-
132
- ### 4.2 코드 품질
133
-
134
- | 항목 | 기준 |
135
- |------|------|
136
- | 린트 통과 | 필수 |
137
- | 타입 체크 | [필수/권장] |
138
- | 정적 분석 | [필수/권장] |
139
-
140
- ---
141
-
142
- ## 5. 의존성 관리
143
-
144
- ### 5.1 허용된 의존성
145
-
146
- | 패키지 | 버전 | 용도 |
147
- |--------|------|------|
148
- | [패키지명] | [버전] | [용도] |
149
-
150
- ### 5.2 의존성 추가 규칙
151
-
152
- - 새 의존성 추가 시: Manager 승인 필요
153
- - 버전 업그레이드 시: [규칙]
154
- - 금지된 패키지: [목록]
155
-
156
- ---
157
-
158
- ## 6. 문서화 규칙
159
-
160
- ### 6.1 코드 문서화
161
-
162
- - 공개 인터페이스: 문서화 필수
163
- - 내부 구현: [규칙]
164
- - 문서화 형식: [형식]
165
-
166
- ### 6.2 산출물 문서
167
-
168
- - 인터페이스 문서: [파일명]
169
- - 변경 시 갱신 필수
170
-
171
- ---
172
-
173
- ## 7. 제약 및 금지 사항 (Enforcement)
174
-
175
- ### 7.1 금지 사항
176
-
177
- - ❌ 이 문서에 없는 기술/라이브러리 도입
178
- - ❌ 규칙 무시한 코드 커밋
179
- - ❌ 문서 없는 구조 변경
180
- - ❌ Manager 승인 없는 의존성 추가
181
-
182
- ### 7.2 예외 처리
183
-
184
- - 예외 필요 시: Manager에게 에스컬레이션
185
- - 승인된 예외는 decision.md에 기록
186
-
187
- ---
188
-
189
- ## 8. 변경 이력
190
-
191
- | 버전 | 날짜 | 변경 내용 | 승인 |
192
- |------|------|----------|------|
193
- | v1.0 | YYYY-MM-DD | 초기 확정 | Manager |
1
+ # Project Standards (Frozen)
2
+
3
+ > 🔒 이 문서는 **Frozen** 상태입니다.
4
+ > 변경 시 RFC(Request for Change) 절차 필수.
5
+ > 모든 개발자는 이 문서의 규칙을 따릅니다.
6
+
7
+ **작성 주체:** 사용자와 팀이 함께 프로젝트 초기에 작성합니다.
8
+ **작성 시점:** plan.md 확정 후, 개발 시작 전에 작성하여 Frozen 상태로 전환합니다.
9
+
10
+ ---
11
+
12
+ ## ✅ 문서 완성도 체크리스트
13
+
14
+ > ⚠️ 모든 필수 항목이 체크되어야 Frozen 상태로 전환 가능
15
+
16
+ ### 필수 섹션 (Required)
17
+ - [ ] 프로젝트 규모 정의 완료 (S/M/L)
18
+ - [ ] 기술 스택 전체 항목 결정됨
19
+ - [ ] 프로젝트 구조 정의됨
20
+ - [ ] 명명 규칙 정의됨
21
+ - [ ] 품질 기준 정의됨
22
+
23
+ ### 품질 체크 (Quality)
24
+ - [ ] 모든 기술 선택에 근거 명시됨
25
+ - [ ] 버전 번호가 구체적으로 명시됨 (예: "1.x" 금지, "1.21.0" 필요)
26
+ - [ ] 금지 사항이 명확히 정의됨
27
+
28
+ ### 연결성 체크 (Linkage)
29
+ - [ ] plan.md의 비기능 요구사항과 일관성 확인됨
30
+
31
+ ---
32
+
33
+ ## ⚠️ Frozen 문서 변경 절차 (RFC)
34
+
35
+ > 이 문서가 Frozen 상태가 된 후에는 아래 절차로만 변경 가능
36
+
37
+ ### RFC 절차
38
+ 1. `rfc/` 디렉토리에 변경 제안서 작성
39
+ - 파일명: `RFC-NNNN-<title>.md`
40
+ 2. RFC 문서에 포함할 내용:
41
+ - 변경 사유
42
+ - 영향 범위 분석
43
+ - 대안 검토
44
+ - 롤백 계획
45
+ 3. Manager 승인
46
+ 4. decision.md에 기록
47
+ 5. project.md 업데이트
48
+
49
+ ### RFC 없이 변경 가능한 항목
50
+ - 오타 수정
51
+ - 예시 추가 (규칙 변경 없이)
52
+ - 설명 보완 (의미 변경 없이)
53
+
54
+ ---
55
+
56
+ ## 0. 프로젝트 규모 정의 (Mandatory)
57
+
58
+ | 항목 | 값 |
59
+ |------|-----|
60
+ | 규모 | S / M / L |
61
+ | 판단 근거 | [근거] |
62
+ | 핵심 기능 수 | N개 |
63
+ | 예상 복잡도 | 낮음 / 중간 / 높음 |
64
+
65
+ ---
66
+
67
+ ## 1. 선택 요약 (Decision Summary)
68
+
69
+ > 프로젝트 기술 스택 및 아키텍처 선택 사항
70
+
71
+ | 항목 | 선택 | 근거 |
72
+ |------|------|------|
73
+ | [항목1] | [선택] | [근거] |
74
+ | [항목2] | [선택] | [근거] |
75
+
76
+ ---
77
+
78
+ ## 2. 기술 스택 (Frozen)
79
+
80
+ | 영역 | 선택 | 버전 | 비고 |
81
+ |------|------|------|------|
82
+ | 언어 | [선택] | [버전] | - |
83
+ | 프레임워크 | [선택] | [버전] | - |
84
+ | 데이터 저장 | [선택] | [버전] | - |
85
+ | 테스트 | [선택] | [버전] | - |
86
+ | 빌드 | [선택] | [버전] | - |
87
+
88
+ ---
89
+
90
+ ## 3. 아키텍처 규칙
91
+
92
+ ### 3.1 프로젝트 구조
93
+
94
+ ```
95
+ src/
96
+ ├── [디렉토리]/
97
+ │ └── [설명]
98
+ ├── [디렉토리]/
99
+ │ └── [설명]
100
+ └── [디렉토리]/
101
+ └── [설명]
102
+ ```
103
+
104
+ ### 3.2 명명 규칙
105
+
106
+ | 대상 | 규칙 | 예시 |
107
+ |------|------|------|
108
+ | 파일 | [규칙] | [예시] |
109
+ | 클래스/구조체 | [규칙] | [예시] |
110
+ | 함수/메서드 | [규칙] | [예시] |
111
+ | 변수 | [규칙] | [예시] |
112
+
113
+ ### 3.3 코드 스타일
114
+
115
+ - 들여쓰기: [스페이스/탭, 개수]
116
+ - 최대 줄 길이: [N자]
117
+ - 린트 도구: [도구명]
118
+ - 포매터: [도구명]
119
+
120
+ ---
121
+
122
+ ## 4. 품질 기준
123
+
124
+ ### 4.1 테스트
125
+
126
+ | 항목 | 기준 |
127
+ |------|------|
128
+ | 테스트 프레임워크 | [선택] |
129
+ | 최소 커버리지 | [N%] |
130
+ | 필수 테스트 유형 | [단위/통합/E2E] |
131
+
132
+ ### 4.2 코드 품질
133
+
134
+ | 항목 | 기준 |
135
+ |------|------|
136
+ | 린트 통과 | 필수 |
137
+ | 타입 체크 | [필수/권장] |
138
+ | 정적 분석 | [필수/권장] |
139
+
140
+ ---
141
+
142
+ ## 5. 의존성 관리
143
+
144
+ ### 5.1 허용된 의존성
145
+
146
+ | 패키지 | 버전 | 용도 |
147
+ |--------|------|------|
148
+ | [패키지명] | [버전] | [용도] |
149
+
150
+ ### 5.2 의존성 추가 규칙
151
+
152
+ - 새 의존성 추가 시: Manager 승인 필요
153
+ - 버전 업그레이드 시: [규칙]
154
+ - 금지된 패키지: [목록]
155
+
156
+ ---
157
+
158
+ ## 6. 문서화 규칙
159
+
160
+ ### 6.1 코드 문서화
161
+
162
+ - 공개 인터페이스: 문서화 필수
163
+ - 내부 구현: [규칙]
164
+ - 문서화 형식: [형식]
165
+
166
+ ### 6.2 산출물 문서
167
+
168
+ - 인터페이스 문서: [파일명]
169
+ - 변경 시 갱신 필수
170
+
171
+ ---
172
+
173
+ ## 7. 제약 및 금지 사항 (Enforcement)
174
+
175
+ ### 7.1 금지 사항
176
+
177
+ - ❌ 이 문서에 없는 기술/라이브러리 도입
178
+ - ❌ 규칙 무시한 코드 커밋
179
+ - ❌ 문서 없는 구조 변경
180
+ - ❌ Manager 승인 없는 의존성 추가
181
+
182
+ ### 7.2 예외 처리
183
+
184
+ - 예외 필요 시: Manager에게 에스컬레이션
185
+ - 승인된 예외는 decision.md에 기록
186
+
187
+ ---
188
+
189
+ ## 8. 변경 이력
190
+
191
+ | 버전 | 날짜 | 변경 내용 | 승인 |
192
+ |------|------|----------|------|
193
+ | v1.0 | YYYY-MM-DD | 초기 확정 | Manager |
@@ -1,37 +1,37 @@
1
- # Release Notes - Sprint N
2
-
3
- ## 버전: v1.N.0
4
-
5
- ## 날짜: YYYY-MM-DD
6
-
7
- ### 새로운 기능
8
-
9
- - [기능명]: [설명]
10
- - [기능명]: [설명]
11
-
12
- ### 개선 사항
13
-
14
- - [개선 내용]
15
- - [개선 내용]
16
-
17
- ### 버그 수정
18
-
19
- - task-NNN: [버그 설명] → [수정 내용]
20
- - task-NNN: [버그 설명] → [수정 내용]
21
-
22
- ### Breaking Changes
23
-
24
- > ⚠️ 기존 사용자에게 영향있는 변경
25
-
26
- - [변경 내용]
27
- - Migration: [마이그레이션 가이드]
28
-
29
- ### 알려진 이슈
30
-
31
- - [알려진 문제와 임시 해결책]
32
-
33
- ### 의존성 변경
34
-
35
- - 추가: [라이브러리명@버전]
36
- - 업데이트: [라이브러리명] v1.0 → v2.0
37
- - 제거: [라이브러리명]
1
+ # Release Notes - Sprint N
2
+
3
+ ## 버전: v1.N.0
4
+
5
+ ## 날짜: YYYY-MM-DD
6
+
7
+ ### 새로운 기능
8
+
9
+ - [기능명]: [설명]
10
+ - [기능명]: [설명]
11
+
12
+ ### 개선 사항
13
+
14
+ - [개선 내용]
15
+ - [개선 내용]
16
+
17
+ ### 버그 수정
18
+
19
+ - task-NNN: [버그 설명] → [수정 내용]
20
+ - task-NNN: [버그 설명] → [수정 내용]
21
+
22
+ ### Breaking Changes
23
+
24
+ > ⚠️ 기존 사용자에게 영향있는 변경
25
+
26
+ - [변경 내용]
27
+ - Migration: [마이그레이션 가이드]
28
+
29
+ ### 알려진 이슈
30
+
31
+ - [알려진 문제와 임시 해결책]
32
+
33
+ ### 의존성 변경
34
+
35
+ - 추가: [라이브러리명@버전]
36
+ - 업데이트: [라이브러리명] v1.0 → v2.0
37
+ - 제거: [라이브러리명]
@@ -1,54 +1,54 @@
1
- # Sprint N 메타정보
2
-
3
- | 항목 | 값 |
4
- |------|-----|
5
- | 스프린트 번호 | N |
6
- | 상태 | active / completed |
7
- | 시작일 | YYYY-MM-DD |
8
- | 종료 예정 | YYYY-MM-DD (또는 완료일) |
9
- | 목표 | [스프린트 목표 설명] |
10
-
11
- ## Task 목록
12
-
13
- | Task | 제목 | 상태 | 우선순위 | 크기 |
14
- |------|------|:----:|:--------:|:----:|
15
- | task-NNN | [Task 제목] | BACKLOG | P0/P1/P2 | S/M/L |
16
-
17
- **상태 범례:**
18
- - BACKLOG: 스프린트에 할당됨, 작업 미시작
19
- - IN_DEV: 개발 중
20
- - DONE: 완료
21
- - REJECTED: 리뷰 거부 (재작업 필요)
22
-
23
- ## 이월된 Task
24
-
25
- > 이전 스프린트에서 미완료된 Task
26
-
27
- | Task | 원 스프린트 | 이월 사유 |
28
- |------|------------|----------|
29
- | - | - | - |
30
-
31
- ## 차단 사항
32
-
33
- > 현재 진행을 막고 있는 이슈
34
-
35
- | Task | 차단 사유 | 담당자 | 상태 |
36
- |------|----------|--------|------|
37
- | - | - | - | - |
38
-
39
- ## 스프린트 회고 (완료 시 작성)
40
-
41
- ### 완료된 Task
42
- - task-NNN: [설명]
43
-
44
- ### 미완료 Task (이월/취소)
45
- - task-NNN: [사유]
46
-
47
- ### 잘된 점
48
- - [내용]
49
-
50
- ### 개선할 점
51
- - [내용]
52
-
53
- ### 다음 스프린트 제안
54
- - [제안]
1
+ # Sprint N 메타정보
2
+
3
+ | 항목 | 값 |
4
+ |------|-----|
5
+ | 스프린트 번호 | N |
6
+ | 상태 | active / completed |
7
+ | 시작일 | YYYY-MM-DD |
8
+ | 종료 예정 | YYYY-MM-DD (또는 완료일) |
9
+ | 목표 | [스프린트 목표 설명] |
10
+
11
+ ## Task 목록
12
+
13
+ | Task | 제목 | 상태 | 우선순위 | 크기 |
14
+ |------|------|:----:|:--------:|:----:|
15
+ | task-NNN | [Task 제목] | BACKLOG | P0/P1/P2 | S/M/L |
16
+
17
+ **상태 범례:**
18
+ - BACKLOG: 스프린트에 할당됨, 작업 미시작
19
+ - IN_DEV: 개발 중
20
+ - DONE: 완료
21
+ - REJECTED: 리뷰 거부 (재작업 필요)
22
+
23
+ ## 이월된 Task
24
+
25
+ > 이전 스프린트에서 미완료된 Task
26
+
27
+ | Task | 원 스프린트 | 이월 사유 |
28
+ |------|------------|----------|
29
+ | - | - | - |
30
+
31
+ ## 차단 사항
32
+
33
+ > 현재 진행을 막고 있는 이슈
34
+
35
+ | Task | 차단 사유 | 담당자 | 상태 |
36
+ |------|----------|--------|------|
37
+ | - | - | - | - |
38
+
39
+ ## 스프린트 회고 (완료 시 작성)
40
+
41
+ ### 완료된 Task
42
+ - task-NNN: [설명]
43
+
44
+ ### 미완료 Task (이월/취소)
45
+ - task-NNN: [사유]
46
+
47
+ ### 잘된 점
48
+ - [내용]
49
+
50
+ ### 개선할 점
51
+ - [내용]
52
+
53
+ ### 다음 스프린트 제안
54
+ - [제안]
@@ -1,50 +1,50 @@
1
- # Sprint N 회고
2
-
3
- ## 기간
4
- - 시작: YYYY-MM-DD
5
- - 종료: YYYY-MM-DD
6
-
7
- ## 목표 달성도
8
-
9
- | 목표 | 달성 여부 | 비고 |
10
- |------|:--------:|------|
11
- | [목표 1] | ✅ / ⚠️ / ❌ | [설명] |
12
- | [목표 2] | ✅ / ⚠️ / ❌ | [설명] |
13
-
14
- ## 완료된 Task (N개)
15
-
16
- - task-001: [설명]
17
- - task-002: [설명]
18
-
19
- ## 미완료 Task (N개)
20
-
21
- | Task | 사유 | 처리 |
22
- |------|------|------|
23
- | task-NNN | [사유] | 이월 / 취소 |
24
-
25
- ## 잘된 점 (Keep)
26
-
27
- - [구체적 내용]
28
- - [구체적 내용]
29
-
30
- ## 개선할 점 (Problem)
31
-
32
- - [구체적 문제점]
33
- - [구체적 문제점]
34
-
35
- ## 시도할 것 (Try)
36
-
37
- - [다음 스프린트에서 시도할 개선 방안]
38
- - [다음 스프린트에서 시도할 개선 방안]
39
-
40
- ## 메트릭
41
-
42
- - 계획 Task 수: N개
43
- - 완료 Task 수: N개
44
- - 완료율: X%
45
- - 이월 Task 수: N개
46
-
47
- ## 다음 스프린트 제안
48
-
49
- - [제안 1]
50
- - [제안 2]
1
+ # Sprint N 회고
2
+
3
+ ## 기간
4
+ - 시작: YYYY-MM-DD
5
+ - 종료: YYYY-MM-DD
6
+
7
+ ## 목표 달성도
8
+
9
+ | 목표 | 달성 여부 | 비고 |
10
+ |------|:--------:|------|
11
+ | [목표 1] | ✅ / ⚠️ / ❌ | [설명] |
12
+ | [목표 2] | ✅ / ⚠️ / ❌ | [설명] |
13
+
14
+ ## 완료된 Task (N개)
15
+
16
+ - task-001: [설명]
17
+ - task-002: [설명]
18
+
19
+ ## 미완료 Task (N개)
20
+
21
+ | Task | 사유 | 처리 |
22
+ |------|------|------|
23
+ | task-NNN | [사유] | 이월 / 취소 |
24
+
25
+ ## 잘된 점 (Keep)
26
+
27
+ - [구체적 내용]
28
+ - [구체적 내용]
29
+
30
+ ## 개선할 점 (Problem)
31
+
32
+ - [구체적 문제점]
33
+ - [구체적 문제점]
34
+
35
+ ## 시도할 것 (Try)
36
+
37
+ - [다음 스프린트에서 시도할 개선 방안]
38
+ - [다음 스프린트에서 시도할 개선 방안]
39
+
40
+ ## 메트릭
41
+
42
+ - 계획 Task 수: N개
43
+ - 완료 Task 수: N개
44
+ - 완료율: X%
45
+ - 이월 Task 수: N개
46
+
47
+ ## 다음 스프린트 제안
48
+
49
+ - [제안 1]
50
+ - [제안 2]