프로젝트로 배우기: 만들면서 실력 쌓기

강의를 열 개 듣는 것보다 작은 것 하나를 끝까지 만드는 게 실력이 더 늘어요. 튜토리얼만 따라 하다 제자리를 맴도는 이유, 내 문제에서 출발해 끝낼 수 있는 크기로 주제 고르기, 단계별 프로젝트 예시, 가장 작은 쓸모 있는 버전부터 만드는 계획, 끝에서 끝까지 얇게 먼저 잇기, 막혔을 때의 순서와 AI를 선생님으로 쓰는 법, 완성하고 기록하고 돌아보는 법까지 4주짜리 예시 계획과 함께 정리해요.

중급강의 6 / 6약 8분

이 가이드북의 강의들은 개념을 하나씩 떼어 내서 보여 줘요. 그런데 실제 프로그램은 그 개념들이 한데 엉켜 있어요. 데이터를 어디에 저장할지, 오류가 나면 어떻게 할지, 화면은 어떻게 보일지를 동시에 정해야 해요. 이 엉킴을 다루는 힘은 강의만으로는 생기지 않고, 직접 만들어 봐야 생겨요.

튜토리얼만으로는 늘지 않는 이유

튜토리얼을 따라 하면 잘 돌아가는 결과물이 나와요. 뿌듯하지만, 막상 빈 화면 앞에 혼자 앉으면 무엇부터 해야 할지 모르겠어요. 많은 사람이 그래서 또 다른 튜토리얼을 찾고, 이 고리를 맴돌아요. 개발자들 사이에서 튜토리얼 지옥이라고 부르는 상태예요.

이유는 간단해요. 튜토리얼은 결정을 대신 내려 줘요. 어떤 라이브러리를 쓸지, 파일을 어떻게 나눌지, 다음에 무엇을 할지 모두 정해져 있어요. 실력의 큰 부분은 바로 그 결정을 내리는 힘인데, 따라 하기만 하면 그 연습을 못 해요. 프로젝트는 결정을 내가 내리게 만들어요. 그래서 힘들고, 그래서 늘어요.

주제 고르기

좋은 첫 프로젝트에는 세 가지 조건이 있어요.

  1. 내 문제에서 출발해요. "매달 카드값 정리가 귀찮다", "공부한 걸 기록할 곳이 필요하다"처럼 내가 실제로 겪는 문제면, 무엇이 필요한지 스스로 알고 끝까지 갈 동기도 생겨요. 남이 정해 준 주제보다 훨씬 오래 버텨요.
  2. 끝낼 수 있는 크기예요. 첫 프로젝트로 "쇼핑몰 만들기"는 너무 커요. 2주에서 4주 안에 쓸 수 있는 형태가 나오는 크기로 시작해요. 다 만들고 나서 키우면 돼요.
  3. 새것은 조금만 섞어요. 아는 것이 대부분이고 새로 배울 것이 한두 가지인 정도가 좋아요. 언어, 프레임워크, 데이터베이스, 배포를 모두 처음 하면 어디서 막혔는지조차 알기 어려워요.

단계별 예시

단계프로젝트 예시주로 쓰는 트랙
입문숫자 맞히기 게임, 단위 변환기, 내려받은 파일을 종류별로 정리하는 스크립트프로그래밍
초급파일에 저장되는 할 일 목록, 가계부 CSV 분석, 한 장짜리 소개 웹페이지 배포프로그래밍, 웹
중급로그인과 데이터베이스가 있는 웹 서비스, 매일 데이터를 모아 기록하는 파이프라인, 작은 API 서버웹, 데이터베이스, 서버, AI 엔지니어링
고급내 문서를 아는 RAG 챗봇, 정해진 조건이 되면 알려 주는 알림 서비스, 느린 서비스를 재서 빠르게 만들기LLM, AI 엔지니어링, 알고리즘

목록의 예시를 그대로 하기보다, 내 문제에 맞게 바꾸면 더 좋아요. "할 일 목록"도 "공부 시간까지 기록하는 할 일 목록"이 되면 나만의 프로젝트가 돼요.

계획하기: 가장 작은 쓸모 있는 버전

계획의 핵심은 가장 작은 쓸모 있는 버전을 정하는 거예요. 흔히 MVP(최소 기능 제품)라고 불러요. "이것만 되면 내가 실제로 쓸 수 있다"는 가장 작은 기능 묶음이에요.

  1. 한 문장 목표: "카드 내역 CSV를 넣으면 이번 달 항목별 지출이 나온다."
  2. 하고 싶은 기능 모두 적기: 그래프, 월별 비교, 예산 알림, 로그인, 휴대폰 앱...
  3. 잘라 내기: 목표 문장에 꼭 필요한 것만 남겨요. 위 예시라면 "CSV 읽기, 항목 분류, 합계 출력" 세 가지예요. 나머지는 다음에 할 일 목록으로 옮겨요. 지우는 게 아니라 미루는 거예요.
  4. 주 단위로 나누기: 한 주에 하나씩 눈에 보이는 결과가 나오게 쪼개요.

할 일은 GitHub 저장소의 이슈(Issues)에 하나씩 적어 두면, 무엇을 했고 무엇이 남았는지 한눈에 보여요. Git 강의의 커밋 메시지에 이슈 번호를 적으면 둘이 연결돼요.

4주짜리 예시 계획

주목표끝나면 할 수 있는 것
1주카드 내역 CSV를 읽어 이번 달 합계 출력터미널에서 실행하면 총액이 나와요
2주가맹점 이름으로 항목(식비, 교통, 쇼핑) 분류항목별 합계가 나와요. 분류 안 된 것은 따로 보여요
3주결과를 간단한 웹 페이지로 보여 주기브라우저에서 표로 봐요
4주정리, README, 배포남에게 보여 줄 수 있어요

2주차의 "분류 안 된 것은 따로"에 주목하세요. 데이터 파이프라인 강의의 격리와 같은 생각이에요. 앞에서 배운 것들이 프로젝트에서 이렇게 다시 나와요.

만들기: 끝에서 끝까지 얇게 먼저

흔한 실수는 한 부분을 완벽하게 만들고 다음으로 넘어가는 거예요. 화면을 두 주 동안 다듬었는데, 데이터를 저장하려고 보니 구조를 다 바꿔야 하는 식이에요. 대신 처음부터 끝까지를 얇게 먼저 이어요. 입력을 받고, 아주 단순하게 처리하고, 결과를 내보내는 길을 엉성하게라도 한 번 뚫어요. 그다음에 각 부분을 두껍게 만들어요. 전체 구조의 문제를 일찍 발견할 수 있어요.

만드는 동안의 습관이에요.

  • 작게 자주 커밋해요: 잘 되던 시점으로 언제든 돌아갈 수 있어요(Git 강의).
  • README를 일찍 써요: 무엇을 하는 프로그램인지, 어떻게 설치하고 실행하는지 적어요. 쓰다 보면 설계가 정리되고, 몇 주 쉬었다 돌아온 나에게도 큰 도움이 돼요.
  • 일찍 배포해요: 다른 사람이 쓸 수 있는 곳에 일찍 올려 보면, 내 컴퓨터에서만 되던 문제가 일찍 드러나요.
  • 중요한 부분은 시험을 써요: 돈 계산, 날짜 처리처럼 틀리면 곤란한 부분부터요(읽기 쉬운 코드 강의).

README는 이 정도면 충분해요.

# 카드값 정리기

카드사에서 내려받은 내역 CSV를 넣으면 이번 달 항목별 지출을 보여 줘요.

## 실행하기
pip install -r requirements.txt
python main.py 내역.csv

## 만든 이유와 고민한 점
- 가맹점 이름이 제각각이라, 낱말 목록으로 먼저 분류하고 안 되는 건 따로 모았어요.
- 금액은 부동소수점 오차가 없게 원 단위 정수로 계산해요.

## 다음에 할 일
- 월별 비교 그래프

막혔을 때의 순서

프로젝트를 하면 반드시 막혀요. 막히는 게 정상이고, 그때가 가장 많이 배우는 순간이에요. 순서를 정해 두면 덜 헤매요.

  1. 오류 메시지를 끝까지 읽어요. 트레이스백을 아래에서 위로(디버깅 강의).
  2. 문제를 작게 재현해요. 프로젝트 전체가 아니라 문제가 나는 가장 작은 코드로 줄여요.
  3. 공식 문서를 봐요. 내 버전의 레퍼런스부터요(문서 읽기 강의).
  4. 시간을 정해요. 30분에서 1시간 혼자 해도 안 되면 물어봐요. 좋은 질문의 여섯 가지 재료를 챙겨서요.
  5. 잠시 떠나요. 산책하고 돌아오면 보이는 경우가 놀랄 만큼 많아요.

AI를 선생님으로 쓰기

AI는 프로젝트의 든든한 도우미예요. 하지만 쓰는 방식에 따라 실력이 늘기도 하고, 안 늘기도 해요.

  • 설명을 부탁해요: "이 코드를 짜 줘"보다 "이 오류가 왜 나는지 설명해 줘", "이 두 방법의 장단점은?"이 더 많이 배워요.
  • 모든 줄을 이해해요: AI가 준 코드를 붙여 넣었다면, 한 줄씩 무엇을 하는지 내 말로 설명할 수 있어야 해요. 설명할 수 없는 코드는 고칠 수도 없어요.
  • 먼저 시도해요: 내가 먼저 짜 보고, 막힌 부분만 묻거나, 다 짠 뒤에 검토를 부탁해요.
  • 확인해요: AI의 답에 나온 함수와 옵션은 문서와 실행으로 확인해요.

끝내기

프로젝트의 가장 어려운 부분은 마지막 10%예요. 핵심 기능이 돌아가면 새 프로젝트가 더 재미있어 보이거든요. 그래서 "다 됐다"의 기준을 처음에 정해 둬요. 예를 들면 이래요.

  • 목표 문장의 기능이 동작한다
  • README만 보고 다른 사람이 설치하고 실행할 수 있다
  • 알고 있는 큰 버그가 없다
  • 남에게 보여 줄 수 있는 곳에 올라가 있다

기준을 채우면 끝났다고 선언해요. 더 하고 싶은 건 "다음에 할 일"로 넘기고요. 끝낸 작은 프로젝트 하나가 끝내지 못한 큰 프로젝트 열 개보다 값져요. 남에게 보여 줄 때도, 내 자신감에도요.

기록하고 돌아보기

끝냈다면 짧게 돌아봐요. 많이 쓰는 방법이 KPT예요.

  • Keep(계속할 것): 잘 됐고 다음에도 할 것
  • Problem(문제): 어려웠거나 아쉬웠던 것
  • Try(시도할 것): 다음 프로젝트에서 바꿔 볼 것

그리고 만든 과정을 글로 남겨요. 어떤 문제를 풀려 했고, 무엇을 고민해서 어떻게 정했고, 무엇을 배웠는지요. 이 글이 가장 좋은 포트폴리오예요. 결과물보다 어떻게 생각했는지가 보이니까요.

꾸준히 하기

  • 시간을 정해 두기: "시간 날 때"는 오지 않아요. 매주 같은 요일 두 시간처럼 정해요.
  • 흐름 끊지 않기: 끝낼 때 "다음에 할 일"을 한 줄 적어 두면, 다음에 앉았을 때 바로 시작할 수 있어요.
  • 함께하기: 같이 공부하는 사람에게 매주 진행 상황을 짧게 공유하면 멈추지 않게 돼요.
  • 조금씩 키우기: 첫 프로젝트가 끝나면, 같은 프로젝트에 새것 한두 가지를 더하거나, 한 단계 위의 프로젝트로 가요.

실습

  1. 요즘 귀찮다고 느낀 일 세 가지를 적고, 그중 하나를 한 문장 목표로 바꿔 보세요.
  2. 그 목표로 하고 싶은 기능을 모두 적은 뒤, 가장 작은 쓸모 있는 버전만 남기고 나머지는 "다음에 할 일"로 옮겨 보세요.
  3. 4주짜리 계획표를 만들어 보세요. 주마다 "끝나면 할 수 있는 것"이 눈에 보이게요.
  4. 새 저장소를 만들고, 코드를 쓰기 전에 README부터 써 보세요.
  5. 예전에 그만둔 프로젝트가 있다면 KPT로 돌아봐 보세요. 왜 멈췄나요?

자주 하는 실수

  • 튜토리얼만 계속 찾기. 작더라도 내가 결정하는 프로젝트를 시작해요.
  • 처음부터 크게 잡기. 끝낼 수 있는 크기로 시작하고, 끝낸 뒤 키워요.
  • 새 기술을 한꺼번에 많이 쓰기. 어디서 막혔는지 알 수 없어요.
  • 한 부분만 완벽하게 다듬기. 끝에서 끝까지 얇게 먼저 이어요.
  • AI 코드를 이해 없이 붙여 넣기. 고칠 수 없는 코드가 쌓여요.
  • 끝의 기준 없이 계속 늘리기. "다 됐다"의 기준을 정하고, 채우면 끝내요.

점검 문제

  1. 튜토리얼만으로 실력이 잘 늘지 않는 이유는?
  2. 좋은 첫 프로젝트의 세 가지 조건은?
  3. 가장 작은 쓸모 있는 버전(MVP)이란? 잘라 낸 기능은 어떻게 하나요?
  4. "끝에서 끝까지 얇게 먼저"가 좋은 이유는?
  5. 막혔을 때의 순서를 말해 보세요.
  6. AI를 선생님으로 쓰는 방법 두 가지는?
  7. KPT의 세 글자는 각각 무엇인가요?

정답

  1. 튜토리얼은 결정을 대신 내려 줘서, 실력의 큰 부분인 결정하는 힘을 연습할 수 없기 때문이에요.
  2. 내 문제에서 출발하고, 끝낼 수 있는 크기이고, 새로 배울 것이 조금만 섞여 있는 거예요.
  3. "이것만 되면 실제로 쓸 수 있다"는 가장 작은 기능 묶음이에요. 잘라 낸 기능은 지우지 않고 "다음에 할 일"로 미뤄요.
  4. 전체 구조의 문제를 일찍 발견할 수 있어서, 한 부분을 다 만든 뒤 구조를 뒤엎는 일을 막아 주기 때문이에요.
  5. 오류 메시지를 끝까지 읽고, 작게 재현하고, 공식 문서를 보고, 정해 둔 시간이 지나면 좋은 질문으로 물어보고, 필요하면 잠시 떠나요.
  6. 코드를 대신 짜게 하기보다 설명을 부탁하고, 받은 코드는 모든 줄을 이해한 뒤에 써요. 내가 먼저 시도하고 막힌 부분만 묻는 것도 좋아요.
  7. Keep(계속할 것), Problem(문제), Try(시도할 것)예요.

다음 강의

성장 트랙을 마쳤어요. 이제 무엇을 배우든 기록하고, 증거로 고치고, 문서에서 찾고, 읽기 쉽게 쓰고, 끝까지 만드는 방법을 갖췄어요. 다음은 컴퓨터 기초 트랙이에요. 우리가 매일 쓰는 기계가 안에서 어떻게 움직이는지, CPU와 메모리와 저장 장치부터 차근차근 들여다봐요.