@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.
- package/README.md +296 -25
- package/ai-dev-team/.ada-status.template.json +10 -10
- package/ai-dev-team/README.md +39 -44
- package/ai-dev-team/artifacts/api.md +2 -212
- package/ai-dev-team/artifacts/features/_template/api.md +19 -19
- package/ai-dev-team/artifacts/features/_template/review.md +14 -14
- package/ai-dev-team/artifacts/features/_template/spec.md +28 -28
- package/ai-dev-team/artifacts/features/_template/ui.md +14 -14
- package/ai-dev-team/artifacts/improvement-reports/IMP-0000-template.md +57 -57
- package/ai-dev-team/artifacts/project.md +2 -193
- package/ai-dev-team/artifacts/rfc/RFC-0000-template.md +49 -49
- package/core/artifacts/decision.md +72 -72
- package/core/artifacts/plan.md +187 -187
- package/core/artifacts/project.md +193 -193
- package/core/artifacts/sprints/_template/docs/release-notes.md +37 -37
- package/core/artifacts/sprints/_template/meta.md +54 -54
- package/core/artifacts/sprints/_template/retrospective.md +50 -50
- package/core/artifacts/sprints/_template/review-reports/review-template.md +49 -49
- package/core/artifacts/sprints/_template/tasks/task-template.md +43 -43
- package/core/docs-templates/mkdocs/docs/architecture/overview.md +29 -29
- package/core/docs-templates/mkdocs/docs/changelog.md +36 -36
- package/core/docs-templates/mkdocs/docs/contributing/contributing.md +60 -60
- package/core/docs-templates/mkdocs/docs/getting-started/configuration.md +51 -51
- package/core/docs-templates/mkdocs/docs/getting-started/installation.md +41 -41
- package/core/docs-templates/mkdocs/docs/getting-started/quick-start.md +56 -56
- package/core/docs-templates/mkdocs/docs/guides/api-reference.md +83 -83
- package/core/docs-templates/mkdocs/docs/index.md +32 -32
- package/core/docs-templates/mkdocs/mkdocs.yml +86 -86
- package/core/roles/analyzer.md +265 -265
- package/core/roles/developer.md +6 -1
- package/core/roles/documenter.md +226 -715
- package/core/roles/improver.md +461 -461
- package/core/roles/manager.md +574 -544
- package/core/roles/planner.md +398 -398
- package/core/roles/reviewer.md +294 -294
- package/core/rules/document-priority.md +198 -198
- package/core/rules/escalation.md +172 -172
- package/core/rules/iteration.md +236 -236
- package/core/rules/rfc.md +31 -31
- package/core/rules/rollback.md +218 -218
- package/core/skills/_template/SKILL.md +50 -0
- package/core/skills/clean-code/SKILL.md +177 -0
- package/core/skills/code-review-checklist/SKILL.md +125 -0
- package/core/skills/error-handling/SKILL.md +155 -0
- package/core/skills/talk-game-dot-design/SKILL.md +85 -0
- package/core/skills/talk-game-dot-design/references/asset-specs.md +57 -0
- package/core/skills/talk-game-dot-design/references/review-checklist.md +34 -0
- package/core/skills/task-writing/SKILL.md +166 -0
- package/core/skills/testing-patterns/SKILL.md +140 -0
- package/dist/bin/cli.d.ts +2 -0
- package/dist/bin/cli.js +121 -0
- package/dist/bin/cli.js.map +1 -0
- package/dist/src/commands/config.d.ts +4 -0
- package/dist/src/commands/config.js +427 -0
- package/dist/src/commands/config.js.map +1 -0
- package/dist/src/commands/docs.d.ts +12 -0
- package/dist/src/commands/docs.js +453 -0
- package/dist/src/commands/docs.js.map +1 -0
- package/dist/src/commands/interactive.d.ts +4 -0
- package/dist/src/commands/interactive.js +380 -0
- package/dist/src/commands/interactive.js.map +1 -0
- package/dist/src/commands/logs.d.ts +1 -0
- package/dist/src/commands/logs.js +76 -0
- package/dist/src/commands/logs.js.map +1 -0
- package/dist/src/commands/monitor.d.ts +6 -0
- package/dist/src/commands/monitor.js +216 -0
- package/dist/src/commands/monitor.js.map +1 -0
- package/dist/src/commands/reset.d.ts +4 -0
- package/dist/src/commands/reset.js +57 -0
- package/dist/src/commands/reset.js.map +1 -0
- package/dist/src/commands/run.d.ts +45 -0
- package/dist/src/commands/run.js +421 -0
- package/dist/src/commands/run.js.map +1 -0
- package/dist/src/commands/sessions.d.ts +5 -0
- package/dist/src/commands/sessions.js +563 -0
- package/dist/src/commands/sessions.js.map +1 -0
- package/dist/src/commands/setup.d.ts +1 -0
- package/dist/src/commands/setup.js +132 -0
- package/dist/src/commands/setup.js.map +1 -0
- package/dist/src/commands/skills.d.ts +4 -0
- package/dist/src/commands/skills.js +748 -0
- package/dist/src/commands/skills.js.map +1 -0
- package/dist/src/commands/sprint.d.ts +4 -0
- package/dist/src/commands/sprint.js +434 -0
- package/dist/src/commands/sprint.js.map +1 -0
- package/dist/src/commands/status.d.ts +1 -0
- package/dist/src/commands/status.js +97 -0
- package/dist/src/commands/status.js.map +1 -0
- package/dist/src/commands/upgrade.d.ts +6 -0
- package/dist/src/commands/upgrade.js +350 -0
- package/dist/src/commands/upgrade.js.map +1 -0
- package/dist/src/commands/validate.d.ts +8 -0
- package/dist/src/commands/validate.js +260 -0
- package/dist/src/commands/validate.js.map +1 -0
- package/dist/src/commands/validate.test.d.ts +1 -0
- package/dist/src/commands/validate.test.js +74 -0
- package/dist/src/commands/validate.test.js.map +1 -0
- package/{src/index.js → dist/src/index.d.ts} +1 -3
- package/dist/src/index.js +15 -0
- package/dist/src/index.js.map +1 -0
- package/dist/src/types/common.d.ts +31 -0
- package/dist/src/types/common.js +2 -0
- package/dist/src/types/common.js.map +1 -0
- package/dist/src/types/config.d.ts +46 -0
- package/dist/src/types/config.js +2 -0
- package/dist/src/types/config.js.map +1 -0
- package/dist/src/types/index.d.ts +53 -0
- package/dist/src/types/index.js +2 -0
- package/dist/src/types/index.js.map +1 -0
- package/dist/src/types/session.d.ts +87 -0
- package/dist/src/types/session.js +2 -0
- package/dist/src/types/session.js.map +1 -0
- package/dist/src/types/task.d.ts +32 -0
- package/dist/src/types/task.js +2 -0
- package/dist/src/types/task.js.map +1 -0
- package/dist/src/ui/dashboard.d.ts +9 -0
- package/dist/src/ui/dashboard.js +468 -0
- package/dist/src/ui/dashboard.js.map +1 -0
- package/dist/src/ui/keyHandler.d.ts +47 -0
- package/dist/src/ui/keyHandler.js +132 -0
- package/dist/src/ui/keyHandler.js.map +1 -0
- package/dist/src/ui/quickActions.d.ts +25 -0
- package/dist/src/ui/quickActions.js +106 -0
- package/dist/src/ui/quickActions.js.map +1 -0
- package/dist/src/utils/config.d.ts +33 -0
- package/dist/src/utils/config.js +135 -0
- package/dist/src/utils/config.js.map +1 -0
- package/dist/src/utils/files.d.ts +84 -0
- package/dist/src/utils/files.js +202 -0
- package/dist/src/utils/files.js.map +1 -0
- package/dist/src/utils/promptBuilder.d.ts +39 -0
- package/dist/src/utils/promptBuilder.js +726 -0
- package/dist/src/utils/promptBuilder.js.map +1 -0
- package/dist/src/utils/sessionState.d.ts +83 -0
- package/dist/src/utils/sessionState.js +466 -0
- package/dist/src/utils/sessionState.js.map +1 -0
- package/dist/src/utils/sessionState.process.test.d.ts +1 -0
- package/dist/src/utils/sessionState.process.test.js +93 -0
- package/dist/src/utils/sessionState.process.test.js.map +1 -0
- package/dist/src/utils/sessionState.test.d.ts +1 -0
- package/dist/src/utils/sessionState.test.js +150 -0
- package/dist/src/utils/sessionState.test.js.map +1 -0
- package/dist/src/utils/sprintUtils.d.ts +13 -0
- package/dist/src/utils/sprintUtils.js +129 -0
- package/dist/src/utils/sprintUtils.js.map +1 -0
- package/dist/src/utils/taskParser.d.ts +9 -0
- package/dist/src/utils/taskParser.js +122 -0
- package/dist/src/utils/taskParser.js.map +1 -0
- package/dist/src/utils/taskParser.test.d.ts +1 -0
- package/dist/src/utils/taskParser.test.js +69 -0
- package/dist/src/utils/taskParser.test.js.map +1 -0
- package/package.json +62 -47
- package/templates/cli/artifacts/commands.md +262 -262
- package/templates/cli/artifacts/output-format.md +298 -298
- package/templates/cli/rules/command-change.md +225 -225
- package/templates/game/artifacts/assets.md +148 -148
- package/templates/game/artifacts/game-systems.md +217 -217
- package/templates/game/artifacts/hud.md +199 -199
- package/templates/game/rules/system-change.md +184 -184
- package/templates/library/artifacts/changelog.md +84 -84
- package/templates/library/artifacts/examples.md +157 -157
- package/templates/library/artifacts/public-api.md +197 -197
- package/templates/library/rules/versioning.md +186 -186
- package/templates/web-dev/artifacts/api.md +212 -212
- package/templates/web-dev/artifacts/ui.md +104 -104
- package/templates/web-dev/rules/api-change.md +198 -198
- package/ai-dev-team/.ada-status.json +0 -10
- package/ai-dev-team/.ada-version +0 -6
- package/ai-dev-team/.current-template +0 -1
- package/ai-dev-team/.gitkeep +0 -0
- package/ai-dev-team/.sessions/logs/20260124-014551-00f04724.log +0 -5
- package/ai-dev-team/.sessions/logs/20260124-014623-cb2b1d44.log +0 -5
- package/ai-dev-team/artifacts/.gitkeep +0 -0
- package/ai-dev-team/artifacts/decision.md +0 -72
- package/ai-dev-team/artifacts/plan.md +0 -187
- package/ai-dev-team/artifacts/sprints/_template/docs/release-notes.md +0 -37
- package/ai-dev-team/artifacts/sprints/_template/meta.md +0 -54
- package/ai-dev-team/artifacts/sprints/_template/retrospective.md +0 -50
- package/ai-dev-team/artifacts/sprints/_template/review-reports/review-template.md +0 -49
- package/ai-dev-team/artifacts/sprints/_template/tasks/task-template.md +0 -43
- package/ai-dev-team/artifacts/ui.md +0 -104
- package/ai-dev-team/roles/.gitkeep +0 -0
- package/ai-dev-team/roles/analyzer.md +0 -265
- package/ai-dev-team/roles/developer.md +0 -222
- package/ai-dev-team/roles/documenter.md +0 -715
- package/ai-dev-team/roles/improver.md +0 -461
- package/ai-dev-team/roles/manager.md +0 -544
- package/ai-dev-team/roles/planner.md +0 -398
- package/ai-dev-team/roles/reviewer.md +0 -294
- package/ai-dev-team/rules/.gitkeep +0 -0
- package/ai-dev-team/rules/api-change.md +0 -198
- package/ai-dev-team/rules/document-priority.md +0 -199
- package/ai-dev-team/rules/escalation.md +0 -172
- package/ai-dev-team/rules/iteration.md +0 -236
- package/ai-dev-team/rules/rfc.md +0 -31
- package/ai-dev-team/rules/rollback.md +0 -218
- package/bin/cli.js +0 -127
- package/src/commands/config.js +0 -371
- package/src/commands/docs.js +0 -502
- package/src/commands/interactive.js +0 -392
- package/src/commands/logs.js +0 -81
- package/src/commands/monitor.js +0 -236
- package/src/commands/reset.js +0 -66
- package/src/commands/run.js +0 -739
- package/src/commands/sessions.js +0 -646
- package/src/commands/setup.js +0 -149
- package/src/commands/sprint.js +0 -503
- package/src/commands/status.js +0 -109
- package/src/commands/upgrade.js +0 -416
- package/src/commands/validate.js +0 -289
- package/src/commands/validate.test.js +0 -84
- package/src/ui/dashboard.js +0 -518
- package/src/ui/keyHandler.js +0 -147
- package/src/ui/quickActions.js +0 -111
- package/src/utils/config.js +0 -74
- package/src/utils/files.js +0 -201
- package/src/utils/sessionState.js +0 -513
- package/src/utils/sessionState.process.test.js +0 -101
- package/src/utils/sessionState.test.js +0 -183
- package/src/utils/sprintUtils.js +0 -134
- package/src/utils/taskParser.js +0 -134
- 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]
|