PHpullh

STATIC LEARNING LIBRARY

Vibe Coding 학습 예제

125개 예제를 개별 HTML 문서로 제공합니다. 검색엔진과 공유 링크에서 각 주제를 바로 열 수 있습니다.

Vibe Coding

프롬프트

맥락을 충분히 제공하라

AI에게 코드를 요청할 때 현재 프로젝트 구조, 사용 중인 라이브러리, 목표, 제약사항을 함께 설명하세요. "Kotlin Spring Boot 프로젝트에서 PostgreSQL과 연동된 사용자 인증 REST API를 작성해줘"가 "인증 API 만들어줘"보다 10배 좋은 결과를 냅니다.

"왜"를 함께 질문하라

단순히 코드 요청보다 "이 접근법의 장단점이 무엇인가", "대안은 무엇인가"를 함께 질문하세요. AI는 최선의 방법 대신 요청한 것을 그대로 구현하는 경향이 있습니다. 요구사항을 주면서 "더 나은 방법이 있으면 제안해줘"를 추가하는 것만으로 품질이 크게 향상됩니다.

Vibe Coding

워크플로우

작게 쪼개서 요청하라

큰 기능을 한 번에 요청하기보다 작은 단위로 나눠 점진적으로 구현하세요. "전체 주문 시스템"보다 "주문 생성 API 엔드포인트 하나"를 먼저 구현하고 검토 후 확장하는 방식이 실수가 적습니다. AI 출력 결과를 항상 검증하고 다음 단계로 나아가세요.

Commit 메시지를 AI로 자동화

변경된 diff를 AI에게 제공해 명확하고 일관된 커밋 메시지를 생성하세요. "이 diff를 Conventional Commits 형식(feat/fix/refactor/docs)으로 한 줄 커밋 메시지 + 상세 설명으로 작성해줘"라고 요청하면 일관된 히스토리를 유지할 수 있습니다.

PR 설명문 자동 생성

변경 내용(diff)과 티켓 설명을 AI에게 주고 PR 설명을 생성하세요. "변경 동기, 구현 방법, 테스트 방법, 주의사항 섹션을 포함한 GitHub PR 설명을 작성해줘"처럼 형식을 명시하면 팀원이 리뷰하기 쉬운 설명이 만들어집니다.

스프린트 태스크 분해에 AI 활용

"이 User Story를 개발자 태스크로 분해해줘: 각 태스크는 1~2일 안에 완료 가능해야 하고 AC(인수 조건)를 포함해야 해"라고 요청하면 체계적인 작업 계획이 만들어집니다. 백로그 정제 시간을 크게 줄일 수 있습니다.

Vibe Coding

코드생성

예시 코드를 먼저 제공하라

기존 코드베이스의 스타일과 패턴을 AI에게 보여주면 일관된 코드가 생성됩니다. "이 파일의 스타일을 따라서 새로운 기능을 추가해줘"처럼 예시를 포함하면 팀 컨벤션에 맞는 코드를 받을 수 있습니다. Few-shot 프롬프팅 원리를 코드 생성에 적용한 것입니다.

테스트 케이스 먼저 생성하라

구현 코드보다 테스트 케이스를 AI로 먼저 생성하면 엣지 케이스를 놓치지 않습니다. TDD 방식으로 "이 함수의 예상 동작에 대한 JUnit 5 테스트를 먼저 작성해줘"라고 요청한 뒤 구현을 요청하면 품질이 향상됩니다.

언어별 관용구를 명시하라

"Kotlin답게(Idiomatic Kotlin)", "Pythonic하게" 같은 언어 관용구를 명시하면 해당 언어의 베스트 프랙티스를 따른 코드를 받습니다. Java 스타일의 Kotlin 코드, Callback 스타일의 Kotlin 비동기 코드 등 안티패턴을 방지할 수 있습니다.

환경 설정 파일 자동 생성

프로젝트 요구사항을 설명하면 Dockerfile, docker-compose.yml, GitHub Actions CI/CD, build.gradle.kts, application.yml 등 설정 파일을 AI가 생성합니다. 설정 파일은 반복적이고 AI가 잘하는 영역입니다. 생성 후 보안 설정은 반드시 검토하세요.

정규표현식 생성 및 검증

복잡한 정규식을 자연어로 설명하면 AI가 작성하고 테스트 케이스도 함께 제공합니다. "한국 휴대폰 번호 형식(010-xxxx-xxxx, 010xxxxxxxx)을 검증하는 정규식과 통과/실패 케이스를 작성해줘"처럼 구체적으로 요청하세요.

Vibe Coding

디버깅

에러 메시지 그대로 붙여넣기

디버깅 시 에러 메시지와 스택 트레이스를 가공 없이 그대로 AI에게 붙여넣으세요. 자신만의 해석을 추가하면 오히려 AI를 잘못된 방향으로 이끌 수 있습니다. 에러 전후의 코드 컨텍스트를 함께 제공하면 원인을 더 정확히 찾습니다.

AI로 로그 패턴 분석

서버 로그, 에러 로그를 AI에게 제공하고 이상 패턴이나 에러 원인을 분석 요청하세요. 수백 줄의 로그에서 반복되는 패턴, 타임스탬프 기반 상관관계, 숨겨진 에러를 빠르게 찾을 수 있습니다. 로그에 민감정보가 없는지 먼저 확인하세요.

Vibe Coding

리팩터링

리팩터링 요청 시 목표를 명시하라

"리팩터링해줘"는 너무 모호합니다. "이 코드를 Kotlin 코루틴을 사용해 비동기로 리팩터링해줘", "SOLID 원칙 중 단일 책임 원칙을 지키도록 분리해줘"처럼 구체적인 목표를 명시하면 원하는 방향의 리팩터링 결과를 받을 수 있습니다.

레거시 코드 이해에 AI 활용

이해가 안 되는 레거시 코드를 AI에게 붙여넣고 "이 코드가 무엇을 하는지 단계별로 설명해줘, 잠재적 버그도 찾아줘"를 요청하세요. 오래된 복잡한 코드를 30분 걸려 분석하던 것을 5분으로 줄일 수 있습니다.

Vibe Coding

문서화

문서 초안은 AI로 빠르게 작성

README, API 문서, 인라인 주석의 초안을 AI로 빠르게 작성하고 사람이 다듬는 워크플로우를 사용하세요. 코드를 AI에게 주고 "KDoc 형식으로 모든 public 함수에 문서 주석을 추가해줘"라고 하면 문서화 시간을 80% 단축할 수 있습니다.

API 문서 OpenAPI 스펙 자동화

컨트롤러 코드를 AI에게 주고 "OpenAPI 3.0 YAML 스펙으로 변환해줘, 각 엔드포인트의 요청/응답 예시도 포함해줘"를 요청하세요. Swagger 문서 작성에 걸리는 시간을 대폭 줄일 수 있습니다.

Vibe Coding

설계

아키텍처 검토에 AI를 활용하라

설계한 시스템 구조를 AI에게 설명하고 "이 설계의 잠재적 문제점, SPOF(단일 장애점), 스케일링 병목은 무엇인가"를 질문하세요. AI는 경험 많은 리뷰어처럼 놓치기 쉬운 관점을 제시합니다. 아키텍처 결정 문서(ADR) 작성에도 활용하세요.

여러 구현 방법 비교 요청

"이 기능을 구현하는 3가지 다른 방법과 각각의 시간복잡도, 메모리 사용, 가독성을 비교해줘"라고 요청하세요. AI는 트레이드오프를 설명하고 상황에 맞는 선택을 돕습니다. 하나의 방법만 요청하면 최선이 아닐 수 있습니다.

데이터베이스 스키마 설계 검토

ERD나 스키마 설계를 AI에게 보여주고 "정규화 이슈, N+1 쿼리 가능성, 인덱스 전략, 확장성 문제를 찾아줘"를 요청하세요. 운영 단계에서 발견하면 수정 비용이 큰 설계 결함을 개발 초기에 발견할 수 있습니다.

Vibe Coding

테스트

엣지 케이스 자동 발견

함수 시그니처와 비즈니스 로직을 AI에게 제공하고 "생각하지 못한 엣지 케이스와 경계값 조건을 모두 나열해줘"를 요청하세요. null 입력, 빈 컬렉션, 최대/최소값, 동시성, 타임아웃 등 놓치기 쉬운 케이스를 체계적으로 발견합니다.

Vibe Coding

도구활용

SQL 쿼리 최적화에 AI 활용

느린 SQL 쿼리를 AI에게 보여주고 EXPLAIN 결과와 함께 최적화 제안을 받으세요. "이 쿼리가 느린 이유와 인덱스 전략, 쿼리 개선 방법을 알려줘"라고 요청하면 DBA 수준의 최적화 조언을 받을 수 있습니다.

Vibe Coding

마인드셋

AI를 아주 빠른 주니어로 대하라

AI는 빠르게 코드를 작성하지만 도메인 지식과 비즈니스 맥락이 없습니다. 시니어 개발자처럼 명확한 스펙을 주고, 결과를 검토하고, 피드백을 주는 역할을 해야 합니다. 아키텍처와 핵심 로직은 개발자가 책임지고 반복 작업은 AI에게 위임하세요.

생성된 코드를 항상 이해하라

AI가 생성한 코드를 이해 없이 그대로 사용하면 나중에 유지보수가 불가능해집니다. 이해가 안 되는 부분은 "이 부분을 줄 단위로 설명해줘"라고 요청하세요. AI 코드를 책임지는 것은 결국 개발자입니다. 복사-붙여넣기 전에 반드시 읽고 이해하세요.