뉴스레터 목록
파이프라인바이브코딩클로드코드

바이브 코딩, 프롬프팅을 넘어 파이프라인으로

바이브 코딩, 프롬프팅을 넘어 파이프라인으로

AI 코딩의 생산성 향상이 10~20%에 그치는 이유와, 파이프라인 설계로 50~100배까지 끌어올린 실전 사례를 소개합니다.


바이브 코딩은 쉽다. 그런데 생산성은?

AI에게 코딩을 위임하는 것 자체는 이제 너무 쉬워졌습니다. 간단한 프롬프트로도 그럴싸한 결과물이 나오고, 홈페이지 URL을 주고 클론 코딩을 요청하면 꽤 비슷하게 만들어 줍니다.

버그 수정, 작은 UI 변경, 테스트 작성 같은 일도 잘 해주고있고요. 아마 많이들 이미 활용하고 계실 것입니다.

그런데 생산성이 10배 늘었나요? 대부분 그렇지 않습니다.

왜 그럴까요? 개발자의 작업 시간 비중을 따져보면, 구현은 전체의 15%밖에 안 됩니다. 나머지는 요구 사항 명확화, 설계, 리뷰에 소요됩니다. AI는 구현만 해주니까 드라마틱한 변화가 일어나지 않는 거죠.

AI에게 설계를 맡기고 그걸 고치는 것보다, 내가 설계 흐름을 잡아준 다음 구현만 시키는 게 훨씬 덜 번거롭습니다.

결국 키보드 타이핑만 위임하는 셈이 됩니다.


앞 단계를 맡길 수 없는 이유

개발 작업은 크게 구체화 → 설계 → 구현 → 셀프 체크 단계로 나뉩니다.

앞 단계(구체화, 설계)에서 무언가 잘못되면 뒷 단계로 전파되면서 증폭됩니다. 잘못된 요구 사항이 잘못된 설계를 만들고, 잘못된 설계가 잘못된 코드를 만듭니다. 리뷰할 때 이 거대한 잘못됨을 감지하고 고치는 게 오히려 더 번거로워서 맡길 수 없는 겁니다.

그래서 AI에게 온전히 맡길 수 있는 건 구현과 셀프 체크뿐입니다.


파이프라인화할 수 있는 작업의 조건

AI 활용도를 극대화하려면, 구현과 셀프 체크 비중이 높은 작업을 위임해야 합니다. 경험적으로 가장 효과가 좋았던 프로젝트 유형은 마이그레이션스펙 기반 구현이었습니다.

이런 작업들의 공통점은 세 가지입니다:

1. 정확하게 정의된 스펙이 있어야 한다

일반적인 기획 문서 수준이 아닙니다. 유스케이스 수준으로 스텝 바이 스텝, 엣지 케이스까지 명시되어 있어야 합니다. 유비쿼터스 랭귀지를 사용해 용어 혼동도 없어야 합니다. 마이그레이션의 경우 레거시 코드 자체가 스펙 역할을 합니다.

2. 코드 레벨에서 검증 가능해야 한다

"디자인이 예쁘게 구현되었는가"는 아직 에이전트에게 검증시키기 어렵습니다. 하지만 테스트 통과 여부로 검증할 수 있는 프로젝트라면 가능합니다.

3. 반복적인 작업이 많아야 한다

창의적인 설계가 중간중간 필요하면 안 됩니다. 규칙에 따라 구현하는 작업이 대다수인 경우에 유용합니다.


파이프라인 설계 4단계

Specify — 스펙 만들기

레거시 코드를 읽고 마크다운 문서로 스펙을 만드는 과정입니다.

Explore — 현재 코드베이스 파악

지금 코드베이스의 컨벤션, 활용 가능한 파일과 라이브러리를 파악합니다.

Plan — 설계

스펙과 파악된 컨벤션을 바탕으로 설계합니다.

Implement — 구현

설계를 바탕으로 구현합니다.


사례 1: 레거시 ERP 마이그레이션

자바로 작성된 노후화된 ERP를 Next.js로 통째로 옮기는 프로젝트였습니다. 기능 113개, 페이지 96개의 큰 규모였습니다.

파이프라인 운영 방식:

  • 각 단계의 마지막에 마크다운 파일이 생성됩니다. 사람은 결과만 검토하고, 과정은 보지 않습니다.
  • 각 단계 시작 전에 에이전트가 방향성을 사용자에게 되물은 후 진행합니다.
  • 플래닝은 Opus, 구현은 Sonnet으로 모델을 분리했습니다. Sonnet이 더 빠르고 비용이 낮으며, 잘 설계된 계획이 있으면 충분히 잘 동작합니다.

결과: 1명이 7일 만에 완료. 구현보다 파이프라인 세팅에 더 오래 걸렸습니다. 약 5개 페이지를 테스트 데이터셋으로 파이프라인을 최적화한 뒤 전체를 돌렸습니다. 이후 2주간 안정화하여 런칭했습니다.

생산성 향상: 50~100배.


사례 2: 제조 공장 MES 자동화

제조 기업 전문 외주사에서 PM이 공장에 세일즈하며 파악한 요구 사항을 문서화해 개발자에게 전달하는 과정을 자동화했습니다.

핵심 개선 사항:

1. 데이터 정형화: 파워포인트와 전화 전달 방식을 노션과 스프레드시트로 바꿔 기계가 읽을 수 있는 포맷으로 변환했습니다.

2. 커스텀 MCP 제작: 범용 MCP(예: 공식 노션 MCP)는 툴이 방대해 최적화되어 있지 않습니다. 커스텀 MCP를 만들면 툴 세 번 호출할 것을 한 번으로 줄일 수 있고, 속도와 컨텍스트 모두 절약됩니다.

3. 정적 작업 분리: 빈 파일 생성이나 API 연동처럼 정적으로 가능한 작업은 파이썬 스크립트로 분리했습니다. 모든 작업을 에이전트에게 맡기는 것보다 효율적입니다.

결과: 파이프라인 세팅 2주 후, "OOO 회사 MES 만들어 줘"라는 요청만으로 동작하는 수준에 도달했습니다.


바이브 코딩 vs 파이프라인 코딩

둘은 우열 관계가 아닙니다.

  • 바이브 코딩: 창의적이고 비정형적인 작업, 신규 기능 개발에 적합
  • 파이프라인 코딩: 규칙적이고, 검증 가능하고, 지루한 반복 작업에 적합

일반적인 작업이라도 부분적으로만 파이프라인화할 수 있습니다. 디자인은 사람이 하고, 비즈니스 로직만 파이프라인에 태우는 식입니다.


파이프라인 설계 프로세스

  1. 페이즈별 에이전트 생성: Specify, Explore, Plan, Implement 각각 하나씩 만듭니다.
  2. 서브 에이전트 최적화: 필요한 도구(MCP, 스킬)를 부여하고 시스템 프롬프트를 조정합니다.
  3. 서브 에이전트 분해: 작업을 병렬화하거나 컨텍스트가 과도할 때 쪼갭니다.

가장 중요한 것은 이터레이션입니다. 처음 만들면 반드시 불만족스러운 결과가 나옵니다. 테스트 데이터셋으로 반복하며 미세 조정하는 과정이 핵심입니다.


FAQ

왜 클로드 코드를 추천하나요?

서브 에이전트 기능이 클로드 코드에만 있습니다. 다른 코딩 에이전트로는 파이프라인화 자체가 불가능합니다. Opus 모델은 스펙이나 플랜을 작성했을 때 가장 충실히 따르는 성능을 보여줍니다.

MCP와 스킬 중 어떤 걸 써야 하나요?

기업 내부 파이프라인 최적화 관점에서는 MCP가 더 좋습니다. 리모트 서버로 배포할 수 있어 새 버전을 릴리즈하면 일괄 적용되고, 인증 기능도 붙일 수 있습니다. 스킬은 파일 기반이라 배포할 때마다 구성원들에게 파일을 교체하라고 해야 합니다.