부록 E. 실전으로 익힌 개발 용어 × Claude 스킬 — 상세 안내
개발자와 대화할 때 이 말들을 쓰면 됩니다
이 책에서는 결과물을 만들며 필요한 기술을 익혔습니다. 이제 기술 이름을 들으면 그 기술로 무엇을 만들었고, 나는 무엇을 정하고 확인했는지 연결해봅니다.
| 이런 말을 들으면 | 이렇게 답하면 됩니다 |
|---|---|
| 「API 연동해보셨어요?」 | 「실거래가와 위치 데이터를 하나의 아파트 찾기 화면에 붙여봤습니다」 |
| 「테스트는 짜세요?」 | 「완료 조건은 제가 정하고, Test 구현과 실행은 AI에 맡겨 결과를 확인했습니다」 |
아래 표는 관련 기술과 그 기술로 만든 결과를 묶었습니다. 마지막 열은 그 묶음을 주로 다룬 장입니다. 기술별 뜻과 위치를 하나씩 찾으려면 온라인 부록 E의 「전체 기술 목록」을 이용합니다.
PART 1. 결과와 과정을 확인하는 법
| 기술 이름 | 이 책에서 만든 것과 확인한 것 | 주로 다룬 장 |
|---|---|---|
| Python·openpyxl·출처 | 공식 자료로 영화 흥행 Excel 보고서를 만들고 출처를 남겼습니다 | 1장 |
| 완료 조건·Test·기준 자료·PASS/FAIL | 공식 원본 일부를 직접 대조하고, 보관한 기준 자료와 보고서를 Test로 비교했습니다 | 2장 |
| Permission·Plan mode | 반복 작업의 권한과 큰 변경 전에 볼 계획을 정했습니다 | 2장 |
| 재현·Debug·Root Cause·Regression | 문제를 다시 만들고 원인을 좁혀 고친 뒤 원래 기능도 확인했습니다 | 3장 |
| CLAUDE.md | 공통 작업 원칙과 프로젝트별 규칙을 나눠 남겼습니다 | 4장 |
| Git·Commit·Diff·Checkpointing·GitHub | 변경을 기록·비교하고, 최근 작업을 되돌리며, 검증한 상태를 원격에 보관했습니다 | 5장 |
PART 2. 실제 데이터를 웹서비스로 연결하는 법
| 기술 이름 | 이 책에서 만든 것과 확인한 것 | 주로 다룬 장 |
|---|---|---|
| TypeScript·Next.js | 아파트 찾기 서비스를 만들 기본 프로젝트를 준비했습니다 | 6장 |
| API·API Key·환경변수 | 실거래가·위치 데이터를 연결하고 인증값은 코드와 Git 밖에 뒀습니다 | 6장 |
| 정규화·데이터 결합 | 서로 다른 주소와 거래 기록을 같은 아파트 기준으로 합쳤습니다 | 7장 |
| Boundary | 면적·가격의 경곗값 포함 여부를 정하고 잘못된 입력과 결과 0건을 구분했습니다 | 7장 |
| 웹 화면·클라이언트와 서버 | 브라우저에 입력·결과 화면을 만들고 외부 API와 Secret은 서버에서 처리했습니다 | 8장 |
| 배포·HTTPS·Region·CI/CD·E2E | 인터넷 주소에서 사용자 흐름을 확인하고 GitHub 변경이 자동 배포로 이어지게 했습니다 | 8장 |
8장에서 자동으로 이어진 것은 배포입니다. Test는 GitHub에 보내기 전에 Claude가 실행했습니다. CI/CD라는 이름만으로 모든 검사가 자동화됐다는 뜻은 아닙니다.
PART 3. 근거가 있는 AI 브리핑을 만드는 법
| 기술 이름 | 이 책에서 만든 것과 확인한 것 | 주로 다룬 장 |
|---|---|---|
| 기준일·Chart | 숫자의 기준일을 붙이고 1년 주가 흐름을 그렸습니다 | 9장 |
| OpenDART·공시 원문·Source Link | 해당 종목에 접수된 공시를 제출인과 함께 보여주고 원문 링크를 남겼습니다 | 10장 |
| 식별값 매핑·Pagination | 서비스마다 다른 회사 값을 잇고 긴 공시 목록을 나눴습니다 | 10장 |
| Gemini API·Grounding·Prompt | 확인한 자료만 AI에 넘겨 브리핑을 만들었습니다 | 11장 |
| 출력 검증·기능 격리 | AI 답을 정한 조건으로 검사하고 생성이 실패해도 기존 주가·공시 화면은 유지했습니다 | 11장 |
| Database·Cache·TTL·Latency·사용량과 비용 | 데이터와 브리핑을 정한 기간 동안 재사용해 외부 호출과 대기 시간을 줄였습니다 | 12장 |
PART 4. 같은 서비스를 모바일 앱으로 넓히는 법
| 기술 이름 | 이 책에서 만든 것과 확인한 것 | 주로 다룬 장 |
|---|---|---|
| Mobile Architecture·공통 Backend·권한 | 기존 서버를 재사용할 앱의 범위·권한·완료 조건을 계획했습니다 | 13장 |
| Android SDK·Kotlin·Compose | 웹서비스를 Android 앱 화면으로 확장했습니다 | 14장 |
| Build·APK·Emulator | 설치 파일을 만들고 컴퓨터에서 Android 앱을 실행했습니다 | 14장 |
| Xcode·SwiftUI·URLSession | iPhone 화면을 만들고 기존 서버와 연결했습니다 | 15장 |
| Simulator·Unit Test·UI Test | iPhone Simulator에서 앱 기능과 사용자 흐름을 확인했습니다 | 15장 |
PART 5. AI 콘텐츠를 만들고 검사해 게시하는 법
| 기술 이름 | 이 책에서 만든 것과 확인한 것 | 주로 다룬 장 |
|---|---|---|
| Storyboard·TTS·FFmpeg | 장면과 대사를 정한 뒤 음성·화면·자막을 Shorts로 합쳤습니다 | 16장 |
| 라이선스·Skill | 사용할 수 있는 자료를 확인하고 제작 방법을 다시 부를 이름으로 남겼습니다 | 16장 |
| 독립 검사·PASS/FAIL Gate | 만드는 AI와 검사하는 AI를 나누고 한 기준으로 판정했습니다 | 17장 |
| YouTube Data API·OAuth·Scope·Token | 필요한 권한만 받아 영상을 실제 채널에 올렸습니다 | 18장 |
| Preview·사람 승인·Receipt | 게시 전 변경을 확인하고 결과 기록을 남겼습니다 | 18장 |
PART 6. 만든 기능을 AI가 사용하는 법
| 기술 이름 | 이 책에서 만드는 것과 확인할 것 | 주로 다루는 장 |
|---|---|---|
| 분류·구조화 응답 | 댓글의 종류와 처리 수준을 나누고 초안을 검사합니다 | 19장 |
| OAuth Scope·실행 승인 | 허용한 채널의 댓글에 승인한 범위의 답글만 보냅니다 | 20장 |
| 중복 방지·상태 기록 | 동시 실행과 전송 결과 미확인을 구분해 재전송을 막습니다 | 20장 |
| 예약 실행·Cron·중단 | 정한 범위의 작업을 정해진 시각에 수행하고 안전하게 멈춥니다 | 20장 |
| 대화 맥락·근거 기반 응답 | 현재 종목의 실제 자료로 질문에 답하고 출처를 표시합니다 | 22장 |
| 함수 호출·허용 목록 | AI가 제안한 기능과 입력을 서버가 검사해 기존 조회를 실행합니다 | 22장 |
| 요청 제한·기능 격리 | AI 호출량을 제한하고 대화만 꺼도 원래 서비스를 유지합니다 | 22장 |
기술은 이 순서로 자랐습니다
| 이것을 알게 되니 | 이것을 할 수 있었습니다 |
|---|---|
| 완료 조건을 먼저 정하는 법(2장) | 결과가 다를 때 잘못된 자리를 짚었습니다(3장) |
| 보고서 값을 기준 자료와 대조하는 법(2장) | 답변의 사실 카드와 출처를 실제 조회 결과로 대조합니다(21~22장) |
| 통과와 실패를 한 기준으로 판정하는 법(2장) | 제작 절차와 분리한 검사 Skill로 같은 기준을 반복 확인했습니다(17장) |
| 원인을 증거로 좁히는 법(3장) | 다음 문제에도 사용할 조사·수정 순서를 규칙으로 남겼습니다(4장) |
| 정상 상태로 돌아가는 법(5장) | 큰 변경을 다시 시도할 수 있었습니다(6장 이후) |
| 외부 데이터를 가져오는 법(6장) | 성격이 다른 두 자료를 합쳤습니다(7장) |
| 화면과 서버를 나누는 법(8장) | 앱을 만들며 서버와 AI 기능을 그대로 썼습니다(14~15장) |
| 인터넷 주소에서 서비스를 돌린 경험(8장) | 다음 서비스도 같은 방식으로 올렸습니다(9~12장) |
| 확인한 자료만 AI에 주는 법(11장) | 한 질문에 사용할 자료와 출처를 먼저 준비하고 답변에 표시했습니다(21~22장) |
| 기존 기능을 재사용하는 법(13장) | 같은 조회 기능을 AI가 사용할 수 있게 연결합니다(22장) |
뒤로 갈수록 새 기술만 늘어난 것이 아니라, 앞에서 만든 것을 재료로 쓰게 됐습니다.
Claude에게 맡길 수 있는 일이 점점 많아졌습니다
| 어디까지 맡겼나 | 그때 내가 판단한 것 |
|---|---|
| 결과물을 만들어달라고 말합니다(1장) | 나온 결과가 요청과 같은지 |
| 정한 완료 조건을 검사로 만들게 합니다(2장) | 무엇을 검사로 확인하고 무엇을 직접 볼지 |
| 고치기 전에 원인을 확인하게 합니다(3장) | 증거가 그 원인을 가리키는지 |
| 규칙을 남기고 다음에도 참고하게 합니다(4장) | 무엇을 규칙으로 굳힐지 |
| 정상 상태를 기록하고 되돌리게 합니다(5장) | 어디로 돌아가고 무엇만 남길지 |
| 외부 데이터 연결과 배포까지 맡깁니다(6~8장) | 공개할 상태와 넘기지 않을 값 |
| 근거 안에서만 설명하게 합니다(9~12장) | 근거와 말하면 안 되는 것 |
| 같은 서비스를 앱으로 넓힙니다(13~15장) | 앱의 목적·기능 범위·기기 권한과 실제 사용 흐름 |
| 만드는 쪽과 검사하는 쪽을 나눕니다(16~17장) | 무엇을 내보낼지 |
| 내 계정에 실제로 게시하게 합니다(18장) | 지금 게시해도 되는지 |
| 내가 없는 동안 도착한 일을 처리하게 합니다(19~20장) | 자동 처리할 일과 멈출 조건 |
| AI가 필요한 조회 기능을 사용하게 합니다(21~22장) | 허용할 기능·입력·근거와 모르는 범위 |
맡기는 일이 커질수록, 원하는 결과와 함께 판단 기준과 방향도 더 분명하게 정합니다.
배운 기술을 내 결과물로 증명합니다
온라인 부록 E의 templates/skills-evidence.md를 docs/skills.md로 가져갑니다. 위 표에서
설명하고 싶은 기술 다섯 개를 고르고 다음 네 칸을 채웁니다.
기술 이름 → 내가 만든 것 → 내 저장소의 증거 링크 → 처음 쓴 장
저자의 공개 검증은 비교 자료이지 여러분의 경험을 증명하지 않습니다. 내 결과물, Test, 검증 기록, Commit 가운데 실제로 있는 것만 연결합니다. 증거를 찾지 못한 내용은 경험한 것처럼 쓰지 않습니다.
더 만들어보고 싶은 것이 있다면 표의 결과물에서 하나를 고르고, 해당 장의 방법을 내 소재에 적용해봅니다. 아직 해보지 않은 일은 가능성으로 구분해 적습니다.
용어는 지금 만든 결과와 연결해 찾아봅니다
처음에는 한 줄 뜻과 이 장에서 맡는 역할부터 확인합니다. “이 용어를 지금 프로젝트로 설명해줘”라고 물으면 작은 예시와 헷갈리는 개념 하나를 함께 살펴봅니다. 더 알아보기는 선택 학습이며 새 계정·새 프로그램·다음 장 구현을 자동으로 요구하지 않습니다.
AI 사용량을 세는 Token과 OAuth 권한을 증명하는 Token은 다른 의미입니다. 기술 이름을 이력에 적을 때도 실제로 한 일을 구분합니다. 완료 조건은 사람이 정했고 Test 구현·실행을 AI에게 맡겼다면 그 경험 그대로 설명합니다. 읽기만 했거나 완성 소스로 재개한 부분을 직접 모두 구현했다고 포장하지 않습니다.
자료 기준 확인
자료 판본 052a579f · 문서 반영 2026-10-10
문서 반영일은 도구·서비스의 현재 지원을 확인한 날짜가 아닙니다.