가이드

알파고에서 지금까지

2016년 그 사건 이후 6년간 아무것도 안 바뀐 이유, 그리고 2022년에 바뀐 것.

AI가 무엇인가

로봇 얘기가 아닙니다. 검색과 무엇이 다른지부터 봅니다.

무엇이 좋아지나

하루 업무에서 실제로 달라지는 것 다섯 가지 — 진짜 예시로 봅니다.

처음 써보기실습

그대로 따라 하면 되는 첫 대화 세 개. 5분이면 됩니다.

원하는 답을 얻는 법

같은 일을 시켜도 결과가 달라지는 요령 다섯 가지. 나쁜 예와 좋은 예로.

같은 일을 세 번 시켜 비교하기실습

읽는 장이 아니라 하는 장입니다. 요령을 하나씩 얹으며 답이 어떻게 달라지는지 봅니다.

조심할 것

지어내기 · 오래된 정보 · 회사 정보. 언제 믿고 언제 확인할지.

맡기고 · 말하고 · 살피고 · 책임지기

AI와 일하는 동작은 네 가지입니다. 프롬프트 잘 쓰기는 그중 하나일 뿐인데, 대부분의 사고는 나머지 셋에서 납니다.

용어집

이 매뉴얼에 나오는 용어를 한 곳에. 모르는 말이 나오면 여기부터 보세요.

AI 도입과 AI 전환은 무엇이 다른가

같은 도구를 넣고도 한쪽은 지표가 움직이고 한쪽은 안 움직이는 이유.

왜 지금 필요한가

몇 년 전에는 안 되던 일이 지금은 되는 이유 — 세 가지가 동시에 바뀌었습니다.

전환이 실패하는 방식

세 가지 전형적인 실패와, 각각을 몇 개월차에 알아챌 수 있는지.

우리 조직의 준비도를 채점해보기실습

읽는 장이 아니라 하는 장입니다. 세 가지 실패 방식에 우리를 대입합니다.

과제를 고르는 세 가지 질문

할 수 있는 일은 늘 후보보다 많습니다. 무엇을 버릴지 정하는 기준.

품질 향상

고객 제품이 좋아지는가 — 효과는 늦게 나타나고 오래 갑니다.

비용 절감

가장 빨리 증명되는 영역. 그래서 첫 과제로 가장 적합합니다.

매출·마진 증대

임팩트가 가장 큽니다. 그리고 전제 조건도 가장 많습니다.

우선순위 정하기

임팩트 순서와 착수 순서는 반대입니다. 왜 그런지, 어떻게 정하는지.

과제를 실제로 채점해보기실습

읽는 장이 아니라 하는 장입니다. 후보 여섯 개를 적고 절반을 버립니다.

로드맵 전체 그림

4단계와, 각 단계를 넘어가도 되는지 판단하는 게이트.

Phase 1 — 문제 정의

AI가 해결할 수 있는 명확한 비즈니스 문제를 정의합니다.

Phase 2 — 데이터 · 시스템 진단

"만들 수 있는가"를 만들기 전에 확인합니다. 건너뛰면 POC 중간에 막힙니다.

규제와 컴플라이언스

AI 기본법은 2026년 1월 22일부터 이미 시행 중입니다. 우리가 대상인지부터 확인합니다.

AI로 만든 것을 밝히기

무엇을, 누구에게, 어디까지 밝히나. 면책 문구를 붙이는 일이 아니라 책임의 자리를 정하는 일입니다.

Phase 3 — POC 설계와 실행

가장 중요한 단계. 목적은 성공시키는 게 아니라 판정하는 것입니다.

POC를 한 장으로 설계해보기실습

읽는 장이 아니라 하는 장입니다. 중단 조건까지 적어야 끝납니다.

Phase 4 — 프로덕션 배포

확대는 권한을 넓히는 게 아니라 정착시키는 것입니다.

성과 측정과 보고

"좋아진 것 같다"는 예산을 못 받습니다. 배포 전에 재두지 않으면 영원히 증명 못 합니다.

베이스라인을 직접 설계해보기실습

읽는 장이 아니라 하는 장입니다. 오늘 안 재면 영원히 못 잽니다.

감사 기록과 관측

"에이전트가 왜 그랬나"에 답할 수 있어야 합니다. 무엇을 남기고 무엇을 남기면 안 되나.

변화관리

실패 원인 1위는 기술이 아니라 사람입니다. 로드맵에 안 적힌 절반.

컴퓨터는 지금 무엇을 하고 있나

저장·작업대·일꾼 셋만 구분하면 됩니다. "껐다 켜세요"가 왜 듣는지도 여기서 나옵니다.

파일 · 폴더 · 경로

경로 한 줄을 읽을 수 있으면 작업 폴더도 드라이브도 막히지 않습니다.

터미널과 명령어

검은 창이 왜 아직 남아 있는지, 그리고 command not found 가 무슨 뜻인지.

프로그램과 언어 — 파이썬 · 자바스크립트 · Node

왜 Node를 깔라고 하는지, 파이썬 예제는 왜 그렇게 자주 나오는지.

네트워크와 통신

IP · 포트 · 도메인. localhost:27777 이 무슨 뜻인지 여기서 풀립니다.

서버 · 클라이언트 · 클라우드

서버는 특별한 기계가 아닙니다. 그리고 클라우드는 남의 컴퓨터입니다.

요청과 응답 — HTTP

한 번의 왕복이 전부입니다. 401과 404가 왜 다른 문제인지도 여기서.

API란 무엇인가

프로그램에게 내주는 창구. 화면 대신 API를 쓰는 순간 무엇이 달라지는지.

요청 하나를 직접 뜯어보기실습

브라우저만 있으면 됩니다. 요청·응답·상태 코드를 눈으로 확인합니다.

데이터의 형태 — JSON · CSV · 문서

왜 어떤 파일은 AI가 그냥 읽고 어떤 파일은 변환이 필요한가.

데이터베이스란 무엇인가

표 · 행 · 열 · 키. 그리고 왜 엑셀로는 안 되는가.

계정 · 비밀번호 · API 키 · 권한

누구인가와 무엇을 해도 되는가는 다른 질문입니다.

기계의 네 가지 성질

언어 모델의 능력과 한계는 서로 다른 목록이 아닙니다. 같은 네 가지 성질의 양면입니다.

언어 모델은 무엇을 하는 기계인가

"다음에 올 말을 맞힌다"가 어떻게 요약과 번역이 되는지.

왜 그럴듯하게 틀리는가

환각은 고장이 아니라 구조에서 나옵니다. 그래서 없앨 수 없고 관리해야 합니다.

맞장구와 치우침

모델은 내 말에 동의하는 쪽으로 기울고, 배운 데이터 쪽으로 기웁니다. 둘 다 틀렸다고 말해주지 않습니다.

도구 사용

모델에 손을 달아주기 — 아는 것만 말하던 것이 찾아보고 실행하게 됩니다.

자료를 찾아 붙이기

모르는 것을 아는 척하지 않게 만드는 가장 확실한 방법. 검색해서 근거와 함께 답하게 합니다.

자료를 붙여보기실습

읽는 장이 아니라 하는 장입니다. 30분이면 됩니다.

어떤 학습을 고를까

"우리 데이터로 학습시키면 되지 않나요"에 대한 답. 학습에는 네 가지가 있고 그중 하나가 가장 비쌉니다.

에이전트 — 스스로 도는 루프

도구를 한 번 쓰는 것과 목표를 받아 끝까지 반복하는 것의 차이.

컨텍스트 창이란 무엇인가

모델이 지금 보고 있는 전부. 기억처럼 보이는 것의 정체.

컨텍스트가 밀려날 때

앞의 지시를 잊은 것처럼 구는 이유, 그리고 그걸 막는 습관.

컨텍스트를 일부러 넘겨보기실습

읽는 장이 아니라 하는 장입니다. 앞부분이 밀려나는 순간을 직접 만듭니다.

세션을 넘는 기억

대화가 끝나면 다 사라집니다. 남길 것을 남기는 세 개의 층.

좋은 지시의 네 가지 요소

목표 · 범위 · 완료 조건 · 맥락. 하나라도 빠지면 어디가 어긋나는지.

지시가 그대로 먹지 않는 이유

모델은 지시를 이해해서 지키는 것이 아니라, 지시가 적힌 글의 이어짐을 만듭니다. 그 차이가 사고를 만듭니다.

지시 고쳐쓰기실습

나쁜 지시 다섯 개를 직접 고쳐봅니다. 답을 보기 전에 먼저 써보세요.

평가(Evals)

"잘하고 있는지"를 감이 아니라 숫자로 아는 법. 조직에서는 필수입니다.

모델 고르기와 비용

제일 좋은 것 하나로 다 돌리면 3~5배를 더 냅니다. 어디에 무엇을 쓰고 무엇으로 아끼나.

도구 — 세 가지 꼴, 한 가지 목적

스킬 · 플러그인 · MCP 는 다른 물건이 아닙니다. 같은 것을 포장한 세 가지 방식이고, 그 구분은 만든 사람의 사정입니다.

도구가 많아질 때

200개를 붙이면 왜 정확도까지 떨어지는가, 그리고 골라 쓰는 장치.

읽은 것이 명령이 될 때

프롬프트 인젝션. 웹페이지·문서·메일에 심긴 문장이 에이전트의 지시가 되는 문제.

도구는 권한이다

꼴이 무엇이든 도구를 붙이는 것은 에이전트에게 권한을 주는 일입니다.

도구 권한 점검해보기실습

읽는 장이 아니라 하는 장입니다. 지금 켜져 있는 도구를 실제로 훑습니다.

MCP — 도구를 붙이는 공통 규격

도구 3개를 에이전트 3개에 붙이면 9번 만들어야 했던 시절.

MCP 서버가 주는 세 가지

도구 · 리소스 · 프롬프트 세 가지. 실무에서는 대부분 도구입니다.

애자일이 풀었던 문제와 남은 병목

2주 스프린트는 무엇에 맞춰진 숫자였나. 그리고 그 안에 무엇이 들어 있나.

하이퍼 애자일이 바꾸는 지점

스프린트를 억지로 줄이는 게 아닙니다. 사람이 하던 회의와 업무 조율을 AI가 알아서 처리하게 만듭니다.

마이크로 스프린트

핵심은 크기가 아니라 독립성입니다. 쪼개기만 해서는 안 되는 이유.

우리 백로그를 쪼개보기실습

읽는 장이 아니라 하는 장입니다. 진행 중인 일감 하나를 40분 안에 쪼갭니다.

IntentOps

개발자의 산출물이 코드에서 의도로 바뀝니다. 그러면 무엇을 책임지나.

유동적 소프트웨어

레거시의 정의가 바뀝니다. 대신 지켜야 할 것이 이동합니다.

프로세스 4단계 지도

익숙한 분석·설계·구현·시험은 어디로 갔나. 네 장을 읽기 전에 보는 지도.

프로세스 1 — 의도 포착

PM 에이전트가 되묻습니다. 여기서 남긴 애매함은 저절로 해결되지 않습니다.

프로세스 2 — 에이전트 오케스트레이션

사람 팀의 위계를 옮긴 게 아니라, 동시에 도는 역할들입니다.

프로세스 3 — 자동 검증

자가 치유 루프가 도는 곳. 그리고 이 방법론이 가장 자주 무너지는 곳.

검증 관문을 설계해보기실습

읽는 장이 아니라 하는 장입니다. 사람이 안 보고도 나갈 수 있는 조건을 적습니다.

프로세스 4 — 즉시 배포

배포가 끝이 아니라 다음 의도의 출발점입니다.

가드레일과 도입 전 점검

속도를 늦추는 장치가 아니라, 속도를 감당하게 하는 조건입니다.

하이퍼팀즈(HyperTeams)는 무엇인가

내 컴퓨터의 AI 에이전트를 웹 화면에서 시키는 관제실.

준비물

에이전트 CLI 하나와 Node.js. 각각 왜 필요하고 어떻게 확인하는지.

설치하기

한 줄이면 됩니다. 설치 중에 무엇을 물어보는지.

처음 켜고 접속하기

한 단어로 켜고 브라우저로 들어갑니다. 그리고 끄는 법.

첫 접속을 점검해보기실습

읽는 장이 아니라 하는 장입니다. 막히는 자리를 미리 한 번씩 통과합니다.

작업 폴더 등록하기

폴더 하나가 목록의 한 줄. 등록 기준과 나누는 요령.

첫 업무 맡기기실습

따라 하면 되는 첫 업무. 계획만 모드로 시작합니다.

업무 실행 원칙과 결과 보기

격리된 작업 폴더(Worktree), 백그라운드 프로세스 정리, 대시보드 렌더링 문법.

어디까지 맡길지 정하기

자율성 수준 네 가지와, 각각을 언제 쓰는지.

터미널

작업 폴더에서 계속 열려 있는 명령 창. 화면을 닫아도 살아 있습니다.

예약 실행

반복되는 일을 시간에 맡깁니다. 사람이 안 볼 때의 설계.

사용량 한도 다루기

한도는 도구가 아니라 계정에 붙습니다. 같은 구독으로 더 많은 일을 하는 법.

어디서나 접속하기

터널로 고정 주소를 만듭니다. 밖으로 여는 만큼 먼저 잠가야 합니다.

명령어 레퍼런스

켜기 · 끄기 · 다시 시작 · 설정 · 업데이트 · 삭제.

문제 해결

증상별로 찾아보는 장. 로그 보는 법부터.

멈춘 업무를 되살려보기실습

읽는 장이 아니라 하는 장입니다. 일부러 멈추고 순서대로 복구합니다.

두 개의 API 표면

기본은 꺼짐입니다. 무엇이 열리고 무엇은 안 열리는지부터.

REST로 업무 시키기

다른 시스템에서 내 컴퓨터에 일을 맡깁니다. 멱등 키가 없다는 것부터.

REST로 업무를 걸어보기실습

읽는 장이 아니라 하는 장입니다. 중복 실행까지 직접 만들어봅니다.

모델 갖추기 — 내려받고 띄우기

다음 장이 "내 컴퓨터의 모델이 응답합니다"라고 말하는 그 모델을, 여기서 갖춥니다.

내 컴퓨터를 모델 서버로

OpenAI 호환이라 SDK를 그대로 씁니다. base 주소만 바꾸면 됩니다.

음성과 이미지 다루기

글 → 음성, 음성 → 글, 이미지 생성. 그리고 OpenAI 규격에 없는 복제 목소리.

예약으로 파이프라인 만들기

예약에는 두 종류가 있습니다. 에이전트에게 맡기는 것과 명령을 실행하는 것.

파이프라인 하나를 끝까지 만들어보기실습

읽는 장이 아니라 하는 장입니다. 단계 셋을 잇고 가운데를 일부러 깨뜨립니다.

스킬로 절차를 담기

지시문보다 오래 가는 단위. 폴더가 곧 상태입니다.

문서를 자료로 바꾸기

PDF·워드·엑셀·파워포인트를 검색 가능한 사본으로. 그리고 git과의 관계.

사례 — 콘텐츠 공장

앞의 여섯 장을 하나로 잇습니다. 매일 도는 제작 파이프라인.

브라우저로 자료 모으기 — Crawlee + 스텔스

브라우저를 띄워야만 열리는 페이지에서 자료를 받는 법. 배선은 세 줄이고, 어려운 건 그 앞뒤입니다.

영상에서 자료 뽑기 — yt-dlp + 음성→글

유튜브·인스타·틱톡 영상을 자료로 바꾸는 법. 대부분의 경우 영상을 받을 필요조차 없습니다.

공문서 다루기 — hwp·hwpx

한글 문서를 읽고, 만들고, 서식을 채웁니다. 한컴오피스도 윈도우도 없이.

Connect는 무엇인가

팀이 함께 쓰는 AI 업무 공간. 하이퍼팀즈(HyperTeams)와 무엇이 다른지.

워크스페이스

모든 것이 그 아래에 있습니다. 어떻게 나눌지가 첫 결정입니다.

스레드

일 하나가 대화 하나. 창을 닫아도 계속 돕니다.

업무 보드 — 대화를 일감으로 보기

그룹을 열면 카드가 보입니다. 내 차례인 것, 도는 것, 아직 아무도 안 본 것.

업무 보드를 하루 돌려보기실습

읽는 장이 아니라 하는 장입니다. 대화 세 개를 일감으로 취급해봅니다.

계정과 워크스페이스 만들기

가입부터 워크스페이스 생성까지. 화면과 함께 따라갑니다.

첫 대화 따라하기실습

그대로 따라 하면 되는 세 개. 도구 호출까지 확인합니다.

슬래시 명령 — /every

입력창에서 바로 반복 업무를 만듭니다. 그리고 재시도는 명령이 아니라 기본입니다.

에이전트란

다섯 종류와 각각을 언제 쓰는지. 목록 화면 읽는 법.

서브 에이전트 만들기실습

지시문을 어떻게 쓰는지. 실제 예시 하나를 처음부터 끝까지.

MCP 서버 연결하기

두 방향이 있습니다. 밖에서 안으로, 안에서 밖으로.

데이터베이스 붙이기

PostgreSQL·MySQL·SQLite·MongoDB를 도구로. 읽기 전용 계정으로 시작하세요.

플레이그라운드

도구를 직접 호출해봅니다. 붙이기 전에 확인하는 자리.

도구 켜고 끄기

안 쓰는 도구를 끄는 것이 정확도를 올립니다.

드라이브

워크스페이스의 파일 보관함. 올리면 검색과 답변의 재료가 됩니다.

시스템 연결하기

내 컴퓨터를 워크스페이스에 등록합니다. 토큰은 비밀번호와 같습니다.

시스템 관리 — 자리와 주소

요금제가 포함하는 대수까지는 무료입니다. 자리·주소·태그가 각각 무엇인지.

예약 — 쌓아두고 시간에 맡기기

큐와 스케줄이 한 화면으로 합쳐졌습니다. 낱말도 하나입니다 — 예약.

예약을 하나 걸어보기실습

읽는 장이 아니라 하는 장입니다. 사람이 안 볼 때를 먼저 설계합니다.

채널 — 밖에서 들어오는 길

화면 말고 다른 길로 에이전트에 닿는 방법 네 가지.

이메일 에이전트

메일 주소 하나가 담당자가 됩니다. 보내면 답이 옵니다.

채팅 위젯

우리 웹사이트에 심는 상담 창구. 도메인을 반드시 제한하세요.

멤버와 역할

세 가지 역할과 각각이 할 수 있는 것. admin을 몇 명 둘지.

그룹과 부서

그룹은 대화를 묶고, 부서는 사람을 묶습니다. 권한은 부서에 주세요.

승인 대기와 작업자 권한

권한이 없는 사람의 요청은 실행 전에 멈춰 섭니다. 누가 그것을 풀어 주나.

권한을 실제로 나눠보기실습

읽는 장이 아니라 하는 장입니다. 사람 이름 대신 묶음에 권한을 겁니다.

사용량과 크레딧

총액이 아니라 분포를 보세요. 어디서 새는지가 거기 있습니다.

요금제와 등급

크레딧은 사서 채우는 게 아니라 플랜이 매달 발행합니다. 등급이 무엇을 열어 주는지.

API 키로 외부에서 부르기

워크스페이스 밖에서 대화를 겁니다. 키는 발급보다 회수가 어렵습니다.

알림 받기

앱을 닫아 둔 동안에도 폰으로 알립니다. 스위치는 헤더의 벨 안에 있습니다.

용어사전

우리 회사에서만 쓰는 약어를 등록합니다. 검색이 놓치던 것이 걸리기 시작합니다.

보안 검토를 위한 한 장

사내 도입 심사에서 나오는 질문들. 경계가 어디에 있고 무엇으로 통제하나.

데이터 마스킹

개인정보를 대체 문자로 바꾼 뒤에 모델로 보냅니다. 지우는 게 아니라 바꿉니다.

감사 로그

누가 무엇을 누구의 컴퓨터에 맡겼고, 누가 통과시켰고, 누가 권한을 바꿨는지 한 줄씩 남습니다.

감사 로그로 하루를 재구성해보기실습

읽는 장이 아니라 하는 장입니다. 질문 네 개에 로그만으로 답해봅니다.

SSO와 부서 동기화

사내 계정으로 로그인하고, 그쪽 그룹을 부서에 연결합니다.

문제 해결

안 될 때 무엇부터 보는지. 증상별로 순서대로.