
Claude Code와 Codex를 '인생의 비서'로 만드는 운용 설계(전체상)
요약
Claude Code와 Codex를 개인 비서로 활용하기 위해 Markdown 기반의 'Portable Context Layer'를 구축하는 설계 방법을 제안합니다. 도구의 내장 기억 대신 외부 파일로 컨텍스트를 관리하여 에이전트 간 일관성을 유지하고 정보의 신뢰도를 높이는 것이 핵심입니다.
핵심 포인트
- Markdown 파일 기반의 Portable Context Layer 구축을 통한 컨텍스트 유지
- AGENTS.md, CLAUDE.md 등을 활용한 규칙과 데이터의 분리 관리
- 정보의 확도(Confidence)를 6가지 라벨로 구분하여 기억 오염 방지
- Git을 활용한 컨텍스트 변경 이력 추적 및 정본(Source of Truth) 관리
AI 에이전트를 「비서」로 사용하려면
Claude Code나 Codex에 질문하면 조사, 문장 작성, 코드 편집까지 짧은 시간 안에 진행할 수 있습니다. 반면, 세션이 바뀌면 전제가 사라지거나 이전의 추측이 사실처럼 취급되기도 합니다.
이 문제를 모델의 기억력만으로 해결하려 하지 않는 방법이 있습니다. AI가 참조하는 장기 컨텍스트 (Long Context)를 Markdown 파일의 집합으로서 수중에 두는 방법입니다. 저는 이를 Personal AI System의 portable context layer라고 부르고 있습니다.
portable context layer는 특정 도구의 내장 기억에 의존하지 않는 컨텍스트 층입니다. 에이전트를 전환하더라도 동일한 정본(Source of Truth), 동일한 운용 규칙, 동일한 사실 라벨을 참조할 수 있습니다. 인간이 직접 읽을 수 있기 때문에 오류를 발견했을 때 수정할 수 있으며, Git의 차분(Diff)을 통해 변경 이력도 확인할 수 있습니다.
최소 구성은 파일을 너무 늘리지 않는다
처음에 필요한 것은 다음과 같은 작은 구성입니다.
personal-ai-system/
├── AGENTS.md
├── CLAUDE.md
...
AGENTS.md에는 AI에게 영구적으로 적용할 응답 스타일, 사실의 취급, 완료 주장(Claim)의 검증 방법을 작성합니다. CLAUDE.md는 Claude Code를 위한 입구로서, 공통 규칙을 참조하는 얇은 래퍼(Wrapper)로 만듭니다. 개인의 목표나 답변 선호도는 context/에 두어 규칙과 데이터를 분리합니다.
source_of_truth.md에는 어떤 사실을 어떤 파일에서 관리할지 등록합니다. 예를 들어, 목표는 goals.md, 답변 선호도는 preferences.md, 제약 사항은 constraints.md입니다. 동일한 정보를 일일 브리핑이나 안건 메모에 전문 복사하지 않습니다. 요약을 두는 경우에도 정본에 대한 참조를 남깁니다.
아직 분류할 수 없는 메모는 inbox/unsorted.md에 둡니다. inbox를 장기 보관소로 만들지 말고, 주간 또는 월간 단위로 정본으로 옮기거나 불필요한 것을 정리합니다.
사실을 6가지 라벨로 관리한다
기억 오염을 방지하려면 정보의 내용뿐만 아니라 확도(Confidence)를 저장해야 합니다.
확인됨 (Confirmed): 이용자가 명시했거나 1차 정보로 확인한 것 -
관측됨 (Observed): 화면, 도구, 로컬 파일로부터 관측한 것 -
수집됨 (Imported): 엑스포트나 기존 자료로부터 가져온 것 -
추정 (Inferred): 여러 정보로부터 추론한 것 -
재확인 필요 (Needs Re-verification): 오래되었을 가능성이 있는 것 -
불명 (Unknown): 현 시점에서 판단할 수 없는 것
예를 들어 "다음 달 우선 목표는 신기능 프로토타입 제작"이라는 대화를 저장할 때, 본인이 명시했다면 '확인됨', 과거의 메모에서 읽어낸 것이라면 '수집됨', 여러 태스크로부터 추론한 것이라면 '추정'입니다. 추정을 '확인됨'으로 자동 승격시켜서는 안 됩니다.
레코드에는 상태뿐만 아니라 갱신일, 출처, 공유 범위도 붙입니다. 가격, 영업시간, 예정, 외부 서비스 사양처럼 변화하는 정보는 확인 시점을 남기고, 필요하다면 '재확인 필요'로 되돌립니다.
"이전에 샀다"를 "지금도 사용 중이다"로, "한때 마음에 들었다"를 "항상적인 선호"라고 결론짓는 것도 피해야 합니다. 과거의 기록, 현재의 관측, 본인의 확인을 별개의 정보로 다루는 것이 중요합니다.
자율성을 멈추는 것은 3가지만
AI에게 위임하는 범위를 너무 세세하게 나누면 실행할 때마다 확인이 발생합니다. 운용상으로는 정지 조건을 다음 3가지로 묶으면 다루기 쉬워집니다.
1. 특정 관리 대상 자산
퇴직한 조직 계정, 권한이 없는 운영 자산, 공유 금지 환경 등입니다. 명시적 지시가 없는 한 건드리지 않습니다.
2. 금전 · 계약
설정한 상한을 초과하는 지출, 새로운 결제처나 결제 수단, 계약, 해지, 정기 결제의 변경은 정지합니다. 금액이 상한 이내라도 연간 계약이나 갱신 조건이 불명확하면 멈춥니다.
3. 불가역 · 대외 조작
공개, 게시, 전송, 신청, 예약 확정, 구매 확정, 대량 삭제, 계정 삭제, 권한 변경, 본인 명의의 개별 메시지입니다.
이 외의 읽기, 검색, 초안 작성, 로컬 편집, 차분 생성, 가역적인 정리는 다른 제약에 반하지 않는 한 기본 자율(Default Autonomy)로 둡니다. 예를 들어, AI에게 기사 초안을 작성하게 하는 것은 허용하되, 공개 버튼을 누르는 것은 정지하도록 분리하는 것입니다.
정지할 때는 대상, 내용, 금액, 수신처, 영향 범위, 가역성을 제시합니다. 승인 후에는 입력만 한 것인지, 접수된 것인지, 외부로 반영되었는지를 재확인합니다.
워크플로우로 지속 운용한다
세션 시작 시에는 AGENTS.md, 00_START_HERE.md
、상담에 해당하는 색인(index)과 정본(正本)만을 읽습니다. 서두에 「참조한 파일」, 「확인된 전제」, 「불명확한 점」, 「다음 단계」를 제시하면 근거가 명확해집니다.
새로운 정보를 얻으면 정본 맵(正本 map)에 따라 저장 위치를 결정하고, 상태, 출처, 업데이트 날짜를 부여합니다. 비밀 정보, 인증 정보, 금융 원본, raw export는 Markdown에 두지 않습니다. 월 1회, 오래된 정보, 중복, inbox의 정체를 점검합니다.
일일 브리프(Daily Brief)는 정보 목록이 아니라, 판단을 위한 짧은 출력물로 만듭니다. 오늘의 결론, 예정, 3가지 액션, 회신/확인 필요 사항, 기한, 미확인 사항, 승인이 필요한 조작을 구분하면 다음에 무엇을 해야 할지 보입니다.
마지막으로, 「완료했습니다」라는 주장을 검증합니다. 로컬 파일을 변경했을 뿐이라면, 외부 서비스에 반영된 것은 아닙니다. 계획됨, 시도됨, 실행됨, 검증됨, 외부 반영됨을 구분하고, 차이(diff), 종료 코드, 재로드 결과 등의 증거를 첨부합니다.
요약
Personal AI System의 본질은 AI를 인간처럼 보이게 만드는 것이 아닙니다. 무엇을 올바른 것으로 취급할지, 어디까지 맡길지, 어떤 증거로 완료를 판단할지를 이용자가 확인할 수 있는 형태로 외부화하는 것입니다.
도입용 템플릿 repo와 상세 설계, 각 파일의 작성법, 30분 셋업, 멀티 에이전트(Multi-agent) 운용을 해설한 유료 도서는 다음 링크에서 확인할 수 있습니다.
Discussion

AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기