Floorplan — Claude Code·Codex가 코드베이스를 읽어 그리는 대화형 앱 지도, 7일 만에 2,194스타
haydenschmitty가 공개한 Floorplan은 Claude Code와 Codex가 코드베이스를 읽어 앱 구조를 대화형 지도로 그려 주는 도구입니다. 개발자용 지식 그래프가 아니라, 앱 소유자가 읽을 수 있는 지도를 지향한다는 점이 README의 설명입니다.
레포는 2026년 10월 27일에 만들어졌고, 11월 2일 실측 기준으로 스타 2,194개와 포크 155개를 기록했습니다. 라이선스는 MIT이고 언어는 JavaScript이며, 현재 버전 표기는 0.6.3입니다.
AI로 앱을 만든 사람은 동작은 확인해도 내부 구조를 모르는 경우가 많습니다.
앱 전체에서 파일과 엔드포인트까지 이어지는 지도
지도는 전체 앱에서 시작해서 부분, 파일 그룹, 파일, 엔드포인트까지 확대해서 볼 수 있습니다. 각 요소에는 평이한 영어 이름이 붙기 때문에, 코드를 직접 읽지 않아도 구조를 따라가기 쉽습니다.
프론트엔드 요청과 서버 엔드포인트는 서로 다른 레포 사이에 있어도 연결해서 보여 줍니다. 결제 흐름을 바꾸면 어디가 함께 바뀌는지 같은 질문에 지도 위에서 답을 찾을 수 있다는 것이 핵심입니다.
코드가 아직 없는 단계에서도 쓸 수 있습니다. PRD나 설명만으로 blueprint, 즉 계획 지도를 먼저 그리는 흐름도 README에 포함되어 있습니다.
Floorplan 동작 흐름
흐름은 읽는 단계에서 끝나지 않고 고치는 단계까지 이어집니다. 지도에서 문제를 찾으면, 그 자리에서 붙여 넣을 수 있는 수정 프롬프트까지 함께 받는 구조입니다.
Health check와 Recent work
내장된 Health check는 고전적인 보안 실수를 지도 위에서 짚어 줍니다. README가 드는 항목은 다음과 같습니다.
- 코드에 박힌 키와 비밀번호를 찾습니다.
- 누구나 읽을 수 있는 Supabase 테이블과 Firebase 규칙을 찾습니다.
- 위조 가능한 Stripe 웹훅과 로그인 없는 엔드포인트를 찾습니다.
- 찾은 항목마다 붙여 넣을 수 있는 수정 프롬프트를 함께 줍니다.
Recent work 기능은 에이전트가 방금 바꾼 카드를 녹색으로 표시합니다. 각 변경이 원래 요청과 어떻게 연결되는지도 함께 적히기 때문에, 변경 영향을 눈으로 확인하는 용도로 쓸 수 있습니다.
다만 README 스스로 Health check에 대해 선을 긋고 있습니다. 보안 감사의 대체재가 아니라 점검 도구라는 뜻의 문구가 README에 들어 있습니다.
공개 7일 만의 반응
스타 2,194개는 생성 후 약 7일 만에 쌓인 수치입니다. 하루 평균으로 환산하면 약 310개 속도로 읽힙니다.
의존성은 0개라고 README 배지에 적혀 있습니다. 실행 조건은 Node.js 18+와 Claude Code 또는 Codex이고, API 키 없이 기존 구독으로 동작한다는 점도 진입 장벽을 낮추는 요소입니다.
라이브 데모가 공개되어 있어서 설치 없이 지도를 직접 눌러 볼 수도 있습니다. 먼저 데모로 지도 품질을 보고 자기 레포에 붙이는 순서가 부담이 적습니다.
확인되지 않은 지점
- 큰 모노레포나 오래된 레거시 코드에서 지도 품질이 유지되는지는 미확인입니다.
- README의 데모는 커피 구독 앱 사례라서, 규모가 큰 앱에서의 사례는 아직 공개되지 않았습니다.
- 버전이 0.6.3인 초기 프로젝트라서 지도 형식과 플러그인 구조가 바뀔 수 있습니다.
실무 판단
에이전트가 코드를 짜는 속도가 빨라질수록, 사람이 구조를 파악하는 도구의 가치도 함께 커집니다. Floorplan은 그 간극을 지도와 점검 결과로 메우는 쪽에 서 있습니다.
코드를 읽지 않는 빌더도 자기 앱의 변경 영향과 보안 실수를 점검할 수 있다는 점이 이 도구의 자리입니다. Android와 웹을 함께 다루는 실무에서도 에이전트 변경분을 확인하는 용도로 바로 시험해 보시기 바랍니다.