daily-brief-bot

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번 해보자" 처리 절차

1. 원문 전문부터 읽는다. 브리핑 요약만 보고 시작하지 마라.

   ssh remote-host 'cat ~/Projects/<프로젝트>/state/brief-<날짜>.md'
   

   해당 항목의 링크에서 post ID를 뽑아 posts-<날짜>.json에서 body를 꺼낸다.

2. 사용자 볼트의 관련 노트를 읽는다. 브리핑의 "사용자 쪽 연결" 줄에 적힌 노트를 실제로 열어본다. 남이 쓴 방법을 그대로 옮기지 말고, 사용자가 이미 가진 것과 겹치는 부분을 먼저 확인한다.

3. 사용자 환경 기준으로 다시 짠 실행안을 제시하고 승인받는다.

   • 원문에서 그대로 쓸 것 / 사용자 환경에 맞게 바꿀 것 / 안 쓸 것을 구분해서 보여준다
   • 되돌리기 어려운 작업(배포, 결제, 삭제)은 승인 전에 절대 실행하지 않는다

4. 실행한다. 무거운 작업이면 원격 머신로 넘긴다(macmini-offload 스킬).

5. 끝나면 기록한다.

   • 볼트: 새 노트를 만들지 말고 기존 노트에 한 줄 덧붙인다. [[위키링크]] 문법 지킬 것. 예) 참고: 정본노트를 채널별 브리프로 분리하는 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 의 "말투와 어휘" 절에 있다.