Repolode
haydenschmitty

haydenschmitty/floorplan

Claude Code나 Codex가 그려 주는, 구성 요소와 파일, 엔드포인트 및 서로 간의 연결을 보여 주는 인터랙티브한 평이한 언어의 코드베이스 지도입니다.

스타
2,966
포크
230
열린 이슈
7
마지막 커밋
3일 전

어떤 프로젝트인가요?

Floorplan은 기존 앱을 읽고 확대·축소할 수 있는 평이한 언어의 지도로 만들어 주는 Claude Code 및 Codex 플러그인입니다. 구성 요소와 파일, 웹 엔드포인트에 설명적인 이름을 붙이고, 서로 간의 import와 프론트엔드에서 백엔드로 보내는 요청을 연결선으로 표시합니다. 별도의 저장소에 걸친 연결도 보여 줍니다.

지도 외에도 AI로 만든 앱에서 흔히 발견되는 문제를 찾아내는 Health check가 포함되어 있습니다. 코드에 남은 키, 외부에서 읽을 수 있는 데이터베이스 테이블, 개방된 Firebase 규칙, 검증되지 않은 Stripe 웹훅, 로그인 없이 접근 가능한 엔드포인트 등을 표시하고 각 문제에 대한 해결 방법을 제안합니다. Recent work 뷰에서는 AI 어시스턴트가 방금 변경한 내용을 확인할 수 있습니다. 아직 존재하지 않는 앱의 PRD나 사양을 바탕으로 청사진을 작성할 수도 있습니다.

스캔 및 레이아웃 스크립트는 의존성 없는 순수 Node.js로 작성되어 있으며, 결과물은 내 컴퓨터에서만 제공되는 로컬 HTML 파일입니다. 업데이트할 때는 변경된 파일만 다시 읽으며, 생성된 폴더는 git에서 제외됩니다.

핵심 기능

  • 01앱 전체에서 개별 파일과 엔드포인트까지 확대·축소할 수 있는 지도
  • 02import를 추적하고 여러 저장소에 걸친 프론트엔드 요청과 백엔드 엔드포인트를 연결
  • 03노출된 키, 개방된 데이터베이스 규칙, 검증되지 않은 웹훅, 인증되지 않은 엔드포인트를 점검하는 Health check
  • 04AI 어시스턴트가 변경한 구성 요소를 보여 주는 Recent work 뷰
  • 05PRD나 사양을 바탕으로 계획된 시스템의 초안을 작성하는 Blueprint 모드

활용 사례

  • 코드를 전부 읽지 않고도 AI 지원을 받아 대부분 만들어진 앱 파악하기
  • 여러 저장소로 구성된 프로젝트에 새 팀원 온보딩하기
  • AI 코딩 세션에서 무엇이 왜 변경되었는지 검토하기
  • 출시 전에 흔히 발생하는 보안 설정 오류 찾아내기

빠른 시작

  1. 1

    Claude Code에 Floorplan 마켓플레이스 추가하기

    claude plugin marketplace add haydenschmitty/floorplan
  2. 2

    Floorplan 플러그인 설치하기

    claude plugin install floorplan@floorplan
  3. 3

    새 세션에서 Claude Code에 앱의 플로어플랜을 만들어 달라고 요청하기

  4. 4

    브라우저에 표시된 맵을 열어 둘러보기

사용 전 알아둘 점

  • Node.js 18 이상과 Claude Code 또는 Codex가 필요합니다.
  • 데스크톱 앱에서 맵의 Ask 바가 실제 코드를 읽으려면 Claude Code CLI를 설치해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

floorplan은(는) 무엇인가요?
Claude Code나 Codex가 그려 주는, 구성 요소와 파일, 엔드포인트 및 서로 간의 연결을 보여 주는 인터랙티브한 평이한 언어의 코드베이스 지도입니다. Floorplan은 기존 앱을 읽고 확대·축소할 수 있는 평이한 언어의 지도로 만들어 주는 Claude Code 및 Codex 플러그인입니다. 구성 요소와 파일, 웹 엔드포인트에 설명적인 이름을 붙이고, 서로 간의 import와 프론트엔드에서 백엔드로 보내는 요청을 연결선으로 표시합니다. 별도의 저장소에 걸친 연결도 보여 줍니다.
floorplan은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
floorplan은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
floorplan은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. floorplan의 마지막 커밋은 2026년 11월 2일입니다.
floorplan은(는) 어디에 사용할 수 있나요?
코드를 전부 읽지 않고도 AI 지원을 받아 대부분 만들어진 앱 파악하기 여러 저장소로 구성된 프로젝트에 새 팀원 온보딩하기 AI 코딩 세션에서 무엇이 왜 변경되었는지 검토하기 출시 전에 흔히 발생하는 보안 설정 오류 찾아내기
floorplan는 어떻게 설치하나요?
Claude Code에 Floorplan 마켓플레이스 추가하기: claude plugin marketplace add haydenschmitty/floorplan Floorplan 플러그인 설치하기: claude plugin install floorplan@floorplan 새 세션에서 Claude Code에 앱의 플로어플랜을 만들어 달라고 요청하기 브라우저에 표시된 맵을 열어 둘러보기
floorplan은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/haydenschmitty/floorplan

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트