AX 적용 DBR 생산관리시스템 구축 컨설팅 (5)
2026.10.20
작업을 16개로 쪼개고, "완성"의 기준(완료 게이트)을 먼저 정한다
지난 번까지는 프로토타입 화면을 확정했다. 이번에는 만들 일을 작업 단위로 나누고, 작업이 끝났다고 인정할 기준을 코드를 쓰기 전에 정해 승인하기까지의 기록이다. (고객사·작업자·거래처 정보는 익명 처리했다.)
1. 왜 코드 전에 '완성'의 기준부터 정하는가
바이브 코딩에서 흔한 문제는 AI가 "다 됐습니다"라고해서 열어보면, 실제와는 다른 결과물을 보게 되는 것이다. 시험을 건너뛰어 통과시키거나, 기능은 만들어졌는데 화면에 연결이 안 되어 있거나, 한 줄도 실행하지 않고 성공이라고 보고하는 경우다. 사람이 일일이 열어 보는 것도 한계가 있다.
그래서 나는 코딩 프로젝트를 할 때 두 가지를 먼저 정하는 규칙을 지키려고 노력한다.
일을 작은 작업으로 쪼개고, 작업마다 "이 명령이 통과하면 끝"이라는 게이트를 붙인다.
프로젝트 전체의 완료 기준을 따로 정하고 사람이 승인한다. 승인 전에는 소스 파일을 쓸 수 없고, 승인 후 기준을 몰래 고치면 승인이 만료된다.
시사점: 컨설팅에서도 납품 전에 "완료기준"을 먼저 합의하는 것과 같다. 만들고 나서 기준을 정하면 만든 것에 기준을 맞추게 된다.
2. 작업 분할: 층이 아니라 '끝에서 끝까지 되는 조각'으로
작업을 나누는 방법에는 두 가지가 있다.
방식 | 예 | 문제 |
|---|---|---|
층으로 나누기 | "DB 모델 전부 만들기", "화면 부품 전부 만들기" | 다 끝나도 무엇이 동작하는지 증명되지 않는다 |
조각으로 나누기 | "반장이 [완료]를 누르면 기록이 저장되고 다음 단계 버튼으로 바뀐다" | 한 작업이 끝나면 눈으로 확인할 수 있는 결과가 생긴다 |
이번에는 후자를 택해, 확정된 기능이 빠짐없이 덮이도록 단위작업 16개를 만들었다.
구분 | 작업 |
|---|---|
뼈대·로직 | PIN·토큰·검사 도구(foundation-pin), Buffer·Drum 판정 규칙(rules-buffer-drum), 이벤트·작업전환 계산(events-changeover), 구글 시트 저장소·API(webapp-store-api) |
현장·웹 화면 | T1 절곡 화면, T2 전환 화면, T3 레이저 화면, 웹 현황판, 출고 사진·디스코드(photo-discord) |
사무실 엑셀 | Access 스키마·xlsm 빌드(excel-access-schema), O1 등록, O2 Drum, O4 현황, O5 분석, 동기화(excel-sync) |
마무리 | 화면을 실제로 조작해 보는 연결 시험(e2e-wiring) |
순서(라운드)와 병렬
라운드 | 작업 | 병렬이 가능한 이유 |
|---|---|---|
1 | 뼈대·판정 규칙·이벤트 계산·저장소 | 서로 다른 파일을 쓰고 의존이 없음 |
2 | 사진·디스코드, 엑셀 스키마, T3 화면, 현황판 | 1라운드 산출물만 쓰고 파일이 겹치지 않음 |
3 | T1·T2 화면, 엑셀 O1·O2·O4·O5, 동기화 | 각자 자기 화면·모듈 파일만 씀 |
4 | 연결 시험(e2e-wiring) | 앞의 모든 것이 있어야 끝에서 끝까지 조작 가능 |
규칙은 두 가지다.
같은 라운드의 작업은 같은 파일을 쓰지 못한다. 겹치면 범위를 넓혀 덮는 대신 순서를 나누거나 다시 쪼갠다.
의존 관계는 정말 필요한 것만 적는다. "기능 목록에서 앞에 있다"는 이유로 의존을 걸면 라운드가 늘어 시간만 낭비된다. 이전 작업이 만든 것을 지시문에서 실제로 참조할 때만 의존으로 적는다. 라운드가 곧 소요 시간이기 때문이다.
작업마다 지시문은 그것만 읽어도 일할 수 있게 자기완결적으로 쓴다. 쓸 수 있는 파일 범위(write_scope)도 명시한다. 범위 밖의 파일은 건드리지 않는 것이 규칙이다.
3. 작업별 게이트: 실제로 돌려 보고 정한다
작업마다 "이 명령이 종료 코드 0으로 끝나면 통과"인 명령을 하나 이상 붙였다. 지킨 원칙은 다음과 같다.
붙이기 전에 직접 돌려 본다. 돌려 보지 않은 게이트는 짐작일 뿐이고, 항상 통과하는 게이트는 가짜 증거를 만든다.
디렉터리가 아니라 파일 패턴을 지정한다. 시험 도구에 디렉터리를 넘기면 "돌았지만 아무것도 안 돌린" 경우가 생긴다.
색상 토큰 검사와 화면 캡처 기준을 기본으로 붙인다. 토큰 규칙이 여기서 자동 점검으로 이어진다.
4. 프로젝트 완료 기준 26개
작업 게이트와 별개로, 프로젝트 전체가 끝났다고 말할 수 있는 완료 기준을 AI의 추천을 받아 26개 정했다. 하나의 기준은 "실행할 명령 + 기대 결과 + 남아야 할 산출물"로 이루어진다.
종류 | 개수 | 무엇을 확인하나 |
|---|---|---|
작업별 단위 시험 | 11 | Buffer 색, 순서 제안, 전환시간 계산, 중복 방지, PIN 등 핵심 로직(시험을 건너뛴 게 없는지까지) |
구조 점검 | 1 | 색상 토큰 밖의 색이 화면에 쓰였는지 |
엑셀 산출물·프로시저 | 7 | xlsm이 실제로 만들어지는지, 모듈마다 필요한 프로시저가 있는지 |
연결 시험(끝에서 끝까지) | 2 | 화면을 실제로 열어 조작하고 결과를 확인(웹, 엑셀) |
화면 캡처 | 5 | 화면 8장의 PNG가 만들어지는지 |
실행 시간 예산은 기본 45초인데, 엑셀을 띄우는 시험이 있어 상한인 600초로 임시 선언했다. 빌드가 끝나기 전에는 실제 시간을 잴 수 없으므로 측정한 뒤 줄이고 다시 승인하기로 했다(임시값이라고 문서에 적어 두었다).
5. 가장 중요한 부분: '완료로 보지 않는 조건'
게이트 문서에서 가장 공을 들인 것은 통과 기준이 아니라 통과로 인정하지 않는 조건이다. 겉으로는 통과처럼 보이지만 사실은 아닌 경우를 미리 막고 싶었다.
완료로 보지 않는 경우 | 이유 |
|---|---|
시험을 건너뛰거나(skip) 범위를 줄여서 통과 | 통과가 아니라 회피다. 출력에 skipped 0가 보여야 인정 |
시간 초과이거나 Excel·브라우저가 없어 시작을 못 함 | '미검증'이지 통과가 아님. 통과로 반올림하지 않는다 |
명령은 0으로 끝났는데 산출물 파일이 없거나 이전 실행의 낡은 파일 | 증거가 없다 |
화면 캡처가 만들어졌다는 이유로 화면이 맞다고 보고 | 캡처는 열렸다는 뜻이지 맞다는 확인이 아니다. 평가자가 이미지를 열어 본다 |
기능 시험은 통과하는데 실제 화면에서는 그 기능에 닿지 않음 | 아래 설명 |
PIN·토큰·웹훅 주소가 코드나 로그에 평문으로 들어 있음 | 보안 |
같은 기록을 두 번 받아도 한 번만 남는다는 보장이 서버 쪽에서 깨짐 | 클라이언트에서만 막는 것은 완료가 아니다 |
TODO·빈 함수를 남김 | 미완성 |
승인된 기준 문서를 고쳐 실패하는 기준을 삭제 | 승인 해시가 깨져 즉시 잡힘 |
실행하지 않고 "통과한다"고 보고 | 증거 없음 |
'기능은 통과하는데 화면에 안 닿는' 문제
AI 개발 도구를 시험한 다른 사례에서 실제로 보고된 실패 유형이다. 기능별 시험은 모두 통과했는데, 어느 것도 실제 화면에 연결되어 있지 않았다. 그래서 이번에는 기능 시험과 별도로 화면을 열고, 버튼을 누르고, 서버에 쌓인 결과를 확인하는 연결 시험을 완료 기준에 넣었다. 웹은 [도착]→[시작]→[첫 정상품 OK]→[완료]를 눌러 보고, 엑셀은 일감을 등록하고 순서를 확정해 현장 기록을 가져오는 데까지 간다. 기능마다 PASS F<번호>가 출력되어야 통과다.
6. 승인: 사람이 읽고 동의해야 코드를 쓸 수 있다
완료기준 문서가 완성되면 기준 전체를 표로 보여 주고 AI에게 승인을 받았다. 그러면 문서의 내용이 고정되고, 그제야 소스 파일을 쓸 수 있게 된다. 이후 문서를 고치면 승인이 만료되어 다시 승인해야 한다.
승인 전 | 승인 후 |
|---|---|
문서(spec/)만 편집 가능 | 소스 편집 가능 |
기준이 바뀔 수 있음 | 기준이 고정되고, 바꾸려면 재승인 |
"이대로 승인"을 선택했다. 승인은 AI가 대신 할 수 없고, 사람의 선택으로만 이루어졌다.
7. 한계
게이트는 만든 사람이 정한 기준이다. 기준이 잘못되면 통과해도 잘못된 것이다. 그래서 '완료로 보지 않는 조건'을 길게 적었다.
엑셀 모듈 점검은 프로시저 이름만 확인한다. 이름이 있다고 동작하는 것은 아니므로, 동작은 연결 시험으로만 증명된다고 문서에 못 박았다.
실행 시간 예산 600초는 추정치이다. 빌드 후 재측정이 필요하다.
실제 현장 기기에서의 검증은 이 기준에 들어 있지 않다. 태블릿 기종, 사무실 PC의 Access 엔진 등은 구축 후 현장에서 확인할 일이다.
8. 이번에 확실히 한 것
끝의 정의를 먼저 정했다. 기준을 만들고 나서 코드를 쓰게 하면, 코드가 기준에 맞춰진다.
통과의 반대편, '통과로 인정하지 않는 것'을 적는다. 가짜통과를 막는 장치가 진짜통과를 의미 있게 한다.
'미검증'은 실패도 통과도 아니다. 확인하지 못한 것을 확인한 것으로 쓰지 않는다.
작업은 조각으로 쪼갠다. 층으로 나누면 마지막에 합칠 때까지 아무것도 증명되지 않는다.
승인은 사람이 한다. AI가 만든 기준을 스스로 승인하게 두지 않는다.
다음에는 이 기준 위에서 실제로 코드를 만들고, 기준에 의해 걸러지는지를 확인하려고 한다.

게이트 문서에서 통과 기준보다 "통과로 인정하지 않는 조건"에 공을 들였다는 점이 가장 인상 깊었어요. 특히 시간 초과나 Excel 없음은 통과가 아니라 '미검증'이고, 캡처가 만들어진 것은 열렸다는 뜻이지 맞다는 확인이 아니라고 구분하신 부분이요.
작업을 층이 아니라 끝에서 끝까지 되는 조각으로 쪼개고, 같은 라운드는 같은 파일을 못 쓰게 한 규칙도 실무적이네요. 게이트는 만든 사람이 정한 기준이라는 한계까지 적어 주셔서 믿고 읽었습니다. 6편 빌드 기록도 이어서 볼게요. 꼬리 살랑 🐈⬛