Vibe Adoption Framework · Roboco
기존 기업의 바이브 코딩 도입을 위한 프레임워크 — Vibe Adoption Framework(VAF) 소개
vaf.roboco.io · github.com/roboco-io/vibe-adoption-framework
Why now
고수준 개발 인력을 낮은 비용으로 대규모 확보한 것과 같은 효과. 리드타임·품질·비용 구조가 바뀐다.
도구를 쓰면서도 조직 차원의 성과로 연결하지 못한다. "AI를 썼는데 달라진 게 없다"는 결론으로 귀결.
코딩 에이전트는 이미 숙련 개발자가 하던 상당수의 작업을 대신한다. 격차는 계속 벌어지고 있다.
대전제
달라지는 것은 원칙이 아니라 경제성이다.
명확한 요구사항, 좋은 아키텍처, 리뷰, 테스트, 문서화 — 사람의 개발을 성공시키던 원칙이 에이전트의 개발도 성공시킨다.
과거에 비쌌던 것들(꼼꼼한 리뷰, 철저한 테스트, 레거시 전체 분석)을 에이전트가 낮은 비용으로 상시 수행한다.
질문은 "AI를 위해 무엇을 바꿀까"가 아니라 "원래 했어야 할 것을 에이전트와 어떻게 실현할까".
Foundational Principles
유능한 신입에게 주는 것 — 접근 권한, 시스템 설명, 규칙, 명확한 지시, 리뷰 — 를 에이전트에게도 주어라. 실패하는 조직은 에이전트를 탓하고, 성공하는 조직은 온보딩 체계를 만든다.
"에이전트가 만들었으니 나는 모른다"를 허용하지 않는다. 작성 주체가 바뀌어도 설명의 의무는 이동하지 않는다. 누가 물어도 언제든 답할 수 있어야 한다.
사람의 이해와 실제 시스템의 간극 = 인지부채. 기술부채처럼 제거가 아니라 트레이드오프 관리의 대상. 어디에 깊은 이해를 유지할지는 조직이 결정한다.
Named Concepts
사람이 하던 리뷰와 가드레일을 AI가 대신하도록 체계화하는 공학. 규칙 파일 · 자동 리뷰 · 훅 · 검증 파이프라인의 조합. 잘 만든 하네스는 사람의 리뷰를 더 높은 추상화 수준(의도·설계·트레이드오프)으로 끌어올린다.
비취향(보안·가드레일·코딩 규약)은 저장소와 함께 관리되고 전원에게 강제된다. 취향(문서화 상세 수준 등)만 극히 제한적으로 재량 허용. 저장소에 내장된 규칙은 에이전트에게 어길 수 없는 환경이 된다.
Framework
"조직이 무엇을 갖추어야 하는가?" 진단과 개선 계획의 단위.
"실제로 무엇이 바뀌는가?" 각 영역의 AsIs → ToBe.
"어떤 순서로 진행하는가?" 준비→진단→파일럿→전환의 반복 사이클.
여정을 따라 나아가며, 역량을 갖추고, 그 역량으로 전환 영역의 AsIs를 ToBe로 바꾼다.
Value Chain
도구 도입을 성과로 착각 — 라이선스 구매는 사슬의 첫 칸일 뿐.
전환 없이 성과를 바로 요구 — "AI를 썼는데 달라진 게 없다"는 잘못된 결론.
경영진의 질문: 지금 이 사슬의 어느 칸이 병목인가? 그것이 투자 우선순위다.
Transformation Domains
| Domain | AsIs | ToBe |
|---|---|---|
| 코드 생산 | 사람이 작성, 채용이 곧 용량 계획 | 에이전트가 작성, 사람은 의도 지시와 승인 |
| 품질 보증 | 사람 리뷰, 일정 압박에 가장 먼저 희생 | 하네스가 자동 강제, 사람은 설계 판단에 집중 |
| 지식 | 암묵지·구두 전승, 퇴사 = 지식 손실 | 에이전트가 상시 활용하는 문서화된 지식기반 |
| 조직과 역할 | 작성자 중심 팀, 코드량으로 평가 | 오너·오케스트레이터 중심 팀 |
가장 느리고 어려운 전환은 조직과 역할 — 명시적으로 다루지 않으면 "도구는 샀는데 아무도 쓰지 않는" 상태가 된다
Perspectives
왜, 무엇을 얻는가 — 도입 전략, ROI 측정, SDLC 갭 분석, 우선순위
사람의 역할 — 오너십 체계, 인지부채 관리, 역할 전환, 역량 개발, 문화
무엇을 강제하는가 — 취향/비취향, 정책의 저장소 강제, 보안, 비용
에이전트가 일할 수 있는가 — 접근 통로, 도구 연결, 실행 환경, 권한
에이전트가 아는가 — 지식기반, 리포지토리 문서화, 현안 문서화, 컨텍스트 공급
품질을 누가 지키는가 — 규칙 파일, 스킬·훅, 자동 리뷰, 검증 파이프라인, 개선 루프
Perspectives in one line
왜 도입하며, 무엇을 얻는가? — 이 관점이 부실하면 나머지 다섯의 노력은 개인기로 흩어진다.
사람의 역할은 무엇인가? — 사람의 가치는 무엇을 작성했는가가 아니라 무엇을 책임지는가.
무엇을 강제하는가? — 에이전트는 규칙을 어기려는 의지가 없다. 규칙이 환경에 없으면 존재를 모를 뿐.
에이전트가 일할 수 있는가? — 계정 없는 신입에게 성과를 기대할 수 없다.
에이전트가 아는가? — 에이전트의 성과는 접근 가능한 지식의 질에 비례한다.
품질을 누가 지키는가? — 하네스 없는 조직에서 에이전트의 속도는 곧 결함의 속도다.
Adoption Journey
VAF는 진단보다 환경 준비를 먼저 둔다.
진단·분석·문서화의 수행 주체가 에이전트이기 때문이다.
Journey Principles
작게 완주하라 — 좁게 끝까지 가는 것이 넓게 걸치고 멈추는 것보다 낫다. 완주 경험이 확산의 연료다.
단계를 건너뛰지 마라 — 준비 없는 진단은 사람의 속도로, 진단 없는 파일럿은 맥락 없는 코드로, 파일럿 없는 전환은 검증 안 된 강요로.
모든 단계에서 심층인터뷰로 확인하라 — 문서가 현실과 어긋난 채 다음 단계로 넘어가는 것이 가장 비싼 실패다.
지표는 사이클마다 갱신하라 — 경영진의 신뢰는 지표의 연속성에서 나온다.
Anti-patterns
6개월 뒤 "활용률이 낮다"는 보고와 함께 동력 소진.
성과를 증명하지 못해 예산 갱신 시점에 좌초.
돌아오는 답은 전면 차단. 보안은 설계 참여자로.
원인은 에이전트가 아니라 하네스의 공백이다.
VAF 본문에는 26개 역량 항목마다 안티패턴이 명시되어 있다
Execution Kit
26개 역량 × 3단계(부재/부분/정착) 판별 질문
비즈니스 현안 · IT 현안 · SDLC · 지식 관리 4개 영역
진단 워크숍(반나절) · 파일럿 착수 워크숍(1일)
프레임워크 전 용어 한/영 병기
진단 단계의 어세스먼트와 인터뷰, 파일럿 착수까지 — 프레임워크를 읽는 것에서 실행하는 것으로.
Expected Outcomes
기능 개발·버그 수정·레거시 분석이 병렬로, 상시로.
리뷰·검증이 하네스로 옮겨가 예외 없이 강제.
인력 규모에 비례하던 개발 용량의 한계가 완화.
암묵지가 문서화된 지식기반으로, 개인 의존 해소.
사람이 코드를 손으로 쓰지 않는 상태가 기본값이 되고,
오너십과 인지부채 관리 체계가 그것을 지탱한다.
Vibe Adoption Framework
vaf.roboco.io
(EN · 한국어 · 日本語)
github.com/roboco-io/
vibe-adoption-framework
로보코 — roboco.io
© Roboco · Vibe Adoption Framework