개발 이야기2026년 11월 2일

가독 개발기 (feat. 정준경, 김가원)

가독(GaDoc)의 시작은 slacord라는 사이드 프로젝트였다.

(회사 선임님이 만들어 준 8초짜리 티저. 이 글의 내용이 8초 안에 다 들어 있다.)

slacord, 심심풀이의 시작

예전 회사를 퇴사하기 전에 심심풀이로 만들던 게 있었다. 이름하여 slacord. 이름에서 눈치챘겠지만 슬랙(Slack)이랑 디스코드(Discord)를 합친 이름이다. 당시에는 나름 슬랙의 장점과 디스코드의 장점을 다 합쳐 보겠다는 야심 찬(?) 물건이었다.

처음부터 맥이랑 윈도우에서 앱을 켜고 채팅하고 싶었다. 그래서 Electron으로 만들고, 윈도우용은 exe로, 맥용은 dmg로 배포할 생각이었다. 실제로 3월 24일에 Electron 데스크톱 앱이랑 릴리즈 파이프라인을 붙여 놨고, 데스크톱 알림이랑 업데이트 배지까지 연결해 뒀다. (웹으로 만들어서 앱처럼 쓰는 게 Electron의 맛 아니겠나.)

저장소를 다시 열어 보니 첫 커밋이 1월 2일이다. 새해 둘째 날부터 뭘 만들고 있었던 건지... 초기 커밋을 보면 팀이랑 방 관리, 초대 링크, 디스코드 아카이빙 같은 게 들어 있다. 3월에는 백엔드를 헥사고날 구조로 다시 짜면서 채널이랑 Socket.IO 실시간 채팅까지 붙였는데, 이때만 커밋이 116개다.

그리고 4월 이후로는... 자연스럽게 잠들었다. 5월부터 9월까지 커밋이 다 합쳐 8개다. 사이드 프로젝트의 흔한 결말이다.

MERMAID

그런데 10월에 갑자기 331개가 됐다. 무슨 일이 있었냐면...


노션 좀 쓰게 해 주세요

10월 말, 회사에서 일하다가 도저히 안 되겠다 싶은 순간이 왔다. 회의록 관리도 안 되고, 문서 관리도 안 되고... 그래서 노션 좀 지원해 달라고 했는데, 나름 워터폴이라 절차가 한가득이었다.

그래서 그냥 만들기로 했다. REA, 그러니까 리버스 엔지니어링으로. 노션에 있는 기능은 하나씩 뜯어보면서 따라 만들고, 잠들어 있던 slacord를 깨워서 그 위에 올렸다. 회사 친구 준경이랑 같이.

근데 노션을 그대로 베끼는 게 목표는 아니었다. 우리가 생각한 건 메시지 아카이빙에 가까웠다. 대화하다 나온 얘기를 그 자리에서 바로 이슈로 만들고, 정보로 정리해 두는 것. 그리고 나중에는 MCP로 AI를 붙여서, 같은 이슈에 얽힌 대화랑 문서를 이슈별로 알아서 묶어 주는 그림이었다. (슬랙에서 '그거 어디서 얘기했더라...' 하면서 스크롤을 끝없이 올리는 일은 이제 그만...)

그래서 지금 가독에서는 메시지에 마우스를 올리면 '이슈 연결'이 바로 뜨고(아래 #배포 채널 캡처에도 보인다), 이슈랑 연결된 메시지 아래에는 이슈 칩이 붙는다. MCP도 1.1.0에서 붙였다. 아직은 AI가 MCP로 가독의 문서랑 데이터베이스를 읽고 쓰는 단계고, 대화랑 이슈까지 이슈별로 묶어 주는 건 다음 목표다.


준경핑이 디자인 톤을 잡아 주고

역할은 자연스럽게 나뉘었다. 준경핑이 디자인 톤을 잡아 주고(홈페이지도 준경핑 작품이다), 나는 기능이랑 서버, 배포를 붙였다.

이름도 이때 바꿨다. 가독(GaDoc). 소개 문구는 '문서의 가닥이 잡히는 곳'. 가독, 가닥... 네, 말장난 맞다.


그리고 3일 반

그렇게 고도화를 시작했는데... 정신 차려 보니 3일 반 만에 Microsoft Store 등록까지 해 버렸다. 그 주를 날짜로 적어 보면 이렇다.

  • 10월 27일: 이름을 가독으로 바꾸고 소개 화면을 새로 달았다. 저녁엔 1.1.0(AI 연결, 공동 편집)을 main에 올렸다.
  • 10월 28일: 운영 서버도 slacord에서 가독으로 이사했다. MCP 연결 키 화면도 다듬었다.
  • 10월 29일: Microsoft Store 개발자 계정을 만들고 GaDoc 이름을 예약했다. 같은 날 메시지 아래 이슈 칩이 붙었고, iOS·안드로이드 앱 뼈대도 올라갔다.
  • 10월 30일: 첫 Store 제출. 한글 입력하고 Enter를 치면 메시지가 두 번 가던 버그도 이날 잡았다. (한국어 채팅 만들면 한 번은 꼭 만나는 그 버그...)
  • 10월 31일 아침 8시: Store에 공개!

커밋 수로 보면 더 웃기다. slacord 시절(1~4월) 커밋이 다 합쳐 166개였는데, 10월 27일부터 31일까지 닷새 동안 318개를 찍었다. 잠자던 사이드 프로젝트가 깨어나면 이렇게 된다...


생각보다 많이 쓴다

만든 사람 입장에서 제일 신기한 건 이거다. 생각보다 회사에서 꽤 많은 인원이 쓰고 있다.

11월 2일에 DB를 세어 보니 최근 일주일 동안 접속한 계정이 16개, 메시지를 보낸 사람이 12명이었다. 그 사이 오간 메시지만 1,819개. 일주일 된 사내 툴치고는 꽤 시끄럽다.

당시 실시간 채팅은 Socket.IO로 받고 있었고, 백엔드 프로세스 하나가 메모리 300MB 남짓을 쓰고 있었다. (나중에 사람이 더 늘면 그때 또 글 하나 나오겠지...)


영상까지 생겼다

툴 하나 만들었는데 영상이 세 개나 생겼다.

맨 위 8초짜리 티저는 회사 선임님이 만들어 줬다. 어떻게 만드셨냐고 여쭤봤더니 돌아온 답이 이거였다.

remotion, motion canvas, revideo 같은 것들 있어요. claude code한테 대본만 입력하면 뚝딱 만드네요

코드로 영상을 만드는 도구에 Claude Code를 붙여서, 대본만 주면 영상이 나오는 거다. (그 자리에서 바로 "스킬 기록해 놓겠습니다" 했다.)

나도 질 수 없어서(?)... 는 아니고, 사실 나는 그 전에 이미 하나 만들어 뒀었다. 내가 쓰던 스킬인 video-shotcraft로 뽑은 50초짜리 소개 영상이다. Remotion 위에서 도는 오픈소스 스킬인데, 실제 화면 캡처에 2.5D 카메라 무빙, 박자에 맞춘 컷, 효과음까지 장면별 레시피로 잡아 준다. Codex에 붙여서 썼고, 목소리는 TTS, 음악이랑 효과음도 프로젝트 안에서 직접 합성했다. 나오는 팀이랑 대화, 문서는 전부 소개용 가짜 데이터다.

첫 문장이 "그 얘기, 어디에 남겼더라?"인데, 가독을 만든 이유가 딱 이거다.

그리고 준경핑이 만든 홈페이지 영상. gadoc.kr 첫 화면에 들어가 있는 그거다. 디자인 톤 잡는 사람이 영상까지 만드니 확실히 때깔이 다르다...


11월 2일까지 붙인 기능

회의록이랑 문서 관리 때문에 시작했으니, 결국 하고 싶었던 건 대화하던 자리에서 바로 문서를 쓰고, 정한 일을 바로 할 일로 넘기는 거다. 홈페이지 문구 그대로 '대화의 다음을, 함께 만드는 곳'.

  • 채팅: 채널, 스레드, 이모지 반응, 파일 첨부, 메시지에서 바로 이슈 연결 (slacord 시절의 유산)
  • 허들: 소규모 팀용 음성·영상 통화랑 화면 공유 (디스코드 느낌 그대로)
  • 문서: 노션 스타일 블록 편집, 문서 트리, 버전 기록, 여럿이 같이 쓰는 공동 편집, Confluence 문서 가져오기
  • 문서 데이터베이스: 표에 관계·롤업·수식, 달력이랑 타임라인 보기까지
  • 이슈: 칸반 보드
  • AI 연결: MCP로 문서랑 데이터베이스 읽고 쓰기
  • 공지, GitHub 알림 연동
  • 데스크톱 앱: 맥은 서명·공증된 dmg, 윈도우는 Microsoft Store
  • 모바일 앱: iOS·안드로이드 준비 중

시스템 아키텍처

구조는 생각보다 단순하다. 그림으로 그리면 이렇다.

웹, 데스크톱, 모바일, AI 도구 전부 nginx 하나를 지나 맥미니 위 컨테이너 하나로 들어온다. 그 안에서 PM2가 Next.js 프론트랑 NestJS 백엔드를 띄우고, 백엔드 하나가 REST API, Socket.IO 실시간 채팅, Yjs 공동 편집, MCP 서버를 한꺼번에 맡는다. 백엔드는 헥사고날, 프론트는 FSD로 나눠 놨다.

DB는 같은 컨테이너 안의 MongoDB 9.0이다. 얼마 전에 standalone에서 레플리카셋으로 바꿨는데, 그 얘기는 가독 MongoDB 운영기에 따로 적었다. 첨부 파일이랑 데스크톱 설치 파일은 호스트에 Homebrew로 띄운 MinIO에 쌓인다.

그리고 맥미니에서는 launchd로 채팅 명령 실행기가 돌고 있다. 채팅에서 받은 명령을 가져가서 빌드랑 배포를 대신 해 준다.


채팅으로 배포까지

만들면서 제일 잘한 것 같은 건 채팅 배포다. #배포 채널에서 명령 하나면 된다.

  • @웹: DB 백업부터 뜨고, 빌드해서 운영 웹을 바꾼다.
  • @일렉트론: 맥미니가 데스크톱 앱을 빌드하고 서명·공증까지 해서 게시한다. 버전도 알아서 올리고 Microsoft Store 제출까지 간다.
  • @테스트: main CI를 한 번 돌리고 결과만 알려 준다.

가독으로 가독을 배포하는 셈이다. (도그푸딩의 끝...?)

왜 굳이 맥미니가 직접 빌드하냐면... 돈 때문이다. 가독 저장소는 비공개이고, 쓰고 있는 GitHub Free 조직 요금제에는 한 달 12달러어치의 연산 사용량이 포함된다. GitHub의 기본 러너 요금으로 계산하면 리눅스 약 2,000분, 맥 약 193분, 윈도우 약 1,200분이다. 각각 그 운영체제에만 전부 썼을 때의 계산이고, 실제로는 같은 무료분에서 차감된다. dmg 하나 만들려면 애플 공증 대기까지 10~20분은 걸리니까, 맥에서 빌드 몇 번 하고 나면 무료분이 금방 줄어든다.

실제로 10월 29일에는 PR을 열었다가 바로 취소하는 걸 몇 번 반복했는데, 취소해도 러너가 이미 붙은 뒤라 한 번에 리눅스 환산 15분어치씩 빠져나가서 무료분을 넘겨 버렸다. (2,015/2,000분... 취소해도 공짜가 아니더라.) 그래서 빌드는 맥미니가 하고, CI는 @테스트로 필요할 때 한 번만 돌린다.


이어지는 이야기

이렇게 달리다 보니 생긴 일들은 따로 글로 적어 뒀다.


함께 만든 사람들

  • 정준경: 디자인 톤과 홈페이지, 홈페이지 영상, 그리고 가독 안의 Git 기능(작업 트리·원격·태그 관리)
  • 김가원: MCP 연결 키 화면, 데스크톱 창 제목 표시줄 테마
  • 회사 선임님: 맨 위의 8초 티저

그렇게 가독을 만들었다

노션 좀 쓰게 해 달라고 했다가 협업 툴을 만들고, Store 등록까지 했다. 혼자 잠들려던 프로젝트를 준경이랑 다시 꺼낸 덕분에 여기까지 온 것 같다.

11월 2일에 이 글을 처음 쓸 때도 모바일 앱이랑 윈도우 exe 서명은 남아 있었다. 대화와 이슈를 AI로 묶는 것도 더 해 보고 싶었고. 그래도 당장 필요했던 회의록이랑 문서를 둘 곳은 생겼다.

가독은 gadoc.kr에서 바로 써 볼 수 있고, 윈도우는 Microsoft Store에서 "GaDoc"을 검색하면 된다. 🙇🏻‍♂️


11월 10일 현황

위에서 10월에 커밋을 331개 했다고 적었다. 그런데 11월은 열흘도 다 안 지났는데 벌써 964개가 됐다. 가독 저장소의 누적 커밋은 1,469개다. 머지 커밋은 뺀 숫자다.

GitKraken을 켜 보면 이제 이렇다.

11월 10일의 가독 Git 트리. 선 하나 따라가다가 옆으로 빠지면 다시 찾아야 한다...

처음에는 채팅이랑 문서만 있으면 될 것 같았는데, 모바일 알림을 고치고, 문서 편집을 다듬고, Agent를 붙이다 보니 작업 브랜치도 계속 늘었다. 위에 적은 '3일 반 만에 Store 등록'은 정말 시작이었나 보다.

11월에는 얼마나 만들고 고쳤나

구간커밋 수
10월 전체331개
11월 1~10일964개
그중 11월 10일 오후 2시 10분까지67개
저장소 전체 누적1,469개
MERMAID

11월 10일 오후 2시 10분(KST), dev에 합쳐진 이력을 커밋 시각 기준으로 집계했다. 같은 커밋을 브랜치마다 중복해서 세지 않았고, 머지는 제외했다. 스토어 배포 횟수는 이 집계에 포함하지 않았다.

커밋 제목을 보니 11월에는 feat가 337개, fix가 440개다. 새로 붙이는 커밋보다 고치는 커밋이 더 많다. (만들 땐 분명 다 된 것 같았는데...)

최근 개발 이력에는 모바일 홈 화면·잠금 화면 위젯, 앱 잠금, 방해 금지 시간대 설정도 들어왔다. Agent가 후속 질문을 받았을 때 대화 원문을 다시 확인하도록 고친 작업도 있다. 위젯처럼 새 앱 빌드가 필요한 작업도 있어서, 여기서는 스토어 공개 여부와 별개로 개발 브랜치에 들어온 내용까지 적었다.

읽은 알림을 지우는 기능도 계속 고치고 있다. 다른 워크스페이스에 읽음 상태를 전달하거나, 이미 지운 대화에 같은 무음 푸시를 또 보내지 않도록 하는 수정이 오늘 커밋에도 있다. 알림이 오게 만드는 데서 끝날 줄 알았는데, 지우는 쪽도 일이 꽤 많다.

실제로는 얼마나 쓰고 있나

커밋만 세면 좀 민망하니까 운영 DB에서도 사용량을 다시 봤다.

항목11월 10일 확인한 값
현재 가입 계정19개
최근 7일 접속 기록이 있는 계정15개
최근 7일 메시지를 쓴 계정12개
최근 7일 사람이 보낸 메시지2,461건

최근 7일은 11월 3일 오후 2시 10분부터 11월 10일 오후 2시 10분까지다. 접속은 마지막 실시간 접속 기록을 기준으로 봤고, 메시지는 가입 계정이 보낸 것 중 시스템 메시지·봇·외부 연동을 제외했다.

위에 적은 11월 2일 기록과 비교하면 접속한 계정은 16개에서 15개, 메시지를 쓴 계정은 12개로 같았다. 여전히 열몇 명이 같이 쓰고 있다. 다만 그 사람들이 일주일 동안 메시지를 2,461개나 남겼다. 동료들이 계속 쓰는 걸 숫자로 보니, 이제 고장 나면 나만 불편한 게 아니겠구나 싶다.

여튼 지금은 새 기능을 붙이는 일만큼 이미 만든 기능을 계속 고치고 있다. 노션 좀 쓰고 싶어서 시작했는데, 이제 이걸 고치고 배포하는 데도 같은 채팅방을 쓰고 있다. 회사에서 쓸 도구는 생겼고, 내 할 일도 같이 생겼다...