@tienne/gestalt 0.8.0 → 0.9.1

package/CLAUDE.md

@@ -1,7 +1,7 @@
 # Gestalt — AI Development Harness
 
 ## Overview
-게슈탈트 심리학 원리를 요구사항 명확화 프로세스에 매핑한 TypeScript 기반 AI 개발 하네스.
+게슈탈트 지각이론을 요구사항 명확화 프로세스에 매핑한 TypeScript 기반 AI 개발 하네스.
 "전체는 부분의 합보다 크다" — 흩어진 요구사항 조각들을 모아 완전한 스펙(Spec)으로 결정화.
 
 ## Architecture
@@ -10,7 +10,7 @@
 - **Execute Engine**: 게슈탈트 5원리를 실행 전략으로 사용, Spec→ExecutionPlan 변환 (Figure-Ground→Closure→Proximity→Continuity)
 - **Resilience Engine**: Stagnation 감지 → Lateral Thinking Personas → Human Escalation
 - **MCP Server**: stdio transport로 Claude Code 등 AI 에이전트와 통합
-- **Skill System**: SKILL.md 기반 확장, chokidar hot-reload 지원
+- **Skill System**: SKILL.md 기반 확장, chokidar hot-reload 지원. 각 스킬(`/interview`, `/spec`, `/execute`)은 실행 중 Claude Code Task 패널에 진행 상태를 `TaskCreate`/`TaskUpdate`로 실시간 표시 (공통 진행 패널)
 - **Event Store**: better-sqlite3 WAL 모드 이벤트 소싱
 
 ## Tech Stack
@@ -57,6 +57,7 @@ interface GestaltConfig {
   llm: { apiKey: string; model: string };
   interview: { ambiguityThreshold: number; maxRounds: number };
   execute: { driftThreshold: number; successThreshold: number; goalAlignmentThreshold: number };
+  notifications: boolean;
   dbPath: string;
   skillsDir: string;
   agentsDir: string;
@@ -75,6 +76,7 @@ interface GestaltConfig {
 | `GESTALT_DRIFT_THRESHOLD` | `execute.driftThreshold` | `0.3` |
 | `GESTALT_EVOLVE_SUCCESS_THRESHOLD` | `execute.successThreshold` | `0.85` |
 | `GESTALT_EVOLVE_GOAL_ALIGNMENT_THRESHOLD` | `execute.goalAlignmentThreshold` | `0.80` |
+| `GESTALT_NOTIFICATIONS` | `notifications` | `false` |
 | `GESTALT_DB_PATH` | `dbPath` | `"~/.gestalt/events.db"` |
 | `GESTALT_SKILLS_DIR` | `skillsDir` | `"skills"` |
 | `GESTALT_AGENTS_DIR` | `agentsDir` | `"agents"` |

package/README.ko.md

@@ -4,7 +4,7 @@
 
 <p align="center">
   <strong>Gestalt — AI 개발 하네스</strong><br/>
-  모호한 요구사항을 구조화된 실행 계획으로 — Claude Code 안에서 바로.
+  흩어진 막연함을 하나의 실행 계획으로
 </p>
 
 <p align="center">
@@ -21,24 +21,34 @@
 
 ## Gestalt는 무엇인가요?
 
-Gestalt는 Claude Code 안에서 실행되는 MCP(Model Context Protocol) 서버예요. 구조화된 요구사항 인터뷰를 진행해 검증된 **Spec**(목표·제약조건·완료 기준을 담은 JSON 문서)을 만들어요. 그 Spec을 의존성 기반 실행 계획으로 변환할 때 별도 API 키는 필요하지 않아요.
+Gestalt는 Claude Code 안에서 실행되는 MCP(Model Context Protocol) 서버예요. 요구사항을 인터뷰로 구체화해 **Spec**(목표·제약조건·완료 기준)을 만들고, 그 Spec을 바탕으로 실행 계획을 짜요.
 
 > **시작 전 확인** — Node.js >= 20.0.0이 필요해요. `nvm install 22 && nvm use 22`로 설치할 수 있어요.
 
 ---
 
-## 실제로 어떻게 작동하나요?
+## 빠른 시작
 
-> **30초 만에 구조화된 실행 계획** — API 키 없이도 돼요.
+플러그인을 설치하세요 (최초 1회):
 
 ```bash
-# Gestalt 기반 요구사항 인터뷰 시작
+# 1단계: 마켓플레이스 등록
+/plugin marketplace add tienne/gestalt
+
+# 2단계: 플러그인 설치
+/plugin install gestalt@gestalt
+```
+
+설치가 끝나면 Claude Code에서 바로 사용할 수 있어요:
+
+```bash
+# 요구사항 인터뷰 시작
 /interview "사용자 인증 시스템"
 
-# 인터뷰 완료 후 구조화된 Spec 생성
+# 인터뷰 완료 후 Spec 생성
 /spec
 
-# Spec을 검증된 실행 계획으로 변환하고 실행
+# Spec을 실행 계획으로 만들고 실행
 /execute
 ```
 
@@ -88,15 +98,13 @@ Claude Code
   최종 Spec → 실행 계획
 ```
 
-`ANTHROPIC_API_KEY`는 필요하지 않아요. 모든 LLM 작업은 Claude Code가 처리해요.
-
 > **참고해 주세요** — CLI 직접 실행 모드에서는 `ANTHROPIC_API_KEY`가 필요해요. Claude Code 없이 터미널에서 바로 사용할 경우에만 해당돼요.
 
 ---
 
-## Project Memory
+## 프로젝트 메모리
 
-Spec과 실행 결과는 레포 루트의 `.gestalt/memory.json`에 자동으로 기록돼요.
+Spec과 실행 결과는 레포 루트의 `.gestalt/memory.json`에 자동으로 저장돼요.
 
 ```json
 {
@@ -109,8 +117,8 @@ Spec과 실행 결과는 레포 루트의 `.gestalt/memory.json`에 자동으로
 ```
 
 - **커밋하세요** — `.gestalt/memory.json`은 일반 JSON 파일이에요. 커밋하면 팀원도 `git pull` 후 이전 결정 사항을 그대로 이어받을 수 있어요.
-- **컨텍스트 주입** — 다음 Spec을 생성할 때 이전 목표와 아키텍처 결정 사항이 프롬프트에 자동으로 주입돼요.
-- **User Profile** — 개인 설정은 `~/.gestalt/profile.json`에 저장되며 커밋 대상에 포함되지 않아요.
+- **컨텍스트 반영** — 다음 Spec을 생성할 때 이전 목표와 아키텍처 결정 사항이 프롬프트에 자동으로 반영돼요.
+- **User Profile** — 개인 설정은 `~/.gestalt/profile.json`에 저장돼요. git에는 올라가지 않아요.
 
 ---
 
@@ -118,7 +126,7 @@ Spec과 실행 결과는 레포 루트의 `.gestalt/memory.json`에 자동으로
 
 ### 옵션 1: Claude Code 플러그인 (권장)
 
-MCP 서버, 슬래시 커맨드 스킬, Gestalt 에이전트, 프로젝트 컨텍스트를 단일 설치로 묶어서 제공해요.
+설치 한 번에 MCP 서버, 슬래시 커맨드, Gestalt 에이전트, 프로젝트 컨텍스트를 모두 사용할 수 있어요.
 
 ```bash
 # 1단계: 마켓플레이스 등록 (최초 1회)
@@ -135,7 +143,7 @@ MCP 서버, 슬래시 커맨드 스킬, Gestalt 에이전트, 프로젝트 컨
 | **MCP 도구** | `ges_interview`, `ges_generate_spec`, `ges_execute`, `ges_create_agent`, `ges_agent`, `ges_status` |
 | **슬래시 커맨드** | `/interview`, `/spec`, `/execute`, `/agent` |
 | **에이전트** | Gestalt 파이프라인 에이전트 5개 + Role 에이전트 9개 + Review 에이전트 3개 |
-| **CLAUDE.md** | 프로젝트 컨텍스트 및 MCP 사용 가이드 자동 주입 |
+| **CLAUDE.md** | 프로젝트 컨텍스트 및 MCP 사용 가이드 자동 추가 |
 
 > **Node.js >= 20.0.0** 필요 — [nvm](https://github.com/nvm-sh/nvm) 사용 시: `nvm install 22 && nvm use 22`
 
@@ -192,7 +200,7 @@ claude mcp add gestalt -- npx -y @tienne/gestalt
 /interview "Stripe로 결제 플로우를 만들고 싶어"
 ```
 
-각 라운드는 특정 모호성 차원을 목표로 진행돼요:
+각 라운드는 모호한 부분을 집중해서 파악해요:
 
 - **Closure** — 빠진 요구사항과 말하지 않고 가정한 것을 찾아요
 - **Proximity** — 함께 묶여야 할 기능을 식별해요
@@ -218,7 +226,7 @@ claude mcp add gestalt -- npx -y @tienne/gestalt
 3. caller가 요약 생성 후 제출 → 세션에 저장
 ```
 
-이후 라운드에서는 압축된 요약이 자동으로 주입돼요.
+이후 라운드에서 압축된 요약이 자동으로 반영돼요.
 
 ---
 
@@ -250,7 +258,7 @@ ges_generate_spec({ text: "JWT 인증이 포함된 API", template: "rest-api" })
 /spec
 ```
 
-파이프라인 전체를 구동하는 구조화된 **Spec**을 생성해요:
+이후 단계 전체의 기준이 되는 **Spec**을 생성해요:
 
 ```
 goal                → 명확하고 모호성 없는 프로젝트 목표
@@ -264,7 +272,7 @@ gestaltAnalysis     → 게슈탈트 원리별 핵심 발견 사항
 
 ### 3단계 — Execute (계획 + 실행)
 
-Spec을 의존성 기반 실행 계획으로 변환하고 실행해요:
+Spec에서 실행 계획을 만들어 실행해요:
 
 ```bash
 /execute
@@ -279,15 +287,15 @@ Spec을 의존성 기반 실행 계획으로 변환하고 실행해요:
 | 3 | **Proximity** | 관련 태스크를 도메인별 그룹으로 묶음 |
 | 4 | **Continuity** | 의존성 DAG 검증 — 순환 없음, 위상 정렬 순서 확인 |
 
-**Execution 단계**에서 위상 정렬 순서대로 태스크를 실행해요. 각 태스크 후 **Drift Detection**이 Spec과의 정렬 상태를 확인해요:
+**Execution 단계**에서 위상 정렬 순서대로 태스크를 실행해요. 각 태스크 후 **Drift Detection**이 Spec과 얼마나 맞는지 확인해요:
 
 - 3차원 점수: Goal (50%) + Constraint (30%) + Ontology (20%)
 - Jaccard 유사도 기반 측정
-- Threshold를 초과하면 소급 검토가 자동으로 시작돼요
+- 임계값을 초과하면 회고(Retrospective)가 자동으로 시작돼요
 
 #### 병렬 실행 (Parallel Groups)
 
-`plan_complete` 응답에 `parallelGroups: string[][]`이 포함돼요. 의존성이 없는 태스크는 같은 그룹에 배치되어 동시 실행할 수 있어요:
+`plan_complete` 응답에 `parallelGroups: string[][]`이 포함돼요. 의존성이 없는 태스크를 같은 그룹으로 묶어 동시에 실행해요:
 
 ```json
 "parallelGroups": [
@@ -325,9 +333,13 @@ ges_execute({
 })
 ```
 
-#### Sub-agent 스포닝 (Spawn)
+#### 실행 진행 패널
+
+`/execute` 실행 중 Claude Code Task 패널에 진행 상태가 실시간으로 표시돼요. Planning 단계부터 Evaluate까지 각 완료 태스크 수, 현재 태스크 이름, 실패 수, 병렬 그룹 구조가 자동으로 갱신돼요.
+
+#### 하위 에이전트 생성 (Spawn)
 
-복잡한 태스크를 동적으로 하위 태스크로 분해할 수 있어요:
+실행 중에 복잡한 태스크를 하위 태스크로 나눌 수 있어요:
 
 ```bash
 ges_execute({
@@ -349,7 +361,7 @@ ges_execute({
 
 | 단계 | 방식 | 실패 시 |
 |:---:|-------|-----------|
-| 1 | **Structural** — lint → build → test 실행 | 단락(short-circuit); 2단계 스킵 |
+| 1 | **Structural** — lint → build → test 실행 | 조기 종료(short-circuit); 2단계 건너뜀 |
 | 2 | **Contextual** — LLM이 각 AC + goal alignment 검증 | Evolution Loop 진입 |
 
 **성공 조건:** `score ≥ 0.85` AND `goalAlignment ≥ 0.80`
@@ -372,18 +384,18 @@ evolve → Spec 패치 (AC/constraints) → 영향받은 태스크 재실행 →
 
 Spec 패치 범위: AC와 constraints는 자유 수정; ontology는 추가/변경만; **goal은 변경 불가**.
 
-**Flow C — Lateral Thinking** (스태그네이션 감지 시)
+**Flow C — Lateral Thinking** (답보 상태 감지 시)
 
-종료하는 대신 Lateral Thinking Persona를 순환하며 다른 접근을 시도해요:
+종료하는 대신 Lateral Thinking Persona를 순서대로 적용하며 다른 접근을 시도해요:
 
-| 스태그네이션 패턴 | Persona | 전략 |
+| 답보 상태 패턴 | Persona | 전략 |
 |--------------------|---------|---------|
 | Hard cap 도달 | **Multistability** | 다른 각도로 보기 |
 | 진동하는 점수 | **Simplicity** | 단순하게 줄이고 수렴 |
 | 진전 없음 (no drift) | **Reification** | 빠진 것 채우기 |
-| 수익 체감 | **Invariance** | 성공한 패턴 복제 |
+| 효과 감소 | **Invariance** | 성공한 패턴 복제 |
 
-4개 Persona를 모두 소진하면 세션이 **Human Escalation**으로 종료돼요 — 수동 해결을 위한 구체적인 제안 목록과 함께.
+4개 Persona를 모두 소진하면 세션이 **Human Escalation**으로 종료돼요. 직접 해결할 수 있도록 구체적인 제안도 함께 제공해요.
 
 **종료 조건:**
 
@@ -406,7 +418,7 @@ Evolution 완료 후 코드 리뷰 파이프라인이 자동으로 실행돼요:
 review_start → 에이전트 관점 제출 → 합의 → 자동 수정
 ```
 
-9개의 내장 **Role 에이전트**가 다중 관점 리뷰를 제공해요:
+9개의 내장 **Role 에이전트**가 다양한 관점에서 리뷰해요:
 
 | 에이전트 | 도메인 |
 |-------|--------|
@@ -434,7 +446,7 @@ review_start → 에이전트 관점 제출 → 합의 → 자동 수정
 # 사용 가능한 에이전트 목록 조회
 /agent
 
-# 특정 에이전트로 임의 태스크 실행
+# 특정 에이전트로 원하는 태스크 실행
 /agent architect "이 코드베이스의 모듈 경계를 리뷰해줘"
 /agent security-reviewer "이 인증 코드의 취약점을 확인해줘"
 /agent technical-writer "이 모듈의 README를 작성해줘"
@@ -456,9 +468,9 @@ ges_create_agent  →  action: "submit", sessionId: "<id>", agentContent: "..."
 
 ---
 
-### 대안: CLI 직접 실행 모드
+### CLI 모드 (Claude Code 없이 사용하기)
 
-`ANTHROPIC_API_KEY`가 필요해요. Claude Code 없이 터미널에서 직접 실행할 수 있어요:
+Claude Code 없이 터미널에서 바로 사용하고 싶다면 CLI 모드를 이용할 수 있어요. **`ANTHROPIC_API_KEY`가 필요해요.**
 
 ```bash
 # 인터랙티브 인터뷰 시작
@@ -528,7 +540,7 @@ npx @tienne/gestalt setup
 
 **설정 우선순위** (높음 → 낮음): 코드 override → 쉘 환경변수 → `.env` → `gestalt.json` → 기본값
 
-잘못된 값은 경고를 출력하고 기본값으로 fallback해요.
+잘못된 값은 경고를 출력하고 기본값을 사용해요.
 
 ### 환경변수
 

package/README.md

@@ -21,7 +21,7 @@
 
 ## What is Gestalt?
 
-Gestalt is an MCP (Model Context Protocol) server that runs inside Claude Code. It conducts structured requirement interviews, generates a validated **Spec** (a JSON document capturing your goal, constraints, and acceptance criteria), and transforms that Spec into a dependency-aware execution plan — all without a separate API key.
+Gestalt is an MCP (Model Context Protocol) server that runs inside Claude Code. It conducts structured requirement interviews, generates a validated **Spec** (a JSON document capturing your goal, constraints, and acceptance criteria), and transforms that Spec into a dependency-aware execution plan.
 
 > **Prerequisites:** Node.js >= 20.0.0. Use `nvm install 22 && nvm use 22` if needed.
 
@@ -29,21 +29,7 @@ Gestalt is an MCP (Model Context Protocol) server that runs inside Claude Code.
 
 ## Quick Start
 
-**Choose your path:**
-
-### For Non-Developers (Claude Desktop)
-
-No terminal. No API key. Just Claude Desktop.
-
-→ **[5-minute Getting Started Guide](./docs/getting-started.md)**
-
-1. Open Claude Desktop
-2. Install the Gestalt plugin
-3. Type `/interview "your idea"` — Gestalt guides you through the rest
-
----
-
-### For Developers (MCP Integration)
+Install the plugin once, then use it in any Claude Code session:
 
 ```bash
 # Step 1: Add to marketplace (one-time setup)
@@ -104,8 +90,6 @@ You (in Claude Code)
   Final Spec → Execution Plan
 ```
 
-`ANTHROPIC_API_KEY` is not required. All LLM work is handled by Claude Code.
-
 ---
 
 ## Project Memory
@@ -339,6 +323,10 @@ ges_execute({
 })
 ```
 
+#### Real-time progress panel
+
+When using the `/execute` slash command, Gestalt displays live execution status in the Claude Code Task panel — showing completed/total tasks, current task name, failed task count, and parallel group progress. Updated automatically at each planning step, task completion, and evaluation stage.
+
 #### Sub-agent spawning
 
 Decompose a complex task into sub-tasks dynamically during execution:
@@ -468,9 +456,9 @@ ges_create_agent  →  action: "submit", sessionId: "<id>", agentContent: "..."
 
 ---
 
-### Alternative: CLI Direct Mode
+### CLI Mode (without Claude Code)
 
-Requires `ANTHROPIC_API_KEY`. Runs Gestalt directly from the terminal without Claude Code:
+Want to run Gestalt without Claude Code? CLI mode runs interviews directly in your terminal. **Requires `ANTHROPIC_API_KEY`.**
 
 ```bash
 # Start an interactive interview

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tienne/gestalt",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "description": "TypeScript AI Development Harness - Gestalt psychology-driven requirement clarification",
   "type": "module",
   "main": "./dist/src/index.js",
@@ -46,6 +46,7 @@
     "gray-matter": "^4.0.3",
     "ink": "^6.8.0",
     "jimp": "^1.6.0",
+    "node-notifier": "^10.0.1",
     "node-pty": "^1.1.0",
     "openai": "^6.27.0",
     "react": "^19.2.4",
@@ -54,6 +55,7 @@
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^22.13.10",
+    "@types/node-notifier": "^8.0.5",
     "tsx": "^4.19.3",
     "typescript": "^5.8.2",
     "vitest": "^3.0.9"

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

@@ -32,8 +32,20 @@ When writing Korean developer documentation, follow these conventions observed i
 **Formatting Patterns**
 - Bold key terms on first use: **소모성 아이템**, **비소모성 아이템**
 - Use bullet lists for features, options, and constraints — keep each item concise
+- Use numbered lists when sequence matters — installation steps, API call order, migration procedures
+  — Don't: bullet a 3-step setup where step 2 depends on step 1
+  — Do: number any list where "do these in order" is part of the instruction
 - Separate distinct concepts with `---` horizontal rules
-- End conceptual sections with a "참고해 주세요" callout for edge cases or policy notes
+- Use callout blocks to signal importance — choose the type based on consequence:
+  - 💡 **Tip**: better approach, shortcut, optional improvement
+  - 📝 **Note / 참고**: extra context, exception cases, policy notes — use at the end of conceptual sections
+  - ⚠️ **Warning / 주의**: incorrect usage causes problems (wrong output, wasted time)
+  - 🔴 **Danger / 경고**: data loss, security risk, service outage — reader must not skip this
+  — Don't use Note for Danger: "참고로 이 명령어는 데이터를 삭제해요" understates the risk
+- Write descriptive link text — destination should be clear from the link text alone
+  — Don't: "자세한 내용은 [여기](...)를 참고하세요."
+  — Do: "자세한 내용은 [설치 가이드](...)를 참고하세요."
+  — Don't: "See [this](url)." → Do: "See [API authentication guide](url)."
 
 **Content Principles**
 - Lead with business value or user benefit, follow with technical detail
@@ -46,6 +58,26 @@ When writing Korean developer documentation, follow these conventions observed i
 - Avoid listing terms inline in introductions if they are covered in a dedicated section below — redundant inline lists interrupt flow without adding value
 
 **Korean Sentence Writing**
+
+**핵심 원칙: 영어로 생각하고 번역하지 말 것**
+한국어로 직접 작성한다. "dependency-based execution planning"을 머릿속에서 먼저 영어로 구성한 뒤 번역하면 번역체가 된다.
+
+- ❌ 의존성 기반 실행 계획 수립 → ✅ 의존성에 따라 실행 순서를 정해요
+- ❌ 스태그네이션 감지 메커니즘이 트리거됩니다 → ✅ 답보 상태를 감지하면 자동으로 분기해요
+- ❌ 스포닝 → ✅ 하위 에이전트 생성
+- ❌ 소급 검토 컨텍스트 → ✅ 회고 컨텍스트
+- ❌ 임의 태스크에 적용 가능합니다 → ✅ 모든 태스크에 적용할 수 있어요
+- ❌ 단락(short-circuit) 처리 → ✅ 조기 종료 처리
+- ❌ 수익 체감 패턴 → ✅ 효과 감소 패턴
+
+**기술 용어 3단계 처리**
+
+| 단계 | 사용 기준 | 예시 |
+|------|-----------|------|
+| 영어 그대로 | 한국 개발자들이 영어로 통용하는 용어 | API, CLI, JSON, Git, PR, LLM, DAG |
+| 한국어 + 영어 병기 (첫 등장) | 덜 일반적인 전문 용어의 첫 사용 | 이벤트 소싱(Event Sourcing), 단락 회로 실행(Short-circuit Evaluation) |
+| 한국어만 | 자연스러운 한국어 표현이 있는 경우 | 버전 관리 (버저닝 ❌), 배포 (디플로이먼트 ❌) |
+
 - Reader is the subject: write so the developer is the actor — use active constructions
   — Don't: "설정이 완료되어야 합니다." → Do: "설정을 완료하세요."
   — Don't: "이 라이브러리는 초기화를 수행해요." → Do: "이 명령어로 초기화하세요."
@@ -206,7 +238,11 @@ When writing documentation, produce:
 - Callout blocks for important notes, warnings, or tips
 
 When reviewing existing documentation, provide:
-- Specific issues by section (clarity / structure / completeness / consistency)
-- Rewrite suggestions for unclear passages
+- Issues classified by severity:
+  - **Blocker**: reader can misunderstand, follow wrong steps, or miss a critical risk — must fix before publish
+  - **Fix**: clarity, consistency, or structural problem — fix when possible
+  - **Suggest**: improvement idea — optional, at author's discretion
+- Specific location (section name or quoted passage) for each issue
+- Rewrite suggestions for all Blocker and Fix items
 - Missing content checklist
 - Overall readability assessment

package/dist/schemas/gestalt.schema.json

@@ -87,6 +87,11 @@
       "description": "Directory containing agent definitions (env: GESTALT_AGENTS_DIR)",
       "default": "agents"
     },
+    "notifications": {
+      "type": "boolean",
+      "description": "Enable OS desktop notifications for pipeline events (env: GESTALT_NOTIFICATIONS)",
+      "default": false
+    },
     "logLevel": {
       "type": "string",
       "enum": ["debug", "info", "warn", "error"],

package/dist/skills/execute/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: execute
-version: "1.1.0"
+version: "1.2.0"
 description: "Gestalt-driven execution planner that transforms a Spec into a validated ExecutionPlan"
 triggers:
   - "execute"
@@ -183,6 +183,67 @@ API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가
 
 ---
 
+### 병렬 그룹 실행 (parallelGroups 활용)
+
+`plan_complete` 응답에 `parallelGroups: string[][]`가 포함되어 있으면 병렬 실행을 사용한다. 각 내부 배열은 동시에 실행할 수 있는 태스크 ID 묶음이다.
+
+**병렬 그룹 실행 흐름:**
+
+1. `parallelGroups[groupIndex]`의 taskId 목록을 확인한다.
+2. **단일 메시지에서** 각 taskId마다 Agent 툴을 하나씩, 동시에 호출한다 (여러 Agent 툴 호출을 같은 메시지에 담는다).
+3. 각 Agent는 독립적으로 해당 태스크를 수행하고, 완료되면 `execute_task`를 호출해 결과를 제출한다.
+4. 그룹 내 일부 Agent가 실패해도 나머지는 계속 실행한다. 실패한 태스크는 `status: "failed"`로 제출한다.
+5. 그룹 내 모든 Agent가 완료되면 다음 그룹으로 넘어간다.
+6. 모든 그룹이 완료된 후 실패한 태스크가 있으면 기존 evolve 파이프라인으로 재처리한다.
+
+**Agent 툴 호출 예시 (parallelGroups[0] = ["task-0", "task-1", "task-2"] 인 경우):**
+
+단일 메시지에서 세 Agent를 동시에 실행한다.
+
+```
+// 같은 메시지에서 동시 호출 — Agent 1
+Agent(task: "task-0 실행: {task-0 title}\n컨텍스트: {taskContext}\n완료 후 execute_task로 결과 제출")
+
+// 같은 메시지에서 동시 호출 — Agent 2
+Agent(task: "task-1 실행: {task-1 title}\n컨텍스트: {taskContext}\n완료 후 execute_task로 결과 제출")
+
+// 같은 메시지에서 동시 호출 — Agent 3
+Agent(task: "task-2 실행: {task-2 title}\n컨텍스트: {taskContext}\n완료 후 execute_task로 결과 제출")
+```
+
+**각 Agent의 execute_task 제출:**
+
+```json
+{
+  "action": "execute_task",
+  "sessionId": "...",
+  "taskResult": {
+    "taskId": "task-0",
+    "status": "completed",
+    "output": "태스크 수행 결과 요약",
+    "artifacts": ["path/to/file.ts"]
+  }
+}
+```
+
+실패 시:
+```json
+{
+  "action": "execute_task",
+  "sessionId": "...",
+  "taskResult": {
+    "taskId": "task-1",
+    "status": "failed",
+    "output": "실패 원인 설명",
+    "artifacts": []
+  }
+}
+```
+
+**parallelGroups가 없는 경우:** 기존 순차 실행 방식을 사용한다.
+
+---
+
 ### `execute_task` — 태스크 실행 결과 제출
 
 role_match/role_consensus로 얻은 `roleGuidance`를 참조해 태스크를 수행한 후 결과 제출.
@@ -350,3 +411,89 @@ role_match/role_consensus로 얻은 `roleGuidance`를 참조해 태스크를 수
 | `hard_cap` | structural 3회 + contextual 3회 실패 |
 | `caller` | `{ action: "evolve", terminateReason: "caller" }` |
 | `human_escalation` | 4개 lateral persona 소진 |
+
+---
+
+## 공통 진행 패널
+
+Execute 파이프라인 실행 중 Claude Code Task 패널에 실시간 상태를 표시한다. 패널 업데이트는 best-effort — 실패가 태스크 실행 흐름을 중단시켜서는 안 된다.
+
+### Planning 단계 시작 시 (`start` 응답 수신 후)
+
+`TaskCreate`로 실행 패널을 생성하고, 반환된 taskId를 세션 동안 보관한다.
+
+```
+subject: "Gestalt Execute: {spec.goal 앞 40자}"
+description: "Planning 중 | 단계 1/4 | figure_ground"
+activeForm: "실행 계획 수립 중"
+```
+
+### Planning 각 단계 후 (`plan_step` 응답 수신 시마다)
+
+`TaskUpdate`로 현재 Planning 단계를 업데이트한다.
+
+```
+description: "Planning 중 | 단계 {stepsCompleted}/4 | {currentPrinciple}"
+```
+
+### Execution 시작 후 (`execute_start` 응답 수신 후)
+
+Planning 패널 태스크를 완료하고, 새 Execution 패널 태스크를 생성한다.
+
+```
+subject: "Gestalt Execute: {spec.goal 앞 40자}"
+description: "0/{totalTasks} 완료 | 실패: 0개 | 그룹 0/{parallelGroupCount}"
+activeForm: "실행 중: {taskContext.currentTask.title}"
+```
+
+`plan_complete` 응답의 `planSummary.totalTasks`와 `planSummary.parallelGroupCount`를 활용한다.
+`taskContext.currentTask.title`은 `execute_start` 응답에서 바로 꺼내 쓴다.
+
+### 병렬 그룹 실행 시작 시 (Agent 툴 동시 호출 직전)
+
+각 병렬 그룹 실행을 시작하기 전에 `TaskUpdate`로 병렬 실행 상태를 표시한다.
+
+```
+activeForm: "병렬 실행 중: 그룹 {groupIndex}/{totalGroups} — {agentCount}개 Agent 실행 중"
+```
+
+- `groupIndex`: 현재 병렬 그룹 번호 (1부터 시작)
+- `totalGroups`: 전체 병렬 그룹 수 (`parallelGroups.length`)
+- `agentCount`: 현재 그룹의 태스크 수 (`parallelGroups[groupIndex].length`)
+
+### 각 태스크 완료 후 (`execute_task` 응답 수신 시마다)
+
+`TaskUpdate`로 진행 상황과 현재 실행 태스크명을 업데이트한다.
+
+순차 실행 중:
+```
+description: "{completedCount}/{totalTasks} 완료 | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+activeForm: "실행 중: {taskContext.currentTask.title}"
+```
+
+병렬 그룹 실행 중 (각 Agent의 execute_task 완료 시):
+```
+description: "{completedCount}/{totalTasks} 완료 | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+activeForm: "병렬 실행 중: 그룹 {groupIndex}/{totalGroups} — {agentCount}개 Agent 실행 중"
+```
+
+- `completedCount`: 지금까지 제출한 taskResult 수 (`response.completedTasks`)
+- `failedCount`: status가 `failed`인 taskResult 수
+- `groupIndex/totalGroups`: 현재 처리 중인 병렬 그룹 번호 / 전체 그룹 수
+- `agentCount`: 해당 그룹에서 아직 실행 중인 Agent 수
+
+`allTasksCompleted === true` 이면 `TaskUpdate({ status: "completed", activeForm: undefined, description: "전체 완료 ({totalTasks}개)" })`로 변경한다.
+
+### 평가/진화 단계
+
+- `evaluate` 시작: description에 "평가 중 — structural 검사" 추가
+- structural 통과: "평가 중 — contextual 검사" 로 업데이트
+- 평가 완료(success): `TaskUpdate({ status: "completed", description: "완료 | score: {overallScore} | alignment: {goalAlignment}" })`
+- Evolve 진입: description에 "개선 중 (generation {N})" 추가
+
+### 오류/에스컬레이션 시
+
+```
+status: "completed"
+description: "종료: {terminationReason} | 최고 점수: {bestScore}"
+```

package/dist/skills/interview/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: interview
-version: "1.0.0"
+version: "1.1.0"
 description: "Gestalt-driven interview to clarify project requirements"
 triggers:
   - "interview"
@@ -80,3 +80,39 @@ API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가
 | `questionPrompt` | string | 다음 질문 생성용 프롬프트 |
 | `scoringPrompt` | string? | 모호성 점수 산출용 프롬프트 (respond 후에만 포함) |
 | `roundNumber` | number | 현재 라운드 번호 |
+
+---
+
+## 공통 진행 패널
+
+인터뷰 진행 중 Claude Code Task 패널에 실시간 상태를 표시한다. 패널 업데이트는 best-effort — 업데이트 실패가 인터뷰 흐름을 중단시켜서는 안 된다.
+
+### 시작 시 (`start` 응답 수신 직후)
+
+`TaskCreate`를 호출해 진행 패널을 생성하고, 반환된 taskId를 세션 동안 보관한다.
+
+```
+subject: "Gestalt 인터뷰: {topic}"
+description: "라운드 1/{maxRounds} | 모호성: 측정 전"
+activeForm: "라운드 1 — {currentPrinciple}"
+```
+
+### 각 라운드 후 (`respond` 응답 수신 시마다)
+
+`TaskUpdate`로 description과 activeForm을 최신 상태로 갱신한다. 모호성 점수는 추이 형식으로 표시한다.
+
+```
+description: "라운드 {roundNumber}/{maxRounds} | 모호성: {score1} → {score2} → {latestScore}"
+activeForm: "라운드 {roundNumber} — {currentPrinciple}"
+```
+
+ambiguityScore.isReady === true 이면 description에 "✓ 준비 완료" 표시를 추가한다.
+
+### 완료 시 (`complete` 응답 수신 후)
+
+`TaskUpdate`로 status를 completed로 변경한다.
+
+```
+status: "completed"
+description: "총 {totalRounds}라운드 완료 | 최종 모호성: {finalAmbiguityScore}"
+```