# templates_v1 → templates_v2 변경 요약

_v2 는 v1 엔트리를 **복제 + 필드 추가** 방식으로 생성. 기존 필드는 변경 없음._

## 추가된 필드

| 필드 | 타입 | 역할 |
|---|---|---|
| `content_affinity` | `{primary, secondary[], evidence{}}` | 프레임이 선호하는 콘텐츠 성격 |
| `structure_intent_v2` | `{primary, secondary[], evidence{}}` | 레이아웃의 시각 의도 (v1 의 structure_intent 와 별도 축) |
| `alternative_patterns` | `[{pattern, reason, confidence}]` | 의미적 대안 layout 목록 |
| `v2_meta` | `{generated_at, source_analysis, needs_review}` | 생성 메타 |

## 유지된 필드 (변경 없음)

- `short_id` / `template_id` / `schema_version` / `source`
- `description` / `visual_pattern` (전체)
- `slots` / `suits` / `not_suits` / `adaptation_allowed`

## 통계

### content_affinity primary 분포

| primary | 프레임 수 |
|---|---:|
| `concept_comparison` | 9 |
| `capability_requirements` | 8 |
| `process_steps` | 4 |
| `concept_definition` | 4 |
| `persona_benefit` | 3 |
| `before_after_change` | 1 |
| `policy_requirements` | 1 |
| `interrelation` | 1 |
| `goal_axes` | 1 |

### structure_intent (v2) primary 분포

| primary | 프레임 수 |
|---|---:|
| `binary_compare` | 10 |
| `sequence` | 8 |
| `singleton_emphasis` | 4 |
| `matrix_coverage` | 3 |
| `persona_mapping` | 2 |
| `state_transition` | 2 |
| `multi_parallel` | 1 |
| `cycle_interrelation` | 1 |
| `hierarchy` | 1 |

### alternative_patterns 수

- 평균 대안 수: 3.8
- 대안 0개 프레임: 6
- 대안 5개 프레임: 19

## v1 과의 관계

- `structure_ontology.yaml` 원본 **유지** — v2 는 `structure_ontology_v2.yaml` 별도 파일.
- v2 매칭 로직 (pipeline_08_v3_structure_rerank.py 재구현) 에서 `_COMPAT` 대신 `content_affinity + structure_intent_v2 + alternative_patterns` 조합 사용 예정.
- v2 최종 승인 전까지 V3 재구현 보류 — 사용자 검토 (priority 5) 후 확정.