| name | daily-brief-bot |
| description | 매일 정해진 시간에 관심 주제 아티클을 수집·요약해 디스코드로 받는 봇을 만들고 튜닝한다. 톤·길이·발송 시각 조정 방법 포함. |
데일리 브리프봇
사용자는 매일 아침 10시에 디스코드 DM으로 데일리 브리프봇 아티클을 받는다.
지피터스(gpters.org) 신규 글을 전부 읽고, 사용자의 제2두뇌 볼트·에이사이드 스킬/메모리와 대조해
사용자가 지금 붙들고 있는 고민에 닿는 3건을 골라 편지 형식으로 보낸다.
각 항목에 번호(1~3)와 원문 링크가 붙어 있다.
"여백"은 이 봇이 후보를 고르는 내부 판정 기준을 부르는 말이다(볼트에 한 번도 안 나온 것).
사용자에게 말할 때는 봇 이름인 데일리 브리프봇으로 부른다.
트리거
- "데일리 브리프봇 고치자" — 톤·길이·건수·시간 등 편집. 아래 편집 표 참고
- "데일리 브리프봇 2번 해보자" / "8/13 2번 해보자" / "어제 그거 해보자" — 실행
- "오늘 데일리 브리프봇 뭐 왔어" — 읽어주기만
- "이거 볼트에 넣어" — 볼트 승격
- 옛 호칭 "여백 브리핑"으로 불러도 같은 것을 가리킨다
인프라 위치 (전부 원격 머신, ssh remote-host)
~/Projects/<프로젝트>/
prompt-template.md ★ 톤·형식·길이·몇 건을 결정하는 유일한 파일. 편집은 거의 여기만 고친다
collect.mjs 지피터스 신규 글 수집 (Bettermode GraphQL, 게스트 토큰 · 로그인 불필요)
brief.mjs 볼트·스킬·메모리 대조 → 후보 22건 추린 뒤 템플릿에 끼워 프롬프트 생성
verify.mjs 브리핑 링크가 실제 수집분인지 대조·정정
dm.py 디스코드 DM 발송 (stdin → 사용자 DM, 1900자씩 분할)
capture.py 사용자의 DM 답장 회수 (10분마다)
run.sh 매일 10:00 전체 실행 (launchd com.bambam.gpters-brief)
.env DISCORD_TOKEN / BAMBAM_USER_ID / CLAUDE_CODE_OAUTH_TOKEN (600)
ctx/ 맥북에서 동기화한 에이사이드 skills/ · memory/ ("이미 하고 있는 것" 판정용)
state/
posts-YYYY-MM-DD.json 그날 수집한 글 전문
brief-YYYY-MM-DD.md 그날 보낸 아티클
marks.jsonl 사용자가 DM에서 표시한 관심 항목
done.jsonl 실제로 실현한 항목 (재제안 금지 목록)
사용자 볼트: ~/Library/Mobile Documents/com~apple~CloudDocs/제2두뇌 (원격 머신에서도 접근됨)
현재 확정된 형식 (2026-08-13 사용자 승인)
- 아티클이다. 목록이나 알림이 아니다. 링크를 하나도 안 눌러도 내용을 다 알 수 있어야 한다.
- 문체는 "사용자님" + 해요체의 편지. 관찰 보고서 금지.
- 첫 문단은 반드시 "요즘 ~에 걸려 계신 것 같아요" 로 시작해 고민을 한 가지로 짚는다.
노트 제목 나열 금지. 틀려도 좋으니 구체적으로 짚는다.
- 3건, 전체 1만자 안팛. 앞 2건은 짚은 고민에 바로 닿는 것, 마지막 1건은 안 해본 것.
- 각 항목: 그 사람 상황 → 무엇을 어떻게 했는지(도구·프롬프트·숫자 그대로) → 결과
→ 사용자님 쪽이랑 겹치는 데(볼트·스킬 근거) → "이거 한번 시도해보시면 어때요?" → 오늘 30분 → 원문 링크
편집 요청 처리
사용자가 "데일리 브리프봇 고치자" 계열로 말하면 아래에서 해당하는 파일만 고친다.
| 요청 | 고칠 곳 |
|---|
| 톤, 문체, 형식, 길이, 몇 건, 어떤 순서로, 금지 표현 | prompt-template.md ← 거의 전부 여기 |
| 어떤 글을 후보로 올릴지 (점수 기준, 후보 개수, 활동 판정 기간 7일) | brief.mjs |
| 어떤 카테고리를 수집할지, 몇 건 가져올지 | collect.mjs |
| 보내는 시각 | ~/Library/LaunchAgents/com.bambam.gpters-brief.plist → 수정 후 unload/load |
| 모델 (클로드 → 코덱스 폴백) | run.sh |
고친 뒤에는 반드시 한 번 돌려보고 결과를 보여준 다음 발송한다.
ssh remote-host 'cd ~/Projects/<프로젝트> && node brief.mjs && set -a && . ./.env && set +a && claude -p < state/prompt-<날짜>.txt'
맥북 스킬/메모리가 바뀜으면 판정 근거도 갱신해야 한다.
rsync -az --delete 스킬 폴더 remote-host:~/Projects/<프로젝트>/ctx/skills/
rsync -az --exclude='.history.jsonl' --exclude='memory-index.json' --exclude='.moss-cache' --exclude='.git' 에이전트 메모 remote-host:~/Projects/<프로젝트>/ctx/memory/
"데일리 브리프봇 N번 해보자" 처리 절차
-
원문 전문부터 읽는다. 브리핑 요약만 보고 시작하지 마라.
ssh remote-host 'cat ~/Projects/<프로젝트>/state/brief-<날짜>.md'
해당 항목의 링크에서 post ID를 뽑아 posts-<날짜>.json에서 body를 꺼낸다.
-
사용자 볼트의 관련 노트를 읽는다. 브리핑의 "사용자 쪽 연결" 줄에 적힌 노트를 실제로 열어본다.
남이 쓴 방법을 그대로 옮기지 말고, 사용자가 이미 가진 것과 겹치는 부분을 먼저 확인한다.
-
사용자 환경 기준으로 다시 짠 실행안을 제시하고 승인받는다.
- 원문에서 그대로 쓸 것 / 사용자 환경에 맞게 바꿀 것 / 안 쓸 것을 구분해서 보여준다
- 되돌리기 어려운 작업(배포, 결제, 삭제)은 승인 전에 절대 실행하지 않는다
-
실행한다. 무거운 작업이면 원격 머신로 넘긴다(macmini-offload 스킬).
-
끝나면 기록한다.
- 볼트: 새 노트를 만들지 말고 기존 노트에 한 줄 덧붙인다.
[[위키링크]] 문법 지킬 것.
예) 참고: 정본노트를 채널별 브리프로 분리하는 OSMU 방식 — https://...
새 개념 노트가 필요할 정도면 사용자에게 먼저 묻는다.
done.jsonl에 한 줄 추가:
ssh remote-host 'echo "{\"date\":\"2026-08-13\",\"no\":2,\"post\":\"<postId>\",\"title\":\"...\",\"result\":\"...\"}" >> ~/Projects/<프로젝트>/state/done.jsonl'
이게 있으면 같은 주제를 다시 제안하지 않는다.
설계 원칙 (사용자가 직접 정한 것)
- 여백 = 사용자가 지금 하는 일과 인접한데, 볼트 761개 노트에 한 번도 기록된 적 없는 것.
미결 목록은 고민이 아니다. 사용자가 선택을 안 한 건 그냥 넘긴 것일 수 있다.
- "지금 하는 일"은 사용자에게 묻지 말고 볼트에서 최근 7일 수정된 노트로 판단한다.
- 읽지 않은 것은 볼트에 넣지 않는다. 브리핑 원본은 원격 머신에 30일만 두고 자동 삭제된다.
볼트로 올라가는 건 사용자가 표시했거나 실제로 해봤을 때뿐이다.
- 억지로 4개를 채우지 않는다. 그날 걸리는 게 없으면 비운다.
- 볼트가 커질수록 "이미 아는 것"이 두꺼워져 여백이 좁아진다. 그게 정상이다.
톤
- 이모지 쓰지 않는다.
- 금지 표현: "~이 아니라" 대조 구문, "굴러가다", "여정", "진짜 기준", 안심시키려는 문장.
- 볼트에 없는 걸 있다고 말하지 않는다. 근거는 실제 노트 경로로 댄다.
아바타 교체
후보 4종이 원격 머신 ~/Projects/<프로젝트>/assets/ 에 있다 (b_bot 적용 중 / a_owl / c_book / d_cat).
사용자가 로봇을 골랐다. 40px 원형으로 잘려도 눈 두 개와 안테나 라임 점이 살아남는다.
커뮤니티 브랜드 컬러 기준: 배경 #0d0d0d, 강조 #d4f000. 디스코드는 작은 원으로 잘리니 여백을 넉넉히 둔 단순한 형태만 쓴다.
ssh remote-host 'cd ~/Projects/<프로젝트> && set -a && . ./.env && set +a && python3 -c "
import os,json,base64,urllib.request
img=base64.b64encode(open(\"assets/b_bot.png\",\"rb\").read()).decode()
H={\"Authorization\":\"Bot \"+os.environ[\"DISCORD_TOKEN\"],\"User-Agent\":\"DiscordBot (https://github.com, 1.0)\",\"Content-Type\":\"application/json\"}
r=urllib.request.Request(\"https://discord.com/api/v10/users/@me\",data=json.dumps({\"avatar\":\"data:image/png;base64,\"+img}).encode(),headers=H,method=\"PATCH\")
print(json.load(urllib.request.urlopen(r))[\"username\"])"'
어휘 수준 (2026-08-13 교정)
사용자는 개발자가 아니다. 읽다가 모르는 단어가 하나라도 나오면 실패다.
전문용어는 처음 나올 때 괄호로 풀고, 영어 약어는 우리말로 바꾸고, 명령어·코드는 역할 설명이 붙을 때만 쓴다.
단 숫자와 구체적 사실은 그대로 살린다. 쉽게 쓰라는 게 내용을 빼라는 뜻이 아니다.
자세한 규칙은 prompt-template.md 의 "말투와 어휘" 절에 있다.
