Floorplan의 개요
Floorplan은 Claude Code와 Codex용 플러그인으로, 코드베이스를 읽고 그 대화형 지도를 로컬 HTML 파일로 그립니다. 모든 부분, 파일, 엔드포인트, 화면에 쉬운 말로 된 설명이 붙고, 프런트엔드의 각 웹 요청을 그에 응답하는 서버 엔드포인트와 연결합니다. 저장소가 나뉘어 있어도 마찬가지입니다.
십여 개 언어의 import, 라우트, 요청을 파싱하는 기계적인 일은 순수 Node 스크립트가 맡고, 이름 붙이기와 설명은 에이전트가 맡습니다. 지도 위에는 관련 부분의 미니 지도와 함께 질문에 답하는 Ask 바, 가이드 흐름, 에이전트가 방금 바꾼 내용을 보여 주는 Recent work 보드, AI로 만든 앱의 흔한 실수를 찾는 Health check, 코드가 생기기 전에 PRD로 그리는 blueprint가 있습니다.
MIT 라이선스이며 의존성이 없고, API 키 없이 기존 Claude 또는 ChatGPT 요금제로 실행됩니다.
Floorplan, 쓸 만한 가치가 있습니까?
Floorplan은 대부분의 코드 도구가 외면해 온 독자를 겨냥합니다. AI의 도움을 크게 받아 앱을 출시했지만 "누가 결제하면 무슨 일이 일어나나?"에 답하지 못하는 사람입니다. 그 질문에 쉬운 말로 쓴 확대 가능한 지도로 답하며, 저장소의 성장세가 수요가 실재함을 보여 줍니다. 2026년 10월 27일 생성 이후 스타 약 2,568개, 포크 187개입니다.
중요한 설계 선택은 역할 분담입니다. 파싱, 요청과 엔드포인트의 연결, 레이아웃은 의존성 없는 결정적 Node 스크립트가 하고, 모델은 이름 붙이기와 설명만 합니다. 그래서 지도 위 연결이 모델의 추측이 아니라 코드에 근거하고, 바뀐 파일만 다시 읽으니 업데이트도 저렴합니다.
Health check는 가장 제값을 할 기능입니다. 코드에 있거나 브라우저로 보내지는 키, 누구나 읽을 수 있는 Supabase 테이블, 열린 Firebase 규칙, 위조 가능한 Stripe 웹훅, 로그인 없는 엔드포인트를 찾아 각각 수정 프롬프트를 붙입니다. README는 솔직하게 "a check, not an audit"라고 말합니다. 로직 결함은 찾지 못하며 특정 유형의 앱에서 흔한 실수를 다룹니다.
한계는 빠르게 움직이는 새 프로젝트의 한계입니다. 2026년 10월 31일부터 11월 2일 사이에 릴리스가 v0.4.4에서 v0.6.3까지 나왔고, 기여자는 8명, 열린 이슈와 풀 리퀘스트는 29건이며, 엔드포인트 감지는 정해진 프레임워크 목록에 의존합니다. 큰 앱의 첫 지도는 시간이 더 걸리고, 모든 파일을 설명하므로 요금제 사용량도 더 씁니다.
안전 면에서는 대부분의 플러그인보다 더 나아갑니다. 훅도, MCP 서버도, 다운로드도 없고, 이를 변경마다 확인하는 테스트와 릴리스별 파일 지문이 있습니다. 외부로 나가는 요청은 선택형 대기자 명단 이메일뿐입니다. 무엇이든 깔끔한 다이어그램으로 그리는 Archify, 개발자용 함수 단위 그래프를 만드는 Understand Anything과 비교하면, Floorplan은 자기 앱을 이해하고 점검하려는 소유자를 위한 도구입니다.
제 역할을 하는 곳
대부분 Claude Code로 만든 Next.js와 Supabase 앱을 가진 1인 창업자
users 테이블을 바꾸면 무엇이 깨지는지 알기
floorplan을 요청한 뒤 지도에 물으면 관련 부분과 단계별 설명으로 답합니다. Health check는 누구나 읽을 수 있는 Supabase 테이블을 짚고, Claude Code에 붙여 넣을 수정 프롬프트를 줍니다.
고객 앱을 새 개발자에게 넘기는 3인 에이전시
일주일이 아니라 오후 한나절에 새 사람을 적응시키기
floorplan을 HTML 파일 하나로 내보내 보냅니다. 개발자 보기 전환으로 기술 이름이 보입니다. 업데이트는 바뀐 파일만 다시 읽으므로 최신 상태 유지에 요금제를 거의 쓰지 않습니다.
PRD는 있지만 아직 코드가 없는 프로덕트 매니저
기능에 필요한 모든 부분, 엔드포인트, 화면 보기
PRD를 공유하고 floorplan을 요청하면 blueprint가 계획된 부분을 점선 카드로 표시하고 미결 사항을 나열합니다. 코드가 생기면 같은 지도가 실제 시스템의 지도가 됩니다.
도입 전 확인할 점
- 설정
- Node.js 18 이상이 필요합니다. Claude Code에서는 claude plugin marketplace add haydenschmitty/floorplan 다음 claude plugin install floorplan@floorplan을 실행하고, Codex에서는 앱에서 마켓플레이스를 추가합니다. floorplan을 요청하면 작은 앱은 몇 분 안에 지도가 됩니다.
- 연동
- Claude Code와 Codex. TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Scala를 파싱하고, Express, Fastify, Next.js, FastAPI, Django, Gin, Axum, Spring 등의 엔드포인트와 Next.js, React Router, Vue, SvelteKit 등의 화면을 지원합니다.
- 데이터와 개인정보
- 스캔, 지도, 로컬 서버는 사용자 기기에서 실행되며 로컬 연결만 받습니다. AI는 평소처럼 사용자 계정으로 파일을 읽습니다. 분석 도구는 없고 외부 요청은 선택형 대기자 명단 이메일뿐입니다. git에서 무시되는 floorplan/ 폴더를 만듭니다.
- 대규모 사용 시 비용
- 요금은 없고, 첫 지도와 업데이트마다 Claude 또는 ChatGPT 요금제를 사용합니다. 큰 프로젝트는 병렬 도우미로 나뉘므로 요금제를 더 씁니다.
- 제한
- 열린 이슈와 풀 리퀘스트 29건. 목록 밖 프레임워크는 지원이 가볍고, Ask 바가 실제 코드를 읽으려면 Claude Code CLI나 Codex가 필요합니다.
좋은 점
- 저장소를 넘나들며 프런트엔드 요청과 백엔드 엔드포인트를 잇는 쉬운 말 지도
- 유출된 키, 열린 Supabase와 Firebase, 위조 가능한 웹훅을 찾는 Health check
- Recent work로 에이전트가 무엇을 왜 바꿨는지 확인
- 의존성 없음, 훅 없음, 로컬 전용 서버, MIT 라이선스
- 기존 Claude 또는 ChatGPT 요금제로 실행
아쉬운 점
- 2026년 10월 27일 생성, 주 작성자 한 명
- Health check는 흔한 패턴만 다루며 보안 감사가 아님
- 큰 코드베이스의 첫 지도는 느리고 요금제 한도를 소모함
- 엔드포인트와 화면 감지는 목록에 있는 프레임워크로 제한
추천 대상
Claude Code나 Codex로 앱을 만들었고, 모든 파일을 읽지 않고도 이해하고 설명하고 점검해야 하는 창업자와 소규모 팀.
Floorplan 대안
Floorplan: 자주 묻는 질문
- Floorplan, 쓸 만한 가치가 있습니까?
- AI로 앱을 만들었지만 코드를 읽지 못하는 사람에게 정말 유용한 지도입니다. 다만 나온 지 일주일 된, 작성자 한 명의 젊은 플러그인입니다. 평점은 5점 만점에 4.0점입니다.
- Floorplan의 가격은 얼마입니까?
- MIT 라이선스로 무료입니다. 지도 생성에는 자신의 Claude 또는 ChatGPT 요금제를 쓰며, 별도 API 키나 요금은 없습니다.
- Floorplan의 단점은 무엇입니까?
- 2026년 10월 27일 생성, 주 작성자 한 명; Health check는 흔한 패턴만 다루며 보안 감 사가 아님; 큰 코드베이스의 첫 지도는 느리고 요금제 한도를 소모함; 엔드포인트와 화면 감지는 목록에 있는 프레임워크로 제한.
- Floorplan에 적합한 사람은 누구입니까?
- Claude Code나 Codex로 앱을 만들었고, 모든 파일을 읽지 않고도 이해하고 설명하고 점검해야 하는 창업자와 소규모 팀.
- 팀이나 프로덕션 환경에서 Floorplan의 비용은 얼마입니까?
- 요금은 없고, 첫 지도와 업데이트마다 Claude 또는 ChatGPT 요금제를 사용합니다. 큰 프로젝트는 병렬 도우미로 나뉘므로 요금제를 더 씁니다.
- Floorplan에 회사 데이터를 맡겨도 안전합니까?
- 스캔, 지도, 로컬 서버는 사용자 기기에서 실행되며 로컬 연결만 받습니다. AI는 평소처럼 사용자 계정으로 파일을 읽습니다. 분석 도구는 없고 외부 요청은 선택형 대기자 명단 이메일뿐입니다. git에서 무시되는 floorplan/ 폴더를 만듭니다.
- Floorplan의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Archify 및 Repomix입니다.
답변 확인일: 2026년 11월 3일.
Floorplan 개발사입니까? 이 평점을 사이트에 표시하십시오
