여러 개발 프로젝트를 동시에 다루다 보니 프로젝트 간에 서로 전달해야 할 메모나 메시지를 남겨두는 별도의 '우편함' 폴더를 만들어 활용하고 있었다. 하지만 시스템을 만들어두고도 편지가 새로 도착했는지 매번 직접 디렉터리에 들어가 확인해야 하는 점이 꽤나 불편했다.
수동 확인 과정을 잊어버리면 중요한 메시지를 놓치기 일쑤였고, 그렇다고 계속 폴더를 들여다보는 것은 소중한 집중력을 갉아먹는 일이었다. 결국 우편함 폴더를 스스로 감시하고 알려주는 자동화 장치가 간절해졌다.
셸 스크립트 grep으로 파일 머리말만 가볍게 읽기
우선 우편함을 확인하는 효율적인 방법을 고민했다. 메시지 파일 전체를 통째로 읽어 들이는 것은 매우 비효율적이라고 생각했다. 나에게 필요한 핵심 정보는 오직 새로운 메시지가 도착했는지 여부와 그 메시지가 어떤 내용인지 알 수 있는 짧은 요약뿐이었다.
이를 해결하기 위해 공용 셸 스크립트 grep 명령어를 활용해 대기 중인 편지들의 머리말만 깔끔하게 추출하는 방식을 떠올렸다. 대기 중인 편지가 없을 때는 스크립트의 출력이 숫자 0이 되도록 만들어서 불필요한 정보나 노이즈가 발생하지 않도록 깔끔하게 처리했다.
이 스크립트가 정확하게 동작하도록 우편함 이용 규칙도 하나 새로 정했다. 우편함 폴더에 새로 남기는 메시지 머리말에는 반드시 한 줄 제목을 작성하도록 필수화한 것이다. 덕분에 파일 전체를 뒤질 필요 없이 머리말만 뽑아서 빠르게 상태를 파악할 수 있게 되었다.
Claude Code SessionStart 훅으로 작업 맥락 자동 주입하기
머리말만 뽑아내는 스크립트를 완성한 뒤, 이를 실제 개발 작업 흐름에 자연스럽게 녹여낼 방법을 찾았다. 여기서 활용한 것이 바로 Claude Code SessionStart 훅이다.
터미널에서 새로운 개발 세션을 시작할 때마다 Claude Code SessionStart 훅이 스크립트를 자동으로 실행하도록 설정했다. 이렇게 세팅해 두니 세션이 열리는 순간 대기 중인 메시지 머리말이 작업 맥락 속으로 자동 주입되었다.
가장 만족스러웠던 부분은 극적인 토큰 절약 효과였다. 파일의 전체 본문을 매번 읽어서 AI 맥락에 집어넣는 대신, 머리말 한 줄만 가볍게 읽어오기 때문에 소모되는 토큰이 거의 없다시피 했다. 비용 걱정 없이 항상 최신 프로젝트 간 메시지 현황을 파악할 수 있는 최선의 환경이 갖춰졌다.
매일 밤 스케줄러와 알림 동작의 핵심 원리
세션이 시작될 때 확인하는 것에서 더 나아가, 작업을 하지 않는 동안에도 중요한 소식을 놓치지 않도록 추가 장치를 마련했다. 매일 밤마다 자동으로 실행되는 읽기 전용 스케줄 프로세스를 구축한 것이다.
이 야간 스케줄 역시 동일하게 셸 스크립트 grep 방식으로 우편함을 점검한다. 점검 결과 대기 중인 편지가 존재할 때만 푸시 알림을 발송하도록 조건을 걸어두었다.
만약 대기 중인 우편이 하나도 없다면 아무런 알림도 보내지 않고 완전히 조용하게 프로세스를 종료한다. 알림 폭탄에 시달리지 않으면서 정말 필요한 순간에만 소식을 접할 수 있게 된 셈이다.
자동 확인 시스템을 구축하며 얻은 교훈
이번 우편함 자동 확인 장치를 구축하면서 자동화 설계에 대한 중요한 깨달음을 얻었다. 자동 확인 장치는 '확인할 대상이 없을 때 조용한 것'이 전체 설계의 절반을 차지한다는 사실이었다.
도착한 메시지가 없는데도 매번 확인 완료 메시지 같은 불필요한 알림을 보낸다면 도리어 작업의 흐름을 방해하는 또 다른 피로 요소가 된다. 없을 때는 존재감을 드러내지 않고 가만히 대기하는 것이 제대로 된 자동화의 핵심이었다.
Claude Code SessionStart 훅과 가벼운 셸 스크립트를 조합한 덕분에, 토큰을 거의 쓰지 않고도 여러 프로젝트 간 소통을 매끄럽게 연결할 수 있었다. 소소한 불편함에서 시작된 삽질이었지만, 최소한의 자원으로 최고의 효율을 내는 매력적인 자동 확인 시스템을 완성할 수 있었다.