현장에서 있었던 일
이름으로 프로세스를 끄면 남의 일까지 꺼져요
상황
한 개발 장비에서 여러 에이전트가 같은 테스트 명령을 동시에 돌리고 있었어요.
위험
한 에이전트가 정리한다며 이름으로 프로세스를 끄면 다른 에이전트의 테스트까지 함께 끊겨요.
바꾼 것
지침에 '자기가 띄운 PID만 끈다'를 적었어요. 그 뒤로 모든 세션이 이 규칙으로 시작했어요.
1주차 · 에이전트와 일하는 기본기 — 18
커머스 AI 운영 실전 8주 과정 · 1주차
에이전트는 무엇을 보고, 무엇을 못 보는가
난이도 LV.1 입문
수업 3시간 · 자료 4시간 40분
실습: contto.ai 70% 클론
1 / 8
이번 주 목표
01
클로드 코드·코덱스를 설치·로그인하고, 전용 실습 폴더에서 안전하게 시작해요.
02
RULES.md 한 장과 포인터 파일로 어떤 엔진이든 같은 규칙을 읽게 해요.
03
PRD v0.1을 쓰고 메뉴 5개와 브랜드 추가·목록을 만들어 커밋해요.
1주차 · 에이전트와 일하는 기본기 — 2
진행 순서
진한 칸(코어)만 하면 3시간 수업이에요. 회색 칸은 확장·자습이에요.
0:00
복습 리뷰
0:20
개념 핵심
1:05
개념 심화
1:20
영상 노트
1:40
강사 시연
2:10
실습 1
3:20
실습 2 도전
4:05
상급 노하우
4:25
회고 과제
1주차 · 에이전트와 일하는 기본기 — 3
진행 순서 · 자세히
| 시간 | 순서 | 내용 | 구분 |
|---|---|---|---|
| 0:00–0:20 | 복습·과제 리뷰 | 과정 지도, 설치 확인, 실습 폴더 만들기 | 코어 |
| 0:20–1:05 | 개념 (핵심) | 에이전트의 반복, 모르는 것, 지침 한 장, 권한 | 코어 |
| 1:05–1:20 | 개념 (심화) | 토큰과 다음 토큰 예측, 만들기 난이도 2×2 | 확장 |
| 1:20–1:40 | 참고 영상 노트 | CNV 1단계, 핵심은 Skill | 확장 |
| 1:40–2:10 | 강사 시연 | 빈 폴더에서 미니 콘토 뼈대까지 | 코어 |
| 2:10–3:20 | 실습 1 (기본) | 지침·포인터·PRD v0.1·메뉴·브랜드 목록 | 코어 |
| 3:20–4:05 | 실습 2 (도전) | 같은 요청을 두 엔진으로 비교 | 확장 |
| 4:05–4:25 | 상급 노하우 | 하네스 엔지니어링: 훅과 거부 규칙 | 확장 |
| 4:25–4:40 | 회고·과제 | 잘된 것·막힌 것 하나씩, 과제 안내 | 코어 |
1주차 · 에이전트와 일하는 기본기 — 4
과정 지도
1
1주 지침·PRD·메뉴 뼈대
2
2주 요청서·결정·DB 연결
3
3주 URL 자동 설정·스킬
4
4주 만들기·워크트리·PR
5
5주 상태·검수 8항목·E2E
6
6주 에이전트·승인 관문
7
7주 배포·가짜 올리기·원장
8
8주 운영 현황·데모데이
1주차 · 에이전트와 일하는 기본기 — 5
미니 콘토 지도
가입·로그인은 만들지 않아요. 이번 주는 메뉴 5개 껍데기와 브랜드 목록이에요.
미니 콘토
contto.ai 70% 클론
브랜드
등록·URL 자동 설정
고객 유형
누구에게 말할지
만들기
이미지·슬라이드·스레드
고르기·승인
사람이 마지막 관문
올리기(가짜)
예약·포인트 원장
운영 현황
성과가 다음 재료로
1주차 · 에이전트와 일하는 기본기 — 6
개념 1
좋은 결과는 멋진 프롬프트보다 '확인'이 들어간 반복에서 나와요.
읽기
파일·검색으로 이해
행동
권한 안에서 실행
확인
테스트·출력 보기
에이전트 루프
한 번 답할 때도 여러 번 돌아요
1주차 · 에이전트와 일하는 기본기 — 7
개념 2
모르는 것 다섯
말하지 않으면 추측해요
팀의 규칙
RULES.md에 적기 · 오늘
지난 세션의 결정
인계 문서 · 3주차
내 의도와 완료 기준
요청서 · 2주차
배포된 서비스 상태
확인 명령·로그 · 7주차
되돌릴 수 없는 일
거부 규칙·확인 · 오늘
1주차 · 에이전트와 일하는 기본기 — 8
개념 3
엔진이 바뀌어도 규칙은 한 곳에서만 고쳐요.
답변 첫 줄
이번에 읽은 파일을 적게 해요
확인포인터 파일
CLAUDE.md는 @RULES.md 한 줄, AGENTS.md도 'RULES.md 먼저' 한 줄
엔진별RULES.md
명령·구조·규칙·하지 말 것·보고 형식을 한 장에. 규칙은 여기서만 고쳐요
토대1주차 · 에이전트와 일하는 기본기 — 9
개념 4
멈춰야 할 곳에서 멈추는 설정이 좋은 설정이에요.
자동 허용
읽기·검색
허용 또는 확인
폴더 편집
자주 쓰는 것만
테스트·빌드
항상 사람 확인
삭제·배포
격리·커밋 후
무승인 모드
1주차 · 에이전트와 일하는 기본기 — 10
개념 5
처음 익힐 명령
버전마다 이름이 조금 달라요
/model
모델·추론 강도 · 시작할 때
/usage · /status
남은 사용량 · 긴 작업 전
/compact
대화 요약 · 길어졌을 때
/clear
완전히 비움 · 주제가 바뀔 때
/init
지침 초안 · 처음 한 번
Esc
멈추기 · 엉뚱한 방향일 때
1주차 · 에이전트와 일하는 기본기 — 11
개념 6
나
사람에이전트
AI1. PRD 초안을 써 줘
2. 초안 작성
3. 결정할 것 하나 질문
4. 답 또는 '권장대로'
5. 가입 화면 가정 등장
6. 틀린 가정 바로 지적
7. PRD v0.1 저장
1주차 · 에이전트와 일하는 기본기 — 12
개념 7 · 심화
답하는 동안 모델은 안 바뀌어요. 그래서 지침은 짧게, 확인은 반드시.
1
글이 토큰 조각으로 잘려요
2
모델이 다음 토큰을 계산해요
3
후보마다 확률이 붙어요
4
온도가 높으면 고르게 퍼져요
5
확률대로 하나를 뽑아요
1주차 · 에이전트와 일하는 기본기 — 13
개념 8 · 심화
미니 콘토는 1~6주는 왼쪽 위, 7주차 배포부터 오른쪽 아래로 가요.
내 PC에서만
인터넷에 올리면
나만 써요
1~6주 미니 콘토는 여기예요
키·권한·공개 범위를 챙겨요
남도 써요
남이 헷갈리지 않게 만들어요
7주차 배포부터 여기예요
1주차 · 에이전트와 일하는 기본기 — 14
운영 루프에서
오늘 만든 지침은 다섯 칸 모두의 규칙이 돼요.
1
데이터: 브랜드 URL·사진·반응
2
AI: 분석·생성·판정 (2~6주)
3
승인 관문: 사람이 고르기 (6주)
4
실행: 올리기·예약 (7주)
5
성과 원장: 다음 재료 (8주)
6
관문을 지나야 실행돼요
1주차 · 에이전트와 일하는 기본기 — 15
참고 영상 노트
출처: CNV AI 「AI 에이전트 만들기 1단계 — Codex·Claude·Gemini를 하나의 환경에서」 · https://www.youtube.com/watch?v=bSpwsDM5pqo&t=94s
01:34
사람은 목표와 기준을, 경로는 에이전트가 골라요.
05:08
1등 엔진보다 엔진과 상관없는 작업 환경이 중요해요.
46:13
터미널 셋에 같은 요청을 주고 결과를 비교해요.
70:34
사용량 확인, 요약, 비우기를 먼저 익혀요.
무승인 실행은 실습 폴더 안에서, 커밋해 둔 뒤에만.
1주차 · 에이전트와 일하는 기본기 — 16
참고 영상 노트
출처: CNV AI 「핵심은 Skill입니다 — 비용·할루시네이션을 줄이는 방법」 · https://www.youtube.com/watch?v=_eEXg1mNp8I&t=117s
01:57
기억·인내·속도는 이미 에이전트가 나아요.
05:39
설명서, 노하우, 실행 코드를 한 묶음으로 줘요.
07:41
도구를 먼저 만들고 나중에 쓰는 분업이 환각을 줄여요.
10:13
판단은 사람과 에이전트, 실행은 검증된 도구가 맡아요.
RULES.md에 한 줄: 판단은 사람과 에이전트, 실행은 검증된 도구.
1주차 · 에이전트와 일하는 기본기 — 17
현장에서 있었던 일
상황
한 개발 장비에서 여러 에이전트가 같은 테스트 명령을 동시에 돌리고 있었어요.
위험
한 에이전트가 정리한다며 이름으로 프로세스를 끄면 다른 에이전트의 테스트까지 함께 끊겨요.
바꾼 것
지침에 '자기가 띄운 PID만 끈다'를 적었어요. 그 뒤로 모든 세션이 이 규칙으로 시작했어요.
1주차 · 에이전트와 일하는 기본기 — 18
강사 시연 30분
볼 것: 답변 첫 줄의 '읽은 파일' · AI의 결정 질문 · 요청 안 한 변경
01
사람실습 폴더·git init·클로드 코드 실행
02
AI공식 문서를 찾아 Next.js 생성
03
AIRULES.md + 포인터 파일 두 개
04
AI결정 질문에 답하고 메뉴·브랜드 목록
05
사람diff 읽고 커밋, 새 세션에 '뭘 읽었어?'
사람 승인 관문
1주차 · 에이전트와 일하는 기본기 — 19
시연 프롬프트
# 1) 환경
최신 공식 문서를 검색해서 Next.js(App Router)+TypeScript+Tailwind
프로젝트를 이 폴더에 만들어 줘. 실행 명령과 결과를 보고해.
# 2) PRD
contto.ai를 70% 클론하는 '미니 콘토' PRD 초안을 docs/PRD.md에 써 줘.
가입·로그인은 없음. 결정이 필요한 것만 한 번에 하나씩 물어봐.
# 3) 첫 화면
메뉴 5개(홈·콘텐츠·운영 현황·브랜드·설정) 껍데기와
브랜드 추가·목록을 data/brands.json에 저장하는 것까지만 만들어.
끝나면 바꾼 파일 목록과 확인 방법을 보고해.
1주차 · 에이전트와 일하는 기본기 — 20
실습 1 · 70분
1주차 · 에이전트와 일하는 기본기 — 21
실습 힌트
| 상황 | 이렇게 말해요 |
|---|---|
| 설치가 안 돼요 | "에러 전문이야. 원인을 먼저 설명하고 고쳐 줘" |
| 지침을 안 읽어요 | "답변 첫 줄에 읽은 파일을 적어. 안 읽히면 읽히게 장치를 만들어" |
| 너무 많이 만들어요 | "메뉴 껍데기와 브랜드 목록까지만. 나머지는 하지 마" |
| 뭘 했는지 모르겠어요 | "바꾼 파일과 이유를 표로 보고해" |
| 결과가 이상해요 | 기대와 다른 점 한 문장 + 화면 캡처를 붙여요 |
1주차 · 에이전트와 일하는 기본기 — 22
실습 2 · 도전 45분
완료: 비교표 1장(5항목 이상) · 규칙 1줄 · 두 엔진이 같은 지침을 읽은 증거
01
사람같은 RULES.md·PRD를 둔 폴더 두 개
02
AI클로드 코드·코덱스에 브랜드 목록 화면
03
사람시간·사용량·바꾼 파일 수·질문 수
04
사람두 결과를 실행해 나란히
사람 승인 관문
05
사람고른 이유를 RULES.md에
1주차 · 에이전트와 일하는 기본기 — 23
템플릿
# 미니 콘토 — 에이전트 규칙 (모든 엔진 공통)
## 명령 실행: pnpm dev 테스트: pnpm test
## 구조 app/ 화면·API · lib/ 로직 · data/ 로컬 데이터
## 규칙
- 답변 첫 줄에 이번에 읽은 파일을 적는다
- 판단은 사람과 에이전트, 실행은 검증된 도구(스크립트)로
- 화면 이름은 contto.ai를 따른다 (홈·콘텐츠·운영 현황·브랜드·설정)
## 하지 말 것
- .env* 파일을 읽거나 출력하거나 커밋하지 않는다
- 실제 SNS·결제·광고 API를 호출하지 않는다 (가짜만)
- 이름으로 프로세스를 끄지 않는다 (자기 PID만)
## 보고 형식 바꾼 것 · 확인 방법과 결과 · 확인 못 한 것
1주차 · 에이전트와 일하는 기본기 — 24
안전 체크
실행
모르는 명령은 설명부터, 서버는 PID로 끄기
매번연결
실제 계정·게시는 연결 안 함, 구독 로그인, 종량제 키는 한도부터
키
API 키는 .env.local에만, .gitignore에 .env* 확인, 커밋 금지
격리
실습은 전용 폴더에서만, 무승인 실행 전에 커밋이나 백업
토대1주차 · 에이전트와 일하는 기본기 — 25
흔한 실수
| 실수 | 무슨 일이 생기나 | 대신 이렇게 |
|---|---|---|
| '알아서 잘 해 줘' | 세션마다 다르게 만들어요 | RULES.md에 규칙으로 |
| 엔진별로 지침을 따로 | 규칙이 서로 어긋나요 | 메인 한 장 + 포인터 |
| 처음부터 무승인 모드 | 되돌릴 수 없는 명령이 바로 실행 | 폴더 격리·커밋 후에만 |
| diff를 안 읽고 커밋 | 요청 안 한 변경이 섞여요 | 커밋 전에 diff 읽기 |
| 한 번에 다 만들어 달라 | 환각과 과잉 구현 | 단계로 쪼개 요청 |
1주차 · 에이전트와 일하는 기본기 — 26
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| command not found | 설치 경로가 PATH에 없음 | 터미널 재시작, 설치 문서대로 PATH |
| 로그인 창이 안 열려요 | 브라우저 권한·기본 브라우저 | 출력된 URL을 직접 열기 |
| pnpm·npm 권한 오류 | 실행 정책·권한 문제 | 에러 전문을 주고 원인부터 요청 |
| 포트 3000 사용 중 | 이전 서버가 살아 있음 | 자기가 띄운 PID만 확인 후 종료 |
| 한도 초과 메시지 | 5시간·주간 사용 한도 | 사용량 확인, 작은 단계로 나눠 진행 |
1주차 · 에이전트와 일하는 기본기 — 27
자습 목록 · 확장
| 자료 | 볼 구간 | 볼 것 |
|---|---|---|
| CNV AI 1단계 | 27:13–51:16 | CLI 설치·로그인, 무승인 실행의 위험 |
| CNV AI 핵심은 Skill | 01:31–02:34, 05:39–11:15 | 판단과 실행의 분리 |
| 양실장 LLM 원리 | 05:48–30:47 | 토큰·다음 토큰 예측·파라미터 |
| 양실장 3시간 강의 | 00:00–21:22 | 결과물 읽는 능력, 난이도 2×2 |
| 공식 문서 | 클로드 코드·코덱스 시작하기 | 설치, 권한, 지침 파일 |
1주차 · 에이전트와 일하는 기본기 — 28
상급 노하우
| 기법 | 어떻게 | 왜 |
|---|---|---|
| 지침은 짧은 지도 | RULES.md 200줄 안쪽, 반복된 실수만 한 줄씩. 긴 절차는 스킬로 | 길수록 지켜지는 비율이 떨어져요 |
| 포인터 파일 | CLAUDE.md는 @RULES.md, AGENTS.md는 'RULES.md를 먼저 읽는다' 한 줄 | 엔진이 달라도 같은 규칙을 읽어요 |
| '항상' 규칙은 훅으로 | PreToolUse로 .env*·기존 마이그레이션 수정을 막아요 | 지침은 권고, 훅은 반드시 실행돼요 |
| 거부 규칙 | deny: .env* 읽기, 실제 발송 스크립트 실행 | 편한 모드에서도 멈출 곳은 멈춰요 |
1주차 · 에이전트와 일하는 기본기 — 29
상급 노하우 · 예시
심화 과제(선택): settings에 거부 규칙 2개와 PreToolUse 훅 1개를 넣고, 실제로 막히는 장면을 캡처해요
// .claude/settings.json (미니 콘토, 커밋)
{
"permissions": {
"allow": ["Bash(pnpm test)", "Bash(pnpm lint)", "Bash(git diff *)"],
"deny": ["Read(./.env*)", "Bash(node scripts/send-real*)"]
},
"hooks": { "PreToolUse": [{ "matcher": "Edit|Write",
"hooks": [{ "type": "command", "command": "scripts/guard.sh" }] }] }
}
# guard.sh: .env* 나 기존 migrations 파일을 고치려 하면 exit 2
# CLAUDE.md: @RULES.md AGENTS.md: 먼저 RULES.md 를 읽는다
1주차 · 에이전트와 일하는 기본기 — 30
과제와 다음 주
다음 수업 첫 20분에 두 명이 화면을 보여 줘요.
다음 주
PRD를 v0.2로 키우고, 기술 결정 15개를 AI와 1문1답으로 정한 뒤 브랜드 등록을 DB에 저장해요.
1주차 · 에이전트와 일하는 기본기 — 31