Vercel의 57개 React 규칙이 보여주는 품질 강제의 방법

Vercel이 공개한 57개 React 성능 규칙의 핵심은, “효율적으로 작성하라” 같은 추상적 원칙이 아니라 기계가 확인할 수 있는 수준의 구체적 규칙으로 정리됐다는 점이다. 예를 들어 lucide-react의 barrel import를 피하라, 독립적인 await는 Promise.all로 병렬화하라, 50KB가 넘는 컴포넌트는 dynamic import를 쓰라처럼 위반 여부를 코드만 보고 판단할 수 있게 만들었다.

대부분의 팀은 이런 표준을 위키에 적거나 코딩 agent의 system prompt에 넣는다. 하지만 둘 다 사람의 기억에 의존하기 때문에, 위키는 읽히지 않고 prompt는 도구를 쓰는 사람에게만 적용된다. 그 결과 리뷰 화면에는 문제 없어 보여도 같은 실수가 반복되고, 표준은 사실상 문서 조언으로 끝난다.

해결책은 표준을 standards-as-code로 바꾸는 것이다. 체크를 저장소 안의 markdown 파일로 두고, PR마다 자동으로 실행되게 만들면 누가 열었는지와 상관없이 같은 기준이 적용된다. Continue에서는 이런 체크가 full AI agent로 동작해 파일을 읽고 명령을 실행한 뒤, 수정 제안이 붙은 상태로 GitHub status check에 반영된다.

도입은 한 번에 57개를 올리는 방식이 아니라 CRITICAL부터 시작하는 것이 좋다. 실제 사용자 피해로 이어지는 규칙부터 몇 스프린트 동안 돌려 보고, 오탐이 적고 유용성이 확인되면 HIGH, 그다음 MEDIUM으로 확장해야 한다.

핵심 변화는 단순하다.

• 문서에 적힌 표준이 아니라, 매 PR마다 실행되는 검사로 바뀐다.
• 리뷰어의 기억과 주의력에 기대지 않아도 된다.
• 새로 합류한 개발자도 senior engineer와 같은 기준을 적용받는다.

결국 Vercel의 규칙에서 배울 점은 지식의 축적이 아니라 집행 방식이다. 적는 것만으로는 부족하고, PR마다 자동으로 실행될 때 비로소 표준이 팀의 동작 방식이 된다.