4회차 가이드 | 몰입 개발 ①

수업 전에 읽어보세요

오늘부터 이틀은 만들기만 합니다

🎯 오늘의 목표

새로운 도구도, 새로운 개념도 없습니다. 3회차까지 배운 것만으로 충분해요. 오늘과 내일은 오직 내 앱의 완성도를 올리는 데만 씁니다.

📅 내일(10/24 토)까지 연속입니다

오늘 못 끝낸 건 내일 바로 이어서 합니다. 이틀을 하나로 보고 계획을 세우세요. 오늘은 큰 덩어리, 내일은 다듬기로 나누면 좋아요.

⚠️ 2주 만입니다

3회차(10/9) 이후 2주가 지났어요. "내가 어디까지 했더라"부터 시작합니다. 그래서 오늘 첫 20분은 복구 세션이에요. 당황하지 마세요, 다 같이 합니다.

💡 오늘의 마음가짐

새 기능을 욕심껏 붙이는 것보다 있는 기능이 제대로 돌아가게 만드는 것이 훨씬 가치 있습니다. 심사 기준에서도 완성도와 활용 가능성이 가장 큰 비중을 차지해요.

오늘 흐름

이렇게 진행됩니다

15:00 ~ 15:20

🔄 복구 세션

current_status.md 읽기, 내 앱 다시 써보기, 상태 파악

📌 복구 방법 →

15:20 ~ 15:40

🎯 이틀치 목표 정하기

남은 작업을 Must / Should / Could로 나누기

📌 목표 정하기 →

15:40 ~ 16:30

⚡ 개발 몰입 ①

Must 항목부터 차례로

📌 개발 요령 →

16:30 ~ 16:40

☕ 쉬는 시간

16:40 ~ 17:40
⚡ 개발 몰입 ②
계속 진행. 중간에 강사가 한 바퀴 돌며 막힌 곳 확인

17:40 ~ 18:00

📌 마무리 & 내일 계획

커밋&푸시, current_status.md 갱신, 내일 할 것 정하기

🎯 오늘의 최소 목표

Must 항목 중 최소 1개 완료 + 커밋&푸시 + current_status 갱신. 오늘 다 못 해도 내일이 있습니다. 조급해하지 마세요.

2주 만에 돌아오면 사람도 AI도 다 잊어버립니다. 순서대로 따라하면 5분이면 복구돼요.

1

VS Code로 프로젝트 폴더 열기

폴더 위치가 기억 안 나면 GitHub Desktop → 내 저장소 선택 → Repository > Show in Explorer

2

Claude Code 연결 후 상황 읽히기

복구 프롬프트

이 폴더의 CLAUDE.md, prd.md, current_status.md를 읽고 지금까지 뭘 만들었고 다음에 뭘 해야 하는지 정리해줘. 그리고 아직 구현 안 된 기능이 뭔지도 알려줘.

3

배포된 내 앱 직접 써보기

URL을 열어서 모든 버튼을 눌러보세요.

· 빈 값으로 제출하면?
· 이상한 값을 넣으면?
· 데이터가 많아지면 화면이 어떻게 되나?
· 휴대폰에서 열면 잘 보이나?

깨지는 지점을 메모하세요. 오늘 고칠 목록입니다.

🚨 앱이 안 열리거나 망가져 있다면? 당황하지 말고 강사를 부르세요. GitHub의 History에서 잘 되던 시점으로 되돌릴 수 있습니다. 그러려고 커밋을 한 거예요.

남은 작업을 전부 나열한 다음, 세 칸으로 나누세요. 이게 오늘 개발 속도를 결정합니다.

Must

이게 없으면 앱이 성립 안 됨. 핵심 기능 중 아직 안 된 것, 지금 깨져 있는 것. → 오늘 반드시

Should

있으면 확실히 좋아짐. 사용성 개선, 자주 쓰는 보조 기능. → 내일까지

Could

여유 있으면. 욕심나는 기능, 디자인 다듬기. → 6회차 이후에

목표 정리 프롬프트

지금 앱 상태를 기준으로, 남은 작업을 Must / Should / Could 세 단계로 나눠줘. 내가 직접 써보고 발견한 문제는 이거야: - [문제 1] - [문제 2] Must는 3개를 넘지 않게 해줘. 이틀 안에 끝낼 수 있는 분량으로.

💡 Must는 3개를 넘기지 마세요

욕심내면 다 못 끝내고 어느 것도 완성이 안 됩니다. 3개를 확실히 끝내는 게 10개를 어설프게 만드는 것보다 훨씬 낫습니다.

✅ 목록이 나왔다면

PRD에도 반영해두세요. "prd.md에 오늘 정한 Must/Should/Could를 반영해줘"라고 요청하면 됩니다.

기본 리듬 — 한 번에 하나씩

1

Must 항목 하나를 고른다

여러 개를 한꺼번에 요청하지 마세요. AI가 헷갈려서 엉뚱한 걸 만듭니다.

2

구체적으로 요청한다

기능 추가 프롬프트

[기능 이름]을 추가해줘. 동작 방식: - [사용자가 무엇을 하면] - [무엇이 일어나야 하는지] - [예외 상황에서는 어떻게] 기존 기능은 그대로 두고 자연스럽게 추가해줘.

3

만들어지면 바로 눌러본다

AI가 "완료했습니다"라고 해도 믿지 마세요. 내가 직접 눌러봐야 진짜 되는지 압니다. 정상 흐름만 말고 빈 값·이상한 값도 넣어보세요.

4

작동하면 즉시 커밋 & 푸시

기능 하나가 제대로 되면 바로 저장하세요. "안전지대"를 만들어두는 거예요.

GitHub Desktop → Summary에 "OO 기능 추가" → Commit to main → Push origin

💡 커밋해두면 다음 작업에서 망가져도 여기로 돌아올 수 있어요. 겁 없이 실험할 수 있는 이유가 이겁니다.

자주 쓰는 요청 모음

🔧 버그 고치기

[이 상황]에서 [이런 문제]가 생겨. 브라우저 콘솔 에러는 이거야: [F12 → Console 탭 내용 붙여넣기] 원인을 찾아서 고쳐줘.

📱 모바일에서 잘 보이게

휴대폰 화면에서 봤을 때 [어디가] 불편해. 모바일에서 보기 좋게 개선해줘. 글씨 크기, 버튼 크기, 여백을 손가락으로 쓰기 편하게 조정해줘.

🛡️ 예외 처리 추가

빈 값으로 제출하거나 잘못된 값을 넣었을 때 앱이 멈추지 않고 안내 문구를 보여주도록 해줘. 어떤 경우들을 처리했는지도 알려줘.

🎨 디자인은 "예쁘게 해줘"가 아니라 "골라줄게" "예쁘게 해줘"라고만 하면 AI가 자기 취향대로 바꿔버립니다. 그러면 마음에 안 들어도 뭐라고 고쳐야 할지 모르겠어요.

대신 "3가지 스타일을 제안해줘, 내가 고를게"라고 하세요. 선택지를 받아서 방향은 내가 정합니다.

🎨 디자인 — 3가지 제안 받기 (추천)

전체 화면 디자인을 다듬고 싶어. 바로 바꾸지 말고, 서로 확실히 다른 스타일 3가지를 제안해줘. 각각 어떤 느낌인지 한 줄로 설명하고, 내가 고르면 그걸로 적용해줘. 부대에서 업무용으로 쓸 앱이라는 걸 감안해줘.

🎨 디자인 정리 (바로 적용해도 될 때)

전체 화면의 색상과 글꼴을 통일감 있게 정리해줘. 너무 화려하지 않고 업무용으로 쓰기 좋은 차분한 톤으로. /mnt/skills/public/frontend-design/SKILL.md 가이드라인을 참고해줘.

🤔 뭘 더 해야 할지 모르겠을 때

지금 앱 상태를 보고, 실제 사용자 입장에서 가장 불편하거나 빠져있는 부분 3가지만 냉정하게 알려줘. 중요하지 않은 건 말하지 마.

막힐 때

이렇게 대처하세요

고쳐달라고 했는데 자꾸 다른 게 망가져요

AI가 맥락을 잃었을 가능성이 큽니다.

① 일단 마지막으로 잘 되던 커밋으로 되돌리기 (강사 도움 요청)
② 새 대화를 시작하고 current_status.md부터 읽히기
③ "건드리면 안 되는 것"을 명시해서 요청하기

예: "OO 기능은 잘 작동하니까 절대 건드리지 말고, △△만 고쳐줘"

같은 에러가 계속 반복돼요

같은 방식으로 3번 요청했는데 안 되면 접근을 바꿔야 합니다.

"이 방법으로 3번 시도했는데 계속 같은 에러가 나. 다른 접근 방법으로 해결할 수 있을까? 2가지 대안을 제안해줘."

그래도 안 되면 강사를 부르세요. 혼자 30분 이상 붙잡고 있지 마세요.

Supabase 연결이 안 돼 있어요 (3회차에 못 끝냄)

3회차 가이드의 Supabase 섹션을 따라하시고, 막히면 강사에게 요청하세요. 오늘 시간을 좀 써서라도 연결해두는 게 좋습니다.

기능이 너무 많아서 시간 안에 못 끝낼 것 같아요

범위를 줄이는 건 실패가 아니라 설계 판단입니다. Must 3개만 확실히 끝내고 나머지는 Could로 내리세요. 발표에서도 "이건 다음 단계로 남겨뒀습니다"라고 말하면 됩니다.

AI가 계속 멈춰요

채팅창에 "계속해줘" 또는 "이어서 완성해줘"를 입력하세요. 긴 작업은 여러 번 나눠서 진행됩니다.

앱이 너무 꼬여서 손댈 수가 없어요

완전히 새로 시작해도 됩니다. 이건 후퇴가 아니라 선택지예요.

꼬인 앱을 억지로 살리려고 30분을 쓰는 것보다, 새 폴더에 문서부터 다시 준비해서 처음부터 만드는 게 빠를 때가 있습니다. 어차피 PRD와 current_status.md가 있으니 재료는 그대로 남아 있어요. 2회차에 했던 것보다 훨씬 빨리 갑니다.

새로 시작하는 순서
① 기존 폴더는 지우지 말고 그대로 둡니다 (비교용)
② 새 폴더를 만들고 prd.md · CLAUDE.md · current_status.md를 복사해 넣습니다
③ "이 문서들을 읽고, 처음부터 다시 만들어줘. 한 단계씩 진행하자"로 시작

판단 기준 — 같은 에러를 3번 이상 고쳐도 안 잡히면, 새로 시작을 검토하세요. 결정이 어려우면 강사에게 물어보면 됩니다.

마무리

내일을 위한 정리

📌 나가기 전에 반드시 3가지

① 커밋 & 푸시 — 오늘 작업 저장
② current_status.md 갱신 — 내일 이어서 시작하려면 필수
③ 내일 할 것 1순위 정하기 — 내일 바로 시작할 수 있게

마무리 갱신 프롬프트

current_status.md를 업데이트해줘. 아래 4개 항목으로 정리해줘. ## 지금 상태 ## 오늘 한 것 ## 다음에 할 것 (내일 1순위부터) ## 건드리면 안 되는 것 (잘 작동하는 기능) 오늘은 [한 작업]을 완료했어.

📌 갱신 후 커밋 + 푸시까지! 안 하면 저장이 안 됩니다.

⏰ 내일은 10/24(토) 13:00~16:00

오늘 이어서 바로 갑니다. 오늘 정한 내일 1순위부터 시작하면 워밍업 없이 바로 몰입할 수 있어요.

오늘 체크리스트

current_status.md로 지난 작업을 복구했다
내 앱을 직접 써보고 문제를 찾았다
남은 작업을 Must / Should / Could로 나눴다
Must 항목을 최소 1개 완료했다
기능이 완성될 때마다 커밋했다
푸시해서 배포된 앱에 반영했다
current_status.md를 갱신하고 푸시했다
내일 할 것 1순위를 정했다

설문

오늘 수업, 어떠셨나요?

1분이면 끝나는 짧은 설문입니다. 여러분의 솔직한 피드백이 다음 수업을 더 좋게 만듭니다. 꼭 참여해 주세요!

📋 4주차 설문 참여하기 →