# SCQA 보고서 포맷 템플릿
> 버전: 1.0 | 작성일: 2026-03-12 | 참조: McKinsey SCQA 프레임워크

---

## SCQA 프레임워크 구조

### S - Situation (현재 상황)
- 1-2문장으로 현재 상황 기술
- 객관적 사실 기반 (추측 금지)
- 예시: "InsuWiki v2.0이 2주 전 배포되어 일 방문자 150명 수준으로 운영 중이다."

### C - Complication (문제/변화)
- 1-2문장으로 문제 또는 변화 기술
- 왜 이것이 문제인지 명시
- 예시: "그러나 모바일 사용자의 이탈률이 72%로, 데스크톱(38%)의 2배에 달한다."

### Q - Question (핵심 질문)
- 1문장으로 핵심 질문 도출
- S와 C에서 자연스럽게 도출되는 질문
- 예시: "모바일 UX를 개선하여 이탈률을 50% 이하로 낮출 수 있는가?"

### A - Answer (답변/제안)
- 1-3문장으로 답변 또는 제안
- 구체적 행동 포함
- 예시: "모바일 전용 레이아웃 도입 + 이미지 최적화로 로딩 시간 3초 → 1.5초 단축 시 이탈률 40% 이하 달성 가능. Phase 1: 레이아웃 (3일), Phase 2: 이미지 최적화 (2일)."

## 작성 규칙

### 분량 제한
- 전체 325-475 단어
- 초과 시 핵심만 남기고 축약

### 정량적 데이터 의무
- 모든 발견(Finding)에 정량적 데이터 포인트 최소 1개 포함
- 허용: 테스트 통과율, 응답시간, 에러 수, 커버리지, 사용자 수, 전환율
- 금지: "좋다", "나쁘다", "개선됨" 등 정성적 표현만 단독 사용

### 활용 시점
- 제이회장님 보고 시 필수 포맷
- 아누(개발실장) → 제이회장님 주간/특별 보고
- 팀장 → 아누 에스컬레이션 보고

## SCQA 보고서 작성 예시

### 예시: task-100.1 완료 보고

**S**: InsuWiki 보험 비교 기능의 백엔드 API가 구현 완료되어 5개 보험사 데이터를 실시간 조회할 수 있다.

**C**: 동시 10건 이상 요청 시 응답시간이 8초로 증가하며, 타임아웃(5초) 초과로 프론트엔드에서 에러가 발생한다.

**Q**: 동시 요청 100건 기준 응답시간 2초 이내를 달성할 수 있는가?

**A**: Redis 캐싱 레이어 도입으로 반복 조회 응답시간을 8초 → 0.3초로 단축. 신규 조회도 비동기 처리로 3초 이내 달성. 예상 소요: 2일 (캐싱 1일 + 비동기 1일). pytest 12건 전체 통과, pyright 에러 0건.

(총 412단어)

## 발견 이슈 및 해결

> 버전 1.1 추가 (2026-03-15): 이슈 발견 시 자체 해결 + 보고 규칙

보고서에 이슈를 기재할 때는 아래 포맷을 사용합니다. "발견했습니다"만으로는 보고 완료가 아닙니다.

### 자체 해결 (N건)
1. **[이슈 요약]** — [해결 방법 1줄]
   - 상세: [수정 파일:라인] 또는 아래 "상세 수정 내역" 참조

### 범위 외 미해결 (N건)
1. **[이슈 요약]** — 범위 외 사유: [구체적 사유]

<details>
<summary>상세 수정 내역 (클릭하여 펼치기)</summary>

#### 이슈 1: [제목]
- 발견 경위: ...
- 원인 분석: ...
- 수정 내용: [파일:라인] 변경 전 → 변경 후
- 검증: 테스트 통과 확인

</details>

## 산출물 파일 표기 규칙

- 산출물 파일은 **개별 파일 경로를 각각 나열** 필수
- 축약형(`slide{1-5}.png`, `*.py`, `file (5개)` 등) 사용 금지
- 대시보드에서 각 파일을 클릭하여 내용 확인할 수 있어야 함
- 올바른 예시:
  - `output/slide1.png`
  - `output/slide2.png`
  - `output/slide3.png`
- 잘못된 예시:
  - `output/slide{1-3}.png (3개)`

## 모델 사용 기록

> 버전 1.3 추가 (2026-04-01): 팀원별 사용 모델 감사 기록

논리적 팀(marketing, consulting, publishing, design) 작업 시 반드시 아래 형식으로 팀원별 모델 사용 기록을 포함합니다.

### 기재 항목
- **팀원**: 팀원 이름
- **작업 내용**: 수행한 작업 설명
- **사용 모델**: sonnet 또는 haiku
- **정당성**: haiku 사용 시 사유 필수 (sonnet은 기본이므로 생략 가능)

### 예시
- 팀원: 아폴론 / 작업 내용: 블로그 초안 작성 / 사용 모델: sonnet / 정당성: -
- 팀원: 에이레네 / 작업 내용: 키워드 리스트 포맷 변환 / 사용 모델: haiku / 정당성: 단순 데이터 정리 (판단 불필요)

## 토큰 사용량 (Token Usage)

> 버전 1.2 추가 (2026-03-25): 작업별 토큰 사용량 자동 기록

작업 완료 보고서에 토큰 사용량 섹션을 포함합니다. 비용은 참고용이며 정확한 청구 금액이 아닙니다.

### 기재 항목
- **입력 토큰**: (input_tokens + cache_read + cache_creation)
- **출력 토큰**: output_tokens
- **총 토큰**: total_tokens
- **캐시 적중률**: cache_read / total_input (%)
- **예상 비용**: $X.XX (모델: claude-xxx)
- **메시지 수**: N개

### 예시
| 항목 | 값 |
|------|-----|
| 입력 토큰 | 150,000 |
| 출력 토큰 | 45,000 |
| 총 토큰 | 195,000 |
| 캐시 적중률 | 58.3% |
| 예상 비용 | $1.23 (claude-sonnet-4-6) |
| 메시지 수 | 42개 |