부록
용어 인덱스
기본부터 에이전틱 엔지니어링까지 등장하는 주요 용어 180여 개를 주제별로 모은 인덱스입니다. 낯선 말이 나오면 여기서 찾아보세요.
강의를 따라가다 보면 처음 보는 말이 계속 나옵니다. 그때마다 검색하러 밖으로 나가지 않도록, 기본부터 에이전틱 엔지니어링까지 네 파트에서 등장하는 용어를 한곳에 모았습니다. 용어마다 한 줄 설명과 함께, 그 개념을 제대로 다루는 레슨으로 가는 링크를 붙여뒀습니다.
전체는 열세 개 분류입니다. 바이브코딩과 AI, Claude Code, 개발 기초, 웹과 네트워크, 데이터베이스와 저장소, Git과 GitHub, 디자인, 인증과 보안, 에이전틱 워크플로우, 배포와 도메인, 런칭과 운영, 코드베이스 관리와 CI, 그리고 하네스와 작업 자동화 순서로 이어집니다.
바이브코딩과 AI
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 바이브코딩 | 코드를 직접 짜는 대신, 만들고 싶은 것을 자연어로 설명해 AI가 만들게 하는 방식 | 바이브코딩이란 |
| 에이전틱 엔지니어링 | 한 번의 요청을 넘어, 에이전트가 반복해서 잘 일하도록 환경과 흐름을 설계하는 단계 | 바이브코딩 뛰어넘기 |
| LLM | 글을 읽고 쓰는 능력을 학습한 대규모 언어 모델. 코딩 에이전트의 두뇌 | 코딩 에이전트와 Claude Code |
| 코딩 에이전트 | LLM에 파일 읽기·쓰기, 명령 실행 같은 도구를 붙여 개발 작업을 맡길 수 있게 만든 프로그램 | 코딩 에이전트와 Claude Code |
| 프롬프트 | AI에게 보내는 작업 요청 문장 | 바이브코딩이란 |
| 토큰 | 모델이 글을 읽고 쓸 때 세는 기본 단위 | 메모리 구조 파악하기 |
| 컨텍스트 윈도우 | 모델이 한 번의 대화에서 기억할 수 있는 분량의 한계 | 메모리 구조 파악하기 |
| Deep Research | AI가 여러 자료를 검색하고 교차 확인해 조사 보고서를 만들어주는 기능 | 딥 리서치를 활용한 시장 조사 |
| Markdown | AI가 문서를 만들 때 기본으로 쓰는 텍스트 문서 형식 | AI가 만든 문서 읽기 |
Claude Code
우리가 강의 내내 쓰는 도구, Claude Code를 다루는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| Claude Code | 터미널에서 실행하는 Anthropic의 코딩 에이전트 | 코딩 에이전트와 Claude Code |
| 권한 모드 | Claude Code가 어디까지 물어보지 않고 실행할지 정하는 설정 | Claude Code 기본 사용법 |
| plan 모드 | 바로 고치지 않고 계획부터 세워 보여주는 권한 모드 | Claude Code 기본 사용법 |
| 슬래시 명령어 | /clear처럼 /로 시작하는 Claude Code 내장 명령 | Claude Code 기본 사용법 |
| 컨텍스트 | 에이전트가 지금 대화에서 들고 있는 모든 정보 | 메모리 구조 파악하기 |
| CLAUDE.md | 프로젝트의 규칙과 맥락을 적어두면 에이전트가 매 세션 읽고 시작하는 메모리 파일 | 메모리 구조 파악하기 |
| Skill | 자주 반복하는 작업 방식을 파일로 저장해 불러 쓰는 즐겨찾기 | SKILL 핵심 파악하기 |
| MCP | 에이전트를 캘린더, 데이터베이스 같은 외부 도구와 연결하는 표준 규격 | MCP 핵심 파악하기 |
개발 기초
코드와 실행을 이해하기 위한 최소한의 밑말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 터미널 | 명령어를 입력해 컴퓨터를 다루는 창 | 터미널과 IDE 이해하기 |
| CLI | 화면 클릭 대신 명령어로 조작하는 방식의 인터페이스 | 터미널과 IDE 이해하기 |
| IDE | 코드를 읽고 고치기 위한 편집기. 우리는 VS Code를 씁니다 | 터미널과 IDE 이해하기 |
| 경로 | 컴퓨터 안에서 파일이 있는 위치를 나타내는 주소 | 터미널 사용해보기 |
| Node.js | 브라우저 밖에서 JavaScript를 실행하게 해주는 프로그램 | node · npm 설치 |
| npm | Node.js 세계의 라이브러리 설치 도구 | node · npm 설치 |
| 변수 | 값을 담아두고 이름을 붙인 것 | 코드 기본 개념 |
| 자료형 | 숫자, 문자열처럼 값의 종류 | 코드 기본 개념 |
| 함수 | 자주 쓰는 동작을 묶어 이름 붙인 것 | 코드 기본 개념 |
| 조건문 | 상황에 따라 다른 코드를 실행하게 하는 문법 | 코드 기본 개념 |
| 반복문 | 같은 일을 여러 번 실행하게 하는 문법 | 코드 기본 개념 |
| 주석 | 실행되지 않는 설명용 메모 | 코드 기본 개념 |
| 에러 | 코드가 실행을 멈추며 남기는 문제 신호 | 코드 기본 개념 |
| 로그 | 프로그램이 실행 중에 남기는 기록 | 코드 기본 개념 |
| 빌드 | 코드를 실행 가능한 형태로 바꾸는 과정 | 코드와 프로세스 |
| 프로세스 | 실행 중인 프로그램 | 코드와 프로세스 |
| 서버 | 요청을 받으면 응답을 돌려주는, 계속 떠 있는 프로세스 | 코드와 프로세스 |
| 라이브러리 | 필요한 기능만 가져다 쓰는 코드 묶음 | 라이브러리와 프레임워크 |
| 프레임워크 | 앱의 뼈대, 규칙, 실행 흐름을 미리 정해둔 틀 | 라이브러리와 프레임워크 |
| Next.js | 카공맵을 만들 때 쓰는 React 기반 웹 프레임워크 | Scaffolding: 프로젝트 구조 잡기 |
| Scaffolding | 프로젝트의 첫 뼈대 구조를 만드는 작업 | Scaffolding: 프로젝트 구조 잡기 |
| 환경 변수 | API 키처럼 코드 밖에서 따로 주입하는 설정값 | Scaffolding 결과 리뷰하기 |
웹과 네트워크
브라우저와 서버 사이에서 무슨 일이 일어나는지 설명하는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| IP 주소 | 인터넷에서 컴퓨터를 찾아가는 숫자 주소 | 웹과 HTTP |
| 포트 | 한 컴퓨터 안에서 프로그램별로 나눠 쓰는 통신 문 번호 | 웹과 HTTP |
| URL | 웹에서 특정 페이지나 자원을 가리키는 주소 | 웹과 HTTP |
| DNS | 도메인 이름을 실제 서버의 IP로 바꿔주는 시스템 | 웹과 HTTP |
| HTTP | 브라우저와 서버가 요청과 응답을 주고받는 대화 규격 | 웹과 HTTP |
| 요청과 응답 | 브라우저가 묻고 서버가 답하는 웹의 기본 리듬 | 웹과 HTTP |
| 상태 코드 | 200, 404처럼 응답 결과를 요약한 숫자 | 웹과 HTTP |
| 프로토콜 | 컴퓨터끼리 서로 알아듣기 위한 대화 형식, 규격 | 웹과 HTTP |
| 프론트엔드 | 사용자 눈에 보이는 화면 쪽 | 프론트엔드와 백엔드 |
| 백엔드 | 데이터와 규칙을 처리하는 서버 쪽 | 프론트엔드와 백엔드 |
| 클라우드 | 서버를 직접 두지 않고 빌려 쓰는 서비스 | 프론트엔드와 백엔드 |
| API | 프로그램끼리 기능을 주고받기로 약속한 창구 | API |
| REST API | URL과 HTTP 동사로 자원을 다루는, 가장 흔한 API 패턴 | API |
| API 키 | 외부 서비스가 누가 쓰는지 확인하는 비밀 문자열 | 카카오맵 SDK 설정하기 |
| SDK | 외부 서비스를 코드에서 쉽게 쓰도록 제공되는 도구 묶음 | 카카오맵 SDK 설정하기 |
| JSON | 중괄호와 키-값 쌍으로 데이터를 표현하는 형식. API 응답의 표준 | 데이터 읽기 (JSON) |
| CSV | 쉼표로 구분한 표 형태의 데이터 파일 | 데이터 읽기 (JSON) |
데이터베이스와 저장소
서비스가 오래 기억해야 하는 것들을 다루는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 데이터베이스 | 서비스가 오래 기억해야 하는 정보를 저장하는 곳 | 데이터베이스 |
| 관계형 데이터베이스 | 데이터를 표(테이블)로 관리하고 표끼리 연결하는 방식 | 데이터베이스 |
| SQL | 데이터베이스와 대화하는 언어 | 데이터베이스 |
| 테이블·컬럼·row | 데이터를 담는 표, 표의 세로 항목, 그리고 가로 한 줄 | 데이터베이스 스키마 설계하기 |
| 스키마 | 어떤 테이블에 어떤 컬럼을 둘지 정한 설계도 | 데이터베이스 스키마 설계하기 |
| Postgres | 카공맵에서 쓰는 대표적인 오픈소스 관계형 데이터베이스 | 데이터베이스 스키마 설계하기 |
| Supabase | Postgres에 인증, 스토리지까지 얹어 제공하는 백엔드 서비스 | Supabase 활용하기 |
| 마이그레이션 | 스키마 변경을 기록해두고 순서대로 적용하는 방법 | places 테이블 마이그레이션하기 |
| 파일 스토리지 | 이미지 같은 파일을 저장하고 URL로 제공하는 저장소 | 파일 스토리지 적용하기 |
Git과 GitHub
코드의 역사를 남기고 되돌릴 수 있게 해주는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| Git | 코드 변경 이력을 기록하고 되돌릴 수 있게 하는 버전 관리 도구 | Git 기본기 다지기 |
| 커밋 (commit) | 변경 내용을 하나의 저장 지점으로 기록하는 것 | Git 기본기 다지기 |
| 브랜치 (branch) | 원본을 건드리지 않고 갈라져 나와 작업하는 줄기 | Git 기본기 다지기 |
| 머지 (merge) | 갈라진 브랜치의 작업을 다시 합치는 것 | Git 기본기 다지기 |
| GitHub | Git 저장소를 온라인에 올려두고 협업하는 서비스 | GitHub 사용법 익히기 |
| Repository | 프로젝트 코드와 그 역사가 담긴 저장소 | GitHub 사용법 익히기 |
| Local과 Remote | 내 컴퓨터의 저장소와 GitHub에 있는 저장소 | GitHub 사용법 익히기 |
| push · fetch · pull | 내 커밋을 올리고, 원격 변경을 가져오고, 가져와서 합치는 세 가지 동작 | GitHub 사용법 익히기 |
| Pull Request | 내 브랜치의 변경을 합쳐달라고 요청하고 리뷰받는 절차 | GitHub 사용법 익히기 |
.gitignore | Git이 추적하지 않을 파일을 적어두는 목록 | 조금 더 공부하기 |
| reset · stash | 변경을 되돌리거나 잠시 치워두는 명령 | 조금 더 공부하기 |
| worktree | 같은 저장소를 브랜치별로 다른 폴더에 열어, 여러 작업을 동시에 진행하게 해주는 기능 | Git Worktree로 여러 에이전트 병렬 실행하기 |
디자인
화면의 생김새를 다듬을 때 쓰는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| HTML | 웹 화면의 구조를 만드는 마크업 언어 | Claude Code에게 디자인 수정 요청하기 |
| CSS | 색, 간격, 배치 같은 화면의 생김새를 정하는 언어 | Claude Code에게 디자인 수정 요청하기 |
| 개발자 도구 | 브라우저에서 화면 요소를 찍어 구조와 스타일을 확인하는 도구 | Claude Code에게 디자인 수정 요청하기 |
| 바이브 디자인 | 시안 도구로 방향을 잡고 구현은 AI에게 맡기는 디자인 흐름 | 바이브 디자인으로 방향 잡기 |
| Shadcn | 복사해서 바로 쓰는 React UI 컴포넌트 모음 | 바이브 디자인으로 방향 잡기 |
| 디자인 시스템 | 색, 글자, 간격의 규칙을 한 벌로 정리한 것 | DESIGN.md로 디자인 시스템 고정하기 |
| DESIGN.md | 디자인 시스템을 파일로 고정해 에이전트가 매번 따르게 하는 문서 | DESIGN.md로 디자인 시스템 고정하기 |
인증과 보안
누가 들어오고, 무엇까지 할 수 있는지 정하는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 인증 | 지금 요청한 사람이 누구인지 확인하는 것. 로그인 | 인증과 인가 이해하기 |
| 인가 | 그 사람이 이 일을 해도 되는지 확인하는 것. 권한 | 인증과 인가 이해하기 |
| 소셜 로그인 | 카카오 같은 외부 계정으로 로그인을 대신하는 방식 | 카카오 로그인·Supabase 설정 |
| Callback URL | 외부 로그인이 끝난 사용자를 되돌려보낼 우리 서비스의 주소 | 카카오 로그인·Supabase 설정 |
| RLS | 데이터베이스가 row 단위로 누가 무엇을 보고 고칠 수 있는지 강제하는 규칙 | Supabase RLS 설정 |
| 세션 | 로그인 상태를 유지시켜 주는 장치 | 보안과 권한 체크리스트 |
| 권한 매트릭스 | 역할별로 무엇을 할 수 있는지 표로 정리한 것 | 보안과 권한 체크리스트 |
| 민감정보 | 비밀번호, API 키, 개인정보처럼 밖으로 새면 안 되는 값 | 보안과 권한 체크리스트 |
에이전틱 워크플로우
에이전트에게 큰 작업을 믿고 맡기기 위한 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 에이전틱 워크플로우 | 계획, 구현, 검증, 학습까지 한 단위로 이어지는 작업 흐름 | 에이전틱 워크플로우란 |
| clarify | 구현하기 전에 질문으로 요구사항을 좁히는 단계 | 계획하고 구현하기 |
| PRD | 무엇을 만들고 무엇을 만들지 않을지 적어둔 구현 기준 문서 | 계획하고 구현하기 |
| implement | PRD를 기준 삼아 에이전트에게 구현을 맡기는 단계 | 계획하고 구현하기 |
| 기계 검증 | lint, 타입 체크, 테스트처럼 기계가 돌려주는 검사 | 검증 고도화하기 |
| 에이전트 검증 | 에이전트가 코드를 읽고 직접 실행해보며 확인하는 검사 | 검증 고도화하기 |
| 사람 검증 | 마지막에 사람이 직접 눈으로 확인하는 단계 | 검증 고도화하기 |
| lint | 코드의 형식과 흔한 실수를 잡아주는 정적 검사 도구 | 작업 전에 검증 환경 만들기 |
| 타입 체크 | 값의 종류가 맞게 쓰였는지 실행 전에 확인하는 검사 | 작업 전에 검증 환경 만들기 |
| 테스트 | 이 입력이면 이 결과가 나와야 한다는 조건을 코드로 박아 자동으로 확인하는 것 | 작업 전에 검증 환경 만들기 |
| Playwright | 브라우저를 코드로 조작해 사용자처럼 테스트하는 도구 | 검증 고도화하기 |
| pre-commit | 커밋 직전에 검사를 자동으로 돌려주는 장치 | 작업 전에 검증 환경 만들기 |
| 코드 리뷰 | 변경된 코드를 사람이나 다른 에이전트의 눈으로 한 번 더 훑는 절차 | 긴 작업 태워보기 |
| learn | 작업에서 배운 것을 프로젝트 파일로 남겨 다음 작업에 쓰는 마무리 단계 | 배운 걸 프로젝트에 남기기 |
배포와 도메인
내 컴퓨터의 코드를 세상에 내보내는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 배포 | 내 컴퓨터에서 돌던 코드를 모두가 접속할 수 있는 서버에 올리는 일 | 서버 배포 기본 이해 |
| Vercel | GitHub와 연결해 push만으로 배포까지 해주는 호스팅 서비스 | Vercel로 카공맵 배포하기 |
| GitHub Actions | push할 때마다 검사와 배포를 자동으로 돌리는 GitHub의 자동화 기능 | 서버 배포 기본 이해 |
| 배포 환경 | 로컬, 프리뷰, 프로덕션처럼 같은 서비스를 단계별로 나눠 운영하는 것 | 서버 배포 기본 이해 |
| 도메인 | IP 주소 대신 쓰는, 사람이 읽을 수 있는 서비스 주소 | 나만의 도메인 설정하기 |
| 네임서버 | 내 도메인에 대한 DNS 질문에 답해주는 서버 | 나만의 도메인 설정하기 |
| DNS 레코드 | 도메인을 어디로 연결할지 적어두는 항목. A, CNAME 등 | 나만의 도메인 설정하기 |
런칭과 운영
첫 사용자를 맞이하고, 서비스를 계속 살아 있게 하는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| OG 태그 | 링크를 공유했을 때 보이는 미리보기 제목과 이미지 정보 | 주변에 링크를 공유하기 전에 |
| SEO | 검색 엔진에 잘 발견되게 만드는 작업 | SEO/GEO 기본 점검하기 |
| 크롤러 | 검색 엔진과 AI가 웹페이지를 읽으러 다니는 프로그램 | SEO/GEO 기본 점검하기 |
| robots.txt · sitemap | 크롤러에게 어디를 읽어도 되는지, 무슨 페이지가 있는지 알려주는 파일 | SEO/GEO 기본 점검하기 |
| GEO · AEO | 검색 결과가 아니라 AI의 답변에 인용되도록 최적화하는 작업 | SEO/GEO 기본 점검하기 |
| 크롤링 (스크래핑) | 공식 API가 없을 때, 사람이 보는 화면을 프로그램이 대신 읽어오는 방식 | 장소 데이터 수집을 위한 크롤링 이해하기 |
| 정적 페이지 · 동적 페이지 | 원하는 정보가 처음 받은 HTML에 이미 있는지(정적), JS를 실행해야 나타나는지(동적) | 장소 데이터 수집을 위한 크롤링 이해하기 |
| 봇 감지 (Bot Detection) | 자동화 도구로 접속했는지 판별해서 차단하는 방어 장치 | 장소 데이터 수집을 위한 크롤링 이해하기 |
| Claude in Chrome | 평소 쓰는 크롬 브라우저를 Claude Code가 직접 조작하게 해주는 확장 프로그램 | 브라우저 자동화로 장소 후보 수집하기 |
| 관리자 페이지 | 운영자가 제보와 데이터를 처리하는 별도 화면 | 관리자 페이지 개발하기 |
| 에러 대응 4단계 | 파악, 재현, 해결, 배포·확인 순서로 도는 문제 해결 절차 | 에러 대응 4단계 |
| 재현 | 같은 문제 상황을 다시 만들어 눈으로 확인하는 것 | 에러 대응 4단계 |
| 로그 레벨 | info, warn, error처럼 로그의 심각도를 구분하는 표시 | 주요 지점에 로그 남기기 |
| 모니터링 | 지표와 로그로 서비스 상태를 계속 지켜보는 일 | 서비스 상태와 운영 신호 모니터링하기 |
| 지표 | 응답 시간, 에러율처럼 서비스 상태를 숫자로 요약한 것 | 서비스 상태와 운영 신호 모니터링하기 |
| 방문 · 이벤트 · 속성 | 사용자가 페이지에 들어옴 / 의미 있는 행동을 함 / 그 행동에 딸린 정보 | 사용자 행동 분석하기 |
| 퍼널 · 전환 · 이탈 | 목표까지 가는 단계 순서 / 원한 행동이 실제로 일어남 / 다음 단계로 가지 않고 나감 | 사용자 행동 분석하기 |
| CTA · 유입 경로 | 사용자가 다음 행동을 하게 만드는 버튼·문구 / 사용자가 들어온 경로 | 사용자 행동 분석하기 |
| 프로덕트 애널리틱스 | 방문·이벤트·전환 같은 사용자 행동을 숫자로 보고 다음 개선을 고르는 분석 분야. Mixpanel, GA, Amplitude 같은 도구로 합니다 | 사용자 행동 분석하기 |
| 인덱스 (index) | 책의 목차처럼, 자주 찾는 조건을 빠르게 찾게 해주는 장치 | 성능과 비용 문제 고민해보기 |
| 전체 조회 (full scan) | 목차 없이 데이터를 처음부터 끝까지 훑는 조회. 데이터가 많아지면 그대로 느려집니다 | 성능과 비용 문제 고민해보기 |
| 페이지네이션 | 데이터를 한 번에 다 가져오지 않고 조금씩 나눠 가져오는 방식 | 성능과 비용 문제 고민해보기 |
| 캐시 (Cache) | 한 번 만든 결과를 저장해뒀다가 다시 쓰는 기법. 브라우저·서버·CDN 등 여러 층에서 반복됩니다 | 성능과 비용 문제 고민해보기 |
| CDN | 파일을 우리 서버 대신 사용자와 가까운 캐시 서버에서 내보내, 속도와 전송량을 함께 아끼는 방식 | 성능과 비용 문제 고민해보기 |
| 로컬 환경 · 운영(프로덕션) 환경 | 내 컴퓨터에서 도는 개발 환경과, 실제 사용자가 쓰는 배포된 서비스 | 로컬과 운영 환경 구분하기 |
| 프리뷰 배포 | PR·브랜치마다 임시 URL로 배포해서 결과를 확인하는 환경 | 로컬과 운영 환경 구분하기 |
| 스테이징 | 운영과 최대한 비슷한 별도 서버·DB에서 배포 전 마지막으로 리허설하는 환경 | 로컬과 운영 환경 구분하기 |
| Docker | 실행 환경을 통째로 담아 어디서든 똑같이 재현할 수 있게 해주는 도구 | 로컬과 운영 환경 구분하기 |
코드베이스 관리와 CI
제품으로 오래 갈 코드를 만들고, 그 위에 자동 검증을 얹는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 코드베이스 | 한 프로젝트에 쌓인 코드 전체. 파일 하나가 아니라 그 묶음을 가리키는 말 | 지속가능한 서비스를 위한 코드베이스 |
| KISS · YAGNI | 구조는 단순하게, 지금 필요 없는 건 미리 만들지 말라는 두 원칙 | 지속가능한 서비스를 위한 코드베이스 |
| DRY | 같은 규칙이나 기준값은 코드베이스 안에 한 곳에만 두라는 원칙 | 지속가능한 서비스를 위한 코드베이스 |
| 리팩토링 | 동작은 그대로 두고 코드 안쪽 구조만 정리하는 작업 | 코드베이스 리팩토링하기 |
| 변경분 (diff) | 이번에 바뀐 부분만 추려낸 것. 코드 리뷰가 보는 대상 | 코드베이스 리팩토링하기 |
| 죽은 코드 | 아무 데서도 쓰지 않는데 남아 있는 파일이나 함수 | 코드베이스 리팩토링하기 |
| 의존성 | 내 코드가 돌아가려면 함께 있어야 하는 외부 라이브러리와 패키지 | 코드베이스 리팩토링하기 |
| 변경 여파 (blast radius) | 한 곳을 고쳤을 때 같이 흔들리는 범위. 좁을수록 먼저 손대기 안전합니다 | 코드베이스 리팩토링하기 |
| CI (Continuous Integration) | 코드가 합쳐지기 전에 자동으로 검증을 돌리는 단계 | GitHub Actions 환경 구성하기 |
| GitHub Secrets | 저장소에 안전하게 보관해두고 워크플로우에서만 꺼내 쓰는 비밀값 저장소 | PR에 코드 리뷰/보안 점검 워크플로우 붙이기 |
| Claude Code Action | GitHub Actions 안에서 Claude Code를 실행해주는 공식 액션 | PR에 코드 리뷰/보안 점검 워크플로우 붙이기 |
하네스와 작업 자동화
에이전트가 매번 같은 기준으로 움직이게 하고, 사람 없이도 작업이 굴러가게 만드는 말들입니다.
| 용어 | 뜻 | 배우는 곳 |
|---|---|---|
| 하네스 (Harness) | 에이전트가 매번 참고할 맥락, 도구, 경계, 검증 방식을 묶어 둔 작업 환경 | 하네스 엔지니어링 이해하기 |
| 가드레일 | 정해진 시점에 자동으로 실행돼, 사람이 승인하기 전에 위험한 동작을 막는 장치 | 하네스 엔지니어링 이해하기 |
| Hook | 도구 실행 직전·직후 같은 정해진 시점에 자동으로 실행되는 장치. 글이 아니라 실행이라 에이전트가 판단할 여지가 없습니다 | Claude Code의 메모리·가드레일·워크플로우 장치 이해하기 |
| Rules | .claude/rules/에 두고, 파일 패턴(paths)에 걸리는 종류의 파일을 열 때만 불러오는 세분화된 메모리 | Claude Code의 메모리·가드레일·워크플로우 장치 이해하기 |
| Subagent | 메인 에이전트가 조사나 반복 작업을 넘기는 별도 컨텍스트의 에이전트. 결과만 메인 창으로 돌아옵니다 | Claude Code의 메모리·가드레일·워크플로우 장치 이해하기 |
| auto memory | Claude가 대화 중 알아낸 것을 스스로 파일에 적어두는 메모리. 사람이 쓰는 CLAUDE.md와 달리 Claude가 직접 씁니다 | Claude Code의 메모리·가드레일·워크플로우 장치 이해하기 |
| Draft PR | 아직 리뷰를 요청하지 않은, 작업 중임을 표시하는 PR 상태 | GitHub Actions를 활용해 에이전트 작업 자동화하기 |
| GitHub Issue | 저장소 안에서 할 일·버그·요청을 기록하고 추적하는 GitHub 기본 기능. 에이전트 작업의 티켓으로 씁니다 | GitHub Actions를 활용해 에이전트 작업 자동화하기 |
| 라벨 (label) | Issue에 붙여 작업 가능·실행 중·확인 필요 같은 상태를 표시하는 태그 | GitHub Actions를 활용해 에이전트 작업 자동화하기 |
| self-hosted runner | GitHub이 아니라 내가 직접 켜둔 컴퓨터에서 GitHub Actions 작업을 실행하는 방식 | GitHub Actions를 활용해 에이전트 작업 자동화하기 |
| loop · Routine · schedule | 내 컴퓨터에서 세션을 반복 실행 / desktop app으로 컴퓨터만 켜지면 실행 / 클라우드에서 정해진 시각에 실행, 세 가지 자동 반복 방식 | 에이전트 작업 자동화의 전체 구조 이해하기 |
여기 없는 용어를 만나면 AI에게 바로 물어보세요.