# Reflect 에이전트 참여: 백링크 활용 탐색 구조 재검토

> **일시**: 2026-02-09 13:33
> **참석자**: PM, UX, Frontend, Backend, QA, **Reflect 전문가 (신규 참석)**
> **안건**: 기 구현된 백링크 기능을 활용한 탐색 구조 개선 가능성 검토

---

## 📋 Reflect 전문가 브리핑

### 기 구현된 백링크 기능 현황

```typescript
// 현재 Document 스키마 (firestore.ts)
interface Document {
  outgoingLinks: string[];    // [[링크]]된 문서 제목 배열
  outgoingLinkIds: string[];  // [[링크]]된 문서 ID 배열
  searchKeywords: string[];   // 검색 키워드 (제목 기반)
}

// BacklinksPanel.tsx 기능
1. Linked Mentions   - 이 문서를 [[명시적으로]] 링크한 문서들
2. Unlinked Mentions - 제목이 언급되었지만 링크가 없는 문서들
3. "Link now" 버튼   - 클릭 한 번으로 [[백링크]] 자동 생성
```

### Reflect AI 철학 vs 카테고리 시스템

| 관점 | Reflect (Bottom-up) | 카테고리 (Top-down) |
|-----|---------------------|---------------------|
| **분류 방식** | 링크가 자연스럽게 형성 | 사전 정의된 계층 |
| **사용자 부담** | 작성 중 [[링크]]만 하면 됨 | 저장 시 카테고리 선택 필요 |
| **발견 방식** | 연결된 문서 따라가기 | 카테고리 필터링 |
| **확장성** | 무한 (그래프 구조) | 카테고리 수 제한 |

---

## 🤔 Reflect 전문가 의견

### 핵심 질문
> "카테고리를 새로 구현하기 전에, **기존 백링크 시스템을 강화**하는 것만으로 탐색 문제를 해결할 수 있지 않을까요?"

### Reflect 관점의 대안 제안

#### Option D: 백링크 중심 탐색 강화 (Reflect 스타일)

```
┌─────────────────────────────────────────────────────────────┐
│ 📊 메인 페이지 - "인기 허브 문서" 섹션 추가                  │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🔗 가장 많이 연결된 문서 (Hub Documents)                   │
│  ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐│
│  │ 📄 일배책        │ │ 📄 청약         │ │ 📄 종신보험     ││
│  │ 🔗 15개 백링크   │ │ 🔗 12개 백링크  │ │ 🔗 10개 백링크  ││
│  └─────────────────┘ └─────────────────┘ └─────────────────┘│
│                                                             │
│  📈 최근 링크된 문서 (Recent Connections)                   │
│  • 오늘: "변액연금" → "투자형상품"                          │
│  • 어제: "CI보험" → "진단특약"                              │
│                                                             │
└─────────────────────────────────────────────────────────────┘
```

#### 장점
| 항목 | 설명 |
|-----|------|
| **구현 복잡도** | 낮음 - 기존 `outgoingLinkIds` 집계만 하면 됨 |
| **사용자 교육** | 불필요 - 기존 [[링크]] 문법 그대로 |
| **자연스러운 분류** | 많이 링크된 문서 = 자연스러운 허브 |
| **Firestore 인덱스** | 추가 불필요 |

#### 구현 방안
```typescript
// 허브 문서 조회 (집계 쿼리)
// 1. Cloud Functions로 주기적 집계
// 2. 또는 별도 hubScore 필드 관리

interface Document {
  // 기존 필드...
  incomingLinkCount?: number;  // 백링크 수 (집계용)
}
```

---

## 🔄 Option C vs Option D 비교

| 비교 항목 | Option C (하이브리드) | Option D (백링크 강화) |
|----------|----------------------|----------------------|
| **구현 복잡도** | 🟠 High (2주+) | 🟢 Low (3일) |
| **스키마 변경** | `primaryCategory`, `tags[]` 추가 | `incomingLinkCount` 추가 |
| **마이그레이션** | 전체 문서 업데이트 필요 | 집계 스크립트만 실행 |
| **사용자 행동 변화** | 저장 시 카테고리 선택 | 없음 (기존 [[링크]] 사용) |
| **탐색 효과** | 명시적 분류 | 자연 발생 허브 탐색 |
| **확장성** | 카테고리 수 제한 | 무한 (그래프 구조) |
| **Reflect 철학** | ❌ Top-down 분류 | ✅ Bottom-up 발견 |

---

## 🧑‍🤝‍🧑 에이전트 토론

### PM 의견
> "Option D가 구현 비용 대비 효과가 클 수 있습니다. 단, 사용자가 [[링크]]를 적극 활용하지 않으면 허브 문서가 형성되지 않는 리스크가 있습니다."

### UX 전문가 의견
> "Option D는 '발견' 경험을 제공하지만, '특정 주제 문서 찾기' 니즈는 카테고리가 더 직관적입니다. **두 방식 병행**이 이상적입니다."

### Frontend 전문가 의견
> "Option D의 '허브 문서' 섹션은 기존 카드 UI에 쉽게 추가 가능합니다. Option C 대비 공수가 1/3 수준입니다."

### Backend 전문가 의견
> "백링크 카운트 집계는 Cloud Functions 트리거로 쉽게 구현 가능합니다. Firestore 인덱스 추가 없이 가능합니다."

### Reflect 전문가 의견
> "Reflect의 핵심은 **사용자가 분류를 의식하지 않아도** 지식이 자연스럽게 연결되는 것입니다. Option D가 이 철학에 부합합니다. 다만, 보험 도메인의 특성상 '생명보험/손해보험' 같은 대분류는 **최소화된 탭**으로 유지하는 것이 실용적입니다."

---

## 💡 합의된 최종 제안

### Option E: Reflect 하이브리드 (최소 카테고리 + 백링크 허브)

```
┌─────────────────────────────────────────────────────────────┐
│  [전체] [생명보험] [손해보험] [일반]  ← 3개 탭만 (최소화)   │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  🔗 허브 문서 (가장 많이 연결됨)                            │
│  [일배책 (15)] [청약 (12)] [종신보험 (10)]                  │
│                                                             │
│  📄 문서 리스트 (기존 카드 UI 유지)                         │
│  ...                                                        │
└─────────────────────────────────────────────────────────────┘
```

### 구현 범위

| Phase | 내용 | 공수 |
|-------|------|-----|
| 5-1 | `docType` 기반 탭 (Wiki/Daily + 보험유형) | 2일 |
| 5-2 | 허브 문서 집계 + 메인 페이지 섹션 추가 | 3일 |
| 5-3 (선택) | 그래프 뷰 시각화 | 추후 |

### 장점
1. **최소 침습**: 기존 구조 대부분 유지
2. **Reflect 철학 존중**: 명시적 분류 최소화
3. **점진적 확장**: 허브 기능 검증 후 카테고리 확대 가능
4. **사용자 부담 제로**: 카테고리 선택 강제 없음

---

## 📊 최종 옵션 비교

| 옵션 | 설명 | 복잡도 | Reflect 적합성 |
|-----|------|--------|---------------|
| C | 카테고리 8개 + 태그 | 🔴 High | ❌ Low |
| D | 백링크 허브만 | 🟢 Low | ✅ High |
| **E** | **최소 탭 + 백링크 허브** | 🟡 Medium | ✅ High |

---

## ✅ Action Items

| 담당 | 항목 | 상태 |
|-----|------|------|
| **사용자** | Option C/D/E 최종 선택 | 🔴 대기 |
| Backend | `incomingLinkCount` 필드 설계 | 🟡 선택 후 |
| Frontend | 허브 문서 섹션 UI 와이어프레임 | 🟡 선택 후 |

---

> 📋 **Reflect 전문가 최종 코멘트**:
> "백링크 기능은 이미 최고 수준으로 구현되어 있습니다. 이 자산을 최대한 활용하는 Option E를 권장합니다. 카테고리는 정말 필요할 때 추가해도 늦지 않습니다."