Claude에게 앱을 발주한다

요구사항을 설계로 바꾸는 법 — 코딩 없이 앱 기획하기

클로드의 친구 · 2026-04-18

◀ S2-EP 12: 반복 업무 사냥꾼 | 📚 S2-EP 13 | S2-EP 14: 근태 앱 뼈대 세우기 ▶

1. Phase 5가 시작됩니다 — 실전 프로젝트

EP00부터 EP12까지 우리는 Claude를 생산성 도구로 활용하는 방법을 배웠습니다. 이메일, 회의록, 보고서, 분석, 루틴 자동화까지. 이제 Phase 5에서는 한 걸음 더 나아갑니다. Claude와 함께 실제로 작동하는 웹 앱을 만들어봅니다.

"앱 개발은 개발자가 하는 것 아닌가요?" 맞습니다. 지금까지는 그랬습니다. 하지만 Claude를 활용하면 비개발자도 실제 앱을 만들 수 있습니다. 코딩을 모르더라도 어떤 앱을 만들고 싶은지, 어떻게 동작해야 하는지를 명확하게 설명할 수 있다면 충분합니다.

EP13은 실제 개발 전 단계인 요구사항 설계를 다룹니다. 막연한 아이디어를 Claude가 개발할 수 있는 명확한 명세로 바꾸는 과정입니다.

EP13~EP15 실전 프로젝트 개요

EP13: 요구사항 정의 → 설계 명세 작성 (오늘)
EP14: 근태 앱 1편 — DB 설계, 회원가입, 로그인 구현
EP15: 근태 앱 2편 — 출퇴근 기록, 휴가 신청, QR 보안 완성

사용 도구: Claude + HTML/CSS/JavaScript (브라우저에서 바로 실행) + LocalStorage

2. 나쁜 발주 vs 좋은 발주

개발자에게 앱을 맡길 때 가장 흔한 실패 원인은 불명확한 요구사항입니다. "근태 관리 앱 만들어주세요"는 나쁜 발주입니다. Claude에게 개발을 맡길 때도 마찬가지입니다.

❌ 나쁜 발주

"직원 출퇴근 관리 앱 만들어줘"
"로그인 기능 넣고 관리자 페이지도 있으면 좋겠어"
"나중에 추가 기능도 붙일 수 있게 해줘"

✅ 좋은 발주

사용자 역할 2가지(직원/관리자), 기능 5개 명시, 화면 목록 7개 정의, 데이터 항목 구체화, 예외 케이스 포함

좋은 발주를 하려면 생각이 많이 필요합니다. 그런데 이 생각 자체를 Claude와 함께 할 수 있습니다. "내가 만들고 싶은 앱은 이런 건데, 발주서를 잘 쓰려면 어떤 것들을 결정해야 하지?"라고 물어보면 됩니다.

3. 요구사항 정의 — 5가지 질문

앱을 발주하기 전에 반드시 답해야 할 5가지 질문입니다. 이 질문들에 답하는 과정이 곧 요구사항 정의입니다.

Q1. 누가 쓰는가? (사용자와 역할)

사용자가 한 종류인가, 여러 역할이 있는가. 각 역할이 볼 수 있는 것과 할 수 있는 것이 다르다면 권한 관리가 필요합니다.
예: 직원(자신의 기록 조회), 팀장(팀 전체 조회), 관리자(전체 관리)

Q2. 무엇을 할 수 있어야 하는가? (핵심 기능)

기능 목록을 만들되 "있으면 좋은 것"과 "반드시 있어야 하는 것"을 구분합니다. 처음에는 반드시 필요한 것만 만들고 나중에 추가합니다 (MVP 원칙).

Q3. 어떤 데이터를 저장하는가? (데이터 구조)

앱이 다루는 정보의 종류와 항목을 정의합니다. 예: 직원(ID, 이름, 부서, 역할), 출퇴근(직원ID, 날짜, 출근시각, 퇴근시각, 상태)

Q4. 화면이 몇 개 필요한가? (페이지 목록)

앱의 각 화면을 나열하고 각 화면에서 무엇을 보고 할 수 있는지를 정의합니다. 화면 목록이 개발 범위를 결정합니다.

Q5. 예외 케이스는 어떻게 처리하는가?

"출근을 두 번 찍으면?", "퇴근 없이 날이 넘어가면?", "과거 날짜 수정이 필요하면?" — 예외 케이스를 미리 정의하지 않으면 개발 중에 계속 막힙니다.

4. Claude와 함께 요구사항 명세 작성하기

5가지 질문에 대한 초안이 생겼다면, Claude와 함께 명세를 구체화합니다. Claude는 빠진 것을 찾아주고, 모호한 것을 명확하게 만들어줍니다.

나는 우리 회사(직원 30명)용 근태 관리 웹앱을 만들려고 해.
아래 내가 생각한 것들을 보고 빠진 것, 모호한 것, 추가로 결정해야 할 것을 알려줘.
그리고 완전한 요구사항 명세서(PRD)를 작성해줘.

=== 내가 생각한 기능 ===
- 직원이 출근/퇴근 버튼을 누르면 시간이 기록됨
- 관리자는 전체 직원의 출퇴근 내역을 볼 수 있음
- 휴가 신청 기능 (직원이 신청, 관리자가 승인/거절)
- 월별 근무 시간 집계

=== 기술 조건 ===
- 브라우저에서 바로 실행 (서버 없이)
- HTML + JavaScript로 구현
- 데이터는 브라우저 LocalStorage에 저장

이 프롬프트를 넣으면 Claude가 빠진 것들을 찾아줍니다. 예를 들어: "로그인 방식은? 비밀번호 저장은? 초과 근무 기준은? 반차/반반차 구분은? 관리자 계정은 누가 만드는가?" 같은 것들입니다.

5. 근태 앱 최종 요구사항 명세

EP14~EP15에서 실제로 만들 앱의 확정된 명세입니다. Claude와 대화를 통해 완성된 버전입니다.

앱 이름: 팀근태 (TeamAttend)

사용자 역할 2가지
· 직원(employee): 자신의 출퇴근 기록, 휴가 신청, 본인 내역 조회
· 관리자(admin): 전체 직원 관리, 출퇴근 내역 조회, 휴가 승인/거절, 월별 리포트

핵심 기능 (MVP)
1. 로그인/로그아웃 (ID+비밀번호, LocalStorage 저장)
2. 출근 기록 (버튼 클릭 → 현재 시각 저장)
3. 퇴근 기록 (버튼 클릭 → 현재 시각 저장, 근무 시간 자동 계산)
4. 휴가 신청 (날짜, 유형 선택: 연차/반차/병가)
5. 관리자 승인/거절
6. 월별 근무 시간 집계 및 조회
7. QR 코드 출퇴근 (보안 강화: 관리자 QR로만 기록 가능)

화면 목록 (7개)
· 로그인 화면 / 직원 대시보드 / 출퇴근 기록 화면 / 내 근태 내역 / 휴가 신청 화면 / 관리자 대시보드 / 관리자 직원 관리

데이터 구조
· users: {id, name, department, role, password}
· attendance: {userId, date, checkIn, checkOut, workMinutes, status}
· leaves: {id, userId, startDate, endDate, type, reason, status, approvedBy}

예외 처리
· 이미 출근 기록이 있는 날 다시 출근 시도 → 경고 메시지
· 퇴근 없이 자정 초과 → 다음날 첫 접속 시 알림
· 과거 날짜 수정 → 관리자만 가능

6. 개발 순서 설계 — 어떻게 쪼갤 것인가

명세가 완성되면 어떤 순서로 개발할지를 정합니다. 한 번에 전체를 만들려 하면 실패합니다. 작동하는 작은 버전부터 시작해서 기능을 붙여나가는 것이 핵심입니다.

팀근태 앱 개발 순서 (Claude에게 요청한 결과)

1단계 (EP14): 뼈대
  - LocalStorage 기반 데이터 저장 구조
  - 로그인/로그아웃 (관리자 1명, 직원 3명 기본 데이터)
  - 역할별 대시보드 라우팅

2단계 (EP14 계속): 핵심 기능
  - 출근/퇴근 버튼 + 시각 저장
  - 내 근태 내역 조회 (캘린더 형식)
  - 회원 가입 (관리자가 직원 추가)

3단계 (EP15): 완성
  - 휴가 신청 + 관리자 승인 워크플로우
  - 월별 근무 시간 집계
  - QR 코드 출퇴근 (Canvas API)
  - 전체 UI 다듬기

7. 실습 — 나만의 앱 발주서 작성하기

지금 여러분이 업무에서 필요하다고 느끼는 작은 도구가 있습니까? 그것을 앱으로 만든다면 어떤 명세가 필요할지 Claude와 함께 작성해봅니다.

나는 [앱 아이디어를 한 문장으로]을 만들고 싶어.

이 앱의 요구사항 명세를 작성해줘.
다음 항목을 포함해서:

1. 사용자 역할과 각 역할의 권한
2. 핵심 기능 목록 (Must Have / Nice to Have 구분)
3. 화면 목록과 각 화면의 주요 요소
4. 데이터 구조 (저장해야 할 것들)
5. 예외 케이스 3가지 이상
6. 브라우저에서 바로 실행 가능한 기술 스택 추천

아이디어:
[내 아이디어 설명]

아이디어 예시

· 팀 공유 스니펫 저장소 (자주 쓰는 문구/템플릿 팀이 공유)
· 고객 미팅 로그 앱 (미팅 날짜, 참여자, 논의사항, 다음 액션)
· 프로젝트 일일 진행 로그 (누가 오늘 무엇을 했는지 기록)
· 팀 도서 대여 관리 시스템
· 소규모 재고 관리 앱