📅 카카오톡으로 구글 캘린더를 제어하는 AI 봇 기획하기

프로젝트 소개

시도하고자 했던 것과 그 이유

매번 구글 캘린더 앱을 열어서 일정을 확인하거나 추가하는 게 번거로웠습니다.

• "오늘 일정 뭐지?" → 앱 켜기 → 로그인 → 캘린더 확인

• "내일 3시에 미팅 추가해야지" → 앱 켜기 → 날짜 선택 → 시간 입력...

"카톡으로 '오늘 일정 보여줘' 한마디면 끝나면 얼마나 좋을까?"

이 생각에서 CaldBot(Calendar Bot) 프로젝트를 시작했습니다. 카카오톡에서 자연스러운 대화만으로 일정을 조회하고, 추가하고, 수정하고, 삭제할 수 있는 봇을 만들고 싶었어요.

목표 대화 예시:

나: "오늘 일정 뭐야?"
봇: "📅 2025년 11월 17일 (월) 일정
     • 14:00-16:00 AI 스터디
     • 18:00-19:00 저녁 약속"

나: "내일 오후 3시에 치과 예약 추가해줘"
봇: "✅ 일정이 추가되었습니다."

진행 방법

1️⃣ 사용한 도구

• Claude Code: 설계 문서 작성, 시스템 아키텍처 설계

• Codex: 설계 검증, 보안/확장성 리뷰

• FastAPI: 24/7 시간 구동 가능 서버

2️⃣ Claude Code와 Codex 교차검증 프로세스

이번 주는 코드 작성이 아닌, 탄탄한 설계서를 만드는 데 집중했어요.

Step 0: 프로젝트 개요 및 초기 설정

• 서버 환경 구축

• FastAPI 기본 설치

• Systemd 서비스 등록

Step 1: 설계서 초안 작성 (Claude Code)
먼저 Claude Code에게 프로젝트 전체 구조를 설계하도록 했답니다.

사용한 프롬프트:

카카오톡으로 구글 캘린더를 제어하는 챗봇을 만들려고 합니다.
다음 요구사항을 포함한 상세 설계 문서(design.md)를 작성해주세요:

1. 프로젝트 개요 및 목표
2. 시스템 아키텍처 (메신저봇R → FastAPI → Google Calendar API)
3. 주요 기능 명세 (일정 조회/추가/수정/삭제)
4. 자연어 처리 흐름 (LLM 활용)
5. 보안 고려사항
6. Phase별 구현 계획

각 섹션마다 구체적인 기술적 결정 사항을 포함해주세요.

결과:

• design.md 파일 생성 (약 500줄 분량)

• 시스템 구조도, API 엔드포인트 설계, Phase별 로드맵까지 포함

• 전체 구조를 시각적으로 명확하게 파악할 수 있었어요

🔍 Step 2: 설계 검증 (Codex에 리뷰 요청)

Claude Code가 만든 설계서를 Codex에게 리뷰시켰어요.

사용한 프롬프트:

[design.md 내용 전체 첨부]

위 설계서를 꼼꼼히 검토하고 다음 관점에서 피드백해주세요:

1. 보안 취약점
2. 확장성 문제
3. 놓친 엣지케이스
4. 더 나은 설계 대안

각 항목마다 구체적인 예시와 개선안을 제시해주세요.

Codex가 지적한 주요 이슈:

🚨 보안 취약점
1. HTTP/HTTPS 혼용 위험
   → 개발 환경에서 HTTP 쓰다가 프로덕션에서도 실수할 수 있음
   → HTTPS를 기본으로, HTTP는 주석 처리

2. Webhook Secret 검증 없음
   → 아무나 서버에 메시지 보낼 수 있음
   → 토큰 검증 필수

⚠️ 확장성 문제
1. 다중 계정 매핑 전략 부재
   → user1/user2 파일만 있고, 누가 어떤 계정 쓸지 매핑 안 됨
   → UserProfile 테이블 필요

2. LLM Fallback 전략 없음
   → LLM API 다운되면 봇 전체 다운
   → Rule-based Fallback 필수

💡 놓친 엣지케이스
1. 대화 상태 관리 없음
   → "그래도 추가할까요?" → "응" (맥락 유지 안 됨)
   → Conversation State 필요

2. 충돌 체크 로직 누락
   → 이미 3시에 일정 있는데 또 추가됨

🔄 Step 3: 설계서 업데이트 및 최종 검증

여러 차례의 교차 검증 프로세스를 통해 설계서 품질을 크게 높였어요!

주요 개선사항:

• ✅ 보안 강화: HTTPS 기본, Webhook Secret, IP 화이트리스트

• ✅ LLM Fallback 전략: LLM 실패 시 Rule-based Parser로 대체

• ✅ 대화 상태 관리: Conversation State (In-Memory → Redis)

• ✅ 다중 계정 매핑: UserProfile 테이블로 sender → calendar_id 매핑

• ✅ 감사 로그: 누가, 언제, 무엇을 했는지 SQLite에 기록

• ✅ 구조화된 로깅: JSON 형식으로 디버깅 용이하게

3️⃣ 현재까지의 결과물

📄 design.md (최종본)

• 총 약 1,700줄

• 시스템 아키텍처 다이어그램

• API 명세서

• 보안 체크리스트

• Phase별 구현 계획 (Week 1-5)

• 테스트 시나리오

• 예상 이슈 및 해결 방안

📋 dev-history.md (개발 히스토리)

• 프로젝트 시작부터 현재까지의 모든 의사결정 기록

• 기술 스택 확정 과정

• 설계 개선 히스토리

결과와 배운 점

1️⃣ AI 교차 검증의 중요성 ⭐⭐⭐

단 하나의 AI Agent만 사용하는 것은 위험합니다.

Claude Code만 사용했을 땐,

• 보안 이슈를 놓침 (Webhook Secret 검증 없음)

• 확장성 고려 부족 (다중 계정 매핑 전략 부재)

• 엣지케이스 누락 (대화 상태 관리, LLM Fallback 없음)

최소 두 개의 AI를 병행하면서 서로의 결과물을 비교 평가하고 피드백을 주고받으면서 결과물의 퀄리티를 높이는 것이 중요합니다.

교차 검증 프로세스:

1. Claude Code → 초안 작성
2. Codex → 비판적 리뷰
3. Claude Code → 피드백 반영
4. Codex → 재검증
(필요시 반복)

이렇게 하니까 좋았던 점:

• 한 AI가 놓친 부분을 다른 AI가 잡아냄

• 서로 다른 관점에서 설계를 바라봄

  • Claude Code: 구조적, 체계적 설계 - 작성자, 설계자, 실무자 역할

  • Codex: 실용적, 비판적 검증 - 감독 및 상사 역할

• 최종 결과물의 완성도가 2배 이상 높아짐

역할 분담:

• Claude Code: 작성자 (초안 작성, 구조 설계)

• Codex: 검증자 (비판, 보완점 제시)

• 이렇게 역할을 나누니까 훨씬 효율적! 👍

→ 핵심 꿀팁: 지속적인 교차 검증 프로세스를 거쳐 설계 품질을 높여야 향후 불필요한 디버깅을 줄일 수 있습니다!

2️⃣ 기획서 단계가 80%다

이번 주는 코드 한 줄 안 짰는데, 오히려 이게 제일 중요한 시간이었어요.

잘못된 접근 (과거의 나):

"일단 코드부터 짜고 보자!"
→ 나중에 구조 전체를 갈아엎게 됨
→ 3일치 작업이 날아감

올바른 접근 (현재):

1주차: design.md 완성 (교차 검증 포함)
2주차 이후: 단계별 구현

기획서를 탄탄하게 만들면:

• 코드 작성이 오히려 빠름 (설계서 보고 그대로 구현)

• 버그가 적음 (엣지케이스를 미리 고려)

• 혼자 개발해도 길을 잃지 않음

→ 꿀팁: 코드 짜기 전에 AI한테 "상세 설계 문서 작성해줘"부터 시키세요! 그리고 반드시 다른 AI로 검증하세요!

3️⃣ 보안은 나중이 아니라 지금!

처음엔 "일단 작동만 하게 만들고, 보안은 나중에..." 생각했는데, Codex가 경고했어요:

Codex의 경고:

"개인 캘린더 데이터는 민감 정보입니다. 나중에 보안 추가하려면 코드 전체를 다시 짜야 합니다. 지금 설계에 포함하세요."

design.md에 포함된 보안 체크리스트:

• ✅ HTTPS 적용 (프로덕션 필수)

• ✅ Webhook Secret 토큰 검증

• ✅ IP 화이트리스트 (선택)

• ✅ OAuth 토큰 안전 저장 (환경변수)

• ✅ 로그에 민감정보 제외 (토큰 마스킹)

→ 꿀팁: 개인정보 다루는 프로젝트는 설계 단계부터 보안 체크리스트 필수!

4️⃣ Phase별 구현 전략

모든 기능을 한번에 만들려고 하면 압도당합니다.

Phase 구분 전략:

• Week 1: 기획 및 설계 (← 현재)

• Week 2: 일정 조회만 (MVP)

• Week 3: 일정 추가 (LLM 파싱)

• Week 4: 일정 수정/삭제

• Week 5: 고급 기능 (감사 로그, 구조화된 로깅)

각 Phase마다:

• 작동하는 상태로 완성

• 바로 테스트 가능

• 다음 Phase로 자연스럽게 확장

→ 꿀팁: 기획서는 탄탄하게, 구현은 단계별로!

🎯 다음에 할 일

Week 2 계획: Phase 1 구현 (일정 조회)

• Google Calendar API 연동

• 메신저봇R 연결

• "오늘 일정 보여줘" 작동 확인

Week 3 이후:

• 일정 추가 기능 (자연어 파싱)

• 충돌 체크

• 일정 수정/삭제

• 감사 로그 및 구조화된 로깅

마치며...

핵심 메시지:

1. AI 교차 검증은 필수! 최소 2개 이상의 AI로 서로 검증하세요.

2. 기획이 80% 코드 짜기 전에 탄탄한 설계서부터!

3. 보안은 지금! 나중으로 미루지 마세요.

4. Phase별로 구현 한번에 다 하려고 하지 마세요.

긴 글 읽어주셔서 감사합니다!

#FastAPI #GoogleCalendarAPI #메신저봇R #ClaudeCode #Codex #AI교차검증