📝 한줄 요약
매주 Linear 이슈를 하나하나 확인하며 프로젝트 업데이트를 작성하던 걸, 슬랙에서 /project-update 한 번이면 AI가 자동 요약해주는 시스템을 만 들었습니다.
🎯 이런 분들께 도움돼요
Linear로 프로젝트 관리하는데 매주 업데이트 작성이 귀찮은 분
Slack + Linear 연동 자동화를 만들고 싶은 개발자/비개발자
AI 코딩 도구로 사내 업무 자동화를 시도해보고 싶은 분
😫 문제 상황 (Before)
프로젝트 담당자로서의 고충
매주 금요일, 프로젝트 업데이트를 써야 했습니다. Linear를 열고, 이번 주에 뭘 했는지 이슈를 하나하나 클릭해서 확인하고, "만든 결과"와 "만들 결과"로 분류해서 정리하는 작업. 솔직히 30분은 걸렸습니다.
이 리스트를 보고
아래처럼 정리해야함
이니셔티브 리드로서의 고충
더 큰 문제는 이니셔티브 리드 역할이었습니다. 팀원들이 각자 프로젝트 업데이트를 작성하면, 저는 그걸 모아서 "이번 주 이니셔티브 전체 업데이트"를 만들어야 했거든요. 각 프로젝트 들어가서 업데이트 확인하고, 복붙하고, 정리하고... 시간이 정말 많이 듭니다.
(이니셔티브 안에 프로젝트가 여러개면 *n배 시간이 듭니다)
🛠️ 사용한 도구
도구명: OpenCode (Claude Code 기반 AI 코딩 도구)
모델: Claude Opus 4.5
기술 스택: Cloudflare Workers, Slack Slash Command, Linear GraphQL API
🔧 작업 과정
1. 프로젝트 담당자용 /project-update 만들기
먼저 프로젝트 담당자가 쓸 기능부터 만들었습니다. 슬랙에서 /project-update를 치면, 내 가 리드인 프로젝트의 이번 주 이슈들을 자동으로 가져와서 "만든 결과"와 "만들 결과"로 분류해주는 거죠.
프로젝트 담당자들이 매주 프로젝트 상태 업데이트를 작성해야 하는데, 이슈들을 일일이 확인하면서 요약하기 너무 귀찮아. 슬래시 커맨드로 "만든 결과" / "만들 결과"를 자동으로 요약해줬으면 좋겠어.
AI가 Linear API로 이슈를 가져오고, 상태별로 자동 분류하는 로직을 만들었습니다:
만든 결과: Done 상태 (이번 주 완료) + In Review 상태
만들 결과: In Progress 상태 + 다음 사이클 예정 이슈
각 이슈는 Claude Haiku가 50자 이내로 한 줄 요약해줍니다. 덕분에 슬랙에서 바로 업데이트 초안을 볼 수 있게 됐어요.
이렇게 슬랙에서 프로젝트 업데이트 뽀시래기를 선택하면
쌈빡하게 정리해줍니다.
이걸 보고 적절히 수정해서 복붙하면 됩니다.
2. 이니셔티브 리드용 /initiative-update 만들기 - 공식 문서에 없는 API 찾기
이제 이니셔티브 리드용 기능을 만들 차례였습니다. 여러 프로젝트의 업데이트를 한 번에 모아서 보여주는 기능이요.
프로젝트 담당자들이 /project-update로 프로젝트 업데이트를 작성하면, 이니셔티브 리드가 여러 프로젝트의 업데이트를 모아서 통합 업데이트를 만들어야 해. 이걸 자동화해줘.
그런데 문제가 생겼습니다. Linear API 공식 문서에 Initiative(이니셔티브) 관련 API가 없었어요.
여기서 AI가 빛을 발했습니다. GitHub에서 Linear API를 실제로 사용하는 코드들을 검색해서, initiative, initiatives, projectUpdates 같은 쿼리를 찾아냈거든요. 공식 문서에는 없지만 실제로 동작하는 API를 발견한 거죠.
덕분에 필요한 세 가지 쿼리를 구현할 수 있었습니다:
내가 리드인 이니셔티브 목록 조회
이니셔티브에 속한 프로젝트 목록 조회
각 프로젝트의 업데이트 내용 조회
3. AI가 프로젝트별 핵심 성과를 불릿으로 정리
이니셔티브에 프로젝트가 5개 있으면, 각 프로젝트 업데이트를 그대로 보여주는 건 너무 길어요. 그래서 AI가 각 프로젝트 업데이트에서 핵심 성과 2-3개만 뽑아서 불릿으로 정리해주도록 했습니다.
결과적으로 /initiative-update를 실행하면 이런 메시지가 옵니다:
✅ 결과 (After)
Before vs After
항목
Before
After (예상)
프로젝트 업데이트 작성
30분 (이슈 하나하나 확인)
5분 (/project-update + 복붙)
이니셔티브 통합 업데이트
30분+ (각 프로젝트 취합)
5분 (/initiative-update 실행)
아직 팀 전체 배포 전이라 예상 수치입니다. 배포 후 실제 효과를 업데이트할 예정이에요.
결과물
/project-update: 본인이 리드인 프로젝트의 이슈 자동 분류 + AI 요약/initiative-update: 이니셔티브 소속 프로젝트 업데이트 통합 조회 + AI 요약
💬 이 과정에서 배운 AI 활용 팁
효과적이었던 것
공식 문서에 없는 API는 GitHub 코드 검색으로 찾기 - AI가 실제 사용 예시를 찾아서 바로 구현할 수 있었습니다
분류 로직을 명확하게 설명하기 - "만든 결과는 Done + In Review, 만들 결과는 In Progress + Planned"처럼 구체적으로 알려주니 AI가 정확하게 구현했습니다
이렇게 하면 안 돼요
AI 요약 형식은 프롬프트로 명확히 지정하기 - 처음엔 번호 목록으로 나와서 "50자 이내 핵심 문장 1개"라고 명시해야 했습니다
🌍 다른 업무에 적용한다면?
Jira + Slack: 스프린트 완료된 이슈 자동 요약
Notion + Slack: 주간 회의록 자동 정리
GitHub + Slack: 이번 주 머지된 PR 요약
🚀 앞으로의 계획
팀 전체 배포 후 실제 효과 측정
팀원들 피드백 받아서 요약 형식 개선
정해진 요일에 자동으로 업데이트 알림 보내는 기능 추가
