튜토리얼 소개
이 튜토리얼에서는 Prometheus의 강력한 AI 에이전트 기능을 활용하여, 설계부터 실행까지 단 몇 줄의 대화만으로 게시판 서비스를 구축하는 과정을 학습합니다. 개발자는 복잡한 문법 고민 없이 구현하고자 하는 ‘의도’만 전달하면 됩니다.0. 시작하기 전 : 환경 설정 (Setup)
바이브 코딩을 시작하기 전, Java 기반의 Spring Boot 프로젝트가 로컬 환경에서 원활하게 작동할 수 있도록 기본적인 셋팅이 필요합니다.1. Java 개발 환경 설정
컴퓨터에 다음 도구들이 설치되어 있는지 확인하세요.- JDK (Java Development Kit) : 버전 17 이상 설치를 권장합니다.
- Build Tool : Maven 또는 Gradle이 설치되어 있어야 합니다. (Prometheus는 두 환경 모두 지원합니다.)
2. Spring Initializr 설정 (start.spring.io)
새로운 프로젝트를 생성할 때 start.spring.io에서 다음과 같은 설정으로 프로젝트를 내려받아 IDE에서 열어주세요.| 항목 | 설정값 |
|---|---|
| Project | Maven 또는 Gradle |
| Language | Java |
| Spring Boot | 3.x.x (최신 안정 버전) |
| Java | 17 또는 21 |
| Dependencies | Spring Web, Spring Data JPA, H2 Database, Lombok, Thymeleaf 등등 |
Tip: 환경 설정이 어렵다면 Prometheus에게 “Java 개발 환경을 확인하고 부족한 설정을 도와줘”라고 말해보세요. run_terminal_command 도구를 통해 현재 시스템 상태를 점검해 줍니다.
1. 게시판 서버 만들기 (Backend)
가장 먼저 데이터 저장과 비즈니스 로직을 담당할 서버 환경을 구축합니다.실행 방법
채팅창에 다음과 같이 입력하여 AI에게 서버 개발을 지시하세요.Prompt : “Spring Boot와 JPA를 사용해서 기본적인 게시판 서버를 만들어줘. 제목, 내용, 작성자 필드가 있는 Board 엔티티가 필요해. H2 데이터베이스를 사용하고, 기본적인 CRUD를 수행하는 Service와 Controller까지 한 번에 생성해줘.”
작동 원리
- Tools 활용 : AI는
create_new_file도구를 사용하여 프로젝트 구조에 맞는 Java 파일들을 생성합니다[cite: 4, 5, 7]. - Logic Create : 사용자의 요구사항을 분석하여 게시글 저장, 조회, 수정, 삭제에 필요한 비즈니스 로직을 자동으로 설계합니다.
2. 게시판 화면 만들기 (Frontend)
서버와 연동하여 사용자가 실제로 게시글을 확인하고 작성할 수 있는 화면을 구성합니다.실행 방법
서버 생성이 완료되면 이어서 레이아웃 변경 및 화면 생성을 요청합니다.Prompt : “방금 만든 서버와 연동되는 타임리프(Thymeleaf) 기반의 HTML 화면을 만들어줘. 목록 페이지는 깔끔한 테이블 형식이면 좋겠고, 글쓰기 버튼을 누르면 작성 폼이 나오게 해줘. 디자인은 Bootstrap을 써서 현대적인 느낌으로 부탁해.”
작동 원리
- Layout Change : AI가
edit_existing_file을 통해 HTML 파일의 구조를 잡고 Bootstrap 클래스를 입혀 세련된 레이아웃을 완성합니다. - 통합 : 생성된 서버 API와 프론트엔드 폼(Form)을 자동으로 연결하여 데이터가 정상적으로 오갈 수 있게 합니다.
3. 실행하기 (Execution)
작성된 코드를 빌드하고 실제로 서비스가 돌아가는지 확인하는 단계입니다.실행 방법
터미널 명령어를 직접 입력하는 대신 AI에게 실행을 요청하세요.Prompt : “프로젝트를 빌드하고 서버를 실행해줘. 실행이 완료되면 브라우저에서 접속할 수 있는 로컬 주소(URL)를 알려주고, 테스트용 게시글을 하나 등록하는 SQL문도 실행해줘.”
작동 원리
- System Control : AI가
run_terminal_command도구를 실행하여 빌드 및 실행 명령을 대신 수행합니다[cite: 13, 17, 18]. - SQL 생성 : AI가 데이터베이스 구조에 맞는 SQL 쿼리를 생성하여 테스트 데이터를 DB에 즉시 삽입합니다.
⚠️ 중요: 오류 수정 및 상호작용 (Iterative Debugging)
LLM이 생성하는 코드는 항상 완벽하지 않을 수 있으며, 환경 차이나 버전 호환성 문제로 인해 한 번에 실행되지 않을 수 있습니다. 하지만 이것은 실패가 아니라 바이브 코딩의 자연스러운 과정입니다.- 오류 메시지 전달 : 빌드 에러나 런타임 오류가 발생하면, 터미널에 나타난 오류 내용을 그대로 복사하여 AI에게 전달하세요.
- 상호작용을 통한 수정 : “이 에러가 왜 발생했는지 분석하고 고쳐줘”라고 요청하면, AI는
read_file로 코드를 다시 검토하고edit_existing_file로 수정안을 제안합니다. - 지속적인 피드백 : “이 부분은 내가 원하는 동작이 아니야” 혹은 “다른 방식으로 코드를 짜줘”와 같이 피드백을 주고받으며 코드를 완성해 나가는 것이 바이브 코딩의 핵심입니다.
💡 바이브 코딩 핵심 팁
- 끊김 없는 대화 : “로그인 기능도 추가해줘”, “인기글 로직을 업데이트해줘”와 같이 튜토리얼 이후의 작업도 대화하듯 이어나갈 수 있습니다.
- Rules 참조 : 프로젝트의 특정 코딩 표준이 있다면 AI가 Rules를 참고하여 여러분의 팀 스타일에 맞는 코드를 작성합니다.
- 안전한 실행 : 모든 도구 실행 전 Ask First 모드를 활용하여 AI가 어떤 파일을 고치고 어떤 명령을 내리는지 검토하세요.