MAPS 프레임워크로 자신만의 AI OS 구축하기
제 비디오 **Turn Claude Code Into Your AI Operating System (4 Layers)**의 무료 보조 자료입니다.
네 개의 레이어로 구성되어 있으며, 이 순서대로 구축하고 각 레이어별로 준비된 프롬프트와 사용자 인터뷰용 프롬프트, 그리고 대시보드 뷰를 위한 프롬프트를 제공합니다. Claude Code에 카드를 붙여 넣으면, 그것이 어떤 조각인지 한 단계씩 안내받으며 구축할 수 있습니다. 이 저장소의 ai-os-maps-guide.pdf와 동일한 가이드입니다.
시작하기 전에 한 가지 알아두세요: 이 카드들은 사용자의 Claude 구독을 사용하는 Claude Code를 위해 작성되었습니다. 생성되는 파일은 일반 마크다운(plain markdown)이므로 나중에 어떤 LLM도 읽을 수 있습니다. 하지만 다른 에이전트를 다른 구독으로 실행할 경우, 먼저 해당 제공업체의 약관을 확인하세요 (카드 2 참조).
준비된 대시보드 인터페이스
준비된 대시보드 인터페이스를 원하시나요? 이는 유료 Patreon Builder 멤버십($15/월)을 통해 이용할 수 있습니다. MAPS 가이드는 무료로 유지됩니다.
Current dashboard switching between six animated graph views with fictional sample data
MAPS
| 문자 | 레이어 | 한 줄 설명 |
|---|
| M | Memory | 사용자가 가리키지 않아도 Claude가 작업하는 모든 것의 지도를 만들어 어떤 사실이든 찾을 수 있게 합니다 |
| ... | | |
| 구축 순서는 정확히 이 순서를 따르세요. 대시보드는 제가 가장 마지막에 구축한 것이며, 솔직히 전체 가치 중 20% 정도입니다. 나머지 부분은 지도와 루틴들입니다. | | |
무언가를 구축하기 전에 던져야 할 세 가지 질문
- 사용자가 파일을 가리키지 않아도 Claude가 작업에 대한 어떤 사실이든 두 번의 연결(two hops) 내에서 찾을 수 있나요?
- 설정된 것 중 노트북이 닫혀 있을 때도 작동하는 것이 있나요?
- 대시보드가 단순히 무언가를 보여주는 곳인가요, 아니면 진실이 자리 잡은 장소가 되었나요?
현재 위치는 어디인가요? 네 개의 사다리
| Layer | Level 1 | Level 2 | Level 3 |
|---|
| Memory | 폴더들의 집합, Claude가 질문 하나에 답하기 위해 20개의 파일을 읽음 | 폴더 대신 안내 표지판 파일 사용 | 매일 밤 확인하는 생성된 지도 |
| ... | | | |
| 각 카드는 하나의 레이어를 레벨 3까지 구현합니다. | | | |
Card 0: 먼저 Claude에게 인터뷰를 받으세요
아무것도 없는 상태에서 시작한다면, 지도를 직접 작성하지 마세요. 질문을 하나씩 스무 분 동안 받는 것이, 오후 내내 폴더 이름을 타이핑하는 것보다 Claude가 작업할 더 많은 자료를 제공합니다. 원하는 만큼 여러 번 실행하고, 매번 다른 주제로 진행하세요. 모든 세션마다 파일이 남게 됩니다.
아무것도 쓰기 전에, 저에게 인터뷰해 주세요. 질문을 하나씩 하고 제 답변을 기다려 주세요. 다음 순서에 맞춰 다뤄주세요: 제가 어떤 사업을 하며 누구를 위해 하는지, 매주 다섯 가지 활동, 현재 누군가에게 빚진 것이 있는지 등...
Card 1: 메모리 (Memory)
여기서 메모리란 채팅 기록을 의미하는 것이 아닙니다. Claude가 사용자가 없어도 올바른 파일을 찾을 수 있는지를 의미합니다. 맨 위에는 사실(fact)이 전혀 담겨있지 않은 짧은 파일 하나(제 것은 40줄입니다)가 있으며, 오직 작업 영역별로 어디에 무언가가 존재하는지만 알려줍니다. 각 줄은 해당 영역의 안내 표지판 파일을 가리키고, 그 파일이 실제 문서를 가리킵니다. 따라서 모든 문서는 맨 위에서 두 단계 거리에 있습니다.
안내 표지판(signpost) 아이디어는 Jay E의 Agentic OS 영상에서 가져왔으며, 생성된 지도와 매일 밤 확인하는 기능은 제가 추가한 것입니다.
이 시스템을 신뢰성 있게 유지하기 위한 두 가지 규칙이 있습니다:
- 모든 사실에는 정확히 하나의 집(home)이 있다. 아무것도 두 번 작성되지 않습니다.
- 매일 밤 작은 검사(check)가 실행되어 이동한 파일에 연결된 안내 표지판을 플래그 지정함으로써, 지도가 조용히 구식이 되는 것을 막습니다.
성과 측정의 중요성. 동일한 질문을 가지고 작업 공간에서 Claude Code 세션을 두 번 실행해 보았습니다. 'LinkedIn 게시물에 절대로 사용해서는 안 되는 단어는 무엇이며, 그 내용은 어디에 기록되어 있나요?' 이 질문은 두 번 모두 올바른 파일을 찾아냈습니다. 맵(map)이 없을 때: 1분 2초, 읽기 및 쓰기 과정에서 27.7k 토큰 소모 (/context의 Messages 라인). 맵이 있을 때: 30초, 16.8k 토큰 소모, 약 40% 적습니다. 두 번째 실행에서는 읽는 간격(reading gap)이 더 작았지만, 맵을 사용했을 때가 여전히 약 두 배나 빨랐습니다.
Scan my project folders and draft a memory map: one master signpost file under 60 lines listing my areas of work, and one signpost file per area under 80 lines, with these fixed sections in this order: Projects, State,
...
Card 2: Agent
동일한 Claude Code를 두 대의 기기에서 실행했습니다. 바로 여러분의 노트북과 절대 잠들지 않는 클라우드 임대 소형 컴퓨터(제 것은 Hostinger VPS입니다). 두 기기는 동일한 폴더 사본을 가지고 있으며, git을 통해 양방향으로 5분마다 동기화됩니다. 따라서 Claude가 어떤 기기에서 실행되든 동일한 맵과 기술을 갖게 됩니다.
이 서버는 여러분이 잠든 동안에도 아무도 지켜보지 않는 상황에서도 작동하기 때문에 두 가지가 중요합니다:
- 공용 인터넷에 연결하지 마십시오. 저는 Tailscale(무료)을 사용하는데, 이를 통해 제 노트북, 휴대폰, 그리고 서버를 자체적인 사설 네트워크에 배치했습니다. 공용 주소가 없으며, 누군가 찾아올 곳도 없습니다.
- 의도적으로 그곳에서 실행되는 Claude의 기능을 제한하십시오. 하나의 설정 파일이 전송, 공유 또는 삭제할 수 있는 모든 도구를 차단합니다. 이 도구는 저를 위한 이메일을 작성할 수는 있지만, 실제로 보낼 수는 없습니다. 최악의 경우에도 초안을 남기는 것 이상은 할 수 없습니다.
약관 확인. Anthropic의 약관은 다른 사람의 앱이나 에이전트 하네스(agent harness)를 통해 Claude 구독을 사용하는 것을 허용하지 않습니다. 여러분이 할 수 있는 것은 서버 자체에서 Claude Code를 실행하는 것이며, 공식 setup-token 흐름을 통해 본인의 계정으로 로그인해야 합니다. 제가 하는 방식이며, 이는 구독료 외에 추가 비용이 들지 않습니다. 만약 다른 제공업체를 사용한다면 약관이 다르므로, 이 내용을 복사하기 전에 반드시 확인하십시오.
저는 복사된 세션이나 제3자 도구 대신 기존 구독을 통해 두 번째의 항상 켜져 있는(always-on) 기기에서 귀하를 무인으로 운영하고 싶습니다. 단계별로 설명해 주시고 각 단계를 확인해 주세요...
선택 사항: 휴대폰. 저는 서버에 있는 Telegram 봇에게 음성 메모를 보내면, 그것이 제 목소리를 텍스트로 변환하고, 제가 무엇을 요청하는지 파악하여 Claude가 같은 채팅에서 답변합니다.
항상 켜져 있는 기기에는 음성 또는 텍스트로 대화할 수 있는 작은 Telegram 봇을 만들어 주세요. 이 봇은 오직 저의 채팅 ID에만 응답하며 다른 누구는 무시해야 합니다. 음성 메모는 먼저 텍스트로 전사(transcribe)되어야 합니다. 각 메시지는 다음으로 라우팅됩니다...
Card 3: Pulse
하나의 파일이 모든 루틴을 나열합니다. 이름, 스케줄, 어떤 기기가 실행하는지, 무엇을 실행하는지, 그리고 시도 및 시간 제한입니다. 각 기기에 있는 스케줄러는 이 목록을 5분마다 확인하고 예정된 작업을 실행합니다. 모든 실행은 기록을 남기며, 이것이 나중에 대시보드가 읽는 내용이고, 한계(cap) 기능은 계속 실패하는 루틴이 밤새 전체 월간 할당량을 소진하는 것을 막아줍니다.
제가 가장 많이 사용하는 것인 아침 요약부터 시작해 보세요. 제가 잠에서 깨기 전에 채팅방에 도착하며, 밤사이 무슨 일이 있었는지, 오늘 무엇을 해야 하는지, 누가 저를 기다리고 있는지 등을 알려줍니다.
예정된 무인 작업을 위한 루틴 시스템을 설정하세요:
- 각 루틴의 이름, 스케줄, 어떤 기기가 실행하는지, 실행할 프롬프트 또는 기술(skill), 모델, 노력량 등 목록이 있는 레지스트리 파일...
Card 4: Screen
대시보드를 절대 만들지 않더라도 제가 지킬 규칙은 있습니다. 저장하지 말고 보여주세요(show, don't store). 모든 패널은 다른 무언가가 이미 작성한 파일에서 읽어옵니다. 제 노트북은 제 주간 계획에 대한 패널을 만드는데, 그곳에 제 트래커가 있기 때문입니다. 서버는 루틴 보드를 만들고, 그곳이 루틴이 실행되는 곳이기 때문입니다. 두뇌는 매일 밤 제 메모로부터 재구축됩니다. 페이지 자체는 아무것도 저장하지 않기 때문에 휴가 중 휴대폰으로 봐도 안전하며, 만약 대시보드가 내일 사라져도 저는 아무것도 잃지 않을 것입니다. 모든 사실은 여전히 제가 소유한 파일 안에 있습니다.
나의 대시보드에 추가할 액션: 레지스트리 내 각 루틴 옆에 재생 버튼을 하나 만듭니다. 이 버튼을 누르면 작은 요청 파일(루틴 이름, 시간, 요청자)이 큐 폴더에 기록될 뿐, 그 외에는 아무것도 하지 않습니다. 러너는
카드 5: 브레인 뷰 (링, 원, 영역, 링크, 타임라인, 3D 오빗)
내 대시보드의 중심은 나의 실제 파일 그래프입니다. 이것은 밤에 실행되는 루틴이 카드 1에서 지도를 따라가며 작성하는 하나의 JSON 파일로부터 구축됩니다: 모든 파일은 노드이며, 모든 표지판이나 참조는 링크입니다. 이 페이지는 그 하나의 파일을 여섯 가지 방식으로 그려냅니다. 제가 만든 사양(spec)이 이것이니; 카드 4가 존재하는 후 Claude Code에게 건네주세요. 가장 마지막에 만드세요. 사람들이 클릭하는 부분이지, 시간을 절약해 주는 부분이 아닙니다.
모든 레이어에 적용할 일곱 가지 규칙
- Claude는 작업을 완료로 표시하지 않고, 오직 당신만 체크합니다
- 스토어 파일은 추가(Append)하고, 전체를 다시 쓰지 않습니다
- 결정론적 코드(Deterministic code)가 어떤 모델 호출보다 먼저 실행됩니다
- 보여주고, 저장하지 마세요: 대시보드는 읽을 뿐, 진실의 소유자가 아닙니다
- 파일이 이동하는 동시에 표지판도 업데이트합니다
- 아무것도 삭제되지 않습니다: 아카이브하거나, 주차하거나, 되돌리기(undo)를 유지합니다
- 계획과 사양은 채팅에 있는 것이 아니라 레포지토리(repo)에 살아 있습니다.
내가 의도적으로 구축하지 않을 것들
- 대시보드 우선은 없다: 뷰는 마지막에 오며, 파일 위에 그 없이도 읽을 수 있다.
- 다른 구독에 별도로 부착하는 두 번째 에이전트 앱은 없다.
- git이 이미 하는 일을 하는 폴더 동기화 도구는 없다.
- 로그인 페이지가 있는 공개 대시보드는 없고, 사설 네트워크만 가능하다.
- 자체적으로 전송, 공유 또는 삭제할 수 있는 서버상의 것은 아무것도 없다.
비용
제가 이미 지불하는 Claude 구독료 외에 추가되는 비용은 다음과 같습니다: VPS(제 것은 작은 Hostinger 플랜으로, 블랙 프라이데이 할인가로 2년에 약 $140이며, 월간으로는 대략 $6 정도입니다)와 음성 전사 서비스의 몇 달 치 비용. 그게 전부입니다. 구매하기 전에 실시간 가격을 확인하세요. 플랜과 할인은 변경될 수 있습니다.
Pav가 제작했습니다. Automation Orbit에서 더 많은 내용을 YouTube에서 확인하세요: https://www.youtube.com/@pavrusovs