@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 CHANGED
@@ -9,83 +9,33 @@
9
9
  [![CI](https://github.com/AIDD-Projects/harness/actions/workflows/ci.yml/badge.svg)](https://github.com/AIDD-Projects/harness/actions/workflows/ci.yml)
10
10
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
11
11
 
12
- **모든 개발자의 AI 하나의 프로젝트 방향으로 정렬합니다.**
12
+ > **AI 코딩 에이전트는 세션이 끝나면 모든 것을 잊습니다. kode:harness는 목표, 결정, 실패, 프로젝트 방향을 기억하게 합니다.**
13
13
 
14
- kode:harness는 **harness engineering** 원칙을 기반으로 합니다. 멀티 개발자와 엔터프라이즈급 환경, 그리고 solo 개발 흐름까지 고려한 AI 개발 엔지니어링 방식을 제품 형태로 제공하는 구조입니다.
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
- # Solo 모드 (기본)
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
- 프롬프트에서 IDE를 선택하면 현재 디렉토리에 파일이 설치됩니다.
79
-
80
- 설치 후, LLM에게 `bootstrap` 스킬을 실행하도록 요청하세요:
81
-
82
- > "bootstrap을 실행해서 이 프로젝트를 온보딩해줘."
24
+ ```bash
25
+ # 그 후 AI 에이전트에게:
26
+ > "setup을 실행해서 프로젝트를 온보딩해줘."
27
+ ```
83
28
 
84
- 코드베이스를 스캔하고 5개 State 파일을 자동으로 채웁니다.
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
- ```bash
112
- # kode:harness 파일 설치 상태 확인
113
- npx @kodevibe/harness doctor
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
- # State 파일에 실제 내용이 있는지 검증 (플레이스홀더가 아닌지)
116
- npx @kodevibe/harness validate
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
- | **bootstrap** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
147
- | **learn** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
138
+ | **setup** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
139
+ | **wrap-up** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
148
140
  | **pivot** | 목표·기술·범위 변경 시 모든 state 파일에 변경사항 전파 |
149
- | **test-integrity** | 커밋 전 mock/인터페이스 동기화 검증 |
150
- | **security-checklist** | 커밋 전 보안 위험 스캔 |
151
- | **investigate** | 4단계 체계적 디버깅 (증거 → 범위축소 → 수정 → 검증) |
152
- | **impact-analysis** | 공유 모듈 수정 전 영향 범위 평가 |
153
- | **feature-breakdown** | 기능을 의존성 순서대로 구현 태스크로 분해 |
154
- | **code-review-pr** | PR 코드 리뷰: 품질, 보안, 방향 정렬 확인 |
155
- | **deployment** | 배포 전 검증 체크리스트 (테스트, state 파일, 보안, 버전) |
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
- | **planner** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
153
+ | **pm** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
162
154
  | **reviewer** | 코드 리뷰 + State 파일 감사 (state 파일이 실제로 업데이트되었는지 검증) |
163
- | **sprint-manager** | 스프린트/스토리 상태 관리, 범위 이탈 방지, 다음 단계 추천 |
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` 후 `bootstrap` 스킬을 실행합니다. 코드베이스를 스캔하고, 목표/비목표에 대해 질문한 후, 5개 state 파일을 자동으로 채웁니다. **가장 중요한 단계입니다** — 이것 없이는 Direction Guard 등 다른 스킬이 컨텍스트를 가지지 못합니다.
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
- bootstrapplanner → [코딩] → reviewer → sprint-managerlearn
187
+ setuppm → [코딩] → reviewer → leadwrap-up
196
188
  ```
197
189
 
198
190
  kode:harness는 상황별 **5개 파이프라인**을 제공합니다:
199
191
 
200
192
  | 파이프라인 | 상황 | 흐름 |
201
193
  |---|---|---|
202
- | 🟢 New Dev | 첫 기능 개발 | bootstrapplannersprint-manager → [코딩] → reviewer → learn |
203
- | 🔵 Continue | 작업 재개 | sprint-manager → [코딩] → reviewer → learn |
204
- | 🔴 Bug Fix | 디버깅 | investigate → [수정] → reviewer → learn |
205
- | 🟡 Direction Change | 목표/기술 변경 | pivot → plannersprint-manager → [코딩] → reviewer → learn |
206
- | 🟣 Crew-Driven | 외부 기획 산출물 | bootstrap(crew) → plannersprint-manager → [코딩] → reviewer → learn |
194
+ | 🟢 New Dev | 첫 기능 개발 | setuppmlead → [코딩] → reviewer → wrap-up |
195
+ | 🔵 Continue | 작업 재개 | lead → [코딩] → reviewer → wrap-up |
196
+ | 🔴 Bug Fix | 디버깅 | debug → [수정] → reviewer → wrap-up |
197
+ | 🟡 Direction Change | 목표/기술 변경 | pivot → pmlead → [코딩] → reviewer → wrap-up |
198
+ | 🟣 Crew-Driven | 외부 기획 산출물 | setup(crew) → pmlead → [코딩] → reviewer → wrap-up |
207
199
 
208
200
  각 단계 완료 시 🧭 **Navigation 블록**이 다음에 무엇을 해야 하는지 — 입력할 프롬프트까지 안내합니다.
209
201
 
210
- - **planner**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
202
+ - **pm**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
211
203
  - **reviewer**: 코드 리뷰 + state 파일 업데이트 감사
212
- - **sprint-manager**: **Wave-Level Pacing** — 구현 Wave 사이에 자동 테스트 실행
213
- - **learn**: 세션 종료 전 교훈 캡처
214
- - **investigate**: **Recalculating Mode** — 3회 실패 후 대안 접근법 제시
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`, `test-integrity` |
251
+ | 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `sync-tests` |
260
252
  | 2 | **타입 확인** — 생성자 호출 전 소스 파일을 직접 읽기. 기억에 의존하지 않기 | `reviewer` |
261
- | 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `sprint-manager`, `reviewer` |
262
- | 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `security-checklist`, `reviewer` |
253
+ | 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `lead`, `reviewer` |
254
+ | 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `secure`, `reviewer` |
263
255
  | 5 | **3회 실패 정지** — 같은 접근이 3번 실패하면 → 중단 후 보고 | 모든 에이전트 |
264
- | 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `learn` |
265
- | 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `learn` |
266
- | 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `learn` |
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
- ## 왜 kode:harness인가?
262
+ ## 왜 만들었나
271
263
 
272
- ### 핵심 통찰
264
+ 기존 AI 코딩 프레임워크는 **AI가 무엇을 하는지** — 코드 생성, 테스트 실행, 배포에 집중합니다. 하지만 진짜 문제는 능력이 아닙니다. **방향**입니다.
273
265
 
274
- 기존 AI 코딩 프레임워크는 **AI가 무엇을 하는지**(코드 생성, 테스트 실행, 배포) 집중합니다.
275
- kode:harness는 **AI가 어디로 가는지** — 모든 개발자의 AI가 같은 방향으로 움직이는지에 집중합니다.
266
+ 혼자 개발하면 방향이 일관됩니다. 하지만 팀에서는 각 개발자의 AI가 독립적으로 이탈합니다. 그리고 혼자 개발해도 세션 간 방향을 잃습니다 — 우리가 **컨텍스트 부패(Context Rot)**라 부르는 현상입니다. AI는 아키텍처 결정을 잊고, 확정된 사항을 재논의하며, 자신의 이전 작업과 모순됩니다.
276
267
 
277
- 이것은 개별 AI가 제멋대로 움직이는 것과, harness 기반 방향 관리 기법이 전체를 방향으로 이끄는 것의 차이입니다.
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` | ✅ (`bootstrap` 스킬) |
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.8.4** — 6개 IDE 지원 완료, Navigation Dispatcher와 Crew Artifact Integration 안정화.
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 | ✅ 현재 | 🧭 Navigation Dispatcher, 5개 파이프라인, Crew Artifact Integration, 100점 품질 감사, Confirm-First 게이트, Wave-Level Pacing, Recalculating Mode |
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
  ### 다음 단계