---
task_id: task-2981
project: insuro-composite-workbench-phase1
created: 2026-08-20
---

# 맥락노트 — 인슈로 복합설계 워크벤치 Phase 1

## 결정 근거
### 왜 입력을 (문서+약관) 세트로 통일하나 = (a)안 (회장 2026-08-20 확정)
- 담보를 회사간·기존신규간 "같은 담보"로 자동 매칭하려면 axes(판별축)가 필요. axes는 **약관 정독**에서만 나옴.
- 보장분석이 증권만 받으면 axes 근거(약관)가 없어 → 비교 시 기존측 100% UNKNOWN(`engine.py:9-20` docstring, `CoverageRow`에 clause_id/axes 필드 부재).
- 둘 다 약관을 받으면 둘 다 신규축 grouping 엔진으로 axes 부착 → 자동 매칭 성립. 파이프라인도 하나로 통일(구조 단순화).

### 기각된 대안
- **(b) 별도 브리지**(증권만 받되 axes 붙이는 파이프라인): 약관 없이 담보명·지급조건 텍스트만으로 axes 추론 → 부정확·오비교 위험. 개발량도 큼. 회장이 (a) 선택(입력 부담 감수).
- **이름 매칭으로 대충 매칭**: T3가 처음부터 금지(회사마다 명칭 상이 → 오비교). 불변식 유지.

### 소비자 프레임 폐기 (미팅 교훈)
- 이 도구는 **설계사 전용**(고객 노출 X). 전환율·부끄러움·클로징 화법·공백잠금·고객 disclaimer는 폐기. "정직노출"=고객 오도 방지 아닌 **설계사 오판 방지**. (`meetings/2026-08-20-insuro-t3c3-honest-comparison.md`)

## 주의사항
- ★**게이트 봉인 불침해**: t2970/2974/2977/G-1/G-2 봉인 유지. 프론트=순수 소비자, API 스키마 계약 동결, 하류 read-only·additive.
- ★**grouping 엔진 재사용**: 보장분석 axes 부착은 `policy_grouping` 엔진을 **그대로 재사용**. name-match 판정층(`grouping_bridge.py:7-10`) 불변식 보존. 새 매칭 로직 재구현 금지.
- ★**보험료 선형은 동일 고객 전제**(연령·성별 고정)라 성립 — 회장 확정. Phase 2 가성비 계산의 근거.
- 보장분석 확장은 **기존 라이브 기능 수정**(`main.py:7021` analyze-policy)이므로 회귀 주의. content_hash/renewal 등 G 불변식과 정합.

## 관련 문서
- 비전: `../insuro-policy-analysis_260812/composite-design-workbench-vision_260820.md`
- 미팅: `../../meetings/2026-08-20-insuro-t3c3-honest-comparison.md`
- 실측(보장분석 갭): 이 세션 Explore 결과(engine.py:9-20 / CoverageRow 필드 부재 / main.py:7021 입력)