Inflearn コミュニティ Q&A
강의 내용과는 다른 질문이 있습니다.
作成
·
28
·
編集済み
0
안녕하세요 강사님 강의를 들으면서 배운 내용들을 토대로 스프링부트 프로젝트를 진행해 보고 있습니다. MCP 플러그인과 스킬 에이전트 그리고 플랜 기획을 통한 순차 구현까지 강의에서 강조하신 모든 기법을 최대한 활용하여 실무급 규모의 프로젝트를 구축해 보았습니다. 하지만 프로젝트가 진행될수록 결과물의 완성도가 기대에 미치지 못해 고민이 깊어지고 있습니다.
현재 제가 겪고 있는 가장 큰 문제는 클로드 코드가 프로젝트의 전반적인 구조를 일관되게 유지하지 못한다는 점입니다. 분명 이닛 과정에서 클로드md 파일을 통해 아키텍처와 구조를 명확히 정의했음에도 불구하고 실제 구현 단계에서는 구조를 불필요하게 복잡하게 만들거나 계층 간의 역할이 뒤섞이는 현상이 자주 발생합니다. 또한 사용하지도 않는 함수를 임의로 생성하거나 데이터베이스 쿼리를 비효율적으로 작성하고 때로는 잘못된 쿼리를 생성하는 등 코드의 세부적인 퀄리티에서도 많은 부족함을 느끼고 있습니다.
특히 프로젝트의 규모가 어느 정도 커지니 특정 부분의 로직은 잘 짜여 있어도 정작 핵심적인 구현이 대거 누락되는 경우가 잦아지고 있습니다. 누락된 부분을 수정하도록 지시하면 그 과정에서 잘 돌아가던 다른 기능이 망가지는 연쇄적인 오류가 발생하며 이를 해결하기 위해 검증 에이전트를 병행해서 돌려보아도 알맹이가 없는 빈 껍데기 코드들이 걸러지지 않은 채 그대로 남는 문제도 겪고 있습니다.
이러한 현상들이 오푸스와 소넷 모델 모두에서 공통적으로 나타나고 있어 이것이 현재 클로드 코드가 가진 지능적 혹은 컨텍스트 유지의 한계인 것인지 아니면 제가 에이전트를 가이드하고 제어하는 능력이 부족해서 발생하는 문제인지 판단이 서질 않습니다. 강사님께서는 대규모 프로젝트를 진행하실 때 이런 AI의 구조적 일탈과 구현 누락을 어떻게 제어하시는지 그리고 제가 어떤 부분을 더 보완해야 완성도 높은 결과물을 얻을 수 있을지 조언을 구하고 싶습니다.
回答 2
1
안녕하세요! 🙂
여기까지 고민하시고 이러한 문제를 직면했다는 거 자체가 강의를 잘 학습하신 거예요! 이 벽을 만났다는 건 반대로 이 문제만 넘으면 또 한 번 엄청난 성장을 하실 거라는 신호예요. (장담합니다 👍)
결론부터 말씀드릴게요. 이제부터는 컨텍스트 엔지니어링 싸움입니다.
컨텍스트 엔지니어링이란 작업 요청을 할 때 클로드가 꼭 알아야 할 정보만 정확하게 담아주는 기술이에요. 그리고 이건 클로드 코드의 스킬이나 서브에이전트처럼 "이렇게 하면 이렇게 된다"는 공식이 딱 떨어지는 게 아니에요.훨씬 본질적인 영역이에요.
여기서 중요한 게 있어요. 컨텍스트 엔지니어링은 도구나 기법을 익히는 것보다, 지금 이 작업에 어떤 정보가 필요한지 스스로 판단하는 능력이 핵심이에요. 클로드가 구조를 잃고 헤매는 건 대부분 "너무 많은 걸 한꺼번에 알려줬거나, 반대로 정작 필요한 게 빠져있는" 경우예요. 어떤 정보를 넣고 뺄지는 결국 본인이 프로젝트를 얼마나 잘 이해하고 있느냐에서 나와요. 도구는 그 판단을 실행하는 수단일 뿐이고요.
그 판단을 실행하는 데 도움이 되는 클로드 코드의 메모리 관리 방법들이 있어요.
CLAUDE.md: 프로젝트 전반의 아키텍처, 규칙, 컨텍스트를 담는 핵심 파일.claude/rules.md: 세부 규칙을 별도로 분리해서 관리.claude/rules.md(frontmatter paths) : 특정 경로에 필요한 규칙만 선택적으로 불러오는 방식디렉토리/CLAUDE.md(on-demand 로딩) : 특정 디렉토리 작업 시에만 해당 컨텍스트를 로드
프로젝트 규모가 커질수록 클로드가 전체를 한 번에 파악하려 하면 구조가 흔들려요. 위 방법들을 활용하면 "지금 이 작업에 필요한 정보"만 정확하게 전달할 수 있어서 구조 일탈과 구현 누락 문제가 눈에 띄게 줄어들어요.
그리고 정말 좋은 타이밍에 질문해주셨어요 😊
사실 이 메모리 관리 내용을 강의 중반부에 다루고 싶었는데, 입문자분들한테는 너무 머리가 터지는 내용이라 일부러 뒤로 미뤄뒀어요. 그런데 지금처럼 하루하루 AI 도구가 쏟아지는 시점에 더 본질적인 내용을 다뤄야겠다는 생각이 강하게 들어서, 메모리 관리 고급편 추가 강의를 준비 중이에요. .claude/rules 모듈식 관리, 디렉토리별 on-demand 로딩까지 말씀하신 문제를 직접 해결할 수 있는 내용이에요. 거의 완성 단계예요.
조금만 기다려주시면 곧 업데이트될 예정입니다 🔥
감사합니다 🙂
0
안녕하세요, 인프런 AI 인턴입니다. dev.hellolab님.
스프링부트 프로젝트를 진행하시면서 클로드 코드의 일관성 및 코드 품질 문제로 고민하고 계신 것 같습니다. 이러한 문제는 특히 규모가 큰 프로젝트에서 더욱 두드러질 수 있습니다.
클로드 코드의 구조적 일탈과 구현 누락에 대한 해결책
명확한 초기 설계: 설계 단계에서
CLAUDE.md파일뿐 아니라 다른 문서화 도구를 통해 설계를 구체화하는 것이 중요합니다. 설계 문서를 기반으로 요구 사항을 단계적으로 구현해야 합니다.클로드 코드 가이드라인 강화: 클로드 코드에게 줄 작업 지시를 세분화하고 명확하게 정의하여, 작업 과정에서 혼란이 발생하지 않도록 가이드라인을 강화하세요.
모델 선택 기준: 오푸스(Opus)와 소넷(Sonnet) 모델 모두에서 문제를 경험하고 계시다면, 두 모델이 다루는 문제에 따라 각 모델의 특징을 잘 이해하고 해당 상황에 적합한 모델을 선택하는 것도 중요합니다.
코드 리뷰 강화: 프로젝트의 구조적 일탈을 최소화하기 위해 정기적으로 코드 리뷰를 수행하고, 코드 품질을 평가하도록 합니다. 이 평가 과정에서 클로드 코드가 생성한 부분들을 주의 깊게 확인하십시오.
핵심 기능 관리: 프로젝트 핵심 기능이 누락되거나 부실해지는 것을 방지하기 위해 여러 단계에서 수시로 테스트를 진행하고, 테스트 커버리지를 철저히 관리합니다.
에이전트 제어 능력 향상: 에이전트를 효율적으로 가이드하고 제어하는 스킬을 강화하기 위해, 해당 과정에서 발생했던 문제들을 일지로 남겨 기록하고 분석하여 지속적으로 학습합니다.
아래는 유사한 문제 상황과 해결 방법에 대한 기존 답변이 담긴 게시글들이니, 참고하시면 도움이 될 것입니다:
지식공유자님께서도 대규모 프로젝트에서 클로드 코드의 역할과 제어 방법을 다루신 적 있으니 강의 내용을 복기하거나 Q&A를 통해 추가 조언을 요청해보시는 것도 추천드립니다.
저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏
추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.





정말 감사합니다! 큰도움이 되고있습니다!