이 단원의 카드 6개
실습 구조
프로젝트 구조
이 카드를 다루는 수업 자료를 잘 정리하는 법 Codex부터 GitHub 저장까지
-
위치 규칙을 먼저 정합니다. 예: “발행물은 여기, 임시 산출물은 저기, 원본은 건드리지 않는다”
-
규칙이 없으면 매번 위치를 새로 지정해야 하고, 나중에 찾는 것도 일이 됩니다
-
SSoT(Single Source of Truth, 단일 진실 출처)를 정하는 이유도 같습니다:
-
같은 정보가 여러 파일에 흩어져 있으면 어느 쪽이 최신인지 매번 확인해야 합니다.
-
정본 파일 하나를 정하고 나머지는 그 파일을 가리키게 합니다.
-
예: 마케터의 캠페인 자료에서 발행본과 초안이 같은 폴더에 섞여 있으면 어느 파일이 최종본인지 매번 물어봐야 합니다
-
“최종”, “진짜최종”, “최종_수정2”처럼 파일명으로 버전을 구분하는 방식은 피합니다.
-
발행 폴더와 초안 폴더를 나누고 발행 폴더에 있는 것만 정본으로 취급하면, 파일명에 기대지 않아도 됩니다.
-
공개 범위도 구조에 포함됩니다. 외부에 나가도 되는 폴더와 내부용 폴더를 나눠 두면, 발행 작업을 맡길 때 비공개 자료가 실수로 섞여 나가는 일을 줄일 수 있습니다.
실행 순서
-
현재 폴더 구조를 훑어 확인합니다.
지금 폴더에 있는 파일들을 훑어봐 줘.
확인지금 폴더의 파일 구성이 요약되어 나옵니다.
-
산출물·원본·임시 파일이 들어갈 위치를 각각 정합니다.
산출물·원본·임시 파일을 각각 어디에 두면 좋을지 3줄로 제안해 줘. 새 폴더를 실제로 만들지는 말고 제안만 해 줘.
확인산출물·원본·임시 파일 위치 제안이 3줄 이내로 나오고, 새 폴더는 실제로 만들어지지 않습니다.
-
정본(SSoT, Single Source of Truth) 파일을 하나 지정합니다.
-
정한 구조 규칙을 CLAUDE.md에 기록합니다.
직접 해보기
대괄호 안은 실제 값으로 바꿔서 붙여넣습니다.
[내 프로젝트 이름]에서 산출물과 원본 파일이 자꾸 같은 폴더에 섞여. 지금 폴더 구조를 보고 정본 파일 하나와 나머지 파일들의 역할을 구분해서 3줄 이내로 제안해 줘.
방금 제안받은 구조 규칙을 CLAUDE.md에 바로 추가할 수 있는 문장으로 만들어 줘.
제안받은 구조에서 정본 파일이 정확히 하나인지 확인해 보세요.
헷갈리기 쉬운 것
같은 정보가 여러 파일에 흩어져 있으면 어느 쪽이 최신인지 매번 확인해야 하는 드리프트가 생깁니다. 이때는 정본 파일 하나를 정하고 나머지는 그 파일을 가리키게 정리합니다. 원본 폴더를 작업 대상에 포함하면 실수로 원본이 고쳐지거나 지워질 수 있으므로, 원본은 읽기 전용으로 따로 분리해 둡니다.
용어 풀이
전체 용어집 →2026-07-13 기준 · 출처 · Claude Code — Memory