풀스택
개발자

‘독서 시작해볼까’는 재미있게 즐길 수 있는 도서 추천 서비스입니다. 몇 가지 질문에 답하면 읽을 만한 책을 추천해 줍니다. 좋아하는 장르처럼 간단한 질문도 있지만, 책을 읽으며 무엇을 얻고 싶은지, 어떤 감정을 느끼고 싶은지처럼 더 깊고 구체적인 질문도 합니다. 이미 나와 있는 일반적인 도서 추천 서비스와 차별화하기 위해 의도적으로 내린 설계 결정입니다.

하루 최대 40명의 사용자가 방문했고, 대체로 긍정적인 반응을 얻었습니다. Threads에 사이트를 공유하면서 “재밌는 아이디어!” 같은 말을 남긴 사용자도 있었습니다. 가장 많이 나온 아쉬운 점은 수록된 책이 적다는 것이었는데, 첫 개발 사이클에서는 의도적으로 적은 수의 책만 넣었기 때문에 충분히 예상한 반응이었습니다. 두 번째 사이클에서는 추천 알고리즘을 다듬고 도서 목록을 늘리는 데 집중하고 있으며, 이 글을 쓰는 시점에는 아직 진행 중입니다.

수익 모델은 쿠팡 파트너스 제휴 링크입니다. 사용자가 추천을 통해 책을 구매할 때마다 일정 비율의 수수료를 받습니다. 정식 파트너가 되기 전까지는 제휴 링크를 직접 하나씩 만들어야 해서, 처음부터 많은 책을 넣기가 더 어려웠습니다.

작업 방식

웹사이트는 혼자 개발했고, 구현의 상당 부분에 Claude의 Opus 5 모델을 활용했습니다. 이 기회에 에이전트 기반 워크플로도 실험해 보았습니다. Claude Code의 GitHub Actions 연동을 이용해 GitHub에서 바로 이슈를 처리하게 했고, 에이전트 개발을 세밀하게 이끌기 위한 Matt Pocock의 스킬처럼 널리 쓰이는 여러 Claude 스킬 세트도 시도했습니다.

이 앱을 개발하면서 가장 어려웠던 점은 에이전트와 방향을 맞추는 일이었습니다. 아이디어를 빠르게 바꿀 때면 에이전트가 이전 로직과 아이디어를 그대로 유지하려는 경향이 있어서, 새로운 아이디어를 정확하게 구현하는 데 방해가 되었습니다. 예를 들어 한번은 무엇을 해야 하는지 분명하게 지시했는데도 에이전트가 추천 알고리즘을 제대로 바꾸지 못했습니다.

지금은 컨텍스트를 신경 써서 관리하는 방식으로 이 문제에 대응하고 있습니다. 먼저 몇 개의 계획 에이전트로 큰 계획을 세운 뒤, 매번 깨끗한 컨텍스트에서 한 단계씩 구현합니다. 물론 서로 막히는 작업이 없다면 GitHub 워크플로 등을 이용해 여러 단계를 동시에 구현할 수도 있습니다.

추천 로직

추천 로직은 필터링과 점수 계산으로 이루어져 있습니다. 각 책에는 정해진 형식의 데이터가 붙어 있습니다. 예를 들면 다음과 같습니다.

{
  title: '죽고 싶지만 떡볶이는 먹고 싶어',
  author: '백세희',
  year: 2018,
  genre: ['essay'],
  ratings: {
    need: { comfort: 3, fun: 1, knowledge: 1, growth: 1, trend: 1, habit: 2 },
    priority: { easy: 3, depth: 1, bestseller: 3, happy: 1 },
    topic: {
      money: 0, relationship: 1, career: 0, mindcare: 3,
      society: 0, science: 0, history: 0, selfunderstand: 2,
    },
  },
  trendRatedAt: '2026-09-24',
  avoid: ['heavy'],
  difficulty: 1,
  length: 'short',
}

장르가 필터의 한 예로, 사용자가 고른 장르에 속한 책만 남깁니다. ratings와 topic에는 점수 계산에 쓰이는 값이 들어 있습니다. 필터를 통과한 책마다 사용자의 답변을 바탕으로 점수를 계산하는데, 사용자가 선호한 ratings와 topic 항목의 값이 높은 책일수록 점수가 높아집니다. 가장 높은 점수를 받은 책이 최우선 추천이 됩니다.