본문으로 건너뛰기

Own-it : 기획자와 개발자가 100프로 바이브코딩으로 서비스 만들기 - 1탄

황인준

2025.12.16

Own-it : 기획자와 개발자가 100프로 바이브코딩으로 서비스 만들기 - 1탄 본문 이미지

소개

안녕하세요! 지난 11월부터, 2025년 제로백 AI 빌더톤에 참여하며 기획자 윤누리와 개발자 황인준이 5주간 바이브 코딩으로 서비스를 런칭하기까지의 과정입니다!

우리는 누구인가

황인준 — 10년차 프론트엔드 개발자, 처음으로 백엔드를 맡다

10년 동안 프론트엔드를 해왔습니다. NextJS, React, Vue, 뭐든 익숙했습니다. 그런데 백엔드를 사이드 프로젝트 수준이 아닌 서비스 레벨에서 메인으로 담당해본 적은 한 번도 없었습니다.

이번 프로젝트에서 처음으로 백엔드 및 인프라 구성을 맡았습니다.

윤누리 — 바이브 코딩의 선구자, 기발자

본업은 기획자입니다. AI가 본격화되기 전부터, '바이브 코딩'이라는 말이 생기기도 전부터 AI로 코드를 짜왔습니다. ChatGPT 초기 버전부터 프론트, 백, 파이썬 자동화를 만들었습니다.

문제는 AI로 해결이 안 될 때였습니다. 에러가 나면 AI한테 물어보고, AI가 준 답이 또 에러를 내고, 그 에러를 또 물어보고... 이 루프에서 빠져나오지 못할 때가 종종 있었습니다.

저희는 이런 상황에서 2025년 zero100 빌더톤에 참여하게 되었습니다.


프로젝트 시작: 노션에서의 기획과 R&R

빌더톤에 참여하면서 어떤 아이디어로 도전할지 고민했습니다. 결국 '당장이라도 돈을 벌 수 있는 아이디어'라는 관점에서 AI 포트폴리오 서비스가 최종 아이디어로 선정됐습니다. (상 탄 아이디어를 반대한 사람이 저입니다..)

프로젝트의 시작

불꽃놀이가 그려진 한국 앱의 스크린샷

프로젝트는 노션에서 시작했습니다. 아이디어 정리, 기능 목록, 일정 계획. 모든 게 노션 페이지 안에 있었습니다.

R&R은 자연스럽게 나뉘었습니다:

이 과정에서 R&R을 직접 정했고 단순히 개발/기획, front와 back으로 나누지 않은건

누리님이 바이브코딩으로 충분히 한 feature를 구현하기 충분하고 이 과정 자체가 더 서로 즐겁게 일할 수 있는 방식이라고 판단했기 때문에 이렇게 진행했습니다. 이것이 프로젝트를 모노 레포로 구조로 선택하게 된 계기 였습니다.

역할 분담 상세

구분

윤누리

황인준

포지션

Product Owner & Vibe Coder

Tech Lead & Developer

핵심 역할

서비스 컨셉 기획 및 초기 아이디어 제공
바이브 코더 관점의 제품 요구사항 정의
실사용자로서 피드백 및 개선사항 도출

프로젝트 기술 설계 및 아키텍처 책임
개발 방향 설정 및 기술 의사결정
인프라 구축 및 배포 관리

개발 영역

포트폴리오 생성 시스템 (Full-stack)
• GitHub 데이터 분석 및 시각화
• Vibe 코딩 메트릭 통합 및 표시
• 포트폴리오 템플릿 및 커스터마이징
• 포트폴리오 공유 및 프라이버시 설정

프로젝트 분석 시스템 (Full-stack)
• 분석/평가 페이지 구현
• 프로젝트 동기화, 일괄 분석, 재분석 기능

Daily Review 시스템 (Full-stack)
• Daily Review 메인/상세 페이지
• /dailyreview-sync 커스텀 커맨드 개발
• Git 커밋 분석 로직, Claude AI 통합

인증 시스템
• GitHub OAuth 통합
• 사용자 인증/인가 관리

결제 시스템
• 구독/결제 모듈 구현
• 플랜별 기능 제어

백그라운드 처리
• GitHub 프로젝트 비동기 데이터 수집
• Worker 시스템 구축 (BullMQ)
• 대용량 데이터 처리 최적화

인프라 & DevOps
• 모노레포 구조 설정 및 관리
• CI/CD 파이프라인
• 데이터베이스 설계 및 최적화
• 배포 환경 구축 (Railway + Vercel)

개발 방식

Vibe 코딩을 활용한 빠른 프로토타이핑
실제 사용 경험을 바탕으로 한 기능 개발

기획 완료 후 체계적인 개발
아키텍처 설계 우선 접근

역할 분담의 효과성

✅ 명확한 분업:

- 윤누리: 핵심 기능 Full-stack 개발 (프로젝트 분석, Daily Review)
- 황인준: 인프라, 인증, 결제 등 기반 시스템
- 충돌 최소화: 각자의 도메인에서 독립적인 작업 가능

✅ 상호 보완:

- 윤누리: 사용자 관점의 기능 개발, UI/UX 개선
- 황인준: 시스템 아키텍처, 안정성, 성능 최적화
- 결과: 기술적으로 탄탄하면서도 사용자 친화적인 제품

한국어 텍스트가 있는 검은 화면

첫번쨰 고민 - 문서화

그런데 고민이 하나 있었습니다. 문서화를 어디에 할 것인가?

저는 노션에 모든 문서가 기록되길 바랐습니다. 하지만 누리님은 "왜 굳이 노션에 한 번 더 써야 되는지 모르겠다"고 했습니다.

제 주장은 이랬습니다. 클로드 코드에 기획 문서를 추가하는 것은 당연하다. 하지만 클로드 코드에 작성되어 있는 문서가 언제 추가되고 변경되는지 확인하기 어렵고, 그 맥락을 팀 차원에서 공유할 수 있는 방법은 노션이라고 생각했습니다.

결론부터 말하면, 제가 졌습니다.
결국 선택한 방식은 CLAUDE.md 시스템이었습니다. 프로젝트 루트와 각 앱 폴더에 claude.md 파일을 두고, 개발 맥락을 코드와 함께 버전 관리했습니다.

이 결정이 나중에 큰 차이를 만들었습니다. 윤누리가 Claude Code를 쓸 때, 프로젝트 맥락을 AI가 바로 이해할 수 있었습니다. "이 프로젝트는 이런 구조고, 이런 패턴을 쓰고 있어"라고 매번 설명할 필요가 없었습니다.

하지만 관리를 잘못한 탓에 5주차에 문서 폭탄으로 돌아왔습니다.

Azure 개발자 콘솔의 스크린샷

📂 Root Directory

own-it/
├── apps/                    # Application workspaces
├── packages/                # Shared packages
├── docs/                    # Documentation (restructured)
├── docker/                  # Docker configurations
├── scripts/                 # Utility scripts
├── testsprite_tests/        # E2E test suites
├── env-package/             # Environment file packaging
├── docs-backup-20251215/    # Documentation backup
├── worktrees/               # Git worktrees
├── .github/                 # GitHub Actions workflows
├── docker-compose.yml       # Local development services
├── turbo.json               # Turborepo configuration
├── pnpm-workspace.yaml      # PNPM workspace configuration
├── package.json             # Root package.json (workspace)
└── claude.md                # AI development guide

🚀 Apps

apps/api (Backend API)

apps/api/
├── src/
│   ├── config/              # Configuration (database, GitHub, JWT)
│   ├── controllers/         # Request handlers
│   ├── db/                  # Database schema and migrations
│   ├── middlewares/         # Express middlewares
│   ├── routes/              # API route definitions
│   ├── services/            # Business logic services
│   ├── types/               # TypeScript types
│   ├── utils/               # Utility functions
│   └── index.ts             # Application entry point
├── docs/                    # API-specific documentation
├── scripts/                 # Database and utility scripts
├── drizzle.config.ts        # Drizzle ORM configuration
├── package.json
├── tsconfig.json
└── claude.md                # API development guide

apps/web (Frontend)

apps/web/
├── app/                     # Next.js 15 App Router
│   ├── (auth)/             # Auth routes (login, signup)
│   ├── (main)/             # Main app routes (dashboard, editor)
│   ├── (public)/           # Public routes (landing, portfolio view)
│   ├── api/                # API routes (webhooks, internal)
│   ├── layout.tsx          # Root layout
│   └── page.tsx            # Landing page
├── components/              # React components
│   ├── blocks/             # Portfolio block components
│   ├── dashboard/          # Dashboard UI components
│   ├── editor/             # Portfolio editor components
│   ├── modals/             # Modal dialogs
│   ├── theme/              # Theme system components
│   └── ui/                 # shadcn/ui components
├── contexts/                # React contexts
├── hooks/                   # Custom React hooks
├── lib/                     # Libraries and utilities
│   ├── api/                # API client functions
│   ├── types/              # TypeScript types
│   └── utils/              # Utility functions
├── public/                  # Static assets
├── stores/                  # State management (Zustand)
├── styles/                  # Global styles
├── next.config.ts
├── package.json
├── tsconfig.json
└── claude.md                # Web development guide

apps/worker (Background Jobs)

apps/worker/
├── src/
│   ├── config/              # Configuration
│   ├── services/            # Service layer
│   │   ├── ai-analyzer.ts  # Claude AI integration
│   │   └── github-client.ts # GitHub API client
│   ├── workers/             # BullMQ worker definitions
│   └── index.ts             # Worker entry point
├── Dockerfile               # Docker container config
├── railway.json             # Railway deployment config
├── package.json
├── tsconfig.json
└── claude.md                # Worker development guide

이 후 초기 화면 기획은 누리님이 Google AI Studio 를 사용하여 모든 화면에 대한 기획을 마쳤고, 저는 그 화면을 보며 클로드 코드와 화면에 대한 명세, API 명세, 인프라 구성, 프로젝트 구조에 대한 기획을 할 수 있었습니다.

AI 포트폴리오 웹사이트 스크린샷

1-3주차 핵심 구현 사항

11월 10-11일: GitHub 연동

로그인 화면이 있는 검은색 화면

핵심 기능의 시작점이었습니다.

  • GitHub 계정 연결 시스템

  • 코드 저장소 접근 설정

  • 사용자 관리 체계

GitHub OAuth를 붙이고, 사용자의 저장소에 접근할 수 있는 권한 체계를 만들었습니다. 여기서 GitHub App을 선택한 건 나중에 좋은 결정이 됐습니다.

11월 12-14일: 포트폴리오 편집기

웹사이트의 기술 페이지 스크린샷

사용자가 직접 만지는 부분이라 공을 들였습니다.

6가지 구성 요소 개발

  • 드래그 앤 드롭 기능

  • 실시간 미리보기

  • 디자인 테마 변경 기능

블록 기반 에디터를 만들었습니다. Hero, About, Project, Skills, Experience, Contact. 6가지 블록을 조합해서 포트폴리오를 구성하는 방식입니다. 누리님이 전부 개발을 맡아서 처리했습니다.

11월 20-22일: AI 시스템 개선

비용이 문제였습니다.

  • 최신 AI 모델 도입

  • 비용 80% 절감 달성

  • 프로젝트 이미지 업로드

  • 분석 중단 및 재시작 기능

처음엔 Claude Sonnet을 썼는데, 분석 한 번에 $0.50 정도 나왔습니다. 서비스로 굴리기엔 부담스러운 금액이었습니다. Haiku 4.5로 바꾸니까 $0.10으로 떨어졌습니다. 품질은 거의 차이가 없었습니다.

이 과정에서 프로젝트 분석 및 평가를 BullMQ 기반 비동기 Job Queue 시스템으로 구현을 하고, 분석이 완료 알림을 보내도록 구현을 했는데,

이게 누군가가 merge 할때마다 알림이 안오는 이슈가 생겼습니다. 여기서 두번째 문제가 발생했습니다.(이어서...)

11

함께 이야기해요 11

로그인하고 댓글을 남겨 주세요

진여진 프로필 이미지
진여진2025.12.16

개발자 시선에서 협업한 사례를 처음부터 보는게 너무 재미있고 유익했습니다.

사례 게시글 작성해주셔서 감사합니다. 🙇‍♂️

참여자 모두 바이브코딩에 익숙하다보니

문서화를 프로젝트에 작성해서 일을 줄인 사례가 참 인상깊습니다

그리고 프로젝트 메모리 문서화 합의 관계에서 나름의 기준을 만들고 작업을 했을 것 같은데

기준 설립 과정에서 어떤 이야기가 오갔을지도 궁금해지네요 ㅎㅎ

황인준 프로필 이미지
황인준2025.12.17

재밌게 봐주셔서 감사합니다!

그리고 프로젝트 메모리 문서화 합의 관계에서 나름의 기준을 만들고 작업을 했을 것 같은데

기준 설립 과정에서 어떤 이야기가 오갔을지도 궁금해지네요 ㅎㅎ

-> 이 부분은 잘 작성된 문서 하나를 딱 만들고, 해당 레퍼런스를 참고해서 작성해달라고 했습니다.

2탄에서 소개될 예정이지만, 직접 커뮤니케이션이 많이 필요한 변경 사항들은, 클로드코드가 해석할 수 있도록 잘 제공했고, 사람에게는 이 부분만 확인해줘 라고 전달했습니다!

물결2 프로필 이미지
물결22025.12.16

오오 둘이서 협업하면서 하나하나 손발을 맞추면서 만들어낸거였군요! 이렇게 하나의 프로젝트를 같이 하는 방법이 더 공유되면 좋을거 같아요!!

황인준 프로필 이미지
황인준2025.12.17

정말 생각하지도 못했던 부분에서 시행착오가 좀 많았습니다 ㅎㅎㅎ

2탄에서 좀 더 풀어보겠습니다!

Rose 프로필 이미지
Rose2025.12.17

Role 분배 이야기며, 상세 토론 내용 등 흥미진진합니다. 2탄이 기대되는군요. 👍

Haiku와 Sonnet이 성능 차이가 없었다는 점이 인상적입니다.

황인준 프로필 이미지
황인준2025.12.17

이번에 제일 잘한 것 중 하나가 좀 더 능동적으로 책임감을 부여하는 role 분배가 아니였나 싶었습니다!

또 그에 따른 속도감도 되게 좋았습니다!

닿 프로필 이미지
닿2025.12.17

바이브코더랑 개발자 1:1 매칭 시스템을 만들어볼까나.....

Rose 프로필 이미지
Rose2025.12.17

몇 달 전에 제가 상상한 것과 비슷한데요~~~!! AI 때문에 현업에서 밀려나는 개발자들과 매칭해주면 너무 좋을 것 같아요~^^

황인준 프로필 이미지
황인준2025.12.17

파티 시스템?!! 당근 처럼 온도 만들면 될듯 ㅋㅋㅋ 중간에 탈주 못하도록

세

주식투자

세

종목선택프롬프트

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요

이런 사례도 있어요

사례 전체 보기