바이브 코딩은 함정입니다. "코덱스"가 필요합니다.

요약:"바이브 코딩"—AI에게 소프트웨어를 구축하도록 캐주얼하게 유도하는 행위—가 유행하고 있습니다. 하지만 구조가 없으면 필연적으로 "맥락 이탈"과 스파게티 코드로 이어집니다. AI로 기업 수준의 소프트웨어를 구축하려면 엄격한 맥락 아키텍처가 필요합니다.머큐리에서는 이를 "코덱스 프로토콜"이라고 부릅니다.이는 당신의 문서를 제안이 아닌 AI가 코드 한 줄을 쓰기 전에 반드시 참고해야 할 불변의 법으로 취급합니다.

저는 머큐리 기술 솔루션의 CEO 제임스입니다.

인터넷은 "바이브 코딩"으로 떠들썩합니다. 그 약속은 매력적입니다: 당신이 AI에게 캐주얼하게 ("바이브") 말하면, AI가 앱을 만듭니다.

저는 개발자 커뮤니티에서 유행하는 인기 있는 워크플로우를 검토했습니다. 이들은 프로토타입에는 훌륭하지만, 진지한 엔지니어링에는 치명적인 결함이 있습니다: AI가 "큰 그림"을 기억한다고 가정합니다. 그렇지 않습니다.

LLM은 엔트로피에 시달립니다. 대화가 길어질수록 AI는 40개의 메시지 전에 합의한 데이터베이스 스키마를 잊어버립니다. 새로운 패턴을 만들어내기 시작합니다. "바이브"는 혼란으로 변합니다.

머큐리에서는 이를 엄격한 워크플로우로 다듬었습니다. 우리는 이를 바이브 코딩이라고 부르지 않습니다. 우리는 이를 맥락 엔지니어링이라고 부릅니다.

여기 AI와 함께 소프트웨어를 구축하기 위한 "머큐리 프로토콜"이 있습니다. 우리는 이를 코덱스라고 부르는 진실의 단일 출처를 사용합니다.핵심 철학: "코덱스"

비밀은 모델(클로드 vs. GPT-5)이 아닙니다. 비밀은

외부화된 기억입니다.프로젝트 폴더를 단순한 코드 저장소가 아니라 AI를 위한 "두뇌"로 취급해야 합니다. 우리는

/codex라는 엄격한 폴더 구조를 시행합니다.왜 "코덱스"인가요? 권위를 암시하기 때문입니다. 이것들은 메모가 아니라 법칙입니다.

AI가 코드 한 줄을 쓰기 전에 반드시 코덱스를 참조해야 합니다.구조루트 디렉토리에 /codex라는 폴더를 만드세요. 이 폴더에는 다섯 개의 불변 파일이 포함되어 있습니다:

product-vision.md (왜):

고수준 목표입니다. (예: "ThreeJS를 사용한 3D 멀티플레이어 개싸움 게임").

1. tech-stack.md (어떻게):특정 도구입니다. (예: "네트워킹을 위한 WebSockets, 물리를 위한 Rapier. React는 사용하지 않고, 바닐라 JS만 사용합니다").
2. architecture.md (지도):파일 구조와 데이터베이스 스키마입니다.
3. 가장 중요한 파일입니다.implementation-plan.md (경로):단계별 작업 목록입니다. 각 단계는
4. 확인 테스트가 반드시 있어야 합니다.progress.md (로그):무엇이 완료되었고, 무엇이 남았는지입니다.워크플로우: 아키텍처 --> 실행 --> 검증
5. 그냥 채팅을 열고 코딩을 시작하지 마세요. 이 루프를 따르세요.1단계: 아키텍트 (모델: 클로드 오퍼스 4.5)

우리는 법을 작성하기 위해 가장 똑똑하고 느린 모델을 사용합니다.

행동: 당신은 제품 관리자 역할을 합니다. 당신의 생각을 채팅에 쏟아냅니다.

Phase 1: The Architect (Model: Claude Opus 4.5)

We use the smartest, slowest model to write the law.

Action: You act as the Product Manager. You dump your brain into the chat.

프롬프트: "시스템 아키텍트로서 활동하세요. 제 아이디어를 바탕으로 product-vision.md와 tech-stack.md의 항목을 작성하세요. 그런 다음 architecture.md를 제안하세요. 아직 코드는 작성하지 마세요. 이 파일들은 The Codex에 들어갈 것입니다."

결과: 디자인을 확정합니다. AI가 나중에 아키텍처 결정을 내리는 것을 명시적으로 금지합니다.

2단계: 필경사 (모델: Claude Sonnet 4.5 / Codex)

우리는 법을 실행하기 위해 빠르고 '행동적인' 모델을 사용합니다.

황금 규칙: 모든 새로운 채팅 세션은 AI가 The Codex에 상담하는 것으로 시작해야 합니다.

프롬프트: "/codex/@architecture.md 및 /codex/@implementation-plan.md를 참조하세요. 현재 3단계에 있습니다. The Codex에 정의된 아키텍처를 엄격히 준수하여 3단계를 구현하세요. 4단계로 진행하지 마세요."

AI가 매번 /codex를 읽도록 강제함으로써 '맥락 드리프트'를 제거합니다. 프롬프트 #1에 있든 #100에 있든, AI는 동일한 진리에 기반합니다.

3단계: 검증자 (모델: 인간 + 브라우저 도구)

이것이 당신의 작업입니다.

인기 있는 가이드는 자동화를 사용할 것을 제안하지만, 저는 인간 검증을 고집합니다.

작업: AI가 "3단계가 완료되었습니다."라고 말합니다.

당신: 코드를 실행하세요. 로그를 확인하세요. 3D 비행체가 실제로 날아가나요?

중요 단계: 작동한다면, AI에게 명령하세요: "/codex/@progress.md를 업데이트하여 3단계를 완료로 표시하세요. 새로운 파일을 추가했다면 /codex/@architecture.md도 업데이트하세요."

그때 비로소 Git에 커밋합니다.Git은 당신의 저장 지점입니다.AI가 4단계에서 환각을 일으킨다면, git reset --hard를 하고 다시 시도하세요.

"반중력" 이점: 모델 차익 거래

원래 가이드는 하나의 도구를 선택할 것을 제안합니다. 저는 동의하지 않습니다.

모델 차익 거래를 사용하세요:

1. 계획 (아키텍트):사용하세요Opus 4.5". 엣지 케이스에 대해 깊이 생각하고 강력한 Codex를 작성합니다.코딩 (필경사):
2. 사용하세요Sonnet 4.5". 지침을 따르며 비용이 저렴합니다.리팩토링 (사서):사용하세요
3. Gemini 3 Pro". 복잡해지면 전체 코드베이스를 한 번에 읽을 수 있는 방대한 컨텍스트 창을 가지고 있습니다.결론: "분위기"에서 "비전"으로"분위기 코딩"은 AI가 작업하는 동안 그냥 편안히 있을 수 있다는 것을 의미합니다. 이는 잘못된 것입니다.이 작업 흐름은 당신의 노력을 타이핑에서 관리로 전환합니다.

당신은 더 이상 벽돌 쌓는 사람이 아닙니다.

당신은 "Codex의 관리자"입니다.

당신의 일은 "Codex"가 깨끗하게 유지되도록 하는 것입니다. architecture.md가 복잡해지면 코드도 복잡해집니다. implementation-plan.md가 모호하면 AI가 막힙니다.

• Codex를 마스터하면 혼자서 기업 수준의 소프트웨어를 구축할 수 있습니다. 무시하면 고장난 스크립트로 가득 찬 폴더만 남게 됩니다.
• 머큐리 기술 솔루션: 디지털리티 가속화.Keeper of the Codex.

Your job is to ensure the Codex stays clean. If the architecture.md gets messy, the code gets messy. If the implementation-plan.md is vague, the AI will get stuck.

Master the Codex, and you can build enterprise-grade software alone. Ignore it, and you’ll just have a folder full of broken scripts.

Mercury Technology Solutions: Accelerate Digitality.