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

의견이 아니라 데이터로 API 디자인 논쟁을 해결하는 방법입니다. 올바른 답이 명확하지 않을 때 API 형태들 사이에서 선택하기 위한 운영 프로세스입니다.

언제 사용하는가 (When to Use This)

모든 API 결정에 arbitration이 필요한 것은 아닙니다. 다음 경우에 이 프로세스를 사용하십시오:

• 2~3개의 실행 가능한 API 형태 사이에서 선택 중이며, 어느 쪽으로든 논거를 댈 수 있을 때
• 네이밍이 명확하지 않을 때 (거의 항상 그렇습니다)
• "올바른" 답이 실제 상황에서 사람들이 어떻게 손을 뻗을지에 달려 있을 때
• 두 사람이 의견이 갈리고 둘 다 합리적인 논거를 가질 때
• Spec 리뷰에서 convention 확인만으로는 해소할 수 없는 불확실성이 드러날 때

다음에는 사용하지 마십시오:

• API Conventions가 이미 다루는 결정 (그냥 convention을 따르십시오)
• Public API를 바꾸지 않는 버그 수정이나 구현 세부 사항
• 실제로 작동하는 옵션이 하나뿐인 경우 (arbitration이 필요 없습니다 — 배포하십시오)

프로세스 (The Process)

네 개의 phase를 순서대로 진행합니다. Phase를 건너뛰지 마십시오 — 각 phase가 다음 phase에 입력을 제공합니다.

Phase 1: API 옵션 탐색 (Explore API Options)

현실적인 디자인 공간을 열거하십시오. 두 옵션에 성급하게 anchoring하지 말고 — 전체 범위를 고려하십시오: