@tienne/gestalt 0.9.0 → 0.9.2

package/skills/execute/SKILL.md

@@ -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`를 참조해 태스크를 수행한 후 결과 제출.
@@ -381,26 +442,47 @@ Planning 패널 태스크를 완료하고, 새 Execution 패널 태스크를 생
 
 ```
 subject: "Gestalt Execute: {spec.goal 앞 40자}"
-description: "0/{totalTasks} 완료 | 현재: 시작 대기 중 | 실패: 0개 | 그룹 0/{parallelGroupCount}"
-activeForm: "태스크 실행 중"
+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`로 진행 상황을 업데이트한다.
+`TaskUpdate`로 진행 상황과 현재 실행 태스크명을 업데이트한다.
+
+순차 실행 중:
+```
+description: "{completedCount}/{totalTasks} 완료 | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+activeForm: "실행 중: {taskContext.currentTask.title}"
+```
 
+병렬 그룹 실행 중 (각 Agent의 execute_task 완료 시):
 ```
-description: "{completedCount}/{totalTasks} 완료 | 현재: {nextTask.title or '완료'} | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+description: "{completedCount}/{totalTasks} 완료 | 실패: {failedCount}개 | 그룹 {groupIndex}/{totalGroups}"
+activeForm: "병렬 실행 중: 그룹 {groupIndex}/{totalGroups} — {agentCount}개 Agent 실행 중"
 ```
 
-- `completedCount`: 지금까지 제출한 taskResult 수
-- `nextTask`: 응답의 `nextTaskId`로 다음 태스크 이름 추론
+- `completedCount`: 지금까지 제출한 taskResult 수 (`response.completedTasks`)
 - `failedCount`: status가 `failed`인 taskResult 수
-- `groupIndex/totalGroups`: `plan_complete` 응답의 `parallelGroups` 기준
+- `groupIndex/totalGroups`: 현재 처리 중인 병렬 그룹 번호 / 전체 그룹 수
+- `agentCount`: 해당 그룹에서 아직 실행 중인 Agent 수
 
-`allTasksCompleted === true` 이면 description에 "전체 완료" 표시 후 `TaskUpdate`로 status를 completed로 변경한다.
+`allTasksCompleted === true` 이면 `TaskUpdate({ status: "completed", activeForm: undefined, description: "전체 완료 ({totalTasks}개)" })`로 변경한다.
 
 ### 평가/진화 단계
 

package/skills/interview/SKILL.md

@@ -93,16 +93,17 @@ API 키 없이 MCP 서버 실행 시 자동 활성화. LLM 작업을 caller가
 
 ```
 subject: "Gestalt 인터뷰: {topic}"
-description: "라운드 1/{maxRounds} | 원리: {currentPrinciple} | 모호성: 측정 전"
-activeForm: "인터뷰 진행 중"
+description: "라운드 1/{maxRounds} | 모호성: 측정 전"
+activeForm: "라운드 1 — {currentPrinciple}"
 ```
 
 ### 각 라운드 후 (`respond` 응답 수신 시마다)
 
-`TaskUpdate`로 description을 최신 상태로 갱신한다. 모호성 점수는 추이 형식으로 표시한다.
+`TaskUpdate`로 description과 activeForm을 최신 상태로 갱신한다. 모호성 점수는 추이 형식으로 표시한다.
 
 ```
-description: "라운드 {roundNumber}/{maxRounds} | 원리: {currentPrinciple} | 모호성: {score1} → {score2} → {latestScore}"
+description: "라운드 {roundNumber}/{maxRounds} | 모호성: {score1} → {score2} → {latestScore}"
+activeForm: "라운드 {roundNumber} — {currentPrinciple}"
 ```
 
 ambiguityScore.isReady === true 이면 description에 "✓ 준비 완료" 표시를 추가한다.

package/skills/spec/SKILL.md

@@ -104,7 +104,13 @@ Spec 생성 중 Claude Code Task 패널에 상태를 표시한다. best-effort
 ```
 subject: "Spec 생성 중"
 description: "인터뷰 세션 {sessionId} 기반 Spec 구성 중..."
-activeForm: "Spec 생성 중"
+activeForm: "1/2 — 컨텍스트 요청 중"
+```
+
+1단계 응답(`status: "prompt"`) 수신 후 `TaskUpdate`로 갱신한다.
+
+```
+activeForm: "2/2 — Spec 검증 중"
 ```
 
 ### 완료 시 (2단계 `ges_generate_spec` 응답 수신 후)