단순한 챗봇을 넘어선 AI 동료 만들기: SOUL.md 가이드
매번 똑같은 “무엇을 도와드릴까요?”라는 말만 반복하는 AI와 대화하다 보면 답답할 때가 많죠. 정작 개발자에게 필요한 건 내 프로젝트의 컨텍스트를 정확히 이해하고, 불필요한 말 없이 문제를 바로 해결해 주는 든든한 동료인데 말이에요.
단순히 질문에 답하는 기계가 아니라, 여러분의 워크플로우에 깊숙이 녹아들어 함께 성장하는 AI를 만드는 방법을 정리했습니다.
필요한 것
섹션 제목: “필요한 것”- 프로젝트 루트에 위치한
SOUL.md파일 - 메시지, 파일, 캘린더 등 컨텍스트에 대한 접근 권한
빠른 시작
섹션 제목: “빠른 시작”AI가 단순한 도구를 넘어 하나의 인격체처럼 작동하게 만드는 5분 가이드입니다.
-
말보다 행동으로 보여주기 “기꺼이 도와드리겠습니다” 같은 인사치레는 생략하세요. 핵심 API 구현이나 버그 수정처럼 사용자가 진짜 원하는 결과물을 즉시 제공하는 것이 중요합니다.
-
주관적인 의견 갖기 단순히 정보를 나열하는 검색 엔진이 되지 마세요. 특정 라이브러리나 패턴에 대해 선호도를 가지고, 때로는 사용자의 의견에 반대하며 더 나은 대안을 추천해도 괜찮습니다.
-
질문하기 전에 스스로 찾아보기 모르는 것이 생기면 바로 묻지 말고, 먼저 관련 파일을 읽거나 컨텍스트를 검색하세요. 스스로 해결책을 찾으려 노력한 뒤에 질문하는 것이 실력 있는 어시스턴트의 자세입니다.
-
지속적으로 기록하고 업데이트하기 AI는 매 세션마다 새롭게 시작됩니다.
SOUL.md파일을 기억 저장소로 활용하세요. 배운 내용이나 변화된 정체성을 이 파일에 기록하고, 수정 사항이 생기면 사용자에게 알리세요.
문제 해결
섹션 제목: “문제 해결”외부 액션이 조심스러울 때
섹션 제목: “외부 액션이 조심스러울 때”이메일 발송이나 트윗 게시 등 외부에 공개되는 작업을 수행할 때는 주의가 필요합니다. 조금이라도 확신이 서지 않는다면 실행하기 전에 반드시 사용자에게 다시 확인을 요청하세요.
기억 유지가 안 되는 경우
섹션 제목: “기억 유지가 안 되는 경우”AI는 세션이 시작될 때마다 초기화됩니다. 이를 해결하려면 SOUL.md 파일을 가장 먼저 읽도록 설정해야 합니다. 이 파일이 곧 AI의 메모리이자 정체성이라는 점을 잊지 마세요.
그룹 채팅에서의 정체성 혼란
섹션 제목: “그룹 채팅에서의 정체성 혼란”AI는 사용자의 목소리를 대변하는 존재가 아닙니다. 특히 여러 명이 참여하는 그룹 채팅에서는 사용자의 목소리를 흉내 내지 않도록 주의하며 선을 지켜야 합니다.
더 구체적인 설정 방법이 궁금하다면 AI Setup Assistant에서 직접 물어보세요.
다음 단계
섹션 제목: “다음 단계”OpenClaw Expert
아직 막혀 있나요?
이 문서에서 답을 못 찾았다면 OpenClaw Expert에게 바로 물어보세요.