project-based-learning 딥다이브
— "강의를 보지 말고, 직접 만들면서 배워라" — 언어별로 정리된 '직접 만들기' 튜토리얼 대백과

practical-tutorials/project-based-learning. "바닥부터 직접 만들며 배우는(build from scratch)" 프로그래밍 튜토리얼을 프로그래밍 언어별로 모아 둔 거대한 큐레이션 목록이다. 데이터베이스·셸·OS·Git·인터프리터·Redis 클론 같은 "네 손으로 직접 만드는 X" 튜토리얼이 22개 언어 섹션에 약 450개 링크로 정리돼 있다. 실행되는 앱이 아니라 단 하나의 README.md가 상품인 awesome 리스트로, "수동적 강의 시청"이 아니라 "능동적 만들기"가 더 잘 배운다는 철학에 베팅한 레포다. (저장소: practical-tutorials/project-based-learning · 형식 Markdown 큐레이션 · 라이선스 MIT · ★ 약 271k · GitHub 역대 최상위권 스타 레포)

1프로젝트 한줄 요약

"이 레포 자체는 코드를 가르치지 않는다 — '무엇을 만들며 배울지'를 언어별로 안내하는 거대한 지도다."

핵심을 한 번 더 짚으면 — 이 레포에는 실행할 코드가 없습니다. 깃허브 별 27만 개를 받은 이 거대한 레포의 정체는 잘 정리된 링크 목록 하나입니다. 그래서 이 문서도 "코드 아키텍처"가 아니라 "목록이 어떻게 구성·관리되는가"와 "이 목록으로 어떻게 공부하는가"를 파고듭니다.

2왜 주목받는가

"규모, 변치 않는 가치, 그리고 '만들며 배운다'는 강력한 철학 — 그래서 몇 년이 지나도 계속 트렌딩에 오른다."

먼저, '수동적 학습'의 함정

많은 입문자가 튜토리얼 영상·강의를 끝없이 봅니다. 보는 동안엔 다 아는 것 같지만, 막상 빈 에디터 앞에 앉으면 한 줄도 못 짜는 '튜토리얼 지옥(tutorial hell)'에 빠집니다. 지식이 '읽은 것'에 머물고 '해 본 것'이 되지 못했기 때문입니다.

숫자와 영향력

이 레포가 몇 년이 지나도 계속 트렌딩에 오르는 이유는, 내용이 '유행을 안 타는(evergreen)' 지식이기 때문입니다. "데이터베이스를 직접 만들어 보라"는 가치는 10년 전에도 지금도 유효합니다. 거의 유지보수하지 않아도 신선하게 남고, README가 "시작하려면 그냥 이 레포를 포크하세요"라고 안내해 입문자의 첫 포크·첫 PR 대상으로도 인기가 높습니다.

3기술 스택 — 이 목록은 어떻게 만들어지나

"애플리케이션 코드는 없다. '스택'은 곧 문서(Markdown) + 링크를 지키는 자동화다."

실행되는 프로그램이 아니므로 백엔드·프론트엔드가 없습니다. 대신 "목록을 어떻게 관리하느냐"가 이 레포의 기술입니다.

요점은 이 레포의 '엔지니어링'은 코드가 아니라 '문서를 깨끗하고 일관되게 유지하는 규칙·자동화'라는 것입니다. 기여 규칙(CONTRIBUTING.md)은 매우 엄격합니다 — PR 하나당 튜토리얼 하나, 형식은 정확히 [제목](링크), URL 단축기 금지, 올바른 언어 섹션에 배치, 새 언어면 목차 항목 추가 등.

4아키텍처 — 목록은 어떻게 구성돼 있나

"최상위 구분은 '프로그래밍 언어별'. 큰 언어는 다시 주제·프레임워크로 가지를 친다."

전체 구조 한 장

책장을 언어별 칸으로 나눈 도서관을 떠올리면 됩니다. 최상위는 언어(##)로 나뉘고, 큰 언어는 다시 주제(###)로, JavaScript는 프레임워크(####)까지 가지를 칩니다.

실제 언어 섹션과 규모

항목의 '문법' — 목록의 한 줄은 어떻게 생겼나

# 단일 튜토리얼
- [Build Your Own Text Editor](https://...)   (제목+링크, 때로 (video) 태그)

# 다중 파트 시리즈는 부모-자식 들여쓰기
- Building Blockchain in Go
    - [Part 1](https://...)
    - [Part 2](https://...)
    ...

이렇게 일관된 한 줄 문법이 있어야 사람이 읽기 좋고, 동시에 awesome_bot 같은 자동 도구가 링크를 검사할 수 있습니다 — 구성과 자동화가 맞물려 돌아갑니다.

5디렉토리 구조 해부

"거의 모든 것이 README 하나에 있다. 나머지는 기여·CI를 돕는 곁가지 파일."

6학습 포인트 (어떻게 활용하나)

"고르는 법은 셋 — 내 언어 섹션으로 가서, 관심 주제를 고르고, 다 만든 뒤 난이도를 올린다."

7시스템 요구사항

"레포 자체엔 요구사항이 거의 없다 — 브라우저, 그리고 고른 프로젝트의 언어 도구뿐."

8직접 해볼 수 있는 실습 과제

"작은 앱 → 풀스택 → CLI 도구 → 인터프리터 → DB → OS 순으로 난이도를 올려 보자."

9관련 기술 심화 학습 로드맵

"이 목록을 4주 코스로 쓰는 한 가지 방법."

10핵심 키워드 사전

"학습 방법론 + 큐레이션 레포 용어를 한자리에."

11참고 링크

"형제 격인 '직접 만들기' 자료들과 함께 보면 좋다."

• 저장소: github.com/practical-tutorials/project-based-learning
• README 원본: raw README.md
• 형제 격 "build your own X": codecrafters-io/build-your-own-x
• 핸즈온 "직접 만들기"(유료): codecrafters.io
• 기여 방법: 레포의 CONTRIBUTING.md(포크 → PR당 튜토리얼 하나 → 올바른 언어 섹션에 배치)