@tienne/gestalt 0.14.1 → 0.15.0

package/README.ko.md

@@ -128,6 +128,14 @@ Spec과 실행 결과는 레포 루트의 `.gestalt/memory.json`에 자동으로
 
 설치 한 번에 MCP 서버, 슬래시 커맨드, Gestalt 에이전트, 프로젝트 컨텍스트를 모두 사용할 수 있어요.
 
+**터미널에서:**
+
+```bash
+claude plugin install gestalt@gestalt
+```
+
+**Claude Code 세션 내에서:**
+
 ```bash
 # 1단계: 마켓플레이스 등록 (최초 1회)
 /plugin marketplace add tienne/gestalt

package/README.md

@@ -118,6 +118,14 @@ Every spec and execution result is automatically recorded in `.gestalt/memory.js
 
 Bundles the MCP server, slash-command skills, Gestalt agents, and project context — pre-configured in a single install.
 
+**From a terminal:**
+
+```bash
+claude plugin install gestalt@gestalt
+```
+
+**Inside a Claude Code session:**
+
 ```bash
 # Step 1: Add to marketplace (one-time setup)
 /plugin marketplace add tienne/gestalt

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",

package/dist/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/dist/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/dist/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/dist/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",