바이브 코딩 가이드 Vibecoding Guide

Learn by building

입문에서 심화, 에이전트 실습까지

바이브 코딩을 처음 접하는 학습자가 개발 환경을 잡고, Claude Code·Codex·Antigravity의 작업 방식을 비교한 뒤, 관광 검색·챗봇·글쓰기, 기사 작성, 논문 검색 세 가지 응용 실습까지 이어 가는 단일 학습 허브입니다.

학습 로드맵

다섯 과정은 순서대로 보도록 설계했습니다. 기본 도구 사용법을 익힌 뒤 자동화 개념을 확장하고, 마지막에 관광 실습과 기사 작성·논문 검색 세 가지 응용 파이프라인으로 연결합니다.

바이브 코딩 입문

코딩 경험이 적은 사용자가 AI 코딩 도구를 손에 익히는 기본 과정입니다.

  • VS Code·터미널·Node.js·파이썬 설치
  • Claude Code, OpenAI Codex, Antigravity CLI 실습
  • 도구 비교와 자주 나는 오류 해결

바이브 코딩 심화

도구를 반복 업무에 맞게 길들이는 설정, 명령어, 확장 개념을 다룹니다.

  • 슬래시 명령어와 도구별 내장 기능
  • 메모리 파일, 커스텀 명령어, 스킬
  • 서브에이전트, 훅, MCP 연결

관광지 검색·챗봇·글쓰기 실습

무료 공공 API 키 두 개로 웹페이지, 챗봇, 글쓰기 에이전트를 차례로 만드는 응용 실습입니다.

  • 공공데이터포털 관광정보 API로 검색 웹페이지
  • Gemini API를 붙인 관광 안내 챗봇
  • 검색·요약·집필 3개 서브에이전트로 글 작성

기사 작성 에이전트 실습

자료를 폴더에 넣으면 핵심 정리·기사 작성·팩트체크까지 이어지는 응용 실습입니다.

  • 자료 읽고 핵심 사실 정리
  • 스킬로 내 문체·뉴스가치 반영해 작성
  • 서브에이전트로 문장별 독립 팩트체크

논문 검색 에이전트 실습

검색어 한 마디로 관련 논문을 모아 관련도를 선별하고 보기 좋은 HTML 한 장으로 정리하는 응용 실습입니다.

  • paper-search-mcp를 pip로 설치해 MCP 연결
  • researcher 서브에이전트로 논문 수집·선별
  • make-report 스킬로 HTML 리포트 생성

이렇게 진행하면 됩니다

처음에는 입문 가이드에서 도구별 사용 감각을 잡고, 심화 가이드에서 명령어와 프로젝트 지침을 이해합니다. 이후 세 가지 응용 실습(관광 검색·챗봇·글쓰기, 기사 작성, 논문 검색)에서 입력 자료, 중간 산출물, 결과물이 이어지는 엔드투엔드 흐름을 직접 확인합니다.

수업이나 워크숍에서는 1일차에 입문, 2일차에 심화, 3일차에 응용 실습(관광 → 기사 작성 → 논문 검색)으로 나누면 무리가 없습니다. 관광 실습은 API 키 발급부터 시작하므로 응용 단계의 첫 관문으로 적당합니다.

기본 학습 AI 코딩 도구가 어떤 순서로 파일을 읽고 수정하는지 익힙니다.
심화 학습 메모리 파일, 스킬, 서브에이전트, MCP로 반복 작업을 구조화합니다.
응용 실습 관광 API로 웹페이지·챗봇을 만들고, 기사 작성과 논문 검색 파이프라인까지 직접 만듭니다.

자료 바로가기

GitHub Pages 배포 후에도 같은 상대경로로 접근됩니다. 저장소 루트에 이 `index.html`을 두면 첫 화면으로 열립니다.

vibecoding_basic.html 입문 강의용 HTML 문서
vibecoding_advanced.html 심화 강의용 HTML 문서
agent_tour.html 관광지 검색·챗봇·글쓰기 응용실습 문서
agent_newsmaking.html 기사 작성 에이전트 응용실습 문서
agent_paperfinder.html 논문 검색·정리 에이전트 응용실습 문서

배포 후 접속 주소

GitHub Pages에서 저장소 루트 또는 배포 브랜치의 루트를 공개하면 아래 주소로 접속하는 구성이 됩니다.

https://jonghhhh.github.io/vibecoding_guide/

내부 자료는 각각 https://jonghhhh.github.io/vibecoding_guide/vibecoding_basic.html, https://jonghhhh.github.io/vibecoding_guide/vibecoding_advanced.html, https://jonghhhh.github.io/vibecoding_guide/agent_tour.html, https://jonghhhh.github.io/vibecoding_guide/agent_newsmaking.html, https://jonghhhh.github.io/vibecoding_guide/agent_paperfinder.html 경로로 연결됩니다.