DS Primitive 배포방식 논쟁

질문

인력 부족으로 디자인시스템을 Primitive 단계까지만 만들어 우선 배포하기로 했다. 개발팀에 핸드오프할 때 순수 변수 라이브러리/json 파일만 넘기면 되는지, Code Syntax(CSS 변수 규칙)까지 포함해서 넘겨야 하는지 — 사수는 "왜 코드까지 짜서 줘야 하냐"는 입장이라 의견이 갈린다.

답변

Figma Variables에 Primitive를 정리하고 이름 규칙만 개발팀과 맞추면(변수명은 디자이너가 이해하기 쉽게, 실제 코드에서 쓰는 이름은 Code Syntax에 매핑) 개발팀은 CSS Variables나 공통 theme 파일로 관리할 수 있다. 최종 전달물은 '네이밍 규칙 문서 + Variables + Code Syntax 포함 Figma 파일' 정도면 충분하다는 답변을 받았다. Code Syntax 매핑 자체는 오래 걸리는 작업이 아니니 진행하되 "디자이너가 코드 규칙을 짜는 게 아니라 개발팀이 넘겨준 값을 피그마에 매핑만 하는 것"이라고 설득해보라는 조언과, Code Syntax의 최종 결정권은 개발팀에 있어야 하며 디자인팀 내부에서만 정하면 결국 단순 UI Kit으로 남을 뿐이라는 반론도 있었다. 이미 구현된 제품을 마이그레이션하는 상황이라면 Code Syntax는 프론트 개발자에게 맡기고 디자인팀은 매핑만 담당하는 게 안전하다(참고 플러그인: Token Studio for Figma). 초기 매핑은 개발팀에서 csv로 값을 받아 피그마 에이전트로 일괄 매핑하는 방법이 유용하다는 팁도 공유됐다.