Reference Documents

Frontmatter 규칙

모든 reference 문서는 다음 frontmatter를 포함해야 합니다:

필드	타입	설명
title	string	한글 제목
status	enum	active, approved, archived, superseded, draft, partially-adopted-into-<target>
track 또는 phase	enum	아래 enum 참조. 캠페인 단위 문서는 track 대신 phase를 사용
summary	string	한줄 요약 (50자 내외)
updated	date	YYYY-MM-DD

Track / Phase enum

단일 규칙을 유지하기 위해 repo 전체에서 사용하는 track letter / phase 이름은 다음으로 고정한다. 신규 값을 추가할 때는 본 표를 함께 갱신할 것.

값	범주	의미
a	track	논문 작성
b	track	실험 (FL, KD 등)
c	track	다음 방향 / 문헌 조사
d	track	완료·이관된 실험 라인 (예: FeDPM codebook MVP)
e	track	VQ codebook 연구 아카이브 (v3까지)
track-f	phase	Decoder capacity swap (v8 실패 후속)
v7 / v8 / v9	phase	버전 단위 캠페인 (clean-restart, rescue, redesign 등)

캠페인 문서(v7/v8/v9, track-f)는 frontmatter에 phase: <값>을 사용하고, 일반 reference·track 문서는 track: <letter>를 사용한다. project_state/README.md는 두 필드를 합쳐 하나의 열(Track / Phase)로 노출한다.

카테고리

kd/ — Knowledge Distillation 방법론

KD 아키텍처, 방법론 비교, 실험 설계 문서

energy/ — 에너지 시스템

ESS, Energy Community, 피크 정의, 경제성 분석

metrics/ — 평가 지표 및 참고

스케일 불변 지표, 핵심 수치, 참고문헌