바이브코딩 제작·검토 가이드

실습 예: 가상 교육 문의를 목록으로 보고 상태별로 필터하는 도구. 실제 고객 정보나 외부 시스템 연결 없이 화면과 동작을 먼저 확인합니다.

제작 요청서
사용자: [도구를 쓰는 사람]
문제: [지금 불편한 행동]
핵심 기능: [최대 3개]
입력: [필드 / 형식 / 가상 예시]
결과: [사용자가 보는 화면과 값]
완료 기준: [직접 눌러 확인할 행동]
실습 범위: [로컬 또는 테스트 공간 / 외부 전송 여부]

예시 완료 기준: ‘목록을 볼 수 있다. 대기 상태만 고를 수 있다. 결과가 없으면 안내 문구가 보인다.’ 디자인 취향과 기능의 통과 조건을 구분해 적습니다.

복사할 요청
‘[제작 요청서]를 기준으로 현재 프로젝트 구조를 확인하고 한 화면의 초안을 구현해 주세요. 기존 실행 방법을 먼저 확인하고, 바꿀 파일과 확인할 동작을 설명하세요. 가상 데이터로 핵심 기능을 만들고 실행 방법과 직접 확인할 항목을 남겨 주세요. 실제 발송·결제·원본 삭제 기능은 이번 범위에 넣지 마세요.’

제작 순서
1) 화면 구조와 가상 데이터를 확인합니다.
2) 기능 한 가지를 구현하고 실제로 실행합니다.
3) 기대 동작과 다르면 재현 조건을 기록합니다.
4) 수정 후 같은 조건으로 다시 확인합니다.

오류 전달 양식: [어떤 화면에서 / 무엇을 입력하고 눌렀는지 / 기대한 결과 / 실제 결과 / 화면 또는 오류 문구]. 한 번에 여러 요구를 추가하기 전에 현재 기능이 동작하는지 확인합니다.

화면과 기능
[ ] 핵심 동작이 완료 기준대로 실행됩니다.
[ ] 빈 목록·검색 결과 없음·긴 문장·작은 화면을 확인했습니다.
[ ] 키보드로 주요 입력과 버튼에 접근할 수 있습니다.
[ ] 저장·취소·새로고침 뒤 상태가 기대대로 보입니다.

자료와 연결
[ ] 화면·코드·실행 기록에 비밀번호나 비밀 키를 넣지 않았습니다.
[ ] 입력값을 어디에 저장하고 누구에게 보내는지 확인했습니다.
[ ] 실제 계정 연결이나 변경 기능은 필요한 접근 범위를 검토했습니다.
[ ] 실패했을 때 성공으로 표시하지 않고 다음 행동을 안내합니다.

검토 기록: [시험 조건 / 기대 결과 / 실제 결과 / 수정 여부]. 로그인·권한·저장·외부 연결이 있는 도구는 해당 부분을 확인할 기술 담당자를 정하고 검토 결과를 남깁니다.

최종 전달 묶음
[ ] 제작한 파일과 변경 요약
[ ] 설치·실행 방법과 필요한 환경
[ ] 직접 확인한 기능과 시험 조건
[ ] 아직 구현하지 않은 기능과 알려진 문제
[ ] 자료 저장 위치·외부 연결·권한의 설명
[ ] 수정 담당자와 이전 상태로 되돌리는 방법

마무리 요청
‘완료 기준별로 구현 위치와 확인 결과를 정리해 주세요. 실행하지 못한 검사는 미확인으로 표시하세요. 다음 담당자가 처음부터 실행할 수 있도록 필요한 명령과 설정 이름을 설명하되 실제 비밀 값은 넣지 마세요.’

공식 참고 문서
OpenAI의 Codex 실무 가이드는 프로젝트 맥락과 완료 기준을 제공하고 관련 검사와 변경 검토를 수행하는 작업 방식을 설명합니다.
ChatGPT Learn — Best practices
https://learn.chatgpt.com/guides/best-practices

이 가이드의 요구사항 양식과 문의 목록 과제는 COBSLAB의 실습 예시입니다.