검색, 버전 확인, 예제 실행, 팀 노트 반영을 하나의 루프로 묶는다
문서 활용은 일회성 검색이 아니라 같은 문제를 다시 찾지 않게 팀 기준으로 남기는 과정이다.
| 루프 단계 | 해야 할 일 | 확인 산출물 | 다음 단계로 가는 조건 |
|---|---|---|---|
| 1 검색 | 문제 키워드와 오류 메시지로 공식 문서 찾기 | 관련 문서 URL | 문제와 같은 기능/라우터 문서 확인 |
| 2 버전 | 현재 프로젝트의 Next.js 버전과 router 기준 대조 | 버전 차이 메모 | 예제가 현재 조건과 맞음 |
| 3 실행 | 작은 예제로 동작 검증 | 성공/실패 로그와 코드 조각 | 프로젝트 적용 전 위험 확인 |
| 4 적용 | 프로젝트 코드에 최소 변경으로 반영 | 테스트, 빌드, 렌더 확인 | 회귀 없이 동작 확인 |
| 5 기록 | 팀 노트와 코드 주석에 결정 이유 남기기 | ADR, README, 체크리스트 | 다음 사람이 같은 검색을 반복하지 않음 |