Files
clean-architecture-frontend…/docs/runbooks/FE-RB-003.md
T
DongHyeonka 11530b1adf docs: runbook·보안·스타일·접근성·계약·테스트 문서와 모듈 README를 한국어로 옮긴다
문제: docs/runbooks, docs/security, docs/styling/design-tokens.md,
docs/accessibility, docs/contracts, docs/testing/taxonomy.md와
src/adapters/browser-transfer/image-cdn/README.md는 본문이 영어다.
PRODUCT.md는 「~합니다」 체라 한 문서 안 문체 규칙(「~한다」)과 다르다.

고른 방법: 뜻을 바꾸지 않고 옮긴다. runbook 제목의 ID와 오류 code,
기록 양식의 영어 키(`Status:`, `M1 Keyboard:` 등, 코드 블록 안)는 그대로
둔다. PRODUCT.md는 디자인 도구가 읽는 제목(`## Users` 등)을 두고 문장
끝만 바꾼다.

위험: 이 커밋으로 문서 검사의 예외 목록이 빈다. 앞으로 영어 문서나 높임
문체를 더하면 verify:documentation이 실패한다.

검증: 백틱 span·링크 대상·코드 블록을 옮기기 전과 python으로 비교해 같다.
문서 검사 여섯이 모두 0건이고 예외 목록과 FROZEN이 비었다.
2026-11-08 21:57:47 +09:00

820 B

FE-RB-003 — 백엔드 API 품질 저하

다음 중 하나면 시작한다. 더 재시도하지 않는(terminal) 네트워크·시간 초과·5xx 실패가 최근 5분 이동 구간(rolling)의 기준치를 넘는다. 또는 SCHEMA_MISMATCH가 한 번 난다. 클라이언트 재시도 상한을 늘리지 않는다. schema 불일치는 재시도하지 않는다. 멱등 키가 없는 mutation(unkeyed mutation)은 절대 재시도하지 않는다. API client owner에서 백엔드 운영으로, 그다음 release 호환성 담당으로 올린다(escalate). 첫 분류의 계획 목표 시간은 10분이다.

다음이 모두 맞을 때만 닫는다. 실패율이 평소 수준(baseline)으로 돌아온다. 재시도 증폭이 없다. 핵심 읽기·쓰기 smoke가 통과한다. schema fixture가 통과한다.