5 skill → index service 진화 경로

⚠ 부분 SUPERSEDED (2026-06, D-index-45/46/47). 본 페이지는 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 (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.

skill ownership (ic/ingest/pmc 이전) → D-index-47 가 universal-base mirror + --attest + vertical-gate 로 실구현·배포. skill-ownership 참조.

신규 본질: relational 진화에 더해 artifact-first judgment layer (D-index-45) — 가정·calibration·comp·base_rate 를 typed fact 로 적재 (당시 계획에 없던 layer). /services/index § judgment.

아래는 의도·맥락 기록으로 보존. 현행 사실은 위 링크.

핵심 원칙

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 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 (5th mode FINALIZE 평행 track) + D-index-13 (atomic propose_deal_closure + idempotency key). 서버 측 contract = /services/index/skill-integration § 2.

현재 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-진화.

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)

현재: 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) 로 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) 가 모든 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 의 점진 migration 패턴과 정합. 신규 fact 는 처음부터 index typed (markdown append 안 함).

5 skill → index service 진화 경로

핵심 원칙

5 skill 매핑

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

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

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

현재 ic skill 산출

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

sanity check 흡수

호환 보존

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

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

ic skill 의 detailed changes

폴더 규약 변경 (D-index-6)

Rule 추가

propose flow 통합

기존 markdown KB 의 점진 migration

관련 페이지

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

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

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

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

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

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