소개
앞선 사례들에서는 부동산 투자 분석 에이전트의 기본 구조 구성과 분석 기준 보강 과정을 중심으로 정리했다면, 이번 사례에서는 스터디장님께서 추가로 공유해주신 4주차 프롬프트를 활용해서 보다 구체적인 투자 분석 프롬프트들을 실제 분석 기준 데이터로 활용하여 에이전트를 확장·보완해본 과정을 정리하고자 합니다.
아직 완성 단계와는 거리가 있는 실험적 시도이지만, 스터디 과정에서의 고민과 개선 흐름을 공유드리는 데 의미를 두고 작성했습니다.
진행 방법
1. 추가 프롬프트를 활용한 분석 단계 보강
이번에는 스터디장님께서 추가로 공유해주신 아래와 같은 투자 분석 프롬프트들을 분석 기준 데이터로 활용해보고자 했습니다.
심층 비교 분석
적정가 산정
거래량 분석
과거 수익률 분석
임장 체크리스트
매물 재평가
추가 의사결정 판단
이 프롬프트들을 단순히 질문 예시로 사용하는 것이 아니라, 에이전트가 참고해야 할 분석 단계와 판단 항목으로 재정의하는 것을 목표로 했습니다.
2. knowledge 디렉토리 확장 및 활용 방식 정리
공유받은 분석 관련 md 파일들을 기존 knowledge 디렉토리에 추가하고, Claude Code가 이 자료들을 실제 분석에 활용할 수 있는 방법을 중심으로 구조를 재검토했습니다.
knowledge 디렉토리에 "P7-" 과 "P8-" 로 시작하는 md 파일을 추가해서 지식 데이터를 추가했어. 이 데이터들로 추가적으로 분석에 사용할 수 있는 방안을 많이 고민해 보고 분석해서 정리해줘.각 프롬프트의 목적과 분석 단계 정리
기존 분석 기준과 중복되거나 충돌하는 부분 검토
실제 투자 분석 자료로 활용 가능하도록 정리
이 과정에서 Claude Code와 여러 차례 대화를 통해, 어떤 방식으로 지식 파일을 참조시키는 것이 적절한지 고민하고 정리했습니다.
3. skills 디렉토리 업데이트
분석 기준이 확장됨에 따라, 기존 분석 도구만으로는 한계가 있다고 판단했습니다.
기존 skills 디렉토리(분석 처리 python 파일 저장) 내 분석 도구 수정
추가된 분석 단계에 대응하는 신규 Python 기반 skills 파일 생성
이를 통해 에이전트가 보다 다양한 관점에서 투자 분석을 수행할 수 있도록 구조를 보완했습니다.
4. 보고서 생성 과정에서 확인한 문제점
업데이트된 에이전트로 분석을 요청한 결과, 보고서 작성과 관련하여 여러 개선이 필요하다고 느꼈습니다.
투자 분석에 필요한 사용자 정보 수집 항목이 충분하지 않음
분석 결과에 대한 출처 표시가 누락됨
판단 근거 및 의견 서술이 지침에 비해 단순함
기존에 CLAUDE.md에 정의해두었던 지침이 실제 실행 과정에서 충분히 반영되지 않는다고 판단하여, 해당 부분에 대해 Claude Code에 개선을 요청했습니다.
5. CLAUDE.md 및 분석 흐름 재정비
skills 업데이트 이후, CLAUDE.md 파일도 함께 수정했습니다.
보고서 작성 지침 보강
출처 표기 및 근거 의견 작성 규칙 추가
분석 단계별 역할 재정의
수정 이후 에이전트를 다시 실행한 결과, 추가한 투자 분석 프롬프트에 대한 결과를 확인할 수 있었습니다.
6. 분석 수준 옵션 도입
종합 분석 보고서를 확인하는 과정에서, 기존 분석 데이터들이 다소 단순하게 느껴지는 문제가 있었습니다.
이를 개선하기 위해 분석 프롬프트와 skills를 다시 보완하고, 사용자가 분석 요청 시 분석 수준을 선택할 수 있도록 구조를 변경했습니다.
Quick: 빠른 요약 중심 분석
Standard: 기본적인 투자 판단을 위한 표준 분석
Full: 다양한 분석 항목을 포함한 종합 리포트
이를 통해 사용 목적에 따라 분석 깊이를 조절할 수 있도록 개선했습니다.
7. 오류 수정 및 운영 상 고려 사항
추가 테스트 과정에서 다음과 같은 문제도 확인했습니다.
사용자가 요청한 지역이 아닌 다른 지역을 분석하는 오류
해당 문제에 대해서도 수정 요청을 진행하여, 분석 대상 지역을 보다 명확히 반영하도록 보완했습니다.
또한 Claude Pro 요금제 환경에서는 Full 분석을 여러 차례 실행할 경우 토큰 사용량이 상당히 증가하는 점을 확인했습니다. 향후에는 분석 단계 분리나 결과 재사용 등, 토큰 사용을 최적화할 수 있는 방안을 고민할 필요가 있다고 느꼈습니다.
결과와 느낀 점
보고서 샘플 내용은 다음과 같습니다.
이번 과정에서는 단순히 기능을 추가하는 것보다,
분석 기준을 어떻게 구조화할 것인지
보고서 품질을 어떻게 일정 수준으로 유지할 것인지
운영 비용과 성능을 어떻게 균형 있게 가져갈 것인지
에 대해 고민해볼 수 있었습니다.
아직 부족한 부분이 많지만, 이번 스터디를 통해 경험한 사례들을 바탕으로, 향후 제가 계획하고 있는 개인 프로젝트에도 이러한 구조와 접근 방식을 적용해보고 싶다는 생각을 하게 되었습니다.
부족한 점이나 개선 방향에 대해 조언을 주신다면 감사히 참고하겠습니다.
