@dmsdc-ai/aigentry-devkit 0.1.0

package/mcp-servers/deliberation/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "mcp-deliberation",
+  "version": "2.5.0",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "mcp-deliberation": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "ws": "^8.18.0"
+  }
+}

package/mcp-servers/deliberation/session-monitor.sh

@@ -0,0 +1,316 @@
+#!/bin/bash
+#
+# Session Monitor — 단일 deliberation 세션 전용 터미널 뷰
+#
+# Usage:
+#   bash session-monitor.sh <session_id> <project_slug>
+#
+# MCP 서버가 deliberation_start 시 자동으로 tmux 윈도우에서 실행합니다.
+#
+
+SESSION_ID="${1:?session_id 필요}"
+PROJECT="${2:?project_slug 필요}"
+STATE_FILE="$HOME/.local/lib/mcp-deliberation/state/$PROJECT/sessions/$SESSION_ID.json"
+
+# 색상
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+MAGENTA='\033[0;35m'
+BOLD='\033[1m'
+DIM='\033[2m'
+NC='\033[0m'
+BOX_CONTENT_WIDTH=60
+BOX_RULE="$(printf '%*s' "$((BOX_CONTENT_WIDTH + 2))" '' | tr ' ' '═')"
+
+fit_to_width() {
+  TEXT="$1" WIDTH="$2" node -e "
+    const raw = String(process.env.TEXT ?? '')
+      .replace(/\s+/g, ' ')
+      .trim();
+    const target = Number(process.env.WIDTH ?? '60');
+
+    const isWide = (cp) =>
+      cp >= 0x1100 && (
+        cp <= 0x115f || cp === 0x2329 || cp === 0x232a ||
+        (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) ||
+        (cp >= 0xac00 && cp <= 0xd7a3) ||
+        (cp >= 0xf900 && cp <= 0xfaff) ||
+        (cp >= 0xfe10 && cp <= 0xfe19) ||
+        (cp >= 0xfe30 && cp <= 0xfe6f) ||
+        (cp >= 0xff00 && cp <= 0xff60) ||
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1f64f) ||
+        (cp >= 0x1f900 && cp <= 0x1f9ff) ||
+        (cp >= 0x20000 && cp <= 0x3fffd)
+      );
+
+    const charWidth = (ch) => {
+      const cp = ch.codePointAt(0);
+      if (!cp || cp < 32 || (cp >= 0x7f && cp < 0xa0)) return 0;
+      return isWide(cp) ? 2 : 1;
+    };
+
+    const src = Array.from(raw);
+    const out = [];
+    let width = 0;
+    let truncated = false;
+    for (const ch of src) {
+      const w = charWidth(ch);
+      if (width + w > target) {
+        truncated = true;
+        break;
+      }
+      out.push(ch);
+      width += w;
+    }
+
+    if (truncated && target >= 3) {
+      while (out.length > 0 && width + 3 > target) {
+        const last = out.pop();
+        width -= charWidth(last);
+      }
+      out.push('.', '.', '.');
+      width += 3;
+    }
+
+    process.stdout.write(out.join('') + ' '.repeat(Math.max(0, target - width)));
+  " 2>/dev/null
+}
+
+print_box_border() {
+  printf "%b%s%b\n" "$BOLD" "$1${BOX_RULE}$2" "$NC"
+}
+
+print_box_row() {
+  local text="$1"
+  local color="${2:-$NC}"
+  local fitted
+  fitted="$(fit_to_width "$text" "$BOX_CONTENT_WIDTH")"
+  printf "%b║%b %b%s%b %b║%b\n" "$BOLD" "$NC" "$color" "$fitted" "$NC" "$BOLD" "$NC"
+}
+
+pane_in_copy_mode() {
+  if [ -z "$TMUX" ] || [ -z "${TMUX_PANE:-}" ]; then
+    return 1
+  fi
+  [ "$(tmux display-message -p -t "$TMUX_PANE" "#{pane_in_mode}" 2>/dev/null)" = "1" ]
+}
+
+state_signature() {
+  if [ ! -f "$STATE_FILE" ]; then
+    echo "MISSING"
+    return
+  fi
+
+  node -e "
+    const fs = require('fs');
+    try {
+      const s = JSON.parse(fs.readFileSync('$STATE_FILE','utf-8'));
+      const logs = Array.isArray(s.log) ? s.log : [];
+      const last = logs.length > 0 ? logs[logs.length - 1] : {};
+      const sig = [
+        s.status ?? '',
+        s.current_round ?? '',
+        s.max_rounds ?? '',
+        s.current_speaker ?? '',
+        Array.isArray(s.speakers) ? s.speakers.join(',') : '',
+        logs.length,
+        last.timestamp ?? '',
+        s.updated ?? '',
+        s.synthesis ? s.synthesis.length : 0
+      ].join('|');
+      console.log(sig);
+    } catch {
+      console.log('PARSE_ERROR');
+    }
+  " 2>/dev/null
+}
+
+get_field() {
+  node -e "
+    try {
+      const d = JSON.parse(require('fs').readFileSync('$STATE_FILE','utf-8'));
+      const keys = '$1'.split('.');
+      let val = d;
+      for (const k of keys) val = val?.[k];
+      if (Array.isArray(val)) console.log(val.length);
+      else console.log(val ?? '?');
+    } catch { console.log('?'); }
+  " 2>/dev/null
+}
+
+render() {
+  if [ ! -f "$STATE_FILE" ]; then
+    echo -e "${DIM}세션 파일 대기 중: $STATE_FILE${NC}"
+    return
+  fi
+
+  local topic=$(get_field "topic")
+  local status=$(get_field "status")
+  local round=$(get_field "current_round")
+  local max_rounds=$(get_field "max_rounds")
+  local participant_count=$(get_field "speakers")
+  local speaker=$(get_field "current_speaker")
+  local responses=$(get_field "log")
+
+  # 상태 색상
+  local status_color="$YELLOW"
+  case "$status" in
+    active) status_color="$GREEN" ;;
+    completed) status_color="$CYAN" ;;
+    awaiting_synthesis) status_color="$BLUE" ;;
+  esac
+
+  # 프로그레스 바
+  if ! [[ "$participant_count" =~ ^[0-9]+$ ]]; then participant_count=2; fi
+  if [ "$participant_count" -lt 1 ]; then participant_count=1; fi
+
+  local total=$((max_rounds * participant_count))
+  local filled=$responses
+  [ "$filled" -gt "$total" ] 2>/dev/null && filled=$total
+  local bar=""
+  for ((i=0; i<filled; i++)); do bar+="█"; done
+  for ((i=filled; i<total; i++)); do bar+="░"; done
+
+  # 헤더
+  print_box_border "╔" "╗"
+  print_box_row "$topic" "$YELLOW"
+  print_box_border "╠" "╣"
+  print_box_row "Session:  $SESSION_ID" "$MAGENTA"
+  print_box_row "Project:  $PROJECT" "$CYAN"
+  print_box_row "Status:   $status" "$status_color"
+  print_box_row "Round:    $round/$max_rounds  |  Next: $speaker" "$BOLD"
+  print_box_row "Progress: [$bar] $responses/$total" "$GREEN"
+  print_box_border "╚" "╝"
+  echo ""
+
+  # 토론 기록
+  node -e "
+    const fs = require('fs');
+    try {
+      const s = JSON.parse(fs.readFileSync('$STATE_FILE','utf-8'));
+
+      if (s.synthesis) {
+        console.log('\x1b[1m── Synthesis ──\x1b[0m');
+        console.log('');
+        const lines = s.synthesis.split('\n').slice(0, 20);
+        lines.forEach(l => console.log('  ' + l));
+        if (s.synthesis.split('\n').length > 20) console.log('  ...(truncated)');
+        console.log('');
+      }
+
+      if (s.log.length === 0) {
+        console.log('\x1b[2m  아직 응답이 없습니다. ' + s.current_speaker + ' 차례 대기 중...\x1b[0m');
+        process.exit(0);
+      }
+
+      console.log('\x1b[1m── Debate Log ──\x1b[0m');
+      console.log('');
+
+      const palette = ['\x1b[34m', '\x1b[33m', '\x1b[35m', '\x1b[36m', '\x1b[32m', '\x1b[31m'];
+      const icons = ['🔵', '🟡', '🟣', '🟢', '🟠', '⚪'];
+      const hash = (name) => {
+        let out = 0;
+        for (let i = 0; i < name.length; i += 1) out = (out * 31 + name.charCodeAt(i)) >>> 0;
+        return out;
+      };
+      const styleFor = (name) => {
+        const idx = hash(String(name ?? '')) % palette.length;
+        return { color: palette[idx], icon: icons[idx % icons.length] };
+      };
+
+      for (const entry of s.log) {
+        const { color, icon } = styleFor(entry.speaker);
+        console.log(color + '\x1b[1m' + icon + ' ' + entry.speaker + ' — Round ' + entry.round + '\x1b[0m');
+
+        const lines = entry.content.split('\n');
+        lines.forEach(l => console.log('  ' + l));
+        console.log('');
+      }
+
+      if (s.status === 'active') {
+        const nextColor = styleFor(s.current_speaker).color;
+        console.log(nextColor + '  ⏳ Waiting for ' + s.current_speaker + ' (Round ' + s.current_round + ')...\x1b[0m');
+      } else if (s.status === 'awaiting_synthesis') {
+        console.log('\x1b[36m  🏁 모든 라운드 종료. 합성 대기 중...\x1b[0m');
+      }
+    } catch(e) {
+      console.log('  읽기 실패: ' + e.message);
+    }
+  " 2>/dev/null
+
+  echo ""
+
+  # 완료 시 카운트다운
+  if [ "$status" = "completed" ]; then
+    echo -e "${CYAN}${BOLD}  ✅ Deliberation 완료!${NC}"
+    echo -e "${DIM}  이 터미널은 30초 후 자동으로 닫힙니다...${NC}"
+    for i in $(seq 30 -1 1); do
+      printf "\r${DIM}  닫히기까지 %2d초...${NC}" "$i"
+      sleep 1
+      # 파일이 삭제되었으면 즉시 종료
+      [ ! -f "$STATE_FILE" ] && break
+    done
+    echo ""
+    exit 0
+  fi
+}
+
+draw_frame() {
+  # 전체 클리어 대신 홈 이동 + 하단 잔여 영역만 정리해서 깜빡임 감소
+  printf '\033[H'
+  render
+  printf '\033[J'
+  echo -e "${DIM}Auto-refresh on change (poll 2s) | Scroll: mouse wheel / PgUp (tmux copy-mode) | Ctrl+C${NC}"
+}
+
+# 커서 숨김 (종료 시 복구)
+printf '\033[?25l'
+trap 'printf "\033[?25h"' EXIT INT TERM
+printf '\033[2J\033[H'
+
+# tmux에서 스크롤(휠/업다운) 동작을 위해 mouse/copy history 옵션 활성화
+if [ -n "$TMUX" ]; then
+  tmux set-option -g mouse on >/dev/null 2>&1 || true
+  tmux set-option -g history-limit 200000 >/dev/null 2>&1 || true
+fi
+
+# 메인 루프
+last_sig=""
+seen_file=0
+while true; do
+  if pane_in_copy_mode; then
+    # 사용자가 스크롤 중이면 렌더 업데이트를 멈춰 화면 점프를 방지
+    sleep 1
+    continue
+  fi
+
+  if [ ! -f "$STATE_FILE" ]; then
+    if [ "$seen_file" -eq 1 ]; then
+      printf '\033[H\033[J'
+      echo -e "${RED}세션이 삭제되었습니다.${NC}"
+      sleep 3
+      exit 0
+    fi
+
+    if [ "$last_sig" != "MISSING" ]; then
+      draw_frame
+      last_sig="MISSING"
+    fi
+
+    sleep 2
+    continue
+  fi
+
+  seen_file=1
+  sig="$(state_signature)"
+  if [ "$sig" != "$last_sig" ]; then
+    draw_frame
+    last_sig="$sig"
+  fi
+
+  sleep 2
+done

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@dmsdc-ai/aigentry-devkit",
+  "version": "0.1.0",
+  "description": "Cross-platform installer and tooling bundle for aigentry-devkit",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dmsdc-ai/aigentry-devkit.git"
+  },
+  "homepage": "https://github.com/dmsdc-ai/aigentry-devkit#readme",
+  "bugs": {
+    "url": "https://github.com/dmsdc-ai/aigentry-devkit/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "aigentry-devkit": "bin/aigentry-devkit.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/aigentry-devkit.js",
+    "config/**",
+    "hooks/**",
+    "hud/**",
+    "install.sh",
+    "install.ps1",
+    "mcp-servers/deliberation/index.js",
+    "mcp-servers/deliberation/package.json",
+    "mcp-servers/deliberation/session-monitor.sh",
+    "skills/clipboard-image/**",
+    "skills/deliberation/**",
+    "skills/deliberation-executor/**",
+    "skills/env-manager/**",
+    "skills/youtube-analyzer/**",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "ai",
+    "devkit",
+    "claude",
+    "codex",
+    "mcp",
+    "deliberation"
+  ]
+}

package/skills/clipboard-image/SKILL.md

@@ -0,0 +1,31 @@
+---
+name: clipboard-image
+description: Capture and view clipboard image. Triggers on "clipboard", "paste image", "클립보드", "이미지 붙여넣기", "캡처 확인"
+allowed-tools: Bash, Read
+---
+
+# Clipboard Image Viewer
+
+Capture the current clipboard image and display it for analysis.
+
+## Steps
+
+1. Save clipboard image to a temp file:
+```bash
+DISPLAY=:1 xclip -selection clipboard -t image/png -o > /tmp/clipboard-image.png 2>/dev/null
+```
+
+2. Check if the image was captured successfully:
+```bash
+file /tmp/clipboard-image.png
+```
+
+3. If successful, use the Read tool to view `/tmp/clipboard-image.png` (Claude Code can read images natively).
+
+4. If no image in clipboard, inform the user:
+   - "클립보드에 이미지가 없습니다. 스크린샷을 복사한 후 다시 시도해주세요."
+
+## Troubleshooting
+
+- If DISPLAY=:1 doesn't work, try DISPLAY=:0
+- If xclip fails, check: `DISPLAY=:1 xclip -selection clipboard -t TARGETS -o`

package/skills/deliberation/SKILL.md

@@ -0,0 +1,135 @@
+---
+name: deliberation
+description: |
+  AI 간 deliberation(토론) 세션을 관리합니다. 멀티 세션 병렬 토론 지원.
+  MCP deliberation 서버를 통해 MCP를 지원하는 모든 CLI가 구조화된 토론을 진행합니다.
+  "deliberation", "deliberate", "토론", "토론 시작", "deliberation 시작",
+  "저장소 전략 토론", "컨셉 토론", "debate" 키워드 시 자동 트리거됩니다.
+---
+
+# AI Deliberation 스킬 (v2.4 — Multi-Session)
+
+Claude/Codex를 포함해 MCP를 지원하는 임의 CLI들이 구조화된 토론을 진행합니다.
+**여러 토론을 동시에 병렬 진행할 수 있습니다.**
+**이 스킬은 토론/합의 전용이며, 실제 구현은 `deliberation-executor`로 handoff합니다.**
+
+## MCP 서버 위치
+- **서버**: `~/.local/lib/mcp-deliberation/index.js` (v2.4.0)
+- **상태**: `~/.local/lib/mcp-deliberation/state/{프로젝트명}/sessions/{session_id}.json`
+- **등록**: 각 CLI 환경의 MCP 설정에 `deliberation` 서버 등록
+- **브라우저 탭 스캔**: macOS 자동화 + CDP(Windows/Linux는 remote-debugging port 권장)
+
+## 사용 가능한 MCP 도구
+
+| 도구 | 설명 | session_id |
+|------|------|:---:|
+| `deliberation_start` | 새 토론 시작 → **session_id 반환** | 반환 |
+| `deliberation_speaker_candidates` | 참가 가능한 speaker 후보 목록 조회 | 불필요 |
+| `deliberation_list_active` | 진행 중인 모든 세션 목록 | 불필요 |
+| `deliberation_status` | 토론 상태 조회 | 선택적* |
+| `deliberation_context` | 프로젝트 컨텍스트 로드 | 불필요 |
+| `deliberation_browser_llm_tabs` | 브라우저 LLM 탭 목록 (웹 기반 LLM 참여용) | 불필요 |
+| `deliberation_clipboard_prepare_turn` | 클립보드 기반 턴 준비 (프롬프트 생성) | 선택적* |
+| `deliberation_clipboard_submit_turn` | 클립보드 기반 턴 제출 (응답 붙여넣기) | 선택적* |
+| `deliberation_route_turn` | 현재 차례 speaker의 transport(CLI/clipboard/manual)를 자동 라우팅 | 선택적* |
+| `deliberation_respond` | 현재 차례의 응답 제출 | 선택적* |
+| `deliberation_history` | 전체 토론 기록 조회 | 선택적* |
+| `deliberation_synthesize` | 합성 보고서 생성 및 토론 완료 | 선택적* |
+| `deliberation_list` | 과거 토론 아카이브 목록 | 불필요 |
+| `deliberation_reset` | 세션 초기화 (지정 시 해당 세션만, 미지정 시 전체) | 선택적 |
+
+*\*선택적: 활성 세션이 1개면 자동 선택. 여러 세션 진행 중이면 필수.*
+
+## session_id 규칙
+
+- `deliberation_start` 호출 시 session_id가 자동 생성되어 반환됨
+- 이후 모든 도구 호출에 해당 session_id를 전달
+- 활성 세션이 1개뿐이면 session_id 생략 가능 (자동 선택)
+- 여러 세션이 동시 진행 중이면 반드시 session_id 지정
+
+## 자동 트리거 키워드
+다음 키워드가 감지되면 이 스킬을 자동으로 활성화합니다:
+- "deliberation", "deliberate", "토론", "debate"
+- "deliberation 시작", "토론 시작", "토론해", "토론하자"
+- "deliberation_start", "deliberation_respond", "deliberation_route_turn"
+- "speaker candidates", "브라우저 LLM", "clipboard submit"
+- "{주제} 토론", "{주제} deliberation"
+
+## 워크플로우
+
+### A. 사용자 선택형 진행 (권장)
+1. `deliberation_speaker_candidates` → 참가 가능한 CLI/브라우저 speaker 확인
+2. (선택) `deliberation_browser_llm_tabs` → 웹 LLM 탭 점검
+3. `deliberation_start` (speakers 명시) → session_id 획득
+4. `deliberation_route_turn` → 현재 차례 speaker transport 확인 + turn_id 확보
+5. 라우팅 결과에 따라 제출:
+- CLI speaker: `deliberation_respond(session_id, speaker, content, turn_id)`
+- Browser speaker: `deliberation_clipboard_prepare_turn` → 응답 복사 → `deliberation_clipboard_submit_turn(session_id, speaker, turn_id)`
+6. 반복 후 `deliberation_synthesize(session_id)` → 합성 완료
+7. 구현이 필요하면 `deliberation-executor` 스킬로 handoff
+   예: "session_id {id} 합의안 구현해줘"
+
+### B. 병렬 세션 운영
+1. `deliberation_start` (topic: "주제A") → session_id_A
+2. `deliberation_start` (topic: "주제B") → session_id_B
+3. `deliberation_list_active` → 진행 중 세션 확인
+4. 각 세션을 `session_id`로 명시해 독립 진행
+5. 각각 `deliberation_synthesize`로 개별 종료
+
+### C. 자동 진행 (스크립트)
+```bash
+# 새 토론
+bash auto-deliberate.sh "저장소 전략"
+
+# 5라운드로 진행
+bash auto-deliberate.sh "API 설계" 5
+
+# 기존 세션 재개
+bash auto-deliberate.sh --resume <session_id>
+```
+
+### D. 모니터링
+```bash
+# 모든 활성 세션 모니터링
+bash deliberation-monitor.sh
+
+# 특정 세션만
+bash deliberation-monitor.sh <session_id>
+
+# tmux에서
+bash deliberation-monitor.sh --tmux
+```
+
+## 역할 규칙
+
+### 역할 예시 A: 비판적 분석가
+- 제안의 약점을 먼저 찾는다
+- 구체적 근거와 수치를 요구한다
+- 리스크를 명시하되 대안을 함께 제시한다
+
+### 역할 예시 B: 현실적 실행가
+- 실행 가능성을 우선 평가한다
+- 구체적 기술 스택과 구현 방안을 제시한다
+- 비용/복잡도/일정을 현실적으로 산정한다
+
+## 응답 형식
+
+매 턴의 응답은 다음 구조를 따릅니다:
+
+```markdown
+**상대 평가:** (동의/반박/보완)
+**핵심 입장:** (구체적 제안)
+**근거:** (2-3개)
+**리스크/우려:** (약점 1-2개)
+**상대에게 질문:** (1-2개)
+**합의 가능 포인트:** (동의할 수 있는 것)
+**미합의 포인트:** (결론 안 난 것)
+```
+
+## 주의사항
+1. 여러 deliberation을 동시에 병렬 진행 가능
+2. session_id는 `deliberation_start` 응답에서 확인
+3. 토론 결과는 Obsidian vault에 자동 아카이브 (프로젝트 폴더 존재 시)
+4. `deliberation-{session_id}.md`가 프로젝트 루트에 실시간 동기화됨
+5. `Transport closed` 발생 시 현재 CLI 세션 재시작 후 재시도 (stdio 연결은 세션 바인딩)
+6. 멀티 세션 운영 중 `pkill -f mcp-deliberation` 사용 금지 (다른 세션 연결까지 끊길 수 있음)

package/skills/deliberation-executor/SKILL.md

@@ -0,0 +1,86 @@
+---
+name: deliberation-executor
+description: |
+  deliberation 합의안을 실제 구현으로 전환하는 실행 전용 스킬.
+  synthesis/결론을 작업 단위로 분해하고 코드 수정, 테스트, 검증까지 진행합니다.
+  "합의안 구현", "토론 결과 구현", "deliberation 구현", "synthesis 구현", "executor" 요청 시 사용합니다.
+allowed-tools: Bash, Read, Edit, Write, Glob, Grep
+---
+
+# Deliberation Executor
+
+토론(deliberation) 결과를 실제 코드 변경으로 연결하는 실행 스킬입니다.
+
+## 입력 기준
+
+다음 중 하나를 받아 구현을 시작합니다:
+
+1. `deliberation-{session_id}.md` 파일
+2. `deliberation_synthesize` 결과 텍스트
+3. 사용자가 직접 붙여넣은 합의안/결론
+
+입력이 불완전하면 즉시 확인:
+- 목표 산출물(코드/문서/스크립트)
+- 완료 조건(테스트 통과, 동작 확인, 품질 기준)
+- 범위(이번 턴에서 처리할 것과 제외할 것)
+
+## 실행 워크플로우
+
+### 1) 합의안 -> 실행 백로그 변환
+
+합의안을 3~8개 작업으로 분해합니다:
+- `task_id`
+- `목표`
+- `영향 파일/모듈`
+- `검증 방법`
+- `완료 기준`
+
+작업은 작고 독립적으로 나눕니다. 모호한 작업은 바로 구현하지 않고 먼저 구체화합니다.
+
+### 2) 적재적소 스킬/에이전트 라우팅
+
+요청 성격에 따라 필요한 보조 스킬을 함께 사용합니다:
+
+- 환경변수/배포 설정/direnv: `env-manager`
+- 스크린샷/클립보드 이미지 분석: `clipboard-image`
+- YouTube 링크 분석/요약 근거 추출: `youtube-analyzer`
+- 설계 불확실성이 큰 경우: 짧은 `deliberation` 세션 재개 후 합의 업데이트
+
+기본 원칙:
+- 구현은 이 스킬에서 진행
+- 조사/분석성 하위 작업만 보조 스킬로 위임
+
+### 3) 구현 루프
+
+각 task마다 아래 순서를 지킵니다:
+
+1. 관련 파일 탐색 (`rg`, `rg --files`)
+2. 최소 변경으로 코드 수정
+3. 영향 범위 테스트/검증 실행
+4. 실패 시 원인 수정 후 재검증
+5. task 상태 업데이트
+
+### 4) 결과 보고 형식
+
+최종 보고에는 반드시 포함:
+
+- 완료된 task 목록
+- 변경 파일 목록
+- 실행한 검증 명령과 결과 요약
+- 남은 리스크/미완료 task
+- 다음 액션(필요 시)
+
+## 품질 규칙
+
+- 합의안에 없는 기능 확장은 금지(범위 드리프트 방지)
+- 테스트가 있으면 반드시 실행하고 결과를 남김
+- 테스트가 없으면 최소 실행 검증 절차를 명시
+- 실패를 숨기지 말고 재현 가능한 형태로 보고
+
+## 빠른 시작 예시
+
+```text
+"deliberation 합의안 구현해줘. session_id는 abc123"
+"토론 결과를 코드로 반영하고 테스트까지 돌려줘"
+"synthesis 구현 진행하고 남은 리스크도 정리해줘"
+```