¿Qué es Floorplan?
Floorplan es un plugin para Claude Code y Codex que lee una base de código y dibuja un mapa interactivo de ella en un archivo HTML local. Cada parte, archivo, endpoint y pantalla recibe una descripción en lenguaje llano, y enlaza cada petición web del frontend con el endpoint del servidor que la responde, incluso entre repositorios separados.
Unos scripts en Node puro hacen el trabajo mecánico de analizar imports, rutas y peticiones en una docena de lenguajes; el agente se encarga de nombrar y describir. Sobre el mapa hay una barra Ask que responde preguntas con un minimapa de las piezas implicadas, flujos guiados, un tablero Recent work con lo que el agente acaba de cambiar, un Health check para errores comunes en apps hechas con IA y blueprints a partir de un PRD antes de que exista código.
Tiene licencia MIT, no tiene dependencias y funciona con tu plan actual de Claude o ChatGPT, sin clave de API.
¿Merece la pena Floorplan?
Floorplan apunta a un lector que la mayoría de herramientas de código ignora: alguien que publicó una app con mucha ayuda de IA y no sabe responder a "¿qué pasa cuando alguien paga?". Lo responde con un mapa ampliable escrito en lenguaje llano, y el crecimiento del repositorio demuestra que la necesidad es real: unas 2.568 estrellas y 187 forks desde su creación el 27 de octubre de 2026.
La decisión de diseño que importa es el reparto del trabajo. El análisis, el emparejamiento de peticiones con endpoints y la disposición son scripts deterministas de Node sin dependencias; el modelo solo nombra y describe. Eso mantiene las conexiones del mapa ancladas en el código y no en las suposiciones del modelo, y abarata las actualizaciones, porque solo se vuelven a leer los archivos que cambiaron.
El Health check es la función con más probabilidades de ganarse su sitio. Señala claves en el código o enviadas al navegador, tablas de Supabase que cualquiera puede leer, reglas de Firebase abiertas, webhooks de Stripe falsificables y endpoints sin inicio de sesión, cada uno con un prompt de corrección. El README admite con honestidad que es "a check, not an audit": no encontrará fallos de lógica y cubre los errores típicos de un estilo concreto de app.
Los límites son los de un proyecto nuevo que va rápido. Las versiones pasaron de v0.4.4 a v0.6.3 entre el 31 de octubre y el 2 de noviembre de 2026, hay 8 colaboradores y 29 issues y pull requests abiertos, y la detección de endpoints depende de una lista fija de frameworks. El primer mapa de una app grande tarda más y consume más del uso de tu plan, porque se describe cada archivo.
En seguridad el proyecto hace más que la mayoría de plugins: sin hooks, sin servidores MCP, sin descargas, una prueba que lo comprueba en cada cambio y huellas de archivos por versión. Su única llamada al exterior es un correo opcional para una lista de espera. Frente a Archify, que dibuja diagramas pulidos de cualquier cosa, y Understand Anything, que construye un grafo a nivel de función para desarrolladores, Floorplan es el indicado para dueños que quieren entender y revisar su propia app.
Dónde se gana su sitio
Una fundadora en solitario con una app en Next.js y Supabase hecha casi toda con Claude Code
Saber qué se rompe si cambia la tabla de usuarios
Pide un floorplan y luego pregunta al mapa; responde con las piezas implicadas y un recorrido. El Health check marca las tablas de Supabase legibles por cualquiera, con un prompt de corrección para pegar en Claude Code.
Una agencia de tres personas que pasa la app de un cliente a un desarrollador nuevo
Incorporar a alguien en una tarde en vez de en una semana
Exporta el floorplan como un único archivo HTML y envíalo; el interruptor de vista para desarrolladores muestra los nombres técnicos. Las actualizaciones solo releen los archivos cambiados, así que mantenerlo al día gasta poco del plan.
Un product manager con un PRD y todavía sin código
Ver cada parte, endpoint y pantalla que necesitará la función
Comparte el PRD y pide un floorplan; el blueprint marca las partes planeadas con tarjetas discontinuas y lista las decisiones pendientes. Cuando exista el código, el mismo mapa pasa a ser el mapa de lo real.
Antes de decidirte
- Puesta en marcha
- Node.js 18 o posterior; en Claude Code ejecuta claude plugin marketplace add haydenschmitty/floorplan y luego claude plugin install floorplan@floorplan, o añade el marketplace en la app de Codex. Pide un floorplan; una app pequeña se mapea en unos minutos.
- Integraciones
- Claude Code y Codex. Analiza TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin y Scala; endpoints de Express, Fastify, Next.js, FastAPI, Django, Gin, Axum, Spring y otros; pantallas de Next.js, React Router, Vue, SvelteKit y más.
- Datos y privacidad
- El análisis, el mapa y el servidor local se ejecutan en tu máquina y solo aceptan conexiones locales; la IA lee los archivos con tu propia cuenta, como siempre. Sin analítica; la única petición externa es un correo opcional para la lista de espera. Escribe una carpeta floorplan/ ignorada por git.
- Coste a escala
- Sin cuota; cada primer mapa y cada actualización tiran de tu plan de Claude o ChatGPT. Los proyectos grandes se reparten entre ayudantes en paralelo, así que usan más del plan.
- Límites
- 29 issues y pull requests abiertos; los frameworks fuera de la lista tienen un soporte más ligero; la barra Ask necesita la CLI de Claude Code o Codex para leer el código real.
Lo bueno
- Mapa en lenguaje llano que une peticiones del frontend con endpoints del backend entre repos
- Health check de claves filtradas, Supabase y Firebase abiertos y webhooks falsificables
- La vista Recent work muestra qué cambió el agente y por qué
- Sin dependencias ni hooks, servidor solo local, licencia MIT
- Funciona con un plan existente de Claude o ChatGPT
Lo malo
- Creado el 27 de octubre de 2026, con un único autor principal
- El Health check cubre solo patrones comunes, no es una auditoría de seguridad
- Los primeros mapas de bases de código grandes son lentos y gastan cuota del plan
- La detección de endpoints y pantallas se limita a los frameworks listados
Ideal para
Fundadores y equipos pequeños que han construido una app con Claude Code o Codex y necesitan entenderla, explicarla o revisarla sin leer cada archivo.
Alternativas a Floorplan
Floorplan: preguntas frecuentes
- ¿Merece la pena Floorplan?
- Un mapa de verdad útil para quien ha construido una app con IA y no sabe leerla, aunque con una semana de vida sigue siendo un plugin joven de un solo autor. Le damos un 4.0 sobre 5.
- ¿Cuánto cuesta Floorplan?
- Gratis bajo la licencia MIT. La generación del mapa usa tu propio plan de Claude o ChatGPT; sin clave de API ni cuota aparte.
- ¿Qué inconvenientes tiene Floorplan?
- Creado el 27 de octubre de 2026, con un único autor principal; el Health check cubre solo patrones comunes, no es una auditoría de seguridad; los primeros mapas de bases de código grandes son lentos y gastan cuota del plan; la detección de endpoints y pantallas se limita a los frameworks listados.
- ¿Para quién es Floorplan?
- Fundadores y equipos pequeños que han construido una app con Claude Code o Codex y necesitan entenderla, explicarla o revisarla sin leer cada archivo.
- ¿Cuánto cuesta Floorplan para un equipo o en producción?
- Sin cuota; cada primer mapa y cada actualización tiran de tu plan de Claude o ChatGPT. Los proyectos grandes se reparten entre ayudantes en paralelo, así que usan más del plan.
- ¿Es Floorplan seguro para los datos de la empresa?
- El análisis, el mapa y el servidor local se ejecutan en tu máquina y solo aceptan conexiones locales; la IA lee los archivos con tu propia cuenta, como siempre. Sin analítica; la única petición externa es un correo opcional para la lista de espera. Escribe una carpeta floorplan/ ignorada por git.
- ¿Cuáles son las mejores alternativas a Floorplan?
- Las alternativas más cercanas que hemos analizado son Archify y Repomix.
Respuestas comprobadas el 3 nov 2026.
¿Desarrollas Floorplan? Muestra esta nota en tu web
