요구사항·검증으로 통제하는 AI 코딩

원문 핵심 요약

Andy McDonald의 지질 도식 앱 제작 경험 · 공개판

요구사항과 검증을 먼저 구조화

저자는 VSCode와 Codex로 암상 무늬 생성기를 만들며 범위와 검토 지점을 문서화했다.

요구사항 고정

PRD에 기능·제외 범위·완료 조건을 적는다. 사례 앱은 지질 해석이나 자동 분류를 하지 않는다.

작업 단위 승인

목록을 합의하고 주요 작업을 세부 항목으로 나눈 뒤 구현 승인을 받는다.

검증과 기록

주요 작업마다 Docker로 검증하고 작업 목록·변경 기록을 갱신한 다음 멈춘다.

개인의 개발 절차 사례이며 우수성을 입증한 통제 비교는 없다.

원문 사례의 실제 도달점

시험 가능한 MVP

미리보기 크기·배치·입력 문제를 수정했지만 남은 이슈는 후속 PRD로 넘겼다.

사람이 유지하는 역할

가정과 정확성

도메인 판단의 책임

에이전트가 반복 구현을 맡아도 가정·명칭·경계·정확성의 판단은 사람이 유지한다.

추가 요청 관리

계획과 실행의 구분

개선 요청을 후속 단계에 기록하고 처리 시점을 결정한다.

원문 절차의 요약

요구사항·규칙 정의
목록·세부 작업 합의
승인 범위 구현
검증·기록 후 정지

별도의 적용 제안

BOM 비교 보조 도구의 단계별 검증

기존 기준을 읽기만 하는 시제품으로 검증

우리의 제안 · 한 제품군의 승인된 비교 규칙

비식별 시험 사본과 별도 개발 환경 사용

범위 문서화

입력 버전·비교 규칙·표시 형식·완료 조건과 자동 변경 금지를 명시한다.

작업 목록 합의

입력 읽기·차이 표시·근거 출력 등 확인 가능한 단위로 분해한다.

단계별 구현·검증

승인한 작업만 구현하고 정상·예외 시험을 통과한 뒤 다음 단계로 간다.

결과 검토·기록

담당자가 기준 결과와 대조하고 변경 이력·잔여 이슈를 검토한다.

완료 표시보다 중요한 검증 지표

기준 결과 일치율

승인된 시험 사례 중 기대한 비교 결과와 일치한 비율

범위 이탈 건수

합의하지 않은 기능·파일·시스템 변경 시도 수

재작업 시간

승인 전 오류 수정과 재검증에 든 시간

검증 기록 완전성

완료 작업 중 테스트 결과와 변경 이력이 모두 남은 비율

시제품과 운영 변경을 분리

기존 기준 존중

Teamcenter·PDM·ERP와 확립된 M-BOM 정합성을 기준선으로 유지

운영 쓰기 차단

시제품은 시험 사본을 읽고 운영 BOM·생산지시를 변경하지 않음

승인과 중단

검증 실패·범위 불명확 시 멈추고 담당자가 다음 작업 승인

자료·이력 보호

승인 자료만 사용하고 입력 버전·검증 결과·변경 이력을 보존

기준·완료 조건 합의
작업별 격리 시험
전문가 대조·수정
시범 확대 여부 승인