AI 코드 생성 시 프롬프트 설계의 핵심

AI 를 활용한 코드 생성이 일상화되고 있습니다. 하지만 생각했던 대로 코드가 나오지 않아 고민인 경험이 많으실 겁니다. 그 원인은 대부분 AI 에게 주는 지시, 즉 **프로프팅(Prompt Design)**에 있습니다.

대상 독자

• AI 를 활용해 코드를 작성하거나 활용하려는 분
• 특히 Claude Code, GitHub Copilot 등 AI 도구를 일상적으로 사용하는 개발자분께 유용합니다.

이번 글의 목표

"프로프팅은仕様書(요구사항 명세서)이다"라는 사고방식을 이해하고, AI 가 의도한 대로 코드를 생성할 수 있는 프롬프트 설계 능력을 익히는 것입니다.

나쁜 프롬프트 예시

먼저, 다음과 같은 식의 프롬프트는 피해야 합니다:

"Python 으로 웹 크롤러를 만들어줘."

이처럼 맥락이나 제약 조건 없이 단순히 결과만 요구하면 AI 는 가장 일반적인 패턴을 따르거나 불완전한 코드를 생성할 수 있습니다.

좋은 프롬프트 설계의 핵심: '요구사항 명세서'로서의 프롬프팅

프로프팅을 성공적으로 수행하려면, 개발자가 작성하는 실제 코드나 설계 문서처럼 구체적이고 명확한 지침을 제공해야 합니다. 이는 다음과 같은 요소들을 포함합니다:

1. 명확한 목표 정의: 무엇을 만들려는지에 대한 구체적인 설명.
2. 기술적 스택 명시: 사용할 언어, 프레임워크, 라이브러리 등.
3. 입력/출력 데이터 형식: 처리할 데이터의 구조와 예상 결과물.
4. 제약 조건 및 규칙: 성능, 보안, 가독성 등의 요구사항.
5. 예시 코드 (Few-Shot): 원하는 스타일이나 패턴을 보여주는 샘플 코드 제공.

이러한 요소들을 포함한 프롬프트를 작성하면 AI 는 더 정확하고 실행