@kodevibe/harness 0.8.4 → 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 +35 -34
- package/README.md +37 -36
- 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} +24 -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
|
@@ -13,7 +13,7 @@
|
|
|
13
13
|
|
|
14
14
|
kode:harness는 **harness engineering** 원칙을 기반으로 합니다. 멀티 개발자와 엔터프라이즈급 환경, 그리고 solo 개발 흐름까지 고려한 AI 개발 엔지니어링 방식을 제품 형태로 제공하는 구조입니다.
|
|
15
15
|
|
|
16
|
-
> **v0.
|
|
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에게 `
|
|
80
|
+
설치 후, LLM에게 `setup` 스킬을 실행하도록 요청하세요:
|
|
81
81
|
|
|
82
|
-
> "
|
|
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
|
-
| **
|
|
147
|
-
| **
|
|
146
|
+
| **setup** | 프로젝트를 kode:harness에 온보딩: 코드베이스 스캔 + state 파일 자동 작성 |
|
|
147
|
+
| **wrap-up** | 세션 종료 시 마무리: 실패 패턴 캡처, 프로젝트 상태 업데이트, 방향 드리프트 감지 |
|
|
148
148
|
| **pivot** | 목표·기술·범위 변경 시 모든 state 파일에 변경사항 전파 |
|
|
149
|
-
| **
|
|
150
|
-
| **
|
|
151
|
-
| **
|
|
152
|
-
| **impact
|
|
153
|
-
| **
|
|
154
|
-
| **
|
|
155
|
-
| **
|
|
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
|
-
| **
|
|
161
|
+
| **pm** | 기능 기획, 의존성 분석, Direction Alignment (목표/비목표/결정사항 체크) |
|
|
162
162
|
| **reviewer** | 코드 리뷰 + State 파일 감사 (state 파일이 실제로 업데이트되었는지 검증) |
|
|
163
|
-
| **
|
|
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` 후 `
|
|
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
|
-
|
|
195
|
+
setup → pm → [코딩] → reviewer → lead → wrap-up
|
|
196
196
|
```
|
|
197
197
|
|
|
198
198
|
kode:harness는 상황별 **5개 파이프라인**을 제공합니다:
|
|
199
199
|
|
|
200
200
|
| 파이프라인 | 상황 | 흐름 |
|
|
201
201
|
|---|---|---|
|
|
202
|
-
| 🟢 New Dev | 첫 기능 개발 |
|
|
203
|
-
| 🔵 Continue | 작업 재개 |
|
|
204
|
-
| 🔴 Bug Fix | 디버깅 |
|
|
205
|
-
| 🟡 Direction Change | 목표/기술 변경 | pivot →
|
|
206
|
-
| 🟣 Crew-Driven | 외부 기획 산출물 |
|
|
202
|
+
| 🟢 New Dev | 첫 기능 개발 | setup → pm → lead → [코딩] → reviewer → wrap-up |
|
|
203
|
+
| 🔵 Continue | 작업 재개 | lead → [코딩] → reviewer → wrap-up |
|
|
204
|
+
| 🔴 Bug Fix | 디버깅 | debug → [수정] → reviewer → wrap-up |
|
|
205
|
+
| 🟡 Direction Change | 목표/기술 변경 | pivot → pm → lead → [코딩] → reviewer → wrap-up |
|
|
206
|
+
| 🟣 Crew-Driven | 외부 기획 산출물 | setup(crew) → pm → lead → [코딩] → reviewer → wrap-up |
|
|
207
207
|
|
|
208
208
|
각 단계 완료 시 🧭 **Navigation 블록**이 다음에 무엇을 해야 하는지 — 입력할 프롬프트까지 안내합니다.
|
|
209
209
|
|
|
210
|
-
- **
|
|
210
|
+
- **pm**: 방향 정렬 확인, 기능 분해. **Confirm-First 게이트** — 사용자 승인 없이 진행하지 않음.
|
|
211
211
|
- **reviewer**: 코드 리뷰 + state 파일 업데이트 감사
|
|
212
|
-
- **
|
|
213
|
-
- **
|
|
214
|
-
- **
|
|
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`, `
|
|
259
|
+
| 1 | **Mock 동기화** — 인터페이스 변경 → 같은 커밋에서 mock 업데이트 | `reviewer`, `sync-tests` |
|
|
260
260
|
| 2 | **타입 확인** — 생성자 호출 전 소스 파일을 직접 읽기. 기억에 의존하지 않기 | `reviewer` |
|
|
261
|
-
| 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `
|
|
262
|
-
| 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `
|
|
261
|
+
| 3 | **범위 준수** — 현재 스토리 범위 내에서만 작업. 범위 외 파일 수정 시 먼저 보고 | `lead`, `reviewer` |
|
|
262
|
+
| 4 | **보안** — 코드나 커밋에 자격증명, 비밀번호, API 키 포함 금지 | `secure`, `reviewer` |
|
|
263
263
|
| 5 | **3회 실패 정지** — 같은 접근이 3번 실패하면 → 중단 후 보고 | 모든 에이전트 |
|
|
264
|
-
| 6 | **의존성 맵** — 모듈 추가/수정 → 같은 커밋에서 `dependency-map.md` 업데이트 | `reviewer`, `
|
|
265
|
-
| 7 | **기능 레지스트리** — 새 기능 → 같은 커밋에서 `features.md`에 등록 | `reviewer`, `
|
|
266
|
-
| 8 | **세션 핸드오프** — 세션 종료 → `project-state.md` Quick Summary 업데이트 | `
|
|
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` | ✅ (`
|
|
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.
|
|
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 | ✅
|
|
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.
|
|
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 (
|
|
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 `
|
|
64
|
+
After installation, ask your LLM to run the `setup` skill:
|
|
65
65
|
|
|
66
|
-
> "Run
|
|
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 `
|
|
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
|
-
- **
|
|
136
|
-
- **
|
|
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
|
-
- **
|
|
139
|
-
- **
|
|
140
|
-
- **
|
|
141
|
-
- **impact
|
|
142
|
-
- **
|
|
143
|
-
- **
|
|
144
|
-
- **
|
|
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
|
-
- **
|
|
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
|
-
- **
|
|
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 `
|
|
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
|
-
|
|
172
|
+
setup → pm → [code] → reviewer → lead → wrap-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 |
|
|
180
|
-
| 🔵 Continue | Resuming work |
|
|
181
|
-
| 🔴 Bug Fix | Debugging |
|
|
182
|
-
| 🟡 Direction Change | Goals/tech shift | pivot →
|
|
183
|
-
| 🟣 Crew-Driven | With external planning artifacts |
|
|
179
|
+
| 🟢 New Dev | First feature | setup → pm → lead → [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 → pm → lead → [code] → reviewer → wrap-up |
|
|
183
|
+
| 🟣 Crew-Driven | With external planning artifacts | setup(crew) → pm → lead → [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
|
-
- **
|
|
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
|
-
- **
|
|
190
|
-
- **
|
|
191
|
-
- **
|
|
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`, `
|
|
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. | `
|
|
233
|
-
| 4 | **Security** — No credentials, passwords, or API keys in code or commits. | `
|
|
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`, `
|
|
236
|
-
| 7 | **Feature Registry** — New feature → register in `features.md` in the same commit. | `reviewer`, `
|
|
237
|
-
| 8 | **Session Handoff** — Session end → update `project-state.md` Quick Summary. | `
|
|
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` | ✅ (`
|
|
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.
|
|
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 | ✅
|
|
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 `
|
|
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
|
|
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 `
|
|
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 `
|
|
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
|
|
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
|
|
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 `
|
|
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 `
|
|
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 →
|
|
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 `
|
|
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 `
|
|
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
|
|
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% →
|
|
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
|
|
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
|
-
- **
|
|
12
|
+
- **pm** (optional) — when proposed changes affect 3+ modules or introduce new layers
|
|
13
13
|
|
|
14
14
|
## Referenced Skills
|
|
15
15
|
|
|
16
|
-
- impact
|
|
17
|
-
-
|
|
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 `
|
|
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
|
|
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 | `
|
|
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: `
|
|
152
|
+
→ Next: `pm`
|
|
153
153
|
→ Prompt: "승인된 설계로 기능을 계획해줘"
|
|
154
154
|
→ Why: Architecture approved — proceed to feature planning
|
|
155
|
-
→ Pipeline: 🟢 Pre-pipeline (leads to
|
|
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 `
|
|
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
|
-
- **
|
|
12
|
-
- **reviewer** (pass, more stories) →
|
|
11
|
+
- **pm** → User confirmation → lead (🟢 pipeline Step 3)
|
|
12
|
+
- **reviewer** (pass, more stories) → lead — "다음 Story는?"
|
|
13
13
|
|
|
14
14
|
## Referenced Skills
|
|
15
15
|
|
|
16
|
-
-
|
|
17
|
-
-
|
|
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
|
-
-
|
|
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/
|
|
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 `
|
|
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/
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
112
|
+
6. Recommend relevant skill: "Consider running `pm` if this story needs detailed breakdown"
|
|
113
113
|
|
|
114
|
-
**Request: "plan approved" / "플랜 반영해줘" (
|
|
114
|
+
**Request: "plan approved" / "플랜 반영해줘" (pm → lead handoff)**
|
|
115
115
|
|
|
116
|
-
When invoked after
|
|
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** (
|
|
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에 반영하지 않아
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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 | `
|
|
203
|
-
| No stories exist | `
|
|
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 | `
|
|
205
|
+
| All stories done | `wrap-up` — "세션을 마무리해줘" |
|
|
206
206
|
| Direction change detected | `pivot` — "방향을 전환해줘" |
|
|
207
207
|
|
|
208
208
|
Example 🧭 block for starting a story:
|