STEP 1 : 프로젝트 시작 (폴더 · 첫 대화)
1단계: 폴더 준비 (직접)
새 폴더 구매요청관리를 만들고 아래처럼 파일을 넣은 뒤, 이 폴더를 Claude 작업 폴더로 엽니다.
구매요청관리/
├── 요구사항서.md ← 3교시 결과물 (없으면 4교시/스타터세트/요구사항서.md)
├── data/
│ ├── 데이터사전.csv ← 스타터세트 (또는 3교시 data/데이터사전.xlsx)
│ ├── 구매요청_샘플_20행.csv
│ └── 구매요청_샘플_20행.xlsx
└── test/
├── 나쁜데이터_5건.csv
├── 열누락_품목명없음.csv
└── 한글인코딩_CP949.csv ← 4교시/테스트데이터
2단계: 폴더 확인 (첫 대화)
안녕! 이 폴더에서 구매요청 관리 프로그램을 만들 거야. 폴더 안에 뭐가 있는지 확인하고, 요구사항서.md를 읽고 3줄로 요약해줘. 아직 만들지는 마.
확인 : 요구사항서.md, data/ 3개, test/ 3개 파일을 찾고, 업로드·검색·요약·등록수정·검증·다운로드 기능을 요약하면 성공
STEP 2 : 환경과 규칙 (Claude 규칙 파일)
1단계: Claude 규칙 파일 기본 생성
/init
2단계: 데이터·보안 규칙 추가
CLAUDE.md에 프로젝트 규칙을 추가해줘:
1. 데이터는 data/ 폴더의 가상 구매요청 데이터만 사용한다. 실제 부서·거래처·금액 사용 금지.
2. 열 이름·필수값·허용값은 data/데이터사전.csv가 기준이다. 임의로 열을 추가·변경하지 않는다.
3. 결과물은 브라우저에서 여는 HTML 파일 1개. 인터넷 없이 동작하고, 데이터를 외부로 전송하지 않는다.
4. 외부 라이브러리는 Excel 읽기·쓰기용 SheetJS 1개만, HTML 파일 안에 내장한다. 다른 라이브러리는 추가 전 확인받는다.
5. 합계·건수·금액 계산은 코드로 직접 한다. AI 호출 금지.
6. 단계가 끝날 때마다 작동하는 파일을 구매요청관리_v1.html, v2, v3로 따로 저장한다.
확인 : CLAUDE.md에 6개 규칙이 들어가면 성공
STEP 3 : 개발 (뼈대·업로드 → 조회·등록·수정 → 검증·다운로드)
1단계: 구현 설계서 생성 → 코드 없이 설계도만
간단하게
요구사항서.md와 CLAUDE.md, data/데이터사전.csv를 읽고, 프로그램을 만들기 위한 "구현 설계서"를 BUILD_PLAN.md로 저장해줘. 아직 코드는 만들지 마.
전체를 3단계(v1 업로드·목록 → v2 조회·요약·등록·수정 → v3 검증·다운로드·변경 이력)로 나누고, 각 단계에 [목표 / 구현 내용 / 완료 확인 방법]을 적어줘.
상세하게
요구사항서.md와 CLAUDE.md, data/데이터사전.csv를 읽고, 프로그램을 만들기 위한 "구현 설계서"를 BUILD_PLAN.md로 저장해줘. 아직 코드는 만들지 마.
전체를 3단계로 나누고, 각 단계에 [목표 / 구현 내용 / 완료 확인 방법]을 적어줘.
■ 1단계 — 뼈대 + 업로드 (구매요청관리_v1.html)
Excel(xlsx)·CSV 업로드 → 목록 표에 표시. 열 이름·순서는 데이터 사전과 동일.
- 데이터 사전의 필수 열이 없으면 빨간 경고, 사전에 없는 열은 노란 경고
- CSV는 UTF-8과 CP949 모두 읽기, Excel 날짜는 YYYY-MM-DD로 표시(46266 같은 숫자 금지)
- 목록에 엑셀 행 번호 표시
확인: 샘플 20행 → 20행 / test/열누락_품목명없음.csv → 경고 / test/한글인코딩_CP949.csv → 한글 정상 / xlsx → 날짜 정상
■ 2단계 — 조회·요약 + 등록·수정 (구매요청관리_v2.html)
검색창(모든 열) + 유형·상태·요청부서 드롭다운 + 시작일~종료일 필터.
요약 탭: 건수·금액 합계 카드, 유형별·월별·상태별·승인권자별 건수와 금액 표 (코드로 계산).
'새 항목' 폼: 드롭다운은 허용값만, 필수값 비면 저장 불가. 요청ID·금액_원(수량×단가)·승인권자(2,000만 초과 본부장 / 500만 초과 팀장 / 그 외 불필요) 자동.
목록 행 클릭 → 같은 폼으로 수정.
확인: 금액 합계 170,838,000원 / 유형=IT장비 5건 / 9월 18건·10월 2건 / 품목명 비우고 저장 → 막힘
■ 3단계 — 검증 + 다운로드 + 변경 이력 (구매요청관리_v3.html)
'검증' 버튼: 전체 행 검사 → [엑셀행 / 요청ID / 열 / 사유] 표, 목록의 오류 행은 빨간색.
검사 항목: 필수값 누락, 허용값 외, 존재하지 않는 날짜, 요청ID 중복, 음수 금액, 금액≠수량×단가, 승인권자 불일치
다운로드: 현재 목록(필터 적용)·전체를 xlsx·csv로, 파일명에 오늘 날짜.
변경 이력: 화면 위에 수정자 이름 입력, 등록·수정 시 [일시 / 수정자 / 요청ID / 항목 / 이전 값 / 새 값] 기록 → 이력도 다운로드.
확인: 샘플 20행 → 검증 통과 / test/나쁜데이터_5건.csv → 오류 행 5개(3·4·6·8·9행) / 내려받은 파일 재업로드 → 오류 0 / 수정 1건 → 이력 1줄 이상
공통 규칙(모든 단계): 가상 데이터만 · 외부 전송 금지 · 인터넷 없이 동작 · SheetJS 1개만 내장 · 계산은 코드로 · 단계마다 v1·v2·v3 저장
이 설계서에 동의하면, 다음부터 1단계씩 구현하자.
2단계: 1단계부터 순서대로 → 짧은 드라이버
BUILD_PLAN.md의 1단계를 구현해서 구매요청관리_v1.html로 저장해줘. 끝나면 브라우저에서 여는 방법과 확인할 파일 순서를 알려줘.
확인 : 샘플 csv 20행 → 열누락 csv 경고 → CP949 csv 한글 → 샘플 xlsx 날짜 순서로 직접 올려보기
좋아. 이제 2단계(조회·요약·등록·수정)를 구현해서 구매요청관리_v2.html로 저장해줘. v1 기능은 그대로 두고, 끝나면 숫자 확인하자.
확인 : 요약 탭 금액 합계 170,838,000원(Excel SUM과 같음) / IT장비 필터 5건 / 새 항목에서 수량 2·단가 3,000,000 입력 시 금액 6,000,000·승인권자 ‘팀장’ 자동
3단계(검증·다운로드·변경 이력)를 구현해서 구매요청관리_v3.html로 저장해줘. 기존 기능은 그대로. 끝나면 test/나쁜데이터_5건.csv로 확인하자.
확인 : 나쁜 데이터 오류 행 5개 검출 → 오류 행 클릭해 고치기 → 변경 이력 1줄 → 전체 xlsx 내려받아 다시 올리면 검증 통과
막힐 때 : 기능이 꼬이면 이전 버전 파일을 지정해서 한 기능씩 요청
v3에서 검색이 안 돼. 구매요청관리_v2.html의 검색 기능은 잘 됐으니 그 방식으로 v3의 검색만 고쳐줘. 다른 기능은 건드리지 마.
3단계: 최종 검수 (4-eyes)
BUILD_PLAN.md 기준으로 완성된 구매요청관리_v3.html을 검토자 입장에서 검수해줘 — 샘플 20행 합계·건수 대조 검산, test/ 파일 3개로 업로드·검증 전수 점검, 데이터 사전 규칙 누락 여부, CLAUDE.md 규칙 위반 여부(외부 전송·라이브러리·AI 계산). 문제는 설명하고 직접 고쳐줘.
확인 : 검산 숫자(170,838,000원 · 20건 · IT장비 5건 · 승인권자 불필요 12 · 팀장 5 · 본부장 3)가 맞고, 규칙 위반 0건이면 완성
STEP 4 : 마무리와 다음 단계
1단계: 공유 (남는 시간)
2~3명 화면 공유 → “가장 효과 본 프롬프트 1개” 발표
2단계: (선택) Windows 실행파일 만들기
요구사항서.md와 구매요청관리_v3.html을 참고해서 같은 기능의 Python 데스크톱 프로그램을 만들고, PyInstaller --onefile로 Windows 실행파일을 빌드해줘. 데이터 파일은 exe 밖 data 폴더에 두게 해줘.
확인 : exe 더블클릭으로 실행, data/ 샘플이 열리면 성공 (사내 백신이 막을 수 있음)
3단계: 과제
실제 업무 데이터 1주일치(개인정보 제거본)를 v3에 넣어 쓰고, 불편한 점 3가지를 기록 → 다음 개선 프롬프트로 사용