@walwal-harness/cli 2.3.2 → 2.4.0

package/assets/templates/memory.md

@@ -0,0 +1,6 @@
+# Harness Memory — 공유 학습 기록
+
+> Dispatcher가 관리. **모든 에이전트**는 세션 시작 시 이 파일을 읽고 학습된 규칙을 따릅니다.
+> gotchas(에이전트별 실수 기록)와 달리, 이 파일은 **프로젝트 전체에 적용되는 구조적 교훈**을 담습니다.
+
+<!-- 항목이 추가되면 아래에 기록됩니다 -->

package/bin/init.js

@@ -141,6 +141,13 @@ function scaffoldHarness() {
     copyFile(harnessMdSrc, harnessMdDest);
   }
 
+  // Copy memory.md (shared learnings)
+  const memorySrc = path.join(PKG_ROOT, 'assets', 'templates', 'memory.md');
+  const memoryDest = path.join(HARNESS_DIR, 'memory.md');
+  if (fs.existsSync(memorySrc) && (!fileExists(memoryDest) || isForce)) {
+    copyFile(memorySrc, memoryDest);
+  }
+
   // Create progress.log
   const progressLog = path.join(HARNESS_DIR, 'progress.log');
   if (!fileExists(progressLog) || isForce) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walwal-harness/cli",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "Production harness for AI agent engineering — Planner, Generator(BE/FE), Evaluator(Func/Visual), optional Brainstormer (requirements refinement). Supports React and Flutter FE stacks.",
   "bin": {
     "walwal-harness": "bin/init.js"

package/skills/brainstorming/SKILL.md

@@ -37,7 +37,8 @@ Planner 가 곧바로 plan.md / feature-list.json / api-contract.json 으로 변
 1. `.harness/progress.json` 읽기 — `next_agent == "brainstormer"` 인지 확인
    - 아니면 즉시 STOP + "Dispatcher 를 먼저 실행하세요" 안내
 2. progress.json 업데이트: `current_agent` → `"brainstormer"`, `agent_status` → `"running"`, `updated_at` 갱신
-3. **Skip 조건 검사**: `.harness/actions/brainstorm-spec.md` 가 이미 존재하고
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. **Skip 조건 검사**: `.harness/actions/brainstorm-spec.md` 가 이미 존재하고
    사용자가 "새로 브레인스토밍" 을 명시하지 않았다면:
    - 사용자에게 "기존 brainstorm-spec.md 가 있습니다. 재사용(Y) / 새로 작성(N)?" 질문
    - Y → 즉시 On Complete 로 이동 (interactive 단계 전부 스킵)

package/skills/dispatcher/SKILL.md

@@ -11,6 +11,7 @@ disable-model-invocation: false
 ### On Start
 1. `.harness/progress.json` 읽기 — `next_agent`가 `"dispatcher"`인지 확인
 2. progress.json 업데이트: `current_agent` → `"dispatcher"`, `agent_status` → `"running"`, `updated_at` 갱신
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
 
 ### On Complete
 1. progress.json 업데이트:
@@ -50,7 +51,16 @@ Claude 는 기본적으로 Dispatcher 경유로 분류/라우팅해야 한다.
 - **혼합** → Gotcha 먼저 기록 → Pipeline 이어서
 - **메타/인사/Claude 자체 질문** → Dispatcher skip, 짧은 일반 응답 허용
 
-## 2. Gotcha Flow
+## 2. Gotcha Flow vs Memory Flow
+
+사용자의 교정/피드백을 받으면 **먼저 분류**:
+
+| 유형 | 저장 위치 | 예시 |
+|------|----------|------|
+| **에이전트별 실수** (일회성 교정) | `.harness/gotchas/[agent].md` | "API 응답에 created_at은 ISO 8601로" |
+| **프로젝트 공유 규칙** (구조적/반복적) | `.harness/memory.md` | "Playwright 스크린샷은 단계 완료 후 항상 삭제" |
+
+### Gotcha Flow (에이전트별 실수)
 
 실수 지적 감지 시 → [Gotcha 상세 가이드](references/gotcha-flow.md)
 
@@ -60,6 +70,14 @@ Claude 는 기본적으로 Dispatcher 경유로 분류/라우팅해야 한다.
 3. `.harness/gotchas/[agent].md`에 항목 추가 (중복 시 Occurrences 증가)
 4. 사용자에게 기록 확인
 
+### Memory Flow (프로젝트 공유 규칙)
+
+구조적/반복적 교훈 감지 시:
+1. 이것이 특정 에이전트의 일회성 실수가 아니라 **전체 에이전트가 따라야 할 규칙**인지 판단
+2. **맞으면**: `.harness/memory.md`에 항목 추가 (ID: `[M-NNN]`, 날짜, 규칙, 적용 범위)
+3. 관련 스킬의 SKILL.md에 구조적 변경이 필요하면 → 사용자에게 "이건 스킬 자체에 반영해야 합니다" 안내 (Dispatcher가 직접 SKILL.md를 수정하지는 않음)
+4. 사용자에게 기록 확인
+
 ## 3. Initialization Check (Phase 0)
 
 파이프라인 선택 전 초기화 상태 확인:

package/skills/evaluator-functional/SKILL.md

@@ -54,7 +54,8 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기 — IA-MAP
 2. `.harness/gotchas/evaluator-functional.md` 읽기 — **과거 실수 반복 금지**
-3. `actions/sprint-contract.md` — BE + FE 성공 기준 전체
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `actions/sprint-contract.md` — BE + FE 성공 기준 전체
 4. `actions/feature-list.json` — 이번 스프린트 범위
 5. `actions/api-contract.json` — 기대 API 동작
 6. `.harness/progress.json`

package/skills/evaluator-functional-flutter/SKILL.md

@@ -53,11 +53,12 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기 — IA-MAP (Flutter 경로 확인)
 2. `.harness/gotchas/evaluator-functional-flutter.md` (없으면 skip) — **과거 실수 반복 금지**
-3. `actions/sprint-contract.md` — FE 성공 기준
-4. `actions/feature-list.json` — 이번 스프린트 범위 (`layer: "frontend"` + `fe_stack: "flutter"`)
-5. `actions/api-contract.json` — 기대 API 계약 (Retrofit 매핑 대조용)
-6. `.harness/progress.json`
-7. **Generator의 anti-patterns.md 로드** — 정적 검증 rule 소스
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `actions/sprint-contract.md` — FE 성공 기준
+5. `actions/feature-list.json` — 이번 스프린트 범위 (`layer: "frontend"` + `fe_stack: "flutter"`)
+6. `actions/api-contract.json` — 기대 API 계약 (Retrofit 매핑 대조용)
+7. `.harness/progress.json`
+8. **Generator의 anti-patterns.md 로드** — 정적 검증 rule 소스
    → `skills/generator-frontend-flutter/references/anti-patterns.md`
 
 ## Evaluation Steps

package/skills/evaluator-visual/SKILL.md

@@ -47,8 +47,9 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기
 2. `.harness/gotchas/evaluator-visual.md` 읽기 — **과거 실수 반복 금지**
-3. `actions/evaluation-functional.md` — Verdict: PASS 확인
-4. Frontend `http://localhost:5173` 실행 확인
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `actions/evaluation-functional.md` — Verdict: PASS 확인
+5. Frontend `http://localhost:5173` 실행 확인
 
 ## Evaluation Steps
 

package/skills/generator-backend/SKILL.md

@@ -28,11 +28,12 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
 2. `.harness/gotchas/generator-backend.md` 읽기 — **과거 실수 반복 금지**
-3. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-4. `.harness/actions/api-contract.json` 읽기 — **이것이 스펙**
-5. `.harness/actions/feature-list.json` — `layer: "backend"` 필터
-6. 통합 러너: `npm run dev`
-7. Gateway 헬스체크: `curl http://localhost:3000/health`
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `pwd` + `.harness/progress.json` + `git log --oneline -20`
+5. `.harness/actions/api-contract.json` 읽기 — **이것이 스펙**
+6. `.harness/actions/feature-list.json` — `layer: "backend"` 필터
+7. 통합 러너: `npm run dev`
+8. Gateway 헬스체크: `curl http://localhost:3000/health`
 
 ## AGENTS.md — 읽기 전용
 

package/skills/generator-frontend/SKILL.md

@@ -28,11 +28,12 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인
 2. `.harness/gotchas/generator-frontend.md` 읽기 — **과거 실수 반복 금지**
-3. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-4. `.harness/actions/api-contract.json` 읽기 — **Gateway가 유일한 API 인터페이스**
-5. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
-6. Gateway 확인: `curl -s http://localhost:3000/health`
-7. Frontend 시작: `cd apps/web && npm run dev`
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `pwd` + `.harness/progress.json` + `git log --oneline -20`
+5. `.harness/actions/api-contract.json` 읽기 — **Gateway가 유일한 API 인터페이스**
+6. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
+7. Gateway 확인: `curl -s http://localhost:3000/health`
+8. Frontend 시작: `cd apps/web && npm run dev`
 
 ## AGENTS.md — 읽기 전용
 

package/skills/generator-frontend-flutter/SKILL.md

@@ -29,10 +29,11 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기 — IA-MAP, 권한 확인 (Flutter 소유 경로)
 2. `.harness/gotchas/generator-frontend-flutter.md` 읽기 (없으면 skip) — **과거 실수 반복 금지**
-3. `pwd` + `.harness/progress.json` + `git log --oneline -20`
-4. `.harness/actions/api-contract.json` 읽기 — **서버 API 계약이 Source of Truth**
-5. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
-6. `pubspec.yaml` 확인 — Flutter 버전, Riverpod/Retrofit/json_serializable 의존성 존재 확인
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `pwd` + `.harness/progress.json` + `git log --oneline -20`
+5. `.harness/actions/api-contract.json` 읽기 — **서버 API 계약이 Source of Truth**
+6. `.harness/actions/feature-list.json` — `layer: "frontend"` 필터
+7. `pubspec.yaml` 확인 — Flutter 버전, Riverpod/Retrofit/json_serializable 의존성 존재 확인
 
 ## AGENTS.md — 읽기 전용
 

package/skills/planner/SKILL.md

@@ -25,16 +25,17 @@ disable-model-invocation: true
 
 1. `AGENTS.md` 읽기
 2. `.harness/gotchas/planner.md` 읽기 — **과거 실수 반복 금지**
-3. `.harness/progress.json` 읽기
-4. `.harness/actions/pipeline.json` 읽기 — `planner_mode`, `fe_stack` 확인
-5. `.harness/actions/scan-result.json` 읽기 — `tech_stack.fe_stack` 확인 (없으면 `react` 기본)
-6. **Brainstorm Spec 우선 로드** — `.harness/actions/brainstorm-spec.md` 가 존재하면
+3. `.harness/memory.md` 읽기 — **프로젝트 공유 학습 규칙 적용**
+4. `.harness/progress.json` 읽기
+5. `.harness/actions/pipeline.json` 읽기 — `planner_mode`, `fe_stack` 확인
+6. `.harness/actions/scan-result.json` 읽기 — `tech_stack.fe_stack` 확인 (없으면 `react` 기본)
+7. **Brainstorm Spec 우선 로드** — `.harness/actions/brainstorm-spec.md` 가 존재하면
    **이 파일이 PRD 대체 입력**. Brainstormer 가 이미 사용자와 대화하여 확정한
    결과이므로 **승인된 결정을 뒤엎지 않는다**. 없으면 사용자의 원본 요청 텍스트를 입력으로 사용.
    - brainstorm-spec.md 에 `## Open Questions` 섹션이 있으면 Planner 가 해소 (API 계약으로 확정)
    - brainstorm-spec.md 의 `## 7. 주요 컴포넌트 / 엔티티` → `feature-list.json` 초기 feature 목록 시드
    - brainstorm-spec.md 의 `## 5. 선택된 접근법` / `## 6. 아키텍처 스케치` → MSA 서비스 분할 베이스
-7. **FE Stack 확정** → [FE Stack 결정 가이드](references/fe-stack-detection.md)
+8. **FE Stack 확정** → [FE Stack 결정 가이드](references/fe-stack-detection.md)
    - `pubspec.yaml` + `flutter:` 키 → `fe_stack = "flutter"`
    - 혼재/불명확 → 사용자에게 단 한 번 질문
    - 확정 후 `pipeline.json.fe_stack` 갱신 (없으면 생성)