← ClaudeAtlas

frontend-fundamentalslisted

토스 frontend-fundamentals 기반 프론트엔드 코드 품질 가이드. React 컴포넌트/훅을 작성·수정·리팩터링하거나 코드 리뷰할 때 가독성·예측가능성·응집도·결합도·접근성 원칙을 적용한다. 성능/번들은 vercel-react-best-practices, 컴포넌트 합성/확장성은 vercel-composition-patterns, Next.js 최신 API는 Context7로 라우팅한다. "컴포넌트 작성", "훅 작성", "리팩터링", "코드 리뷰", "가독성" 등에서 활성화.
S-jooyoung/oh-my-joy · ★ 1 · Web & Frontend · score 70
Install: claude install-skill S-jooyoung/oh-my-joy
# Frontend Fundamentals (통합 품질 가이드) 토스 [frontend-fundamentals](https://github.com/toss/frontend-fundamentals)의 "변경하기 쉬운 코드" 원칙을 Next.js / React 스택에 맞춰 정리한 가이드. **확장성 있고, 접근성 좋고, 예측 가능한 코드**를 목표로 한다. ## 핵심 원칙: 좋은 코드의 4가지 기준 | 기준 | 한 줄 정의 | 상세 | | ------------------------------ | -------------------------------------- | ------------------------------------------------------------ | | **가독성**(Readability) | 코드가 한 번에 담는 맥락을 줄인다 | [references/readability.md](references/readability.md) | | **예측가능성**(Predictability) | 이름만 보고 동작을 예측할 수 있다 | [references/predictability.md](references/predictability.md) | | **응집도**(Cohesion) | 함께 바뀌는 코드는 함께 둔다 | [references/cohesion.md](references/cohesion.md) | | **결합도**(Coupling) | 모듈 간 의존을 낮춰 변경 파급을 줄인다 | [references/coupling.md](references/coupling.md) | > **핵심 트레이드오프**: 네 기준을 한 번에 모두 충족하기는 어렵다. 지금 코드가 **장기적으로 수정하기 쉬워지려면** 어떤 가치를 우선할지 상황에 따라 판단한다. (예: 응집도를 높이려 추상화하면 결합도가 올라갈 수 있다.) 추가 영역: - **접근성(a11y)** → [references/a11y.md](references/a11y.md) — WCAG 2.2 성공 기준 병기(시맨틱·alt·대비·포커스·모션·터치 타깃·폼 에러) - **경계(Server/Client·에러·테스트 가능성)** → [references/boundaries.md](references/boundaries.md) — `'use client'`를 어디에 두는가가 번들과 렌더 모델을 함께 결정한다 - **번들/디버그** → [references/bundling-debug.md](references/bundling-debug.md) - **프로젝트 acceptance 축(메커니즘)** → [references/fe-acceptance