surface, text-secondary, border-soft처럼 역할로 이름을 붙이고, 실제 색 값은 tokens 폴더에만 둡니다. Palette로 대비를 확인한 뒤 값을 확정했습니다.

색 값과 쓰임을 따로 이름 짓기#

컴포넌트 안에 연한 회색 값을 직접 넣었더니 배경을 바꿀 때마다 여러 파일을 수정했습니다. 같은 회색이어도 본문, 보조 문구, 테두리의 역할이 달랐습니다.

원시 팔레트

색 자체를 보관합니다. 실제 색 값은 style/tokens 안에서 관리합니다.

의미 토큰

text-secondary나 border-soft처럼 역할을 나타냅니다. 컴포넌트는 이 이름을 사용합니다.

캡션의 역할을 코드에 남기기#

style/article.css
.article-caption {  color: var(--text-secondary);  border-top: 1px solid var(--border-soft);  background: var(--surface);}

색이 우연히 같다는 이유만으로 역할까지 하나로 묶지 않습니다. 본문을 흐리게 하지 않고 테두리만 낮추고 싶을 때 두 이름이 필요합니다.

토큰을 바꾸고 나서는 팔레트 표보다 실제 문단·링크·버튼에서 확인합니다. 작은 보조 문구가 읽히는지, 선택과 오류가 색만으로 구분되지는 않는지를 함께 봅니다.