project map

구조를 읽을 때는 역할, 수정 여부, 추적 여부를 함께 본다

화면 파일은 자주 수정하고, 설정 파일은 목적이 있을 때만 바꾸며, 빌드 생성물은 직접 고치지 않는다.

앱 코드와 정적 파일

edit often

src/app/page.tsx 루트 경로의 화면 수정 O

src/app/layout.tsx 공통 HTML과 레이아웃 수정 O

src/app/global.css 전체 전역 스타일 추적 O

public/ 이미지와 favicon 같은 정적 파일 추적 O

edit with intent

package.json 스크립트와 의존성 목록 추적 O

next.config Next.js 동작 설정 수정 △

tsconfig.json TypeScript 컴파일 규칙 수정 △

.next/ 빌드 결과와 캐시 추적 X

quick check

파일을 열기 전, 화면을 바꾸는 작업인지 설정을 바꾸는 작업인지 먼저 구분하면 프로젝트 구조를 훨씬 빠르게 읽을 수 있다.