12개의 병렬 AI 에이전트를 사용하여 7,000줄 분량의 AI 코딩 핸드북을 번역했습니다

지난주 저는 뱅골어로 된 완전한 AI 코딩 핸드북을 출시했습니다. 일상적인 비유로 풀어낸 79개의 용어, 실습용 CLI 가이드, 6장으로 구성된 이야기, 그리고 30일 실습 경로가 포함되어 있습니다. 이 프로젝트의 전제는 '어휘의 장벽(vocabulary wall)'이었습니다. "토큰(token)", "컨텍스트 윈도우(context window)", "하네스(harness)"와 같은 단어들은 누군가 평이하게 설명해주기 전까지는 마치 주문처럼 들립니다.

알고 보니 어휘의 장벽은 뱅골어만의 문제가 아니었습니다. 그것은 초보자들의 문제입니다.

그래서 오늘, 책 전체가 영어로 존재합니다:

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

내용 요약 (60초 버전)

📖 파트 1 — 용어들. 7개 섹션에 걸친 62개의 용어로, 각 용어는 교과서적인 정의 대신 일상생활의 비유를 담고 있습니다. 모델은 스스로 버튼을 누르지 않는 계산기와 같습니다. 그리고 3초의 기억력을 가진 금붕어 Goldi 🐠는 모델 또한 상태가 없는(stateless) 특성을 가지고 있다는 점을 계속해서 상기시켜 줍니다.

🛠️ 파트 2 — 도구들. 7개의 실습 가이드가 포함됩니다: 실제 CLI 명령어 (Claude Code + Codex), AI 친화적인 폴더 구조 (AGENTS.md, .claude/), 나쁜 프롬프트에서 좋은 프롬프트로의 재작성, 인기 있는 커뮤니티 기술 (브레인스토밍, grill-me, TDD, 핸드오프(handoff)...), 17개의 추가 용어 (RAG, 임베딩(embeddings), 온도(temperature), 훅(hooks)...), 토큰 경제학(token economics), 그리고 안전성 — 우체부 비유를 통해 설명하는 프롬프트 인젝션(prompt injection)까지 다룹니다.

📜 파트 3 — 이야기. 설치할 것은 아무것도 없습니다: 9학년 학생인 Rafi가 AI 에이전트를 사용하여 첫 포트폴리오 사이트를 구축하며, 모든 전형적인 실수(모호한 프롬프트, 환각(hallucinated)된 라이브러리, 세션을 너무 길게 끌어 멍청한 영역으로 빠지는 것 등)를 저지르고 파트 2의 도구들을 사용하여 회복하는 과정을 담았습니다. 여러분은 그의 어깨 너머로 그 과정을 지켜보게 됩니다.

🗓️ 30일 경로. 하루에 5~15분 정도 소요되는 미션 하나씩 진행합니다. 처음 2주 동안은 무료 AI 채팅 서비스 외에는 아무것도 필요하지 않습니다. 또한, 오해를 바로잡는 FAQ, 79개 용어 인덱스, 그리고 복사해서 붙여넣을 수 있는 templates/가 제공됩니다.

재미있는 점: 이 책은 여러분이 일하는 방식을 가르치는 바로 그 방식으로 스스로를 번역했습니다.

여기에 메타 스토리(meta-story)가 있습니다. 이 핸드북은 서브에이전트(subagents), 핸드오프 아티팩트(handoff artifacts), 그리고 완료 전 검증(verification-before-completion)을 가르치는 데 세 개의 장을 할애합니다. 그래서 36개 파일에 걸친 약 7,000줄의 방글라어 마크다운(markdown)을 번역해야 할 때가 왔을 때... 저는 정확히 그 방식을 사용했습니다.

12개의 병렬 AI 에이전트, 하나의 세션. 각 에이전트는 동일한 컨벤션(conventions) 블록—캐릭터 이름(Goldi, Rafi), 반복되는 섹션 레이블, 파일 이름 변경 규칙—을 부여받았으며, 동시에 책의 각기 다른 부분을 담당했습니다. 예를 들어, 여기서는 사전 관련 세 개의 장을, 저기서는 다른 에이전트에게 6개 장 전체의 이야기를 맡겼습니다(하나의 번역가 = 하나의 일관된 목소리).

이 작업이 성공할 수 있었던 세 가지 요인은 다음과 같습니다:

1. 에이전트의 판단보다 결정론적 규칙(Deterministic rules)이 승리합니다. 방글라어 책의 용어 헤딩(term headings)은 ### বাংলা-শব্দ (English Term) 형식이었습니다. 컨벤션은 다음과 같았습니다: 영어 헤딩이 괄호 안의 용어와 정확히 일치해야 합니다. 이 단 하나의 규칙 덕분에 모든 파일 간 앵커(anchor)를 예측할 수 있게 되었습니다. 서로 다른 파일을 병렬로 작업하는 에이전트들이 아직 작성되지 않은 다른 에이전트의 장으로 링크를 걸 수 있었고, 슬러그(slug)를 일치시킬 수 있었습니다.

2. 느낌(vibes)이 아닌, 기계로 검증 가능한 게이트(gate). 이 레포지토리(repo)에는 모든 마크다운 링크와 앵커를 검증하는 아주 작은 CI 링크 체크 도구(scripts/check-links.py)가 포함되어 있으며, 여기에는 GitHub 슬러그의 특이 사항도 포함됩니다. 에이전트들이 작업을 마친 후 첫 번째 실행 결과: 44개의 깨진 링크가 발견되었습니다. 남아있던 방글라어 앵커, 한 에이전트가 #esc-stop이라고 추측한 곳에 다른 에이전트가 ### ESC (stopping)라고 작성한 경우, 그리고 세 번째 에이전트가 슬러그를 #-grill-me-grill-me처럼 중복시킨 경우 등이 있었습니다. 스크립트를 통한 수정 작업을 20분간 진행한 결과: 36개 파일의 모든 링크가 정상 작동했습니다. 이제 이 체크 도구는 모든 PR(Pull Request)에서 실행됩니다.

3. 가정하지 말고 검증하십시오. 인덱스(index) 에이전트는 79개의 앵커를 _계산(compute)_한 것이 아니라, 실제 번역된 파일들을 읽고 실제 헤딩을 추출했습니다. 누락은 제로였습니다. 한편

만약 이 워크플로우(workflow)가 유용하게 들린다면, 그것은 말 그대로 이 책의 파트 2와 파트 3에서 가르치는 내용—서브에이전트(subagents), 핸드오프(handoffs), 검증(verification)—을 자기 자신에게 적용한 것입니다.

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

두 언어 버전 모두 CC BY 4.0 라이선스를 따르며, 두 판본은 서로 상호 링크되어 있습니다. "오류를 발견했습니다" 및 "새로운 단어를 제안합니다"를 위한 이슈(Issue) 양식도 두 저장소(repo) 모두에 준비되어 있습니다.

💙 Matt Pocock의 Dictionary of AI Coding의 토대 위에 구축되었습니다. 파트 2와 3는 이를 훨씬 뛰어넘어 성장했지만, 그 정신은 그의 것입니다.

그리고 방글라어(Bangla) 출시 때 제안했던 내용은 여전히 유효합니다. 만약 여러분이 다른 언어를 구사한다면, 이 구조를 가져가십시오. 결정론적 헤딩(deterministic-heading) 트릭과 링크 체크 도구 덕분에, 다음 번역은 대부분 에이전트(agent)를 다루는 오후 시간 정도로 해결될 것입니다. 저는 진심으로 스페인어, 힌디어, 또는 베트남어 판본을 보고 싶습니다.

🔗 https://github.com/dhrupo/dictionary-of-ai-coding-english
🇧🇩 방글라어를 선호하시나요? https://github.com/dhrupo/dictionary-of-ai-coding-bangla