Slack에서 쿠키가 함께 일하기 위한 규칙

1. 무슨 일이 있었나

쿠키는 Slack을 작업 큐와 기록 장소로 쓰는 규칙을 만들었습니다. 이후 쌀떡이 여러 차례 스레드 상단 수정, 원래 작업 스레드 답변, 긴 스레드 분리 누락을 지적했습니다.

2. 문제가 된 지점

쿠키는 작업 결과를 만들고도 Slack 운영 마무리를 빠뜨렸습니다. 특히 “작업 완료 보고”와 “상단 인덱스 카드 갱신”을 같은 종료 조건으로 묶지 못했습니다.

반복된 실패:
구현/검증 완료 → Slack에 결과 보고 → 상단 인덱스 카드 갱신 누락
긴 스레드 계속 사용 → 50개 이상 누적 → 이어가기 스레드 생성 지연
threadId로 보냈다고 생각 → 실제 receipt는 다른 스레드 → 원래 작업 스레드 이탈

3. 어떻게 해결했나

• Slack 작업은 답변 전 `어느 스레드가 본류인가`를 먼저 확인합니다.
• 상단 인덱스 카드는 50개 기준이 아니라, 의미 있는 진행이 있으면 갱신 대상입니다.
• 50개 안팎으로 길어진 스레드는 이어가기 스레드를 만들고 기존 스레드에 인계 댓글을 남깁니다.
• 메시지를 보낸 뒤 receipt.threadId가 의도한 부모와 맞는지 확인합니다.
• user-authored 상단 글과 bot-authored 글은 각각 맞는 편집 경로를 사용합니다.

4. 도입하거나 수정한 규칙

• 규칙 이름: Slack work-thread closeout gate
• 적용 상황: Slack에서 긴 작업, 구현 보고, 상태판 갱신, continuation thread 생성
• 핵심 기준: 작업 결과 보고만으로 끝내지 않고, 스레드 위치·상단 카드·다음 행동까지 닫습니다.

5. 바로 재사용할 조각

Slack closeout:
1. 답변할 parent/replyTo 확인
2. 작업 후 상단 카드 갱신 필요 여부 확인
3. 댓글이 길면 continuation thread 생성
4. 메시지 전송 후 receipt.threadId 확인
5. 편집 실패 시 author-context에 맞는 편집 경로 재시도
6. 그래도 실패하면 같은 스레드에 fallback 카드와 blocker를 남김

6. 무엇을 배웠나

Slack 운영규칙은 문서에 있다는 이유로 적용되지 않습니다. 작업 종료 직전에 반드시 실행되는 체크가 되어야 합니다.

7. 다음부터 적용할 기준

Slack에서 의미 있는 작업을 완료하거나 중간 보고할 때마다, 답변 위치와 상단 카드 갱신 여부를 함께 확인합니다.

8. 관련 프로젝트 / 프로세스

쿠키 인프라 유지보수 / Slack 운영

9. 한줄 멘트

Slack에서 일한 결과는 메시지 하나가 아니라, 다음에 찾을 수 있는 스레드 상태까지 포함합니다.