한줄 요약
외부에서 받은 여러 템플릿 프로젝트를 Claude Code와 대화하며 분석하고, 통합 구조를 30분 만에 설계했습니다.
이런 분들께 도움돼요
여러 템플릿/보일러플레이트를 받았는데 어떻게 정리할지 막막한 분
Claude Code 워크스페이스 구조를 체계적으로 잡고 싶은 분
AI와 대화하며 프로젝트 구조를 설계해본 적 없는 분
소개: 시도하고자 했던 것과 그 이유
문제 상황 (Before)
스터디에서 여러 개의 템플릿을 받았습니다. 각각 다른 목적으로 만들어진 템플릿들이었죠.
문제는:
폴더가 너무 많음: 버전별로 폴더가 따로 있음
유니코드 충돌: 같은 폴더가 인코딩 문제로 여러 번 복제됨
기능 분산: 비슷한 기능이 여러 곳에 흩어져 있음
어디서 시작할지 모름: 어떤 템플릿을 기준으로 해야 할지 혼란
시작하게 된 계기
"이 폴더들 어떻게 정리하지?" 고민하고 있었는데, 스터디장님께서 Claude Code에게 물어보라고 알려주셨어요! 저는 파일만 보고는 도저히 어떤 파일인지 구분이 안되어서 막막했었거든요.
진행 방법: 어떤 도구를 사용했고, 어떻게 활 용했나요?
사용한 도구
도구명: Claude Code (VSCode Extension)
모델: Claude Opus 4.5
특이사항: Plan Mode 활용 (구조 설계에 적합)
AI와 협업한 과정
1. 전체 구조 파악 요청
상황: 폴더에 뭐가 있는지 전혀 몰랐습니다.
이렇게 요청했어요:
현재 나는 외부의 여러 템플릿을 받았고 이 폴더들을 정리하고 싶어. 현재 프로젝트를 너가 전체 읽어보고 어떻게 통합할 수 있는지 논의해보자.
결과: Claude가 Explore 에이전트를 사용해서 모든 폴더를 탐색하고, 상세한 분석 리포트를 제공했습니다.
느낀 점: 직접 폴더 하나하나 열어보는 것보다 훨씬 빠르고 체계적이었습니다.
2. 기능 목록 정리 요청
상황: 어떤 기능들이 있는지, 중복은 없는지 파악하고 싶었습니다.
이렇게 요청했어요:
지금 여기에 있는 skill들 정리해서 채팅으로 알려줘
결과: 모든 Skills를 표로 정리해주고, 중복 분석까지 해줬습니다.
느낀 점: 비슷해 보이는 기능들이 사실 다른 용도라는 걸 알게 됐습니다. 직접 봤으면 같은 거라고 생각하고 하나 삭제했을 수도 있어요.
3. 기존 파일 참고 요청
상황: Claude가 제안한 구조가 마음에 안 들었습니다.
이렇게 요청했어요:
[기존 설정 파일 경로] 이걸 참고해서 다시 제안해줘
결과: 기존 설정 파일의 체계를 적용한 새로운 구조를 제안받았습니다.
느낀 점: 기존 파일을 참고하라고 하니까 훨씬 맥락에 맞는 제안을 해줬습니다.
인상적이었던 순간
"오!" 했던 순간: Claude가 유니코드 충돌 문제를 발견했을 때
"인코딩 문제로 같은 폴더가 여러 번 복제됨"
이건 직접 봤어도 몰랐을 문제입니다. 같은 이름처럼 보이는 폴더들이 사실 인코딩 문제로 생긴 중복이었다니!
막혔던 순간과 해결
문제: Claude가 처음 제안한 구조가 너무 단순했습니다.
해결: 기존에 잘 설계된 설정 파일을 직접 열어서 "이거 참고해"라고 했더니, 훨씬 체계적인 구조를 제안해줬습니다.
💡 Tip: AI에게 "이렇게 해줘"보다 "이 파일 참고해서 해줘"가 더 좋은 결과를 줍니다.
결과와 배운 점
Before vs After
항목
Before
After
폴더 구조 파악
여러 템플릿 × 여러 하위 폴더 (혼란)
단일 통합 구조
기능 파악
"뭐가 있는지 모름"
전체 목록 + 중복 분석 완료
소요 시간
예상 반나절
실제 30분
결과물
없음
분석 리포트 + 통합 계획 문서
결과물
분석 리포트 - 전체 분석 문서 (다른 PC에서도 확인 가능)
통합 구조 계획 - 체계적인 설계도
기능 전체 목록 - 표로 정리
배운 점 과 나만의 꿀팁
효과적이었던 것
Plan Mode 활용: 구조 설계처럼 코드 작성이 아닌 작업에 적합
기존 파일 참조 지시: "이 파일 참고해서" 한마디로 품질 급상승
Explore 에이전트: 폴더 탐색은 직접 하지 말고 AI에게 맡기기
이렇게 하면 안 돼요 (주의사항)
처음부터 "통합해줘"라고 하면 안 됨 → 먼저 "분석해줘"부터
AI 제안이 마음에 안 들면 그냥 받아들이지 말고 참고 파일 제시하기
과정 중 시행착오
처음에 Claude가 제안한 구조가 너무 단순해서 기존 체계랑 안 맞았습니다. 그래서 기존 설정 파일을 열어서 "이거 참고해"라고 했더니 훨씬 체계적인 구조로 다시 제안해줬습니다.
앞으로의 계획
다음 단계
실제 폴더 생성 및 파일 이동
기능 동작 테스트
통합 규칙 문서 완성
다른 업무에 적용한다면?
회사에서 여러 팀의 템플릿을 통합할 때
개인 프로젝트 폴더 정리할 때
새 프로젝트 구조 설계할 때
재사용 가능한 프롬프트
프롬프트 1: 프로젝트 구조 분석 요청
현재 나는 외부의 여러 [템플릿/프로젝트]를 받았고 이 폴더들을 정리하고 싶어.
현재 프로젝트를 너가 전체 읽어보고 어떻게 통합할 수 있는지 논의해보자.
우선 프로젝트를 읽고 난 후, 내가 원하는게 무엇인지 되물어줘.
프롬프트 2: 기존 파일 참고 요청
[파일 경로] 이걸 참고해서 다시 제안해줘
프롬프트 3: 정리된 내용 저장 요청
이 내용을 내가 다른 PC에서도 확인할 수 있도록 내용을 아주 자세하게 정리해 줄 수 있어?
대화 내용을 그대로 저장해 주면 더 좋아. 저장은 [폴더명]에 해줘