원문: https://github.com/facebook/astryx/wiki/Component-Build-Protocol · 번역 기준: 2026-09-03

처음이신가요? 전체 end-to-end 가이드는 Component Lifecycle부터 시작하세요. 이 페이지는 build 단계를 상세히 다룹니다.

build 루프는 승인된 스펙(Component Specification Protocol에서 나온)을 받아 머지된 PR을 만들어냅니다. 스펙은 계약입니다 — 스펙에서 벗어나려면 정당한 사유가 필요합니다.

Phase 1: Setup

• 스펙을 꼼꼼히 읽습니다 — 스펙이 곧 계약입니다
• 의존성을 확인합니다 (이 컴포넌트가 다른 컴포넌트를 먼저 필요로 하는가?)
• worktree와 feature 브랜치를 생성합니다
• 같은 family의 기존 컴포넌트들을 참조하여 따라야 할 패턴을 파악합니다

Phase 2: Foundation

구조적 뼈대를 먼저 만듭니다:

• 타입과 인터페이스 (스펙의 API 섹션에서 가져옴)
• 올바른 JSDoc 헤더를 갖춘 핵심 컴포넌트 파일
• 컴포넌트에 재사용 가능한 동작이 있다면 hook (예: usePopover)
• 패키지 index export에 연결

Phase 3: System Integration Check

구현 전에 컴포넌트가 시스템 인프라에 제대로 연결되는지 확인합니다:

• 모달/오버레이 패턴에 Dialog를 사용하는가? (raw portal이 아니라)
• 일관된 구조를 위해 dialog 내부에서 Layout을 사용하는가?
• 조합된 컴포넌트를 clobbering하지 않고 스타일이 실제로 적용되는가?