코드 조각 대신 아키텍처를 요구하세요
Stop asking for code snippets and start asking for architecture
핵심 요약
AI 코딩 시 작은 코드 조각을 요청하기보다 전체적인 아키텍처를 먼저 설계하면 결과물의 품질이 비약적으로 상승함.
- 마이크로 프롬프팅 — 작은 코드 조각을 반복 요청하면 일관성 없는 결과물이 나오기 쉬움.
- 매크로 프롬프팅 — 전체 시스템 구조와 데이터 모델을 먼저 설계하여 AI의 이해도를 높임.
- 아키텍처 우선 — 코드 생성 전 인터페이스와 구조를 확정하여 추상적인 오류를 방지함.
- 교차 기능적 접근 — 비즈니스 로직과 구조를 함께 고려하여 실질적인 제품 가치를 높임.
처음 바이브 코딩을 시작했을 때, 제 프롬프트는 모두 작고 전술적인 것들이었습니다. 'React 내비게이션 바를 작성해줘', '이 URL에 대한 정규식을 알려줘', 'X에 대한 훅을 만들어줘' 같은 식이었죠. 구글링보다 빠르긴 했지만, 역학 관계는 기본적으로 제가 시니어 개발자가 되어 매우 빠르지만 다소 멍청한 주니어를 다루는 것과 같았습니다. 저는 여전히 모든 것을 접착제로 붙여야 했고, 결과물은 보통 이상한 상태 관리와 서로 잘 맞지 않는 일회성 컴포넌트들이었습니다.
몇 주 전, 저는 워크플로우를 뒤집었습니다. 코드를 작성하기 전에 10분 정도 긴 아키텍처 프롬프트를 작성하는 데 시간을 씁니다. 저는 Claude 3.5 Sonnet에게 이렇게 말합니다. '우리는 분석 대시보드를 만들고 있어. 여기 데이터 모델이 있고, 앱을 통해 상태가 어떻게 이동하길 원하는지 설명할게. 여기 제약 사항들이 있어. 폴더 구조와 각 부분 간의 인터페이스를 제안해줘.'
우리는 아키텍처가 일관성 있게 보일 때까지 앞뒤로 대화를 주고받고, 그제서야 파일 생성을 요청하기 시작합니다. 품질의 도약은 분명했습니다. 모델이 고립된 요청의 흐름 대신 실제 전체적인 그림을 가지고 있기 때문입니다.
마이크로 프롬프팅에서 매크로 프롬프팅으로 넘어가서 품질이 급상승하는 것을 경험해보셨나요?
