클로드 코드 사용을 통한 실용적인 프롬프트 엔지니어링 교훈

효과가 있었던 방법: 프로덕션 코드 출시

개발 경험이 없는 프로젝트 매니저인 사용자가 Claude Code를 사용해 프로덕션 코드를 성공적으로 구축하고 출시했습니다. 결과적으로 만들어진 애플리케이션은 브라우저에서 실행되며 1,200개가 넘는 테스트를 포함하고 있습니다.

핵심 과제: 프롬프트 품질

확인된 주요 어려움은 프롬프트가 정확하지 않으면 Claude Code가 부실하거나 잘못된 결과를 생성한다는 점이었습니다. 사용자는 "프롬프트가 완벽하지 않으면 확실히 벽에 정면으로 부딪히게 할 것"이라고 말합니다.

결과를 개선한 세 가지 기법

• 2단계 프롬프트: 한 번에 프롬프트를 작성하는 대신, 사용자는 2단계 접근 방식을 채택했습니다. 1단계에서는 자신의 도메인 언어로 무엇을 할지, 규칙과 원하는 결과를 포함해 작성합니다. 2단계에서는 신뢰성 엔지니어의 관점에서 프롬프트를 재작성하며, 검증 단계, 단일 목표, 명시적 세션 경계, 단축키 방지 규칙을 추가합니다. 사용자는 한 단계만으로는 괜찮은 결과를 얻지만, 두 단계를 거치면 프로덕션 수준의 결과를 얻을 수 있다고 발견했습니다.
• 하나의 프롬프트 = 하나의 목표: 여러 목표를 하나의 프롬프트에 묶는 것은 일관되게 좋지 않은 결과를 초래했습니다. Claude Code는 하나의 목표를 우선시하거나, 목표들을 엉성하게 합치거나, 둘 다에 대해 불완전한 해결책을 제공했습니다. 사용자는 프롬프트당 하나의 목표를 갖는 "무자비한 범위 규율"을 강조하며, 이를 발견한 가장 큰 "품질 승수"라고 부릅니다.
• 구체적인 역할 정의: "시니어 개발자처럼 행동하라"와 같은 일반적인 역할 지시는 "거의 쓸모없다"고 판단되었습니다. 효과적인 역할은 작업에 필요한 정확한 전문성 조합을 명시해야 합니다. 사용자는 예를 들어, "상업용 작곡 엔진을 구축한 음악원 출신 음악 이론가"는 "음악 전문가"와 같은 모호한 지시보다 근본적으로 다르고 더 나은 결과를 생성한다고 설명합니다. 구체성은 출력의 어조뿐만 아니라 모델의 근본적인 사고 과정을 변화시킵니다.