솔로 개발자가 Claude 코드로 야외 플랫폼을 구축하다: AI 지원 제품 개발의 교훈

한 소프트웨어 엔지니어가 풀타임으로 일하면서 클로드 코드를 사용해 미국 전역의 정확한 상황 정보를 제공하기 위해 12개 이상의 데이터 소스를 갖춘 야외 경로 플랫폼인 PathQuest(pathquest.app)를 구축했습니다. 이 프로젝트는 커서가 아직 사용 가능했던 12월에 시작되었으며, 개발자는 지난 한 달 동안 특히 클로드 코드를 사용했습니다.

프로젝트 세부사항

개발자는 기존의 TypeScript 코드베이스를 클로드에 넘겼습니다. 이 프로젝트는 3개의 저장소에 걸쳐 있으며, 스트라바 데이터에서 피크 정상 추적에서 시작해 완전한 경로 구축 플랫폼으로 발전했습니다. 3월 말까지 이 플랫폼은 일부 남아있는 문제점에도 불구하고 그의 야외 커뮤니티에서 인기를 얻기 시작했습니다.

개발 워크플로우

개발자는 다음과 같은 구체적인 워크플로우를 확립했습니다:

• 모든 저장소에 접근할 수 있는 루트 디렉토리에서 실행되는 클로드
• 각 저장소에는 지정된 스킬(프론트엔드-기능, API-기능, 백엔드-기능)이 있음
• 각 스킬에는 3개의 하위 에이전트가 있음: 코드 작성용 구현자, 테스트용 테스터, 코드 리뷰용 검토자

주요 교훈

소프트웨어 구축은 책 쓰기와 같다: 개발자는 많은 코드를 쓰고 다시 썼으며, 이 과정을 중요한 것은 전달하려는 요점이라는 글쓰기에 비유했습니다. PathQuest의 경우 그 요점은 "사람들이 관심 있는 장소와 트레일의 상황 데이터에 쉽게 접근할 수 있어야 한다"였습니다.

실제 사람들과 대화하라: 정상 구역에 대한 LiDAR 스캔의 ML 분석과 등반 경로 지형도에 대한 AI 기반 스캐너와 같은 일부 사이드 프로젝트는 사용자들이 "저게 도움이 전혀 안 된다"고 말한 후 중단되었습니다.

"여자친구 테스트": 공감할 수 있고 대상 커뮤니티의 일원인 누군가를 위해 무언가를 구축하는 것이 피드백에 가치 있음이 입증되었습니다.

AI 정신병은 현실이다: 개발자는 하루 14-16시간씩 한 달 동안 코딩을 했으며, AI가 모든 것을 구축할 수 있게 만들어주기 때문에 모든 것을 구축하는 데 빠지기 너무 쉽지만, 무엇을 구축할 수 있는지 대신 무엇을 구축해야 하는지 결정하기 위해 AI가 아닌 목소리가 필요하다고 언급했습니다.

대규모 코드베이스 관리: AI가 개발을 가속화하는 동안(예전에 혼자서는 수년이 걸렸을 수도 있는 작업), 코드베이스가 확장됨에 따라 구상, 작성, 테스트, 검토 및 코드 푸시를 위한 신중한 프로세스가 필수적이 됩니다.