단독 개발자를 위한 Claude AI 프롬프팅: 2단계 방법으로 대규모 프로젝트 완성

워크플로우 구조

개발자는 두 가지 별도의 Claude 도구를 엄격하게 분리하여 사용합니다: Claude Chat은 설계자 역할을 하여 모든 프롬프트를 설계하고, Claude Code는 빌더 역할을 하여 해당 프롬프트를 실행합니다. 개발자는 Code가 자체 작업을 설계할 때 발생한 숨겨진 품질 문제, 건너뛴 테스트, 기능에 대한 거짓 주장 등의 문제를 경험한 후 이러한 역할을 절대 혼용하지 않는다고 강조합니다.

두 단계 프롬프트 방법

Claude Code로 보내는 모든 프롬프트는 두 단계를 거칩니다:

1단계: Claude Chat은 도메인 전문가 역할을 하여 프롬프트 내용을 작성합니다 - 무엇이, 어떤 순서로, 어떤 제약 조건으로 이루어져야 하는지를 명시합니다.
2단계: Claude Chat은 "AI 신뢰성 엔지니어"로서 프롬프트를 재작성하며, 작업에 대한 구체적인 실패 모드를 식별하고 완화책을 내장합니다. 여기에는 인쇄된 증명(단순히 "테스트 통과"가 아닌)이 필요한 검증 게이트, 단축키 방지 규칙, 롤백 계획, 일괄 작업 전 단일 파일 작업, 편집 후 재읽기 요구사항, 수정 전 백업 게이트 등이 포함됩니다.

인계 과정

Claude Chat이 Claude Code와 직접 대화할 수 없기 때문에, 개발자는 프롬프트를 인계 폴더에 복사하고 Code에 붙여넣습니다. 이 마찰은 이를 건너뛰는 위험에 비해 필요하다고 여겨집니다.

핵심 규칙

하나의 프롬프트는 하나의 목표와 동일 - 작업을 묶지 않음
모든 프롬프트는 Code가 채택해야 할 정확한 역할을 지정하며, "시니어 개발자"와 같은 일반적인 역할이 아닌 구체적인 전문성 조합을 명시
기억에서 상태를 가정하지 않음 - 실제 파일에 대해 검증
Code는 모든 세션 시작 시 프로젝트의 CLAUDE.md 파일을 읽어 전체 맥락 파악
Chat은 해결책을 제안하기 전에 진단 질문을 함
대화 중에 범위가 확장되면, Chat은 통합할지 연기할지 확인
프롬프트에 커밋 지시사항을 포함하지 않음 - 대신 "작업이 검증되면 커밋 체크포인트를 제안하세요" 사용
모든 프롬프트는 파일 인계 체크리스트로 끝남
속도보다는 항상 주의를 기울임

사전 프롬프트 질문

어떤 프롬프트를 작성하기 전에, 개발자는 Claude에게 세 가지 질문에 답하도록 강제합니다:

이 특정 작업에 이상적인 특성을 가진 최적의 역할은 무엇인가요?
이 작업에 대한 모든 가능한 실패 모드는 무엇이며, 각각을 어떻게 완화하나요?
나는 최대 능력을 발휘하고 있나요, 아니면 서두르고 있나요?

이 방법이 효과적인 이유

개발자는 Claude가 훌륭한 실행자가 될 수 있지만, 신뢰할 수 없는 자기 감독자가 될 수 있다는 것을 발견했습니다. Code가 자체 프롬프트를 설계할 때는 품질보다 완료를 최적화합니다. Chat이 내장된 실패 방지 기능으로 프롬프트를 설계할 때는 Code가 일관되게 결과를 제공합니다. 이 과정의 추가적인 마찰은 버그가 아닌 기능으로 간주됩니다.

📖 전체 원문 읽기: r/ClaudeAI