Spark
Spark
🏆 AI 챔피언
🏡 내집마련 찐친

AI 에이전트 다섯과 3시간 반 만에 만든 '노트+메모+지식그래프' 앱

📝 한줄 요약

리버스 엔지니어링 MCP인 REA를 연결하는 데서 출발해, Claude Code를 코디네이터로 두고 cursor·opencode·Antigravity 워커를 병렬로 돌려 약 3시간 반 만에 노트앱·메모앱·지식그래프가 하나로 합쳐진 개인 지식관리(PKM) 웹앱을 만들어 내 도메인에 배포했습니다. 폰과 태블릿에 앱처럼 설치해 씁니다. (커밋 34개, 코드 약 2만 8천 줄)

🎯 왜 시작했나

생각은 노트앱에 정리하고, 장보기나 번뜩이는 아이디어는 메모앱에 적었습니다. 그런데 이 둘이 따로 놀다 보니 "그때 어디에 적었더라?"를 자주 하게 됐고, 업무 단톡방에 흘러간 이야기들은 아예 다시 찾을 수가 없었습니다.

마침 Andrej Karpathy가 소개한 LLM Wiki 방법론이 떠올랐습니다. 원본 자료는 그대로 두고, LLM이 위키 페이지를 직접 쓰고 서로 링크로 엮어 관리하게 하는 방식입니다. 그렇다면 노트와 메모를 한곳에 모으고, 그걸 LLM이 위키와 지식그래프로 정리해서, 내 AI 에이전트들이 그 위키를 기억처럼 읽게 만들 수 있지 않을까 싶었습니다.

목표는 세 가지였습니다.

  1. 노트앱과 메모앱의 기능을 한 앱에서 쓰기 (로그인 포함, 내 도메인으로 접속)

  2. 폰·태블릿에 설치해 알림과 공유까지 되는 '진짜 앱'처럼 쓰기

  3. 노트·메모, 그리고 업무 단톡방 대화를 각각 LLM Wiki와 지식그래프로 만들기

🔧 작업 과정

0. 출발점: 리버스 엔지니어링 MCP, REA를 연결했습니다

처음 계획은 "마음에 드는 앱의 기능을 분석해서 내 앱으로 다시 만든다"였습니다. 그래서 첫 요청은 앱 개발이 아니라 도구 설치였습니다. REA(Reverse Engineer Anything)는 에이전트를 분석 도구에 연결해 주는 MCP 서버입니다. 네이티브 바이너리, Electron·JavaScript 앱, .NET, 안드로이드 APK, 웹사이트까지 하나의 MCP로 들여다보고, 결론마다 근거를 붙여 돌려줍니다.

💡 이때 쓴 프롬프트 https://github.com/morluto/rea/blob/main/docs/readme/README_ko.md 설치해줘

Claude Code는 README를 읽고 Node 버전과 ps 같은 사전 요구 사항을 확인했습니다. 설정 명령은 바로 실행하지 않고, 먼저 --dry-run으로 무엇이 바뀌는지부터 봤습니다. 그 과정에서 클라이언트 이름이 claude-code가 아니라 claude_code라는 것도 찾아냈습니다.

npx rea-agents setup --client claude_code --dry-run   # 바뀔 내용 미리 보기
npx rea-agents setup --client claude_code --yes       # MCP 등록 + 스킬 설치 (기존 설정 자동 백업)

이걸로 Claude Code 설정에 REA MCP 서버가 등록되고, reverse-engineer-anything 스킬이 설치됐습니다. 디컴파일이 필요한 네이티브 분석에는 Ghidra 같은 엔진을 따로 연결해야 하지만, JavaScript·Electron 정적 분석은 그대로 쓸 수 있는 상태였습니다.

1. 그리고 본론: 앱을 만들어 달라는 한 문장

💡 이때 쓴 프롬프트 노트앱과 메모앱의 기능을 분석해서 pkm.내도메인.com 으로 접속해 쓸 수 있게 해줘. 로그인 기능을 추가하고, 두 앱의 기능을 최대한 구현해줘. 필요하면 멀티에이전트 스킬을 써서 구현해도 좋아.

여기서 Claude Code가 먼저 한 판단이 인상적이었습니다. 이번 대상인 노트앱과 메모앱은 로그인 뒤에서 동작하는 웹 서비스라서, REA가 열어 볼 실행 파일이나 앱 패키지가 서버에 없었습니다. 브라우저로 관찰해도 로그인 화면까지밖에 보이지 않습니다. 또 상용 서비스의 코드를 뜯어 그대로 옮기는 건 맞지 않습니다. 그래서 REA로 코드를 분석하는 대신, 공개된 기능과 화면을 기준으로 처음부터 새로 짜는 방식(클린룸)으로 방향을 잡았습니다.

그다음 바로 코드를 쓰지 않고 서버 상태부터 살폈습니다. 도메인이 Cloudflare 터널로 이 서버에 연결돼 있다는 것, 이미 다른 서비스들이 쓰는 포트가 어디인지까지 확인한 뒤에 설계를 시작했습니다.

2. 뼈대와 '계약'을 먼저 고정하고, 그다음에 나눴습니다

여기서 배운 게 가장 큽니다. Claude Code가 먼저 직접 만든 것은 서버 API, DB 구조, 로그인, 그리고 각 기능이 서로 주고받을 컴포넌트의 모양(빈 껍데기) 이었습니다. 예를 들어 "데이터베이스 화면은 이런 이름과 입력값으로 만든다"를 먼저 정해 두고 나서야 작업을 나눴습니다.

그 뒤로는 기능마다 담당 워커를 정하고, 각자 고칠 수 있는 폴더를 딱 정해서 동시에 돌렸습니다. Orca라는 멀티에이전트 도구가 워커마다 별도의 git 작업 공간(worktree)을 만들어 줘서, 서로의 코드를 밟지 않았습니다.

💡 워커에게 준 공통 규칙 (그대로 복붙해 쓰셔도 됩니다) 너는 다른 워커들과 같은 프로젝트를 동시에 작업한다. 맡은 폴더 밖은 고치지 마라. - 새 서버 코드는 새 파일로 만들고, 공용 파일에는 한 줄만 추가해라. - 공용 타입 파일에는 덧붙이기만 하고 기존 내용은 바꾸지 마라. - 빌드가 반드시 통과해야 하고, 브라우저(Playwright)로 직접 눌러 보고 스크린샷을 확인해라. - 끝나면 내 브랜치에 커밋하고, 최신 master를 병합한 다음 완료를 보고해라.

3. 노트 · 데이터베이스 · 메모가 동시에 만들어졌습니다

세 갈래가 병렬로 진행됐습니다.

  • 노트: 슬래시(/) 메뉴로 블록을 넣는 에디터, 페이지 트리 끌어다 놓기, 커버·아이콘, 웹에 게시, 버전 기록, 26개 언어 코드 문법 강조

  • 데이터베이스: 표·보드·목록·갤러리·캘린더·타임라인 6가지 보기, 속성 16종(수식·관계형 포함), 필터·정렬

  • 메모: 카드 그리드, 체크리스트, 12가지 색, 라벨, 알림, 보관처리, 휴지통, 다른 사람과 함께 편집

4. 쓰다 보니 생긴 요구도 그때그때 반영했습니다

처음엔 노트앱과 메모앱이 따로 떠 있었는데, 메모를 고르다 노트로 가려면 오른쪽 위 버튼까지 가야 해서 불편했습니다. "왼쪽 패널 하나로 통일하고, 크게 노트와 메모 그룹으로 정리해줘"라고 하자 두 앱이 하나의 사이드바를 공유하는 구조로 바뀌었습니다. 아이콘이 기존 서비스를 너무 닮았다는 말에는 새 아이콘(접힌 종이 위에 지식 노드)도 그려 줬습니다.

이어서 폰과 태블릿에서 쓰기 위한 기능을 붙였습니다.

  • 홈 화면에 앱으로 설치, 오프라인에서도 마지막 내용 보기

  • 앱이 꺼져 있어도 오는 알림(웹 푸시), 앱 아이콘 배지

  • 다른 앱에서 PKM으로 공유하면 "메모로 저장 / 노트로 저장" 선택

  • 첨부한 PDF·워드·엑셀·파워포인트·한글(hwp) 문서 미리보기

5. 메모가 지식이 되는 길: LLM Wiki와 지식그래프

마지막 단계가 이 프로젝트의 핵심입니다. 위키를 두 개 만들었습니다. 노트·메모를 모은 개인 위키와, 업무 단톡방 세 곳의 대화와 첨부 문서를 모은 팀 위키입니다.

Karpathy 방식 그대로 세 층으로 나눴습니다.

  • 원본(raw): 내보내기 스크립트만 쓰고, LLM은 읽기만 합니다. 전화번호·계좌번호 같은 개인정보는 여기서 가립니다.

  • 위키: LLM이 원본을 읽고 요약·인물·개념·주제 페이지를 만들며 [[링크]]로 엮습니다. index.md(색인)와 log.md(작업 기록)도 LLM이 관리합니다.

  • 규약(AGENTS.md): 페이지 형식, 근거 다는 법, 상충하는 정보 처리법을 사람이 정합니다.

💡 위키 규약의 핵심 부분 (AGENTS.md 발췌) - raw/ 는 읽기 전용이다. 모든 사실의 근거이며 절대 수정하지 않는다. - 새 원본이 오면: 원본을 끝까지 읽고 → sources/ 요약 페이지를 만들고 → 언급된 인물·개념 페이지를 찾아 갱신하거나 새로 만들고 → index.md를 고치고 → log.md 맨 아래에 기록한다. - 사실에는 근거를 단다. 원본에 없는 사실은 쓰지 않는다. - 충돌하는 정보는 지우지 말고 날짜·출처와 함께 둘 다 남긴다.

매일 새벽 3시 반에 Claude Code가 헤드리스로 돌면서 새 원본을 위키에 반영하고, 일요일마다 위키를 점검합니다. 위키는 git으로 관리해서 LLM이 고친 내용을 전부 되돌릴 수 있습니다. 완성된 위키는 제 AI 에이전트가 읽을 수 있도록 스킬로 연결해 두었습니다. 위키가 채워지면 "지난주 단톡방에서 정한 마감이 언제였지?" 같은 질문에 위키 페이지를 근거로 답하게 하는 게 목표입니다.

지식그래프는 처음엔 노드가 원 안에 빽빽하게 몰려 글자가 겹쳤습니다. "생동감 있게, 텍스트와 노드 스케일을 맞춰 가독성 좋게"라고 요청했더니, 노드가 퍼져 나오며 자라는 애니메이션, 마우스를 올리면 연결선을 따라 빛 입자가 흐르는 효과, 겹치는 라벨을 자동으로 숨기는 기능이 들어갔습니다.

😓 막혔던 순간

로그인했는데 자꾸 튕겨 나왔습니다. 계정도 세션도 정상인데 로그인 직후 다시 로그인 화면으로 돌아갔습니다. Claude Code가 서버에 요청 로그를 잠깐 켜고 제가 한 번 더 시도하게 했더니, 로그인 직후 요청에 쿠키가 아예 실려 오지 않는 게 보였습니다. 원인은 http로 접속하면 https 전용 쿠키를 브라우저가 버리는 것이었고, http를 https로 넘기는 한 줄로 해결됐습니다. 감으로 고치지 않고 로그를 보고 고친 게 좋았습니다.

워커가 항상 말을 잘 듣지는 않았습니다. codex 워커는 시작하자마자 "업데이트할까요?" 질문에 멈췄고, 업데이트 후에는 계정에서 쓸 수 없는 모델로 설정돼 멈췄습니다. 이 작업은 cursor에게 다시 맡겼습니다. 또 워커들이 최신 master를 병합하지 않고 완료를 보고해서 파일 9개가 한꺼번에 충돌한 적도 있었습니다. 두 기능이 같은 onShare라는 이름을 서로 다른 뜻(공동작업자 창 vs 다른 앱으로 보내기)으로 쓰고 있었던 게 특히 까다로웠습니다. 그 뒤로는 작업 명세에 "완료 보고 전에 master를 병합하라"를 넣었습니다.

비용도 지켜봐야 했습니다. 한 워커는 디자인을 다듬으며 스크린샷 확인을 계속 반복했고, 사용 크레딧 표시가 20분 만에 900에서 1,250 넘게 올라갔습니다. 결과물이 이미 충분히 좋아서 중간에 멈추고 Claude Code가 마무리했습니다. LLM Wiki도 밀린 단톡방 원본 181개를 한 번에 넣으면 비용이 커서, 하루 6묶음씩 나눠 처리하도록 했습니다.

REA는 도구를 고르는 기준을 남겼습니다. 결과적으로 이번 프로젝트에서 REA로 기존 앱을 분석하지는 않았습니다. 대신 "무엇을 분석할 수 있고 무엇은 다시 만들어야 하는지"가 분명해졌습니다. 한 가지 더, MCP는 등록한 뒤 에이전트를 다시 시작해야 도구가 불러와집니다. 설치한 세션에서 바로 쓰려고 하면 도구가 보이지 않습니다.

대상

REA로 할 수 있는 것

이번 같은 경우

설치형 데스크톱 앱(Electron)

모듈·IPC·preload 구조 추적, 기능 동작 원리 설명

해당 없음

안드로이드 APK, 바이너리, .NET

디컴파일·심볼·호출 관계 분석 (엔진 연결 필요)

해당 없음

로그인 뒤 웹 서비스

공개 페이지 구조·네트워크 관찰 정도

기능·화면 기준 클린룸 재구현

📊 결과

  • 시간: 첫 요청부터 배포·정리까지 약 3시간 반 (커밋 34개, 코드 약 2만 8천 줄)

  • 기능: 블록 에디터 노트, 6가지 보기의 데이터베이스, 공유되는 메모, PWA 설치·알림·공유, 13가지 이상 문서 미리보기, 위키 2개와 지식그래프

  • 운영: 내 도메인 + 로그인, 가입 차단, 매일 자동 백업, 매일 자동 위키 갱신과 주간 점검

  • 분업: Claude Code(설계·병합·배포) + cursor·opencode·Antigravity(기능 개발). 워커에게 맡긴 기능 9건을 모두 병합했고, 그중 1건은 codex가 두 번 멈춘 뒤 cursor가 이어받았습니다.

💡 핵심 팁

분석 도구는 대상에 맞춰 고르세요. REA 같은 리버스 엔지니어링 MCP는 내 PC에 있는 앱 패키지나 바이너리를 분석할 때 힘을 냅니다. 로그인 뒤 웹 서비스라면 기능 목록과 화면을 근거로 새로 짜는 쪽이 빠르고 깔끔합니다. 그리고 분석은 언제나 본인이 소유했거나 분석 권한이 있는 소프트웨어에만 하세요.

멀티에이전트로 나누기 전에 '계약'부터 고정하세요. 서로 주고받을 데이터 모양과 컴포넌트 이름을 코디네이터가 먼저 만들어 두고, 워커마다 고칠 수 있는 폴더를 정해 주면 병렬 작업이 놀랄 만큼 잘 맞물립니다. 그리고 작업 명세에 "끝나면 최신 master를 병합하고 빌드·브라우저 확인까지 하고 보고하라"를 꼭 넣으세요. 병합 지옥의 대부분이 여기서 사라집니다.

🚀 다음 계획

  • REA로 설치형 앱(Electron 데스크톱 앱 등)의 기능 구조를 분석해, 내 앱과 비교하는 다음 사례 만들어 보기

  • 에이전트가 위키를 읽고 답하는 "에이전트에게 묻기"를 앱 안에 붙이기

  • 단톡방 위키를 팀 에이전트의 기억으로 연결하기

  • 위키가 채워지면서 지식그래프가 어떻게 자라는지 기록해 보기


작성일: 2026-10-20 | 도구: Claude Code, REA(MCP), Orca(cursor · opencode · Antigravity · codex) | 프로젝트: PKM

5
지피터스 뉴스레터

이번 주 AI, 딱 쓸 것만

매주 월요일 오후,
읽고 바로 써먹을 AI 소식만