Meeting Minutes

프로젝트 회의록 발행

디스코드 음성 회의 → 전사본 수신 → 회의록 작성 → 노션 등록 → 디스코드 공지까지의 정본 절차.

프로젝트 개요·인물·일정은 볼트 프로젝트/프로젝트.md 참조. 작업 폴더: ~/Projects/<프로젝트>/이벤트/버추얼 프로젝트

1. 전사본 받기

프로젝트 조사봇이 회의 종료 후 사용자 DM으로 transcript.md를 보낸다.

cd "~/Projects/<프로젝트>/이벤트/버추얼 프로젝트"
TOKEN=$(grep '^프로젝트_DISCORD_BOT_TOKEN=' .env | cut -d= -f2-)
CH=$(curl -s -X POST -H "Authorization: Bot $TOKEN" -H "Content-Type: application/json" \
  -H "User-Agent: DiscordBot (https://github.com/bambam/twc-pm, 1.0)" \
  -d '{"recipient_id":"<DISCORD_ID>"}' \
  "https://discord.com/api/v10/users/@me/channels" \
  | python3 -c "import json,sys;print(json.load(sys.stdin)['id'])")
bash scripts/twc-dm-download-transcripts.sh "$CH" "회의록 전사/_dm받은전사" 5

원본은 원격 머신 ~/Projects/<프로젝트>/recordings/<ISO시각>_1515265088167346317/ 에도 있다. 저장되는 건 발화자별 음성(.ogg/.pcm)과 transcript.md뿐 — 화면 영상은 없다.

받자마자 유실 여부를 확인한다 (2026-08-18 사고 후)

전사본을 열어 "(전사된 발언이 없습니다)"이거나 발화수가 비정상으로 적으면 보령을 본다.

ssh remote-host 'grep -E "녹음 시작|디코더 오류|전사 완료" ~/Projects/<프로젝트>/logs/bot.log | tail -20'

디코더 오류 <userId> The compressed data passed is corrupted 가 보이면 그 사람은 그 시점 이후 녹음이 안 된 것이다. 녹음 시작 직후(수 ms 내)에 뜨면 그 참석자 발언은 회의 전체가 없다. 봇이 들어올 때 이미 말하고 있던 사람이 걸린다.

• 원인이던 봇 버그(디코딩 실패 후 재구독 안 함)는 2026-08-19에 수정했고, 이제 발화 0건이거나 음성 0바이트인 참석자가 있으면 DM 상단에 경고 배너가 붙는다.
• 그래도 유실이 생기면 지어내지 말고, 회의록 상단 콜아웃에 "전사 유실 · 무엇을 근거로 썼는지"를 명시하고 참석자에게 DM으로 보완을 요청한다. 사례: 회차 18(8/18).

⚠️ 유실이면 발행보다 사본 요청이 먼저다

봇 녹음이 없다고 기록이 없는 게 아니다. 참석자가 개인 녹취를 갖고 있을 수 있다. 회의 주변 텍스트(디스코드 후속 대화)로 재구성한 문서를 먼저 발행하지 말고, 참석자에게 녹취 유무를 먼저 물어볼 것.

8/18 건은 디스코드 기록만으로 발행했다가 나중에 녹취를 받았는데, 회의 본론이 통째로 빠져 있었다. 주변 텍스트에 남는 건 회의 직후 후속 논의지 회의 그 자체가 아니다. 재구성본을 굳이 내야 한다면 "회의에서 나온 것"과 "회의 후에 오간 것"을 별도 절로 분리해야 나중에 원본이 나왔을 때 무엇이 빠졌는지 바로 보인다.

외부 녹취(mp3)를 받았을 때 전사하는 법

봇과 같은 파이프라인을 손으로 태운다. 무거우니 원격 머신에서 돌린다.

ssh remote-host 'mkdir -p ~/tmp/<이름>'
scp "<mp3>" remote-host:~/tmp/<이름>/raw.mp3
ssh remote-host 'cd ~/tmp/<이름> && /opt/homebrew/bin/ffmpeg -hide_banner -loglevel error -y \
  -i raw.mp3 -ac 1 -ar 16000 -c:a libopus -b:a 24k meeting.ogg'
# 42MB mp3 → 5MB ogg. Groq 25MB 제한을 안 넘긴다.

ssh remote-host 'cd ~/tmp/<이름> && KEY=$(grep -h "^GROQ_API_KEY=" ~/.config/watch/.env | cut -d= -f2- | tr -d "\"") && \
  curl -s -X POST "https://api.groq.com/openai/v1/audio/transcriptions" \
  -H "Authorization: Bearer $KEY" -F "file=@meeting.ogg" -F "model=whisper-large-v3" \
  -F "language=ko" -F "response_format=verbose_json" \
  -F "prompt=<고유명사 나열>" -o result.json'

• prompt에 고유명사를 넣으면 정확도가 크게 오른다. 공간명·캡틴 이름·콜라이더·베이킹 같은 도메인 용어.
• segments의 start에 녹음 시작 시각을 더해 절대 시각으로 바꿔 적으면 회의록 쓸 때 대조하기 쉽다.
• 개인 녹취는 화자 분리가 없다. 역할(피드백을 주는 쪽 / 구현 가능 여부를 답하는 쪽)로 판별하고, 그렇게 판별했다고 회의록 ⚠️참고에 밝힌다.
• 녹음 시작 시각이 회의 시작보다 늦으면 앞부분이 빠졌다고 명시하고 참석자에게 물어볼 것.
• 전사에서 숫자(폴리곤 상한·금액·비율)가 흔들리면 적지 말고 재확인을 요청한다. 지어내면 사고로 이어진다.

2. 읽기

60분 회의가 500줄/70KB 정도 된다. sed -n 으로 150~170줄씩 끊어 전부 읽는다. 요약본만 보고 쓰지 않는다. 발화자별 발화수를 먼저 세면 누가 주도했는지 잡힌다.

grep -o '^\[[0-9:]*\] [^:]*:' FILE | sed 's/^\[[0-9:]*\] //' | sort | uniq -c | sort -rn

직전 회의 회의록과 이전 체크포인트 전사를 함께 확인한다. 이번 회의의 "저번에 말한 거"가 무엇인지 모르면 액션아이템의 담당·기한을 틀리게 적는다.

3. 문서 2개를 만든다

작업 폴더 회의록 전사/ 아래에.

a. 공유본 <날짜>_<회의명>_회의록초안.md

구성 순서(기존 회의록과 동일하게 유지):

1. > 🗓 콜아웃 — 날짜·시각·길이·참석자·회차 맥락
2. ## 🎯 이 회의 한 줄 — 결론 한 문단
3. ## 📅 일정
4. ## 🧩 무슨 얘기를 했나 — 안건별 소제목, 발언 인용 포함
5. ## ✅ 결정사항 — 번호 목록
6. ## 📌 다음 할 일 (액션아이템) — 담당·할 일·기한 3열 표
7. ## ⚠️ 참고

a-2. 이전 회차 미결 항목 대조 (5.4 때문에 필수)

공유본을 쓰기 전에 워치리스트의 진행중 항목을 뽑아 이번 전사와 대조한다. 노션 🔭 프로젝트 워치리스트(YOUR_NOTION_DB_ID)에서 상태=진행중을 조회.

각 항목을 셋 중 하나로 분류해 "무슨 얘기를 했나"에 근거가 남게 쓴다.

• 확인됨 — 회의에서 실물로 시연·확인됨. 그 사실을 문장으로 남긴다. 예: "지하 녹음실은 특정 위치를 누르면 계단이 열리고, 방음 온오프 버튼도 작동하는 것을 확인했습니다."
• 언급만 됨 — 하겠다고 말만 나옴. 완료로 읽히지 않게 쓴다. 예: "해치 손잡이는 추가하겠다고 했으나 이번 회의에서 실물 확인은 없었습니다."
• 언급 없음 — 이번 회의에 안 나옴. ⚠️ 참고 절에 한 줄로 명시한다. 예: "창문 격자·스케일 1.2배는 이번 회의에서 언급되지 않아 진행 상황이 확인되지 않았습니다."

세 번째를 빠뜨리면 봇이 "언급이 없다"를 스스로 해석해야 해서 판정이 흔들린다. 명시해두면 red 로 정확히 유지된다.

b. PM전용메모 <날짜>_<회의명>_PM전용메모(대외비).md

공유본에서 뺀 것 + PM만의 액션. 뺄 것의 기준:

• 클라이언트(하이브·3Y) 비판·변덕에 대한 언급
• 미확정 계약·페이·정산 이야기
• 팀원 개인 사정·컨디션·리소스 문제
• 회식 등 비공식 논의

4. 노션 등록

DB: collection://YOUR_NOTION_DB_ID (📋 회의록)

회차는 직전 회의 +1. 먼저 확인:

notion-query-data-sources: SELECT "회차","제목","date:날짜:start" FROM "collection://YOUR_DATA_SOURCE_ID…" ORDER BY "회차" DESC LIMIT 5

참석자 relation은 인물 DB(collection://YOUR_NOTION_DB_ID) 페이지 URL로 넣는다.

⚠️ 알려진 버그: 노션 MCP로 숫자 속성을 못 넣는다. 회차(number)와 date:날짜:is_datetime(0/1)을 넘기면 문자열로 직렬화돼 Number values must be JavaScript numbers 로 실패한다. → 두 필드를 빼고 페이지를 만든 뒤, 브라우저로 열어 회차만 직접 입력한다. is_datetime은 생략하면 기본 0이라 문제없다.

5. 디스코드 공지

채널 📃회의-안건및기록 <DISCORD_ID>. 형식은 고정이다.

📋 **회의록 업데이트했습니다!**

· **<날짜> <회의명>** — <핵심 3개를 · 로 연결>
<노션 링크>

-# 사용자(PM)이 작성한 회의록을 봇으로 공유드립니다.

bash scripts/twc-discord-post.sh <DISCORD_ID> /tmp/msg.txt

리마인드·담당별 할 일 같은 팀 대상 공지는 파트 채널로 간다: 🗺️맵·트리거-회의 <DISCORD_ID> / 🖼️디자인-회의 1516891... / 💻영상-회의 <DISCORD_ID>

5.4 회의록 본문이 조사봇 판정 근거로 쓰인다 (2026-08-17부터)

전에는 조사봇(followup.py)이 최근 24시간 디스코드 텍스트만 보고 미결 항목을 판정했다. 그래서 음성 회의에서 시연·확인되고 끝나는 일(맵팀 작업이 대표적)은 증거가 어디에도 남지 않아, 실제로는 끝났는데 계속 "마감 지났는데 완료 안 됐어요"로 알림이 갔다.

이제 봇이 판정할 때 노션 회의록 본문을 함께 읽는다. 최근 14일 이내·최대 2건·건당 4000자. 환경변수 FOLLOWUP_MINUTES_DAYS / FOLLOWUP_MINUTES_COUNT / FOLLOWUP_MINUTES_CHARS 로 조절.

그래서 회의록 본문 서술이 그대로 봇의 판정 근거다.

• 무언가 작동하는 것을 확인했으면 그 사실을 본문에 적어라. "지하 녹음실: 특정 위치를 누르면 계단이 열리는 구조. 방음 온오프 버튼도 있고" 같은 서술 한 줄이 그 항목을 green 으로 닫는다.
• 반대로 아직 안 된 것도 본문에 적어야 red·yellow 로 잡힌다. 회의에서 확인 안 된 항목을 확인된 것처럼 쓰면 봇이 잘못 닫는다.
• 결정사항·액션아이템만 적고 "무슨 얘기를 했나"를 부실하게 쓰면 이 기능이 작동하지 않는다. 실물 확인·시연 내용을 구체적으로 남기는 게 봇 정확도로 직결된다.