AI 프롬프트 엔지니어링: 개발자를 위한 필수 명령과 팁

프롬프트 엔지니어링은 AI 도구를 사용하는 개발자에게 가장 중요한 기술 중 하나가 되었습니다. ChatGPT, Claude, GitHub Copilot, Cursor 중 무엇을 사용하든, 프롬프트의 품질이 AI 출력의 품질을 직접 결정합니다. 잘 설계된 프롬프트는 모호하고 쓸모없는 응답을 정밀하고 프로덕션 준비가 된 코드로 변환할 수 있습니다. 이 종합 가이드는 기본 프롬프트 팁부터 고급 전략, 도구별 팁, 즉시 사용 가능한 템플릿까지 모든 것을 다루며, 모든 AI 상호작용에서 최대 가치를 얻을 수 있도록 도와줍니다.

프롬프트 엔지니어링이란 무엇인가요?

프롬프트 엔지니어링은 AI 언어 모델이 원하는 출력을 생성하도록 효과적인 지시사항을 정교하게 설계하는 예술이자 과학입니다. 그 핵심은 커뮤니케이션에 있습니다 — AI 모델이 가장 잘 이해하는 언어로 표현하는 방법을 배우는 것입니다. 시니어 개발자가 주니어 개발자에게 더 나은 결과를 위해 더 정확한 지시를 내리는 것처럼, 프롬프트 엔지니어링은 AI 시스템에 명확하고 정밀하게 의도를 전달하는 방법을 가르쳐줍니다.

개발자에게 프롬프트 엔지니어링이 중요한 이유는 AI 프로그래밍 도우미가 현대 개발 워크플로우의 필수적인 부분이 되었기 때문입니다. 이러한 도구는 코드를 생성하고, 문제를 디버깅하고, 테스트를 작성하고, 아키텍처를 리팩토링하고, 복잡한 시스템을 설명할 수 있습니다 — 하지만 올바른 지시사항을 제공했을 때만 가능합니다. 잘못 작성된 프롬프트는 컴파일되지만 의도와 맞지 않는 코드, 잘못된 프레임워크 버전을 사용한 코드, 또는 중요한 경계 조건을 놓친 코드를 생성할 수 있습니다. 반면, 잘 설계된 프롬프트는 경험 많은 개발자가 작성한 코드와 구별할 수 없는 출력을 생성할 수 있습니다.

프롬프트의 작은 변화가 큰 영향을 미칩니다. "버그 수정"과 "src/services/UserService.ts에 있는 UserService.authenticate 메서드에서 email 매개변수가 undefined일 때 발생하는 null 참조 예외를 수정해줘. 이 메서드는 bcrypt를 사용하여 비밀번호를 비교해"의 차이를 비교해 보세요. 첫 번째 프롬프트는 AI에 유용한 정보를 거의 제공하지 않습니다. 두 번째는 명확한 문제 설명, 위치 및 컨텍스트를 제공하여 AI가 첫 번째 시도에서 정확하고 올바른 수정을 생성할 수 있게 합니다.

기본 프롬프트 팁

핵심 프롬프트 기법을 이해하는 것이 기초를 다집니다. 각 기법에는 특화된 사용 사례가 있으며, 경험 많은 프롬프트 엔지니어는 최상의 결과를 위해 단일 프롬프트에 여러 기법을 결합하는 경우가 많습니다.

제로샷 프롬프팅

제로샷 프롬프팅은 가장 간단한 프롬프트 형태입니다 — 예제를 제공하지 않고 AI에 직접 지시를 내립니다. AI는 훈련 데이터와 프롬프트의 정보에만 의존하여 응답을 생성합니다. 이 기법은 원하는 출력 형식이 명백한 간단한 작업이나, AI가 훈련 중에 많은 유사한 예를 본 경우에 적합합니다.

Write a Python function that validates an email address using regex.
The function should return True for valid emails and False for invalid ones.

제로샷 프롬프팅은 일반적이고 명확하게 정의된 작업에 효과적입니다. 그러나 특정 출력 형식, 스타일 또는 접근 방식이 필요할 때는 퓨샷 프롬프팅이 더 신뢰할 수 있습니다.

퓨샷 프롬프팅

퓨샷 프롬프팅은 실제 작업을 제시하기 전에 원하는 입력-출력 패턴의 예제를 하나 이상 제공하는 것입니다. 이 기법은 원하는 것을 정확히 보여주어 모호성을 줄이고 AI를 올바른 형식과 스타일로 안내하므로 매우 강력합니다. AI는 예제에서 패턴을 학습하고 이를 새로운 입력에 적용합니다.

Convert these database column names to camelCase JavaScript variable names:

user_first_name -> userFirstName
created_at_timestamp -> createdAtTimestamp
is_email_verified -> isEmailVerified
total_order_count ->

Now convert: product_category_id

퓨샷 프롬프팅은 일관된 형식, 특정 코딩 규칙이 필요하거나, AI가 프로젝트 스타일에 맞지 않는 가정을 할 수 있을 때 특히 가치가 있습니다. 일반적으로 두세 개의 예제만으로도 명확한 패턴을 확립하기에 충분합니다.

사고 연쇄 프롬프팅

사고 연쇄 프롬프팅은 AI가 최종 답변을 제공하기 전에 단계별로 문제를 추론하도록 요구합니다. 이 기법은 AI가 잘못된 결론으로 바로 건너뛰지 않고 중간 단계를 처리하도록 강제하므로 복잡한 작업의 정확성을 크게 향상시킵니다. 연구에 따르면 프롬프트에 "단계별로 생각해봐"를 추가하면 추론 작업에서 정확성이 30-50% 향상됩니다.

Analyze this React component for performance issues. Think step by step:

1. First, identify all state variables and their update patterns
2. Then, check for unnecessary re-renders
3. Next, look for missing memoization opportunities
4. Finally, suggest specific optimizations with code examples

Here's the component:
[component code]

사고 연쇄 프롬프팅은 디버깅, 아키텍처 결정 및 논리적 추론이 필요한 모든 작업에 필수적입니다. AI가 추론 과정을 보여주도록 요구함으로써, 추론을 검증하고 중간 단계의 오류를 발견할 수 있는 능력도 얻게 됩니다.

역할극 프롬프팅

역할극 프롬프팅은 AI에 특정 역할이나 전문성 수준을 할당하여 응답의 깊이, 스타일 및 초점에 영향을 미칩니다. AI에 "시니어 DevOps 엔지니어로 행동해"라고 말하면, 범용적인 코드 스니펫 대신 더 운영 중심적이고 프로덕션 환경에 적합한 조언을 제공하도록 관점을 전환합니다. 이 기법은 AI의 도메인 특화 콘텐츠 훈련을 활용하여 더 전문가 수준의 출력을 생성합니다.

Act as a senior security engineer with 15 years of experience in web application security. Review this authentication implementation and identify any vulnerabilities, ranking them by severity. For each vulnerability, explain the attack vector and provide a secure code fix.

효과적인 역할극의 핵심은 구체성에 있습니다. "Python 개발자로 행동해"는 너무 모호합니다. "Apache Airflow와 pandas를 사용하여 고성능 데이터 파이프라인을 구축하는 데 특화된 Python 개발자로 행동해"는 AI에 더 명확한 참조 프레임워크를 제공합니다.

시스템 프롬프트와 사용자 프롬프트

대부분의 AI 도구는 시스템 프롬프트와 사용자 프롬프트를 구분합니다. 시스템 프롬프트는 전체 대화에 적용되는 영구적인 지시사항을 설정하고, 사용자 프롬프트는 개별 메시지입니다. 이 차이를 이해하는 것은 장기간 상호작용에서 일관성을 유지하는 데 중요합니다.

CLAUDE.md 파일이 영구적인 시스템 프롬프트 역할을 합니다. ChatGPT에서는 사용자 정의 지시사항을 모든 대화의 시스템 프롬프트로 설정할 수 있습니다.

# System prompt example
You are a TypeScript expert working on a Next.js 14 project using:
- App Router (not Pages Router)
- Server Components by default
- Prisma for database access
- Tailwind CSS for styling
- Zod for validation

Always use strict TypeScript. Prefer server actions over API routes.
Never use 'any' type. Use 'unknown' and narrow with type guards.

# User prompt example
Add a user profile page that shows the current user's name, email,
avatar, and last 10 activity records. Include loading states and
error handling.

개발자 필수 AI 명령어

특정 명령 패턴은 모든 주요 AI 프로그래밍 도구에서 매우 효과적인 것으로 입증되었습니다. 이는 리터럴 명령이 아니라 지속적으로 고품질 응답을 트리거하는 지시 구문입니다. AI 모델의 특정 능력을 활성화하는 파워 워드로 생각하세요.

"Act as..." / "You are a..." — 역할 할당

역할 할당은 프롬프트 엔지니어링에서 가장 강력한 명령 중 하나입니다. 역할을 지정함으로써 도메인 특화 지식을 활성화하고 응답의 깊이와 스타일에 대한 기대치를 설정합니다. 역할이 구체적일수록 출력이 더 좋아집니다.

You are a senior backend engineer at a fintech company who specializes
in building secure, high-throughput payment processing systems.
You have deep expertise in PostgreSQL, Redis, and distributed systems.
You always consider edge cases, race conditions, and failure modes.

Design a payment processing API that handles:
- Credit card payments via Stripe
- Bank transfers via Plaid
- Retry logic with exponential backoff
- Idempotency keys to prevent duplicate charges

"Step by step" — 사고 사슬

프롬프트에 "단계별로" 또는 "차근차근 생각해보자"를 추가하면 AI가 추론 과정을 분해하도록 트리거합니다. 이는 디버깅, 알고리즘 설계 및 아키텍처 결정에 특히 효과적입니다. 단계별 접근 방식은 더 나은 결과를 생성할 뿐만 아니라 AI의 추론을 투명하게 만들어 논리적 오류를 발견할 수 있게 합니다.

Debug this SQL query that's causing a timeout. Think step by step:

1. First, analyze the query structure and joins
2. Identify potential performance bottlenecks
3. Check for missing indexes
4. Suggest an optimized version with EXPLAIN analysis

SELECT u.name, COUNT(o.id), SUM(o.amount)
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
LEFT JOIN order_items oi ON o.id = oi.order_id
WHERE o.created_at > '2026-01-01'
GROUP BY u.name
HAVING COUNT(o.id) > 10
ORDER BY SUM(o.amount) DESC;

"Think aloud" — 추론 투명화

"Think aloud"은 "step by step"과 유사하지만 AI의 의사 결정 과정에 더 중점을 둡니다. AI가 어떤 대안을 고려했고 왜 특정 방법을 선택했는지 등 추론을 설명하도록 요구합니다. 설계 결정의 트레이드오프를 이해하거나 AI의 추론이 합리적인지 평가하려는 경우 매우 유용합니다.

I need to choose between WebSocket and Server-Sent Events for a
real-time notification system. Think aloud about the trade-offs,
considering: browser support, bidirectional communication needs,
server resource usage, and scalability. Then recommend one with
justification.

"Explain like I'm 5" — 간단한 설명

새로운 개념을 배우거나 복잡한 코드를 이해하려고 할 때, "5살 아이에게 설명하듯이"(ELI5)는 전문 용어를 제거하고 직관적이고 비유 기반의 설명을 제공합니다. 이는 새로운 프로젝트에 참여하거나, 낯선 코드베이스를 이해하거나, 비기술적 이해관계자에게 기술 개념을 설명할 때 특히 유용합니다.

Explain like I'm 5: What is a monad in functional programming,
and why do Haskell developers keep talking about them?
Use a real-world analogy, not code.

"Review and critique" — 코드 리뷰

"검토하고 비평해줘"를 사용하면 AI가 단순히 코드를 수용하지 않고 비판적 관점을 취하도록 신호를 보냅니다. 이는 잠재적 버그, 보안 문제, 성능 문제 및 스타일 위반을 포함한 더 철저한 분석을 생성합니다. 마치 시니어 엔지니어의 코드 리뷰를 주문형으로 받는 것과 같습니다.

Review and critique this Express.js middleware. Focus on:
- Security vulnerabilities
- Error handling gaps
- Performance concerns
- Best practice violations
- Suggest improvements with code examples

[paste your middleware code]

"Write tests for" — 테스트 생성

테스트 생성은 AI 프로그래밍 도구의 가장 높은 가치의 사용 사례 중 하나입니다. "테스트 작성해줘"와 함께 테스트 프레임워크와 커버리지 기대치를 지정하면 포괄적인 테스트 스위트를 빠르게 생성할 수 있습니다. 핵심은 경계 조건과 테스트 우선순위를 지정하는 것입니다.

Write tests for the UserService.register method using Jest.
Cover these scenarios:
- Happy path with valid input
- Duplicate email registration
- Invalid email format
- Password too short
- Missing required fields
- Database connection failure
- Concurrent registration attempts

Use describe/it blocks. Include setup and teardown.
Mock the database layer.

"Refactor using..." — 패턴 기반 리팩토링

리팩토링 프롬프트에서 디자인 패턴이나 원칙을 지정하면 AI에 명확한 목표 아키텍처를 제공합니다. 모호한 "이거 리팩토링해줘" 요청 대신, 패턴을 명명하면 확립된 소프트웨어 엔지니어링 원칙을 따르는 집중적이고 일관된 리팩토링이 생성됩니다.

Refactor this notification system using the Strategy pattern.
Currently, all notification types (email, SMS, push) are handled
in a single class with if-else chains. Create separate strategy
classes for each notification type, a context class that delegates
to the active strategy, and a factory for creating strategies.

[paste your current code]

"Find bugs in" — 디버깅

"Find bugs in" 명령은 AI의 분석 모드를 활성화하여 코드를 생성하는 대신 문제를 찾도록 합니다. 코드를 제공하고, 예상되는 동작을 설명하며, 관찰한 증상을 언급할 때 가장 효과적입니다.

Find bugs in this async Node.js function. It's supposed to process
a batch of orders and update their status, but sometimes orders
get processed twice and the status updates are inconsistent under
high load.

[paste your function code]

"Add error handling" — 견고성 강화

많은 AI 생성 코드 스니펫은 정상 경로에서는 작동하지만 적절한 오류 처리가 부족합니다. "오류 처리 추가해줘" 명령은 이 격차를 구체적으로 겨냥하여 AI가 장애 모드, 경계 조건 및 복구 전략을 고려하도록 요구합니다.

Add error handling to this file upload function. Consider:
- File size limits
- Invalid file types
- Network interruptions during upload
- Disk space errors
- Concurrent upload conflicts
- Partial upload cleanup

Use try-catch with specific error types. Add retry logic for
transient failures. Return meaningful error messages to the client.

코드 생성을 위한 프롬프트 패턴

개별 명령 외에도, 특정 프롬프트 패턴은 특정 유형의 코드 생성 작업에 특히 효과적인 것으로 입증되었습니다. 이러한 패턴은 역할 할당, 컨텍스트 제공 및 출력 명세와 같은 기법을 구조화된 프롬프트로 결합하여 지속적으로 고품질 결과를 생성합니다.

기능 구현 프롬프트

새로운 기능을 구현할 때 가장 효과적인 프롬프트는 사양과 유사한 구조를 따릅니다: 기능 설명, 기술 스택 지정, 수락 기준 정의, 제약 조건 언급. 이는 AI에 구축해야 할 것에 대한 완전한 그림을 제공합니다.

Implement a user avatar upload feature for a Next.js 14 application.

Tech stack: Next.js App Router, TypeScript, Prisma, PostgreSQL, AWS S3

Requirements:
- Accept JPEG, PNG, WebP (max 5MB)
- Resize to 200x200 and 400x400 thumbnails using Sharp
- Upload originals to S3 with unique keys
- Store S3 URLs in the User model
- Delete old avatar when uploading a new one
- Return presigned URLs for frontend display

Acceptance criteria:
- Invalid file types return 400 with error message
- Files over 5MB return 413
- Successful upload returns 200 with avatar URLs
- Old avatars are cleaned up from S3

Create: API route, service layer, Prisma schema update, and types.

API 설계 팁

API 설계 프롬프트는 아키텍처 스타일, 인증 방법, 버전 전략 및 응답 형식을 미리 지정하면 더 나은 결과를 얻을 수 있습니다. 이는 생성된 API가 일관되고 프로젝트 규칙을 따르도록 보장합니다.

Design a RESTful API for a project management application.

Architecture: Express.js with TypeScript, following clean architecture
Auth: JWT with refresh token rotation
Versioning: URL-based (/api/v1/)
Response format: { success: boolean, data?: T, error?: { code, message } }

Endpoints needed:
- Projects CRUD with team membership
- Tasks CRUD with assignee, priority, status
- Comments on tasks with mentions
- Activity feed (recent actions across projects)

Include:
- Request/response TypeScript interfaces
- Zod validation schemas
- Error handling middleware
- Pagination for list endpoints (cursor-based)

데이터베이스 스키마 프롬프트

데이터베이스 스키마 프롬프트는 ORM, 명명 규칙, 인덱스 전략 및 관계를 지정해야 합니다. AI는 적절한 제약 조건, 인덱스 및 마이그레이션 파일이 포함된 완전한 스키마를 생성할 수 있습니다.

Design a Prisma schema for an e-commerce platform with these entities:

- Users (authentication, profile, addresses)
- Products (variants, categories, inventory)
- Orders (line items, status history, payments)
- Reviews (ratings, images, helpful votes)
- Cart (items, applied coupons)

Requirements:
- Use PostgreSQL with UUID primary keys
- Soft deletes with deletedAt timestamps
- Proper indexes for common query patterns
- Enums for order status, payment status
- Decimal fields for prices (not float)
- Full-text search on product name and description
- Include a migration file

프로 팁: 대비 검사기 도구를 사용하여 색상 조합이 WCAG 요구 사항을 충족하는지 확인하세요. 정확한 대비 비율을 계산하고, 조합이 어떤 WCAG 등급을 통과했는지 알려줍니다.

UI 컴포넌트의 경우, 프레임워크, 스타일 접근 방식, 접근성 요구 사항 및 상호작용 상태를 지정하는 것이 일반적인 "컴포넌트 생성" 프롬프트보다 더 나은 결과를 생성합니다.

Create a reusable DataTable component in React with TypeScript.

Styling: Tailwind CSS + shadcn/ui conventions
Features:
- Column definitions with sort, filter, and custom renderers
- Server-side pagination with page size selector
- Row selection (single and multi) with checkboxes
- Loading skeleton state
- Empty state with custom message
- Responsive: card layout on mobile, table on desktop

Accessibility:
- Keyboard navigation (arrow keys, Enter, Escape)
- Screen reader announcements for sort and filter changes
- ARIA labels on all interactive elements

Props interface:
- data, columns, isLoading, pagination, onSort, onFilter, onSelect

Include a usage example with a user list table.

구성 및 DevOps 프롬프트

DevOps 및 구성 프롬프트는 대상 환경, 보안 요구 사항 및 조직 표준을 지정해야 합니다. 이는 AI가 인프라에 맞지 않는 일반적인 구성을 생성하는 것을 방지합니다.

Create a Docker Compose setup for a development environment with:
- Next.js app (hot reload enabled)
- PostgreSQL 16 with persistent volume
- Redis for session storage
- MinIO (S3-compatible) for local file storage

Requirements:
- All services on a shared network
- Environment variables from .env file
- Health checks for all services
- Volumes for node_modules (avoid bind mount issues)
- PostgreSQL initialized with seed data
- Non-root containers where possible

Also create:
- Dockerfile for the Next.js app (multi-stage build)
- .env.example with all required variables
- Makefile with common commands (up, down, logs, reset-db)

고급 프롬프트 전략

기본 기법과 명령을 마스터한 후, 이러한 고급 전략은 단일 프롬프트의 능력을 넘어서는 복잡한 다단계 개발 작업을 처리하는 데 도움이 될 것입니다.

프롬프트 체이닝

프롬프트 체이닝은 복잡한 작업을 일련의 더 작고 집중된 프롬프트로 분해하며, 각 프롬프트는 이전 출력을 기반으로 구축됩니다. 이 전략은 각 단계가 AI의 전체 주의와 컨텍스트를 받기 때문에, 하나의 거대한 프롬프트로 모든 것을 처리하려는 것보다 더 나은 결과를 생성합니다.

# Step 1: Design the architecture
"Design the architecture for a real-time chat application.
List the components, their responsibilities, and how they
communicate. Use a diagram-like text format."

# Step 2: Define the data model
"Based on the architecture above, design the database schema
for the chat application. Include users, conversations,
messages, and read receipts. Use Prisma schema format."

# Step 3: Implement the API
"Implement the REST API for the chat application based on
the architecture and schema we designed. Start with the
message endpoints: send, list, delete."

# Step 4: Add WebSocket support
"Now add WebSocket support for real-time message delivery.
Use Socket.io. Integrate with the existing message API."

# Step 5: Write tests
"Write integration tests for the chat API and WebSocket
events using Jest and Supertest."

효과적인 프롬프트 체이닝의 핵심은 각 단계가 다음 단계로 넘어가기 전에 완전하고 사용 가능한 출력을 생성하도록 보장하는 것입니다. 각 출력을 검토하고 필요에 따라 수정한 다음, 정제된 결과를 다음 프롬프트에 입력하세요.

애니메이션 필 모드

컨텍스트 채우기는 질문하기 전에 AI에 모든 관련 코드, 문서 및 컨텍스트를 제공하는 것입니다. 당연해 보이지만, 많은 개발자가 이 단계를 건너뛰고 AI가 왜 잘못된 가정을 했는지 의아해합니다. 더 많은 관련 컨텍스트를 제공할수록 AI의 응답이 더 정확하고 구체적이 됩니다.

 {
    await this.db.query('UPDATE users SET email = $1 WHERE id = $2', [email, id]);
    await this.cache.del(`user:${id}`);
  }
}
```

Here is the User type:
```typescript
interface User {
  id: string;
  email: string;
  name: string;
  role: 'admin' | 'user';
  createdAt: Date;
}
```

Now, add an updateProfile method that allows updating name and email,
with validation that the email is not already taken by another user.

기존 코드와 타입을 제공함으로써 AI가 기존 패턴과 완전히 일치하는 메서드를 생성하고, 동일한 캐싱 전략을 사용하며, 기존 타입 정의를 따를 수 있게 되는 방식에 주목하세요.

제약 조건 명세

명시적 제약 조건을 설정하면 AI가 원치 않는 가정을 하는 것을 방지할 수 있습니다. 제약 조건은 AI가 하지 말아야 할 것을 정의하며, 이는 종종 해야 할 것만큼 중요합니다. 일반적인 제약 조건에는 기술 버전, 성능 요구 사항, 보안 규칙 및 코딩 표준이 포함됩니다.

Build a URL shortener API with these constraints:

MUST:
- Use Node.js 20+ with native fetch (no axios)
- Use PostgreSQL via pg driver (no ORM)
- Generate short codes of exactly 7 characters
- Support custom aliases (max 20 chars)
- Return 301 for existing short URLs
- Rate limit to 100 creates per hour per IP

MUST NOT:
- Use any ORM or query builder
- Store full URLs without normalization
- Allow short codes that conflict with existing routes
- Return database errors to the client

PERFORMANCE:
- Handle 10,000 requests per second
- Cache hot URLs in Redis with 5-minute TTL
- P99 latency under 50ms for redirects

출력형식제어 대상

원하는 출력 형식을 지정하면 AI의 응답을 재포맷 없이 즉시 사용할 수 있습니다. 이는 출력이 다른 도구에 의해 파싱되거나, 문서에 삽입되거나, 구성 파일로 사용되어야 할 때 특히 중요합니다.

Analyze this codebase and provide the output in this exact format:

## Architecture Overview
[2-3 paragraph summary]

## Component Diagram
```mermaid
graph TD
    [components and relationships]
```

## API Endpoints
| Method | Path | Description | Auth |
|--------|------|-------------|------|

## Database Tables
| Table | Columns | Indexes | Relations |
|-------|---------|---------|-----------|

## Recommendations
1. [Priority] [Description] - [Estimated effort]
2. ...

## Technical Debt
- [ ] [Description] - [Impact: High/Medium/Low]

성능 최적화

반복적 개선은 후속 프롬프트를 통해 AI 출력을 점진적으로 개선하는 실천입니다. 첫 번째 응답이 완벽한 경우는 드물지만, 최적화할 수 있는 출발점을 제공합니다. 각 반복은 단일 프롬프트로 완벽을 달성하려는 것보다 더 효율적으로 원하는 결과에 접근합니다.

# Iteration 1: Get a starting point
"Write a rate limiter middleware for Express.js"

# Iteration 2: Add specificity
"Good start. Now modify it to use Redis for distributed
rate limiting across multiple server instances. Use sliding
window instead of fixed window."

# Iteration 3: Add edge cases
"Add handling for: Redis connection failures (fall back to
in-memory), custom rate limits per route, burst allowance
for legitimate traffic spikes, and proper headers
(X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset)."

# Iteration 4: Add tests
"Write comprehensive tests for all the scenarios we've
covered, including Redis failures and burst handling."

이 반복적 접근 방식은 각 반복이 AI의 이전 출력을 기반으로 수정하고 세부 사항을 추가할 수 있게 하므로, 단일 거대한 프롬프트를 작성하는 것보다 더 효과적입니다. 이는 인간 개발자와 협업하는 방식을 반영합니다: 대략적인 구현으로 시작한 다음 다듬어 나가는 것입니다.

도구별 프롬프트 팁

위의 기법들이 모든 AI 도구에 적용되지만, 각 플랫폼은 고유한 강점과 특성을 가지고 있습니다. 각 도구의 특성에 맞게 프롬프트 스타일을 조정하면 결과를 크게 개선할 수 있습니다.

ChatGPT / GPT-4

ChatGPT와 GPT-4는 대화형 상호 작용에 능숙하며, 구조화되고 잘 조직된 프롬프트의 이점을 누립니다. 긴 컨텍스트를 잘 처리하며, 특히 개념 설명과 문서 생성에 뛰어납니다.

• 사용자 정의 지시사항 사용: ChatGPT의 사용자 정의 지시사항에 기술 스택과 선호도를 설정하면 매 대화마다 반복할 필요가 없습니다.
• Code Interpreter 활용: 데이터 분석 작업의 경우, ChatGPT에 Code Interpreter를 사용하여 Python 코드를 실행하고 시각화를 생성하도록 요청하세요.
• 프롬프트에 마크다운 형식 사용: GPT-4는 제목, 글머리 기호 및 코드 블록이 있는 구조화된 프롬프트에 잘 응답합니다.
• 응답 길이 지정: GPT-4는 장황한 경향이 있습니다. 간결함이 필요할 때는 "간결하게" 또는 "200단어 이내로"를 추가하세요.
• 시스템 메시지 사용: API에서 시스템 메시지를 사용하여 코딩 표준 및 프로젝트 컨텍스트와 같은 영구적 지시사항을 설정하세요.

# Effective GPT-4 prompt structure
**Role:** Senior TypeScript developer
**Task:** Implement a JWT authentication middleware
**Context:** Express.js API, PostgreSQL, existing User model
**Constraints:** No external auth libraries, use crypto module
**Output:** Complete, production-ready code with types
**Format:** Single file with inline comments for complex logic

Claude / Claude Code

Claude와 Claude Code는 대규모 코드베이스를 이해하고, 복잡한 지시를 따르며, 구조화된 출력을 생성하는 데 특히 강합니다. Claude Code의 에이전트 능력은 다단계 작업에 매우 적합합니다.

• CLAUDE.md 사용: 이것이 가장 영향력 있는 일입니다. 프로젝트 컨텍스트, 규칙 및 선호도를 CLAUDE.md에 넣으세요.
• 파일 위치 명시적 지정: Claude Code는 읽고 수정할 파일을 지정할 때 가장 효과적입니다.
• 명령 실행하게 하기: Claude Code는 테스트 및 빌드 명령을 실행할 수 있습니다. 테스트를 실행하여 작업을 검증하도록 요청하세요.
• 긴 세션에서 /compact 사용: 컨텍스트가 길어지면 /compact를 사용하여 대화를 압축하면서 가장 중요한 정보를 보존하세요.
• XML 태그 활용: Claude는 프롬프트에서 XML로 마크업된 부분에 잘 응답하며, 요청의 여러 부분을 명확히 구분할 수 있습니다.

# Effective Claude Code prompt
Read the following files to understand the current architecture:
- src/routes/userRoutes.ts
- src/middleware/authMiddleware.ts
- src/models/User.ts

Then refactor the authentication flow to support:
1. JWT access tokens (15 min expiry) + refresh tokens (7 day expiry)
2. Token rotation on refresh (invalidate old refresh token)
3. Rate limiting on the refresh endpoint (5 per minute per user)

Update all related files and run the test suite when done.

GitHub Copilot

GitHub Copilot은 채팅 기반 도구와 다르게 작동합니다. 입력할 때 인라인 제안을 제공합니다. 효과적인 Copilot 사용은 주석, 타입 시그니처 및 주변 컨텍스트를 통해 의도를 명확히 전달하는 코드를 작성하는 데 달려 있습니다.

• 설명적 주석 작성: 함수 앞에 // Validate email format and check for duplicates와 같은 주석을 추가하여 Copilot에 명확한 의도를 전달하세요.
• TypeScript 타입 사용: 잘 정의된 타입과 인터페이스는 Copilot을 올바른 구현으로 안내합니다.
• 주석에 예제 제공: 주석에 예상 입력/출력을 보여주어 Copilot이 원하는 형식과 일치하도록 도와주세요.
• 부분 제안 수락: 때로는 Copilot의 구조는 맞지만 세부 사항이 틀릴 수 있습니다. 제안을 수락한 다음 세부 사항을 편집하세요.
• 복잡한 작업에 Copilot Chat 사용: 다중 파일 변경이나 아키텍처 결정에는 인라인 제안 대신 Copilot Chat을 사용하세요.

> {
  // Copilot will generate the implementation based on these types

Cursor

Cursor는 IDE 통합과 AI 채팅 기능을 결합하여 인라인 완성과 코드베이스를 이해하는 채팅 인터페이스를 제공합니다. 깊은 프로젝트 인식과 특정 파일 및 심볼을 참조하는 능력이 강점입니다.

• @file 참조 사용: @filename으로 특정 파일을 참조하여 Cursor에 정확한 컨텍스트를 제공하세요.
• @codebase로 광범위한 컨텍스트 얻기: Cursor가 전체 프로젝트를 검색해야 할 때 @codebase를 사용하세요.
• @docs로 라이브러리 문서 가져오기: Cursor는 @docs로 서드파티 라이브러리 문서를 참조할 수 있습니다.
• Cmd+K로 인라인 편집 활용: 코드를 선택하고 Cmd+K로 자연어로 변경 사항을 설명하세요.
• 프로젝트 규칙 설정: .cursorrules 파일(CLAUDE.md와 유사)을 사용하여 영구적인 프로젝트 지시사항을 설정하세요.

# Effective Cursor prompt
@src/services/paymentService.ts @src/types/payment.ts

Refactor the processPayment function to use the Strategy pattern.
Create separate strategy classes for each payment provider
(Stripe, PayPal, BankTransfer). The function should accept a
payment method and delegate to the appropriate strategy.

Keep the same public API so existing callers don't break.

Codex CLI

Codex CLI는 OpenAI의 터미널 기반 프로그래밍 에이전트로, 개념적으로 Claude Code와 유사합니다. 명령줄에서 다단계 개발 작업을 실행하는 데 능숙합니다.

• 명확한 목표 제공: Codex CLI는 단계별 지시보다 명확한 고수준 목표가 있을 때 가장 효과적입니다.
• 작업 디렉토리 지정: 올바른 프로젝트 루트 디렉토리에서 Codex CLI를 실행하는지 확인하세요.
• 먼저 제안 모드 사용: Codex가 변경하기 전에 제안 모드를 사용하여 계획을 검토하세요.
• 샌드박스 권한 신중히 설정: 샌드박스 권한을 구성하여 Codex가 실행할 수 있는 작업을 제어하세요.
• 출력 반복: 다른 도구와 마찬가지로, 첫 번째 시도는 후속 프롬프트를 통해 최적화가 필요할 수 있습니다.

일반적인 실수와 피하는 방법

경험 많은 개발자도 이러한 일반적인 프롬프트 실수를 범합니다. 이를 인식하고 피하는 것만으로도 AI 상호작용이 즉시 개선됩니다.

박스 그림자: 그림자 오프셋과 블러 반경은 일반적으로 일관된 시각적 효과를 위해 픽셀을 사용하는 것이 가장 좋습니다.

가장 흔한 실수는 모호하고 구체적이지 않은 지시를 제공하는 것입니다. "이거 고쳐줘", "더 좋게 만들어줘", "기능 추가해줘"와 같은 프롬프트는 AI에 유용한 정보를 거의 제공하지 않습니다. AI는 가정을 하게 되고, 이러한 가정은 보통 의도와 일치하지 않습니다.

# Bad
"Fix the login bug"

# Good
"Fix the bug where users with uppercase emails cannot log in.
The issue is in src/auth/login.ts - the email comparison is
case-sensitive but emails are stored in lowercase in the database.
The fix should normalize the email to lowercase before comparison."

default-src 누락

AI 모델은 당신이 알려주지 않으면 프로젝트에 대해 알지 못합니다. 기술 스택, 프레임워크 버전, 기존 코드 패턴 또는 프로젝트 구조와 같은 관련 컨텍스트를 제공하지 않으면 AI가 추측하게 되며, 종종 틀리게 됩니다. 새로운 팀 구성원이 요청을 이해하는 데 필요한 컨텍스트를 항상 포함하세요.

# Bad
"Write a function to send emails"

# Good
"Write an email sending function for our NestJS application.
We use:
- @nestjs/mailer with Handlebars templates
- SMTP via AWS SES
- Templates stored in src/templates/emails/
- Existing MailService class in src/mail/mail.service.ts

The function should accept a template name, recipient, and
template variables. Include error handling for SES throttling
and bounce notifications."

503 Service Unavailable: 서버가 일시적으로 요청을 처리할 수 없으며, 일반적으로 유지 관리 또는 과부하 때문입니다. Retry-After 헤더를 사용하여 재시도 시점을 알립니다.

단일 프롬프트에 너무 많은 관련 없는 작업을 처리하려고 하면 모든 측면에서 평범한 결과가 나옵니다. AI의 주의가 분산되어 일부 작업의 중요한 세부 사항을 건너뛰면서 다른 작업에 과도하게 집중할 수 있습니다. 복잡한 요청을 집중된 순차적 프롬프트로 분해하세요.

# Bad - Too many tasks in one prompt
"Build a complete user management system with authentication,
profile management, email verification, password reset,
role-based access control, and an admin dashboard"

# Good - Break it into focused prompts
Prompt 1: "Design the database schema for a user management system..."
Prompt 2: "Implement the authentication endpoints..."
Prompt 3: "Add email verification flow..."
Prompt 4: "Implement role-based access control middleware..."

포커스 표시기 무시하기: 포커스 표시기는 인접 색상과 최소 3:1의 대비를 가져야 합니다. 기본 브라우저 포커스 링은 색상 배경에서 이 요구 사항을 충족하지 못하는 경우가 많습니다.

특정 형식의 출력이 필요할 때 — JSON, 마크다운, 특정 파일 구조 — 이를 지정하지 않으면 예측할 수 없는 형식이 발생합니다. AI가 JSON이 필요할 때 산문을 반환하거나, 여러 파일이 필요할 때 단일 파일을 반환할 수 있습니다. 항상 원하는 출력 형식을 명시적으로 지정하세요.

# Bad
"List all the API endpoints"

# Good
"List all API endpoints in a markdown table with these columns:
| Method | Path | Description | Auth Required | Request Body | Response |"

반복 없음

최적화 없이 AI의 첫 번째 응답을 수락하는 것은 기회를 놓치는 것입니다. 첫 번째 응답은 후속 프롬프트를 통해 개선할 수 있는 기반을 제공합니다. 반복이야말로 AI 지원 개발의 진정한 힘입니다 — 각 주기가 더 좋고 더 정제된 출력을 생성합니다.

# Instead of accepting the first response, iterate:
"Good start. Now add input validation using Zod schemas."
"Now add proper error handling with custom error classes."
"Now add logging for all operations."
"Now write tests for all the edge cases we've discussed."

프롬프트 템플릿 라이브러리

다음은 일반적인 개발자 작업을 위한 즉시 사용 가능한 프롬프트 템플릿입니다. 이 템플릿을 복사하고, 플레이스홀더를 채우고, 구체적인 요구 사항에 맞게 조정하세요. 각 템플릿은 최대 효과를 위해 여러 프롬프트 기법을 결합합니다.

템플릿 1: 기능 구현

You are a senior {language} developer specializing in {framework}.

Implement {feature_description} for our {project_type} application.

Tech stack:
- {language} {version} with {framework} {version}
- {database} for data storage
- {orm} for database access
- {testing_framework} for tests

Requirements:
- {requirement_1}
- {requirement_2}
- {requirement_3}

Constraints:
- Must follow existing patterns in the codebase
- Must include input validation
- Must handle errors gracefully
- Must be backward compatible

Output:
1. Implementation code with inline comments for complex logic
2. Unit tests covering happy path and edge cases
3. Brief explanation of design decisions

템플릿 2: 버그 조사

You are a debugging specialist with expertise in {language}/{framework}.

Investigate and fix this bug:

**Symptom:** {describe_the_observed_behavior}
**Expected:** {describe_the_expected_behavior}
**Frequency:** {always/sometimes/under_specific_conditions}
**Environment:** {production/staging/development}

Relevant code:
```
{paste_relevant_code}
```

Error output / stack trace:
```
{paste_error_output}
```

Think step by step:
1. Identify the root cause
2. Explain why this bug occurs
3. Provide the fix with code
4. Suggest how to prevent similar bugs
5. Write a regression test

반응형 중단점이 어떻게 그리드 템플릿을 간단히 재정의하는지 주목하세요. 항목은 할당된 그리드 영역을 유지하고, 레이아웃이 자동으로 재구성됩니다. 이는 서로 다른 중단점에서 Flexbox 컨테이너를 재배열하는 것보다 훨씬 깔끔합니다.

You are a senior code reviewer at a {company_type} company.

Review this {language} code for:

1. **Correctness:** Logic errors, off-by-one errors, null handling
2. **Security:** Injection, XSS, auth bypasses, data exposure
3. **Performance:** N+1 queries, unnecessary allocations, missing caches
4. **Maintainability:** Code smells, naming, complexity
5. **Testing:** Missing test cases, brittle tests

Code to review:
```
{paste_code}
```

For each issue found, provide:
- Severity: 🔴 Critical / 🟡 Warning / 🔵 Info
- Category: Which of the 5 areas above
- Description: What's wrong and why
- Suggestion: How to fix it, with code example

End with an overall assessment and top 3 priorities.

템플릿 4: API 엔드포인트 설계

Design a {http_method} {endpoint_path} endpoint for {resource_description}.

Framework: {framework}
Auth: {auth_method}
Database: {database}

The endpoint should:
- {functionality_1}
- {functionality_2}
- {functionality_3}

Provide:
1. Route definition with middleware chain
2. Request validation schema ({validation_library})
3. Controller/handler function
4. Service layer function
5. Database query/function
6. Response types (success and error)
7. Example curl request and response

템플릿 5: 데이터베이스 마이그레이션

Create a database migration for {change_description}.

Current schema:
```
{current_schema}
```

Desired changes:
- {change_1}
- {change_2}

ORM: {orm_name}
Database: {database_type}

Requirements:
- Migration must be reversible (include down migration)
- Preserve existing data (write data migration SQL if needed)
- Add appropriate indexes for new columns
- Consider performance impact on large tables
- Include rollback safety checks

템플릿 6: 테스트 스위트 생성

Write a comprehensive test suite for {function_or_class_name}.

Testing framework: {framework}
Mocking library: {library}

Code under test:
```
{paste_code}
```

Test categories to cover:
- ✅ Happy path: All valid inputs produce correct outputs
- 🔄 Edge cases: Empty inputs, boundary values, null/undefined
- ❌ Error cases: Invalid inputs, permission denied, network failures
- 🏎️ Performance: Response time expectations for critical paths
- 🔒 Security: Auth checks, input sanitization

For each test:
- Use descriptive test names that read like documentation
- Follow Arrange-Act-Assert pattern
- Include setup/teardown for shared state
- Mock external dependencies

템플릿 7: 리팩토링 계획

You are a software architect specializing in {language} refactoring.

Current code:
```
{paste_current_code}
```

Problems with current code:
- {problem_1}
- {problem_2}

Refactor using {pattern_or_principle}.

Provide:
1. **Analysis:** What's wrong and why the current approach doesn't scale
2. **Target Architecture:** How the refactored code should be structured
3. **Step-by-step Plan:** Ordered refactoring steps (safe, incremental)
4. **Refactored Code:** Complete implementation
5. **Migration Guide:** How to transition from old to new without breaking changes
6. **Risk Assessment:** What could go wrong and how to mitigate

템플릿 8: 문서 생성

Generate documentation for this {language} code:

```
{paste_code}
```

Documentation type: {JSDoc/TSDoc/Python docstrings/README section}

Requirements:
- Document all public functions/classes/methods
- Include parameter descriptions with types
- Include return type descriptions
- Add usage examples for non-obvious APIs
- Note any side effects or important caveats
- Use {style_guide} conventions

For README documentation, include:
- Overview (1-2 paragraphs)
- Installation instructions
- Quick start example
- API reference table
- Configuration options

반응형 중단점이 어떻게 그리드 템플릿을 간단히 재정의하는지 주목하세요. 항목은 할당된 그리드 영역을 유지하고, 레이아웃이 자동으로 재구성됩니다. 이는 서로 다른 중단점에서 Flexbox 컨테이너를 재배열하는 것보다 훨씬 깔끔합니다.

You are a performance engineering specialist.

Analyze and optimize this code for performance:

```
{paste_code}
```

Current performance:
- {metric}: {current_value}
- Target: {target_value}
- Bottleneck suspected at: {location}

Optimization constraints:
- Must not change the public API
- Must maintain all existing test passes
- Must not sacrifice readability for micro-optimizations
- {additional_constraint}

Provide:
1. **Profiling Analysis:** Where time/memory is being spent
2. **Optimization Strategies:** Ranked by expected impact
3. **Optimized Code:** With comments explaining each change
4. **Benchmark Comparison:** Before vs after expected metrics
5. **Trade-offs:** Any readability or complexity costs

템플릿 10: 보안 감사

You are a security engineer specializing in {language}/{framework} security.

Perform a security audit on this code:

```
{paste_code}
```

Check for:
- Injection attacks (SQL, NoSQL, command, LDAP)
- Authentication and authorization bypasses
- Cross-site scripting (XSS) vulnerabilities
- Cross-site request forgery (CSRF) exposure
- Insecure direct object references (IDOR)
- Sensitive data exposure (logging, error messages)
- Insecure cryptography or key management
- Race conditions in concurrent operations
- Denial of service vulnerabilities

For each finding:
- Severity: Critical / High / Medium / Low
- OWASP Category: Which Top 10 category
- Description: Clear explanation of the vulnerability
- Attack Scenario: How an attacker would exploit it
- Remediation: Specific code fix
- Verification: How to confirm the fix works