haydenschmitty/floorplan
Claude·Codex가 그려주는 앱 지도, Floorplan
원제 haydenschmitty/floorplan
스타 3,201JavaScript
Key Point
AI로 만든 앱의 전체 구조를 단숨에 이해하고 보안 문제를 자동 감지할 수 있는 도구로, 개발자가 AI와 협업할 때 변경 사항을 추적하고 복잡한 다중 저장소 아키텍처를 파악하는 데 필수적이다.
핵심 요약
- Claude나 Codex가 코드를 읽어 앱 전체를 인터랙티브 지도로 시각화하는 도구로, 모든 파일과 웹 요청을 평문 영어로 표시하고 연결 관계를 보여준다.
- 줌 가능한 여러 수준의 지도(전체 앱→부분→파일→엔드포인트)에서 각 항목의 의존성을 확인할 수 있으며, 기술 용어는 설명이 붙어 있고 개발자 뷰로 전환 가능하다.
- 임포트 추적과 요청 매칭으로 여러 저장소 간 실제 연결을 따르며, 프론트엔드 요청을 백엔드 엔드포인트와 매칭한다.
- 지도에 질문하면('환불이 고객 카드에 어떻게 도달하나?') 관련된 부분만 보여주는 미니 지도와 단계별 설명이 반환된다.
- 보안 문제를 감지하는 건강 검사 기능이 코드의 키, 읽기 가능한 Supabase 테이블, 열린 Firebase 규칙, 위조 가능한 웹훅, 인증 없는 엔드포인트를 찾아 수정 방법을 제시한다.
- AI가 최근에 변경한 부분이 초록색으로 표시되며 변경 사유가 기록된다.
- 최초 지도는 작은 앱 기준 몇 분, 큰 프로젝트는 더 오래 걸리지만 업데이트는 변경된 부분만 다시 읽어 빠르고 저렴하다.
- PRD나 명세서에서 시작해 아직 만들지 않은 앱의 청사진(대시 선으로 표시된 계획)을 그릴 수 있으며, 코드 완성 시 실제 지도로 전환된다.
- TypeScript, JavaScript, Python, Go, Rust, Java 등 10개 언어와 Express, Next.js, Flask, Django, Go, Spring 등 주요 프레임워크를 지원한다.
- floorplan/ 폴더에만 파일을 생성하고 .gitignore에 등록되므로 커밋되지 않으며, 선택하면 CLAUDE.local.md에 지도 정보를 추가할 수 있다.
- 모든 처리가 사용자 컴퓨터에서 실행되고, 지도 서버는 로컬호스트만 허용하며 오프라인에서도 작동한다.
- 의존성이 없고 인터넷에서 코드를 다운로드하지 않으며, 모든 릴리스에 파일 지문을 제공해 설치본의 진위를 확인할 수 있다.
저장소 보기 ↗github.com