(Claude Code기준이지만 범용으로 사용 가능)

업무 데이터 관리 Tool 개발 방법론 (Claude Code)

핵심 원칙: 원본을 지키고 → 데이터 사전으로 기준을 정하고 → 기획하고 → 작은 단위로 개발하고 → 데이터로 검증하고 → 배포한다.

데이터 관리 Tool의 품질은 화면이 아니라 **“들어온 데이터가 기준에 맞는지 잡아내고, 계산이 맞고, 누가 무엇을 바꿨는지 남는가”**로 결정된다.

이 문서와 4교시 실습 가이드의 관계

4교시 실습 가이드는 이 방법론을 1시간 분량으로 줄인 버전입니다. 실습의 요구사항서.md는 이 문서의 PRD.md, test/ 폴더는 data/test/, v1·v2·v3 단계는 buildplan.md의 개발 단계에 해당합니다. 실제 업무 Tool을 만들 때는 이 문서의 전체 순서를 따릅니다.

0. 전체 흐름

1. Claude 환경 준비
2. 프로젝트 폴더 생성 및 데이터 규칙(CLAUDE.md) 설정
3. 업무 데이터 확보 — 원본·규칙·예외 사례
4. 데이터 정제 — 원본 보존, 민감정보 제거, 형식 통일
5. 데이터 사전 작성 — 열·타입·허용값·계산 규칙·입력 주체 ← 이 방법론의 중심
6. 기획 문서 — PRD.md → design-system.md → wireframe.md → buildplan.md
7. 개발 — 읽기 → 보기 → 계산 → 쓰기 → 검증 → 내보내기
8. 데이터로 검증 — 검산, 오류 데이터 테스트, 왕복(내보내기 → 다시 불러오기) 테스트

1. Claude Code 환경 준비