@silbaram/artifact-driven-agent 0.1.7 → 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 +510 -60
- package/ai-dev-team/.ada-status.template.json +10 -10
- package/ai-dev-team/README.md +39 -44
- package/ai-dev-team/ada.config.json +15 -0
- package/ai-dev-team/artifacts/api.md +2 -0
- 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 -0
- package/ai-dev-team/artifacts/project.md +2 -0
- 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 -0
- package/core/docs-templates/mkdocs/docs/changelog.md +36 -0
- package/core/docs-templates/mkdocs/docs/contributing/contributing.md +60 -0
- package/core/docs-templates/mkdocs/docs/getting-started/configuration.md +51 -0
- package/core/docs-templates/mkdocs/docs/getting-started/installation.md +41 -0
- package/core/docs-templates/mkdocs/docs/getting-started/quick-start.md +56 -0
- package/core/docs-templates/mkdocs/docs/guides/api-reference.md +83 -0
- package/core/docs-templates/mkdocs/docs/index.md +32 -0
- package/core/docs-templates/mkdocs/mkdocs.yml +86 -0
- package/core/roles/analyzer.md +265 -243
- package/core/roles/developer.md +227 -223
- package/core/roles/documenter.md +226 -293
- package/core/roles/improver.md +461 -0
- package/core/roles/manager.md +574 -541
- package/core/roles/planner.md +398 -248
- package/core/roles/reviewer.md +294 -266
- package/core/rules/document-priority.md +199 -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} +2 -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/.gitkeep +0 -0
- package/ai-dev-team/artifacts/.gitkeep +0 -0
- package/ai-dev-team/artifacts/features/_template/qa.md +0 -16
- package/ai-dev-team/roles/.gitkeep +0 -0
- package/ai-dev-team/rules/.gitkeep +0 -0
- package/bin/cli.js +0 -83
- package/examples/todo-app/README.md +0 -23
- package/examples/todo-app/artifacts/backlog.md +0 -23
- package/examples/todo-app/artifacts/plan.md +0 -23
- package/examples/todo-app/artifacts/project.md +0 -23
- package/src/commands/interactive.js +0 -101
- package/src/commands/logs.js +0 -81
- package/src/commands/reset.js +0 -66
- package/src/commands/run.js +0 -554
- package/src/commands/sessions.js +0 -707
- package/src/commands/setup.js +0 -128
- package/src/commands/sprint.js +0 -262
- package/src/commands/status.js +0 -76
- package/src/commands/validate.js +0 -288
- package/src/commands/validate.test.js +0 -84
- package/src/utils/files.js +0 -134
- package/src/utils/sessionState.js +0 -379
package/package.json
CHANGED
|
@@ -1,48 +1,63 @@
|
|
|
1
|
-
{
|
|
2
|
-
"name": "@silbaram/artifact-driven-agent",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "CLI 기반 멀티 AI 에이전트 개발 프레임워크 - AI가 규칙을 어기지 못하게 하는 문서 기반 개발",
|
|
5
|
-
"type": "module",
|
|
6
|
-
"
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
"
|
|
13
|
-
"
|
|
14
|
-
"
|
|
15
|
-
"
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
"
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
"
|
|
23
|
-
"
|
|
24
|
-
"
|
|
25
|
-
"
|
|
26
|
-
"
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
"
|
|
30
|
-
"
|
|
31
|
-
"
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
"
|
|
37
|
-
"
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
"
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
1
|
+
{
|
|
2
|
+
"name": "@silbaram/artifact-driven-agent",
|
|
3
|
+
"version": "0.2.3",
|
|
4
|
+
"description": "CLI 기반 멀티 AI 에이전트 개발 프레임워크 - AI가 규칙을 어기지 못하게 하는 문서 기반 개발",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/src/index.js",
|
|
7
|
+
"types": "./dist/src/index.d.ts",
|
|
8
|
+
"bin": {
|
|
9
|
+
"ada": "./dist/bin/cli.js"
|
|
10
|
+
},
|
|
11
|
+
"files": [
|
|
12
|
+
"dist",
|
|
13
|
+
"core",
|
|
14
|
+
"templates",
|
|
15
|
+
"examples",
|
|
16
|
+
"ai-dev-team"
|
|
17
|
+
],
|
|
18
|
+
"scripts": {
|
|
19
|
+
"build": "tsc && node scripts/add-shebang.js",
|
|
20
|
+
"dev": "tsx watch bin/cli.ts",
|
|
21
|
+
"typecheck": "tsc --noEmit",
|
|
22
|
+
"test": "node scripts/run-tests.js",
|
|
23
|
+
"pretest": "npm run build",
|
|
24
|
+
"lint": "echo 'No linter configured'",
|
|
25
|
+
"prepublishOnly": "npm run build && npm test",
|
|
26
|
+
"postversion": "git push && git push --tags"
|
|
27
|
+
},
|
|
28
|
+
"keywords": [
|
|
29
|
+
"ai",
|
|
30
|
+
"agent",
|
|
31
|
+
"cli",
|
|
32
|
+
"development",
|
|
33
|
+
"framework",
|
|
34
|
+
"artifact",
|
|
35
|
+
"multi-agent",
|
|
36
|
+
"claude",
|
|
37
|
+
"codex",
|
|
38
|
+
"automation"
|
|
39
|
+
],
|
|
40
|
+
"author": "silbaram <silbaram79@gmail.com>",
|
|
41
|
+
"license": "MIT",
|
|
42
|
+
"repository": {
|
|
43
|
+
"type": "git",
|
|
44
|
+
"url": "https://github.com/silbaram/artifact-driven-agent"
|
|
45
|
+
},
|
|
46
|
+
"dependencies": {
|
|
47
|
+
"chalk": "^5.3.0",
|
|
48
|
+
"commander": "^12.1.0",
|
|
49
|
+
"fs-extra": "^11.2.0",
|
|
50
|
+
"inquirer": "^9.2.15"
|
|
51
|
+
},
|
|
52
|
+
"engines": {
|
|
53
|
+
"node": ">=18.0.0"
|
|
54
|
+
},
|
|
55
|
+
"devDependencies": {
|
|
56
|
+
"@types/fs-extra": "^11.0.4",
|
|
57
|
+
"@types/inquirer": "^9.0.9",
|
|
58
|
+
"@types/node": "^25.1.0",
|
|
59
|
+
"rimraf": "^6.1.2",
|
|
60
|
+
"tsx": "^4.21.0",
|
|
61
|
+
"typescript": "^5.9.3"
|
|
62
|
+
}
|
|
48
63
|
}
|
|
@@ -1,262 +1,262 @@
|
|
|
1
|
-
# Commands Specification
|
|
2
|
-
|
|
3
|
-
> CLI 명령어 정의 문서
|
|
4
|
-
> 모든 명령어의 단일 진실
|
|
5
|
-
|
|
6
|
-
---
|
|
7
|
-
|
|
8
|
-
## 0. 문서 메타
|
|
9
|
-
|
|
10
|
-
| 항목 | 값 |
|
|
11
|
-
|------|-----|
|
|
12
|
-
| 프로그램명 | [program-name] |
|
|
13
|
-
| 버전 | v1.0.0 |
|
|
14
|
-
| 최종 수정 | YYYY-MM-DD |
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
## 1. 전역 옵션
|
|
19
|
-
|
|
20
|
-
모든 명령어에서 사용 가능한 옵션:
|
|
21
|
-
|
|
22
|
-
| 옵션 | 축약 | 설명 |
|
|
23
|
-
|------|------|------|
|
|
24
|
-
| --help | -h | 도움말 표시 |
|
|
25
|
-
| --version | -V | 버전 표시 |
|
|
26
|
-
| --verbose | -v | 상세 출력 |
|
|
27
|
-
| --quiet | -q | 최소 출력 |
|
|
28
|
-
| --config | -c | 설정 파일 경로 |
|
|
29
|
-
| --format | -f | 출력 형식 (text/json/table) |
|
|
30
|
-
|
|
31
|
-
---
|
|
32
|
-
|
|
33
|
-
## 2. 명령어 목록
|
|
34
|
-
|
|
35
|
-
| 명령어 | 설명 | 상태 | Task |
|
|
36
|
-
|--------|------|:----:|------|
|
|
37
|
-
| init | 프로젝트 초기화 | ✅ | TASK-001 |
|
|
38
|
-
| config | 설정 관리 | ⏳ | TASK-002 |
|
|
39
|
-
| run | 실행 | 📋 | TASK-003 |
|
|
40
|
-
|
|
41
|
-
---
|
|
42
|
-
|
|
43
|
-
## 3. init
|
|
44
|
-
|
|
45
|
-
프로젝트를 초기화합니다.
|
|
46
|
-
|
|
47
|
-
### 사용법
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
[program] init [directory] [options]
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
### 인자
|
|
54
|
-
|
|
55
|
-
| 인자 | 타입 | 필수 | 설명 |
|
|
56
|
-
|------|------|:----:|------|
|
|
57
|
-
| directory | path | ❌ | 대상 디렉토리 (기본: .) |
|
|
58
|
-
|
|
59
|
-
### 옵션
|
|
60
|
-
|
|
61
|
-
| 옵션 | 축약 | 타입 | 기본값 | 설명 |
|
|
62
|
-
|------|------|------|--------|------|
|
|
63
|
-
| --template | -t | string | default | 템플릿 이름 |
|
|
64
|
-
| --force | -f | flag | false | 기존 파일 덮어쓰기 |
|
|
65
|
-
| --no-git | | flag | false | git 초기화 건너뛰기 |
|
|
66
|
-
|
|
67
|
-
### 예시
|
|
68
|
-
|
|
69
|
-
```bash
|
|
70
|
-
# 현재 디렉토리에 초기화
|
|
71
|
-
[program] init
|
|
72
|
-
|
|
73
|
-
# 특정 디렉토리에 초기화
|
|
74
|
-
[program] init my-project
|
|
75
|
-
|
|
76
|
-
# 템플릿 사용
|
|
77
|
-
[program] init --template typescript
|
|
78
|
-
|
|
79
|
-
# 강제 덮어쓰기
|
|
80
|
-
[program] init --force
|
|
81
|
-
```
|
|
82
|
-
|
|
83
|
-
### 종료 코드
|
|
84
|
-
|
|
85
|
-
| 코드 | 의미 |
|
|
86
|
-
|:----:|------|
|
|
87
|
-
| 0 | 성공 |
|
|
88
|
-
| 1 | 초기화 실패 |
|
|
89
|
-
| 2 | 디렉토리가 비어있지 않음 (--force 없이) |
|
|
90
|
-
|
|
91
|
-
---
|
|
92
|
-
|
|
93
|
-
## 4. config
|
|
94
|
-
|
|
95
|
-
설정을 관리합니다.
|
|
96
|
-
|
|
97
|
-
### 사용법
|
|
98
|
-
|
|
99
|
-
```bash
|
|
100
|
-
[program] config <subcommand> [options]
|
|
101
|
-
```
|
|
102
|
-
|
|
103
|
-
### 서브커맨드
|
|
104
|
-
|
|
105
|
-
#### config get
|
|
106
|
-
|
|
107
|
-
```bash
|
|
108
|
-
[program] config get <key>
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
설정 값을 조회합니다.
|
|
112
|
-
|
|
113
|
-
| 인자 | 타입 | 필수 | 설명 |
|
|
114
|
-
|------|------|:----:|------|
|
|
115
|
-
| key | string | ✅ | 설정 키 |
|
|
116
|
-
|
|
117
|
-
#### config set
|
|
118
|
-
|
|
119
|
-
```bash
|
|
120
|
-
[program] config set <key> <value> [options]
|
|
121
|
-
```
|
|
122
|
-
|
|
123
|
-
설정 값을 저장합니다.
|
|
124
|
-
|
|
125
|
-
| 인자 | 타입 | 필수 | 설명 |
|
|
126
|
-
|------|------|:----:|------|
|
|
127
|
-
| key | string | ✅ | 설정 키 |
|
|
128
|
-
| value | string | ✅ | 설정 값 |
|
|
129
|
-
|
|
130
|
-
| 옵션 | 설명 |
|
|
131
|
-
|------|------|
|
|
132
|
-
| --global | 전역 설정에 저장 |
|
|
133
|
-
|
|
134
|
-
#### config list
|
|
135
|
-
|
|
136
|
-
```bash
|
|
137
|
-
[program] config list [options]
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
모든 설정을 표시합니다.
|
|
141
|
-
|
|
142
|
-
| 옵션 | 설명 |
|
|
143
|
-
|------|------|
|
|
144
|
-
| --global | 전역 설정만 표시 |
|
|
145
|
-
| --local | 로컬 설정만 표시 |
|
|
146
|
-
|
|
147
|
-
### 예시
|
|
148
|
-
|
|
149
|
-
```bash
|
|
150
|
-
# 설정 조회
|
|
151
|
-
[program] config get user.name
|
|
152
|
-
|
|
153
|
-
# 설정 저장
|
|
154
|
-
[program] config set user.name "John Doe"
|
|
155
|
-
|
|
156
|
-
# 전역 설정
|
|
157
|
-
[program] config set user.email "john@example.com" --global
|
|
158
|
-
|
|
159
|
-
# 모든 설정 표시
|
|
160
|
-
[program] config list
|
|
161
|
-
```
|
|
162
|
-
|
|
163
|
-
### 종료 코드
|
|
164
|
-
|
|
165
|
-
| 코드 | 의미 |
|
|
166
|
-
|:----:|------|
|
|
167
|
-
| 0 | 성공 |
|
|
168
|
-
| 1 | 설정 오류 |
|
|
169
|
-
| 2 | 키를 찾을 수 없음 |
|
|
170
|
-
|
|
171
|
-
---
|
|
172
|
-
|
|
173
|
-
## 5. run
|
|
174
|
-
|
|
175
|
-
프로젝트를 실행합니다.
|
|
176
|
-
|
|
177
|
-
### 사용법
|
|
178
|
-
|
|
179
|
-
```bash
|
|
180
|
-
[program] run [script] [options] [-- args]
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
### 인자
|
|
184
|
-
|
|
185
|
-
| 인자 | 타입 | 필수 | 설명 |
|
|
186
|
-
|------|------|:----:|------|
|
|
187
|
-
| script | string | ❌ | 스크립트 이름 (기본: default) |
|
|
188
|
-
|
|
189
|
-
### 옵션
|
|
190
|
-
|
|
191
|
-
| 옵션 | 축약 | 타입 | 기본값 | 설명 |
|
|
192
|
-
|------|------|------|--------|------|
|
|
193
|
-
| --watch | -w | flag | false | 파일 변경 감시 |
|
|
194
|
-
| --env | -e | string | development | 환경 |
|
|
195
|
-
|
|
196
|
-
### 예시
|
|
197
|
-
|
|
198
|
-
```bash
|
|
199
|
-
# 기본 실행
|
|
200
|
-
[program] run
|
|
201
|
-
|
|
202
|
-
# 특정 스크립트 실행
|
|
203
|
-
[program] run build
|
|
204
|
-
|
|
205
|
-
# 감시 모드
|
|
206
|
-
[program] run --watch
|
|
207
|
-
|
|
208
|
-
# 인자 전달
|
|
209
|
-
[program] run test -- --coverage
|
|
210
|
-
```
|
|
211
|
-
|
|
212
|
-
### 종료 코드
|
|
213
|
-
|
|
214
|
-
| 코드 | 의미 |
|
|
215
|
-
|:----:|------|
|
|
216
|
-
| 0 | 성공 |
|
|
217
|
-
| 1 | 실행 실패 |
|
|
218
|
-
| 127 | 스크립트를 찾을 수 없음 |
|
|
219
|
-
|
|
220
|
-
---
|
|
221
|
-
|
|
222
|
-
## 6. 환경 변수
|
|
223
|
-
|
|
224
|
-
| 변수 | 설명 | 기본값 |
|
|
225
|
-
|------|------|--------|
|
|
226
|
-
| [PROGRAM]_CONFIG | 설정 파일 경로 | ~/.config/[program] |
|
|
227
|
-
| [PROGRAM]_HOME | 홈 디렉토리 | ~ |
|
|
228
|
-
| [PROGRAM]_DEBUG | 디버그 모드 | false |
|
|
229
|
-
| NO_COLOR | 색상 출력 비활성화 | - |
|
|
230
|
-
|
|
231
|
-
---
|
|
232
|
-
|
|
233
|
-
## 7. 설정 파일
|
|
234
|
-
|
|
235
|
-
### 위치 (우선순위)
|
|
236
|
-
|
|
237
|
-
1. --config 옵션
|
|
238
|
-
2. ./[program].config
|
|
239
|
-
3. $[PROGRAM]_CONFIG
|
|
240
|
-
4. ~/.config/[program]/config
|
|
241
|
-
|
|
242
|
-
### 형식
|
|
243
|
-
|
|
244
|
-
```yaml
|
|
245
|
-
# [program].config
|
|
246
|
-
user:
|
|
247
|
-
name: "John Doe"
|
|
248
|
-
email: "john@example.com"
|
|
249
|
-
|
|
250
|
-
defaults:
|
|
251
|
-
template: typescript
|
|
252
|
-
env: development
|
|
253
|
-
```
|
|
254
|
-
|
|
255
|
-
---
|
|
256
|
-
|
|
257
|
-
## 8. 변경 이력
|
|
258
|
-
|
|
259
|
-
| Task | 날짜 | 변경 내용 |
|
|
260
|
-
|------|------|----------|
|
|
261
|
-
| [TASK-001] | YYYY-MM-DD | init 명령어 추가 |
|
|
262
|
-
| [TASK-002] | YYYY-MM-DD | config 명령어 추가 |
|
|
1
|
+
# Commands Specification
|
|
2
|
+
|
|
3
|
+
> CLI 명령어 정의 문서
|
|
4
|
+
> 모든 명령어의 단일 진실
|
|
5
|
+
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## 0. 문서 메타
|
|
9
|
+
|
|
10
|
+
| 항목 | 값 |
|
|
11
|
+
|------|-----|
|
|
12
|
+
| 프로그램명 | [program-name] |
|
|
13
|
+
| 버전 | v1.0.0 |
|
|
14
|
+
| 최종 수정 | YYYY-MM-DD |
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 1. 전역 옵션
|
|
19
|
+
|
|
20
|
+
모든 명령어에서 사용 가능한 옵션:
|
|
21
|
+
|
|
22
|
+
| 옵션 | 축약 | 설명 |
|
|
23
|
+
|------|------|------|
|
|
24
|
+
| --help | -h | 도움말 표시 |
|
|
25
|
+
| --version | -V | 버전 표시 |
|
|
26
|
+
| --verbose | -v | 상세 출력 |
|
|
27
|
+
| --quiet | -q | 최소 출력 |
|
|
28
|
+
| --config | -c | 설정 파일 경로 |
|
|
29
|
+
| --format | -f | 출력 형식 (text/json/table) |
|
|
30
|
+
|
|
31
|
+
---
|
|
32
|
+
|
|
33
|
+
## 2. 명령어 목록
|
|
34
|
+
|
|
35
|
+
| 명령어 | 설명 | 상태 | Task |
|
|
36
|
+
|--------|------|:----:|------|
|
|
37
|
+
| init | 프로젝트 초기화 | ✅ | TASK-001 |
|
|
38
|
+
| config | 설정 관리 | ⏳ | TASK-002 |
|
|
39
|
+
| run | 실행 | 📋 | TASK-003 |
|
|
40
|
+
|
|
41
|
+
---
|
|
42
|
+
|
|
43
|
+
## 3. init
|
|
44
|
+
|
|
45
|
+
프로젝트를 초기화합니다.
|
|
46
|
+
|
|
47
|
+
### 사용법
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
[program] init [directory] [options]
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
### 인자
|
|
54
|
+
|
|
55
|
+
| 인자 | 타입 | 필수 | 설명 |
|
|
56
|
+
|------|------|:----:|------|
|
|
57
|
+
| directory | path | ❌ | 대상 디렉토리 (기본: .) |
|
|
58
|
+
|
|
59
|
+
### 옵션
|
|
60
|
+
|
|
61
|
+
| 옵션 | 축약 | 타입 | 기본값 | 설명 |
|
|
62
|
+
|------|------|------|--------|------|
|
|
63
|
+
| --template | -t | string | default | 템플릿 이름 |
|
|
64
|
+
| --force | -f | flag | false | 기존 파일 덮어쓰기 |
|
|
65
|
+
| --no-git | | flag | false | git 초기화 건너뛰기 |
|
|
66
|
+
|
|
67
|
+
### 예시
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# 현재 디렉토리에 초기화
|
|
71
|
+
[program] init
|
|
72
|
+
|
|
73
|
+
# 특정 디렉토리에 초기화
|
|
74
|
+
[program] init my-project
|
|
75
|
+
|
|
76
|
+
# 템플릿 사용
|
|
77
|
+
[program] init --template typescript
|
|
78
|
+
|
|
79
|
+
# 강제 덮어쓰기
|
|
80
|
+
[program] init --force
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 종료 코드
|
|
84
|
+
|
|
85
|
+
| 코드 | 의미 |
|
|
86
|
+
|:----:|------|
|
|
87
|
+
| 0 | 성공 |
|
|
88
|
+
| 1 | 초기화 실패 |
|
|
89
|
+
| 2 | 디렉토리가 비어있지 않음 (--force 없이) |
|
|
90
|
+
|
|
91
|
+
---
|
|
92
|
+
|
|
93
|
+
## 4. config
|
|
94
|
+
|
|
95
|
+
설정을 관리합니다.
|
|
96
|
+
|
|
97
|
+
### 사용법
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
[program] config <subcommand> [options]
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
### 서브커맨드
|
|
104
|
+
|
|
105
|
+
#### config get
|
|
106
|
+
|
|
107
|
+
```bash
|
|
108
|
+
[program] config get <key>
|
|
109
|
+
```
|
|
110
|
+
|
|
111
|
+
설정 값을 조회합니다.
|
|
112
|
+
|
|
113
|
+
| 인자 | 타입 | 필수 | 설명 |
|
|
114
|
+
|------|------|:----:|------|
|
|
115
|
+
| key | string | ✅ | 설정 키 |
|
|
116
|
+
|
|
117
|
+
#### config set
|
|
118
|
+
|
|
119
|
+
```bash
|
|
120
|
+
[program] config set <key> <value> [options]
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
설정 값을 저장합니다.
|
|
124
|
+
|
|
125
|
+
| 인자 | 타입 | 필수 | 설명 |
|
|
126
|
+
|------|------|:----:|------|
|
|
127
|
+
| key | string | ✅ | 설정 키 |
|
|
128
|
+
| value | string | ✅ | 설정 값 |
|
|
129
|
+
|
|
130
|
+
| 옵션 | 설명 |
|
|
131
|
+
|------|------|
|
|
132
|
+
| --global | 전역 설정에 저장 |
|
|
133
|
+
|
|
134
|
+
#### config list
|
|
135
|
+
|
|
136
|
+
```bash
|
|
137
|
+
[program] config list [options]
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
모든 설정을 표시합니다.
|
|
141
|
+
|
|
142
|
+
| 옵션 | 설명 |
|
|
143
|
+
|------|------|
|
|
144
|
+
| --global | 전역 설정만 표시 |
|
|
145
|
+
| --local | 로컬 설정만 표시 |
|
|
146
|
+
|
|
147
|
+
### 예시
|
|
148
|
+
|
|
149
|
+
```bash
|
|
150
|
+
# 설정 조회
|
|
151
|
+
[program] config get user.name
|
|
152
|
+
|
|
153
|
+
# 설정 저장
|
|
154
|
+
[program] config set user.name "John Doe"
|
|
155
|
+
|
|
156
|
+
# 전역 설정
|
|
157
|
+
[program] config set user.email "john@example.com" --global
|
|
158
|
+
|
|
159
|
+
# 모든 설정 표시
|
|
160
|
+
[program] config list
|
|
161
|
+
```
|
|
162
|
+
|
|
163
|
+
### 종료 코드
|
|
164
|
+
|
|
165
|
+
| 코드 | 의미 |
|
|
166
|
+
|:----:|------|
|
|
167
|
+
| 0 | 성공 |
|
|
168
|
+
| 1 | 설정 오류 |
|
|
169
|
+
| 2 | 키를 찾을 수 없음 |
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## 5. run
|
|
174
|
+
|
|
175
|
+
프로젝트를 실행합니다.
|
|
176
|
+
|
|
177
|
+
### 사용법
|
|
178
|
+
|
|
179
|
+
```bash
|
|
180
|
+
[program] run [script] [options] [-- args]
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
### 인자
|
|
184
|
+
|
|
185
|
+
| 인자 | 타입 | 필수 | 설명 |
|
|
186
|
+
|------|------|:----:|------|
|
|
187
|
+
| script | string | ❌ | 스크립트 이름 (기본: default) |
|
|
188
|
+
|
|
189
|
+
### 옵션
|
|
190
|
+
|
|
191
|
+
| 옵션 | 축약 | 타입 | 기본값 | 설명 |
|
|
192
|
+
|------|------|------|--------|------|
|
|
193
|
+
| --watch | -w | flag | false | 파일 변경 감시 |
|
|
194
|
+
| --env | -e | string | development | 환경 |
|
|
195
|
+
|
|
196
|
+
### 예시
|
|
197
|
+
|
|
198
|
+
```bash
|
|
199
|
+
# 기본 실행
|
|
200
|
+
[program] run
|
|
201
|
+
|
|
202
|
+
# 특정 스크립트 실행
|
|
203
|
+
[program] run build
|
|
204
|
+
|
|
205
|
+
# 감시 모드
|
|
206
|
+
[program] run --watch
|
|
207
|
+
|
|
208
|
+
# 인자 전달
|
|
209
|
+
[program] run test -- --coverage
|
|
210
|
+
```
|
|
211
|
+
|
|
212
|
+
### 종료 코드
|
|
213
|
+
|
|
214
|
+
| 코드 | 의미 |
|
|
215
|
+
|:----:|------|
|
|
216
|
+
| 0 | 성공 |
|
|
217
|
+
| 1 | 실행 실패 |
|
|
218
|
+
| 127 | 스크립트를 찾을 수 없음 |
|
|
219
|
+
|
|
220
|
+
---
|
|
221
|
+
|
|
222
|
+
## 6. 환경 변수
|
|
223
|
+
|
|
224
|
+
| 변수 | 설명 | 기본값 |
|
|
225
|
+
|------|------|--------|
|
|
226
|
+
| [PROGRAM]_CONFIG | 설정 파일 경로 | ~/.config/[program] |
|
|
227
|
+
| [PROGRAM]_HOME | 홈 디렉토리 | ~ |
|
|
228
|
+
| [PROGRAM]_DEBUG | 디버그 모드 | false |
|
|
229
|
+
| NO_COLOR | 색상 출력 비활성화 | - |
|
|
230
|
+
|
|
231
|
+
---
|
|
232
|
+
|
|
233
|
+
## 7. 설정 파일
|
|
234
|
+
|
|
235
|
+
### 위치 (우선순위)
|
|
236
|
+
|
|
237
|
+
1. --config 옵션
|
|
238
|
+
2. ./[program].config
|
|
239
|
+
3. $[PROGRAM]_CONFIG
|
|
240
|
+
4. ~/.config/[program]/config
|
|
241
|
+
|
|
242
|
+
### 형식
|
|
243
|
+
|
|
244
|
+
```yaml
|
|
245
|
+
# [program].config
|
|
246
|
+
user:
|
|
247
|
+
name: "John Doe"
|
|
248
|
+
email: "john@example.com"
|
|
249
|
+
|
|
250
|
+
defaults:
|
|
251
|
+
template: typescript
|
|
252
|
+
env: development
|
|
253
|
+
```
|
|
254
|
+
|
|
255
|
+
---
|
|
256
|
+
|
|
257
|
+
## 8. 변경 이력
|
|
258
|
+
|
|
259
|
+
| Task | 날짜 | 변경 내용 |
|
|
260
|
+
|------|------|----------|
|
|
261
|
+
| [TASK-001] | YYYY-MM-DD | init 명령어 추가 |
|
|
262
|
+
| [TASK-002] | YYYY-MM-DD | config 명령어 추가 |
|