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만 쓰는 길이 따로 자라요. 사람이 쓰는 기능은 그대로예요.
10월 12일부터
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). 규칙마다 언제 지키는지, 한 문장, 쓰는 도구, 훅이 지키게 할지가 있어요.
- 원천
packages/policy/src/agent.ts규칙 22개: 한 문장, 쓰는 도구, 언제, 훅이 지키게 할지
- MCP 안내
lib/mcp도구 쓰는 법 9개를 MCP 서버 안내에 실어요. ikie를 붙인 모든 Claude가 받아요.
- 작업 규칙
CLAUDE.md22개 모두를 저장소 지침의 만든 구간에 써요(npm run policy).
- 훅
scripts/ikie-hook.ts시작할 때 4개를 넣고, 끝낼 때 7개를 검사해요.
- 온톨로지
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개를 고쳤어요.
몇 가지를 꼽으면 이래요.
- 만든 id를 돌려주지 않았어요. 할 일을 만든 뒤 링크를 붙이려면 판을 다시 읽어 찾아야 했어요. 이제 만드는 도구는 id를 돌려줘요.
- 한 주 판이 55KB였어요. 도구 결과 한도를 넘었어요. 판은 하루씩 읽고, 한 주는 꼭 필요할 때만 읽어요.
- 찾기가 없었어요. 세션이 자기 할 일을 다시 찾을 수 없었어요. 제목·링크 주소·상태로 찾는 길이 생겼고, 스레드 주소로 찾으면 그 스레드의 일이 나와요.
- PR 하나만 합쳐도 끝내라고 막았어요. 서버 PR 뒤에 iOS PR이 남은 일이었어요. 남은 단계가 있으면 지킨 것으로 보게 고쳤어요.
- 새 도구가 열린 세션에 안 보여요. 세션은 시작할 때 도구 목록을 받아요. 이건 고칠 수 없어서 규칙에 "새 세션부터 보여요"를 적었어요.
걸어온 길
- 10월 11일AI 작업 전용 시스템: 전용 표·영수증·보고 화면·work API
- 10월 12일같은 쓰임새 위의 얇은 MCP(#261), AI 작업 걷기(#266·#268), 작업 기록 훅(#293), 규칙 원천(#296), 읽기와 만들기 나누기(#318)
- 10월 13일훅이 ikie를 직접 읽는 작업 기록 키(#362)
- 10월 14일합친 PR의 할 일 확인(#389), 문 지킴 시험(#391), 체크리스트를 단계로(#393), 권한도 원천에서(#423)
- 10월 16일start_work·finish_work(#576), 남은 단계가 있으면 끝내지 않기(#604)
배운 것
- 에이전트가 아쉬워하는 것은 사람도 아쉬워해요. 전용 시스템을 걷고 나니, Claude의 불편이 곧 앱의 다음 기능 목록이 됐어요.
- 규칙은 글이 아니라 데이터로 둬요. 한 곳에 적으면 안내·훅·검사가 어긋날 수 없어요. 규칙을 바꾸면 세 곳이 같이 바뀌어요.
- 막되 가두지 않아요. 훅은 까닭마다 한 번만 막아요. 도구가 없는 세션도 일을 끝낼 수 있어요.
- 같은 문으로 들여요. Claude가 사람과 같은 쓰임새를 타면 권한·이력·외부 캘린더 맞추기를 따로 만들 일이 없어요.
층을 나누고 판단을 한 곳에 두는 원칙은 원칙 글에, 문서 기능이 할 일 메모에서 시작한 이야기는 문서 편집기 글에 있어요.