비개발자 수십 명에게 바이브코딩을 시킨 회사의 Starter Kit 전부 공개

비개발자 수십 명에게 바이브코딩을 시킨 회사의 Starter Kit 전부 공개

결론부터. 비개발 직군에게 AI 코딩을 확산시킬 때 실패하는 1번 이유는 "교육을 한 번 하고 끝내서"입니다. 도구 사용법을 가르치는 게 아니라, 누가 어떤 실수를 해도 사고가 안 나는 레일(가드레일)을 먼저 깔고, 그 위에서 실습하게 해야 정착합니다. 이 글은 비개발 직군 수십 명에게 바이브코딩을 실제로 확산시키면서 만든 Starter Kit 구성과 롤아웃 설계를 그대로 공개합니다. 회사 사정에 맞게 복제해 쓰세요.

요즘 "총무팀도 AI로 자동화했다"는 사례 글이 많습니다. 그런데 대부분 "좋았다"는 후기에서 끝나고, 어떻게 실수 없이 굴러가게 만들었는지-실제 구성과 거버넌스-는 안 나옵니다. 비개발자가 AI로 코드를 만드는 건 쉬워졌지만, 그 코드를 회사에서 안전하게 운영하는 건 전혀 다른 문제거든요. 그 빈칸을 채우는 글입니다.

비개발자 바이브코딩 구성

 

---

1. 핵심 통찰 - 가르칠 건 "도구"가 아니라 "안전한 레일"

비개발자에게 "Claude Code 깔고 자유롭게 해보세요"라고 하면 두 부류로 갈립니다. 겁나서 안 하거나, 겁 없이 하다가 사고를 칩니다(자격증명 노출, 운영 데이터 건드리기, 정체불명 코드 배포). 둘 다 확산을 죽여요.

그래서 순서를 뒤집어야 합니다. 자유를 주기 전에 레일을 깐다. 비개발자가 무엇을 하든 (a) 위험한 곳엔 못 닿고, (b) 결과물이 일정한 품질로 나오고, (c) 문제가 생겨도 되돌릴 수 있는 환경을 먼저 만들어두는 거죠. 그게 Starter Kit입니다.

---

2. Starter Kit 구성 - 5개 요소

신규 참가자가 이 템플릿 하나를 복제하면 곧바로 안전하게 시작할 수 있도록 묶었습니다.

① GitHub 템플릿 저장소 (출발점 고정) "빈 폴더에서 시작하세요"가 비개발자에겐 가장 큰 벽입니다. 폴더 구조, 기본 설정, 예제 작업이 다 들어있는 템플릿 저장소를 만들어두고 "복제 버튼만 누르세요"로 시작점을 통일했습니다. 모두가 같은 출발선에 서니 지원도 쉬워집니다.

② CLAUDE.md (AI의 행동 규칙서) 이게 Starter Kit의 심장입니다. 프로젝트마다 들어가는 CLAUDE.md에 AI가 지켜야 할 규칙을 미리 박아둡니다. 비개발자가 매번 프롬프트로 설명할 필요가 없어지고, 결과물이 일정해져요. 예시:

## 작업 규칙
- 항상 한국어로 설명할 것
- 운영 데이터베이스에는 절대 직접 연결하지 말 것 (샘플 데이터만 사용)
- 외부에 파일을 업로드하거나 API 키를 코드에 적지 말 것
- 파일을 바꾸기 전에 무엇을 왜 바꾸는지 먼저 한국어로 설명할 것
- 출처 없는 통계·수치는 쓰지 말 것

금지 사항을 명시적으로 적어두는 게 핵심입니다. "하지 마"를 글로 박아두면 사고의 상당수가 사전에 걸러집니다.

③ ✨CI/CD 파이프라인 (자동 안전망) 비개발자가 만든 코드가 곧바로 운영에 나가면 안 됩니다. 푸시하면 자동으로 검사·테스트·배포가 도는 파이프라인을 템플릿에 미리 깔아두면, 사람이 실수해도 기계가 한 번 걸러줍니다. 비개발자는 파이프라인의 존재조차 몰라도 보호를 받습니다. 제 경험상 바이브코딩 인프라 세팅에 가장 영향력을 크게 미치는 부분은 CI/CD 파이프라인 자동화였습니다.

④ Skills / 재사용 레시피 (반복 작업 표준화) 자주 하는 작업(보고서 양식 만들기, 특정 형식으로 데이터 정리하기 등)을 재사용 가능한 스킬·커스텀 명령으로 묶어 템플릿에 넣었습니다. 매번 같은 지시를 반복할 필요가 없고, 팀 전체가 같은 방식으로 결과를 냅니다.

⑤ 가드레일 & 권한 설정 (못 닿게 막기) 권한 모드와 접근 범위를 미리 설정해, 위험한 명령이나 민감한 경로엔 애초에 닿지 못하게 막아둡니다. "신뢰하되 검증"이 아니라 "애초에 위험을 제거"하는 쪽이 비개발자 대상에선 맞습니다.

---

3. 롤아웃 설계 - 한 번의 교육이 아니라 단계

교육 한 번으로는 절대 정착 안 됩니다. 단계로 끌고 가세요.

1. seed 그룹 먼저 (5~10명). 자발적으로 관심 있는 사람부터. 이들이 성공하면 사내에 가장 강력한 자극이 됩니다("저 팀이 했으면 우리도").
2. 실제 본인 업무로 첫 결과물. "배운 느낌"이 아니라 퇴근할 때 실제로 작동하는 자동화 하나가 손에 남게 설계합니다. 추상적 예제는 금방 잊혀요.
3. 사내 쇼케이스. 씨앗 그룹이 만든 걸 다른 부서 앞에서 시연. "AI가 막연한 개념이 아니라 지금 내 업무에 당장 쓸 수 있다"는 체감이 확산의 연료입니다.
4. 확산 + 지원 채널. 템플릿을 열고, 질문받는 채널을 운영. 모두 같은 Starter Kit에서 출발하므로 지원 부담이 적습니다.

---

4. 거버넌스 - 비개발자 코드의 진짜 리스크는 "운영"

가장 중요한데 다들 빠뜨리는 부분. 코드 생성이 아니라 그 다음이 문제입니다. AI가 코드를 만들 수는 있어도, 만든 사람이 그걸 이해 못 하면 서비스 연속성을 담보할 수 없어요. 반드시 정해두세요.

• 민감정보·운영 데이터 경계: 실데이터는 건드리지 않게(샘플만), 자격증명은 코드가 아닌 별도 보관소(시크릿 매니저 등)에서.
• 오너십: 비개발자가 만든 자동화도 "누가 책임지고 유지하는가"를 정해둡니다. 만든 사람이 퇴사하면 방치되는 게 가장 흔한 사고.
• 배포 게이트: 사람 검토 또는 자동 검사를 반드시 한 단계 끼웁니다.
• 접근 통제: 사내 서버·시스템 접근은 권한 관리가 철저한 경로로만.

---

5. 무엇을 측정할까

"좋았다"는 후기 말고 숫자로 봐야 확산을 설득할 수 있습니다.

• 참가자 중 실제로 작동하는 자동화를 1개 이상 완성한 비율
• 자동화로 줄인 반복 업무 시간(주당 시간)
• 2주 후에도 계속 쓰는 비율(정착률 - 일회성 교육의 함정을 잡는 지표)
• 확산 속도(부서 수)

---

6. 흔한 실패 패턴 (정직하게)

• 교육 한 번 하고 방치 → 정착률 0. 단계·지원 채널 없으면 무조건 실패합니다.
• 레일 없이 자유부터 → 사고 한 번이면 보안팀이 전체를 막아버립니다. 가드레일이 먼저.
• 추상적 예제로 실습 → 자기 업무가 아니면 안 남습니다. 첫 결과물은 반드시 본인 실무로.
• 잘된 사례만 공유 → 신뢰가 안 쌓입니다. 안 된 것·삽질도 같이 공유해야 사람들이 따라옵니다.

---

한 줄 정리

비개발자 바이브코딩 확산의 공식은 "레일을 먼저 깔고(Starter Kit), 본인 업무로 첫 결과물을 만들게 하고, 단계적으로 확산하며, 운영 거버넌스를 정해두는 것." 도구는 쉬워졌습니다. 어려운 건 안전하게 굴러가게 만드는 설계고, 그게 AX 담당자의 진짜 일입니다.

이 Starter Kit 구조는 회사 규모·보안 수준에 맞게 가감하면 됩니다. 도움이 됐다면 사내에 공유해 주세요.

---

함께 보면 좋은 글: "Claude Code 세션 5개 동시에 굴리는 법 - 입문 끝낸 사람을 위한 멀티 세션 실전"

Claude Code 세션 여러개 동시에 굴리는 법 (5개 병렬 멀티 세션)