Claude AI 소개

무엇을 할 수 있나?

• 기획: 아이디어 브레인스토밍, 컨셉 정리, 카피라이팅
• 설계: UI 구조, API 설계, 데이터 모델링
• 개발: 코드 생성, 리팩토링, 버그 수정
• 검토: 코드 리뷰, 기획 피드백, 문서 교정

핵심은 좋은 프롬프트를 작성하는 능력입니다.

효과적인 프롬프트 구조

5가지 요소

┌─────────────────────────────────────────┐
│  1. 역할      → "너는 ~전문가야"          │
│  2. 맥락      → 배경 정보, 현재 상황       │
│  3. 요청      → 구체적으로 원하는 것        │
│  4. 형식      → 출력 형태 지정             │
│  5. 제약조건   → 하지 말아야 할 것          │
└─────────────────────────────────────────┘

프롬프트 구조 — 예시

"너는 모바일 앱 기획 전문가야. (역할)
20대 직장인을 위한 건강 관리 앱을 만들려고 해. (맥락)
핵심 기능 5가지를 제안해줘. (요청)
표 형태로 기능명, 설명, 우선순위를 정리해줘. (형식)
SNS 기능은 제외해줘. (제약조건)"

기획자용 프롬프트 #1: 앱 컨셉 생성

목표: 앱 아이디어를 구체화

역할: 너는 스타트업 기획 전문가야.

맥락: 우리 팀은 워크샵에서 5시간 안에 모바일 앱을 만들어야 해.
팀원은 기획자 1명, 개발자 1명이야.

기획자용 프롬프트 #1 (계속)

요청 · 형식 · 제약조건

요청: 다음 조건에 맞는 앱 컨셉 3가지를 제안해줘.
- 20대 대학생이 매일 사용할 만한 앱
- React Native로 5시간 안에 MVP 구현 가능
- 외부 API 최소 사용

형식: 각 컨셉마다 앱명, 한 줄 소개, 핵심 기능 3개,
      타겟 사용자, 차별점을 정리해줘.

제약조건: 이미 시장에 넘치는 투두 앱, 메모 앱은 제외해줘.

기획자용 프롬프트 #2: UI 설계 + 카피라이팅

목표: 화면 구성과 텍스트 확정

역할: 너는 UX 라이터이자 UI 설계자야.

맥락: "산책메이트"라는 반려동물 산책 매칭 앱을 만들고 있어.
핵심 기능은 매칭, 채팅, 리뷰야.

기획자용 프롬프트 #2 (계속)

요청 · 형식 · 제약조건

요청:
1. 앱의 주요 화면 5개를 텍스트 와이어프레임으로 그려줘.
2. 각 화면의 모든 텍스트(버튼, 안내문구, 타이틀)를 작성해줘.

형식: 화면별로 구분해서, 와이어프레임과 텍스트를 함께 보여줘.

제약조건:
- 한국어로 작성
- 친근하고 따뜻한 톤
- 버튼 텍스트는 4글자 이내

기획자용 프롬프트 #3: 사용자 시나리오 작성

목표: 핵심 사용 흐름 정의

역할: 너는 서비스 기획 전문가야.

맥락: "산책메이트" 앱의 핵심 기능은 다음과 같아:
- 산책 파트너 매칭
- 실시간 채팅
- 산책 후 리뷰

기획자용 프롬프트 #3 (계속)

요청 · 형식 · 제약조건

요청: 신규 사용자가 앱을 처음 열고 첫 산책을 완료하기까지의
시나리오를 단계별로 작성해줘.

형식:
- 각 단계: 화면명 → 사용자 행동 → 시스템 반응
- Mermaid 다이어그램으로도 표현해줘.

제약조건: 10단계 이내로 핵심 흐름만 담아줘.

TIP: 시나리오가 명확하면 개발자가 어떤 API가 필요한지 바로 파악할 수 있습니다.

개발자용 프롬프트 #1: 컴포넌트 생성

목표: React Native 컴포넌트 코드 생성

역할: 너는 React Native 시니어 개발자야.

맥락: Expo (SDK 52)를 사용하는 프로젝트야.
상태관리는 React의 useState만 사용해.

개발자용 프롬프트 #1 (계속)

요청 · 형식 · 제약조건

요청: 다음 와이어프레임을 기반으로
프로필 카드 컴포넌트를 만들어줘.
[와이어프레임 텍스트 붙여넣기]

형식: TypeScript로 작성하고, StyleSheet도 포함해줘.

제약조건:
- 외부 라이브러리 사용 금지 (Expo 내장만 허용)
- Props 타입을 interface로 정의
- 접근성(accessibility) 속성 포함

개발자용 프롬프트 #2: API 엔드포인트 생성

목표: Cloudflare Workers API 코드 생성

역할: 너는 Cloudflare Workers 전문 백엔드 개발자야.

맥락: Cloudflare Workers + KV Store를 사용하는 프로젝트야.
데이터는 KV에 JSON으로 저장해.

개발자용 프롬프트 #2 (계속)

요청 · 형식 · 제약조건

요청: 사용자 프로필 CRUD API를 만들어줘.
- GET /api/users/:id
- POST /api/users
- PUT /api/users/:id
- DELETE /api/users/:id

형식: wrangler 프로젝트 구조에 맞게 작성해줘.

제약조건:
- 에러 핸들링 포함
- CORS 헤더 설정
- 입력값 검증 포함

개발자용 프롬프트 #3: 디버깅

목표: 에러 원인 파악 및 수정

역할: 너는 디버깅 전문가야.

맥락: React Native 앱에서 아래 에러가 발생해.
[에러 메시지 붙여넣기]

요청:
1. 에러 원인을 분석해줘.
2. 수정 방법을 코드와 함께 알려줘.
3. 같은 에러를 예방하는 방법도 알려줘.

개발자용 프롬프트 #3 (계속)

제약조건 및 주의사항

제약조건:
- 기존 코드 구조를 최대한 유지해줘.
- 수정 전후 diff를 보여줘.

제약 조건 명시의 중요성

케이스 5: 동적 스크립트 제약 연계

AI에게 제약 조건을 알려주지 않으면?

제약 조건 명시의 중요성 (계속)

제약 조건은 가드레일입니다. 명시하지 않으면 AI는 모든 방향으로 달립니다.

AI 활용 3대 원칙 #1

생성 코드는 반드시 검증하라

AI가 생성한 코드는 그럴듯하지만 틀릴 수 있습니다.

// AI가 생성한 코드 예시 — 정말 맞을까?
const fetchData = async () => {
  const res = await fetch('/api/data');
  const data = res.json(); // await 빠짐!
  setData(data);
};

AI 활용 3대 원칙 #1 (계속)

검증 체크리스트

• [ ] 문법 오류 없는지 확인 (타입 에러, 빠진 await 등)
• [ ] 비즈니스 로직이 기획과 일치하는지 확인
• [ ] 엣지 케이스 처리가 되어 있는지 확인
• [ ] 보안 취약점 없는지 확인 (XSS, 인젝션 등)

케이스 7 교훈: AI를 믿되, 검증하라 (Trust but Verify).

AI 활용 3대 원칙 #2

환각(Hallucination) 주의

AI는 확신에 차서 없는 API, 없는 함수를 알려줄 수 있습니다.

• 존재하지 않는 라이브러리를 추천할 수 있음
• 더 이상 지원하지 않는 메서드를 사용할 수 있음
• 항상 공식 문서로 교차 검증하세요

AI 활용 3대 원칙 #3

사람의 판단이 최종 결정

AI의 제안은 출발점이지, 결론이 아닙니다.