<!-- canonical: https://docs.axelabs.ai/services/index/skill-evolution -->
<!-- source: content/services/index/skill-evolution.mdx -->

---
title: 5 skill 진화 경로
description: ic / due-diligence / vc-deal-sourcing / portfolio-management / investor-relations 5 skill 의 service 진화 경로 + --push-to-index flow + 호환 보존.
---

# 5 skill → index service 진화 경로

> **⚠ 부분 SUPERSEDED (2026-06, [D-index-45](/ops/decisions)/[46](/ops/decisions)/[47](/ops/decisions)).** 본 페이지는 design-era (D-index-1~10 시기) 의 진화 계획이다. **핵심 원칙 (skill = workflow, index = persistence) 은 유효**하나, 아래 구체 mechanism 중 다음은 실구현에서 달라졌다:
>
> - **per-tool propose 이름** (`record_fund_investment` · `propose_dd_finding` · `record_ic_decision` · `record_kpi_snapshot` 등) → 실제는 **atomic [`propose_deal_closure`](/services/index/schema-catalog)** (deal+fund+model 1-tx) + **`propose_artifacts_from_ingest`** (dataroom sidecar → artifact, `_provenance` stamp + drift gate). dd_finding/ic_decision/portfolio_kpi/risk_alert/valuation 은 아직 **phase-1 stub** (미적재) — [schema-catalog § stubs](/services/index/schema-catalog#6-phase-1-stubs-status-phase1_backlog).
> - **skill ownership** (ic/ingest/pmc 이전) → [D-index-47](/ops/decisions) 가 universal-base mirror + `--attest` + vertical-gate 로 **실구현·배포**. [skill-ownership](/services/index/skill-ownership) 참조.
> - **신규 본질**: relational 진화에 더해 **artifact-first judgment layer** ([D-index-45](/ops/decisions)) — 가정·calibration·comp·base_rate 를 typed fact 로 적재 (당시 계획에 없던 layer). [/services/index § judgment](/services/index#artifact-first-judgment-layer-d-index-45).
>
> 아래는 의도·맥락 기록으로 보존. 현행 사실은 위 링크.

## 핵심 원칙

**skill = workflow (LLM-heavy authoring), index = persistence (typed fact).**

skill 자체는 사라지지 않음 — IC memo 19-agent orchestration / DD 체크리스트 prompt / 포트폴리오 KPI 가이드 같은 LLM 작업 본질은 그대로. 진화하는 것은 **산출물의 보존 방식** 뿐:

```
이전 흐름:
  /ic 실행 → dataroom/ + ic/finance/ + ic/memo/ → PDF/Teams reply
    → 다음 deal 도 markdown grep + LLM 재추출 (휘발)

진화 후:
  /ic 실행 → dataroom/ + ic/finance/ + ic/memo/ → PDF/Teams reply
    + /ic --push-to-index → typed fact 부분만 index 로 propose
      → ctx review confirm → index DB 적재 (audit trail 시작)
        → 다음 deal 의 cross-deal benchmark / time-travel query / fund 별 IRR 자연
```

기존 산출물 (markdown / xlsx / yaml) 은 OneDrive 그대로 보존 — citation source 로 영구.

## 5 skill 매핑

### 1. `vc-deal-sourcing` → `index.deal` + `deal_stage_history`

| skill 현재 | service 진화 |
|---|---|
| pipeline 표 markdown 으로 관리 (Identified / Contacted / Screening / DD / IC / Closed) | `deal_stage_history` 테이블 (bitemporal — stage 진입 시점 + 빠진 시점 audit) |
| 타겟 기준 markdown (Must-Have / Nice-to-Have) | `sector_framework` artifact (RESOURCE — vc-deal-sourcing skill `references/` 정합) |
| 스코어링 5 dimension | `index.deal.attributes.scoring` JSONB (확장 가능) |
| Source channel 분류 | `index.deal.source_channel` enum |

진화 후 가능:
- "지난 6개월 referral 채널 deal 의 IC 통과율?" SQL 한 줄
- "특정 sector 의 deal pipeline 전체 + 현재 stage" cross-fund dashboard

skill 자체 변화: vc-deal-sourcing skill 의 `references/` 가 sector_framework artifact 로 점진 migration ([D-bp-artifact-5](/ops/decisions) markdown → artifact 패턴 정합).

### 2. `due-diligence` → `index.dd_finding` + citation chain

| skill 현재 | service 진화 |
|---|---|
| DD 체크리스트 markdown (재무/시장/기술/팀/법무) | `index.dd_finding` row 단위 — kind enum + severity + citation chain |
| 분석 프레임워크 (SWOT/Porter's 5/Unit Economics/Cohort) | sector_framework artifact 의 reusable RESOURCE |
| finding markdown 본문 (출처 표기 의무 X) | citation 6-kind 강제 (onedrive / index.* / external.web / ...) |

진화 후 가능:
- "지난 12개월 모든 deal 의 'team risk' severity=blocker finding" cross-deal query
- "동일 sector 의 historical DD finding pattern" archive search
- finding 한 줄마다 OneDrive PDF page citation trace 100%

skill 자체 변화: DD 체크리스트 prompt 가 `propose_dd_finding` MCP tool call 로 매핑. 사용자가 confirm 하면 typed fact 적재.

### 3. `ic` skill 18-section memo → `index.ic_decision` + `--push-to-index` mode

가장 큰 진화. ic skill 의 19-agent orchestration 은 그대로 (LLM heavy 본질 유지), **산출물의 typed fact 부분만 propose**. 구체적 mode 정의 = [D-index-11](/ops/decisions) (5th mode FINALIZE 평행 track) + [D-index-13](/ops/decisions) (atomic `propose_deal_closure` + idempotency key). 서버 측 contract = [/services/index/skill-integration § 2](/services/index/skill-integration#2-ic-skill-통합--5th-mode---push-to-index).

#### 현재 ic skill 산출

```
Prj_<DEAL>/
├── dataroom/                       (회사 자료 — READ-ONLY)
├── ic/
│   ├── research/                   (15 sub-folder)
│   ├── proponent/v{N}.md
│   ├── premortem/v{N}.md
│   ├── premortem_critic/v{N}.md
│   ├── devils/v{N}.md
│   ├── qa/v{N}.md
│   ├── finance/
│   │   ├── 3fs_{base,upside,mgmt,downside}/v{N}.xlsx
│   │   ├── scenario_deltas/v{N}.yaml
│   │   ├── exit_matrix/v{N}.yaml
│   │   ├── irr_analysis/v{N}.xlsx
│   │   └── irr_cell_ref/v{N}.xlsx
│   ├── memo/v{N}.md                (18-section)
│   ├── deliverables/v{N}.pdf
│   └── _recap/                     (postmortem stub)
└── ctx/MEMORY.md                   (session knowledge)
```

#### `--push-to-index` 모드 (신규)

ic skill 의 신규 mode (`/ic --finalize` 과 평행):

```
/ic --push-to-index
  ↓
1. `ic/finance/*.xlsx` + `ic/finance/*.yaml` → financial_model + driver/scenario/output 추출
   - `ingest_financial_model_xlsx(deal_id, ic/finance/3fs_base/v{N}.xlsx)` × 4 scenario
   - scenario_deltas.yaml 직접 파싱 → driver_value override
   - exit_matrix.yaml 직접 파싱 → exit_matrix_leaf row
2. ic/memo/v{N}.md 의 §1.4 투자 논거, §14 risk 표, §15 postmortem cadence → dd_finding / risk_alert / postmortem stub propose
3. ic/memo/v{N}.md 자체 → Blueprint artifact (memo body OneDrive citation 유지) + ic_decision row
4. ic/finance/exit_matrix/v{N}.yaml 의 meta (axe_investment, ownership_pct_fd) → fund_investment row
   (강수훈 회신/IC pack 기반 — 1호+2호 split 확인 후 row 2개)
5. 모든 propose 가 ctx review queue 경유 → 사용자 confirm/edit/reject
6. confirmed → typed fact 적재 + audit_event 'confirm' 기록
```

이 후 다음 deal 의 IC 작성 시:
- `compare_drivers_across_deals('gross_margin_terminal', portfolio_deals, ['base'])` — 시장 표준 자동 benchmark
- `query_irr(deal_id={유사 deal})` — historical IRR pattern 참조
- ic skill 의 §11 "포트폴리오 정합성" 자동 채우기

#### sanity check 흡수

ic skill 의 4 Python script (`xlsx_integrity.py` / `check_arithmetic.py` / `check_exit_matrix.py` / `citation_trace.py`) 가 index 의 `validate_financial_model` MCP tool + DB trigger 로 흡수 → Phase 1 후 deprecate.

#### 호환 보존

ic skill 자체는 (a) workspace 가 index DB 부재인 환경에서도 작동 (markdown only mode), (b) `--push-to-index` mode 는 opt-in. Phase 0 launch 후 점진 도입.

상세 = [/services/index/financial-model § ic-skill-진화](/services/index/financial-model).

### 4. `portfolio-management` → `index.portfolio_kpi` time series + `risk_alert`

| skill 현재 | service 진화 |
|---|---|
| 핵심 KPI 표 markdown (SaaS / 커머스) | `index.portfolio_kpi` row 단위 — kind enum + asof_date time series |
| 리스크 지표 (조기 경보) | `index.risk_alert` (severity red/yellow + kind enum) |
| 엑싯 시그널 체크리스트 (IPO / M&A / Secondary) | `index.exit_signal` (Phase 2) |
| 분기 board pack 정리 | `record_kpi_snapshot(deal_id, kind, value, asof_date, source_citation)` MCP tool — board pack PDF OneDrive page cite |

진화 후 가능:
- portfolio time series 자동 dashboard (Blueprint UI Phase 1+)
- "지난 12개월 portfolio 평균 churn vs sector benchmark" 한 줄 query
- runway < 6개월 deal 자동 red alert (분기 KPI 입력 시 trigger)

skill 자체 변화: portfolio-management skill 의 KPI 표가 `record_kpi_snapshot` MCP tool prompt 로 진화. 분기 BOD pack ingest 시 LLM 이 KPI 자동 추출 → ctx review.

### 5. `investor-relations` → `index.lp_comm` audit + 펀드 성과 자동

| skill 현재 | service 진화 |
|---|---|
| LP 보고 구조 markdown | `index.lp_comm` (kind / subject / sent_at / body_sha256) — hive `payslip_send_log` 패턴 |
| 펀드 성과 지표 | `index.valuation` + frame `commitment_ledger` 결합 자동 산출 |
| IR 커뮤니케이션 가이드 | sector_framework artifact (RESOURCE) |

진화 후 가능:
- "LP X 와 마지막 comm 후 변한 portfolio fact" — cross IR × Portfolio query
- 분기 NAV report 자동 (frame 의 commitment_ledger × index 의 valuation_snapshot)
- LP audit 시 모든 숫자가 DB cell trace + citation chain

skill 자체 변화: investor-relations skill 의 보고 템플릿이 `index.lp_comm` propose 와 결합 — 발송 시점에 body_sha256 자동 기록.

## ic skill 의 detailed changes

`/Users/axe/blueprint/.claude/skills/ic/SKILL.md` 의 변경 (Phase 1 PR):

### 폴더 규약 변경 ([D-index-6](/ops/decisions))

- 현재: workspace.name = deal name (Prj_Iippo / Prj_Sentry / Prj_Canopy)
- 진화: workspace 는 sector / pipeline / fund container, deal 은 deal_code tag

deal 폴더 → workspace 안의 sub-folder 로 재구성:

```
workspace_name/                      ← sector / pipeline 단위
├── deal/
│   ├── Iippo/
│   │   ├── dataroom/                ← OneDrive
│   │   ├── ic/
│   │   │   ├── finance/
│   │   │   ├── memo/v{N}.md
│   │   │   └── ...
│   │   └── ctx/                     ← deal-level
│   ├── Sentry/
│   │   └── ...
│   └── Canopy/
│       └── ...
└── ctx/MEMORY.md                    ← workspace-level (sector knowledge)
```

이미 진행 중인 deal 의 마이그레이션은 dispatch link mode ([D-bp-artifact-6](/ops/decisions)) 로 cover — 기존 workspace.name=Prj_Iippo 가 새 workspace 안의 deal/Iippo/ 로 link.

### Rule 추가

ic skill SKILL.md 에 신규 rule:

> **25. Push to index (opt-in)**: `/ic --push-to-index` 모드 활성 시, gate_memo.sh PASS 후 자동으로 (a) `ingest_financial_model_xlsx` × 4 scenario xlsx, (b) `record_fund_investment` (memo §1.3 의 fund split parse), (c) `record_ic_decision` (§17 partner verbatim 의 voting record extract), (d) `propose_dd_finding` (§14 risk 표 row 단위), (e) `record_kpi_snapshot` (§1.6 IRR + §13 financial)  를 index propose. ctx review queue 등재 후 사용자 confirm 까지 ic skill 자체는 markdown / xlsx 산출물 영구 보존 (citation source).

## propose flow 통합

5 skill 의 진화는 모두 같은 패턴:

```
skill workflow 실행 (LLM heavy)
  ↓ 산출물: markdown + xlsx + yaml (OneDrive 영구)
--push-to-index 모드 (opt-in)
  ↓ typed fact 추출 (구조화된 부분만)
ctx review queue 등재
  ↓ 사용자 confirm / edit / reject
index DB 적재 + artifact_event 'confirm'
  ↓
cross-deal query / time-travel / fund 별 IRR / portfolio benchmark 가능
```

ctx skill ([D-bp-artifact-5](/ops/decisions)) 가 모든 propose 의 curation interface — 일관된 review UX.

## 기존 markdown KB 의 점진 migration

각 deal 의 `ctx/MEMORY.md` + `project_*.md` 도 점진적으로 index typed fact 로 migration:

```
ctx/project_iippo_status.md
  ↓ LLM extract — "현재 stage / committed / risk / next milestone" 추출
proposed index.deal + index.risk_alert + index.dd_finding rows
  ↓ ctx review confirm
  ↓
ctx/project_iippo_status.md 의 해당 entry 에 archive 마커 ([D-bp-artifact-5](/ops/decisions) `migrated:` 패턴) 삽입
```

[D-bp-artifact-5](/ops/decisions) 의 점진 migration 패턴과 정합. 신규 fact 는 처음부터 index typed (markdown append 안 함).

## 관련 페이지

- [/services/index](/services/index) — 서비스 main
- [/services/index/financial-model](/services/index/financial-model) — 6-table SoT + ic skill 의 xlsx 진화
- [/services/index/schema-catalog](/services/index/schema-catalog) — 14 schema spec
- [/ops/decisions D-index-6](/ops/decisions) — Workspace ↔ deal N:1 + ic skill 폴더 진화
- [/ops/decisions D-index-8](/ops/decisions) — 5 skill 진화 + `--push-to-index` mode
- [/architecture/artifacts § Markdown → artifact 점진 migration](/architecture/artifacts#markdown--artifact-점진-migration-ai-assisted) — 일반 패턴