문서추출

Figma에서 DESIGN.md 추출 후 바로 적용 가능한 흐름 정리

2026-05-06

Figma 디자인에서 DESIGN.md 파일을 추출하고, 바로 디자인 시스템 작업에 연결하는 과정을 정리할 작업일지입니다.

작업 목표

Figma에 있는 디자인 시스템 기준을 DESIGN.md 형태로 추출하고, 추출된 문서를 바로 저장소에 반영할 수 있는 흐름을 정리합니다.

핵심은 “디자인 파일을 설명 문서로 옮기는 것”이 아니라, 개발자가 곧바로 받아서 실제 디자인 시스템 소스 오브 트루스로 쓸 수 있게 만드는 것입니다.

정리할 과정

  1. Figma에서 어떤 토큰과 컴포넌트 정보를 기준으로 뽑을지 정리합니다.
  2. 그 정보를 DESIGN.md 스키마에 맞게 변환하는 규칙을 정리합니다.
  3. 추출된 문서를 저장소에 반영하는 경로를 정리합니다.
  4. 문서 변경 후 어떤 lint와 검증을 거칠지 정리합니다.

확인할 기준

  • DESIGN.md가 실제 구현 기준 문서로 바로 사용 가능한가
  • 컴포넌트와 토큰 이름이 Figma와 저장소에서 일관된가
  • 수동 복사 없이도 반복 가능한 흐름으로 설명되는가

다음 작업 메모

  • Figma 토큰과 컴포넌트 매핑 기준 먼저 적기
  • DESIGN.md 최소 생성 예시 넣기
  • 저장소 반영 후 검증 순서까지 붙이기