공식 문서 예제를 프로젝트 코드로 옮길 때 확인할 경계

문서 문맥 확인

예제가 어느 라우터와 파일 구조를 기준으로 하는지 먼저 확인한다.

context

서버 전용 API, 클라이언트 훅, Edge 제한이 프로젝트 위치와 맞는지 본다.

runtime

문서 기본 예제의 fetch cache와 실제 최신성 요구가 같은지 조정한다.

data policy

타입, env, 오류 처리, 테스트, 배포 로그까지 프로젝트 규칙에 맞게 감싼다.

adapt

Copy 위험

문서 예제는 최소 맥락이라 운영 오류 처리와 보안이 빠질 수 있다. 입력 검증, 인증, 예외 처리, observability를 추가한다.

not production-ready

버전 차이

문서의 최신 권장 방식이 프로젝트의 고정 버전에서 안 될 수 있다. package version과 migration guide를 함께 본다.

compatibility

런타임 증거

예제를 붙인 뒤 build, route access, 브라우저 동작으로 확인한다. 타입 통과만으로 런타임 경계가 맞다는 뜻은 아니다.

runtime proof

파일 위치 예제 코드가 server/client boundary에 맞는 파일에 있다.

환경 변수 문서의 placeholder secret이 실제 env 정책으로 옮겨졌다.

회귀 테스트 적용한 기능의 핵심 흐름을 테스트나 수동 검증으로 확인했다.

read docs -> identify context -> adapt to project -> run build -> verify runtime -> 판단 기록