전역 지시 파일 3줄과 위키·벡터 DB의 구분
에이전트코리아에서 오간 전역 지시 파일 3줄 문제, 모바일 클로드의 설정 부재, LLM 위키와 벡터 DB RAG의 구분 대화를 정리한 기사.
토요일 오후 4시 무렵, 에이전트코리아 대화창에서 한 참가자가 어제 들은 수업을 복습하는 중이라고 적었다. 복습하다 보니 자기 환경부터 손봐야 한다는 이야기였다.
클로드 코드에는 어느 작업 폴더에서든 먼저 읽히는 전역 지시 파일(CLAUDE.md)을 둘 수 있다(기사 설명). 참가자들이 줄여서 전역 md라 부른 것이 이 파일로 읽힌다.
전역 클로드 md 부터 손대야하는데
이 참가자는 자기 전역 md가 세 줄짜리라고 털어놓았다. 다만 자기 환경에서는 그래도 잘 돌아갔다고 했는데, 전역 md가 구글드라이브에 있는 md를 읽게 해 두었기 때문이라는 설명이었다.
폴더를 나누려던 계획과 두 줄
이 참가자는 원래 일할 때, 개인사를 볼 때, 잡다한 일을 할 때, 자료조사를 할 때마다 구글드라이브의 다른 폴더를 읽히려 했다고 한다. 폴더는 모두 네 개였다.
하지만 귀찮아져서 두 줄만 만들고 잠들었다가 다음 날 잊었다고 했다. 앞서 말한 세 줄짜리 파일과 이 두 줄이 어떤 관계인지는 대화에 풀려 있지 않다. 문제는 그다음에 드러났다. 모바일에서 쓰는 클로드에는 전역 md가 없었다는 것이다.
근데 그렇게했더니 문제가 모바일환경에서 쓰는 클로드는 전역md가없음…
이 참가자는 모바일 클로드에 읽혀 봤다고 하고, 그래서 지금 고치는 중이라고 적었다. 이는 한 사람의 경험담이며, 모바일 클로드 일반의 동작으로 확인된 것은 아니다.
위키와 벡터 DB는 무엇이 다른가
이후 세컨드브레인이라는 이름이 주소에 들어간 페이지를 앞서 공유했던 참가자가 감격했다며 말을 보탰다. 자기 말을 이해하고 적용해 주는 사람이 있다는 취지였다. 이어 샌드박스와 독립 공간, 독립 에이전트 적용, 결정론적·비결정론적 워크플로우, RAG DB 설계와 가중치 제어 정도만 배우면 된다고 했다. 이 항목들은 이름만 오갔고 풀이는 나오지 않았다. 그만큼이면 웬만한 현업 문제는 다룰 수 있다는 주장이었다.
이때 다른 참가자가 LLM 위키와 그냥 윈도우 폴더로 분류해 두는 것이 무엇이 다르냐고 물었다. 답은 뭘 다르냐는 투로 짧게 돌아왔다.
걍 폴더정리하고 규칙적어둔게 llm 위키지
곧이어 벡터 DB를 쓰는 방식과의 경계도 그어졌다.
디비 벡터로 임베딩해서 원하는거 읽게하겠다 이게 벡터 db rag 임베딩이고
임베딩은 글을 숫자 벡터로 바꿔 의미가 가까운 것끼리 찾게 하는 방식, RAG는 그렇게 찾은 자료를 모델에게 읽혀 답하게 하는 방식을 뜻한다(기사 설명). 이 구분대로라면 위키는 사람이 정리한 폴더와 규칙을 모델이 따라 읽는 쪽이고, 벡터 DB는 검색 인프라를 따로 두는 쪽이다. 어느 쪽이 더 낫다는 결론은 대화에서 나오지 않았다.
구조를 공유하는 것의 쓸모
이날 오간 이야기를 이어 보면 흐름이 하나로 읽힌다. 세컨드브레인 페이지 주소가 올라왔고, 누군가는 자기 지시 파일이 세 줄이라는 사실을 다시 떠올렸으며, 다른 누군가는 위키와 폴더 정리의 차이를 물었다. 또 한 참가자는 "이거"를 그대로 보내 PC 설정을 정리시켰더니 청소되지 않은 스킬과 설정이 마구 나왔다며 감사 인사를 남겼다. 다만 "이거"가 무엇을 가리키는지는 대화에 적혀 있지 않다.
이는 남이 공유한 구조가 자기 환경을 점검하는 계기로 이어지고 있음을 시사한다. 지시 파일의 길이나 위치처럼 평소 눈여겨보지 않던 부분이 남의 구조와 맞대어 보면서 드러난 셈이다. 다만 페이지를 공유한 참가자 스스로 내용은 없긴 하다고 덧붙였다는 점도 함께 적어 둔다. 판단 기준과 결정 기준, 추상화 수준을 넣어 둔 것이라 괜찮을 것 같다는 것이 이 참가자의 설명이었다.