미래이음연구소

목차

• 바이브코딩의 달콤한 시작과 씁쓸한 현실
• 진짜 병목은 코드가 아니라 '기억'이었다
• 해결책: Obsidian + Claude 이중 구조
• 핵심 워크플로우 — 기록 → 설계 → 구현 → 기록
• 세션 인수인계 기법 (handoff.md)
• 실제 결과 — 10개 프로젝트 동시 관리
• 무료 가이드북 소개
• Q&A

바이브코딩의 달콤한 시작과 씁쓸한 현실

바이브코딩을 처음 경험하면 누구나 같은 감탄을 합니다:

"프롬프트 던지면 코드가 나오고, 뭔가 돌아가는 것 같고... 나 이거 진짜 만드는 건가?"

하지만 시간이 지나면 현실이 찾아옵니다:

• ❌ 에러를 고쳐달라고 하면 다른 데가 깨진다
• ❌ 30분 지나면 AI가 앞에서 한 말을 까먹는다
• ❌ 1시간 지나면 나도 지금 뭘 만들고 있었는지 헷갈린다
• ❌ 다음 날 다시 열면 백지 상태
• ❌ 여러 프로젝트 동시 진행 시 컨텍스트를 처음부터 다시 세팅

결국 토이 프로젝트를 시작하고 3일 만에 폴더 삭제하기를 반복하게 됩니다. 많은 분들이 여기서 바이브코딩을 포기합니다.

진짜 병목은 코드가 아니라 '기억'이었다

이것이 바이브코딩이 실패하는 근본 원인입니다. 모델의 성능 문제도, 프롬프트의 문제도 아닙니다. 기억의 단절이 문제입니다.

해결책: Obsidian + Claude 이중 구조

이 문제를 해결한 워크플로우의 핵심은 Obsidian을 프로젝트의 장기 기억 저장소로 사용하는 것입니다.

💡 포인트: Claude Desktop이 "설계자", Claude Code가 "개발자" 역할을 분담합니다. 설계와 구현을 분리하는 것이 핵심!

핵심 워크플로우 — 기록 → 설계 → 구현 → 기록

세션 인수인계 기법 (handoff.md)

Claude Desktop의 컨텍스트 유실 문제를 해결하는 핵심 기법입니다:

• 매 세션이 끝날 때 날짜_handoff.md 파일에 인수인계 내용을 기록
• 새 세션을 열 때 이 파일만 읽으면 맥락이 바로 복구
• 여러 프로젝트를 동시에 진행해도 각각의 handoff 파일로 컨텍스트 전환이 즉시 가능

이것은 최근 Claude Code에 추가된 Auto Memory 기능과 보완 관계입니다:

실제 결과 — 10개 프로젝트 동시 관리

무료 가이드북

이 워크플로우의 전체 내용이 위키독스에 무료 공개되어 있습니다:

Q&A

Q. Obsidian 없이 다른 도구로도 가능한가요?
A. 마크다운 기반이면 가능합니다. 하지만 Obsidian은 캔버스, 링크, MCP 연동이 가장 강력해서 이 워크플로우에 최적입니다.

Q. Claude Desktop과 Claude Code를 왜 따로 쓰나요?
A. 설계(사고)와 구현(실행)을 분리하면 각각의 품질이 올라갑니다. 한 AI에게 설계+구현을 다 시키면 컨텍스트가 빨리 소진됩니다.

Q. handoff.md에 뭘 적어야 하나요?
A. 현재 진행 상황, 마지막으로 한 작업, 다음에 해야 할 것, 주의할 에러를 간단히 적으면 됩니다. 5줄이면 충분합니다.

Q. MCP 설정이 어렵지 않나요?
A. Claude Desktop에서 MCP 서버를 추가하면 Obsidian 폴더를 직접 읽을 수 있습니다. 초기 설정만 하면 이후는 자동입니다.

Q. 이 방식으로 실제 서비스를 만들 수 있나요?
A. 네, 원저자는 이 방식으로 10개 이상의 프로젝트를 동시에 관리하며 배포까지 완료하고 있습니다.

원문: GeekNews 하다 (2026.03), 무료 가이드북: wikidocs.net/book/19307