요청하신 개념 **‘디자인 및 코드 명명 일치화’**에 대한 위키 노트를 모든 작성 원칙과 템플릿 구조 및 사용자 규칙(No-Ask Policy)에 맞춰 자율적으로 생성을 완료하였습니다.
작성된 위키 노트 정보
- 노트 파일 경로:
llm-wiki/wiki/디자인 및 코드 명명 일치화.md - 구분(type):
workflow - 태그(tags):
llm,agent,design-system,figma,code,workflow,naming-convention
주요 포함 내용 요약
- 한 줄 정의 및 핵심 요지:
- 디자이너와 개발자 간 ‘명명 불일치(Naming divergence)‘로 인해 발생하는 번역 비용 및 전달(Handoff) 오류 제거.
- 단일 명명 규칙 수립을 통한 디자인-개발 공동 소유권 및 파트너십 형성.
- 상세 기술 내용:
- 명명 불일치가 초래하는 디자인 검토 지연, 상태 오작동 버그, 조직적 파편화 문제 분석.
- 슬래시 기반 계층 구조(
Component / Type / Variant)와 코드 프롭(Prop)/타입 정의 간 1:1 매핑 원칙 정리. - 상위 20대 컴포넌트 전수 조사 및 표준 명명 규칙 합의 4단계 워크플로우 명시.
- 구체적인 코드 예시 및 활용 시나리오:
- TypeScript/React 인터페이스(
ButtonProps)와 Figma 컴포넌트 변형 속성(Variant Properties) 간의 1:1 명명 매핑 코드/설정 구조 예시 포함. - LLM AI 에이전트(예: Antigravity Agent, Claude Code 등)가 Figma API 파싱 후 추가 프롬프트 매핑 없이 즉시 정교한 TSX 코드 컴포넌트를 생성하는 자동화 Handoff 시나리오 제시.
- TypeScript/React 인터페이스(
- 출처 표기 및 관련 노트 연동:
- 수치 및 소스 언급 문장에
(raw/10 Figma Component Structures Used by the World’s Best Design Teams.md)표기 적용. [[슬래시 기반 명명 규칙]],[[토큰 우선 원칙]],[[디자인 시스템 우선 접근 방식]],[[베이스 컴포넌트 및 배리언트 아키텍처]]등 기존 지식 개념 4개 이상 상호 연동 완료.
- 수치 및 소스 언급 문장에