FRONTEND.md

이 파일은 안정적인 프론트엔드 기대치를 정의하여 에이전트(agent)가 예측 불가능하게 UI 패턴을 발명하지 않도록 합니다.

프론트엔드 정책 문서는 에이전트가 UI 작업 중 임의의 패턴을 선택하지 않도록, 디자인 시스템 규칙·접근성(accessibility) 기준·검증 방식을 미리 명시하는 역할을 합니다.

UI 원칙

• 참신함보다 명료함을 우선시한다.
• 상호작용 흐름을 발견하기 쉽고 재시작 가능하게 유지한다.
• 일회성 변형보다 소수의 재사용 가능한 컴포넌트를 선호한다.
• 접근성 검사는 마무리 작업이 아닌 일반적인 검증의 일부이다.

가드레일(Guardrail)

• 디자인 시스템 또는 컴포넌트 라이브러리를 docs/references/에 문서화한다.
• 주요 사용자 대면 상태를 기록한다: 빈 상태, 로딩, 성공, 오류, 재시도.
• 복사 문구, 키보드 동작, 시각적 계층 구조를 흐름 전반에 걸쳐 일관되게 유지한다.
• UI 버그를 수정할 때 일치하는 유효성 검사 단계를 추가하거나 업데이트한다.

검증 기대치

• 중요한 사용자 여정에 대한 증거를 캡처한다.
• 관련 계획에 브라우저 또는 런타임 유효성 검사(validation) 단계를 기록한다.
• 시각적 회귀(regression)가 잦으면 스크린샷 또는 DOM 검사를 표준화한다.