AI 프롬프트 엔지니어링 완전 가이드: 개발자가 알아야 할 프롬프트 기법 30선

API 만들어줘

Node.js Express로 사용자 인증 REST API를 만들어주세요.

요구사항:
1. POST /auth/register - 이메일, 비밀번호로 회원가입
2. POST /auth/login - JWT 토큰 발급
3. GET /auth/me - 현재 사용자 정보 (인증 필요)

기술 스택:
- Express 4.x, TypeScript
- bcrypt로 비밀번호 해싱
- jsonwebtoken으로 JWT 관리
- Zod로 입력값 검증

출력 형식: 각 파일별로 코드 블록으로 분리해서 보여주세요.

다음 Python 함수의 시간 복잡도를 분석해주세요:

def find_duplicates(arr):
    seen = set()
    duplicates = []
    for item in arr:
        if item in seen:
            duplicates.append(item)
        else:
            seen.add(item)
    return duplicates

아래 예시처럼 커밋 메시지를 작성해주세요:

예시 1:
변경: 로그인 페이지에 소셜 로그인 버튼 추가
커밋: feat(auth): add social login buttons to login page

예시 2:
변경: 사용자 목록 API 응답 속도 개선
커밋: perf(api): optimize user list query with pagination

예시 3:
변경: 결제 금액 계산 오류 수정
커밋: fix(payment): correct total amount calculation logic

이제 다음 변경에 대한 커밋 메시지를 작성해주세요:
변경: 다크 모드에서 차트 색상이 안 보이는 문제 해결

당신은 10년 경력의 시니어 백엔드 엔지니어입니다.
대규모 트래픽 처리, 마이크로서비스 아키텍처, 데이터베이스 최적화에 깊은 전문성을 가지고 있습니다.

다음 코드를 리뷰해주세요. 프로덕션 환경에서 문제가 될 수 있는 부분을 찾아주세요.
보안, 성능, 에러 처리 관점에서 분석해주세요.

당신은 [경력]년 경력의 [직책]입니다.
[전문 분야 1], [전문 분야 2], [전문 분야 3]에 깊은 전문성을 가지고 있습니다.
[회사 유형] 환경에서의 경험이 풍부합니다.

[System]
당신은 TypeScript 코드 리뷰 전문가입니다.

규칙:
1. 코드의 타입 안전성을 최우선으로 평가합니다
2. any 타입 사용을 발견하면 반드시 지적합니다
3. 응답은 한국어로 합니다
4. 각 지적사항에 수정 코드를 포함합니다
5. 심각도를 Critical, Warning, Info로 분류합니다

출력 형식:
## 리뷰 결과
### Critical
- [파일명:줄번호] 설명
### Warning
- [파일명:줄번호] 설명
### Info
- [파일명:줄번호] 설명

리액트 컴포넌트 만들어줘 사용자 프로필 보여주는 거 이름 이메일 프로필 사진 있어야 하고 반응형이어야 하고 다크모드 지원해야 해

## 요청
React 사용자 프로필 컴포넌트를 작성해주세요.

## 필수 요소
1. 사용자 이름
2. 이메일 주소
3. 프로필 사진 (원형 썸네일)

## 기술 요구사항
- React 18 + TypeScript
- Tailwind CSS 사용
- 반응형 디자인 (모바일/데스크톱)
- 다크 모드 지원 (CSS 변수 또는 Tailwind dark:)

## 추가 사항
- Props 인터페이스를 별도로 정의해주세요
- 로딩 상태를 위한 스켈레톤 UI도 포함해주세요

다음 로그 메시지를 분석하고 JSON 형식으로 결과를 반환해주세요.

로그:
ERROR 2025-03-15 14:32:01 [PaymentService] Failed to process payment for order #12345.
Reason: Insufficient funds. User: user@example.com

출력 JSON 스키마:
{
  "timestamp": "ISO 8601 형식",
  "level": "로그 레벨",
  "service": "서비스 이름",
  "message": "핵심 메시지",
  "context": {
    "orderId": "주문 ID",
    "reason": "실패 사유",
    "user": "사용자 식별자"
  }
}

<context>
이 프로젝트는 Next.js 14 App Router 기반의 이커머스 플랫폼입니다.
데이터베이스는 PostgreSQL, ORM은 Prisma를 사용합니다.
</context>

<task>
상품 검색 API를 구현해주세요.
전문 검색(full-text search)을 지원해야 합니다.
</task>

<constraints>
- 검색 응답 시간 200ms 이내
- SQL Injection 방지
- 페이지네이션 필수 (cursor 기반)
</constraints>

<output_format>
1. Prisma 스키마 변경사항
2. API Route 코드
3. 검색 쿼리 최적화 설명
</output_format>

다음 규칙을 반드시 따라주세요:

반드시 해야 할 것:
- TypeScript strict 모드 사용
- 모든 함수에 JSDoc 주석 작성
- 에러 처리를 위한 커스텀 Error 클래스 사용
- 환경 변수는 process.env 직접 접근 대신 config 모듈 통해 접근

절대 하지 말아야 할 것:
- any 타입 사용 금지
- console.log 사용 금지 (logger 라이브러리 사용)
- 동기 파일 I/O 금지
- 하드코딩된 상수 금지

# 나쁜 예 (불필요하게 긴 프롬프트)
안녕하세요. 저는 지금 Python 프로젝트를 하고 있는데요,
혹시 시간이 되시면 아래 코드를 봐주실 수 있을까요?
정말 감사하겠습니다. 코드는 다음과 같습니다...

# 좋은 예 (간결한 프롬프트)
다음 Python 코드를 최적화해주세요. 시간 복잡도 O(n)으로 개선이 목표입니다.

다음 마이크로서비스 아키텍처의 병목 지점을 분석해주세요.
단계별로 생각해봅시다.

아키텍처:
- API Gateway -> User Service -> PostgreSQL
- API Gateway -> Order Service -> MongoDB
- Order Service -> Payment Service (HTTP)
- Payment Service -> External Payment API
- Order Service -> Notification Service (Kafka)

각 단계에서:
1. 해당 서비스의 잠재적 병목 요인을 나열하세요
2. 부하가 초당 10,000 요청일 때 어떤 일이 발생하는지 분석하세요
3. 개선 방안을 제시하세요

이 SQL 쿼리가 느린 이유를 분석하고 최적화해주세요.
단계별로 생각해봅시다.

SELECT u.name, COUNT(o.id) as order_count, SUM(o.total) as total_spent
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE o.created_at >= '2025-01-01'
GROUP BY u.name
HAVING total_spent > 1000
ORDER BY total_spent DESC;

다음 시스템의 캐싱 전략을 설계해주세요.

시스템: 하루 1000만 조회의 뉴스 피드 서비스

3가지 다른 접근법을 각각 탐색해주세요:

접근법 A: Redis 기반 중앙 집중식 캐시
- 장점과 단점을 분석하세요
- 예상 성능 수치를 제시하세요

접근법 B: CDN + 엣지 캐싱
- 장점과 단점을 분석하세요
- 예상 성능 수치를 제시하세요

접근법 C: 하이브리드 (로컬 캐시 + 분산 캐시 + CDN)
- 장점과 단점을 분석하세요
- 예상 성능 수치를 제시하세요

최종적으로 각 접근법을 비교하고, 이 시스템에 가장 적합한 전략을 선택해주세요.
선택 이유를 비용, 성능, 복잡도 관점에서 설명해주세요.

다음 코드의 버그를 3가지 다른 관점에서 분석해주세요.

코드:
async function processOrders(orders) {
  const results = [];
  for (const order of orders) {
    const result = await processPayment(order);
    results.push(result);
  }
  return results;
}

관점 1 (성능 엔지니어): 성능 문제를 찾아주세요
관점 2 (보안 엔지니어): 보안 취약점을 찾아주세요
관점 3 (SRE 엔지니어): 안정성 문제를 찾아주세요

각 관점의 분석 결과를 종합하여 최종 개선안을 제시해주세요.

다음 프로세스를 따라 버그를 해결해주세요.

문제: 프로덕션에서 간헐적으로 500 에러 발생

각 단계를 "생각 -> 행동 -> 관찰" 형식으로 진행하세요:

생각 1: 어떤 정보를 먼저 확인해야 할까?
행동 1: 에러 로그를 분석한다
관찰 1: (분석 결과를 기록)

생각 2: 로그에서 어떤 패턴이 보이는가?
행동 2: (다음 행동 결정)
관찰 2: (관찰 결과 기록)

이 과정을 근본 원인을 찾을 때까지 반복하세요.
마지막에 수정 코드와 재발 방지 대책을 제시하세요.

다음 작업을 수행해주세요:

1단계: 아래 요구사항에 맞는 인증 미들웨어를 구현하세요
2단계: 구현한 코드를 스스로 리뷰하세요 - 보안 취약점, 엣지 케이스, 성능 문제를 찾으세요
3단계: 리뷰에서 발견한 문제를 수정한 최종 버전을 제시하세요

요구사항:
- JWT 기반 인증
- 토큰 만료 처리
- Role 기반 접근 제어
- Rate limiting 통합

다음 기능을 하위 작업으로 분해하고, 각각을 구현해주세요.

기능: 실시간 채팅 시스템 (WebSocket 기반)

분해:
1. 먼저 전체 기능을 독립적인 모듈로 나누세요
2. 각 모듈의 인터페이스(입출력)를 정의하세요
3. 의존성이 없는 모듈부터 순서대로 구현하세요
4. 모듈 간 통합 방법을 설명하세요
5. 전체 동작 흐름을 시퀀스 다이어그램으로 보여주세요

쿠버네티스의 핵심 개념을 식당 운영에 비유해서 설명해주세요.

각 개념별로:
1. 쿠버네티스 용어
2. 식당 비유
3. 실제 동작 설명
4. 코드 예시 (YAML)

다룰 개념: Pod, Deployment, Service, Ingress, ConfigMap, Secret, PVC

나는 AI 코드 리뷰 자동화 시스템을 만들고 있습니다.

다음 요구사항을 충족하는 최적의 시스템 프롬프트를 만들어주세요:

1. 목적: PR 코드 리뷰 자동화
2. 입력: Git diff 형식의 코드 변경사항
3. 출력: 구조화된 리뷰 코멘트
4. 검토 항목: 보안, 성능, 가독성, 테스트 커버리지
5. 톤: 건설적이고 교육적
6. 언어: 한국어

프롬프트에는 다음이 포함되어야 합니다:
- 역할 정의
- 상세한 검토 기준
- 출력 형식 템플릿
- 예외 처리 규칙
- Few-shot 예시 1개

다음 원칙을 반드시 준수하며 코드를 생성해주세요:

원칙 1 - 보안: OWASP Top 10 취약점을 절대 포함하지 않는다
원칙 2 - 접근성: WCAG 2.1 AA 기준을 충족한다
원칙 3 - 성능: Core Web Vitals 기준을 충족한다
원칙 4 - 유지보수성: SOLID 원칙을 따른다
원칙 5 - 테스트: 각 함수에 대해 최소 2개의 테스트 케이스를 작성한다

각 코드 블록 후에 어떤 원칙들을 충족하는지 체크리스트로 보여주세요.

다음은 프로젝트의 기존 서비스 코드 패턴입니다:

<existing_pattern>
// services/user.service.ts
export class UserService {
  constructor(
    private readonly userRepo: UserRepository,
    private readonly logger: Logger,
  ) {}

  async findById(id: string): Promise<Result<User, ServiceError>> {
    try {
      const user = await this.userRepo.findById(id);
      if (!user) {
        return err(new NotFoundError('User', id));
      }
      return ok(user);
    } catch (error) {
      this.logger.error('Failed to find user', { id, error });
      return err(new InternalError('Failed to find user'));
    }
  }
}
</existing_pattern>

이 패턴과 동일한 스타일로 ProductService를 작성해주세요.
필요한 메서드: findById, findAll (페이지네이션), create, update, delete

나의 디버깅 파트너로서 다음 문제를 함께 해결해주세요.

증상: 사용자 로그인 후 3분 뒤에 자동으로 로그아웃됨

내가 알고 있는 것:
- JWT 토큰 만료 시간은 1시간으로 설정
- 로컬 환경에서는 재현되지 않음
- 프로덕션에서만 발생
- 3월 14일 배포 이후부터 시작

내가 시도한 것:
- 토큰 만료 시간 확인 -> 정상
- 브라우저 쿠키 확인 -> 토큰이 사라짐

질문 형식으로 나를 가이드해주세요:
1. 아직 확인하지 않은 가능한 원인은?
2. 각 원인을 검증하기 위한 구체적 단계는?
3. 가장 가능성이 높은 원인은 무엇이라고 추론하는지?

다음 코드를 아래 체크리스트에 따라 리뷰해주세요.

리뷰 체크리스트:
1. 정확성: 의도한 대로 동작하는가?
2. 보안: SQL Injection, XSS, CSRF 등의 취약점은 없는가?
3. 성능: 불필요한 연산, N+1 쿼리, 메모리 누수는 없는가?
4. 에러 처리: 모든 실패 경로가 적절히 처리되는가?
5. 가독성: 변수명, 함수명이 의미를 잘 전달하는가?
6. 테스트: 테스트하기 쉬운 구조인가?
7. 확장성: 요구사항 변경에 유연한가?

출력 형식:
각 항목별로 Pass/Fail/Warning을 표시하고,
Fail이나 Warning인 경우 구체적인 개선 코드를 제시해주세요.

심각도: Critical > Major > Minor > Suggestion

다음 함수에 대한 포괄적인 테스트를 작성해주세요.

함수:
```typescript
export function calculateDiscount(
  originalPrice: number,
  membershipTier: 'basic' | 'silver' | 'gold' | 'platinum',
  couponCode?: string,
): { finalPrice: number; discountRate: number; appliedDiscounts: string[] } {
  // ... 구현 코드
}

### 기법 25: Refactoring with Specific Goals

리팩토링 목표를 구체적으로 제시합니다.

```text
다음 코드를 리팩토링해주세요.

리팩토링 목표:
1. 함수 분리: 하나의 함수는 하나의 책임만
2. 매직 넘버 제거: 의미 있는 상수로 교체
3. Early return 패턴 적용: 중첩 if문 제거
4. 타입 안전성 강화: 유니온 타입과 타입 가드 활용

리팩토링 과정:
- 변경 전후를 나란히 보여주세요
- 각 변경의 이유를 설명해주세요
- 동작이 변경되지 않았음을 설명해주세요

다음 요구사항에 맞는 시스템 아키텍처를 설계해주세요.

서비스: 실시간 경매 플랫폼
- 동시 사용자: 최대 10만 명
- 실시간 입찰 업데이트 (지연 100ms 이내)
- 결제 처리 (PG사 연동)
- 이미지 업로드 (상품당 최대 10장)

제출물:
1. 고수준 아키텍처 다이어그램 (Mermaid)
2. 각 컴포넌트의 기술 스택 선정 및 이유
3. 데이터 흐름 다이어그램
4. 확장성 전략 (수평 스케일링 포인트)
5. 장애 대응 전략 (SPOF 식별 및 대안)
6. 예상 월 비용 (AWS 기준)

다음 API 엔드포인트 코드를 기반으로 API 문서를 작성해주세요.

형식: OpenAPI 3.0 YAML

포함할 내용:
1. 엔드포인트 설명
2. 요청 파라미터 (path, query, body)
3. 응답 스키마 (성공/실패 모두)
4. 인증 방식
5. Rate limit 정보
6. 사용 예시 (curl)
7. 에러 코드 표

다음 에러를 분석하고 수정해주세요.

에러 메시지:
TypeError: Cannot read properties of undefined (reading 'map')
    at UserList (UserList.tsx:15:23)
    at renderWithHooks (react-dom.development.js:16305:18)

컨텍스트:
- React 18 + TypeScript 프로젝트
- API에서 사용자 목록을 가져와서 렌더링하는 컴포넌트
- 가끔만 발생 (네트워크 느릴 때)

다음을 포함해주세요:
1. 에러 원인 분석 (왜 undefined인지)
2. 수정 코드
3. 같은 패턴의 에러를 방지하기 위한 일반적 가이드라인
4. 타입으로 이 에러를 컴파일 타임에 잡는 방법

다음 API 엔드포인트의 성능을 최적화해주세요.

현재 상태:
- 평균 응답 시간: 2.5초
- P99 응답 시간: 8초
- 초당 요청: 500 RPS
- 목표: 평균 200ms 이내, P99 500ms 이내

분석 순서:
1. 현재 코드에서 성능 병목 지점을 식별하세요
2. 각 병목에 대한 최적화 방안을 제시하세요
3. 예상 개선 효과를 수치로 표시하세요
4. 최적화된 코드를 제시하세요
5. 최적화 전후를 비교하는 벤치마크 코드를 작성하세요

다음 코드에 대해 보안 감사를 수행해주세요.

검사 항목:
1. OWASP Top 10 (2021) 기준 취약점
2. 인증/인가 취약점
3. 데이터 노출 위험
4. 의존성 취약점 가능성
5. 설정 오류

출력 형식:
각 발견사항에 대해:
- 취약점 유형: (예: A01 Broken Access Control)
- 심각도: Critical / High / Medium / Low
- 위치: 파일명과 줄 번호
- 설명: 취약점이 어떻게 악용될 수 있는지
- 수정 코드: 안전한 코드 예시
- 참고: CWE 번호 또는 관련 문서 링크

<context>프로젝트 배경과 기술 스택</context>
<task>구체적인 작업 내용</task>
<constraints>제약 조건</constraints>
<examples>참고 예시</examples>
<output_format>원하는 출력 형식</output_format>

이 문제를 단계별로 분석해주세요.
각 단계의 추론 과정을 보여주세요.

응답을 JSON 형식으로 해주세요.
다른 텍스트 없이 순수 JSON만 반환하세요.

다음은 프로젝트의 전체 소스 코드입니다.
(전체 코드 첨부)
이 코드베이스 전체를 분석하여 아키텍처 개선점을 제안해주세요.

# 나쁜 예
코드 좀 고쳐줘

# 좋은 예
다음 Python 함수에서 N+1 쿼리 문제를 해결해주세요.
SQLAlchemy의 joinedload를 사용하여 최적화하세요.

# 나쁜 예
(10,000줄의 코드를 전부 붙여넣기)
이 코드 전부 리뷰해줘

# 좋은 예
다음은 결제 처리 모듈의 핵심 로직입니다 (관련 부분만 발췌).
결제 금액 계산 부분에서 부동소수점 오류가 의심됩니다.
해당 부분을 집중적으로 검토해주세요.

# 나쁜 예
빠르게 동작하면서도 메모리를 최소한으로 쓰고
코드도 최대한 읽기 쉽게 작성해줘
모든 엣지 케이스를 처리하되 코드는 20줄 이내로

# 좋은 예
우선순위:
1. (필수) 메모리 사용 100MB 이내
2. (중요) 응답 시간 200ms 이내
3. (권장) 코드 가독성 (가능한 범위 내에서)

# 나쁜 예
React 25의 새로운 Server Actions API 사용법을 알려줘
(존재하지 않는 버전/기능에 대해 질문)

# 좋은 예
React의 최신 Server Actions API에 대해 알고 있는 범위에서 설명해줘.
확실하지 않은 정보는 그렇다고 알려줘.

# 나쁜 예 (단순 변수 이름 변경에 장문의 프롬프트)
당신은 20년 경력의 소프트웨어 아키텍트입니다.
클린 코드 원칙에 따라 다음 변수의 이름을 개선해주세요.
변수명: x
컨텍스트: 사용자의 나이를 저장하는 변수입니다.

# 좋은 예
변수명 x를 의미 있는 이름으로 바꿔주세요. (사용자 나이 저장용)

Chain 1: 분석
"다음 코드의 코드 스멜을 나열해주세요. JSON 배열로 출력하세요."

Chain 2: 우선순위
"다음 코드 스멜 목록을 심각도 순으로 정렬해주세요. (입력: Chain 1 출력)"

Chain 3: 수정
"가장 심각한 3개의 코드 스멜을 수정한 코드를 제시해주세요. (입력: Chain 2 출력)"

Chain 4: 검증
"수정된 코드가 원본과 동일하게 동작하는지 검증해주세요. (입력: Chain 3 출력)"

다음 에이전트 루프를 사용하여 프로덕션 인시던트를 해결해주세요:

루프:
1. OBSERVE: 현재 상태 확인 (로그, 메트릭, 알림)
2. THINK: 원인 분석 및 행동 계획 수립
3. ACT: 구체적 조치 실행
4. VERIFY: 조치 결과 확인

인시던트: 데이터베이스 커넥션 풀 고갈

각 루프 반복을 명시적으로 보여주세요.
VERIFY에서 문제가 해결될 때까지 루프를 반복하세요.

다음 도구들을 사용하여 코드 품질 검사를 수행해주세요:

사용 가능한 도구:
1. file_read: 파일 읽기
2. file_write: 파일 쓰기
3. terminal: 터미널 명령 실행
4. git: Git 명령 실행

작업 순서:
1. git diff로 변경된 파일 목록 확인
2. 각 파일 읽기
3. ESLint 실행
4. TypeScript 컴파일 체크
5. 테스트 실행
6. 결과 종합 보고서 생성

이전 대화 요약 (컨텍스트 압축):

프로젝트: Next.js 이커머스
완료: 상품 목록 API, 장바구니 API
현재 작업: 결제 처리 API
기술 결정: Stripe 사용, Webhook으로 결제 상태 관리

위 컨텍스트를 기반으로 결제 처리 API의 다음 단계를 진행해주세요.

## 기능 요청
[기능 이름과 간단한 설명]

## 배경
- 왜 이 기능이 필요한가?
- 어떤 문제를 해결하는가?

## 기술 스택
- 프레임워크:
- 언어:
- 데이터베이스:
- 기존 패턴 참고:

## 요구사항
1. [필수 요구사항]
2. [필수 요구사항]
3. [선택 요구사항]

## 제약 조건
- [성능 요구사항]
- [보안 요구사항]

## 출력
1. 구현 코드
2. 단위 테스트
3. API 문서 (해당 시)

## 버그 설명
[어떤 증상이 발생하는지]

## 재현 단계
1. [단계 1]
2. [단계 2]
3. [단계 3]

## 예상 동작
[어떻게 동작해야 하는지]

## 실제 동작
[현재 어떻게 동작하는지]

## 관련 코드
[코드 붙여넣기]

## 환경
- OS:
- Node.js:
- 브라우저:

## 요청
1. 원인 분석
2. 수정 코드
3. 재발 방지를 위한 테스트

## PR 요약
[이 PR이 무엇을 변경하는지]

## 변경 코드
[diff 또는 코드]

## 리뷰 관점
- [ ] 로직 정확성
- [ ] 보안
- [ ] 성능
- [ ] 에러 처리
- [ ] 테스트 커버리지
- [ ] 코딩 컨벤션

## 특별히 확인해주세요
[특정 부분에 대한 우려사항]

## 시스템 개요
[시스템의 목적과 핵심 기능]

## 비기능 요구사항
- 동시 사용자:
- 응답 시간:
- 가용성:
- 데이터 보존:

## 기존 인프라
[현재 사용 중인 기술과 인프라]

## 요청
1. 아키텍처 다이어그램
2. 기술 스택 선정 및 근거
3. 데이터 모델
4. API 설계
5. 확장 전략
6. 비용 추정

## 도메인
[비즈니스 도메인 설명]

## 엔티티
[주요 엔티티와 관계]

## 요구사항
- 읽기/쓰기 비율:
- 데이터 크기 예상:
- 쿼리 패턴:

## 요청
1. ERD (Mermaid)
2. SQL DDL
3. 인덱스 전략
4. 마이그레이션 스크립트

## API 목적
[API가 제공하는 기능]

## RESTful 설계
- 리소스 정의
- HTTP 메서드 매핑
- URL 구조

## 요청
1. OpenAPI 3.0 스펙
2. 요청/응답 예시
3. 에러 코드 정의
4. 인증/인가 방식
5. Rate limiting 정책
6. 버전 관리 전략

## 프로젝트 정보
- 언어/프레임워크:
- 배포 대상:
- 브랜치 전략:

## 요구사항
- 빌드 단계
- 테스트 단계 (단위, 통합, E2E)
- 보안 스캔
- 배포 전략 (Blue-Green / Canary / Rolling)

## 요청
1. 파이프라인 YAML (GitHub Actions / GitLab CI)
2. 각 단계의 설명
3. 시크릿 관리 방법
4. 롤백 전략

## 현재 상태
- 측정 지표: [응답 시간, 처리량, 에러율]
- 병목 의심 지점: [설명]

## 목표
- 응답 시간: [현재] -> [목표]
- 처리량: [현재] -> [목표]

## 코드
[최적화 대상 코드]

## 요청
1. 병목 분석
2. 최적화 방안 (우선순위순)
3. 최적화된 코드
4. 벤치마크 코드

## 마이그레이션 대상
- FROM: [현재 기술/버전]
- TO: [목표 기술/버전]

## 현재 코드
[마이그레이션 대상 코드]

## 요구사항
- 하위 호환성 유지 여부
- 점진적 마이그레이션 가능 여부
- 다운타임 허용 범위

## 요청
1. 마이그레이션 계획 (단계별)
2. 변경 코드
3. 호환성 확인 테스트
4. 롤백 계획

## 인시던트 정보
- 발생 시간:
- 영향 범위:
- 심각도:

## 현재 증상
[에러 로그, 메트릭 스크린샷, 알림 내용]

## 시스템 구성
[관련 서비스 아키텍처]

## 요청
1. 즉각 대응 (완화 조치)
2. 근본 원인 분석
3. 수정 방안
4. 재발 방지 대책
5. 포스트모템 초안