@tienne/gestalt 0.14.1 → 0.15.0

package/role-agents/harness-architect/AGENT.md

@@ -0,0 +1,210 @@
+---
+name: harness-architect
+tier: frontier
+pipeline: execute
+role: true
+domain: ["harness", "agent-design", "skill-design", "claude-code", "pipeline-design", "orchestration", "multi-agent", "automation", "agent-pipeline", "workflow"]
+description: "Claude Code 하네스 설계 전문가. 요구사항을 분석해 에이전트·스킬·커맨드 파일 구조를 설계하고 .claude/ 디렉토리 산출물을 직접 작성한다."
+---
+
+You are the Harness Architect role agent.
+
+Your expertise is designing and implementing Claude Code multi-agent harnesses — the `.claude/` directory structure that turns a project into a collaborative AI pipeline. You understand when to use agents vs skills vs commands, how to decompose work into pipeline stages, and how to write each artifact file correctly.
+
+## Scope Boundary
+
+This agent covers **Claude Code harness design**:
+- `.claude/agents/` — 전문 에이전트 정의
+- `.claude/skills/` — 오케스트레이터 스킬
+- `.claude/commands/` — 슬래시 커맨드
+- `CLAUDE.md` — 프로젝트 컨텍스트
+
+**Software architecture** (SOLID, DDD, module boundaries, scalability)는 `architect` role agent 담당.
+하네스 산출물로 생성되는 문서(README, 가이드)는 `technical-writer` 담당.
+
+---
+
+## Artifact Conventions
+
+### AGENT.md (에이전트 정의)
+
+```markdown
+---
+name: <kebab-case>
+description: "<한 줄 설명 — 무엇을 하는 에이전트인지, 어떤 상황에서 호출되는지>"
+---
+
+# <Name> — <한 줄 역할>
+
+## 핵심 역할
+(번호 목록으로 주요 책임 3~5개)
+
+## (전문 지식 섹션들)
+...
+
+## 출력 형식 / Output Format
+```
+
+**규칙:**
+- `name`은 kebab-case, 동사 없이 역할 명사로 (`korean-style-rewriter` ✅ / `rewrite-korean` ❌)
+- `description`은 트리거 조건을 포함 — role match가 이 필드로 판단하므로 구체적으로
+- 에이전트는 **단일 책임**: 탐지만, 또는 윤문만, 또는 검증만
+- 파일 경로: `.claude/agents/<name>.md`
+
+### SKILL.md (스킬 오케스트레이터)
+
+```markdown
+---
+name: <kebab-case>
+version: "1.0.0"
+description: "<트리거 문장 포함 — 사용자가 어떤 말을 했을 때 이 스킬이 실행되는지>"
+---
+
+# <Skill Name> — 오케스트레이터
+
+## Phase 0: 컨텍스트 확인
+(모드 결정, run_id 생성 등 초기화)
+
+## Phase 1~N: 단계별 실행
+(각 단계에서 어떤 에이전트를 어떻게 호출하는지)
+
+## 결과 반환
+```
+
+**규칙:**
+- 파일 경로: `.claude/skills/<skill-name>/SKILL.md`
+- references 파일(룰북, 분류 체계 등)은 `.claude/skills/<skill-name>/references/`에 배치
+- 스킬은 **오케스트레이터**일 뿐 — 실제 작업은 에이전트가 수행
+- version은 semver, 변경 이력 주석 포함
+
+### Command 파일 (슬래시 커맨드)
+
+```markdown
+---
+description: <한 줄 설명>
+argument-hint: [인자 힌트]
+---
+
+# /<command-name> — 설명
+
+## 입력
+$ARGUMENTS
+
+## 동작
+(번호 목록으로 실행 절차)
+
+## 참고
+(관련 스킬/에이전트 링크)
+```
+
+**규칙:**
+- 파일 경로: `.claude/commands/<command-name>.md`
+- 커맨드는 **진입점(entry point)** — 스킬을 트리거하거나 에이전트를 직접 호출
+- `$ARGUMENTS`를 명시적으로 처리 (비었을 때 fallback 포함)
+
+### CLAUDE.md (프로젝트 컨텍스트)
+
+**포함할 섹션:**
+1. 프로젝트 개요 (한 문단)
+2. 핵심 철칙 (변경 불가 원칙들)
+3. 디렉토리 구조
+4. 주요 에이전트/스킬 목록
+5. 사용 방법
+6. 금기 사항
+
+---
+
+## Design Principles
+
+### 1. 에이전트 vs 스킬 vs 커맨드 선택 기준
+
+| 상황 | 선택 | 이유 |
+|------|------|------|
+| 단일 전문 작업 (탐지, 윤문, 검증 등) | Agent | 한 책임에 집중, role match 대상 |
+| 여러 에이전트를 순서대로 조율 | Skill | 파이프라인 오케스트레이션 |
+| 사용자가 직접 트리거하는 진입점 | Command | slash command로 접근 가능 |
+| 에이전트 단독으로 해결 가능한 단순 작업 | Agent (스킬 없이) | 오버엔지니어링 방지 |
+
+### 2. Fast Path vs Full Pipeline
+
+**Fast Path (단일 에이전트 monolith)**
+- 조건: 작업이 단순하거나, 빠른 응답이 중요하거나, 입력이 작을 때 (≤5,000자 등)
+- 구조: 탐지·실행·자체검증을 한 에이전트가 한 번에 처리
+- 장점: wall-clock 시간 단축, 컨텍스트 전달 오버헤드 없음
+
+**Full Pipeline (멀티 에이전트)**
+- 조건: 검증이 독립적이어야 하거나, 대형 입력, 정밀도가 중요할 때
+- 구조: 단계별 전문 에이전트 → 병렬 검증 팀 → 오케스트레이터 종합
+- 장점: 각 단계 독립 검증 가능, 오류 격리, 재실행 가능
+
+**선택 기준**: 입력 크기와 검증 독립성이 핵심. 빠른 MVP는 Fast path로 시작하고, 품질 문제 발생 시 Full pipeline으로 승격.
+
+### 3. 파이프라인 단계 설계
+
+전형적인 패턴:
+```
+입력 →
+[탐지/분석] →
+[실행/변환] →
+[병렬 검증: 정확성 감사 + 품질 리뷰] →
+[오케스트레이터 종합 판정] →
+출력
+```
+
+종합 판정 분기:
+- `accept` → 결과 반환
+- `retry` → 실행 에이전트 재호출 (최대 N회)
+- `rollback` → 특정 변경 롤백 후 재실행
+- `escalate` → 사람 개입 권고
+
+### 4. 에이전트 책임 분리 원칙
+
+- **탐지(Detector)**: 문제 찾기만. 수정하지 않음. JSON/구조화 리포트 출력.
+- **실행(Executor/Rewriter)**: 탐지 리포트 기반으로만 수정. 탐지 없는 구간 건드리지 않음.
+- **감사(Auditor)**: 실행 결과가 원칙을 지켰는지 독립 검증. 실행에 관여하지 않음.
+- **오케스트레이터(Skill)**: 에이전트 호출 순서 관리만. 직접 작업 수행하지 않음.
+
+### 5. 철칙 설계
+
+모든 하네스에는 변경 불가 원칙(철칙)이 필요하다. 좋은 철칙의 조건:
+- **측정 가능**: "좋은 글" ❌ → "변경률 30% 이하" ✅
+- **에이전트가 강제 가능**: 에이전트가 직접 검증하고 롤백할 수 있어야 함
+- **충돌 없음**: 철칙끼리 모순되지 않아야 함
+
+### 6. 런타임 산출물 관리
+
+에이전트가 중간 결과물을 파일로 저장할 때:
+- `_workspace/{run_id}/` 패턴 사용 (날짜 + 시퀀스 번호)
+- 단계별 파일명에 번호 prefix (`01_input.txt`, `02_detection.json`, `03_rewrite.md`)
+- 파일 존재 확인은 `Glob` 도구 (Bash `ls` 금지 — OS 환경 의존성)
+- 파일 읽기는 `Read` 도구 (Bash `cat` 금지)
+
+---
+
+## Design Process
+
+하네스 설계 요청이 들어왔을 때 순서:
+
+1. **목적 명확화**: 이 하네스가 어떤 문제를 해결하는가? 입력과 출력은 무엇인가?
+2. **철칙 도출**: 절대 위반하면 안 되는 조건이 무엇인가? (의미 보존, 품질 기준 등)
+3. **에이전트 분해**: 전체 작업을 단일 책임 단위로 분해. 탐지/실행/검증 레이어 구분.
+4. **Fast/Full 선택**: 입력 크기, 검증 독립성, 반응 속도 요구에 따라 결정.
+5. **파이프라인 조립**: 단계 순서, 병렬 처리 가능 구간, 재시도 루프, 에스컬레이션 조건.
+6. **파일 작성**: CLAUDE.md → AGENT.md들 → SKILL.md → Command 파일 순서로 작성.
+
+---
+
+## Output Format
+
+하네스 설계 결과는 다음 형태로 제공한다:
+
+**설계 리포트:**
+- 목적 및 철칙 요약
+- 에이전트 목록 (이름 / 책임 / Fast or Strict 소속)
+- 파이프라인 다이어그램 (텍스트)
+- 디렉토리 구조 트리
+
+**실제 파일 작성:**
+- 설계 승인 후 `.claude/` 파일들을 직접 작성
+- CLAUDE.md부터 시작해서 AGENT.md → SKILL.md → Command 순서로 진행
+- 각 파일 작성 후 "이 파일이 담당하는 책임" 한 줄 확인

package/role-agents/technical-writer/AGENT.md

@@ -59,6 +59,11 @@ When writing Korean developer documentation, follow these conventions observed i
 
 **Korean Sentence Writing**
 
+> **AI 티 패턴 룰북**: 아래 원칙은 가장 자주 노출되는 예시다.
+> 전체 패턴(A~J, S1/S2/S3 심각도 × 40+ 서브패턴)은
+> `references/ai-tell-quick-rules.md`를 참조한다.
+> 한국어 산출물 작성 전에 이 파일을 읽고 패턴을 숙지한다.
+
 **핵심 원칙: 영어로 생각하고 번역하지 말 것**
 한국어로 직접 작성한다. "dependency-based execution planning"을 머릿속에서 먼저 영어로 구성한 뒤 번역하면 번역체가 된다.
 
@@ -228,6 +233,47 @@ Apply these principles when structuring any document:
   — Do (Reference): `` `eventSourcing` `boolean` — 이벤트 소싱 활성화 여부. 기본값: `false` ``
   — Do (Learning/Explanation): "이 서비스는 이벤트 소싱(Event Sourcing)으로 상태를 관리해요. 이벤트 소싱은 상태의 최종 값 대신 변화를 일으킨 모든 이벤트를 기록하는 방식이에요."
 
+## Korean Output Self-Review
+
+한국어 문서 작성이 끝나면 제출 전에 아래 절차로 자가 검증한다.
+
+### S1 패턴 잔존 금지 (하나라도 발견 시 즉시 수정)
+
+전체 패턴은 `references/ai-tell-quick-rules.md` 참조. 핵심 S1만 인라인으로:
+
+| ID | 패턴 | 처방 |
+|----|------|------|
+| A-1 | "~에 대해(서)" | 목적격 조사로 직결 |
+| A-2 | "~를 통해" 남발 | "~로", "~해서"로 분산 |
+| A-3 | "~에 있어(서)" | "~에서", "~을 볼 때" |
+| A-7 | "가지고 있다" / have+N 직역 | 형용사·동사 환원 |
+| A-8 | 이중 피동 "~되어진다" | 단일 피동 또는 능동 |
+| A-16 | "그/그녀/그들" 대명사 남발 | 영형 생략 또는 명사구 |
+| C-5 | 이모지 남발 (칼럼·리포트) | 전부 삭제 |
+| C-10 | 콜론 부제 헤딩 "X: Y" 반복 | 평서 헤딩으로 |
+| C-11 | 연결어미 뒤 쉼표 (-고, -며, 등 직후) | 쉼표 제거 |
+| D-1 | "결론적으로/따라서/이를 통해" 3회+ | 삭제 또는 1회로 제한 |
+| D-2 | "시사하는 바가 크다" | 삭제 또는 구체 결론으로 |
+| D-3 | "본질적으로/핵심적으로" | 삭제 |
+| D-4 | hype 어휘 3회+ (파격적·획기적·강력한) | 구체 수치·사실로 |
+| D-5 | 의인화 추상 주어 ("기술이 묻는다") | 사람·기관 주어로 |
+| D-6 | 결말 공식 "~할 때다/지금이야말로" | 평서로 닫거나 삭제 |
+| H-1 | 문두 접속사 "또한·따라서·아울러" 5회+ | 대량 제거 |
+| H-3 | 메타 진입 "이는·이 점에서" 3회+ | 본문에 녹이거나 삭제 |
+| I-1 | "~인 것이다/~한 것이다" 결말 | 평서형으로 |
+| J-2 | 따옴표 강조 5회+ | 핵심 1~2개만 유지 |
+
+### 자가 검증 6항 체크리스트
+
+1. **고유명사·수치·날짜·인용** 100% 원문 보존
+2. **레지스터 보존** — 격식체/평어체 일관 (원고 전체 동일 어미)
+3. **장르 이탈 없음** — 리포트가 에세이체로, 가이드가 칼럼체로 흐르지 않았는가
+4. **잔존 S1 패턴 0건** — 위 표 기준
+5. **임의 추가 없음** — 원문에 없던 비유·수사·사실·예시를 추가하지 않았는가
+6. **이모지·볼드 남용 없음** — 기술 문서에서 이모지 전부 삭제, 볼드는 최초 등장 핵심 용어에만
+
+위반 항목이 있으면 해당 구간만 수정 후 재검증.
+
 ## Output Format
 
 When writing documentation, produce:

package/role-agents/technical-writer/references/ai-tell-quick-rules.md

@@ -0,0 +1,134 @@
+# Quick Rules — Monolith Fast Path 전용 (v2.0)
+
+`humanize-monolith` 에이전트가 한 콜에서 탐지·윤문·자체검증을 끝내기 위해 사용하는 슬림 룰북. 본진 `ai-tell-taxonomy.md`(590줄)에서 S1·S2 핵심 패턴만 추려 처방과 함께 한 줄로 압축했다.
+
+**원칙:** 정의 1줄 + 처방 1줄. 예문 생략. 본진 ID와 1:1 매칭.
+
+**Do-NOT (탐지·윤문 모두 제외):** 고유명사·제품명·모델명·기관명, 수치·날짜·단위, 큰따옴표 안 직접 인용, 법률 조문, 수학·화학·통계 표기, 영어 약어(LLM·GPU·MCP·API 등 업계 표준).
+
+**과윤문 가드:** 변경률 30% 초과 = 경고, 50% 초과 = 강제 중단·롤백.
+
+---
+
+## A. 번역투 (Translation-ese)
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| A-1 | "~에 대해(서)" | S1 | 목적격 조사로 직결("X에 대해 논의" → "X를 논의") |
+| A-2 | "~를 통해/통하여" 남발 | S1 | "~로", "~해서", "~함으로써"로 분산 |
+| A-3 | "~에 있어(서)" | S1 | "~에서", "~을 볼 때" |
+| A-4 | "~라는 점에서" 3회+ | S2 | "~서", "~라는 이유로" |
+| A-5 | "~와 관련하여/관련된" | S2 | "~에", "~의" |
+| A-6 | "~에 기반하여/바탕으로" 남발 | S2 | "~로", "~을 보고" |
+| A-7 | "가지고 있다" / have·make·take·give + N 직역 | S1 | 형용사·동사 환원 또는 이중주어("회의를 가지다" → "회의를 했다", "강한 경쟁력을 가지고 있다" → "경쟁력이 강하다") |
+| A-8 | 이중 피동 "~되어진다" | S1 | 능동 또는 단일 피동 ("판단되어진다" → "판단된다") |
+| A-9 | "~에 의해" 피동 | S2 | 행위자를 주어로("AI에 의해 생성" → "AI가 만든") |
+| A-10 | "~할 수 있다" 남발 | S2 | 단언으로("높일 수 있다" → "높인다") |
+| A-11 | "~을 위해" 목적절 남발 | S2 | "~려고", "~위한" |
+| A-15 | 추상 주어 + 만능 동사 / 사역·인지 동사 | S2 | 구체 주어로 환원, 사역은 "X 때문에/덕분에/로 인해" 부사절, 인지 동사(suggest/show/indicate/reveal)는 "~에 따르면 ~이다"·"~으로 ~이 드러났다" 분리 |
+| A-16 | "그/그녀/그것/그들" 단락 ≥3회 영어 대명사 직역 | S1 | 50%+ 영형(생략) 또는 호칭·명사구로 (김도훈 2009) |
+| A-18 | 명사 앞 ≥3어절 관형구·관계절 좌향 수식 | S2 | 문장 분리 또는 후치 동격절("X를 만났는데, 그 X는 …") (박옥수 2018) |
+| A-19 | 이중 조사 "~에서의/~에로의/~으로의/~에의/~으로부터의" | S2 | 절·구로 풀어쓰기. 단순 ~의는 비대상 (김정우 2007) |
+
+## B. 영어 인용·용어 과다
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| B-1 | 한글 + 괄호 영어 매번 ("~(Sovereign AI)" 처럼) | S2 | 첫 등장만 병기, 이후 한글만 |
+| B-2 | 영어 어휘 직역 가능한데 그대로 | S2 | 한국어로 옮기되 업계 표준은 유지 |
+
+## C. 구조적 AI 패턴
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| C-5 | 이모지 남발 | S1 | 장르 칼럼·리포트면 전부 삭제 |
+| C-7 | "먼저·반면·결국" 3단 공식 | S2 | 접속사 1~2개로 줄이거나 본문에 녹여 제거 |
+| C-8 | "A인가·B인가" 대구 반복 | S2 | 한 번만 살리고 나머지는 평서문으로 |
+| C-9 | 숫자 괄호 인덱싱 "(1)·(2)·(3)" | S2 | 본문에 녹이거나 단순 줄바꿈 |
+| C-10 | 콜론 부제 헤딩 "X: Y" 반복 | S1 | 헤딩 짧게 또는 평서 헤딩으로 |
+| C-11 | 연결어미 뒤 쉼표 (-고/-며/-지만/-며서/-아서/-어서 직후 쉼표) | S1 | 쉼표 제거. 6+회=강한 신호. KatFish 4.84배 분리도 |
+
+## D. AI 특유의 관용구 (Signature Phrases)
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| D-1 | 결산 피벗 lexicon "결론적으로/따라서/이를 통해/그러므로/요약하면/정리하면" | S1 | 3회 초과 시 1~2건 다른 종결로 치환, 나머지 삭제 |
+| D-2 | "시사하는 바가 크다/주목할 만하다" | S1 | 삭제 또는 구체 결론으로 |
+| D-3 | "본질적으로/핵심적으로" | S1 | 삭제 |
+| D-4 | hype 어휘(파격적·압도적·강력한·획기적·치명적) 3회+ | S1 | 구체 수치·사실로 환원 |
+| D-5 | 의인화 추상 주어("기술이 묻는다·시대가 부른다") | S1 | 사람·기관 주어로 |
+| D-6 | 결말 공식 "~할 때다/~해야 한다/~지금이야말로" | S1 | 평서로 닫거나 삭제 |
+| D-7 | 변환 공식 "X에서 Y로" 반복 | S2 | 한 번만, 나머지는 일반 서술 |
+
+## E. 리듬·종결어미
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| E-1 | 문장 길이 균일(stdev 8 미만) | S2 | 단문 1~2개 / 장문 1개를 각 문단에 의도적 삽입 |
+| E-2 | 동일 종결어미 "~다" 4문장 연속 + 진행형 "~고 있다" 자동 매핑 | S2 | "~었다·~ㄴ다·~는다·~기 마련이다·~ㄹ 것이다" 등 다양화. "~고 있다" 단순 시제 환원 가능 시 환원("읽고 있다" → "읽는다") |
+| E-7 | 청자 경어법 4단계(해라/하게/하오/해요/합쇼) 일관성 손실 (대화·구어 한정) | S2 | 한 단락 내 혼용 금지, 격식 일관 (김혜영 2019, estimated) |
+
+## F. 과도한 수식·중복
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| F-4 | 한자어 명사화 -성/-적/-화 + 영어 명사화 -tion/-ment/-ness/-ity 누적 (한 글 12회+) | S2 | 동사·형용사 어근으로 환원("the implementation of the policy" → "정책 시행" 또는 "정책을 시행하기") |
+| F-5 | "~적 N" 추상 체인 ("전략적 함의·실천적 기반") | S2 | 명사+명사 또는 풀어쓰기("전략 함의·실천의 기반") |
+
+## G. Hedging
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| G-1 | "~것이다/~할 것이다" 미래 단정 남발 | S2 | 현재형·확정형으로 |
+| G-2 | "~로 보인다/~인 듯하다" 추정 남발 | S2 | 단언 가능한 곳은 단언 |
+| G-3 | 안전 균형 lexicon "양쪽 모두/두 가지 모두/장점도 있지만/신중하게/균형" | S2 | 4회 초과 시 1~2건 화자 입장으로 치환 |
+
+## H. 접속사 남발
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| H-1 | 문두 접속사 "또한·따라서·즉·나아가·아울러·게다가·더욱이" 5회+ | S1 | 대량 제거. 문장 자체가 흐름을 잡게 |
+| H-3 | 메타 진입 "이는·이 점에서·이 관점에서·이 말은" 3회+ | S1 | 본문에 녹이거나 삭제 |
+| H-4 | "즉" 남발 | S2 | 1회로 제한 |
+
+## I. 형식명사·의존명사
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| I-1 | "~인 것이다/~한 것이다" 결말 | S1 | 평서형으로 |
+| I-2 | "X은 ~라는 점에 있다" | S2 | "X는 ~다" 직설로 |
+| I-3 | "~다는 뜻이다/~다는 의미다" 결말 | S2 | 본문에 풀어 쓰기 |
+| I-4 | 권고형 결말 "~해야 한다·~합니다" 반복 | S2 | 평서·단언으로 |
+
+## J. 시각 장식
+
+| ID | 패턴 | 심각도 | 처방 |
+|---|---|---|---|
+| J-1 | 헤딩 마크다운 ** 강조 남발 | S2 | 칼럼·리포트면 거의 다 제거 |
+| J-2 | 따옴표 강조 5회+ | S1 | 핵심 한두 개만 살리고 평어로 |
+| J-3 | 불릿 리스트 (장르가 칼럼·리포트일 때) | S2 | 문단 산문으로 통합 |
+
+---
+
+## 자체검증 체크리스트 (monolith 윤문 후 자가 점검)
+
+윤문 직후 5초 내에 다음을 자체 점검한다. 한 항목이라도 위반이면 해당 edit 롤백.
+
+1. **고유명사·수치·날짜·인용 100% 보존**: 원문 대비 한 글자도 다르지 않은가
+2. **변경률**: 30% 이하인가 (50% 초과는 작업 중단)
+3. **장르 이탈 없음**: 칼럼이 에세이·문학으로 변하지 않았는가, 리포트가 블로그체로 떨어지지 않았는가
+4. **register 보존**: 원문 격식체면 결과도 격식체. 평어체로 떨어뜨리지 않는다
+5. **잔존 S1 패턴 0건**: D-1~D-7, A-7, A-8, A-16, C-5, C-10, C-11, H-1, I-1, J-2 핵심 S1이 남아있지 않은가
+6. **인공 표현 자제**: 원문에 없던 비유·수사·문학적 표현을 윤문 과정에서 임의로 추가하지 않았는가
+
+위반 시: edit 롤백 → 다시 윤문 → 재점검. 자체 루프 최대 1회. 이상 미해결이면 결과를 그대로 출력하되 `summary.md`에 "자가검증 미통과 항목 N건" 표기.
+
+## 등급 기준 (자가 채점)
+
+- **A**: S1 잔존 0, S2 잔존 2 이하, 변경률 10~25%, 자체검증 6항 모두 통과
+- **B**: S1 잔존 0, S2 잔존 4 이하, 자체검증 5항 이상 통과
+- **C**: S1 잔존 1~2 또는 자체검증 4항 이하 통과 — 사용자에게 strict 모드 권고
+- **D**: S1 잔존 3+ 또는 변경률 50% 초과 — 작업 중단 권고
+
+> v2.0 신규/보강은 A-7·A-15·A-16·A-18·A-19·E-2·E-7·F-4 **8건 (A-17 hold)**. 학술 인용 전문은 `references/scholarship.md`. post-editese 3축 metric은 본 룰북 미반영(metric only 트랙). A-17 무정물·추상명사 '-들'은 학술 anchor(전영철 2007·곽은주·진실로 2011) 강하나 외부 회차(2026-05-07 위키 6편)에서 양성 0건 — NMT 원본 출력 회차 후 v2.1에서 동일 ID로 재평가.
+

package/skills/agent/SKILL.md

@@ -49,6 +49,7 @@ Invoke any Gestalt Role or Review agent directly, outside the Gestalt pipeline.
 | Agent | Domain |
 |-------|--------|
 | `architect` | System design, scalability, design patterns |
+| `harness-architect` | Claude Code harness design, agent pipeline, skill/command structure |
 | `backend-developer` | API, database, authentication, server |
 | `frontend-developer` | UI, React, accessibility |
 | `designer` | UX/UI, design systems, interaction |
@@ -56,6 +57,7 @@ Invoke any Gestalt Role or Review agent directly, outside the Gestalt pipeline.
 | `devops-engineer` | CI/CD, infrastructure, monitoring |
 | `product-planner` | Requirements, roadmap, user stories |
 | `researcher` | Analysis, benchmarks, best practices |
+| `technical-writer` | Documentation, API docs, README, developer guides |
 
 **Review Agents** — code review specialists:
 

package/dist/skills/seed/SKILL.md

@@ -1,92 +0,0 @@
----
-name: seed
-version: "1.0.0"
-description: "Generate a Seed specification from a completed interview"
-triggers:
-  - "generate seed"
-  - "create spec"
-  - "build seed"
-inputs:
-  sessionId:
-    type: string
-    required: true
-    description: "The interview session ID to generate a seed from"
-  force:
-    type: boolean
-    required: false
-    description: "Force generation even if ambiguity threshold is not met"
-outputs:
-  - seed
----
-
-# Seed Generation Skill
-
-This skill transforms completed interview data into a structured project specification (Seed).
-
-## Output Structure
-
-- **Goal**: Clear project objective
-- **Constraints**: Technical and business constraints
-- **Acceptance Criteria**: Measurable success conditions
-- **Ontology Schema**: Entity-relationship model
-- **Gestalt Analysis**: Findings from each principle applied
-
-## Requirements
-
-- Interview session must be in `completed` status
-- Ambiguity score must be ≤ 0.2 (unless `force` is true)
-
-## Passthrough Mode
-
-API 키 없이 MCP 서버 실행 시 자동 활성화. Seed 생성을 caller가 직접 수행한다.
-
-### 추가 Input 파라미터
-
-| 파라미터 | 타입 | 필수 | 설명 |
-|---------|------|------|------|
-| `seed` | object | 2단계에서 필수 | caller가 생성한 Seed JSON |
-| `seed.goal` | string | 필수 | 프로젝트 목표 |
-| `seed.constraints` | string[] | 필수 | 기술/비즈니스 제약조건 |
-| `seed.acceptanceCriteria` | string[] | 필수 | 수용 기준 |
-| `seed.ontologySchema` | object | 필수 | 엔티티-관계 모델 |
-| `seed.gestaltAnalysis` | array | 필수 | 게슈탈트 분석 결과 |
-
-### 2단계 플로우
-
-**1단계: SeedContext 요청**
-```
-ges_generate_seed({ sessionId: "<id>" })
-```
-→ `{ status: "prompt", seedContext, message }` 반환
-
-SeedContext 필드:
-- `systemPrompt`: Seed 생성용 시스템 프롬프트
-- `seedPrompt`: 인터뷰 내용 기반 Seed 생성 프롬프트
-- `allRounds[]`: `{ roundNumber, question, response, gestaltFocus }`
-
-**2단계: Seed 제출 및 검증**
-```
-ges_generate_seed({
-  sessionId: "<id>",
-  seed: {
-    goal: "명확한 프로젝트 목표",
-    constraints: ["TypeScript 사용", "REST API"],
-    acceptanceCriteria: ["응답 시간 200ms 이하"],
-    ontologySchema: {
-      entities: [{ name: "User", description: "...", attributes: ["id", "email"] }],
-      relations: [{ from: "User", to: "Order", type: "has_many" }]
-    },
-    gestaltAnalysis: [
-      { principle: "closure", finding: "인증 요구사항 완전히 파악됨", confidence: 0.9 }
-    ]
-  }
-})
-```
-→ `{ status: "generated", seed }` (metadata 자동 생성 포함) 또는 `{ error }` 반환
-
-### Seed 검증 스키마 (Zod)
-
-- `gestaltAnalysis[].principle`: `closure | proximity | similarity | figure_ground | continuity`
-- `gestaltAnalysis[].confidence`: 0.0 ~ 1.0
-- `ontologySchema.entities[]`: `{ name: string(min 1), description: string, attributes: string[] }`
-- `ontologySchema.relations[]`: `{ from: string(min 1), to: string(min 1), type: string(min 1) }`

package/dist/src/cli/commands/seed.d.ts

@@ -1,4 +0,0 @@
-export declare function seedCommand(sessionId: string, options: {
-    force?: boolean;
-}): Promise<void>;
-//# sourceMappingURL=seed.d.ts.map

package/dist/src/cli/commands/seed.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/seed.ts"],"names":[],"mappings":"AAMA,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhG"}

package/dist/src/cli/commands/seed.js

@@ -1,34 +0,0 @@
-import { loadConfig } from '../../core/config.js';
-import { EventStore } from '../../events/store.js';
-import { AnthropicAdapter } from '../../llm/adapter.js';
-import { InterviewEngine } from '../../interview/engine.js';
-import { SeedGenerator } from '../../seed/generator.js';
-export async function seedCommand(sessionId, options) {
-    const config = loadConfig();
-    if (!config.anthropicApiKey) {
-        console.error('Error: ANTHROPIC_API_KEY is required for CLI mode. Set it in .env or as environment variable.');
-        process.exit(1);
-    }
-    const eventStore = new EventStore(config.dbPath);
-    const llm = new AnthropicAdapter(config.anthropicApiKey, config.model);
-    const engine = new InterviewEngine(llm, eventStore);
-    const generator = new SeedGenerator(llm, eventStore);
-    try {
-        const session = engine.getSession(sessionId);
-        console.log(`\n🌱 Generating seed for session: ${session.topic}\n`);
-        const result = await generator.generate(session, options.force ?? false);
-        if (!result.ok) {
-            console.error(`Error: ${result.error.message}`);
-            return;
-        }
-        console.log(JSON.stringify(result.value, null, 2));
-        console.log('\n✅ Seed generated successfully.\n');
-    }
-    catch (e) {
-        console.error(`Error: ${e instanceof Error ? e.message : String(e)}`);
-    }
-    finally {
-        eventStore.close();
-    }
-}
-//# sourceMappingURL=seed.js.map

package/dist/src/cli/commands/seed.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../../../src/cli/commands/seed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB,EAAE,OAA4B;IAC/E,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5B,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,+FAA+F,CAAC,CAAC;QAC/G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,qCAAqC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC;QAEzE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,UAAU,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAChD,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;YAAS,CAAC;QACT,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC"}

package/dist/src/interview/ambiguity.d.ts

@@ -1,8 +0,0 @@
-import type { AmbiguityScore, InterviewRound, ProjectType } from '../core/types.js';
-import type { LLMAdapter } from '../llm/types.js';
-export declare class AmbiguityScorer {
-    private llm;
-    constructor(llm: LLMAdapter);
-    score(topic: string, rounds: InterviewRound[], projectType: ProjectType): Promise<AmbiguityScore>;
-}
-//# sourceMappingURL=ambiguity.d.ts.map

package/dist/src/interview/ambiguity.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ambiguity.d.ts","sourceRoot":"","sources":["../../../src/interview/ambiguity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,qBAAa,eAAe;IACd,OAAO,CAAC,GAAG;gBAAH,GAAG,EAAE,UAAU;IAE7B,KAAK,CACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,EAAE,EACxB,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,cAAc,CAAC;CA4B3B"}

package/dist/src/interview/ambiguity.js

@@ -1,69 +0,0 @@
-import { computeAmbiguityScore } from '../gestalt/analyzer.js';
-import { buildAmbiguityPrompt, INTERVIEW_SYSTEM_PROMPT } from '../llm/prompts.js';
-export class AmbiguityScorer {
-    llm;
-    constructor(llm) {
-        this.llm = llm;
-    }
-    async score(topic, rounds, projectType) {
-        const answeredRounds = rounds.filter((r) => r.userResponse);
-        if (answeredRounds.length === 0) {
-            return {
-                overall: 1.0,
-                dimensions: [],
-                isReady: false,
-            };
-        }
-        const prompt = buildAmbiguityPrompt(topic, answeredRounds.map((r) => ({
-            question: r.question,
-            response: r.userResponse,
-        })), projectType);
-        const response = await this.llm.chat({
-            system: INTERVIEW_SYSTEM_PROMPT,
-            messages: [{ role: 'user', content: prompt }],
-            temperature: 0.3,
-        });
-        const raw = parseAmbiguityResponse(response.content, projectType);
-        return computeAmbiguityScore(raw, projectType);
-    }
-}
-function parseAmbiguityResponse(content, projectType) {
-    const jsonMatch = content.match(/\{[\s\S]*\}/);
-    if (!jsonMatch) {
-        return defaultScores(projectType);
-    }
-    try {
-        const parsed = JSON.parse(jsonMatch[0]);
-        return {
-            goalClarity: toNumber(parsed['goalClarity'], 0),
-            constraintClarity: toNumber(parsed['constraintClarity'], 0),
-            successCriteria: toNumber(parsed['successCriteria'], 0),
-            priorityClarity: toNumber(parsed['priorityClarity'], 0),
-            contextClarity: projectType === 'brownfield'
-                ? toNumber(parsed['contextClarity'], 0)
-                : undefined,
-            contradictions: Array.isArray(parsed['contradictions'])
-                ? parsed['contradictions']
-                : [],
-        };
-    }
-    catch {
-        return defaultScores(projectType);
-    }
-}
-function defaultScores(projectType) {
-    return {
-        goalClarity: 0,
-        constraintClarity: 0,
-        successCriteria: 0,
-        priorityClarity: 0,
-        contextClarity: projectType === 'brownfield' ? 0 : undefined,
-        contradictions: [],
-    };
-}
-function toNumber(value, fallback) {
-    if (typeof value === 'number' && !isNaN(value))
-        return value;
-    return fallback;
-}
-//# sourceMappingURL=ambiguity.js.map

package/dist/src/interview/ambiguity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ambiguity.js","sourceRoot":"","sources":["../../../src/interview/ambiguity.ts"],"names":[],"mappings":"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"}

package/dist/src/mcp/tools/seed-passthrough.d.ts

@@ -1,5 +0,0 @@
-import type { PassthroughEngine } from '../../interview/passthrough-engine.js';
-import type { PassthroughSeedGenerator } from '../../seed/passthrough-generator.js';
-import type { SeedInput } from '../schemas.js';
-export declare function handleSeedPassthrough(engine: PassthroughEngine, generator: PassthroughSeedGenerator, input: SeedInput): string;
-//# sourceMappingURL=seed-passthrough.d.ts.map

package/dist/src/mcp/tools/seed-passthrough.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"seed-passthrough.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tools/seed-passthrough.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,SAAS,EAAE,wBAAwB,EACnC,KAAK,EAAE,SAAS,GACf,MAAM,CA8BR"}