파일이 많아져도 길을 잃지 않게 하기

파일이 많아지면, 먼저 지도를 펼친다

처음에는 파일이 하나였습니다. index.html만 보면 됐습니다.

이제는 조금 달라졌습니다.

my-first-page/
├─ index.html
├─ style.css
└─ script.js

화면 구조는 index.html, 디자인은 style.css, 버튼 기능은 script.js에 들어 있습니다. 파일이 나뉘면 좋은 점도 있지만, Claude가 엉뚱한 곳을 만질 가능성도 생깁니다.

그래서 작업을 시작할 때는 바로 부탁하지 않습니다.

먼저 이렇게 말합니다.

먼저 현재 폴더의 파일 구조를 읽고,
이번 작업에 어떤 파일이 필요한지 말해줘.
아직 파일은 수정하지 마.

핵심은 마지막 문장입니다.

아직 파일은 수정하지 마.

이 한 줄이 안전벨트입니다. Claude가 바로 코드를 바꾸기 전에, 어떤 길로 갈지 먼저 보여주게 만듭니다.

첫 요청은 작업이 아니라 정찰이다

Claude Code를 열고 my-first-page 폴더에서 다음처럼 입력해보세요.

먼저 현재 폴더의 파일 구조를 확인해줘.
그리고 내 자기소개 웹페이지에서 어떤 파일이 어떤 역할을 하는지 설명해줘.
아직 아무 파일도 수정하지 마.

Claude는 보통 파일 목록을 읽고 이렇게 정리해줍니다.

- index.html: 페이지의 글과 버튼 구조
- style.css: 색상, 여백, 카드 디자인
- script.js: 다크모드 버튼 동작

이 답을 받으면 프로젝트가 갑자기 덜 무섭게 느껴집니다. 파일 이름이 의미를 갖기 시작하기 때문입니다.

작업 전에는 늘 이 순서로 가세요.

1. 파일 구조 확인
2. 관련 파일 고르기
3. 수정 계획 듣기
4. 승인하기

코드를 잘 몰라도 괜찮습니다. 적어도 Claude가 어디를 만지려는지는 알 수 있습니다.

관련 파일을 콕 집어 말한다

초보자가 자주 하는 요청은 너무 넓습니다.

포트폴리오처럼 예쁘게 바꿔줘.

이렇게 말하면 Claude는 많은 파일을 한꺼번에 살펴보고, 때로는 필요 없는 구조까지 바꾸려고 합니다.

파일이 이미 정해져 있다면 이렇게 말하세요.

index.html, style.css, script.js 세 파일만 확인해줘.
기존 다크모드 기능은 유지하고,
자기소개 카드 아래에 프로젝트 소개 영역을 추가하려면
어떤 파일을 수정해야 하는지 먼저 말해줘.
아직 수정하지 마.

이 요청에는 좋은 습관이 다 들어 있습니다.

• 볼 파일을 정했습니다.

• 유지할 기능을 말했습니다.

• 추가할 기능을 말했습니다.

• 수정 전 계획을 요구했습니다.

Claude에게 모든 것을 맡기는 대신, 작업대 위에 필요한 도구만 올려두는 느낌입니다.

파일마다 이름표를 붙인다

지금 프로젝트의 세 파일은 이렇게 기억하면 됩니다.

예를 들어 버튼 색만 바꾸고 싶다면 script.js는 필요 없습니다.

style.css만 수정해서 다크모드 버튼 색을 더 선명하게 바꿔줘.
index.html과 script.js는 건드리지 마.
수정 전에 어떤 CSS를 바꿀지 먼저 설명해줘.

문구만 바꾸고 싶다면 style.css와 script.js도 필요 없습니다.

index.html만 수정해서 소개 문장을 더 짧고 자연스럽게 바꿔줘.
디자인과 다크모드 기능은 건드리지 마.

이렇게 말하면 Claude가 헤맬 공간이 줄어듭니다.

작업 메모 파일을 만든다

프로젝트가 커질수록 매번 같은 설명을 반복하게 됩니다.

• 이 페이지는 어떤 페이지인지

• 어떤 분위기로 만들고 싶은지

• 어떤 기능은 절대 지우면 안 되는지

• 파일별 역할은 무엇인지

이때 작은 메모 파일 하나를 만들어두면 편합니다.

프로젝트 폴더에 PROJECT_NOTE.md를 만들어보세요.

Claude에게 이렇게 부탁합니다.

PROJECT_NOTE.md 파일을 만들어줘.
아래 내용을 넣어줘.

# 작업 메모

- 이 프로젝트는 자기소개용 미니 웹페이지입니다.
- 프로젝트 폴더 이름은 my-first-page입니다.
- 디자인 톤은 밝고 깔끔한 카드형 UI입니다.
- 과한 애니메이션은 넣지 않습니다.
- index.html은 화면 구조를 담당합니다.
- style.css는 디자인을 담당합니다.
- script.js는 다크모드 버튼 기능을 담당합니다.
- 기존 다크모드 기능은 삭제하지 않습니다.
- 새 기능을 추가하기 전에는 수정할 파일을 먼저 말합니다.

앞으로 새 작업을 시작할 때는 첫 문장에 이 메모를 붙이면 됩니다.

PROJECT_NOTE.md를 먼저 읽고,
그 규칙을 지키면서 작업해줘.

오늘 할 일은 자기소개 카드 아래에
프로젝트 소개 영역을 추가하는 거야.
먼저 어떤 파일을 수정할지 말해줘.
아직 수정하지 마.

이 파일은 Claude에게 주는 작은 안내판입니다. 프로젝트의 분위기와 금지 사항을 한곳에 적어두면 대화가 훨씬 안정됩니다.

금지 사항은 짧고 분명하게 쓴다

Claude에게 금지 사항을 말할 때는 길게 설명하지 않아도 됩니다. 짧게, 행동 중심으로 쓰세요.

좋은 금지 문장은 이런 모양입니다.

기존 다크모드 기능은 건드리지 마.

파일 이름은 바꾸지 마.

새 라이브러리는 설치하지 마.

index.html의 기존 소개 문장은 삭제하지 말고 아래에 새 영역만 추가해줘.

반대로 이런 문장은 애매합니다.

전체적으로 잘 정리해줘.

전체적으로라는 말은 넓습니다. Claude가 구조를 바꾸거나, 파일을 새로 만들거나, 이미 괜찮은 부분까지 손댈 수 있습니다.

원하는 것이 작다면 작게 말하세요.

기존 기능은 유지하고,
프로젝트 카드 2개만 추가해줘.

새 기능을 넣기 전에는 범위를 잠근다

이제 실제로 기능을 하나 추가해보겠습니다.

목표는 간단합니다. 자기소개 카드 아래에 프로젝트 소개 영역을 넣습니다.

바로 이렇게 요청하지 마세요.

프로젝트 섹션 추가해줘.

대신 범위를 잠그고 요청합니다.

PROJECT_NOTE.md를 먼저 읽어줘.
기존 다크모드 기능은 건드리지 말고,
index.html과 style.css만 수정해서
자기소개 카드 아래에 프로젝트 소개 영역을 추가해줘.

프로젝트 카드는 2개만 만들고,
각 카드에는 제목, 한 줄 설명, 사용 기술을 넣어줘.

수정하기 전에 변경할 파일과 작업 계획을 먼저 말해줘.

이 요청은 길어 보이지만 어렵지 않습니다. 구조는 단순합니다.

참고할 메모 → 지킬 것 → 수정할 파일 → 만들 것 → 먼저 말할 것

이 순서만 기억하면 됩니다.

Claude의 계획을 보고 한 번 더 좁힌다

Claude가 이렇게 답했다고 해봅시다.

수정할 파일:
- index.html
- style.css
- script.js

작업 계획:
- 프로젝트 영역 추가
- 프로젝트 카드 스타일 추가
- 버튼 클릭 시 프로젝트를 펼치는 기능 추가

여기서 멈춥니다.

우리는 펼치는 기능을 부탁하지 않았습니다. script.js도 수정할 필요가 없습니다.

이럴 때는 이렇게 되돌립니다.

이번 작업에서는 script.js를 수정하지 마.
프로젝트를 펼치는 기능도 추가하지 마.
index.html과 style.css만 수정해서
항상 보이는 프로젝트 카드 2개만 추가하는 계획으로 다시 정리해줘.

Claude가 똑똑해도, 작업 범위는 사용자가 잡아야 합니다.

AI에게 맡기는 것이 아니라, AI를 데리고 가는 것입니다.

대화가 길어지면 요약 버튼을 누른다

Claude와 오래 대화하다 보면 처음 목표가 흐려질 때가 있습니다.

처음에는 프로젝트 카드만 추가하려고 했는데, 어느새 폰트, 버튼, 애니메이션, 반응형 디자인까지 이야기가 번질 수 있습니다.

그럴 때는 새 요청을 하지 말고 요약을 시킵니다.

지금까지 작업을 짧게 정리해줘.
아래 형식으로 써줘.

- 현재 목표:
- 완료된 일:
- 수정된 파일:
- 아직 남은 일:
- 다음 작업에서 건드리면 안 되는 것:

이 요약은 대화의 청소 시간입니다. 책상 위에 흩어진 종이를 다시 한 묶음으로 정리하는 느낌입니다.

요약이 마음에 들면 메모 파일에 붙여 넣습니다.

방금 요약을 PROJECT_NOTE.md 아래쪽에
현재 상태 섹션으로 추가해줘.

이제 다음에 다시 Claude Code를 열어도 길을 잃지 않습니다.

PROJECT_NOTE.md를 읽고 현재 상태를 파악해줘.
오늘은 남은 일 중 하나만 진행할 거야.
먼저 추천 작업 1개를 말해줘.
아직 파일은 수정하지 마.

Claude가 엉뚱한 파일을 보려고 할 때

가끔 Claude가 필요 이상으로 많은 파일을 보려고 할 수 있습니다.

그럴 때 겁먹을 필요 없습니다. 이렇게 말하면 됩니다.

지금 작업에는 그 파일이 필요 없어.
index.html, style.css, script.js만 기준으로 다시 판단해줘.

또는 더 강하게 범위를 제한할 수도 있습니다.

이번 요청에서는 index.html만 확인해줘.
다른 파일은 읽거나 수정하지 마.

작업 범위를 줄이는 것은 실력이 부족해서가 아닙니다. 좋은 작업 방식입니다. 작은 범위에서 확인하고, 괜찮으면 다음 범위로 넘어가는 편이 훨씬 안전합니다.

복붙해서 쓰는 길 안내 프롬프트

프로젝트가 커졌을 때는 아래 문장을 그대로 써도 됩니다.

먼저 파일 구조를 읽고,
이번 작업과 관련 있는 파일만 골라줘.
아직 아무 파일도 수정하지 마.

PROJECT_NOTE.md를 먼저 읽고,
그 규칙을 지키면서 작업해줘.

기존 기능은 건드리지 말고,
이 기능만 추가해줘.
수정할 파일을 먼저 말한 뒤 진행해줘.

이번 작업에서는 index.html과 style.css만 수정해줘.
script.js는 건드리지 마.

대화가 길어졌어.
현재 목표, 완료된 일, 남은 일을 짧게 요약해줘.

방금 요약을 PROJECT_NOTE.md에 현재 상태로 추가해줘.

이 문장들은 Claude에게 주는 길 안내 표지판입니다.

길을 잘 알려주면 Claude는 훨씬 덜 헤맵니다.

작업 전 30초 체크리스트

파일이 많아졌다면, 요청을 보내기 전에 이것만 확인하세요.

• 어떤 파일을 봐야 하는가?

• 어떤 파일은 건드리면 안 되는가?

• 기존 기능 중 반드시 유지할 것은 무엇인가?

• 새로 추가할 것은 정확히 무엇인가?

• 수정 전에 계획을 먼저 말하게 했는가?

이 다섯 가지를 챙기면 프로젝트가 커져도 겁낼 필요가 없습니다.

Claude Code는 혼자 달리는 자동 조종 장치가 아닙니다. 옆자리의 빠른 조수에 가깝습니다. 운전대는 여전히 당신에게 있습니다.

파일이 많아질수록 더 크게 명령하지 마세요. 더 작고 선명하게 안내하세요.