LLM 협업을 위한 텍스트 기반 개발 워크플로우: Obsidian과 Git 활용법

섹션별 상세

LLM과의 협업에서 세션 간 맥락이 소실되는 문제는 개발 생산성을 저해하는 주요 요인이다. 기존 도구들은 인간 중심적이거나 AI가 접근하기 어려운 폐쇄적인 구조를 가진 경우가 많다. 이를 해결하기 위해 인간과 AI가 모두 읽고 쓸 수 있는 Markdown 기반의 공유 워크플로우가 필요하다. Git을 통한 버전 관리는 이 과정에서 변경 이력을 추적하고 장기적인 기억 장치 역할을 수행한다.

research.md 파일은 구현 전 시스템의 실제 상태를 파악하여 잘못된 가정을 방지하는 핵심 도구이다. LLM은 소스 코드, 마이그레이션, 테스트 및 문서를 상세히 파악하여 아키텍처 제약 사항과 엣지 케이스를 기록한다. 모호한 요약 대신 구조화된 발견 사항을 작성함으로써 계획 수립을 위한 견고한 토대를 마련한다. 이 단계는 무엇이 존재한다고 가정하는가가 아닌 실제로 무엇이 존재하는가를 정의하는 과정이다.

plan.md는 연구 결과를 바탕으로 구현 단계를 구체적인 페이즈로 분할하여 관리하는 로드맵이다. 각 페이즈는 독립적으로 검증 가능한 작업 단위로 구성되며, 세부 사항은 별도의 파일로 분리하여 관리한다. 이를 통해 LLM은 전체 프로젝트 대신 현재 작업 중인 특정 페이즈의 파일만 로드하여 컨텍스트 창을 효율적으로 사용할 수 있다. 작업이 진행됨에 따라 체크리스트를 업데이트하여 진행 상황을 명확히 공유한다.

Obsidian Kanban은 텍스트 기반의 파일 구조를 시각적인 대시보드로 변환하여 프로젝트의 전체 상태를 한눈에 파악하게 해준다. 칸반 보드의 각 카드는 실제 Markdown 파일에 대한 링크로 구성되어 있어 보드 업데이트가 곧 파일 업데이트와 직결된다. 메타프로젝트, 계획 중, 진행 중, 완료 등의 컬럼을 통해 작업의 흐름을 관리하며 Git 로그는 프로젝트의 타임라인 역할을 한다. 별도의 복잡한 도구 없이도 텍스트 파일만으로 강력한 프로젝트 관리 환경을 구축할 수 있다.

용어 해설

컨텍스트 윈도우(Context Window): — LLM이 한 번에 처리할 수 있는 텍스트 정보의 총량을 의미한다. 긴 대화나 복잡한 코드를 다룰 때 이 한계를 초과하면 이전 정보가 유실되므로, 본문처럼 파일을 분할하여 필요한 맥락만 주입하는 방식이 중요하다. 이는 모델의 추론 정확도와 비용 효율성에 직접적인 영향을 미치는 핵심 요소이다.
칸반 보드(Kanban Board): — 작업의 흐름을 시각적으로 관리하는 도구로, 할 일, 진행 중, 완료 등의 상태를 카드로 표시한다. 본문에서는 Obsidian을 통해 Markdown 파일을 카드로 변환하여 인간과 AI가 프로젝트 진행 상황을 직관적으로 공유하는 인터페이스로 활용한다. 복잡한 워크플로우를 단순화하여 병목 구간을 파악하는 데 유용하다.
버전 관리(Version Control): — 파일의 변경 사항을 시간 순서대로 기록하고 관리하는 시스템이다. Git을 사용하여 AI와의 협업 과정에서 발생한 모든 수정 이력을 보존하며, 이는 LLM의 단기 기억 한계를 보완하는 장기 기억 장치 역할을 수행한다. 협업 중 발생한 오류를 추적하고 이전 상태로 안전하게 복구하는 데 필수적이다.

기술

Obsidian
Git
Markdown
LLM

활용 사례

LLM 기반 코딩 보조
복잡한 코드베이스 리팩터링
장기 프로젝트 관리

언급된 리소스

GitHubObsidian Kanban