Chapter 03

개발 방식
— AI와 어떻게 협업하나

계획이 완성됐습니다. 이제 어떻게 실행하는가.
두 개의 Claude가 역할을 나누고,
Hook이 그 사이를 연결합니다.

핵심 구조

사람 하나, AI 둘, 그리고 기억 하나

범용 AI 하나로 모든 것을 하면 역할이 섞입니다. "생각"과 "실행"을 분리하고, 각각에 최적화된 AI를 배치합니다.

👤
의사결정자
나 (히안)
최종 결정·설치·실행
두 AI 사이의 허브
🧠
PM · 아키텍트
Claude Desktop
프로젝트 컨텍스트 보유
전략 수립·지시 생성
⌨️
개발자
Claude Code
실제 코드 작성·실행
빌드·테스트·디버깅
📋
동기화 브릿지
History Hook
자동 기록·저장
Desktop에 맥락 전달
각 역할 상세

생각하는 AI, 실행하는 AI, 기억하는 Hook

🧠
Claude Desktop
PM의 뇌
  • 프로젝트 목표 · 컨텍스트 영속 보유
  • 기획문서 · 코드 경로 파악
  • "다음에 뭐 해야 해?"에 답변
  • Claude Code에 넘길 프롬프트 생성
  • 의사결정 가이드 제공
⌨️
Claude Code
개발자의 손
  • 기획서 기반 코드 분석
  • 실제 코드 작성 · 수정 · 실행
  • 빌드 · 테스트 · 디버깅
  • Hooks로 작업 히스토리 자동 기록
  • 터미널 명령어 실행
📋
History Hook
동기화 브릿지
  • user_prompt 이벤트 자동 캡처
  • post_tool 이벤트 기록 (Edit, Write…)
  • stop 이벤트 — 최종 응답까지 저장
  • Markdown 포맷으로 정리·저장
  • Desktop 프로젝트에 첨부용 파일 생성
세팅 프로세스

4단계 초기 세팅, 그 이후는 자동

초기 세팅 4단계를 거치면, 이후엔 "다음 뭐 해야 해?"라고 물어보는 것만으로 개발이 진행됩니다.

1
Claude Desktop
프로젝트 생성 & 컨텍스트 세팅
Desktop에서 프로젝트 공간을 만든다. 기획문서·코드 경로·이전 대화 내역을 파일로 첨부한다. 이 공간이 영속적인 컨텍스트 허브가 된다. Code의 컨텍스트가 리셋돼도 Desktop은 전체 맥락을 보존한다.
2
Claude Code
코드베이스 파악 & 목표 제시
Code에게 기획문서를 읽히고, 현재 코드 구조를 분석시킨 뒤 목표를 제시한다. 이 시점에서 Code는 "무엇을 만들어야 하는지"를 정확히 이해한 상태가 된다. 커스텀 에이전트 파일(.claude/agents/)도 이 시점에 정의한다.
3
History Hook
자동 로깅 Hook 설치
.claude/hooks/ 디렉토리에 히스토리 로거 스크립트를 설치한다. user_prompt, post_tool, stop 세 이벤트를 후킹하여 모든 대화와 도구 사용 내역이 full_history/에 마크다운으로 자동 저장된다.
4
개발 루프 시작
세팅 완료. 이제부터 Desktop에게 "다음 뭐 해야 해?"라고 물으면, Desktop이 구체적 액션(설치할 것, 결정할 것, Code에 보낼 프롬프트)을 안내한다. 나는 그 안내를 따라 실행하면 된다.
히스토리 훅 상세

모든 작업이 자동으로 기록된다

Claude Code의 모든 활동을 자동으로 Markdown에 기록하는 쉘 스크립트 Hook. 이 기록이 Desktop에 첨부되어 맥락을 이어줍니다.

💬
user_prompt
사용자가 입력한 프롬프트를 타임스탬프와 함께 기록
🔧
post_tool
Bash, Edit, Write, Read, Task, Glob, Grep 등 도구 사용 기록
🏁
stop
세션 종료 시 마지막 Assistant 응답까지 캡처
📂 출력 project/full_history/YYYY-MM-DD_SESSION.md
반복 개발 루프

세팅 이후 반복되는 4-스텝 사이클

세팅이 완료된 뒤 실제 개발은 아래 4단계 사이클이 반복됩니다. 사람의 역할은 방향을 결정하는 것뿐입니다.

🧠
Claude Desktop
질문
"다음 뭐 해야 해?"
컨텍스트 확인
📋
지시 수신
액션 가이드 받기
결정사항 확인
⌨️
Claude Code
실행
프롬프트 전달
코드 작성·빌드
📝
History Hook
동기화
로그 저장
Desktop에 첨부
이 방식의 장점

왜 이렇게 협업하는가

🎯
컨텍스트 유지
Code의 컨텍스트가 리셋돼도 Desktop 프로젝트가 영속적 허브로 전체 맥락을 보존합니다. 세션이 끊겨도 "어디까지 했는지"를 잃지 않습니다.
🧩
역할 분리
"생각"과 "실행"이 분리됩니다. Desktop은 판단에, Code는 구현에 집중합니다. 판단과 코딩이 섞이지 않아 더 높은 품질이 나옵니다.
📊
자동 문서화
Hooks가 모든 작업을 자동 기록합니다. 나중에 보고서·블로그·회고 자료를 바로 만들 수 있습니다. 이 케이스 스터디도 그 기록에서 나왔습니다.
🚀
의사결정 집중
개발자는 코드 디테일 대신 "무엇을 할지"에 집중합니다. AI가 "어떻게"를 담당합니다. 모바일 경험 없이도 개발이 가능한 이유입니다.
★ 핵심 인사이트
Desktop이 뇌, Code가 손,
History Hook이 기억이다.
두 개의 Claude를 각각 다른 역할로 동시에 활용하고, 그 사이를 히스토리 훅이 연결합니다. 사람은 최종 의사결정에만 집중하면 됩니다.
🔄
이 단계의 산출물
Dual Workflow 구조 + 지속 가능한 개발 루프
구상 → 계획 → 실행의 전 과정이 완성됐습니다. 이 케이스는 "도메인 지식도, 모바일 경험도 없이 AI와 협업해 모바일 앱을 어떻게 만드는가"에 대한 하나의 답입니다.