바이브 코딩의 인식론적 문제
바이브 코딩의 문제의 본질은 “명시지의 암묵지화” 다.
기존 개발: 의도(암묵지) → 설계문서(명시지) → 코드(명시지)
바이브 코딩: 의도(암묵지) → 대화(휘발) → 코드(명시지?)
바이브 코딩의 코드는 표면상 명시지처럼 보이지만, 왜 이렇게 됐는지를 아무도 모른다. 진실의 원천이 아니라 결과물의 스냅샷에 불과하다.
1. 문서 기반 개발(Document-Driven Development)의 복권
문서가 다시 **진실의 원천(Source of Truth)**이 되어야 한다.
의도 → 문서(명시, 버전관리) → 코드(문서의 파생물)
↑ |
└────── 피드백 루프 ──────┘
코드가 문서를 설명하는 게 아니라, 문서가 코드를 지배하는 구조다.
AI 덕분에 문서 작성 비용이 급격히 낮아졌다는 점도 중요하다. 과거에는 “문서 쓸 시간에 코드 짠다“는 압박이 있었지만, 이제 그 트레이드오프가 역전되고 있다.
2. 자동 문서화 루프 제안
개발자의 바이브 지시
↓
AI가 의도를 해석
↓
문서에 먼저 반영 ← 검증 AI와 인간 개발자가 함께 검토/승인
↓
문서 기반으로 코드 생성
↓
코드 변경사항 → 문서 동기화 검증
이 구조의 핵심 가치는 두 가지다.
추적 가능성 : 왜 이 코드가 여기 있는지를 문서 커밋 히스토리가 설명한다. 대화 로그가 아니라.
온보딩 가능성: 새 개발자가 AI와 대화 기록을 뒤질 필요 없이 문서를 읽으면 된다.
3. 문서의 계층화
실제로 구현하려면 문서도 레이어가 있어야 한다.
| 레이어 | 내용 | 변경 주기 |
|---|---|---|
| Why (ADR) | 이 결정을 내린 이유 | 드물게 |
| What (Spec) | 시스템이 무엇을 하는가 | 기능 단위 |
| How (Design) | 어떻게 구현되는가 | 스프린트 단위 |
| Code | 실제 구현 | 문서의 파생 |
AI가 바이브 지시를 받으면, 코드 전에 적절한 레이어의 문서를 먼저 업데이트하고 승인을 받는 방식이다.
결국 이건 AI 시대의 소프트웨어 공학 방법론 문제다. 속도에 취해 방법론을 버리면 기술 부채가 아니라 인식론적 부채가 쌓인다. 아무도 왜 그런지 모르는 코드베이스. 나는 이 방향이 해답이고 결국 이 방향으로 갈것이라고 본다. 또한 이 방향은 SW 개발 진입 장벽을 낮추게 된다. 각자의 도메인 지식을 가진 사람들이 개발에 참여 할 수 있게 된다.
이 개발 방법론은 “검증 AI“를 얼마나 잘 만드느냐가 기술적 해자가 된다. 앤트로픽이 코딩 AI의 승자가 된것 처럼 말이다.