O que é Floorplan?
Floorplan é um plugin para Claude Code e Codex que lê uma base de código e desenha um mapa interativo dela em um arquivo HTML local. Cada parte, arquivo, endpoint e tela recebe uma descrição em linguagem simples, e cada requisição web do frontend é ligada ao endpoint do servidor que a responde, mesmo entre repositórios separados.
Scripts em Node puro fazem o trabalho mecânico de analisar imports, rotas e requisições em uma dúzia de linguagens; o agente cuida de nomear e descrever. Sobre o mapa há uma barra Ask que responde perguntas com um minimapa das peças envolvidas, fluxos guiados, um painel Recent work com o que o agente acabou de mudar, um Health check para erros comuns em apps feitos com IA e blueprints a partir de um PRD antes de existir código.
Tem licença MIT, não tem dependências e roda no seu plano atual do Claude ou do ChatGPT, sem chave de API.
Floorplan vale a pena?
O Floorplan mira um leitor que a maioria das ferramentas de código ignora: alguém que lançou um app com muita ajuda de IA e não sabe responder "o que acontece quando alguém paga?". Ele responde com um mapa com zoom escrito em linguagem simples, e o crescimento do repositório mostra que a necessidade é real: cerca de 2.568 estrelas e 187 forks desde a criação, em 27 de outubro de 2026.
A decisão de design que importa é a divisão do trabalho. Análise, ligação de requisições a endpoints e layout são scripts Node determinísticos sem dependências; o modelo só nomeia e descreve. Isso mantém as conexões do mapa presas ao código, e não aos palpites do modelo, e deixa as atualizações baratas, porque só os arquivos alterados são relidos.
O Health check é o recurso com mais chance de justificar o lugar. Ele aponta chaves no código ou enviadas ao navegador, tabelas do Supabase que qualquer um pode ler, regras abertas do Firebase, webhooks do Stripe que podem ser falsificados e endpoints sem login, cada um com um prompt de correção. O README admite com honestidade que é "a check, not an audit": não vai achar falhas de lógica e cobre os erros típicos de um estilo específico de app.
Os limites são os de um projeto novo e rápido. As versões foram de v0.4.4 a v0.6.3 entre 31 de outubro e 2 de novembro de 2026, há 8 contribuidores e 29 issues e pull requests abertos, e a detecção de endpoints depende de uma lista fixa de frameworks. O primeiro mapa de um app grande demora mais e consome mais do uso do seu plano, porque cada arquivo é descrito.
Em segurança, o projeto faz mais que a maioria dos plugins: sem hooks, sem servidores MCP, sem downloads, um teste que confere isso a cada mudança e impressões digitais dos arquivos por versão. A única chamada externa é um e-mail opcional para uma lista de espera. Diante do Archify, que desenha diagramas caprichados de qualquer coisa, e do Understand Anything, que monta um grafo em nível de função para desenvolvedores, o Floorplan é o indicado para donos que querem entender e conferir o próprio app.
Onde ele se destaca
Uma fundadora solo com um app em Next.js e Supabase feito quase todo pelo Claude Code
Descobrir o que quebra se a tabela de usuários mudar
Peça um floorplan e depois pergunte ao mapa; ele responde com as peças envolvidas e um passo a passo. O Health check aponta tabelas do Supabase legíveis por qualquer um, com um prompt de correção para colar no Claude Code.
Uma agência de três pessoas passando o app de um cliente para um desenvolvedor novo
Integrar alguém em uma tarde em vez de uma semana
Exporte o floorplan como um único arquivo HTML e envie; a chave de visão de desenvolvedor mostra os nomes técnicos. As atualizações só releem arquivos alterados, então mantê-lo em dia gasta pouco do plano.
Um gerente de produto com um PRD e ainda sem código
Ver cada parte, endpoint e tela que o recurso vai exigir
Compartilhe o PRD e peça um floorplan; o blueprint marca as partes planejadas com cartões tracejados e lista as decisões em aberto. Quando o código existir, o mesmo mapa vira o mapa do sistema real.
Antes de decidir
- Configuração
- Node.js 18 ou mais recente; no Claude Code rode claude plugin marketplace add haydenschmitty/floorplan e depois claude plugin install floorplan@floorplan, ou adicione o marketplace no app do Codex. Peça um floorplan; um app pequeno é mapeado em poucos minutos.
- Integrações
- Claude Code e Codex. Analisa TypeScript, JavaScript, Python, Go, Rust, Java, Kotlin e Scala; endpoints de Express, Fastify, Next.js, FastAPI, Django, Gin, Axum, Spring e outros; telas de Next.js, React Router, Vue, SvelteKit e mais.
- Dados e privacidade
- A varredura, o mapa e o servidor local rodam na sua máquina e só aceitam conexões locais; a IA lê os arquivos pela sua própria conta, como sempre. Sem analytics; a única requisição externa é um e-mail opcional para a lista de espera. Grava uma pasta floorplan/ ignorada pelo git.
- Custo em escala
- Sem taxa; cada primeiro mapa e cada atualização usam seu plano do Claude ou do ChatGPT. Projetos grandes são divididos entre ajudantes paralelos e por isso consomem mais do plano.
- Limites
- 29 issues e pull requests abertos; frameworks fora da lista têm suporte mais leve; a barra Ask precisa da CLI do Claude Code ou do Codex para ler o código real.
O que é bom
- Mapa em linguagem simples que liga requisições do frontend a endpoints do backend entre repos
- Health check para chaves vazadas, Supabase e Firebase abertos e webhooks falsificáveis
- A visão Recent work mostra o que o agente mudou e por quê
- Sem dependências nem hooks, servidor só local, licença MIT
- Roda em um plano existente do Claude ou do ChatGPT
O que não é
- Criado em 27 de outubro de 2026, com um único autor principal
- O Health check cobre só padrões comuns, não é auditoria de segurança
- Primeiros mapas de bases grandes são lentos e gastam cota do plano
- Detecção de endpoints e telas limitada aos frameworks listados
Ideal para
Fundadores e equipes pequenas que construíram um app com Claude Code ou Codex e precisam entendê-lo, explicá-lo ou conferi-lo sem ler cada arquivo.
Alternativas ao Floorplan
Floorplan: perguntas frequentes
- Floorplan vale a pena?
- Um mapa realmente útil para quem construiu um app com IA e não consegue lê-lo, embora, com uma semana de vida, ainda seja um plugin jovem de um único autor. Damos nota 4.0 de 5.
- Quanto custa Floorplan?
- Gratuito sob a licença MIT. A geração do mapa usa seu próprio plano do Claude ou do ChatGPT; sem chave de API nem taxa à parte.
- Quais são as desvantagens de Floorplan?
- Criado em 27 de outubro de 2026, com um único autor principal; o Health check cobre só padrões comuns, não é auditoria de segurança; primeiros mapas de bases grandes são lentos e gastam cota do plano; detecção de endpoints e telas limitada aos frameworks listados.
- Para quem Floorplan é indicado?
- Fundadores e equipes pequenas que construíram um app com Claude Code ou Codex e precisam entendê-lo, explicá-lo ou conferi-lo sem ler cada arquivo.
- Quanto custa Floorplan para uma equipe ou em produção?
- Sem taxa; cada primeiro mapa e cada atualização usam seu plano do Claude ou do ChatGPT. Projetos grandes são divididos entre ajudantes paralelos e por isso consomem mais do plano.
- Floorplan é seguro para dados da empresa?
- A varredura, o mapa e o servidor local rodam na sua máquina e só aceitam conexões locais; a IA lê os arquivos pela sua própria conta, como sempre. Sem analytics; a única requisição externa é um e-mail opcional para a lista de espera. Grava uma pasta floorplan/ ignorada pelo git.
- Quais são as melhores alternativas ao Floorplan?
- As alternativas mais próximas que analisamos são Archify e Repomix.
Respostas verificadas em 3 de nov. de 2026.
Você faz o Floorplan? Mostre esta nota no seu site
