← 전체 커리큘럼
MODULE 4 · 기획과 설계

PRD와 4개 문서
만들기

간단한 앱은 그냥 만들면 됩니다. 하지만 조금만 복잡해지면 이야기가 달라져요. 직접 만들어보며 그 차이를 느끼고, 복잡한 앱을 위한 설계도 — PRD를 배웁니다.

읽는 데 8분 · WOWD.LAB 바이브코딩

1먼저, 간단한 앱을 그냥 만들어봅니다

설계도 없이, AI와 대화하며 바로

간단한 앱은 굳이 계획을 세울 필요가 없어요. AI에게 말을 걸고, 나온 결과를 보고, 고쳐달라고 하고 — 이렇게 주고받으며(티키타카) 만들면 됩니다. 아래 셋 중 하나를 골라 만들어보세요.

⏱️
타이머
강의·워크숍, 운동, 요리할 때 쓰는 시간 관리 도구.
📅
D-day 카운터
목표일까지 며칠 남았는지 세는 앱.
🎲
랜덤 뽑기
여럿 중 하나를 무작위로 골라주는 도구.

데스크탑 앱의 코드 탭을 열고, 이렇게 말을 걸어보세요.

📋 이렇게 시작하세요 (복사해서 AI에게)
강의나 워크숍에서 시간 관리를 위해 활용할 타이머를 만들어줘. 화면에 바로 보이는 간단한 웹앱으로 만들어줘.

※ D-day나 랜덤 뽑기를 골랐다면 "[무엇]을 위해 [무슨 앱]을 만들어줘" 형식으로 바꿔 쓰면 됩니다. 예: "기념일까지 며칠 남았는지 세는 D-day 앱을 만들어줘."

강의·워크숍용 타이머를 만들어줘. 간단한 웹앱으로.
시간을 설정하고 시작·정지할 수 있는 타이머를 만들었어요. 미리보기를 확인해보세요.
숫자를 더 크게, 끝나면 소리가 나게 해줘
반영했어요. 더 바꾸고 싶은 게 있나요?

어때요? 코드 한 줄 없이 앱이 만들어졌죠. 간단한 앱은 이렇게 설계도 없이 만들어도 충분합니다.

2그런데, 복잡한 앱을 이렇게 만들면?

기능이 늘어나는 순간 문제가 시작됩니다

방금처럼 즉흥적으로 만드는 방식은 간단한 앱까지만 통합니다. 기능이 여러 개가 되고, 기록이 쌓이고, 화면이 늘어나면 — 티키타카만으로는 슬슬 무너져요. 예를 들어 "매일 독서 습관을 돕는 앱"을 즉흥으로 만들다 보면 이런 일이 생깁니다.

😵 설계 없이 복잡한 앱을 만들 때 생기는 일
  • 기능을 추가했더니 잘 되던 기능이 사라진다
  • AI가 내 의도와 다른 방향으로 앱을 바꿔놓는다
  • "다음에 뭘 하려고 했지?" — 진행 상황을 잊어버린다
  • 고칠수록 앱이 커지면서 어디를 손대야 할지 모르게 된다

즉흥적으로 대화만 하면, AI도 나도 "이 앱이 원래 뭘 하려던 것인지"를 계속 잊어버려요. 그래서 복잡한 앱에는 기준이 되는 설계도가 필요합니다.

3앱의 요구사항 명세서(PRD) 만들기

개발하기 전에 설계도부터 준비한다

집을 지을 때 도면 없이 벽돌부터 쌓지 않죠. 앱도 마찬가지예요. PRD(Product Requirements Document, 제품 요구사항 문서)는 "이 앱이 무엇을, 어떻게 해야 하는지" 적어둔 설계도입니다. PRD를 만들어야 앱을 안정적으로 개발할 수 있습니다.

AI와 대화로 기획을 하고 나서, 아래 4개의 문서로 정리하면 됩니다.

PRD
PRDprd.md
앱 개요, 핵심 기능, 하지 않을 것, 화면 설계, 데이터 구조, 우선순위.
AI에게 개발 지시사항을 정확하게 전달한다
원칙
개발 원칙CLAUDE.md / AGENTS.md
기술 스택, 코딩 규칙, 지켜야 할 것. AI가 작업 전에 자동으로 읽는 문서.
AI가 일관된 원칙으로 작업한다
소개
READMEreadme.md
앱 이름, 무엇을 하는 앱인지, 실행 방법.
이 앱이 무엇을 하는 앱인지 소개한다
진행
진행 상태current_status.md
완료한 것 / 진행 중 / 다음 단계 / 미결정 이슈.
현재 작업 과정의 맥락을 기록한다
💡 WOWD.LAB Insight — current_status.md가 특히 중요한 이유

진행 상태 문서가 없으면 이런 일이 벌어집니다. AI는 이전 대화를 완벽히 기억하지 못해요. 그래서 진행 기록이 없으면, AI는 지금까지 만들어진 결과물(코드)만 보고 상황을 짐작합니다. "무엇을, 왜, 어떤 순서로 했는지"라는 과정이 통째로 빠지는 거예요.

그 결과 — 엉뚱한 곳을 고치고, 잘 되던 기능을 없애버리고, 이미 끝낸 일을 다시 하는 일이 반복됩니다. 그래서 한 단계 끝날 때마다 진행 상황을 기록해두면, AI가 그 문서를 읽고 "어디까지 됐고 다음에 뭘 할지"를 정확히 이어갈 수 있어요.

💡 도구마다 개발 원칙 파일 이름이 다릅니다

개발 원칙 문서는 어떤 AI 도구를 쓰느냐에 따라 파일 이름이 달라요.

Claude Code를 쓰면 → CLAUDE.md
Codex를 쓰면 → AGENTS.md

내용은 같아도 됩니다. 다만 내가 쓰는 도구에 맞는 이름으로 만들어야 그 도구가 자동으로 읽어요. 두 도구를 오갈 계획이면 둘 다 만들어두면 됩니다.

🗄️ 이때 "데이터 저장 방식"도 미리 정합니다

PRD의 데이터 구조를 정할 때, "이 앱이 데이터를 어디에 저장할지"도 함께 판단하세요. 크게 두 가지예요.

혼자 쓰는 앱 — 처음엔 브라우저에만 저장해도 충분합니다. (예: 내 독서 기록)

여럿이 함께 쓰거나, 여러 기기에서 봐야 하는 앱 — 처음부터 DB(Supabase)가 필요합니다. (예: 설문 수집, 팀 공유 게시판)

혼자 쓰는 앱이라면 "지금은 브라우저에 저장하고, 나중에 DB로 바꿀 수 있게 만들어줘"라고 PRD에 적어두면, 필요해질 때 수월하게 전환할 수 있어요. (DB 연결은 7장에서 다룹니다)

4PRD도 AI와 함께 만듭니다

완벽하게 설계하고 시작하지 않아도 됩니다

"PRD를 완벽하게 써야 한다"고 생각하면 시작조차 못 해요. 그럴 필요 없습니다. AI가 먼저 질문하게 만들면 됩니다. 내가 답을 하다 보면 기획이 저절로 구체화돼요. 핵심은 AI에게 "질문해줘"라고 요청하는 것입니다.

예를 들어 "매일 10분씩 꾸준히 독서하게 돕는 앱"을 만들고 싶다고 해볼게요. 이럴 때 이렇게 시작합니다.

📋 기획을 위한 질문을 요청하기 (복사해서 AI에게)
매일 10분씩 꾸준히 독서하게 돕는 앱을 만들고 싶어. 아직 기획이 구체적이지 않으니, 너와 대화하면서 정리하고 싶어. 바로 만들지 말고, 먼저 나에게 질문을 해줘. - 이 앱을 누가, 어떤 상황에서 쓰는지 - 지금 어떤 불편을 겪고 있는지 - 무엇이 해결되면 좋겠는지 이런 맥락을 파악할 수 있는 질문을 한 번에 하나씩 해줘. 내 답을 모아서 기획안으로 정리해줘.

이렇게 요청하면 AI가 문제와 맥락을 파고드는 질문을 던져요. 그 질문에 답하는 것만으로 기획이 또렷해집니다.

매일 10분씩 독서하게 돕는 앱을 만들고 싶어. 먼저 질문해줘.
좋아요. 먼저 — 이 앱은 누가 쓰나요? 본인이 쓸 건가요, 아니면 다른 사람도요?
나 같은 사람. 책은 사는데 며칠 읽다 마는 사람.
그럼 지금은 왜 며칠 읽다 마는 걸까요? 시간이 없어서인가요, 습관이 안 잡혀서인가요?
습관이 문제야. 오늘 읽었는지도 잘 기억 안 나고.
그렇군요. 그럼 "오늘 읽었다"를 눈으로 확인하는 게 중요하겠네요. 며칠 연속 읽었는지 보여주면 도움이 될까요?
맞아! 연속 며칠 했는지 보이면 안 끊고 싶어질 것 같아.
좋습니다. 그럼 핵심은 "매일 10분 기록 + 연속 일수 표시"로 좁혀지네요. 이걸 기획안으로 정리해볼게요.

보셨듯이, AI의 질문에 답하는 것만으로 "막연한 아이디어"가 "구체적인 기획"으로 바뀝니다. 1장에서 배운 문제 정의(누가·무엇을·왜)가 바로 이 대화의 뼈대예요. 대화가 끝나면 "지금까지 내용을 prd.md, 개발 원칙(CLAUDE.md 또는 AGENTS.md), readme.md, current_status.md 4개 문서로 정리해줘"라고 하세요.

💡 WOWD.LAB Insight

좋은 앱은 좋은 질문에서 나옵니다. AI에게 답을 재촉하기보다 "질문을 해달라"고 하세요. AI와 티키타카 대화를 하면서 무엇이 필요한지 명확하게 정의해 나가세요.

5이제, 당신의 앱을 설계해보세요

1장에서 정한 그 문제로

연습은 끝났어요. 이제 당신이 풀고 싶은 진짜 문제로 앱을 설계할 차례입니다. 1장에서 정리한 문제 정의(POV)를 꺼내, 위와 같은 방식으로 AI와 대화하며 4개 문서를 만들어보세요.

📋 내 앱 문서 만들기 (복사해서 AI에게)
내가 풀고 싶은 문제는 이거야: [1장에서 정리한 POV — 누구의 / 무엇이 필요한가 / 왜] 이 문제를 푸는 앱을 만들고 싶어. 바로 만들지 말고, 먼저 나에게 맥락을 파악하는 질문을 하나씩 해줘. 내 답을 모아서 아래 4개 문서로 정리해줘. - prd.md - 개발 원칙 (CLAUDE.md 또는 AGENTS.md) - readme.md - current_status.md

6참고 — 완성된 문서 예시

시간이 없다면 이걸로 시작하세요

아래는 독서 습관 앱의 완성된 문서 예시입니다. 직접 만들 시간이 없다면 이걸 내려받아 내 앱에 맞게 고쳐 써도 됩니다. "좋은 문서는 이렇게 생겼다"는 참고로도 보세요.

📄 독서 습관 앱 · 문서 예시 4종
필요한 것만 받거나, 한 번에 모두 받으세요

※ 이 예시는 참고용입니다. 그대로 쓰기보다, 내 문제에 맞게 고쳐 쓰는 것이 핵심이에요. 특히 "하지 않을 것"은 내 앱 상황에 맞게 다시 정하세요.

핵심 요약
  • 간단한 앱은 설계도 없이 티키타카로 만들어도 된다.
  • 복잡한 앱은 즉흥으로 만들면 기능이 사라지고 방향을 잃는다.
  • 그래서 AI와 대화로 기획하고, 그 내용을 4개 문서로 정리한다.
  • 문서는 AI가 먼저 질문하게 만들며 만든다. 빈 양식을 혼자 채우지 않는다.
  • 개발 원칙 파일은 도구에 따라 이름이 다르다 — CLAUDE.md / AGENTS.md.

이제 설계도(문서)가 준비됐습니다. 다음 모듈에서는 이 문서를 AI에게 읽히고, 개발 계획을 세워 한 단계씩 실제로 앱을 만듭니다.