frontend-fundamentalslisted
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