boxmoe_header_banner_img

Hello! 欢迎来到阿虪的开发世界~

加载中

文章导读

floorplan:让 Claude 读完代码库,画一张人话版交互地图


avatar
阿虪 10 11 月, 2026 381
floorplan

中文版

floorplan(GitHub:https://github.com/haydenschmitty/floorplan ,2026-10-27 创建,今晨抓取时已 3,362★)解决一个很真实的痛点:你用 AI 搭了个能跑的应用,可一问“用户下单时到底发生了什么”“改这里会坏掉什么”,答案是不知道。

做法是让 Claude Code 或 Codex 读你的代码库,画出一张可交互的地图:每个模块、文件、网络请求都有一个人话名字,模块之间的连接也画出来。地图可以随时探索、直接在上面提问,还能随着开发持续更新。README 里说得很直白:这是“没人画的那张图”。对开发者,它帮你不用读代码就理解自己做的东西;对团队,新人几分钟就能从全貌看到具体实现。仓库提供 Claude Code 插件与 Codex 插件两种接入方式,Node 18 以上、零依赖,MIT 开源,官网还有不用安装就能看的 live demo(示例是一个跨四个仓库的咖啡订阅应用)。

为什么值得了解

  • AI 写代码越快,“看不懂自己代码库”的问题越普遍:floorplan 把“理解代码”这件事本身交回给 Agent,补上了 AI 编程流程里缺的那张图
  • 它不是静态文档生成器,而是能提问、能更新的活地图:边开发边维护,图永远跟代码同步
  • 对正在求职的开发者来说,接手陌生代码库、快速讲清系统结构是面试和入职的高频场景,这个工具直接对得上

English Version

floorplan (GitHub: https://github.com/haydenschmitty/floorplan , created 2026-10-27, 3,362 stars at this morning’s fetch) solves a very real pain: you built a working app with a lot of AI help, but ask “what actually happens when someone checks out?” or “what breaks if I change this?” and the honest answer is: no idea.

The approach: let Claude Code or Codex read your codebase and draw an interactive map. Every module, file and web request gets a plain-English name, and every connection between them is shown. The map can be explored, questioned directly, and kept up to date as you work. The README puts it plainly: this is “the diagram nobody drew”. For builders, it helps you understand what you made without reading the code; for teams, a new member can go from the big picture down to the exact implementation in minutes. The repo ships as a Claude Code plugin and a Codex plugin, needs Node 18+, has zero dependencies, is MIT licensed, and offers a live demo you can explore without installing anything (the example is a coffee-subscription app spread across four repos).

Why it’s worth knowing

  • The faster AI writes code, the more common the “I can’t understand my own codebase” problem becomes: floorplan hands the job of understanding code back to the agent, filling in the missing diagram in the AI-coding workflow
  • It is not a static doc generator but a living map you can question and update: maintained alongside development, so the map never drifts from the code
  • For developers on the job hunt, taking over an unfamiliar codebase and explaining a system’s structure quickly is a constant interview and onboarding scenario — this tool speaks directly to it


评论(0)

查看评论列表

暂无评论


发表评论

表情 颜文字

插入代码