칸반 보드를 마크다운으로 — Claude Code와 파일 동기화하는 작업관리 3주 실사용

Claude가 tasks/refactor-api.md 파일을 편집하자마자 브라우저 칸반 보드에서 해당 카드가 "진행 중"으로 움직였습니다. 새로고침 없이요. 에이전트가 작업을 마치고 파일 frontmatter의 status를 done으로 바꾸자 카드가 완료 열로 자동 이동했죠. 3주간 써본 결론은 명확합니다. 에이전트 작업 추적이 주 목적이면 파일 기반 칸반, 팀 협업이 필요하면 Linear 그대로 쓰세요.

어떤 기준으로 평가했나요?

제 환경은 솔로 개발자 + Claude Code로 하루 평균 8개 작업을 처리하는 상황입니다. 기존엔 Linear를 썼는데 에이전트가 티켓을 직접 만들거나 상태를 바꾸지 못해서 답답했어요. 이번 비교에서 본 건 세 가지였습니다. 첫째, 에이전트가 편집한 내용이 보드에 반영되는 속도. 둘째, UI 없이도 작업을 진행할 수 있는지 여부. 셋째, 협업 상황에서 실제로 쓸 만한지. 요금은 파일 기반 칸반이 무료라서 비교 대상이 아니었습니다.

같은 작업을 두 도구로 돌려보니

API 엔드포인트 3개를 추가하는 작업을 Linear와 파일 기반 칸반으로 각각 진행해봤어요. Linear에선 제가 먼저 티켓 3개를 수동으로 만들고, Claude에게 "이 티켓들 처리해줘"라고 요청했습니다. Claude는 코드만 짰고, 티켓 상태는 제가 직접 클릭해서 바꿨죠. 에이전트는 Linear API를 못 쓰거든요.

파일 칸반에선 Claude에게 "API 엔드포인트 3개 추가 계획을 칸반에 넣어줘"라고 했더니 tasks/api-user.md, tasks/api-product.md, tasks/api-order.md 파일 3개를 만들었습니다. frontmatter에 status: todo, title, description을 자동으로 채웠고요. 브라우저 칸반 보드엔 파일 생성 즉시 카드 3개가 나타났습니다. 워처(file watcher)가 디렉토리 변경을 감지해서 UI를 업데이트한 거죠.

작업을 시작하자 Claude가 파일을 열어서 status: in_progress로 바꿨고, 완료하면 status: done으로 변경했어요. 저는 브라우저만 켜두고 카드가 열 사이를 자동으로 움직이는 걸 지켜봤습니다. 체감상 파일 저장 후 1~2초 안에 UI가 반영됐어요. Linear에선 불가능한 흐름이었습니다.

실제로 막힌 순간도 있었어요. 파일명 컨벤션을 안 지키면 워처가 인식을 못 합니다. task-new-feature.md처럼 접두사를 task-로 쓰면 보드에 안 뜨더라고요. 설정에서 tasks/*.md 패턴을 강제하거든요. Linear는 이런 문제가 없지만, API 토큰이 만료되면 수동 갱신을 해야 해서 에이전트 작업이 중간에 멈춥니다.

남들이 잘 안 다루는 각도 하나 더 보겠습니다. 협업할 때 파일 기반이 오히려 불리한 이유예요. 두 명이 같은 파일을 동시에 편집하면 Git 충돌이 납니다. Linear는 실시간 동기화로 이걸 막아주지만, 파일 칸반은 그런 장치가 없어요. 알림도 없습니다. 팀원이 티켓을 완료해도 제가 브라우저를 새로고침하지 않으면 모르죠. Linear는 Slack 알림이 자동으로 오는데 말이에요.

결국 구독을 하나로 줄인 이유

처음엔 Linear 유료 플랜을 쓰면서 파일 칸반을 보조로 썼습니다. Claude 작업은 파일로, 팀 협업은 Linear로 분리한 거죠. 그런데 2주쯤 지나자 Linear를 거의 안 열게 되더라고요. 솔로 개발이라 협업 기능이 필요 없었거든요. 결정적 순간은 Linear에서 에이전트가 만든 작업 이력을 찾을 수 없을 때였어요. Claude가 코드를 짰지만 티켓엔 제 이름만 남아 있었습니다. 파일 칸반은 Git 커밋 로그에 "Claude edited tasks/refactor-api.md"가 남아서 누가 뭘 했는지 추적이 됐죠.

그때 기준이 된 건 "에이전트가 주체인가, 사람이 주체인가"였습니다. 제 작업 흐름은 Claude가 80% 이상 처리하거든요. 에이전트가 티켓을 못 만드는 도구는 제게 맞지 않았어요. 결국 Linear 구독을 끊고 파일 칸반으로 완전히 넘어갔습니다.

대안도 봤어요. Notion 데이터베이스는 API가 있지만 에이전트 설정이 복잡했고, Jira는 무겁고 느렸습니다. GitHub Projects는 파일 기반이 아니라서 에이전트가 직접 편집을 못 했고요. 파일 칸반이 가장 가벼우면서도 에이전트 친화적이었습니다.

솔로면 파일, 팀이면 SaaS

핵심만 정리하면 이렇습니다. 에이전트가 작업을 직접 추적하게 하려면 파일 기반 칸반이 답입니다. UI 없이도 Git만으로 전체 히스토리를 볼 수 있고, 에이전트가 티켓 생성부터 완료까지 자동으로 처리하니까요. 반대로 팀 협업이 필요하면 Linear나 Jira를 유지하세요. 실시간 알림, 권한 관리, 댓글 스레드는 파일 시스템으론 못 만드는 기능이거든요.

자주 묻는 질문

Q. 파일 기반 칸반을 팀에서 쓸 수 있나요? A. Git으로 공유는 되지만 동시 편집 충돌과 실시간 알림 부재로 비추천합니다. 3명 이상 팀이면 Linear·Jira 같은 SaaS가 훨씬 낫습니다.

Q. Linear를 완전히 대체할 수 있나요? A. 솔로 개발자나 에이전트 위주 작업 흐름이면 가능합니다. 협업 기능(멘션·댓글·권한)이 필요하면 Linear를 유지하세요.

Q. Claude 외 다른 에이전트도 작동하나요? A. 파일 편집만 하면 됩니다. GPT-4o, Cursor, Copilot 모두 frontmatter를 바꿀 수 있어서 같은 방식으로 쓸 수 있어요.

Q. 파일명 규칙을 어기면 어떻게 되나요? A. 워처가 해당 파일을 인식하지 못해서 보드에 카드가 안 뜹니다. 설정 파일에서 패턴을 조정하거나, 파일명을 규칙에 맞게 수정하면 즉시 반영됩니다.