바이브코딩 4문서 하네스 방법론

코딩 전 4개 문서를 순서대로 준비함으로써 AI 코딩의 품질·완성도를 높이는 방법론. 출처: 빌더-조쉬의 Codex CLI 실전 라이브 (2026-05)

4개 문서 구성

순서	문서	내용	비유
1	plan.md	기능 목표, 사용자 스토리, 요구사항	상위 기획서
2	design.md (설계)	기술 스택, 데이터 모델, API 구조	상세 기획서
3	design.md (스타일)	색상, 타이포그래피, 컴포넌트 규칙	스타일 가이드
4	agent.md	개발 원칙, 반복 실수 방지, 서브에이전트 규칙	CLAUDE.md 상당

⚠️ 설계 문서와 스타일 문서 모두 design.md로 불리지만 내용이 다름. 두 번째는 구현 설계서, 세 번째는 시각 스타일 정의.

핵심 원칙

• 코드 작성 전에 문서를 충분히 준비할수록 에러 발생 확률이 낮아짐
• AI는 문서로 “컨텍스트를 한 번에 이해”하므로, 프롬프트 반복보다 문서 품질이 중요
• agent.md는 세션 간 지속 업데이트 → 반복 실수 방지 + 원칙 축적

Vixi PDCA와의 관계

이 방법론은 Vixi 플러그인의 PDCA 스킬로 자동화 가능:

1. $pdca 스킬 호출 → 플랜 단계 시작
2. $pdca-design → 설계 문서 생성
3. 스타일 .md 별도 붙여넣기 (getdesign.md / OhMyDesign.ai)
4. agent.md 파일 생성 후 맥락 주입

관련 개념

• vibe-coding — 바이브 코딩 일반
• Thin-Harness-Fat-Skills — 하네스 vs 스킬 설계 원칙
• agent-skill-design — 스킬 설계 패턴
• openai-codex — Codex CLI