Kanban Pro - Claude Code용 내장 CLI 및 MD 컨텍스트 관리자

4개월 전, 제가 Claude Code를 위해 만든 로컬 우선 데스크톱 프로젝트 관리 도구인 Kanban Pro의 첫 버전을 공유했었죠. 그 글 덕분에 훌륭한 기술적 피드백도 많이 받았고, 클로즈드 소스 데스크톱 앱에 대한 뜨거운 논쟁도 벌어졌습니다.

지난 4개월 동안 우리가 무엇을 만들었는지, Claude Code를 어떻게 활용해 기능을 다듬었는지, 그리고 오픈 소스 대 클로즈드 소스 논쟁에 대한 우리의 입장을 정리해 드립니다.

우리가 만든 것과 기능
저는 모든 티켓이 로컬 폴더에 YAML 프론트매터가 포함된 일반 마크다운 파일로 저장되는 네이티브 데스크톱 칸반 보드를 만들었습니다. 계정도, 클라우드 서버도, API도 필요 없어요. 기기 간 동기화나 보드 공유가 필요하면 Git 저장소, iCloud, Dropbox, 혹은 Syncthing 폴더를 지정해서 쓰면 그만입니다.

* 에이전트를 위한 직접적인 파일 조작: 티켓이 디스크상의 일반 파일로 존재하기 때문에, Claude Code는 (내장 터미널 CLI나 Claude/Codex 데스크톱 앱을 통해) 프로젝트 폴더에 있는 `CLAUDE.md`와 `AGENTS.md` 지침을 사용하여 작업을 직접 읽고 수정합니다.
* 중복 제거 기능이 포함된 실시간 파일 감시: Claude가 디스크에서 티켓을 생성, 수정, 이동하면 UI가 실시간으로 업데이트됩니다. 중복 제거 레이어가 있어서 사람이 UI에서 수정하는 작업과 에이전트가 빠르게 파일을 쓰는 작업이 서로 덮어쓰지 않도록 방지합니다.
* 에이전트 귀속 정보: 에이전트가 수정한 내용은 YAML 프론트매터(`modifiedBy`)에 태그가 달리고 활동 피드에 기록되므로, Claude가 바꾼 것과 내가 바꾼 것을 구분해서 추적할 수 있습니다. Claude가 티켓의 마지막 하위 작업을 완료하면, UI에서 클릭 한 번으로 다음 열로 이동할 수 있는 프롬프트를 띄워줍니다.
* 추가 보기 모드: 칸반 보드 외에도 리스트 뷰, 캘린더, 간트 차트, 노트 기능을 포함하고 있으며, 전체 텍스트 검색, 하위 작업, 티켓 링크, 스프린트, 에픽 기능까지 다 들어있습니다.

Claude Code가 개발에 도움을 준 방식
우리는 이 앱을 Claude Code로 만들었고, 첫 프로토타입이 돌아가기 시작한 뒤부터는 우리 보드 자체를 사용해 개발 과정에서 Claude Code를 관리했습니다.

1. 자사 도구 직접 사용(Dogfooding): 지난 레딧 글에서 나온 모든 기능 요청과 버그 리포트를 우리 보드의 마크다운 티켓으로 만들었습니다. 내장 터미널에서 Claude Code를 실행하고 티켓 파일들을 가리킨 다음, Claude가 직접 디스크상의 하위 작업을 체크해가며 코드를 구현하게 했습니다.

2. 파일 감시자 경합 조건 해결: 로컬 파일을 기반으로 하는 일렉트론 앱을 만들 때 가장 골치 아픈 게, 사용자가 카드를 드래그하거나 UI에 타이핑하는 동안 LLM 에이전트가 디스크에 빠르게 데이터를 쓰는 상황을 처리하는 겁니다. Claude는 노드의 파일 시스템 감시자와 프론트엔드 상태 사이에서 디바운싱 및 상태 조정 로직을 설계하는 데 큰 도움을 줬습니다.