소개
지난주에 공유드렸던 부동산 투자 분석 에이전트 제작 후 추가로 진행한 과정을 말씀드리겠습니다.
https://www.gpters.org/nocode/post/real-estate-investment-analysis-Sg6tYwmCNKOfwO3
지난 사례에서는 에이전트의 기본적인 데이터 수집과 분석 흐름을 구성하는 데 중점을 두었다면,
이번 글에서는 스터디 과정에서 공유받은 자료와 여러 의견을 참고하여
분석 기준을 보완하고 구조를 개선해본 과정을 중심으로 정리하고자 합니다.
아직 많이 부족한 실험 단계의 시도이지만, 스터디 사례 게시글로서 완성된 결과보다는
시행착오와 개선 과정을 공유드리는 데 의미를 두고자 합니다.
진행 방법
1. 분석 기준 보강 시도
스터디장님께서 공유해주신 부동 산 투자 분석용 프롬프트를 단순한 참고 자료가 아닌,
에이전트가 실제로 참고하는 분석 기준 데이터로 활용해보고자 했습니다.
이를 위해 다음과 같은 방향으로 정리를 시도했습니다.
공유받은 프롬프트를 분석 단계별 기준으로 재구성
기존 CLAUDE.md에 정의된 판단 로직과의 관계 정리
에이전트가 참고해야 할 자료와 규칙을 구분하여 관리
2. knowledge 디렉토리 추가
기존 구조에서는 분석 기준과 참고 자료가 CLAUDE.md에 집중되어 있어, 관리 측면에서 다소 불편함이 있었습니다.
이를 보완하기 위해 knowledge 디렉토리를 새로 추가했습니다.
프로젝트 루트
├── CLAUDE.md
├── knowledge/
├── context/
├── skills/
└── report/knowledge 디렉토리
스터디에서 공유받은 분석 관련 md 파일과 투자 판단 기준 문서를 관리
Claude Code에는 다음과 같은 역할을 부여했습니다.
knowledge 디렉토리의 문서를 분석 기준으로 참고
CLAUDE.md에 정의된 자동화 규칙과 함께 투자 분석에 활용
3. skills 디렉토리 개선
분석 기준이 어느 정도 정리되면서, 기존 분석 도구 구조에도 수정이 필요하다고 판단했습니다.
기존 skills 디렉토리 내 분석 도구 일부 수정
투자 분석 단계를 세분화한 신규 Python 기반 skills 파일 추가
이를 통해 단순 요약이 아닌, 분석 단계별 흐름을 코드 단위로 분리해보고자 했습니다.
4. 에이전트 실행 과정에서 확인한 사항
업데이트된 에이전트로 분석을 요청하는 과정에서 여러 보완이 필요하다고 느낀 부분들이 있었습니다.
투자 분석을 위해 필요한 사용자 입력 정보가 충분하지 않음
일부 환경에서 인코딩 관련 오류 발생
Python 기반 skills의 자동 실행 흐름이 안정적이지 않음
이러한 부분을 정리하여 Claude Code에 개선을 요청했고, 그 결과 다음과 같은 보완 작업을 진행했습니다.
사용자 정보 수집 항목 추가
자동 실행 흐름 일부 수정
현재 시간과 캐시 데이터 체크 로직은 사용자 확인 과정을 거치지 않고 자동 실행처리하도록 수정
오류 상황을 고려한 로직 보완
5. CLAUDE.md 재정비 및 재실행
skills 구조 변경에 따라, 기존 CLAUDE.md의 내용도 함께 수정할 필요가 있었습니다.
자동화 규칙 일부 수정
분석 단계별 역할 재정의
knowledge / skills / context 간 참조 방식 정리
업데이트 이후 에이전트를 다시 실행한 결과, 기존에는 포함되지 않았던 추가 투자 분석 항목에 대한 결과를 확인할 수 있었습니다.
결과와 느낀 점
기술적인 측면에서는 초기 사례보다 한 단계 보완된 구조를 구성할 수 있었다고 생각합니다.
분석 기준을 프롬프트가 아닌 지식 파일 형태로 분리
투자 분석 로직을 코드 단위로 관리
에이전트의 역할과 범위를 보다 명확히 정의
다만 다음과 같은 한계도 함께 느꼈습니다.
분석 결과가 전반적으로 단순한 요약 수준에 머무름
판단 근거가 충분히 드러나지 않음
결과를 신뢰하기 위한 검증 단계가 마련되어 있지 않음
다음 단계
다음 단계에서는 분석 결과를 생성하는 데서 그치지 않고, 분석 결과를 좀 더 자세하게 제공하고 검증할 수 있는 절차를 추가해보고자 합니다.
아직 많은 부분이 미흡한 상태이므로, 본 사례에 대해 조언이나 의견을 주신다면 감사히 참고하겠습니다.
