본문으로 건너뛰기

작은 파일로 다시 설계한 개인 에이전트

자동 기억과 복잡한 세션 DB 대신 작은 지침 파일과 기존 기록 검색으로 개인 에이전트를 다시 구성한 사례입니다.

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

TL;DR

개인 에이전트의 응답이 과거 선호와 자동 저장된 기억에 지나치게 끌리는 문제를 줄이기 위해, 글에서는 AGENTS.md와 개발 선호·할 일·기억 포인터 파일을 분리한 작은 폴더 구조를 다시 만들었습니다. Git의 commit과 diff가 파일 변경 이력을 남기므로 별도 log.md는 제거했고, 과거 대화도 숨김 세션 파일을 직접 검색하면 되기에 SQLite 데이터베이스를 추가하지 않았습니다. 반복 가능한 이메일 정리나 장부 관리 작업은 기본 지침에 섞기보다 skill.md로 분리하는 방향을 택했으며, 당분간 한 에이전트와 최소한의 기억만 유지하면서 기억의 적절한 개입 시점을 더 탐색하기로 했습니다.

섹션별 상세

01
개인 에이전트가 사용자의 취향과 과거 정보를 지나치게 많이 읽으면 새로운 아이디어를 탐색하기보다 기존 기록에 맞춘 답변으로 기울 수 있습니다. 글에서는 AGENTS.md에 사용자와 상호작용하는 방식, code.md에 개발 선호, todos.md에 현재 작업, memory.md에 기억 파일의 위치를 두는 최소 구조를 새로 만들었습니다. 이렇게 파일을 역할별로 나누면 에이전트가 무엇을 참고해야 하는지 통제하면서도 Claude와 ChatGPT 같은 여러 도구에서 같은 폴더를 사용할 수 있습니다.
근거
  • 개인 에이전트는 AGENTS.md, code.md, todos.md, memory.md 같은 작은 파일 조합으로 구성할 수 있습니다. Starting from scratch에서 새 폴더에 넣을 파일 목록과 각 파일의 역할을 설명한 부분
02
Codex는 코딩 에이전트라는 시스템 지침의 영향을 받아 개발 선호를 주 지침 파일에 합치고 log.md를 없애라는 방향으로 답했습니다. 그러나 개인 에이전트가 코딩 외 업무도 수행하므로 code.md를 분리했고, 파일 변경은 Git commit과 diff에 이미 남기 때문에 별도 로그 파일은 중복으로 판단했습니다. 이 과정은 에이전트의 제안을 그대로 채택하기보다 현재 목적과 기록 방식의 중복 여부를 따져 구조를 결정해야 한다는 점을 드러냅니다.
근거
  • Git의 commit과 diff가 파일 변경 이력을 남기므로 별도 log.md는 중복이 될 수 있습니다. The session에서 Git의 버전 저장, commit, diff, repository를 설명한 문단
03
자동 기억은 매일 또는 매주 대화에서 사용자와 작업에 관한 내용을 추려 파일에 저장하는 방식으로 구상됐지만, 기존 선호가 새 요청의 방향을 제한하는 문제가 생겼습니다. 에이전트는 파일에 적힌 텍스트를 바탕으로 응답하므로, 과거에 좋아한다고 기록된 방식에 계속 맞추면 브레인스토밍의 선택지가 좁아질 수 있습니다. 그래서 글에서는 자동 저장 대신 가장 작은 기억 파일을 유지하고, 그 내용을 사용자가 직접 확인한 뒤 필요할 때만 수정하는 접근을 택했습니다.
근거
  • 자동 기억은 과거에 적힌 선호가 새로운 브레인스토밍을 기존 방향으로 유도하는 문제를 만들 수 있습니다. Memory에서 자동 저장 기억이 응답을 특정 방향으로 기울게 한 경험을 설명한 부분
04
과거 대화를 별도 memory 파일에 계속 복사하지 않아도 에이전트 세션은 컴퓨터의 숨김 폴더에 파일로 남아 검색할 수 있습니다. Codex가 세션 ID와 날짜를 담은 SQLite 데이터베이스를 별도로 만들자는 방향을 제시했지만, 글에서는 검색 가능한 세션 파일을 그대로 활용하기로 했습니다. 데이터베이스를 추가하면 검색 구조를 정교하게 만들 수 있지만, 현재 요구인 과거 대화의 위치 찾기에는 관리 대상과 복잡성만 늘릴 수 있다는 판단입니다.
근거
  • 과거 에이전트 대화는 숨김 파일에 저장될 수 있어 별도 기억 파일이나 SQLite 데이터베이스 없이 검색할 수 있습니다. Remembering chats에서 dot files와 SQLite 세션 데이터베이스를 비교한 부분
05
개인 에이전트의 기본 지침과 반복 작업용 스킬은 서로 다른 층위로 분리할 수 있습니다. 이메일 분류처럼 절차가 반복되는 업무는 skill.md에 작업 지침과 역할을 적고, 사용자에 대한 공통 정보는 상위 폴더의 공유 기억으로 두는 방식입니다. 글의 현재 결론은 한 에이전트와 작은 파일·폴더 구조를 유지하면서 특정 업무가 실제로 반복될 때만 스킬 파일을 늘리고, 기억이 언제 개입해야 유용한지는 더 탐색하는 것입니다.
근거
  • 반복 가능한 업무는 기본 지침이 아니라 별도의 skill.md 파일로 분리할 수 있습니다. Instructions vs skills에서 agents.md와 skill.md의 역할을 비교한 부분

용어 해설

개인 에이전트(Personal Agent)
사용자의 파일과 지침을 읽고 반복적인 대화와 작업을 돕는 에이전트입니다. 별도의 복잡한 학습보다 AGENTS.md 같은 지침 파일, 기억 파일, 작업 폴더, 도구를 조합해 동작하며, 파일에 적힌 정보가 응답의 방향과 범위를 좌우합니다.
Git 저장소(Git Repository)
파일의 변경 이력을 저장하는 폴더입니다. 파일을 commit하면 특정 시점의 버전이 남고, diff로 이전 버전과 달라진 줄을 확인하거나 과거 상태로 되돌릴 수 있어 별도 작업 로그의 필요성을 줄일 수 있습니다.
닷 파일(Dot Files)
이름이 마침표로 시작해 기본적으로 숨겨지는 파일과 폴더입니다. Claude나 Codex 같은 에이전트의 세션 기록이 이런 위치에 저장될 수 있으며, 파일을 직접 기억 데이터로 복제하지 않아도 과거 대화를 검색할 수 있는 근거가 됩니다.
SQLite
컴퓨터의 한 파일 안에 표와 행 형태로 데이터를 저장하는 데이터베이스입니다. 에이전트 세션의 ID와 날짜 같은 메타데이터를 모아 검색 전용 저장소로 만들 수 있지만, 글에서는 기존 세션 파일 검색만으로 충분하다고 판단해 도입하지 않았습니다.
에이전트 스킬(Agent Skills)
이메일 정리나 장부 관리처럼 반복 가능한 작업 절차를 파일로 정의한 지침입니다. 기본 에이전트의 정체성과 공통 지침을 분리하고, 필요한 작업별 skill.md를 불러오는 구조로 재사용성과 관리 편의성을 높일 수 있습니다.

기술

  • Claude
  • ChatGPT
  • Codex
  • Git
  • SQLite
  • AGENTS.md
  • CLAUDE.md
  • skill.md

활용 사례

  • 개인 업무용 에이전트 구성
  • 과거 에이전트 대화 검색
  • 이메일 정리와 장부 관리 같은 반복 작업 자동화
  • 프로젝트별 개발 작업 관리
AI 분석 전체 내용 보기

AI 요약 · 북마크 · 개인 피드 설정 — 무료

출처 · 인용 안내

원문 발행 2026. 08. 21.수집 2026. 08. 21.출처 타입 RSS

인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.