뱅골어로 제작한 완전한 AI 코딩 핸드북 - 용어, 도구, 이야기, 그리고 30일간의 경로

1년 동안 AI 코딩에 대해 논의하며 한 가지를 배웠습니다. 가장 어려운 부분은 도구가 아니라 바로 용어의 장벽 (vocabulary wall) 이라는 점입니다. 영어가 모국어가 아니라면, "token (토큰)", "context window (컨텍스트 윈도우)", "hallucination (환각)", "harness (하네스)" 같은 단어들은 개념처럼 들리지 않습니다. 마치 주문처럼 들리죠. 🪄

Matt Pocock의 훌륭한 Dictionary of AI Coding은 이러한 단어들이 얼마나 가르치기 쉬운지를 보여주었습니다. 그래서 저는 이를 뱅골어로 변형했고, 원본이 끝나는 지점을 훨씬 넘어 계속해서 확장했습니다. 오늘날 이것은 완전하고 무료이며 오픈 소스인 학습 경로가 되었습니다:

🔗 https://github.com/dhrupo/dictionary-of-ai-coding-bangla

4단계 구성: শব্দ → হাতিয়ার → গল্প → অভ্যাস

(words → tools → story → habit / 단어 → 도구 → 이야기 → 습관)

📖 Part 1 — 단어 (The words). 7개 섹션에 걸친 62개의 용어로 구성되어 있으며, 각 용어는 교과서적인 정의 대신 일상생활의 비유를 사용합니다. 모델은 스스로 버튼을 누르지 않는 계산기와 같습니다. 파라미터 (Parameters)는 믹싱 보드의 노브(knob)와 같습니다. 그리고 গোল্ডি (Goldie)가 있습니다. 3초의 기억력을 가진 금붕어인 Goldie는 모델 또한 상태가 없는 (stateless) 특성을 가지고 있다는 점을 계속해서 상기시켜 줍니다. 🐠

🛠️ Part 2 — 도구 (The tools). 이 부분은 원본을 넘어섭니다. 실제 CLI 명령어를 다루는 7개의 실습 가이드 (Claude Code + Codex를 개념과 매핑 — 예를 들어 /compact는 단순한 압축(Compaction) 버튼임), AI 친화적인 폴더 구조 (AGENTS.md, .claude/, 누가 무엇을 언제 읽는지), 나쁜 프롬프트에서 좋은 프롬프트로의 재작성, 인기 있는 커뮤니티 기술 (브레인스토밍, grill-me, TDD, handoff 등), 17개의 추가 용어 (RAG, embeddings (임베딩), temperature (온도), hooks (훅) 등), 토큰 경제학 (token economics), 그리고 안전성 (우체부 비유로 설명한 프롬프트 인젝션 (prompt injection) 포함)을 다룹니다.

📜 Part 3 — 이야기. 무언가를 설치해야 하는 튜토리얼 대신, 6개 장으로 구성된 함께 읽는 이야기입니다: 9학년 학생인 রাফি(Rafi)가 AI 에이전트(AI agent)를 사용하여 자신의 첫 포트폴리오 사이트를 구축합니다. 그는 모호한 프롬프트 (vague prompts), 환각 (hallucination)을 일으킨 라이브러리를 신뢰하는 것, 세션을 너무 길게 끌어 성능이 저하되는 구간 (dumb zone)에 빠지는 것 등 모든 전형적인 실수들을 저지르지만, Part 2에서 배운 도구들을 사용하여 이를 극복합니다. 여백의 메모(Margin notes)는 각 개념이 실제로 문제가 되는 정확한 순간에 다시 언급됩니다. 독자는 아무것도 설치할 필요가 없습니다.

🗓️ 30일간의 경로. 읽는 것만으로는 내 것이 되지 않습니다. 그래서 이 책은 30일간의 일일 미션(각 515분 소요)으로 끝을 맺습니다. 처음 2주는 설정이 전혀 필요 없습니다. 그저 아무 무료 AI 채팅창이나 열고 눈을 크게 뜨기만 하면 됩니다 ("같은 질문을 두 번 해보세요 — 답변이 일치하나요?"). 34주 차에는 직접 실습에 들어가지만, 모든 미션에는 읽기 전용(read-only) 대안이 마련되어 있습니다.

또한, 신화 타파를 위한 FAQ ("AI가 내 일자리를 뺏을 것이다", "컴퓨터 과학 (CS) 학위가 필요하다"), 79개의 용어로 구성된 알파벳순 색인, 복사해서 붙여넣을 수 있는 templates/ (초기 AGENTS.md, 작동하는 /handoff 명령어, SKILL.md 예시), 그리고 26개의 터미널 GIF가 포함되어 있습니다. 이 모든 것은 커밋된 VHS 스크립트를 통해 재현 가능합니다.

제작하며 배운 것들

• 비유는 장식이 아니라 하중을 견디는 지지대이다. "프리픽스 캐시 (Prefix cache)"라는 용어는 "웨이터가 당신의 단골 주문을 기억하는 것"이라는 비유가 나오기 전까지는 전혀 와닿지 않았습니다.
• 이야기는 목록이 할 수 없는 방식으로 순차적 흐름을 가르친다. /compact 대 /clear 대 핸드오프 (handoff)를 완벽하게 문서화할 수는 있지만, 사람들은 여전히 언제 사용해야 하는지 모를 수 있습니다. রাফি가 긴 세션 때문에 색상 구성 (color-scheme) 결정을 놓치는 과정을 지켜보는 것은 기억에 강렬하게 남습니다.
• 뱅골어 텍스트는 재미있는 방식으로 도구들을 고장 낸다. grep은 제 콘텐츠의 절반을 매칭하지 못했고 (분해된 유니코드 (decomposed Unicode)), 이모지로 시작하는 헤딩의 GitHub 슬러그 (slug)는 길을 잃은 하이픈으로 시작하며, 중첩된 코드 펜스 (code fences)에는 4개의 백틱 (backtick) 외곽선이 필요합니다. 저장소의 링크 체크 도구가 작은 Python 스크립트로 만들어진 데에는 다 이유가 있습니다.
• 초보자들도 진짜를 누릴 자격이 있다. 단순화 (Simplified)가 곧 저급화 (dumbed down)를 의미하지는 않습니다. 용어 사전은 정확한 영어 용어를 어디에서나 볼 수 있게 유지하므로, 독자들은 나중에 어떤 영어 문서에 들어가더라도 익숙함을 느낄 수 있습니다.

이것은 커뮤니티의 일입니다

모든 내용은 CC BY 4.0 라이선스를 따릅니다. "새로운 단어를 제안하고 싶습니다"와 "오류를 발견했습니다"를 위한 뱅골어 이슈 양식(issue forms)이 마련되어 있습니다. 오타 수정부터 더 나은 비유, 혹은 완전히 새로운 섹션 추가에 이르기까지, 규모에 상관없이 모든 기여를 환영합니다.

그리고 만약 여러분이 다른 언어를 사용한다면: 이 구조를 가져가서 활용하십시오. 어휘의 장벽(vocabulary wall)은 영어를 사용하지 않는 모든 개발자 커뮤니티에 존재하며, 이를 해결하는 과정은 놀라울 정도로 즐거운 작업이 될 것입니다. 💙

🔗 https://github.com/dhrupo/dictionary-of-ai-coding-bangla