qualitative-data-analyzer¶
Braun & Clarke(2006) 6단계 주제 분석 — Multi-LLM 교차 검증 기본 + Human-in-the-Loop는 Claude Code 채팅에서 직접 승인. 인터뷰 전사본 등 질적 데이터의 주제 분석 시 사용
| 항목 | 값 |
|---|---|
| 캐릭터(역할) | 아스카 · Quality & Review |
| 모델 | Sonnet 5.5 · effort high · 교차검증 합의: Opus 5.5 의장 · gpt-6.1-terra · Gemini |
| 도구 (tools) | Read, Glob, Grep, Write, Bash |
| Codex GPT-5.6 위임 | 예 — Multi-LLM 모드의 2–4단계에 gpt-6.1-terra가 병렬 참여 |
무엇을 하는가¶
질적 데이터(인터뷰 전사, 성찰 일지, 관찰 기록 등)에 대해 Braun & Clarke의 6단계 주제 분석(Thematic Analysis)을 수행한다. 기본 모드에서는 Opus 5.5, Codex gpt-6.1-terra, Gemini가 초기 코딩·주제 탐색·주제 검토를 병렬로 수행하고, Opus 5.5 의장(Chairman)이 결과를 교차 검증·병합한다. 2–4단계마다 사용자 승인 게이트를 두며, 귀납적·연역적·혼합 접근법과 선택적 다중 소스 삼각 검증, 시간적 프레임워크 분석을 지원한다. 산출물로 주제 분석 보고서, 코드북, 대표 인용문 세 가지 파일을 생성한다.
작동 방식¶
질적 데이터 파일 입력
↓
데이터 친숙화 · Opus 의장 단독
↓
초기 코딩 · 주제 탐색 · 검토
Opus · Codex · Gemini 병렬
Opus · Codex · Gemini 병렬
↓
Opus 의장 교차 검증·병합
↓
사용자 승인 게이트 · 2–4단계
↓
주제 정의·명명 · Opus 의장
↓
보고서 작성 · Opus 의장
↓
보고서 · 코드북 · 인용문 산출
↓소비
results-writer · discussion-writer 소비
입·출력¶
- 입력: 질적 데이터 Markdown 파일 1개 이상, 분석 초점 연구 질문, 접근법·데이터 유형·언어 등 옵션
- 출력: 주제 분석 보고서, 코드북, 대표 인용문 세 파일 + 주제 포화도·코딩 신뢰도·삼각 검증 커버리지 품질 점수
- 소비 역할: 마리(results-writer / discussion-writer), 아스카(research-gap-identifier), 레이(methodology-analyzer 병렬 연계)
비고¶
v2.0 기준. 기본은 Multi-LLM 교차 검증 모드로 단계 단위 호출을 통해 5–6턴 대화에 걸쳐 6단계를 완주하며, Claude Code 채팅 자체가 Human-in-the-Loop UI 역할을 한다. v1.x 시절의 별도 HTTP 서버·대시보드 탭 의존성은 제거되었다. 빠른 일괄 분석이 필요하면 단독 모드(--single)로 승인 게이트 없이 Opus 5.5이 6단계를 일괄 수행한다. 품질 임계값은 주제 포화도 ≥ 0.7, 코딩 신뢰도 ≥ 0.7, 삼각 검증 커버리지 ≥ 0.6이다.