@kodevibe/harness 0.8.3 → 0.9.0

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
@@ -13,7 +13,7 @@
13
13
 
14
14
  kode:harness는 **harness engineering** 원칙을 기반으로 합니다. 멀티 개발자와 엔터프라이즈급 환경, 그리고 solo 개발 흐름까지 고려한 AI 개발 엔지니어링 방식을 제품 형태로 제공하는 구조입니다.
15
15
 
16
- > **v0.8.3** — 6개 IDE 지원, Navigation Dispatcher, 5개 파이프라인 (🟢🔵🔴🟡🟣), Crew Artifact Integration, 100점 품질 감사.
16
+ > **v0.9.0** — 네이밍 재설계 (스킬/에이전트 이름 직관화), 6개 IDE 지원, Navigation Dispatcher, 5개 파이프라인 (🟢🔵🔴🟡🟣), Crew Artifact Integration.
17
17
 
18
18
  ---
19
19
 
@@ -77,9 +77,9 @@ npx @kodevibe/harness init --team
77
77
 
78
78
  프롬프트에서 IDE를 선택하면 현재 디렉토리에 파일이 설치됩니다.
79
79
 
80
- 설치 후, LLM에게 `bootstrap` 스킬을 실행하도록 요청하세요:
80
+ 설치 후, LLM에게 `setup` 스킬을 실행하도록 요청하세요:
81
81
 
82
- > "bootstrap을 실행해서 이 프로젝트를 온보딩해줘."
82
+ > "setup을 실행해서 이 프로젝트를 온보딩해줘."
83
83
 
84
84
  코드베이스를 스캔하고 5개 State 파일을 자동으로 채웁니다.
85
85
 
@@ -143,24 +143,24 @@ npx @kodevibe/harness validate
143
143
 
144
144
  | 스킬 | 설명 |
145
145
  |------|------|
146
- | **bootstrap** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
147
- | **learn** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
146
+ | **setup** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
147
+ | **wrap-up** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
148
148
  | **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 파일, 보안, 버전) |
149
+ | **sync-tests** | 커밋 전 mock/인터페이스 동기화 검증 |
150
+ | **secure** | 커밋 전 보안 위험 스캔 |
151
+ | **debug** | 4단계 체계적 디버깅 (증거 → 범위축소 → 수정 → 검증) |
152
+ | **check-impact** | 공유 모듈 수정 전 영향 범위 평가 |
153
+ | **breakdown** | 기능을 의존성 순서대로 구현 태스크로 분해 |
154
+ | **pr-review** | PR 코드 리뷰: 품질, 보안, 방향 정렬 확인 |
155
+ | **release** | 배포 전 검증 체크리스트 (테스트, state 파일, 보안, 버전) |
156
156
 
157
157
  ### 에이전트 (역할 기반 페르소나)
158
158
 
159
159
  | 에이전트 | 역할 |
160
160
  |---------|------|
161
- | **planner** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
161
+ | **pm** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
162
162
  | **reviewer** | 코드 리뷰 + State 파일 감사 (state 파일이 실제로 업데이트되었는지 검증) |
163
- | **sprint-manager** | 스프린트/스토리 상태 관리, 범위 이탈 방지, 다음 단계 추천 |
163
+ | **lead** | 스프린트/스토리 상태 관리, 범위 이탈 방지, 다음 단계 추천 |
164
164
  | **architect** | 설계 리뷰 게이트: 구조 변경이 프로젝트 방향 및 모듈 경계에 부합하는지 검증 |
165
165
 
166
166
  ### State 파일 (프로젝트 메모리)
@@ -179,7 +179,7 @@ npx @kodevibe/harness validate
179
179
 
180
180
  ### 1단계: Bootstrap (최초 1회)
181
181
 
182
- `harness init` 후 `bootstrap` 스킬을 실행합니다. 코드베이스를 스캔하고, 목표/비목표에 대해 질문한 후, 5개 state 파일을 자동으로 채웁니다. **가장 중요한 단계입니다** — 이것 없이는 Direction Guard 등 다른 스킬이 컨텍스트를 가지지 못합니다.
182
+ `harness init` 후 `setup` 스킬을 실행합니다. 코드베이스를 스캔하고, 목표/비목표에 대해 질문한 후, 5개 state 파일을 자동으로 채웁니다. **가장 중요한 단계입니다** — 이것 없이는 Direction Guard 등 다른 스킬이 컨텍스트를 가지지 못합니다.
183
183
 
184
184
  ### 2단계: Direction Guard (매 요청마다)
185
185
 
@@ -192,26 +192,26 @@ npx @kodevibe/harness validate
192
192
  ### 3단계: Workflow Pipeline
193
193
 
194
194
  ```
195
- bootstrapplanner → [코딩] → reviewer → sprint-managerlearn
195
+ setuppm → [코딩] → reviewer → leadwrap-up
196
196
  ```
197
197
 
198
198
  kode:harness는 상황별 **5개 파이프라인**을 제공합니다:
199
199
 
200
200
  | 파이프라인 | 상황 | 흐름 |
201
201
  |---|---|---|
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 |
202
+ | 🟢 New Dev | 첫 기능 개발 | setuppmlead → [코딩] → reviewer → wrap-up |
203
+ | 🔵 Continue | 작업 재개 | lead → [코딩] → reviewer → wrap-up |
204
+ | 🔴 Bug Fix | 디버깅 | debug → [수정] → reviewer → wrap-up |
205
+ | 🟡 Direction Change | 목표/기술 변경 | pivot → pmlead → [코딩] → reviewer → wrap-up |
206
+ | 🟣 Crew-Driven | 외부 기획 산출물 | setup(crew) → pmlead → [코딩] → reviewer → wrap-up |
207
207
 
208
208
  각 단계 완료 시 🧭 **Navigation 블록**이 다음에 무엇을 해야 하는지 — 입력할 프롬프트까지 안내합니다.
209
209
 
210
- - **planner**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
210
+ - **pm**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
211
211
  - **reviewer**: 코드 리뷰 + state 파일 업데이트 감사
212
- - **sprint-manager**: **Wave-Level Pacing** — 구현 Wave 사이에 자동 테스트 실행
213
- - **learn**: 세션 종료 전 교훈 캡처
214
- - **investigate**: **Recalculating Mode** — 3회 실패 후 대안 접근법 제시
212
+ - **lead**: **Wave-Level Pacing** — 구현 Wave 사이에 자동 테스트 실행
213
+ - **wrap-up**: 세션 종료 전 교훈 캡처
214
+ - **debug**: **Recalculating Mode** — 3회 실패 후 대안 접근법 제시
215
215
 
216
216
  ### 4단계: 방향 전환 (Direction Changes)
217
217
 
@@ -256,14 +256,14 @@ npx @kodevibe/harness init --team
256
256
 
257
257
  | # | 규칙 | 적용 대상 |
258
258
  |---|------|----------|
259
- | 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `test-integrity` |
259
+ | 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `sync-tests` |
260
260
  | 2 | **타입 확인** — 생성자 호출 전 소스 파일을 직접 읽기. 기억에 의존하지 않기 | `reviewer` |
261
- | 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `sprint-manager`, `reviewer` |
262
- | 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `security-checklist`, `reviewer` |
261
+ | 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `lead`, `reviewer` |
262
+ | 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `secure`, `reviewer` |
263
263
  | 5 | **3회 실패 정지** — 같은 접근이 3번 실패하면 → 중단 후 보고 | 모든 에이전트 |
264
- | 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `learn` |
265
- | 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `learn` |
266
- | 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `learn` |
264
+ | 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `wrap-up` |
265
+ | 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `wrap-up` |
266
+ | 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `wrap-up` |
267
267
 
268
268
  ---
269
269
 
@@ -302,21 +302,22 @@ Bootstrap이 `docs/crew/`, `docs/PM/`, `docs/Analyst/`, `docs/ARB/`에서 crew
302
302
  | IDE 지원 | 20+ (installer) | 5 (setup --host) | 13 (runtime select) | 6 (네이티브 포맷) |
303
303
  | 방향 관리 | ❌ | ❌ | ❌ | ✅ (Direction Guard + pivot + Decision Log) |
304
304
  | Iron Laws (코드 품질 규칙) | ❌ | ❌ | ❌ | ✅ (8개 규칙이 스킬에 임베딩) |
305
- | Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`bootstrap` 스킬) |
305
+ | Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`setup` 스킬) |
306
306
  | 태스크당 컨텍스트 | 4-6 파일 | 1 파일 | 매번 200k 플랜 | **2-3 파일 (136줄 디스패처)** |
307
307
 
308
308
  ---
309
309
 
310
310
  ## 로드맵
311
311
 
312
- kode:harness는 현재 **v0.8.3** — 6개 IDE 지원 완료, Navigation Dispatcher와 Crew Artifact Integration 안정화.
312
+ kode:harness는 현재 **v0.9.0** — 네이밍 재설계 완료, 6개 IDE 지원, Navigation Dispatcher와 Crew Artifact Integration 안정화.
313
313
 
314
314
  | 단계 | 버전 | 상태 | 초점 |
315
315
  |------|------|------|------|
316
316
  | **Foundation** | v0.5.0 | ✅ 완료 | 핵심 프레임워크: 6 IDE 지원, 8 스킬, 3 에이전트, Team Mode, Direction Guard |
317
317
  | **Hardening** | v0.6.5 | ✅ 완료 | 10 스킬, 4 에이전트, Iron Laws, CLI batch/doctor/validate, 방향 드리프트 감지 |
318
318
  | **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 |
319
+ | **Navigation** | v0.8.x | ✅ 완료 | 🧭 Navigation Dispatcher, 5개 파이프라인, Crew Artifact Integration, 100점 품질 감사, Confirm-First 게이트, Wave-Level Pacing, Recalculating Mode |
320
+ | **Naming** | v0.9.0 | ✅ 현재 | 스킬/에이전트 네이밍 재설계 — 직관성과 발견성 강화 |
320
321
  | **Validation** | v1.0 | 🔜 다음 | 실사용 검증, 사용자 피드백 수집 |
321
322
 
322
323
  ### 다음 단계
package/README.md CHANGED
@@ -13,7 +13,7 @@
13
13
 
14
14
  kode:harness is built on **harness engineering** for multi-developer, enterprise-grade AI-assisted development.
15
15
 
16
- > **v0.8.3** — 6 IDE support, Navigation Dispatcher, 5 Pipelines (🟢🔵🔴🟡🟣), Crew Artifact Integration, 100-point quality audit.
16
+ > **v0.9.0** — Naming redesign (clearer skill/agent names), 6 IDE support, Navigation Dispatcher, 5 Pipelines (🟢🔵🔴🟡🟣), Crew Artifact Integration.
17
17
 
18
18
  ## From Harness to Enterprise Harness Engineering
19
19
 
@@ -45,7 +45,7 @@ kode:harness manages your **project's direction** — goals, decisions, scope
45
45
  - **Crew Artifact Integration** — Reads external planning output (PRD, Architecture, ARB Checklist) directly — no manual copy needed
46
46
  - **State Files** — 5 markdown files that persist project knowledge across LLM sessions
47
47
  - **Skills** — Step-by-step procedures for planning, review, debugging, and direction changes
48
- - **Agents** — Role-based personas that enforce the workflow (planner, reviewer, sprint-manager)
48
+ - **Agents** — Role-based personas that enforce the workflow (pm, reviewer, lead)
49
49
  - **Failure Patterns** — Project-specific failure log that prevents repeat mistakes
50
50
  - **Decision Log** — Records why decisions were made so LLMs don't re-debate settled choices
51
51
 
@@ -61,9 +61,9 @@ npx @kodevibe/harness init --team
61
61
 
62
62
  Select your IDE when prompted. Files are installed into the current directory.
63
63
 
64
- After installation, ask your LLM to run the `bootstrap` skill:
64
+ After installation, ask your LLM to run the `setup` skill:
65
65
 
66
- > "Run bootstrap to onboard this project."
66
+ > "Run setup to onboard this project."
67
67
 
68
68
  This scans your codebase and fills all 5 state files automatically.
69
69
 
@@ -111,7 +111,7 @@ Large projects with crew artifacts may require increased turn limits:
111
111
  | Windsurf | Auto-managed | Default OK |
112
112
  | Claude Code | Terminal-based | Default OK |
113
113
 
114
- > This is only needed when running `bootstrap` with crew artifacts on projects that have many existing frameworks. Normal coding/review operations work within default limits.
114
+ > This is only needed when running `setup` with crew artifacts on projects that have many existing frameworks. Normal coding/review operations work within default limits.
115
115
 
116
116
  ## Supported IDEs
117
117
 
@@ -132,21 +132,21 @@ All IDEs also get state files (`project-state.md`, `project-brief.md`, `features
132
132
  - **Core Rules** — 136-line dispatcher: session start guidance, workflow references, state file list, and Iron Laws. Detailed rules are embedded in each skill/agent that enforces them.
133
133
 
134
134
  ### Skills (on-demand procedures)
135
- - **bootstrap** — Onboard project into kode:harness: scans codebase + fills state files automatically
136
- - **learn** — End-of-session wrap-up: captures failure patterns, updates project state, detects direction drift
135
+ - **setup** — Onboard project into kode:harness: scans codebase + fills state files automatically
136
+ - **wrap-up** — End-of-session wrap-up: captures failure patterns, updates project state, detects direction drift
137
137
  - **pivot** — Propagate direction changes across all state files when goals/tech/scope changes
138
- - **test-integrity** — Verify mock/interface synchronization before committing
139
- - **security-checklist** — Pre-commit security risk scan
140
- - **investigate** — 4-phase systematic debugging (evidence → scope → fix → verify)
141
- - **impact-analysis** — Assess change blast radius before modifying shared modules
142
- - **feature-breakdown** — Decompose features into dependency-ordered implementation tasks
143
- - **code-review-pr** — Review incoming Pull Requests for quality, security, and direction alignment
144
- - **deployment** — Pre-deployment validation checklist (tests, state files, security, versioning)
138
+ - **sync-tests** — Verify mock/interface synchronization before committing
139
+ - **secure** — Pre-commit security risk scan
140
+ - **debug** — 4-phase systematic debugging (evidence → scope → fix → verify)
141
+ - **check-impact** — Assess change blast radius before modifying shared modules
142
+ - **breakdown** — Decompose features into dependency-ordered implementation tasks
143
+ - **pr-review** — Review incoming Pull Requests for quality, security, and direction alignment
144
+ - **release** — Pre-release validation checklist (tests, state files, security, versioning)
145
145
 
146
146
  ### Agents (role-based personas)
147
- - **planner** — Feature planning, dependency analysis, Direction Alignment (goal/non-goal/decision check)
147
+ - **pm** — Feature planning, dependency analysis, Direction Alignment (goal/non-goal/decision check)
148
148
  - **reviewer** — Code review + State File Audit (verifies state files were actually updated)
149
- - **sprint-manager** — Sprint/Story state management, scope drift prevention, Next Step Recommendation
149
+ - **lead** — Sprint/Story state management, scope drift prevention, Next Step Recommendation
150
150
  - **architect** — Design review gate: validates structural changes against project direction and module boundaries
151
151
 
152
152
  ### State Files (project memory)
@@ -159,7 +159,7 @@ All IDEs also get state files (`project-state.md`, `project-brief.md`, `features
159
159
  ## How It Works
160
160
 
161
161
  ### 1. Bootstrap (once)
162
- After `harness init`, run the `bootstrap` skill. It scans your codebase, interviews you about goals/non-goals, and fills all 5 state files automatically. **This is the most important step** — without it, Direction Guard and other skills have no context.
162
+ After `harness init`, run the `setup` skill. It scans your codebase, interviews you about goals/non-goals, and fills all 5 state files automatically. **This is the most important step** — without it, Direction Guard and other skills have no context.
163
163
 
164
164
  ### 2. Direction Guard (every request)
165
165
  Before ANY coding task, the LLM reads `project-brief.md` and checks:
@@ -169,26 +169,26 @@ Before ANY coding task, the LLM reads `project-brief.md` and checks:
169
169
 
170
170
  ### 3. Workflow Pipeline
171
171
  ```
172
- bootstrapplanner → [code] → reviewer → sprint-managerlearn
172
+ setuppm → [code] → reviewer → leadwrap-up
173
173
  ```
174
174
 
175
175
  kode:harness provides **5 pipelines** for different scenarios:
176
176
 
177
177
  | Pipeline | When | Flow |
178
178
  |---|---|---|
179
- | 🟢 New Dev | First feature | bootstrapplannersprint-manager → [code] → reviewer → learn |
180
- | 🔵 Continue | Resuming work | sprint-manager → [code] → reviewer → learn |
181
- | 🔴 Bug Fix | Debugging | investigate → [fix] → reviewer → learn |
182
- | 🟡 Direction Change | Goals/tech shift | pivot → plannersprint-manager → [code] → reviewer → learn |
183
- | 🟣 Crew-Driven | With external planning artifacts | bootstrap(crew) → plannersprint-manager → [code] → reviewer → learn |
179
+ | 🟢 New Dev | First feature | setuppmlead → [code] → reviewer → wrap-up |
180
+ | 🔵 Continue | Resuming work | lead → [code] → reviewer → wrap-up |
181
+ | 🔴 Bug Fix | Debugging | debug → [fix] → reviewer → wrap-up |
182
+ | 🟡 Direction Change | Goals/tech shift | pivot → pmlead → [code] → reviewer → wrap-up |
183
+ | 🟣 Crew-Driven | With external planning artifacts | setup(crew) → pmlead → [code] → reviewer → wrap-up |
184
184
 
185
185
  Each step ends with a 🧭 **Navigation block** telling you exactly what to do next — including the prompt to type.
186
186
 
187
- - **planner**: Checks direction alignment, breaks down features. **Confirm-First gate** — won't proceed without your approval.
187
+ - **pm**: Checks direction alignment, breaks down features. **Confirm-First gate** — won't proceed without your approval.
188
188
  - **reviewer**: Reviews code + audits state file updates
189
- - **sprint-manager**: Tracks progress via **Wave-Level Pacing** — runs tests between implementation waves
190
- - **learn**: Captures lessons before session ends
191
- - **investigate**: **Recalculating Mode** — after 3 failed attempts, proposes alternative approaches
189
+ - **lead**: Tracks progress via **Wave-Level Pacing** — runs tests between implementation waves
190
+ - **wrap-up**: Captures lessons before session ends
191
+ - **debug**: **Recalculating Mode** — after 3 failed attempts, proposes alternative approaches
192
192
 
193
193
  ### 4. Direction Changes
194
194
  When goals, technology, or scope changes, run the `pivot` skill:
@@ -227,14 +227,14 @@ These 8 rules are enforced across all skills and agents. They form the quality b
227
227
 
228
228
  | # | Law | Enforced By |
229
229
  |---|-----|-------------|
230
- | 1 | **Mock Sync** — Interface change → update mocks in the same commit | `reviewer`, `test-integrity` |
230
+ | 1 | **Mock Sync** — Interface change → update mocks in the same commit | `reviewer`, `sync-tests` |
231
231
  | 2 | **Type Check** — Read the source before calling constructors. Never trust memory. | `reviewer` |
232
- | 3 | **Scope Compliance** — Stay within current Story scope. Report before modifying out-of-scope files. | `sprint-manager`, `reviewer` |
233
- | 4 | **Security** — No credentials, passwords, or API keys in code or commits. | `security-checklist`, `reviewer` |
232
+ | 3 | **Scope Compliance** — Stay within current Story scope. Report before modifying out-of-scope files. | `lead`, `reviewer` |
233
+ | 4 | **Security** — No credentials, passwords, or API keys in code or commits. | `secure`, `reviewer` |
234
234
  | 5 | **3-Failure Stop** — Same approach fails 3 times → stop and report. | All agents |
235
- | 6 | **Dependency Map** — New/modified module → update `dependency-map.md` in the same commit. | `reviewer`, `learn` |
236
- | 7 | **Feature Registry** — New feature → register in `features.md` in the same commit. | `reviewer`, `learn` |
237
- | 8 | **Session Handoff** — Session end → update `project-state.md` Quick Summary. | `learn` |
235
+ | 6 | **Dependency Map** — New/modified module → update `dependency-map.md` in the same commit. | `reviewer`, `wrap-up` |
236
+ | 7 | **Feature Registry** — New feature → register in `features.md` in the same commit. | `reviewer`, `wrap-up` |
237
+ | 8 | **Session Handoff** — Session end → update `project-state.md` Quick Summary. | `wrap-up` |
238
238
 
239
239
  ## Documentation
240
240
 
@@ -272,19 +272,20 @@ Original crew documents are **never modified**. Only the index and tracker are c
272
272
  | IDE support | 20+ (installer) | 5 (setup --host) | 13 (runtime select) | 6 (native format) |
273
273
  | Direction management | ❌ | ❌ | ❌ | ✅ (Direction Guard + pivot + Decision Log) |
274
274
  | Iron Laws (code quality rules) | ❌ | ❌ | ❌ | ✅ (8 laws embedded in skills) |
275
- | Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`bootstrap` skill) |
275
+ | Cold start | ❌ | ❌ | `/gsd-new-project` | ✅ (`setup` skill) |
276
276
  | Context per task | 4-6 files | 1 file | Fresh 200k per plan | 2-3 files (136-line dispatcher) |
277
277
 
278
278
  ## Roadmap
279
279
 
280
- kode:harness is at **v0.8.3** — 6 IDE support complete, Navigation Dispatcher and Crew Artifact Integration stable.
280
+ kode:harness is at **v0.9.0** — naming redesign complete, 6 IDE support, Navigation Dispatcher and Crew Artifact Integration stable.
281
281
 
282
282
  | Phase | Version | Status | Focus |
283
283
  |---|---|---|---|
284
284
  | **Foundation** | v0.5.0 | ✅ Done | Core framework: 6 IDE support, 8 skills, 3 agents, Team Mode, Direction Guard |
285
285
  | **Hardening** | v0.6.5 | ✅ Done | 10 skills, 4 agents, Iron Laws, CLI batch/doctor/validate, merge conflict SOP, direction drift detection |
286
286
  | **Flexibility** | v0.7.x | ✅ Done | Delegate team conventions to project-brief.md, remove prescriptive rules |
287
- | **Navigation** | v0.8.x | ✅ Current | 🧭 Navigation Dispatcher, 5 Pipelines, Crew Artifact Integration, 100-point quality audit, Confirm-First gate, Wave-Level Pacing, Recalculating Mode |
287
+ | **Navigation** | v0.8.x | ✅ Done | 🧭 Navigation Dispatcher, 5 Pipelines, Crew Artifact Integration, 100-point quality audit, Confirm-First gate, Wave-Level Pacing, Recalculating Mode |
288
+ | **Naming** | v0.9.0 | ✅ Current | Skill/agent naming redesign for clarity and discoverability |
288
289
  | **Validation** | v1.0 | 🔜 Next | Real-world project adoption, user feedback collection |
289
290
 
290
291
  ### What's Next
@@ -1,6 +1,6 @@
1
1
  # Architect Memory
2
2
 
3
- > Auto-updated by the `learn` skill at session end. Do not edit manually.
3
+ > Auto-updated by the `wrap-up` skill at session end. Do not edit manually.
4
4
  > **Initialization**: After the first architecture review, replace placeholder comments below with real data.
5
5
  > **Update trigger**: Only updated when the `architect` agent runs. If architect was not invoked this session, this file stays unchanged.
6
6
 
@@ -27,7 +27,7 @@
27
27
  <!-- Record anti-patterns with severity, detection method, and prevention.
28
28
  Format: Pattern — Severity (HIGH/MED/LOW) — Detection — Resolution — Prevention
29
29
  Examples:
30
- - Circular dep auth↔user — HIGH — dependency-map bidirectional check — extracted shared types — run impact-analysis before interface changes
30
+ - Circular dep auth↔user — HIGH — dependency-map bidirectional check — extracted shared types — run check-impact before interface changes
31
31
  - God module in utils/ (800+ lines) — MED — file size check — decompose into auth-utils, date-utils, string-utils — enforce max 200 lines per module
32
32
  -->
33
33
 
@@ -1,8 +1,8 @@
1
1
  # Sprint Manager Memory
2
2
 
3
- > Auto-updated by the `learn` skill at session end. Do not edit manually.
3
+ > Auto-updated by the `wrap-up` skill at session end. Do not edit manually.
4
4
  > **Initialization**: After the first sprint completes, replace placeholder comments below with real data.
5
- > **Update trigger**: Updated when `learn` skill runs after sprint management actions.
5
+ > **Update trigger**: Updated when `wrap-up` skill runs after sprint management actions.
6
6
 
7
7
  ## Velocity Tracking
8
8
 
@@ -12,13 +12,13 @@
12
12
  - [Sprint 1] 3/5 (60%) — ramp-up phase, scope adjusted mid-sprint
13
13
  - [Sprint 2] 4/4 (100%) — right-sized after Sprint 1 calibration
14
14
  - [Sprint 3] 5/5 (100%) — team rhythm established
15
- Benchmark: Set after 3+ sprints. If rate < 50% for 2 consecutive sprints → flag in sprint-manager recommendations.
15
+ Benchmark: Set after 3+ sprints. If rate < 50% for 2 consecutive sprints → flag in lead recommendations.
16
16
  Average velocity: recalculate after each sprint (e.g., "Average: 4.0 stories/sprint after 3 sprints")
17
17
  -->
18
18
 
19
19
  ## Scope Drift History
20
20
 
21
- <!-- Record scope violations caught by sprint-manager or reviewer.
21
+ <!-- Record scope violations caught by lead or reviewer.
22
22
  Format: [Story ID] Drift type — Files affected — Resolution
23
23
  Examples:
24
24
  - [S1-003] Out-of-scope modification — 3 files in auth/ (not in story scope) — reverted, created new story S1-005
@@ -1,8 +1,8 @@
1
1
  # Planner Memory
2
2
 
3
- > Auto-updated by the `learn` skill at session end. Do not edit manually.
3
+ > Auto-updated by the `wrap-up` skill at session end. Do not edit manually.
4
4
  > **Initialization**: After the first sprint completes, replace placeholder comments below with real data.
5
- > **Update trigger**: Updated when `learn` skill runs after a planner session.
5
+ > **Update trigger**: Updated when `wrap-up` skill runs after a pm session.
6
6
 
7
7
  ## Estimation Accuracy
8
8
 
@@ -43,5 +43,5 @@
43
43
  - [Sprint 1] Planned: 5, Done: 3, Rate: 60% — ramp-up phase, team unfamiliar with codebase
44
44
  - [Sprint 2] Planned: 4, Done: 4, Rate: 100% — right-sized after Sprint 1 data
45
45
  - [Sprint 3] Planned: 4, Done: 5, Rate: 125% — acceleration, consider planning 5 next sprint
46
- Benchmark: After 3+ sprints, calculate average rate. If < 60% for 2 consecutive sprints → investigate causes
46
+ Benchmark: After 3+ sprints, calculate average rate. If < 60% for 2 consecutive sprints → debug causes
47
47
  -->
@@ -1,8 +1,8 @@
1
1
  # Reviewer Memory
2
2
 
3
- > Auto-updated by the `learn` skill at session end. Do not edit manually.
3
+ > Auto-updated by the `wrap-up` skill at session end. Do not edit manually.
4
4
  > **Initialization**: After the first code review, replace placeholder comments below with real data.
5
- > **Update trigger**: Updated when `learn` skill runs after a reviewer session.
5
+ > **Update trigger**: Updated when `wrap-up` skill runs after a reviewer session.
6
6
 
7
7
  ## Project-Specific Review Patterns
8
8
 
@@ -10,7 +10,7 @@
10
10
  Format: Pattern — Location — Severity — Prevention
11
11
  Examples:
12
12
  - SQL injection risk in src/api/routes/ — req.params used directly — HIGH — add parameterized query wrapper
13
- - Mock sync miss rate 50% — interface changes in src/domain/ — HIGH — run test-integrity skill pre-commit
13
+ - Mock sync miss rate 50% — interface changes in src/domain/ — HIGH — run sync-tests skill pre-commit
14
14
  - Hardcoded timeout 5000ms in tests — tests/integration/ — LOW — extract to test config
15
15
  -->
16
16
 
@@ -32,7 +32,7 @@
32
32
  - Escalations: 0
33
33
  <!-- Track ratios after 5+ reviews:
34
34
  - Auto-fix rate: auto-fixes / total issues (if > 30% → consider automating those checks)
35
- - Escalation rate: escalations / total reviews (if > 20% → investigate root cause)
35
+ - Escalation rate: escalations / total reviews (if > 20% → debug root cause)
36
36
  -->
37
37
 
38
38
  ## Test Failure Patterns
@@ -40,7 +40,7 @@
40
40
  <!-- Track which test patterns commonly fail during reviews.
41
41
  Format: Pattern — Frequency — Root Cause — Mitigation
42
42
  Examples:
43
- - Mock method missing after interface change — 4/10 reviews — FP-001 — run test-integrity pre-commit
43
+ - Mock method missing after interface change — 4/10 reviews — FP-001 — run sync-tests pre-commit
44
44
  - Async test timeout — 2/10 reviews — missing await — enforce eslint no-floating-promises
45
45
  - Snapshot mismatch after UI change — 3/10 reviews — stale snapshots — update snapshots in same commit
46
46
  -->
@@ -9,12 +9,12 @@ The Architect is invoked when changes affect multiple modules, introduce new lay
9
9
  ## Invoked By
10
10
 
11
11
  - **User** (direct) — "아키텍처 리뷰해줘", "설계 검토해줘"
12
- - **planner** (optional) — when proposed changes affect 3+ modules or introduce new layers
12
+ - **pm** (optional) — when proposed changes affect 3+ modules or introduce new layers
13
13
 
14
14
  ## Referenced Skills
15
15
 
16
- - impact-analysis — Change blast radius assessment
17
- - feature-breakdown — Task decomposition for structural changes
16
+ - check-impact — Change blast radius assessment
17
+ - breakdown — Task decomposition for structural changes
18
18
 
19
19
  ## Referenced Files
20
20
 
@@ -45,7 +45,7 @@ Before proceeding, verify that required state files have content:
45
45
  - `docs/dependency-map.md` — Must have at least one module row (for existing projects)
46
46
  - `docs/project-brief.md` — Must have Vision and Goals filled
47
47
 
48
- If `docs/project-brief.md` has no Vision/Goals filled OR `docs/dependency-map.md` has zero module rows → **Stop and run the `bootstrap` skill first.** Report: "State files are empty. Running bootstrap to onboard this project."
48
+ If `docs/project-brief.md` has no Vision/Goals filled OR `docs/dependency-map.md` has zero module rows → **Stop and run the `setup` skill first.** Report: "State files are empty. Running setup to onboard this project."
49
49
 
50
50
  **Step 0.1: Circular Dependency Check**
51
51
 
@@ -85,7 +85,7 @@ Apply these insights when evaluating the current proposal. If the memory file is
85
85
  4. If misaligned → **warn and recommend `pivot` before proceeding**
86
86
 
87
87
  **Step 3: Impact Analysis**
88
- 1. Run `impact-analysis` skill on all affected modules
88
+ 1. Run `check-impact` skill on all affected modules
89
89
  2. Identify:
90
90
  - Modules that will be modified
91
91
  - Modules that depend on modified modules (ripple effect)
@@ -140,7 +140,7 @@ After architecture review completes, always append a 🧭 block:
140
140
 
141
141
  | Architect Result | 🧭 Next Step |
142
142
  |---|---|
143
- | APPROVE | `planner` — "승인된 설계로 기능을 계획해줘" |
143
+ | APPROVE | `pm` — "승인된 설계로 기능을 계획해줘" |
144
144
  | REVISE | [Redesign] — "설계를 수정하고 다시 `architect` 호출" |
145
145
  | REJECT | User decision — "설계가 반려되었습니다. 대안을 논의합시다" |
146
146
  | Direction misaligned | `pivot` — "방향을 전환하고 state 파일을 업데이트해줘" |
@@ -149,10 +149,10 @@ Example 🧭 block for APPROVE:
149
149
  ```
150
150
  ---
151
151
  🧭 Next Step
152
- → Next: `planner`
152
+ → Next: `pm`
153
153
  → Prompt: "승인된 설계로 기능을 계획해줘"
154
154
  → Why: Architecture approved — proceed to feature planning
155
- → Pipeline: 🟢 Pre-pipeline (leads to planner Step 2/6)
155
+ → Pipeline: 🟢 Pre-pipeline (leads to pm Step 2/6)
156
156
  ---
157
157
  ```
158
158
 
@@ -161,7 +161,7 @@ Example 🧭 block for APPROVE:
161
161
  - This agent reviews design, it does NOT implement changes
162
162
  - Always defer to `docs/project-brief.md` Decision Log for settled architectural decisions
163
163
  - If unsure about direction, recommend involving the designated authority (per project-brief.md; default: team lead)
164
- - For implementation after approval, hand off to the `planner` agent
164
+ - For implementation after approval, hand off to the `pm` agent
165
165
 
166
166
  <!-- TEAM_MODE_START -->
167
167
  ## Team Mode: Cross-Team Architecture
@@ -8,22 +8,22 @@ Keeps the LLM focused on the current work item.
8
8
  ## Invoked By
9
9
 
10
10
  - **User** (direct) — "다음 Story는?", "현재 상태 보여줘"
11
- - **planner** → User confirmation → sprint-manager (🟢 pipeline Step 3)
12
- - **reviewer** (pass, more stories) → sprint-manager — "다음 Story는?"
11
+ - **pm** → User confirmation → lead (🟢 pipeline Step 3)
12
+ - **reviewer** (pass, more stories) → lead — "다음 Story는?"
13
13
 
14
14
  ## Referenced Skills
15
15
 
16
- - bootstrap — Recommended when state files are empty
17
- - learn — Recommended at session end or when all stories are done
16
+ - setup — Recommended when state files are empty
17
+ - wrap-up — Recommended at session end or when all stories are done
18
18
  - pivot — Recommended when direction change is detected
19
- - investigate — Recommended when bug is blocking progress
19
+ - debug — Recommended when bug is blocking progress
20
20
 
21
21
  ## Referenced Files
22
22
 
23
23
  ### Required — 반드시 읽기
24
24
  - docs/project-state.md — 핵심 파일: 현재 Sprint/Story 상태 (Step 0, 모든 Handler에서 사용)
25
25
  - docs/features.md — 진행률 개요 (Next Step Recommendation에서 사용)
26
- - docs/agent-memory/sprint-manager.md — 과거 velocity 및 scope drift 데이터
26
+ - docs/agent-memory/lead.md — 과거 velocity 및 scope drift 데이터
27
27
 
28
28
  ### Optional — 해당 Step에서만 읽기
29
29
  - docs/project-brief.md — 방향 확인 필요 시에만 읽기
@@ -38,11 +38,11 @@ Before handling any request, verify `docs/project-state.md` has content:
38
38
  - Quick Summary must not be all TODO placeholders
39
39
  - Story Status table must have at least one row
40
40
 
41
- If `docs/project-state.md` is empty/placeholder-only → **Recommend running `bootstrap` skill first.** Report: "docs/project-state.md is empty. Run bootstrap to initialize project state before tracking sprints."
41
+ If `docs/project-state.md` is empty/placeholder-only → **Recommend running `setup` skill first.** Report: "docs/project-state.md is empty. Run setup to initialize project state before tracking sprints."
42
42
 
43
43
  ### Step 0.5: Load Agent Memory
44
44
 
45
- Read `docs/agent-memory/sprint-manager.md` for past learnings:
45
+ Read `docs/agent-memory/lead.md` for past learnings:
46
46
  - Team velocity data (stories per sprint)
47
47
  - Scope drift history (how often did scope expand?)
48
48
  - Story sizing accuracy (were estimates correct?)
@@ -71,15 +71,15 @@ After every status check, recommend the next action based on current context:
71
71
 
72
72
  | Situation | Recommendation |
73
73
  |-----------|---------------|
74
- | State files are empty | → "Run `bootstrap` to onboard this project" |
74
+ | State files are empty | → "Run `setup` to onboard this project" |
75
75
  |docs/project-brief.md has no Vision/Goals | → "Fill out docs/project-brief.md — this is critical for direction" |
76
- | No stories exist | → "Run `planner` to break down your first feature" |
76
+ | No stories exist | → "Run `pm` to break down your first feature" |
77
77
  | A story is in-progress | → "Continue S{N}-{M}: [title]. Scope: [files]" |
78
- | All stories in sprint are done | → "Run `learn` to capture session lessons, then start a new sprint" |
78
+ | All stories in sprint are done | → "Run `wrap-up` to capture session lessons, then start a new sprint" |
79
79
  | A direction change was discussed | → "Run `pivot` to update all state files before continuing" |
80
80
  | Recent failure patterns apply | → "Watch out for FP-{NNN}: [description]" |
81
81
  <!-- CREW_MODE_START -->
82
- | Unplanned KPI/FR in Validation Tracker | → "Run `planner` — add Stories for unplanned KPI/FR items" |
82
+ | Unplanned KPI/FR in Validation Tracker | → "Run `pm` — add Stories for unplanned KPI/FR items" |
83
83
  | All ARB Fail items resolved | → "ARB Fail items all resolved — deployment readiness can be checked" |
84
84
  <!-- CREW_MODE_END -->
85
85
 
@@ -109,20 +109,20 @@ After every status check, recommend the next action based on current context:
109
109
  3. Read `docs/dependency-map.md` to identify modules involved in this Story
110
110
  4. Specify Story scope (related files/directories from dependency-map)
111
111
  5. Alert relevant docs/failure-patterns.md items
112
- 6. Recommend relevant skill: "Consider running `planner` if this story needs detailed breakdown"
112
+ 6. Recommend relevant skill: "Consider running `pm` if this story needs detailed breakdown"
113
113
 
114
- **Request: "plan approved" / "플랜 반영해줘" (plannersprint-manager handoff)**
114
+ **Request: "plan approved" / "플랜 반영해줘" (pmlead handoff)**
115
115
 
116
- When invoked after planner approval, verify that planner wrote state files correctly:
116
+ When invoked after pm approval, verify that pm wrote state files correctly:
117
117
 
118
118
  1. Read `docs/project-state.md` — check if Stories from the approved plan exist
119
119
  2. **If Stories exist** → proceed to "new story" handler (set first `todo` Story to `in-progress`)
120
- 3. **If Stories are missing** (planner failed to write):
120
+ 3. **If Stories are missing** (pm failed to write):
121
121
  a. Read the approved plan from the conversation context
122
122
  b. Create Sprint entry in `docs/project-state.md` (Sprint N, theme from plan)
123
123
  c. Add all Story rows to the Story Status table (status = `⬜ todo`)
124
124
  d. Update Quick Summary section
125
- e. Report: "Planner가 state files에 반영하지 않아 sprint-manager가 보완했습니다."
125
+ e. Report: "Planner가 state files에 반영하지 않아 lead가 보완했습니다."
126
126
  f. Proceed to set the first Story to `in-progress`
127
127
  <!-- CREW_MODE_START -->
128
128
  4. If 🟣 pipeline: verify `docs/project-brief.md` Validation Tracker has Story mappings. If missing, fill them from the plan.
@@ -134,7 +134,7 @@ When invoked after planner approval, verify that planner wrote state files corre
134
134
 
135
135
  **Wave-Level Pacing (Turn-by-Turn Guidance)**
136
136
 
137
- When a Story contains multiple Tasks/Waves (from feature-breakdown):
137
+ When a Story contains multiple Tasks/Waves (from breakdown):
138
138
  - Guide implementation **one Wave at a time** (not one file at a time, not all at once)
139
139
  - After each Wave is implemented, **run tests (or invoke `reviewer` for a quick check)** to verify the Wave is clean before proceeding
140
140
  - Only after verification passes, prompt: "Wave {N} 완료 (tests pass). Wave {N+1}로 넘어갈까요?"
@@ -178,7 +178,7 @@ STATUS: DONE
178
178
  #### Validation Dashboard (🟣 Pipeline only)
179
179
 
180
180
  When `docs/project-brief.md` contains a `## Validation Tracker` section with data, display the Validation Tracker as a dashboard in every status output.
181
- If the Validation Tracker exists but has zero rows (no KPIs/FRs indexed yet), display: `KPI Coverage: 0/0 (N/A) — consider running bootstrap to populate Artifact Index`.
181
+ If the Validation Tracker exists but has zero rows (no KPIs/FRs indexed yet), display: `KPI Coverage: 0/0 (N/A) — consider running setup to populate Artifact Index`.
182
182
 
183
183
  ```
184
184
  ### 📊 Validation Dashboard
@@ -190,19 +190,19 @@ If the Validation Tracker exists but has zero rows (no KPIs/FRs indexed yet), di
190
190
  - [KPI/FR ID]: [description] — 관련 Story 없음
191
191
  ```
192
192
 
193
- **Sprint Manager reads and reports the Validation Tracker numbers.** It does NOT auto-create Stories for missing coverage — that is the planner's role. If unplanned items exist, recommend running `planner`.
193
+ **Sprint Manager reads and reports the Validation Tracker numbers.** It does NOT auto-create Stories for missing coverage — that is the pm's role. If unplanned items exist, recommend running `pm`.
194
194
  <!-- CREW_MODE_END -->
195
195
 
196
196
  ### 🧭 Navigation — What Comes After Sprint Manager
197
197
 
198
- After sprint-manager completes, always append a 🧭 block based on the outcome:
198
+ After lead completes, always append a 🧭 block based on the outcome:
199
199
 
200
200
  | Sprint Manager Result | 🧭 Next Step |
201
201
  |---|---|
202
- | State files empty | `bootstrap` — "프로젝트를 온보딩해줘" |
203
- | No stories exist | `planner` — "[기능]을 계획해줘" |
202
+ | State files empty | `setup` — "프로젝트를 온보딩해줘" |
203
+ | No stories exist | `pm` — "[기능]을 계획해줘" |
204
204
  | Story set to in-progress | [Coding] — "S{N}-{M} 구현을 시작해줘". 완료 후 **새 채팅**에서 reviewer 호출 |
205
- | All stories done | `learn` — "세션을 마무리해줘" |
205
+ | All stories done | `wrap-up` — "세션을 마무리해줘" |
206
206
  | Direction change detected | `pivot` — "방향을 전환해줘" |
207
207
 
208
208
  Example 🧭 block for starting a story: