14장 개발자에게 의도가 전달되는 명세를 쓴다

좋은 핸드오프는 픽셀 좌표만 넘기지 않는다. 화면의 이유와 상태 전이를 함께 준다.

컴포넌트: ApprovalActions
전제: brief와 proposal이 화면에 표시됨
기본: 승인 / 자동화 미리보기
로딩: 클릭한 버튼만 잠그고 진행 문구 표시
성공: 영수증 ID와 만료 시각을 live region에 표시
실패: 사유별 복구 행동 제공
불변식: preview는 외부 시스템을 변경하지 않음
접근성: 논리적 탭 순서, visible focus, 상태를 색만으로 표현 금지
분석 이벤트: preview_opened, approval_created, approval_failed(reason)

Figma나 이미지에서 보이지 않는 내용이 더 중요할 때가 많다. 긴 문자열의 줄바꿈, 빈 상태, 422·403·500, 느린 네트워크, 모바일 순서, 권한별 차이를 명시한다. 구현 뒤에는 실제 브라우저에서 함께 확인한다.