본문으로 건너뛰기

[1.54.0] 렌더링 전략 전환 — 적응형 → 반응형 (ADR-0007, ADR-0006 대체)

· 약 2분
jangsungyu
Frontend Developer
Claude Code
AI Assistant

작업 일자: 2026-06-16 작업 브랜치: feature/1.54.0-responsive-adr

📋 작업 개요

작업 유형: 아키텍처 의사결정 전환 (대체 ADR) 담당: jsg3121 + Claude

ADR-0006에서 "순수 적응형"을 정했으나, 실제 목표가 전면 UI 개편 + 디자인 시스템 도입임이 명확해지면서 그 전제가 무너졌다. 디자인 시스템의 정석인 반응형(Responsive) 으로 전환하기로 결정했다.

🔄 무엇이 바뀌었나

ADR-0006 (대체됨)ADR-0007 (신규)
패러다임순수 적응형 (UA 분기)반응형 (CSS 브레이크포인트)
공용 컴포넌트모드별 2벌 또는 결정 트리단일 컴포넌트가 모든 폭 대응
디바이스 정보getIsMobile / useDevice점진 제거
디자인 시스템 궁합약함 (2벌 충돌)강함 (단일 반응형이 표준)

💡 전환 근거

  • DS 정합: Material/Ant/shadcn 등 표준 디자인 시스템은 반응형 단일 컴포넌트다. Button/Card에 모바일·데스크톱 버전이 따로 없다.
  • 번들/하이드레이션: 적응형은 분기에 useDevice(훅) 또는 모드별 컴포넌트가 필요해, 리스트로 반복 렌더되는 카드에서 client 강등·하이드레이션 N배 비용 발생. 반응형은 분기를 CSS로 처리해 이 비용이 없다.
  • 전제 변화: ADR-0006의 근거("현 구조 활용, 전면 재작성 회피")는 전면 개편이 전제가 된 순간 무효.

📌 이미 완료된 작업의 유효성

다음은 반응형에서도 유효하므로 유지된다(되돌리지 않음):

  • 디자인 토큰 (touch/touch-lg/2xs)
  • 죽은 미디어쿼리 제거 (#160)
  • DS Foundations 카드 (claude.ai/design)

ADR-0006이 만든 "결정 트리 / getIsMobile / isMobile 전달 규칙"만 ADR-0007로 대체된다.

⏭️ 다음 작업

  • 기획서(§4.1) 반응형 기준 후속 개정
  • 디자인 시스템 컴포넌트를 반응형 단일 컴포넌트로 구축
  • 기존 UA 분기 / useDevice를 스트랭글러 패턴으로 점진 제거

📁 변경 파일

파일변경 내용
.claude/decisions/records/ADR-0007-responsive-rendering-strategy.md반응형 전환 ADR 신규
.claude/decisions/records/ADR-0006-adaptive-rendering-strategy.md상태 '대체됨' 처리 + 안내
.claude/conventions/guides/styling.md반응형 컴포넌트 아키텍처로 개정
.claude/specs/mobile-redesign-plan.md방향 전환 안내 배너 추가