ikieEngineeringGet started
All posts

MCPClaude도그푸딩구조

ikie를 만드는 Claude가 ikie에 일을 적어요: AI 전용 칸 없이

Claude 세션들은 부탁마다 ikie에 할 일을 만들고, 단계·PR·결과를 그 안에 적어요. AI 전용 작업 시스템을 하루 만에 만들었다가 다음 날 걷어 냈고, 사람이 쓰는 기능으로 다시 했어요. 규칙은 한 곳에 적고 안내·훅·검사를 거기서 만들어요. 써 보며 찾은 41개 중 36개를 고쳤어요.

English

ikie는 대부분 Claude가 만들어요. main에 들어간 커밋 882개 중 828개(94%)가 Claude 세션의 커밋이에요. 사람이 프로젝트 대화에 부탁을 적으면 스레드마다 Claude가 붙어 코드를 고치고, PR을 올리고, TestFlight에 빌드를 올려요.

그 Claude들은 자기 일을 ikie에 적어요. 부탁 하나가 작업 캘린더의 할 일 하나가 되고, 스레드에 보이는 체크리스트가 그 할 일 안의 단계가 돼요. PR과 아티팩트는 링크로, TestFlight 빌드 번호는 메모로 붙어요. 일이 끝나면 결과 한 줄과 함께 끝냄이 돼요. 부탁한 사람은 ikie를 열면 어느 일이 하는 중이고, 어느 일이 자기 답을 기다리는지 봐요.

이 글은 그 구조가 어떻게 생겼는지예요.

처음에는 AI 전용 시스템을 만들었어요

10월 11일에 먼저 만든 것은 AI 작업 전용 시스템이었어요. 작업을 담는 전용 표, 다시 보내도 한 번만 적히는 영수증, 진행 보고, 전용 REST와 MCP 길, 보고 화면까지 하루에 생겼어요.

다음 날 새벽에 걷어 냈어요. 다시 보니 그 시스템이 하는 말은 ikie에 이미 있는 것으로 다 할 수 있었어요.

  • 무엇을 하나 → 할 일
  • 하는 중인가, 기다리나 → 할 일의 상태
  • 어디까지 했나 → 안에 넣은 단계
  • 무엇이 나왔나 → 링크와 메모
  • 어떤 일인가 → 태그

옛 기록은 마이그레이션으로 할 일·메모·링크·태그로 옮겼어요. 전용 표 둘과 항목의 전용 칸 둘을 지웠어요. 걷어 낸 PR 하나에서만 2,503줄이 빠졌어요(#266, #268).

10월 11일

AI 작업 시스템전용 표·칸·API·화면
작업 표영수증 표보고 화면work API

AI만 쓰는 길이 따로 자라요. 사람이 쓰는 기능은 그대로예요.

10월 12일부터

ikie 기능 그대로사람과 같은 할 일
할 일·상태안의 단계링크·메모태그

Claude가 아쉬워한 것을 고치면 사람이 쓰는 기능이 좋아져요.

AI 전용 표·칸·규칙을 만들지 않아요. Claude에게 필요한 것은 앱 기능으로 해요.

걷어 낸 뒤로 Claude가 "이게 없어서 불편해요"라고 한 것은 모두 앱 기능이 됐어요. 항목에 링크 붙이기, 링크 주소로 찾기, 상세에서 하는 중·기다리는 중 바꾸기, Markdown 메모, 칸 하나만 고치기가 그렇게 생겼어요. 웹과 iPhone에서 사람도 똑같이 써요.

사람과 같은 문으로 들어와요

연결한 Claude는 MCP로 붙어요. MCP 서버는 공개 API와 같은 쓰임새를, 같은 값 스키마로 부르는 얇은 어댑터예요(#261). 누가 무엇을 보고 고칠 수 있는지도 사람과 같은 판단을 타요. 다른 점은 변경 이력에 "연결한 앱"으로 남는 것뿐이에요.

도구는 39개이고, 작업 기록에만 쓰는 도구는 둘이에요.

  • start_work: 할 일을 만들고, 하는 중으로 두고, 스레드 주소를 링크로 붙여요. 할 일 만들기 쓰임새를 한 번 부를 뿐이에요.
  • finish_work: 결과 한 줄을 메모에 붙이고 끝내요. 안에 끝내지 않은 단계가 남았으면 거절해요(#604).

둘 다 새 저장소나 새 칸이 없어요. 여러 번 부르던 것을 한 번의 쓰기로 묶었을 뿐이에요.

같은 문이라는 것은 시험이 지켜요. 공유받은 사람이 주인의 Google 캘린더에 같은 값을 공개 API로 넣든 MCP로 넣든, 결과가 같고 주인의 계정을 한 번 맞추는지 봐요(#391). 라우트와 MCP 처리기는 진짜를 쓰고, 그 아래만 빈 DB(PGlite)예요.

규칙은 한 곳에 적고, 나머지는 만들어요

Claude가 지킬 규칙은 22개예요. 9개는 누구의 Claude든 ikie 도구를 잘 쓰는 법이고, 13개는 이 저장소에서 일하는 Claude가 자기 일을 적는 법이에요. 규칙은 파일 하나에 데이터로 적어요(#296). 규칙마다 언제 지키는지, 한 문장, 쓰는 도구, 훅이 지키게 할지가 있어요.

  1. 원천packages/policy/src/agent.ts

    규칙 22개: 한 문장, 쓰는 도구, 언제, 훅이 지키게 할지

  2. MCP 안내lib/mcp

    도구 쓰는 법 9개를 MCP 서버 안내에 실어요. ikie를 붙인 모든 Claude가 받아요.

  3. 작업 규칙CLAUDE.md

    22개 모두를 저장소 지침의 만든 구간에 써요(npm run policy).

  4. 훅scripts/ikie-hook.ts

    시작할 때 4개를 넣고, 끝낼 때 7개를 검사해요.

  5. 온톨로지packages/ontology

    규칙 → 쓰는 도구로 이어요. 없는 도구를 가리키면 CI가 막아요.

규칙 원천 하나에서 네 곳이 만들어져요. 사람이 옮겨 적는 곳은 없어요.

세션이 묻지 않고 하는 일(작업 기록 도구 부르기, 초록인 자기 PR 합치기, 빌드)도 같은 식이에요. 까닭과 함께 원천에 적고, 설정 파일은 만들어요(#423). 손으로 고치면 시험이 막아요.

끝낼 때 훅이 확인해요

규칙을 글로만 두면 잊어요. 그래서 Claude Code 훅이 세션을 끝내려 할 때 확인해요. 대화 기록에서 도구 부르기를 차례대로 읽고, 결과(커밋, PR, 합치기, TestFlight, 아티팩트, 공유 폴더 파일)가 나온 자리를 찾아요. 그 앞이나 뒤에 규칙의 도구를 불렀는지 봐요.

규칙언제무엇을 봐요
할 일첫 커밋·PR 앞할 일을 만들었거나 찾았나
하는 중첫 PR 앞그 할 일을 하는 중으로 뒀나
스레드첫 PR 앞할 일에 스레드 주소를 붙였나
링크PR·아티팩트 뒤그 주소를 할 일에 붙였나
파일공유 폴더 파일 뒤경로를 메모에 적었나
빌드TestFlight 뒤빌드 번호를 메모에 적었나
끝냄합친 뒤그 PR이 붙은 할 일을 끝냈나

어기면 까닭을 말하고 한 번 막아요. 같은 까닭으로는 다시 막지 않아요. ikie 도구가 없는 세션이 갇히면 안 되니까요.

처음에 훅은 대화 기록만 볼 수 있었어요. 다른 세션이 이미 할 일을 만들었는지 몰라서 헛짚기도 했어요. 그래서 훅에 좁은 읽기 길을 줬어요(#362). 작업 기록 키는 사람이 고른 캘린더만 읽고, 이 스레드 주소가 붙은 할 일의 단계만 맞출 수 있어요. 키는 해시로만 저장하고, 쿠키를 보지 않아서 다른 사이트가 브라우저를 시켜 부를 수도 없어요.

키가 있으면 훅이 할 수 있는 일이 늘어요.

  • 합친 PR: 그 PR 주소가 붙은 할 일을 ikie에서 읽어, 끝냈거나 안에 남은 단계가 있는지 봐요(#389). PR이 여럿인 일은 남은 PR을 단계로 두면 돼요. 누가 어느 세션에서 합쳐도 같아요.
  • 체크리스트: 스레드에 보이는 체크리스트를 바꿀 때마다 할 일 안의 단계로 그대로 맞춰요(#393). 사람이 스레드에서 보는 단계와 ikie에서 보는 단계가 같아요.

써 보며 찾은 것 41개

규칙 중 하나는 "ikie를 쓰다 걸린 것은 바로 발견 모음에 한 줄씩 적어요"예요. 이 모음이 ikie에서 가장 솔직한 사용자 의견이 됐어요. 지금까지 41개가 쌓였고 36개를 고쳤어요.

찾은 것고친 것
숫자로 보기
묶음찾은 것고친 것
도구 모양14개13개
훅·규칙10개8개
세션·커넥터7개6개
앱 기능6개5개
글 읽기4개4개
발견 모음의 41개를 무엇이 문제였나로 나눴어요. 남은 5개도 모음에 열려 있어요.

몇 가지를 꼽으면 이래요.

  • 만든 id를 돌려주지 않았어요. 할 일을 만든 뒤 링크를 붙이려면 판을 다시 읽어 찾아야 했어요. 이제 만드는 도구는 id를 돌려줘요.
  • 한 주 판이 55KB였어요. 도구 결과 한도를 넘었어요. 판은 하루씩 읽고, 한 주는 꼭 필요할 때만 읽어요.
  • 찾기가 없었어요. 세션이 자기 할 일을 다시 찾을 수 없었어요. 제목·링크 주소·상태로 찾는 길이 생겼고, 스레드 주소로 찾으면 그 스레드의 일이 나와요.
  • PR 하나만 합쳐도 끝내라고 막았어요. 서버 PR 뒤에 iOS PR이 남은 일이었어요. 남은 단계가 있으면 지킨 것으로 보게 고쳤어요.
  • 새 도구가 열린 세션에 안 보여요. 세션은 시작할 때 도구 목록을 받아요. 이건 고칠 수 없어서 규칙에 "새 세션부터 보여요"를 적었어요.

걸어온 길

  1. 10월 11일AI 작업 전용 시스템: 전용 표·영수증·보고 화면·work API
  2. 10월 12일같은 쓰임새 위의 얇은 MCP(#261), AI 작업 걷기(#266·#268), 작업 기록 훅(#293), 규칙 원천(#296), 읽기와 만들기 나누기(#318)
  3. 10월 13일훅이 ikie를 직접 읽는 작업 기록 키(#362)
  4. 10월 14일합친 PR의 할 일 확인(#389), 문 지킴 시험(#391), 체크리스트를 단계로(#393), 권한도 원천에서(#423)
  5. 10월 16일start_work·finish_work(#576), 남은 단계가 있으면 끝내지 않기(#604)

배운 것

  • 에이전트가 아쉬워하는 것은 사람도 아쉬워해요. 전용 시스템을 걷고 나니, Claude의 불편이 곧 앱의 다음 기능 목록이 됐어요.
  • 규칙은 글이 아니라 데이터로 둬요. 한 곳에 적으면 안내·훅·검사가 어긋날 수 없어요. 규칙을 바꾸면 세 곳이 같이 바뀌어요.
  • 막되 가두지 않아요. 훅은 까닭마다 한 번만 막아요. 도구가 없는 세션도 일을 끝낼 수 있어요.
  • 같은 문으로 들여요. Claude가 사람과 같은 쓰임새를 타면 권한·이력·외부 캘린더 맞추기를 따로 만들 일이 없어요.

층을 나누고 판단을 한 곳에 두는 원칙은 원칙 글에, 문서 기능이 할 일 메모에서 시작한 이야기는 문서 편집기 글에 있어요.

The ikie teamikie is a calendar for your events and to-dos in one place. Here we write about the problems we run into while building it, and how we solve them.