@kodevibe/harness 0.8.4 → 0.9.1
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.ko.md +101 -109
- package/README.md +100 -102
- package/harness/agent-memory/architect.md +2 -2
- package/harness/agent-memory/{sprint-manager.md → lead.md} +4 -4
- package/harness/agent-memory/{planner.md → pm.md} +3 -3
- package/harness/agent-memory/reviewer.md +5 -5
- package/harness/agents/architect.md +9 -9
- package/harness/agents/{sprint-manager.md → lead.md} +24 -24
- package/harness/agents/{planner.md → pm.md} +98 -24
- package/harness/agents/reviewer.md +19 -19
- package/harness/core-rules.md +40 -40
- package/harness/dependency-map.md +2 -2
- package/harness/failure-patterns.md +4 -4
- package/harness/features.md +3 -3
- package/harness/project-brief.md +11 -11
- package/harness/project-state.md +5 -5
- package/harness/skills/{feature-breakdown.md → breakdown.md} +8 -8
- package/harness/skills/{impact-analysis.md → check-impact.md} +5 -5
- package/harness/skills/{investigate.md → debug.md} +8 -8
- package/harness/skills/pivot.md +4 -4
- package/harness/skills/{code-review-pr.md → pr-review.md} +4 -4
- package/harness/skills/{deployment.md → release.md} +8 -8
- package/harness/skills/{bootstrap.md → setup.md} +16 -16
- package/harness/skills/{learn.md → wrap-up.md} +12 -12
- package/package.json +1 -1
- package/src/init.js +22 -22
- /package/harness/skills/{security-checklist.md → secure.md} +0 -0
- /package/harness/skills/{test-integrity.md → sync-tests.md} +0 -0
package/README.ko.md
CHANGED
|
@@ -9,83 +9,33 @@
|
|
|
9
9
|
[](https://github.com/AIDD-Projects/harness/actions/workflows/ci.yml)
|
|
10
10
|
[](https://opensource.org/licenses/MIT)
|
|
11
11
|
|
|
12
|
-
|
|
12
|
+
> **AI 코딩 에이전트는 세션이 끝나면 모든 것을 잊습니다. kode:harness는 목표, 결정, 실패, 프로젝트 방향을 기억하게 합니다.**
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
> **v0.8.4** — 6개 IDE 지원, Navigation Dispatcher, 5개 파이프라인 (🟢🔵🔴🟡🟣), Crew Artifact Integration, EXTERNAL_DEP 분류 체계.
|
|
17
|
-
|
|
18
|
-
---
|
|
19
|
-
|
|
20
|
-
## Harness에서 Enterprise Harness Engineering으로
|
|
21
|
-
|
|
22
|
-
AI "harness" — LLM 코딩 에이전트를 안내하는 구조화된 마크다운 파일 — 는 AI 기반 개발의 기본 패턴이 되었습니다. BMAD, gstack, GSD 같은 프레임워크가 **1인 개발자**를 위해 이 접근법을 개척했습니다.
|
|
23
|
-
|
|
24
|
-
이 접근은 harness 엔지니어링을 1인 도구 수준에서 멀티 개발자 팀과 solo 개발자까지 포괄하는 **엔터프라이즈급 방향 관리 기법**으로 확장합니다. **kode:harness**는 이 접근을 제품 형태로 구현한 실행 프레임워크입니다.
|
|
25
|
-
|
|
26
|
-
| | 기존 Harness | kode:harness + harness engineering |
|
|
27
|
-
|---|---|---|
|
|
28
|
-
| 대상 | 1인 개발자 | **멀티 개발자 팀** |
|
|
29
|
-
| 초점 | AI가 무엇을 하는지 | **AI가 어디로 가는지** |
|
|
30
|
-
| 방향 관리 | ❌ | ✅ Direction Guard + pivot + Decision Log |
|
|
31
|
-
| 팀 상태 공유 | ❌ | ✅ 공유/개인 상태 분리 |
|
|
32
|
-
| 토큰 예산 | 200+ 파일 | **~25개 파일 (~17K 토큰)** — 소형 LLM도 작동 |
|
|
33
|
-
|
|
34
|
-
## 어떤 문제를 해결하나요?
|
|
35
|
-
|
|
36
|
-
혼자 개발할 때는 AI 코딩 어시스턴트의 방향이 일관됩니다. 하지만 **기업 팀**에서는 각 개발자가 독립된 AI 세션을 실행하고, 각 AI는 제각각 다른 방향으로 흘러갑니다.
|
|
37
|
-
|
|
38
|
-
- 개발자 A의 AI → 마이크로서비스로 리팩토링
|
|
39
|
-
- 개발자 B의 AI → 모놀리스를 강화
|
|
40
|
-
- 개발자 C의 AI → 이미 결정된 사항을 다시 논의
|
|
41
|
-
|
|
42
|
-
공유된 방향 관리 없이는 **여러 개발자의 AI가 프로젝트를 분리시킵니다.**
|
|
43
|
-
|
|
44
|
-
kode:harness는 모든 개발자의 AI에게 동일한 목표·비목표·결정사항·프로젝트 상태를 제공하여, 누가 코딩하든 어떤 IDE를 쓰든 **하나의 방향**으로 수렴하게 합니다.
|
|
45
|
-
|
|
46
|
-
## 핵심 설계 원칙
|
|
47
|
-
|
|
48
|
-
> **경량성**: Claude Sonnet이나 GPT-4o 같은 대형 LLM뿐 아니라, 프라이빗 망의 소형 LLM(GPT OSS 120B급, 로컬 LLM 등)도 kode:harness 파일을 읽고 프로젝트 방향을 유지할 수 있어야 합니다. BMAD의 200개 이상 파일 대비 **~25개 파일, ~17K 토큰**으로 동일한 효과를 달성합니다.
|
|
49
|
-
|
|
50
|
-
---
|
|
51
|
-
|
|
52
|
-
## 주요 기능
|
|
53
|
-
|
|
54
|
-
| 기능 | 설명 |
|
|
55
|
-
|------|------|
|
|
56
|
-
| 🧭 **Direction Guard** | 모든 코딩 요청을 프로젝트 목표/비목표와 대조 후 실행 |
|
|
57
|
-
| 🧭 **Navigation Dispatcher** | Turn-by-Turn 네비게이션으로 5개 파이프라인을 따라 다음 단계 프롬프트를 자동 안내 |
|
|
58
|
-
| 🟢🔵🔴🟡🟣 **5개 파이프라인** | New Dev → Continue → Bug Fix → Direction Change → Crew-Driven |
|
|
59
|
-
| 🟣 **Crew Artifact Integration** | 외부 기획 도구 산출물(PRD, Architecture, ARB Checklist)을 직접 읽기 — 수동 복사 불필요 |
|
|
60
|
-
| 📝 **State Files** | LLM 세션 간 프로젝트 지식을 유지하는 5개 마크다운 파일 |
|
|
61
|
-
| 🛠️ **Skills** | 기획, 리뷰, 디버깅, 방향 전환을 위한 단계별 절차 10개 |
|
|
62
|
-
| 🤖 **Agents** | 워크플로를 강제하는 역할 기반 페르소나 4개 |
|
|
63
|
-
| ⚠️ **Failure Patterns** | 동일 실수 반복을 방지하는 프로젝트별 실패 기록 |
|
|
64
|
-
| 📝 **Decision Log** | 결정의 이유를 기록해 LLM이 확정된 사항을 재논의하지 않도록 방지 |
|
|
14
|
+
AI 코딩 에이전트를 위한 프로덕션급 가드레일. 컨텍스트 부패를 방지하고, 프로젝트 방향을 강제하며, 세션 간 상태를 유지합니다. **Copilot, Claude, Cursor, Codex, Windsurf, Gemini** 지원. 의존성 제로.
|
|
65
15
|
|
|
66
16
|
---
|
|
67
17
|
|
|
68
18
|
## 빠른 시작
|
|
69
19
|
|
|
70
20
|
```bash
|
|
71
|
-
#
|
|
72
|
-
npx @kodevibe/harness init
|
|
73
|
-
|
|
74
|
-
# Team 모드 (멀티 개발자)
|
|
75
|
-
npx @kodevibe/harness init --team
|
|
21
|
+
npx @kodevibe/harness init # IDE 선택
|
|
76
22
|
```
|
|
77
23
|
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
> "bootstrap을 실행해서 이 프로젝트를 온보딩해줘."
|
|
24
|
+
```bash
|
|
25
|
+
# 그 후 AI 에이전트에게:
|
|
26
|
+
> "setup을 실행해서 이 프로젝트를 온보딩해줘."
|
|
27
|
+
```
|
|
83
28
|
|
|
84
|
-
|
|
29
|
+
끝입니다. 이제 AI는 영속적인 메모리, 방향 가드레일, 자기 교정 루프를 갖게 됩니다.
|
|
85
30
|
|
|
86
|
-
|
|
31
|
+
<details>
|
|
32
|
+
<summary>추가 설치 옵션</summary>
|
|
87
33
|
|
|
88
34
|
```bash
|
|
35
|
+
# Team 모드 (멀티 개발자 방향 정렬)
|
|
36
|
+
npx @kodevibe/harness init --team
|
|
37
|
+
|
|
38
|
+
# 비대화형 (CI/스크립트)
|
|
89
39
|
npx @kodevibe/harness init --ide vscode
|
|
90
40
|
npx @kodevibe/harness init --ide claude
|
|
91
41
|
npx @kodevibe/harness init --ide cursor
|
|
@@ -94,8 +44,6 @@ npx @kodevibe/harness init --ide windsurf
|
|
|
94
44
|
npx @kodevibe/harness init --ide antigravity
|
|
95
45
|
```
|
|
96
46
|
|
|
97
|
-
### 옵션
|
|
98
|
-
|
|
99
47
|
| 플래그 | 설명 |
|
|
100
48
|
|--------|------|
|
|
101
49
|
| `--ide <이름>` | 대상 IDE: `vscode`, `claude`, `cursor`, `codex`, `windsurf`, `antigravity` |
|
|
@@ -106,14 +54,58 @@ npx @kodevibe/harness init --ide antigravity
|
|
|
106
54
|
| `--overwrite` | 기존 파일 덮어쓰기 (state 파일 포함) |
|
|
107
55
|
| `--version` | 버전 번호 표시 |
|
|
108
56
|
|
|
109
|
-
|
|
57
|
+
</details>
|
|
110
58
|
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
59
|
+
---
|
|
60
|
+
|
|
61
|
+
## 문제: 컨텍스트 부패 (Context Rot)
|
|
62
|
+
|
|
63
|
+
AI 코딩 에이전트는 매 세션 제로에서 시작합니다. 세션 3에서는 세션 1의 아키텍처 결정을 잊고, 세션 10에서는 이미 확정된 사항을 다시 논의하며 자신의 이전 작업과 모순됩니다.
|
|
64
|
+
|
|
65
|
+
팀에서는 더 심각합니다 — 개발자 A의 AI는 마이크로서비스로 리팩토링하고, 개발자 B의 AI는 모놀리스를 강화합니다. **공유 가드레일 없이는 AI 에이전트가 프로젝트를 분리시킵니다.**
|
|
66
|
+
|
|
67
|
+
kode:harness는 세 가지 메커니즘으로 해결합니다:
|
|
68
|
+
|
|
69
|
+
| 메커니즘 | 방지하는 문제 |
|
|
70
|
+
|---------|-------------|
|
|
71
|
+
| **상태 영속성** | AI가 세션 간 목표, 결정, 진행 상황을 잊는 것 |
|
|
72
|
+
| **방향 가드** | AI가 프로젝트 목표에서 이탈하거나 과거 결정과 모순되는 것 |
|
|
73
|
+
| **실패 패턴** | AI가 세션 간 같은 실수를 반복하는 것 |
|
|
74
|
+
|
|
75
|
+
---
|
|
114
76
|
|
|
115
|
-
|
|
116
|
-
|
|
77
|
+
## 왜 그냥 ...을 쓰면 안 되나요?
|
|
78
|
+
|
|
79
|
+
| 접근법 | 한계 | kode:harness 차이점 |
|
|
80
|
+
|--------|------|---------------------|
|
|
81
|
+
| **`.cursorrules` / `copilot-instructions.md`** | 정적. 상태 영속성 없음, 자기 교정 없음, 세션 간 기억 없음. | 매 세션 업데이트되는 살아있는 state 파일. Direction Guard가 매 요청을 목표와 대조. |
|
|
82
|
+
| **LangChain / CrewAI** | AI 앱 구축용 런타임 오케스트레이션. AI 코딩 에이전트 방향 관리용이 아님. | IDE 안에서 작동하는 마크다운 네이티브 가드레일. 런타임 없음, SDK 없음. |
|
|
83
|
+
| **BMAD / gstack / GSD** | 1인 개발자용. 200+ 파일. 방향 관리 없음. | ~25개 파일 (~17K 토큰). Direction Guard + Decision Log. 멀티 개발자 팀 지원. |
|
|
84
|
+
| **"조심하면 되지"** | 잊을 때까지만 동작. LLM은 과거 세션에서 배우지 않음. | 자동화: `wrap-up`이 교훈 캡처, `debug`가 실패 추적, `reviewer`가 state 감사. |
|
|
85
|
+
|
|
86
|
+
---
|
|
87
|
+
|
|
88
|
+
## 주요 기능
|
|
89
|
+
|
|
90
|
+
| 기능 | 설명 |
|
|
91
|
+
|------|------|
|
|
92
|
+
| 🛡️ **Direction Guard** | 모든 코딩 요청을 프로젝트 목표/비목표와 대조 후 실행 |
|
|
93
|
+
| 🧭 **Navigation Dispatcher** | 5개 파이프라인을 따라 다음 단계 프롬프트를 자동 안내 |
|
|
94
|
+
| 📝 **상태 영속성** | LLM 세션 간 프로젝트 지식을 유지하는 5개 마크다운 파일 |
|
|
95
|
+
| 🔄 **5개 파이프라인** | 🟢 신규 → 🔵 계속 → 🔴 버그 수정 → 🟡 방향 전환 → 🟣 Crew 기반 |
|
|
96
|
+
| 🛠️ **10개 스킬** | 단계별 절차: setup, debug, breakdown, review, pivot 등 |
|
|
97
|
+
| 🤖 **4개 에이전트** | 역할 기반 페르소나: pm, reviewer, lead, architect |
|
|
98
|
+
| ⚠️ **실패 패턴** | 세션 간 같은 실수를 방지하는 프로젝트별 실패 기록 |
|
|
99
|
+
| 📋 **Decision Log** | 결정의 이유를 기록해 LLM이 확정된 사항을 재논의하지 않도록 방지 |
|
|
100
|
+
| 🟣 **Crew Artifact Integration** | 외부 기획 산출물 (PRD, Architecture, ARB Checklist) 직접 읽기 |
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## 헬스체크
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
npx @kodevibe/harness doctor # 파일 설치 상태 확인
|
|
108
|
+
npx @kodevibe/harness validate # state 파일에 실제 내용 확인
|
|
117
109
|
```
|
|
118
110
|
|
|
119
111
|
---
|
|
@@ -143,24 +135,24 @@ npx @kodevibe/harness validate
|
|
|
143
135
|
|
|
144
136
|
| 스킬 | 설명 |
|
|
145
137
|
|------|------|
|
|
146
|
-
| **
|
|
147
|
-
| **
|
|
138
|
+
| **setup** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
|
|
139
|
+
| **wrap-up** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
|
|
148
140
|
| **pivot** | 목표·기술·범위 변경 시 모든 state 파일에 변경사항 전파 |
|
|
149
|
-
| **
|
|
150
|
-
| **
|
|
151
|
-
| **
|
|
152
|
-
| **impact
|
|
153
|
-
| **
|
|
154
|
-
| **
|
|
155
|
-
| **
|
|
141
|
+
| **sync-tests** | 커밋 전 mock/인터페이스 동기화 검증 |
|
|
142
|
+
| **secure** | 커밋 전 보안 위험 스캔 |
|
|
143
|
+
| **debug** | 4단계 체계적 디버깅 (증거 → 범위축소 → 수정 → 검증) |
|
|
144
|
+
| **check-impact** | 공유 모듈 수정 전 영향 범위 평가 |
|
|
145
|
+
| **breakdown** | 기능을 의존성 순서대로 구현 태스크로 분해 |
|
|
146
|
+
| **pr-review** | PR 코드 리뷰: 품질, 보안, 방향 정렬 확인 |
|
|
147
|
+
| **release** | 배포 전 검증 체크리스트 (테스트, state 파일, 보안, 버전) |
|
|
156
148
|
|
|
157
149
|
### 에이전트 (역할 기반 페르소나)
|
|
158
150
|
|
|
159
151
|
| 에이전트 | 역할 |
|
|
160
152
|
|---------|------|
|
|
161
|
-
| **
|
|
153
|
+
| **pm** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
|
|
162
154
|
| **reviewer** | 코드 리뷰 + State 파일 감사 (state 파일이 실제로 업데이트되었는지 검증) |
|
|
163
|
-
| **
|
|
155
|
+
| **lead** | 스프린트/스토리 상태 관리, 범위 이탈 방지, 다음 단계 추천 |
|
|
164
156
|
| **architect** | 설계 리뷰 게이트: 구조 변경이 프로젝트 방향 및 모듈 경계에 부합하는지 검증 |
|
|
165
157
|
|
|
166
158
|
### State 파일 (프로젝트 메모리)
|
|
@@ -179,7 +171,7 @@ npx @kodevibe/harness validate
|
|
|
179
171
|
|
|
180
172
|
### 1단계: Bootstrap (최초 1회)
|
|
181
173
|
|
|
182
|
-
`harness init` 후 `
|
|
174
|
+
`harness init` 후 `setup` 스킬을 실행합니다. 코드베이스를 스캔하고, 목표/비목표에 대해 질문한 후, 5개 state 파일을 자동으로 채웁니다. **가장 중요한 단계입니다** — 이것 없이는 Direction Guard 등 다른 스킬이 컨텍스트를 가지지 못합니다.
|
|
183
175
|
|
|
184
176
|
### 2단계: Direction Guard (매 요청마다)
|
|
185
177
|
|
|
@@ -192,26 +184,26 @@ npx @kodevibe/harness validate
|
|
|
192
184
|
### 3단계: Workflow Pipeline
|
|
193
185
|
|
|
194
186
|
```
|
|
195
|
-
|
|
187
|
+
setup → pm → [코딩] → reviewer → lead → wrap-up
|
|
196
188
|
```
|
|
197
189
|
|
|
198
190
|
kode:harness는 상황별 **5개 파이프라인**을 제공합니다:
|
|
199
191
|
|
|
200
192
|
| 파이프라인 | 상황 | 흐름 |
|
|
201
193
|
|---|---|---|
|
|
202
|
-
| 🟢 New Dev | 첫 기능 개발 |
|
|
203
|
-
| 🔵 Continue | 작업 재개 |
|
|
204
|
-
| 🔴 Bug Fix | 디버깅 |
|
|
205
|
-
| 🟡 Direction Change | 목표/기술 변경 | pivot →
|
|
206
|
-
| 🟣 Crew-Driven | 외부 기획 산출물 |
|
|
194
|
+
| 🟢 New Dev | 첫 기능 개발 | setup → pm → lead → [코딩] → reviewer → wrap-up |
|
|
195
|
+
| 🔵 Continue | 작업 재개 | lead → [코딩] → reviewer → wrap-up |
|
|
196
|
+
| 🔴 Bug Fix | 디버깅 | debug → [수정] → reviewer → wrap-up |
|
|
197
|
+
| 🟡 Direction Change | 목표/기술 변경 | pivot → pm → lead → [코딩] → reviewer → wrap-up |
|
|
198
|
+
| 🟣 Crew-Driven | 외부 기획 산출물 | setup(crew) → pm → lead → [코딩] → reviewer → wrap-up |
|
|
207
199
|
|
|
208
200
|
각 단계 완료 시 🧭 **Navigation 블록**이 다음에 무엇을 해야 하는지 — 입력할 프롬프트까지 안내합니다.
|
|
209
201
|
|
|
210
|
-
- **
|
|
202
|
+
- **pm**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
|
|
211
203
|
- **reviewer**: 코드 리뷰 + state 파일 업데이트 감사
|
|
212
|
-
- **
|
|
213
|
-
- **
|
|
214
|
-
- **
|
|
204
|
+
- **lead**: **Wave-Level Pacing** — 구현 Wave 사이에 자동 테스트 실행
|
|
205
|
+
- **wrap-up**: 세션 종료 전 교훈 캡처
|
|
206
|
+
- **debug**: **Recalculating Mode** — 3회 실패 후 대안 접근법 제시
|
|
215
207
|
|
|
216
208
|
### 4단계: 방향 전환 (Direction Changes)
|
|
217
209
|
|
|
@@ -256,25 +248,24 @@ npx @kodevibe/harness init --team
|
|
|
256
248
|
|
|
257
249
|
| # | 규칙 | 적용 대상 |
|
|
258
250
|
|---|------|----------|
|
|
259
|
-
| 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `
|
|
251
|
+
| 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `sync-tests` |
|
|
260
252
|
| 2 | **타입 확인** — 생성자 호출 전 소스 파일을 직접 읽기. 기억에 의존하지 않기 | `reviewer` |
|
|
261
|
-
| 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `
|
|
262
|
-
| 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `
|
|
253
|
+
| 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `lead`, `reviewer` |
|
|
254
|
+
| 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `secure`, `reviewer` |
|
|
263
255
|
| 5 | **3회 실패 정지** — 같은 접근이 3번 실패하면 → 중단 후 보고 | 모든 에이전트 |
|
|
264
|
-
| 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `
|
|
265
|
-
| 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `
|
|
266
|
-
| 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `
|
|
256
|
+
| 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `wrap-up` |
|
|
257
|
+
| 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `wrap-up` |
|
|
258
|
+
| 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `wrap-up` |
|
|
267
259
|
|
|
268
260
|
---
|
|
269
261
|
|
|
270
|
-
## 왜
|
|
262
|
+
## 왜 만들었나
|
|
271
263
|
|
|
272
|
-
|
|
264
|
+
기존 AI 코딩 프레임워크는 **AI가 무엇을 하는지** — 코드 생성, 테스트 실행, 배포에 집중합니다. 하지만 진짜 문제는 능력이 아닙니다. **방향**입니다.
|
|
273
265
|
|
|
274
|
-
|
|
275
|
-
kode:harness는 **AI가 어디로 가는지** — 모든 개발자의 AI가 같은 방향으로 움직이는지에 집중합니다.
|
|
266
|
+
혼자 개발하면 방향이 일관됩니다. 하지만 팀에서는 각 개발자의 AI가 독립적으로 이탈합니다. 그리고 혼자 개발해도 세션 간 방향을 잃습니다 — 우리가 **컨텍스트 부패(Context Rot)**라 부르는 현상입니다. AI는 아키텍처 결정을 잊고, 확정된 사항을 재논의하며, 자신의 이전 작업과 모순됩니다.
|
|
276
267
|
|
|
277
|
-
|
|
268
|
+
kode:harness는 **AI가 어디로 가는지**에 집중합니다. 개발자, IDE, 시간을 넘어 모든 AI 세션에 동일한 목표, 결정, 프로젝트 상태를 제공합니다. 이 근간이 되는 원칙이 **harness engineering** — 어떤 LLM이든 읽을 수 있는 경량 마크다운 네이티브 가드레일입니다.
|
|
278
269
|
|
|
279
270
|
### Crew Artifact Integration (🟣 파이프라인)
|
|
280
271
|
|
|
@@ -292,7 +283,7 @@ Bootstrap이 `docs/crew/`, `docs/PM/`, `docs/Analyst/`, `docs/ARB/`에서 crew
|
|
|
292
283
|
|
|
293
284
|
원본 crew 문서는 **절대 수정되지 않습니다**. 인덱스와 트래커만 생성됩니다.
|
|
294
285
|
|
|
295
|
-
### 비교
|
|
286
|
+
### 다른 프레임워크와의 비교
|
|
296
287
|
|
|
297
288
|
| | BMAD v6.2.2 | gstack v0.15.1 | GSD v1.33.0 | **kode:harness** |
|
|
298
289
|
|---|---|---|---|---|
|
|
@@ -302,21 +293,22 @@ Bootstrap이 `docs/crew/`, `docs/PM/`, `docs/Analyst/`, `docs/ARB/`에서 crew
|
|
|
302
293
|
| IDE 지원 | 20+ (installer) | 5 (setup --host) | 13 (runtime select) | 6 (네이티브 포맷) |
|
|
303
294
|
| 방향 관리 | ❌ | ❌ | ❌ | ✅ (Direction Guard + pivot + Decision Log) |
|
|
304
295
|
| Iron Laws (코드 품질 규칙) | ❌ | ❌ | ❌ | ✅ (8개 규칙이 스킬에 임베딩) |
|
|
305
|
-
| Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`
|
|
296
|
+
| Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`setup` 스킬) |
|
|
306
297
|
| 태스크당 컨텍스트 | 4-6 파일 | 1 파일 | 매번 200k 플랜 | **2-3 파일 (136줄 디스패처)** |
|
|
307
298
|
|
|
308
299
|
---
|
|
309
300
|
|
|
310
301
|
## 로드맵
|
|
311
302
|
|
|
312
|
-
kode:harness는 현재 **v0.
|
|
303
|
+
kode:harness는 현재 **v0.9.0** — 네이밍 재설계 완료, 6개 IDE 지원, Navigation Dispatcher와 Crew Artifact Integration 안정화.
|
|
313
304
|
|
|
314
305
|
| 단계 | 버전 | 상태 | 초점 |
|
|
315
306
|
|------|------|------|------|
|
|
316
307
|
| **Foundation** | v0.5.0 | ✅ 완료 | 핵심 프레임워크: 6 IDE 지원, 8 스킬, 3 에이전트, Team Mode, Direction Guard |
|
|
317
308
|
| **Hardening** | v0.6.5 | ✅ 완료 | 10 스킬, 4 에이전트, Iron Laws, CLI batch/doctor/validate, 방향 드리프트 감지 |
|
|
318
309
|
| **Flexibility** | v0.7.x | ✅ 완료 | 팀 컨벤션을 project-brief.md에 위임, prescriptive 규칙 제거 |
|
|
319
|
-
| **Navigation** | v0.8.x | ✅
|
|
310
|
+
| **Navigation** | v0.8.x | ✅ 완료 | 🧭 Navigation Dispatcher, 5개 파이프라인, Crew Artifact Integration, 100점 품질 감사, Confirm-First 게이트, Wave-Level Pacing, Recalculating Mode |
|
|
311
|
+
| **Naming** | v0.9.0 | ✅ 현재 | 스킬/에이전트 네이밍 재설계 — 직관성과 발견성 강화 |
|
|
320
312
|
| **Validation** | v1.0 | 🔜 다음 | 실사용 검증, 사용자 피드백 수집 |
|
|
321
313
|
|
|
322
314
|
### 다음 단계
|