강의

멘토링

커뮤니티

인프런 커뮤니티 질문&답변

형씌님의 프로필 이미지
형씌

작성한 질문수

AI 다루는 백엔드 설계 기본 - SpringBoot SNS 편

AI 에이전트 세팅 (Gemini CLI, Claude Code)

.claude 폴더 규칙 생성 방법

해결된 질문

작성

·

26

1

강의를 들으면서 강의에서 제공해주신 GitHub 프로젝트 코드를 참고하여 개인적으로도 별도의 프로젝트 파일을 만들어 수강하고 있습니다. 현재는 강의 코드가 제공되고 있어 .claude 폴더를 다운로드한 뒤 제가 만든 프로젝트에 추가하면 되지만, 추후 개인 프로젝트에서 AI를 활용해 개발한다고 가정하면 .claude 폴더를 프로젝트 특성에 맞게 커스텀해야 할 것 같다고 생각합니다.

그래서 아래 두 가지가 궁금합니다.

  1. 현재 제공해주신 .claude 폴더는 어느 정도 범용적으로 사용할 수 있는 구조인지 궁금합니다. 다른 프로젝트에서도 그대로 붙여넣어 사용해도 되는지, 아니면 프로젝트마다 반드시 수정해야 하는 핵심 포인트가 있는지 알고 싶습니다.

  2. 처음 새 프로젝트를 만들면 .claude 폴더가 없는 상태인데, 프로젝트 기획과 규칙(코딩 컨벤션, 아키텍처, 역할 분리, 문서화 규칙 등)이 이미 정해져 있는 경우 .claude 폴더를 어떤 순서와 기준으로 새롭게 생성하는지 시작하는 방법이 궁금합니다.

답변 2

0

한조각님의 프로필 이미지
한조각
지식공유자

안녕하세요 형씌님

 

좋은 질문 주셔서 감사합니다. 

 

1)
"추후 ... 프로젝트 특성에 맞게 커스텀해야 할 것 같다고 생각합니다." 말씀해주신 이 부분 정말 잘 캐치하셨습니다!
현재 제공된 .claude 폴더는 도메인 성격, 아키텍처 방식, 팀 규모에 따라 반드시 조정해야 합니다. 예를 들어 도메인 분리 기준, 레이어 구조, 네이밍 규칙, 코드 리뷰에서 꼭 봐야할 점, 보안 규칙 등은 프로젝트마다 달라지기 때문에 이 부분은 프로젝트에 맞게 수정해주는 것이 좋습니다.

 

2)
새 프로젝트에서 .claude 폴더가 없는 상태라면 특히 프로젝트 기획과 규칙이 이미 있다면

이를 바탕으로 먼저 정해볼 수 있는 부분은 도메인 개념 정리, 코딩 컨벤션, 구체적인 개발 규칙에 대한 설명입니다. 이를 미리 정의해두면, 추가 기능을 구현할 때 이 부분을 미리 참고하여 전체적으로 통일감있고 예측가능한 코드를 만들 수 있게 될 수 있습니다. (물론 AI 를 계속 사용해보시면 알겠지만, AI agent 가 기존 코드를 읽고 이를 자동으로 분석하여 해당 코드베이스 맞는 구조로 새로운 코드를 알아서 만들어주기도 합니다.)

이후 실제 개발을 진행하면 반드시 반복해서 AI 에게 요청하는 부분이 생길겁니다. 따라서 “AI가 자주 헷갈리는 부분”이나 “매번 설명하게 되는 내용”을 발견할 때마다 .claude 문서를 보완해 나가면, 점점 프로젝트에 최적화된 형태로 완성됩니다.

 

정리하면, .claude 폴더는 한 번 만들어두고 끝나는 설정이 아니라 프로젝트와 함께 성장시키는 문서에 가깝습니다. 처음에는 단순하게 시작하고, 개발을 진행하면서 반복되는 의사결정과 규칙을 하나씩 녹여내는 방식이 가장 현실적이고 효과적인 접근이라고 보시면 좋겠습니다.

 

감사합니다.

0

안녕하세요, 인프런 AI 인턴입니다. 형씌님.

현재 진행 중이신 강의에서 .claude 폴더를 활용하여 AI 기반의 코딩 작업을 수행하시는 것에 대한 질문이군요. 이를 바탕으로 .claude 폴더를 다른 프로젝트에 어떻게 활용할 수 있을지 궁금하신 점에 대해 답변드리겠습니다.

  1. .claude 폴더의 범용성:

    • 현재 강의에서 제공된 .claude 폴더는 특정 프로젝트에 최적화되어 있을 수 있습니다. 다른 프로젝트에서도 사용 가능하긴 하지만, 각 프로젝트마다 아키텍처, 요구 사항, 사용 기술 스택 등이 다르기 때문에 어느 정도의 수정 작업이 필요할 수 있습니다.
    • 일반적으로 .claude 폴더의 내용은 특별히 반복되는 작업이나 특정 규칙을 자동화하기 위해 사용되는 ‘skill’, ‘hook’, ‘command’ 등이 포함됩니다. 따라서 각 프로젝트의 특성에 맞게 특정 영역은 커스터마이즈해야 합니다.
  2. 새로운 .claude 폴더 생성 가이드라인:

    • .claude 폴더를 처음 생성할 때는, 프로젝트의 기획과 규칙을 명확히 하고 해당 규칙에 맞춰 필요한 파일과 디렉토리를 만든 후, AI 기반의 자동화 내용을 포함시키는 것을 추천드립니다.
    • 시작 순서는 다음과 같습니다:
      1. 프로젝트의 코딩 컨벤션 및 개발 규칙 확인.
      2. 필요한 기능 및 반복 작업 분석.
      3. ‘skills’ 폴더에 주로 반복적인 작업과 관련된 규칙 추가.
      4. ‘hooks’ 폴더에 프로젝트의 빌드, 테스트, 배포 단계에서 자동화할 과제의 스크립트 추가.
      5. 이 외에도 프로젝트 특성에 맞는 추가적인 구조를 더할 수 있습니다.

다음 링크에서 유사한 질문과 답변을 확인하실 수 있습니다:
- “.claude폴더를 복붙해서 넣긴 넣었는데 궁금한 점이 생겼어요.”

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다.
현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

형씌님의 프로필 이미지
형씌

작성한 질문수

질문하기