[AI워케이션 2기 용평] "만든 사람이 나가도, 그 서비스 계속 돌아갑니까?" — 스펙킷으로 두 번 검증한 방법
2026.09.20
![[AI워케이션 2기 용평] "만든 사람이 나가도, 그 서비스 계속 돌아갑니까?" — 스펙킷으로 두 번 검증한 방법 본문 이미지](/_next/image?url=https%3A%2F%2Fcdn-beta.gpters.org%2Fexternal%2F966f3e3c7cd595ff239f7df5.jpg&w=3840&q=75)
[Spec Kit + Claude Code + Codex] "만든 사람이 나가도, 그 서비스 계속 돌아갑니까?" — 스펙킷으로 두 번 검증한 방법
한줄 요약
AI로 빠르게 만든 결과물이 만든 사람 머릿속에서만 존재하다 사라지는 문제를, 연초에는 신규 프로젝트로, 이번 워케이션에는 이미 돌아가고 있는 운영 소스로 두 번 검증했습니다. 오픈소스 3개를 분석하며 작업법을 스킬로 굳혔고, 결과를 한 화면에서 보는 Spec Atlas(9개 프로젝트·405개 문서)까지 만들었습니다.
이런 분들께 도움돼요
바이브코딩으로 서비스를 만들었는데 이걸 계속 운영할 수 있을지 불안한 분
AI 도구는 다 깔았는데 회사에 뭐가 남는지 모르겠는 CEO·경영진
외주나 퇴사자가 남긴 시스템을 넘겨받아야 하는 분
프로젝트마다 방식이 달라 조직의 자산으로 안 쌓이는 팀
소개: 시도하고자 했던 것과 그 이유
먼저, 질문 하나
최근 AI로 만든 프로젝트 하나를 골라보세요.
요구사항·프롬프트·데이터·코드·테스트·승인·운영 문서를
지금 즉시 다른 사람에게 넘길 수 있습니까?
이 질문에 "예"라고 답할 수 있는 회사를 저는 거의 못 봤습니다. AI 유료 계정은 다 있고, 결과물도 빠르게 나옵니다. 그런데 그 결과가 회사에 남는지는 아무도 증명하지 못합니다.
문제 상황 (Before)
바이브코딩이 퍼지면서 예전엔 없던 유형의 문제들이 생겼습니다. 이 중 몇 개나 해당되시나요?
비개발자가 만든 서비스가 만든 사람조차 정확히 설명 못 하는 블랙박스가 된다
새 기능을 요청하면 AI가 전에 고쳐둔 버그를 되돌려 놓는다
로컬에선 되는데 실제 배포하고 늘리는 방법은 아무도 모른다
비개발자 프로토타입을 개발팀이 인수 못 해서 처음부터 다시 만든다
원청이 외주 납품물을 받았는데 AI로 날림 개발한 건지 검수할 방법이 없다
프로젝트가 끝나면 소스만 남고 노하우와 프롬프트는 폐기된다
조직이 커지니 "그때그때 AI에게 물어보는" 방식이 병목이 된다
원인은 하나로 모입니다.
AI와 사람이 함께 만든 결과물(코드·대화·의사결정·시행착오)이
특정 세션·특정 사람·특정 모델 안에서만 존재하다가 휘발된다.
AI로 빠르게 만드는 것은 이미 해결된 문제입니다. 진짜 문제는 그다음입니다.
그래서 두 번 검증했습니다
프로젝트는 크게 두 종류입니다.
종류 | 상태 |
|---|---|
신규 — 처음부터 시작하는 것 | 연초에 검증 완료 |
운영 중 — 이미 코드가 있고 돌아가는 것 | 이번 워케이션에서 검증 |
연초에 저는 신규 프로젝트를 스펙킷 기반으로 진행해서, AI 결과물도 지속 운영이 가능하다는 사례를 만들었습니다. 스펙 177개로 지금도 돌아갑니다.
그런데 여기엔 조건이 있었습니다 — 처음부터 그렇게 시작했다는 것.
세상 대부분의 코드는 두 번째입니다. 그리고 바이브코딩으로 만든 것도 만든 순간 두 번째가 됩니다. 그래서 이번엔 반대쪽을 해봤습니다.
시작하게 된 계기
워케이션 원래 계획은 제 서비스 마이톡 업그레이드(개인 에이전트 메신저)였습니다. 개선하려면 먼저 다른 사례를 봐야 했고, 오픈소스 세 개를 골랐습니다 — Orca, Paseo, Buzz.

여기서 멈칫했습니다.
"분석한다"는 게 대체 뭐지?
README 읽고, 코드 몇 개 열어보고, "아 이렇구나" 하고 닫으면
일주일 뒤에 아무것도 안 남습니다. 저는 그런 분석을 여러 번 해봤습니다.
그래서 방법을 바꿨습니다. 읽지 말고, 스펙으로 되돌려보자.
진행 방법: 어떤 도구를 사용했고, 어떻게 활용했나요?
사용한 도구
Claude Code — 오픈소스 3개를 스펙으로 되돌리는 작업 (분석 본체)
ChatGPT Codex — Spec Atlas 앱 제작
Spec Kit (GitHub 공개 도구) — 산출물 형식의 표준
특이사항 — 둘을 역할로 나눠 썼습니다. "분석"과 "도구 만들기"는 성격이 다른 일이라, 섞지 않으니 둘 다 깊이 들어갔습니다
1단계. "읽기" 대신 "쓰기"로 분석했습니다
핵심 아이디어는 단순합니다.
읽으면 이해한 것 같지만 안 남습니다.
쓰려고 하면 확인해야 하고, 확인하려면 실행해야 하고, 실행하면 진짜로 알게 됩니다.
세 저장소에서 스펙 문서가 나왔습니다 — Buzz 38개, Orca 32개, Paseo 24개.
그런데 가장 값어치 있었던 건 스펙이 아니었습니다.
clarify.md — "코드를 다 읽어도 알 수 없는 것" 목록이었습니다.
이게 사실상 인수인계 공백 지도입니다. 퇴사자가 남긴 시스템, 외주로 받은 결과물, 바이브코딩으로 만든 서비스 — 넘겨받을 때 제일 먼저 필요한 게 정확히 이겁니다. "뭘 모르는지 아는 것." 그런데 이건 그냥 읽어서는 절대 안 만들어집니다.
2단계. 분석했더니 결함이 나왔습니다
스펙을 쓰다 보니 이상한 게 계속 걸렸습니다. 문서는 A라는데 코드는 B를 하고 있고, 테스트는 실제로 쓰이지도 않는 부분을 검사하고 있고.
Buzz 한 곳에서만 결함 10건을 찾았습니다. 그중 3건은 원본 최신 버전에도 그대로 남아 있던 보안 결함이었습니다.

▲ 분석 과정에서 나온 결함 기록. 버그를 찾으려던 작업이 아니었습니다.
제가 만든 코드도 아니고, 버그를 찾으려던 것도 아닙니다. 그냥 분석하려고 문서를 쓰다가 나온 겁니다.
가장 인상적이었던 건 이런 종류였습니다.
만료된 데이터를 정리하는 코드에 오류가 있어서,
한 번 만료가 생긴 사용자는 그 뒤로 영원히 등록이 실패하는 문제.
이런 건 코드를 눈으로 읽어서는 절대 안 보입니다. 실제로 돌려봐야 나옵니다.
여기서 방법론의 진짜 가치를 알았습니다.
문서가 자산이 아니라, 문서를 쓰는 과정이 자산입니다.
지킨 원칙 — 분석과 개입을 섞지 않았습니다
분석이 목적이었으므로 코드를 새로 만드는 단계(implement)는 실행하지 않았습니다. 남의 저장소에 코드를 생성할 이유가 없으니까요.
발견한 결함은 별도의 교정 문서로 분리했습니다. 원본은 읽기 전용, 수정은 별도 작업 공간에서만. 이 구분을 지키니 "지금 이런가"와 "이래야 하는가"가 뒤엉키지 않았습니다.
3단계. 세 번 반복하니 작업법이 굳었습니다
Orca 하고, Paseo 하고, Buzz 할 때쯤 되니 절차가 보였습니다. 매번 같은 순서였습니다.
전수 조사 → 한 영역 깊이 파기 → 발견한 결함 교정 →
전체 기능 지도 → 위험한 것부터 순서대로
이걸 스킬로 고정했습니다. 이제 이름만 부르면 이 절차가 그대로 돕니다.
처음부터 일반화하려 하지 않은 게 중요했습니다. 세 번 해보고 반복되는 걸 발견한 다음에 굳혔습니다. 먼저 추상화했으면 쓸모없는 틀이 나왔을 겁니다.
4단계. "이거 어디 있더라?" — Spec Atlas
산출물이 쌓이니 새 문제가 생겼습니다. 저장소가 9개인데 스펙이 다 흩어져 있었습니다. 어디에 뭐가 있는지 저조차 못 찾겠더군요.
Codex에 던진 첫 마디는 이랬습니다.
각 스펙들의 spec.md 파일을 일반 사용자도 한눈에 파악해볼 수 있는 방법이 뭐가 있을까?
이 한 문장에서 Spec Atlas가 나왔습니다.
9개 프로젝트 · 현재 문서 405개 · 기능 묶음 164개를 한 화면에서
설치 없이 브라우저로 파일 하나 열면 끝 (독립 HTML)
프로젝트별 기능 지도(그림)
외부 AI 호출 없음 — 회사 코드가 밖으로 안 나갑니다
이 도구 자체도 스펙킷으로 만들었습니다. 자기 방법론으로 자기를 만든 셈입니다.

▲ Spec Atlas — 9개 프로젝트·405개 문서를 한 화면에서. 설치 없이 브라우저로 열립니다.

▲ 프로젝트별 기능 지도. 어느 영역에 무엇이 있고, 아직 검토 안 된 게 무엇인지 보입니다.


막혔던 순간과 해결 — AI가 세 번 틀렸습니다
문제: AI가 "이건 버그다"라고 단정한 게 세 번 틀렸습니다.
기능이 2개라고 단정 → 실제로는 7개 (전체를 안 찾아봄)
안 쓰이는 코드를 근거로 "버그" 판정 → 실제로는 정상
회의록 앞부분만 읽고 "요약이 부정확하다" 판정
공통 원인: "안다고 가정하고 확인을 건너뜀" + "한쪽만 보고 단정"
해결: 규칙으로 못 박았습니다.
짝으로 존재하는 건 반드시 함께 본다 (보내는 쪽↔받는 쪽)
근거로 삼기 전에 그게 실제로 쓰이는지 확인한다 (오래된 코드엔 죽은 코드가 흔합니다)
"없다"와 "못 찾았다"를 구분한다
이 규칙을 넣은 뒤로는 오진이 걸러지기 시작했습니다. 나중엔 결함 후보 3건이 이 규칙에 걸려 "버그 아님"으로 판명됐는데, 찾은 것보다 안 틀린 게 더 중요했습니다.
💡 비개발자에게 특히 중요합니다. AI가 확신에 차서 말해도 그대로 믿으면 안 됩니다.
확인할 능력이 없다면, AI에게 "확인 절차"를 규칙으로 주는 것이 대안입니다.
결과와 배운 점
Before vs After
항목 | Before | After |
|---|---|---|
분석 방법 | 읽고 훑기 → 일주일 뒤 아무것도 안 남음 | 문서로 남음 |
남는 곳 | 머릿속 (사람이 나가면 소멸) | 파일로 |
결함 발견 | 사고 나야 앎 | 문서 쓰는 과정에서 미리 |
인수인계 | 처음부터 다시 읽어야 함 | "모르는 것 목록"부터 시작 |
여러 프로젝트 | 어디에 뭐가 있는지 모름 | 한 화면에서 405개 문서 |
작업법 | 매번 감으로 | 스킬로 고정, 재사용 |
검증된 것 / 아직 아닌 것
정직하게 나눠 적겠습니다.
검증됐습니다
신규 프로젝트에 스펙킷을 쓰면 지속 운영 가능 — 연초, 스펙 177개
이미 돌아가는 운영 소스도 전환 가능 — 이번, 오픈소스 3개
문서를 쓰는 과정이 실제로 결함을 찾아냄 — 10건, 그중 보안 3건
작업법이 반복 가능한 형태로 고정됨 — 스킬화
여러 프로젝트를 한 화면에서 볼 수 있음 — Spec Atlas
아직 검증 못 했습니다
"적용된다"와 "쓸모 있다"는 다릅니다. 이 문서들이 실제로 의사결정을 바꾸는지는 측정 중입니다
조직 단위 적용은 아직입니다. 제가 혼자 검증한 것이고, 팀에서 돌려본 건 다음 단계입니다
CEO·경영진이라면 — 무엇이 달라지는가
같은 AI 예산을 쓰면서 이렇게 갈립니다.
지금 방식 | 자산이 쌓이는 방식 | |
|---|---|---|
도입 철학 | 일단 직원들에게 계정을 나눠준다 | AI 산출물을 회사 지식 자산으로 축적 |
비용 성격 | 매달 소멸하는 구독료 | 누적되는 투자 |
품질 관리 | 일단 돌아가니 괜찮다 (사후 수습) | 명세와 검증을 통과해야 배포 |
퇴사자 발생 | 파악 불가 → 시스템 전면 재구축 | 남겨진 기록으로 즉시 승계 |
모델 교체 | 프롬프트·코드가 깨져 사실상 불가능 | 표준 형식이라 즉시 전환 |
투자유치·실사 | 문서-코드 불일치로 감점 요인 | 즉시 제시 가능한 자산 |
한 문장으로 줄이면 이렇습니다.
AI가 만든 속도를, 사람이 없어도 모델이 바뀌어도 유지되는 회사의 자산으로 전환하는 것.
배운 점과 나만의 꿀팁
효과적이었던 것
"읽기" 말고 "쓰기"로 분석하세요. 이해한 느낌과 실제로 아는 것은 다릅니다.
"모르는 것"을 산출물로 만드세요. 완벽한 문서보다 "우리가 뭘 모르는지 아는 문서" 가 실전에서 더 값집니다.
분석과 수정을 분리하세요. 원본은 읽기 전용, 고치는 건 별도 공간에서.
세 번 해본 뒤에 표준화하세요. 먼저 틀부터 만들면 안 맞는 틀이 나옵니다.
AI를 역할로 나누세요. 한 대화에서 다 하려 하면 컨텍스트가 섞여서 둘 다 얕아집니다.
이렇게 하면 안 돼요
AI의 "버그다" 판정을 그대로 믿지 마세요. 세 번 틀렸습니다. 확인 규칙을 먼저 주세요.
원본을 건드리지 마세요. 나중에 "이게 원래 것인가 내가 고친 건가"를 구분 못 하게 됩니다.
문서가 있다고 검증된 게 아닙니다. 문서 상태·체크박스·실제 동작 확인은 전부 별개입니다.
기존 문서를 형식만 바꿔 옮기지 마세요. 이건 제가 실제로 시행착오한 부분입니다 ↓
과정 중 시행착오
가장 큰 실수는 "문서를 옮기면 되겠지" 였습니다.
Buzz에는 이미 문서가 760KB나 있었습니다. 처음엔 이걸 스펙킷 형식으로 옮기면 되겠다고 생각했습니다.
그건 값어치가 0이었습니다. 원본이 더 자세한데 형식만 바꾸면 정보가 오히려 줄어듭니다.
방향을 바꿨습니다 — 옮기지 말고, 문서와 실제 코드 사이의 차이를 재자. 그랬더니 결함 11건 중 7건이 문서만 읽어서는 안 나오는 것이었습니다.
그리고 재밌는 걸 발견했습니다. 문서가 두꺼운 프로젝트와 얇은 프로젝트에서 결과가 정반대였습니다.
문서가 두꺼우면 코드가 틀린 곳이 나오고, 문서가 얇으면 문서가 틀린 곳이 나옵니다.
어느 쪽이든, 한쪽만 봐서는 안 나옵니다.
앞으로의 계획
다음 단계
마이톡 업그레이드 — 원래 목적. 이제 분석 자산이 생겼으니 여기에 씁니다
조직 단위 적용 검증 — 혼자 말고 팀에서 돌려보기
여러 프로젝트를 가로지르는 공통 패턴 추출 — 9개를 겹쳐 보면 반복되는 구조가 보입니다
지금 당장 해볼 수 있는 것
비개발자라면 — 바이브코딩으로 만든 것 중 하나만 골라서 AI에게 물어보세요.
이 코드가 실제로 무엇을 하는지 설명해줘.
그리고 코드만 봐서는 알 수 없는 것을 따로 목록으로 만들어줘.
추측하지 말고, 모르는 건 모른다고 표시해줘.
두 번째 목록이 나오면 그게 당신 서비스의 위험 지점입니다.
CEO·경영진이라면 — 팀에 이 질문을 던져보세요.
"AI를 쓰고 있습니까?"가 아니라
"AI로 만든 것을 다른 사람이 수정한 경험이 있습니까?"
"담당자가 없을 때 어떤 문제가 생겼습니까?"
"이전 프로젝트의 해결책을 다시 찾는 데 얼마나 걸립니까?"
답이 안 나오면, 그게 지금 상태입니다.
도움이 필요한 부분
조직 단위로 이걸 적용해보신 분이 계시면 경험을 나눠주시면 좋겠습니다. 저는 아직 개인 검증 단계입니다.
재사용 가능한 프롬프트
프롬프트 1: 내가 만든 것의 위험 지점 찾기 (비개발자용)
[프로젝트 폴더]의 코드를 분석해줘.
1. 이 코드가 실제로 무엇을 하는지 설명해줘
2. 코드만 봐서는 알 수 없는 것을 별도 목록으로 만들어줘
3. 추측하지 마라. 확인 못 한 건 "확인 필요"로 표시해라
특히 이런 걸 찾아줘:
- 데이터가 잘못 저장될 수 있는 곳
- 동시에 여러 사람이 쓰면 문제가 생기는 곳
- 비밀번호나 열쇠가 코드에 그대로 적혀 있는 곳
프롬프트 2: 기존 코드를 스펙으로 되돌리기
[저장소 경로]의 기존 코드를 Spec Kit 형식으로 역방향 스펙화해줘.
원칙:
- 원본은 읽기 전용이다. 절대 수정하지 마라
- 스펙은 별도 저장소([프로젝트명]-specs)에 쓴다
- 코드가 실제로 무엇을 하는지 기술한다 (그래야 하는 것이 아니라)
- 코드를 다 읽어도 알 수 없는 것은 "모르는 것 목록"으로 남긴다
- 추측하지 마라. 확인 못 한 건 [NEEDS CLARIFICATION]으로 표시한다
먼저 전수 조사(어떤 부분이 있고 각각 얼마나 활발한가)부터 하고,
그다음 가장 중요한 영역 하나를 깊이 들어가자.
프롬프트 3: AI 오진 방지 규칙 (위와 함께 사용)
"이건 버그다"라고 판단하기 전에 반드시 지켜라:
1. 짝으로 존재하는 건 함께 본다 (보내는 쪽↔받는 쪽, 요청↔응답)
2. 근거로 삼는 코드가 실제로 쓰이는지 검색해서 확인한다
(오래된 코드엔 안 쓰이는 코드가 흔하다)
3. "전에는 됐는데 망가졌다"고 하려면 전체 이력을 확인한다
(처음부터 그랬을 수 있다)
4. "없다"와 "못 찾았다"를 구분해서 표기한다
확인 못 한 건 결함이 아니라 "확인 필요"로 남겨라.
프롬프트 4: 문서와 실제의 차이 재기
[모듈명]에 대해 "문서가 주장하는 것 / 코드가 실제로 하는 것 / 차이" 표를 만들어줘.
- 문서 쪽은 원문을 그대로 인용한다 (요약하지 말고)
- 코드 쪽은 근거(파일·함수)를 함께 적는다
- 일치 / 불일치 / 확인불가 세 가지로 분류한다
- 불일치는 어느 쪽이 맞는지 단정하지 말고 둘 다 기록한다
도움 받은 글
참고한 자료
GitHub Spec Kit — spec-driven.md
지피터스 워케이션 (2026.09.18~21, 용평)
AX 전환 아키텍트 백성욱
경험을 자산으로 만들어주는 시스템을 어떻게 만들 것인가 — 이 질문으로 일하고 있습니다.
AI로 빠르게 만드는 건 이미 해결된 문제입니다. 진짜 문제는 그다음입니다.
만든 사람이 없어도, 그 AI 모델이 바뀌어도, 다음 사람이 이어받고 운영하고 재사용할 수 있는가.




좋은 결과물은 내가 아니라 다른 사람이 사용할 수 있는 것이군요. spec kit 라는 것을 조금은 이해할 수 있을 것 같습니다. 감사합니다.