개발자를 위한 AI 모델 별 프롬프트 가이드

공통

1. 역할(Role)을 먼저 지정한다

당신은 대규모 트래픽 환경의 백엔드 시니어 엔지니어다.
NestJS + TypeScript + PostgreSQL 기반으로
유지보수성과 테스트 용이성을 우선시한다.

 

 

2. 목표를 단일 문장으로 명확하게 표현한다

JWT 기반 인증 시스템을 구현하되,
Refresh Token Rotation까지 포함해라.

 

 

3. 기술 스택을 강제한다

조건:
- Runtime: Node.js 22
- Framework: NestJS
- ORM: Prisma
- DB: PostgreSQL
- Package Manager: Yarn Berry
- node_modules 사용 금지

 

 

4. 코드 스타일을 강제한다

규칙:
- 함수는 최대 30줄
- early return 사용
- class보다 함수형 선호
- any 금지
- interface보다 type 우선
- snake_case 파일명 사용

 

 

5. 출력 형식(Output Format)을 강제한다

다음 형식으로 출력:
1. 디렉토리 구조
2. 파일별 코드
3. 동작 흐름
4. 장점
5. 단점

 

 

6. 하지 말아야할 것도 써야한다

금지:
- 추상적인 설명
- 생략된 코드
- pseudo code
- TODO 주석
- any 타입

 

 

7. 예시 입력과 출력을 제공한다

예시 응답 스타일:

# auth_service.ts
```ts
export class AuthService {}
```


---

# 8. 단계별 사고 강제

복잡한 작업은 무조건 단계 분리.

### 예시
```text
순서대로 진행:
1. 요구사항 분석
2. 아키텍처 설계
3. 디렉토리 구조 생성
4. 타입 정의
5. 구현
6. 테스트 코드 작성
```

 

 

 

 

 

실무에서 많이 사용하는 패턴

1. 아키텍트 모드

당신은 시니어 소프트웨어 아키텍트다.

목표:
대규모 트래픽 환경에서 동작 가능한
실시간 채팅 시스템 설계.

조건:
- NestJS
- Redis Pub/Sub
- WebSocket Gateway
- Horizontal Scaling 고려
- 장애 복구 고려

출력:
1. 전체 구조
2. 패킷 흐름
3. 서버 간 통신 구조
4. Redis 사용 이유
5. 장애 상황 대응
6. 프로젝트 구조

 

 

2. 리팩토링 모드

다음 코드를 리팩토링해라.

목표:
- 가독성 향상
- 테스트 용이성
- 책임 분리
- 타입 안정성 강화

절대 하지 말 것:
- 동작 변경
- 과도한 추상화

 

 

3. 디버깅 모드

다음 문제를 분석해라.

증상:
- SQLite transaction deadlock 발생

환경:
- React Native
- expo-sqlite
- Jest 테스트 환경

분석 순서:
1. 원인 후보
2. 재현 가능성
3. 로그 기반 추론
4. 해결책
5. 예방 방법

 

 

 

 

 

권장 프롬프트 패턴 (단계 분리)

1. 요구사항 분석만 해라
2. 승인 후 아키텍처 설계
3. 승인 후 구현
4. 마지막에 테스트 작성

 

 

 

 

 

클로드 코드

1. 잘 먹히는 것

- 하지 말 것
- 출력 형식
- 역할 부여
- 대규모 구조 설명

 

 

2. 아키텍트 모드 예시 (긴 구조 설명 / 계층 분리 / 아키텍쳐 Reasoning / "절대 하지마" 준수)

당신은 대규모 분산 시스템을 설계하는 시니어 소프트웨어 아키텍트다.

목표:
100만 동시 접속을 처리 가능한 실시간 채팅 시스템 설계.

환경:
- Node.js 22
- NestJS
- Redis Pub/Sub
- PostgreSQL
- WebSocket Gateway
- Kubernetes

중요 요구사항:
- 수평 확장 가능해야 함
- 세션 스티키 최소화
- 장애 복구 고려
- Redis 장애 시 대응 전략 포함
- 메시지 유실 방지 전략 포함
- 채팅방 shard 전략 포함

출력 형식:
1. 전체 시스템 아키텍처
2. 패킷 흐름
3. 서버 간 메시지 흐름
4. Redis 역할
5. DB 저장 전략
6. 장애 상황 시나리오
7. 프로젝트 구조
8. 트래픽 병목 예상 지점
9. 확장 전략
10. 장단점

절대 하지 말 것:
- 추상적인 설명
- pseudo code
- TODO

 

 

3. 리팩터링 모드 예시 (코드 스멜 분석 / SRP 분석 / 책임 분리 reasoning)

다음 코드를 리팩토링해라.

목표:
- 책임 분리
- 유지보수성 향상
- 테스트 용이성 향상
- 타입 안정성 강화

분석 순서:
1. 현재 코드의 문제점
2. 코드 스멜 분석
3. 책임 분리 전략
4. 구조 개선 방향
5. 최종 코드

규칙:
- any 금지
- 함수 길이 최대 30줄
- early return 사용
- 중복 제거
- 계층 분리 유지

절대 하지 말 것:
- 과도한 추상화
- 동작 변경
- 불필요한 디자인 패턴 추가

 

 

4. 디버깅 모드 예시 (왜 그렇게 의심하는지 / 어떤 흐름으로 좁혀 가는지)

다음 장애를 분석해라.

증상:
- WebSocket 연결이 간헐적으로 끊김
- CPU usage 급증
- Redis reconnect 반복 발생

환경:
- NestJS
- Redis Cluster
- Kubernetes

분석 순서:
1. 가능한 원인 후보
2. 우선순위 높은 원인
3. 로그 기반 추론
4. 재현 가능성
5. 병목 가능성
6. 해결 방법
7. 예방 방법

추론 과정을 단계별로 설명해라.

 

 

 

 

 

제미나이

1. 잘 먹히는 것

- 예시 입력/출력
- 짧고 명확한 지시
- 반복 패턴

 

 

2. 아키텍트 모드 예시 (문서화 / 비교 설명 / 요약 / 표 정리에 강함)

실시간 채팅 시스템 설계를 도와줘.

기술 스택:
- NestJS
- Redis Pub/Sub
- PostgreSQL
- Kubernetes

다음 항목 위주로 설명:
- 메시지 흐름
- Redis 사용 이유
- WebSocket 확장 방식
- DB 저장 전략
- 서버 증설 시 변화

표와 다이어그램 느낌으로 정리해줘.
가능하면 단계별 흐름으로 설명해줘.

각 기술 선택 이유를 비교 형태로 설명해줘.

 

 

3. 리팩터링 모드 예시 (변경점 비교 / diff 스타일 설명 / 읽기 쉬운 요약)

다음 코드의 가독성과 유지보수성을 개선해줘.

중점:
- 중복 제거
- 함수 역할 명확화
- 변수명 개선
- 흐름 단순화

변경 전 / 변경 후 비교 형태로 설명해줘.

각 변경 이유를 짧게 정리해줘.

 

 

4. 디버깅 모드 예시 (체크 리스트 / 문서형 정리 / 운영 가이드 느낌)

다음 장애 상황을 분석해줘.

증상:
- Redis reconnect 반복
- websocket disconnect 발생

확인해야 할 항목을 체크리스트 형태로 정리해줘.

가능한 원인을:
- 네트워크
- Redis
- Kubernetes
- 애플리케이션 레벨

로 분류해서 설명해줘.

 

 

 

 

 

코덱스

1. 잘 먹히는 것

- 구체적인 함수 시그니처
- 테스트 기반 요구
- 입력/출력 명시

 

 

2. 아키텍트 모드 예시 (구현 중심 / 코드 연결 / 실제 파일 생성 강점)

실시간 채팅 서버 아키텍처를 설계해라.

환경:
- Node.js 22
- NestJS
- Redis
- PostgreSQL

다음을 포함해라:
- 실제 디렉토리 구조
- gateway 코드 예시
- Redis adapter 예시
- Docker 구성
- Kubernetes deployment 예시
- websocket 인증 흐름
- 메시지 persistence 구조

최종 결과는 production-ready 수준이어야 한다.

생략 없는 코드 작성.

 

 

3. 리팩터링 모드 예시 (실제 코드 변환 / 테스트 포함 생성 / 구현 연결 강점)

다음 코드를 production-ready 수준으로 리팩토링해라.

요구사항:
- Jest 테스트 유지
- 타입 안정성 강화
- 의존성 분리
- 성능 저하 금지

출력:
1. 리팩토링된 전체 코드
2. 테스트 코드
3. 변경 포인트
4. 성능 영향 분석

코드는 생략 없이 작성.

 

 

4. 디버깅 모드 예시 (실전 구현 연결 강점)

다음 문제를 해결해라.

문제:
Redis reconnect 반복으로 websocket disconnect 발생.

환경:
- NestJS
- ioredis
- Kubernetes

다음을 포함해라:
- 원인 분석
- 실제 로그 예시
- 재현 코드
- 수정 코드
- retry 전략 개선 코드
- health check 예시
- timeout 설정 예시

production-ready 수준으로 작성.