Jira를 버리고 Git 파일 시스템 기반의 AI 협업 보드를 구축한 사례

Context

프로젝트 상태 관리 도구인 Jira와 실제 작업물인 Markdown 파일 간의 데이터 불일치 발생. AI 에이전트가 파일 시스템에 직접 리포트를 생성하며 파일 시스템이 실질적인 진실 공급원(Source of Truth)으로 작동. 수동 업데이트 비용 증가로 인해 프로젝트 보드가 방치되는 구조적 한계 직면.

Technical Solution

• 파일 시스템 내 Markdown 파일과 YAML Frontmatter를 기반으로 한 상태 관리 설계
• Git 저장소를 데이터베이스로 활용하여 보드 내 모든 액션을 즉시 Commit 및 Push 하는 동기화 방식
• server-side에서 git ls-remote를 5초 주기로 폴링하여 원격 저장소의 변경 사항을 감지하는 메커니즘
• Server-Sent Events(SSE)를 통해 브라우저 새로고침 없이 실시간으로 상태 변화를 반영하는 푸시 구조
• fs.watch와 Debounce 로직을 결합하여 IDE 내 파일 수정 시 5초 후 자동 커밋하는 자동화 흐름
• Vanilla HTML/CSS/JS와 Node.js http.createServer만 사용한 제로 빌드 단계의 경량 스택 구성

Key Takeaway

도구가 작업 흐름을 규정하는 것이 아니라 실제 데이터가 흐르는 지점을 인터페이스로 추상화할 때 운영 오버헤드를 최소화할 수 있다는 설계 원칙.