haydenschmitty/floorplan

解決する課題

Floorplanは、特にコードベースが大規模化したり、AIの支援を受けて構築された場合に発生する「コードベースの構造が不明である」という問題を解決します。コードの機能を平易な言葉で説明する視覚的なマップを提供し、アプリケーションの各パーツがどのように接続されているか、特定のユーザーアクション中に何が起こるか、セキュリティの脆弱性や未使用ファイルなどの潜在的な問題がどこにあるかを理解するのに役立ちます。

仕組み

Floorplanは、Claude CodeまたはCodexを使用して、ファイル、インポート、Webリクエストを含むコードベースをスキャンします。各コンポーネントの目的を特定し、インタラクティブなローカル専用マップを生成します。このマップに対して「注文が行われたときに何が起こるか？」や「どこでStripeと通信しているか？」といった自然言語で質問することで対話できます。コードに変更を加えるとツールが段階的に更新されるため、手動メンテナンスなしでマップを最新の状態に保つことができます。

対象ユーザー

複雑なコードベースを迅速に理解する必要がある個人開発者やチーム、新しいチームメンバーのオンボーディング、AI主導の変更がアプリケーションのアーキテクチャに与える影響を追跡したい方に最適です。また、製品要件から設計図を生成して新規プロジェクトを計画する際にも役立ちます。

ハイライト

• ファイルやリポジトリ間の接続を表示する、ズーム可能なインタラクティブマップ。
• コードコンポーネントや技術エンドポイントに対する平易な英語での説明。
• データフローの追跡やアーキテクチャに関する質問に答える「Ask the map」機能。
• セキュリティリスク、未使用ファイル、肥大化したコンポーネントを特定する自動ヘルスチェック。
• AIアシスタントによる変更を強調表示する「Recent work」ビュー。
• コードを書く前にアプリケーションを可視化・計画するためのブループリントモード。
• 外部依存関係なしでマシン上でローカルに実行され、gitへのコードコミットも不要です。