DEV Community: Fran Borges

[Boost]

Fran Borges — Sat, 04 Apr 2026 00:34:26 +0000

De front-end para UX, e de volta ao código: o que significa ser Design Engineer em 2026 - DEV Community

Sou UX/UI designer, mas antes disso fui front-end. Atuei cerca de 5 anos trabalhando com HTML e CSS,...

dev.to

Engenharia de Prompt: Por Que a Forma Como Você Pergunta Muda Tudo(Um guia introdutório)

Fran Borges — Mon, 23 Mar 2026 16:20:34 +0000

Neste artigo irei explicar alguns pontos importantes sobre Engenharia de prompt, e como saber esses pontos pode te ajudar muito no dia a dia lidando com IAs, no seus estudos, pesquisas, trabalho, vibeconding, whatever.

Prefácio
Antes de tudo, para lembrar, o que é uma LLM mesmo?
Fazendo Perguntas
- 1 - Evite a Ambiguidade
- 2 - Delimite o Escopo
- 3 - Forneça Contexto Relevante
Considerações Finais

Prefácio

A base do conhecimento é necessária em tudo que se quer aprender, com LLMs não é diferente. Analisando padrões, conversando com amigos, observei que a grande parte das pessoas que usam LLMs no dia a dia de trabalho, estudo, pessoas que trabalham com tecnologia e principalmente quem está começando na área tech, não tem ideia de como a LLM funciona e de como fazer as perguntas e tirar dúvidas de forma certa para um ChatGPT da vida.

Tendo isso em vista, e como venho estudando bastante sobre esse assunto, como forma de compartilhar o conhecimento, já dizia a poetisa brasileira Cora Coralina: "Feliz aquele que transfere o que sabe, e aprende o que ensina", farei uma série de artigos explicando sobre o tema, e esse é só o primeiro deles...

Antes de tudo, para lembrar, o que é uma LLM mesmo?

A LLM pode ser definida de algumas formas. Uma delas é: "São modelos de linguagem de máquina, que usam algoritmos de aprendizado profundo (Deep Learning) para processar e aprender a linguagem natural", essa é a sua definição estrutural. A definição que mais gosto é: "A LLM, na sua essência, é composta por dois arquivos: um contendo os pesos (parâmetros) com os conhecimentos aprendidos, e o outro com o código necessário para rodar os dados aprendidos.", como uma pessoa visual, consigo imaginar melhor como funciona.

Então, ChatGPT, Claude e muitos outros são exatamente isso, e atualmente têm a capacidade de executar várias atividades, como escrever código, traduzir texto, responder às mais variadas dúvidas e, dependendo da sua capacidade de escrever prompts mais robustos, pode até criar arquiteturas de produtos, te ajudar a resolver bugs complexos, te dar ideias, e até criar um SaaS revolucionário (risos).

O ponto é que a capacidade das LLMs de "compreender" e "criar" chegou a um ponto bem avançado, e você só chega na camada -17 de boas respostas fazendo as perguntas de forma certa!

Nota: Camada -17 se refere à camada onde se acha o minério de ouro no jogo Minecraft ;).

Fazendo Perguntas

Como fazer as perguntas certas? E por que saber isso importa? Vamos lá.

Saber fazer as perguntas certas para uma LLM é tão importante que existe uma área da tecnologia específica só para isso: a Engenharia de Prompts, definida como "a ciência empírica de planejar, criar e testar prompts para gerar melhores respostas em LLMs". Saber fazer as perguntas certas te coloca em outro nível, você consegue obter as melhores respostas, e isso te traz muitos ganhos, sendo o principal deles a produtividade.

Mas afinal, como perguntar de forma certa?

A LLM é poderosa, mas não adivinha sua intenção. Para obter os melhores resultados nas suas buscas, você precisa se concentrar na criação de prompts claros, na especificidade e ser rico em dar contexto. E tudo isso envolve:

1 - Evite a Ambiguidade

"Espaço de possibilidades"

Quando você escreve um prompt muito ambíguo, vago, o modelo enxerga vários caminhos estatisticamente válidos. É como se ele estivesse numa encruzilhada com 50 estradas e todas tivessem placas dizendo "Talvez por aqui", ele vai escolher uma, mas não necessariamente a que você precisa: a estrada com o percurso mais rápido e sem trânsito (a resposta correta de fato).

Exemplos:

Prompt ambíguo:

"Crie uma API."

O que a LLM "vê": Vários caminhos, API REST? GraphQL? Em qual linguagem? Para qual domínio? Com autenticação? Com banco? O modelo vai escolher o caminho mais estatisticamente comum nos dados de treino (provavelmente uma API REST genérica em Node.js com Express), que pode não ter nada a ver com o que você precisa.

Prompt sem ambiguidade:

"Crie um microsserviço em Node.js com Express e TypeScript para processar pagamentos via
Stripe. Endpoints: criar pagamento, confirmar webhook e consultar status. O payload tem:
orderId(UUID), amount(number), currency(enum: BRL, USD) e customerId(string).
Use zod para validação, Prisma com PostgreSQL para persistir as transações e winston
para logs. Retorne status codes apropriados como(201, 200, 400, 422, 500). Trate falhas de
rede com retry automático (máx. 3 tentativas)."

O que a LLM "vê": Um caminho quase único. Cada detalhe funciona como uma restrição que elimina ambiguidade: "Node.js com Express e TypeScript" define runtime, framework e linguagem de uma vez. "Pagamentos via Stripe" restringe o SDK e o domínio. "3 endpoints explícitos + payload com tipos" elimina adivinhações sobre rotas e schema. "Zod, Prisma, PostgreSQL, Winston" travam a stack, o modelo não vai sugerir alternativas. "Status codes específicos + retry com máximo de 3 tentativas" definem os status HTTP e a estratégia com limites claros. A distribuição de probabilidade fica concentrada e o modelo praticamente "só tem uma opção" a cada token gerado.

2 - Delimite o Escopo

"Janela de atenção"

LLMs têm um context window(Janela), uma quantidade de tokens (pedaço de palavra) que conseguem ser processados de uma vez. Isso inclui o seu prompt e a resposta gerada. Dentro dessa janela, existe um fenômeno importante: nem todos os tokens recebem a mesma "atenção" no processamento.

O mecanismo de self-attention (o coração da arquitetura Transformer, não é um cubo rsrsrs, e a arquitetura de rede neural, que seria o framework da LLM se a mesma fosse uma linguagem de programação), ela define a estrutura de tudo, calcula relações entre todos os tokens do prompt. Quanto mais tokens irrelevantes existem, mais o modelo precisa "dividir atenção" entre informações úteis e inúteis.

Exemplos:

Sem escopo:

"Me ensine Docker."

O que acontece internamente: O modelo precisa decidir entre centenas de subtópicos, instalação, conceitos básicos, Dockerfile, docker-compose, volumes, orquestração, a atenção se fragmenta e o resultado é um overview superficial de tudo.

Com escopo:

"Explique o conceito de multi-stage build no Docker para um dev backend pleno que já usa
Docker no dia a dia mas nunca otimizou o tamanho das imagens. Mostre um exemplo prático
com uma aplicação JavaScript, comparando o Dockerfile sem e com multi-stage build,
incluindo o tamanho final de cada imagem."

O que acontece internamente: O mecanismo de atenção se concentra em uma região muito específica, a interseção entre "Docker", "multi-stage build", "otimização de imagem" e "JavaScript". Os pesos de atenção ficam fortemente direcionados.

3 - Forneça Contexto Relevante

"Estado da aplicação"

Uma LLM é stateless por natureza, ela não tem memória entre requisições. Cada prompt é processado do zero, o único "estado" que ela tem é o que você coloca no prompt. Isso significa que todo contexto que você não fornece simplesmente não existe para o modelo.

Internamente, o contexto funciona como um sistema de pesos no mecanismo de atenção. Quando você adiciona informações, elas criam "âncoras" que influenciam a distribuição de probabilidades de todos os tokens subsequentes, é como se cada pedaço de contexto fosse um ímã que puxa a resposta para uma direção específica.

Exemplos:

Sem contexto:

"Revise meu código."

O que a LLM faz: Sem saber a linguagem, o framework, o nível do dev, o objetivo do código, o padrão do time ou o tipo de revisão esperada, ela vai fazer comentários genéricos: "adicione tratamento de erro", "use nomes mais descritivos", "considere adicionar testes".

Com contexto:

"Revise este endpoint Node.js com Express que lida com upload de arquivos para o S3.
O time usa ESLint + Prettier, então ignore estilo. O padrão do time é async/await com
try/catch e erros customizados. Endpoint em produção, recebe 200 uploads/min.
Foque em: memory leaks, tratamento de erros e uso correto do SDK do S3."

O que a LLM faz: Cada informação do prompt funciona como um filtro que elimina ruído e concentra a revisão: "Node.js com Express + upload para S3" ativa conhecimento específico sobre streams, buffers, multipart e AWS SDK. "ESLint + Prettier, ignore estilo" elimina os comentários possíveis que o linter já resolve. "async/await com erros customizados" faz o modelo pular sugestões que o time já aplica e focar em como estão sendo usadas. "Produção, 200 uploads/min" muda o peso de cada problema, um buffer não liberado que seria aceitável em dev vira um incidente crítico sob carga. "Foque em: memory leaks, erros, SDK S3" restringe a revisão a 3 eixos e ignora dezenas de outros tópicos.

Com base nisso, saber as limitações do modelo que você está usando, te ajuda também a entender até aonde você pode ir nas perguntas e inferências, então escolha a sua melhor IA, treine ela, faça as suas perguntas, teste, tente! ;)

É Lembre-se: a LLM não "pensa", ela calcula probabilidades!

Considerações Finais

É isto, tentei resumir cada ponto que achei interessante abordar e explicar nessa primeira etapa, mas há muito mais sobre engenharia de prompt de LLM para falar, como técnicas mais clássicas de engenharia de prompts(Zero-shot prompting, Role prompting), técnicas mais avançadas(Chain-of-Thought (CoT), Prompt Chaining), são muitas camadas que tentarei destrinchar nos próximos artigos, esse é apenas o primeiro que traz a minha volta para a escrita de artigos após alguns bons anos. Espero que você caro leitor tenha entendido e aprendido algo. Obrigado por ler até aqui. ;)

Onde me encontrar:

Meu LinkedIn
Meu GitHub

O Futuro do Desenvolvimento Web: Node.js vs Bun.

Fran Borges — Mon, 02 Oct 2023 20:48:46 +0000

Introdução
Ambiente e Cenário Atual
Bun: Mais uma Alternativa no Universo da Programação
Node.js em Detalhes: O Que Você Precisa Saber
Um pouco sobre JavaScript
V8: A Tecnologia que Impulsiona a Web
O Impacto do Bun sobre outros ecossistemas!
Conclusão

Introdução

Este artigo apresentará a análise e o impacto de um dos lançamentos mais comentados no mundo da tecnologia no último mês, conhecido como Bun. Desde seu lançamento, o Bun tem gerado grande entusiasmo e levantado questionamentos sobre como ele pode potencialmente desafiar a posição do Node.js como uma das principais plataformas de execução de JavaScript. Neste artigo, exploraremos as razões por trás desse entusiasmo, bem como os aspectos em que o Bun promete oferecer uma alternativa competitiva ao Node.js, potencialmente sacudindo as bases dos ecossistemas JavaScript.

Contextualizando O que é Bun e Node.js? E para que eles servem?

Explorando o Potencial do Bun!

Sé você não sabe ou perdeu as últimas notícias do mundo tech no último mês foi lançada a versão 1.0 de um novo runtime para JavaScript que vem prometendo derrubar outro runtime o mais conhecido e usado até então Node.js. Bun e um novo runtime para JavaScript e Typescript que seguindo a sua descrição permite, testar, executar e agrupar projetos fazendo o bundle em JavaScript e Typescript, é um kit de ferramentas para JavaScript tudo em um, projetado para velocidade, compatível com Node.js e com algumas das seguintes premissas:

Velocidade: Bun é rápido, usando o JavaScriptCore, o mecanismo JS voltado para desenvolvimento de apps que executem JavaScript incorporando diretamente nos sistemas da Apple.

APIs Simplificadas: Bun oferece APIs mínimas e altamente eficientes para tarefas comuns, como iniciar servidores HTTP e manipular arquivos.

Experiência de Desenvolvimento Unificada: Bun é um conjunto completo de ferramentas para criar aplicativos JavaScript, incluindo gerenciamento de pacotes, testes e empacotamento.

Suporte Nativo: Oferece suporte nativo a Typescript, e compilação built-in que e o processo de transformar código Typescript em código JavaScript.

O Bun usa o JavaScriptCore da Apple e foi desenvolvido em C e C++ mais a grande parte do seu código e escrita na linguagem Zig, que é uma linguagem de programação de código aberto projetada para ser uma alternativa mais moderna, rápida e segura a outras linguagens de baixo nível, como as próprias C e C++.

Documentação do Bun

Node.js

O Node, o runtime até então mais famoso e usado, é um runtime também porque tem em sua base um ambiente de execução que permite que você execute código JavaScript além do navegador, e fornece as ferramentas necessárias para que o código JavaScript interaja com o sistema e realize tarefas de servidor, com algumas das seguintes premissas.

Execução no servidor: Com o Node.js, você pode criar aplicativos de servidor, como sites, APIs e serviços, usando JavaScript.

Plataforma única: Ele fornece uma plataforma única para desenvolver tanto o lado do servidor quanto o lado do cliente de um aplicativo, tornando mais fácil compartilhar código entre essas partes.

Modelo de programação assíncrona: O Node.js utiliza um modelo de programação assíncrona, o que significa que permite que o código execute operações de forma não bloqueante, tornando-o eficiente para manipular muitas conexões simultâneas.

Event-Driven: Usa um modelo de programação orientado a eventos, onde ações desencadeiam eventos e funções são executadas em resposta a esses eventos.

O Node.js foi desenvolvido principalmente usando a linguagem C e também incorpora códigos escritos em C++. É um ambiente de tempo de execução JavaScript construído sobre o motor V8 do Google, escrito em C++. Portanto, a base do Node.js é a combinação de código C/C++ e JavaScript.

Site e Doc do Node.js

Javascript

JavaScript é uma linguagem de programação usada principalmente na web. É uma linguagem interpretada, por trás disso, muitas vezes é utilizada a engine V8, desenvolvida pelo Google, para transformar em linguagem de máquina e executar o código JavaScript de forma eficiente.

Mas como funciona essa relação entre a linguagem JavaScript ser interpretada e a V8 transformar isso em linguagem de máquina?

JavaScript Interpretado:

JavaScript é uma linguagem de programação interpretada, o que significa que o código é lido e executado linha por linha em tempo real, como se você estivesse lendo um livro linha por linha e página por página.

Quando você abre uma página da web, um site, com código JavaScript, o navegador interpreta cada linha de código e a executa sequencialmente, realizando as ações especificadas no código, como abrir um modal, mostrar animações ou mostrar um botão para clicar.

A V8

É uma engine de JavaScript desenvolvida pelo Google.

Ela é usada principalmente no ambiente de execução Node.js e no navegador Google o Chrome.

A V8 é responsável por executar código JavaScript de uma maneira eficiente, compilando-o, ela não executa o código diretamente como texto, mas sim o converte em código de máquina antes da execução, para ser executado rapidamente.

A V8 se concentra na velocidade de execução e é projetada para tornar o JavaScript mais rápido e utiliza uma técnica chamada Compilação Justin-In-Time (JIT), que transforma o código JavaScript em um código de máquina mais otimizado e sob demanda, á medida que o código é executado.

Isso significa que enquanto o JavaScript faz a festa é e interpretado linha por linha, a V8 compila e otimiza o código à medida que avança, melhorando a velocidade de execução e afins.

Portanto, a relação entre a linguagem JavaScript ser interpretada e a V8 estar na V8 atuando como um intermediário que compila e otimiza o código JavaScript em código de máquina, tornando a execução mais rápida e eficiente à medida que o código é interpretado.

O Potencial Impacto do Bun no Ecossistema Node.js

O Bun, tem a ambição de criar o seu ecossistema próprio, e já vimos que promete trazer mudanças significativas ao cenário do Node.js e de outros, mas tomando como exemplo outras criações como a de outro ambiente de execução JavaScript, o Deno criado coincidentemente pelo mesmo criador do Node.js Ryan Dahl, sé formos comparar o impacto que o Deno trouxe ao Node, só foram impactos positivos e abaixo eu exploro um pouco melhor esses impactos.

Diversidade e Inovação:
O surgimento do Bun como um novo ambiente de execução JavaScript representa uma oportunidade para a diversificação do ecossistema. A concorrência pode ser saudável entre as plataformas pode levar a uma maior inovação para todos os lados, resultando em melhorias nas ferramentas, na eficiência e na experiência de desenvolvimento para os usuários do Node.js.

O Deno: também criado também por Ryan Dahl, forneceu valiosas lições sobre como melhorar o ecossistema JavaScript. Suas ênfases na segurança, sistema de módulos e suporte ao TypeScript inspiraram melhorias no Node.js. O Bun pode continuar essas evoluções, incorporando as melhores práticas aprendidas com o Deno para beneficiar os desenvolvedores e a comunidade Node.js

Escolha e Flexibilidade:
A existência do Bun oferece a nós desenvolvedores mais opções, podemos escolher a plataforma que melhor atender às necessidades dos nossos projetos e essa flexibilidade pode resultar em um ecossistema mais adaptável e ágil.

Conclusão

Em resumo, o Bun representa uma emocionante reviravolta no ecossistema JavaScript e pode desempenhar um papel vital no desenvolvimento futuro de aplicações JS/TS e melhorias contínuas ao Node.js e outros. À medida que ambas as plataformas evoluem, os desenvolvedores podem esperar colher os frutos dessa competição e inovação, resultando em um ambiente de desenvolvimento JavaScript cada vez mais robusto e diversificado.

Espero que esse artigo seja útil de alguma forma!!

Minhas redes sócias e outros!

Meu LinkedIn
Meu Instagram
Meu GitHub

Entendendo os códigos de status HTTP: Um guia teórico para desenvolvedores.

Fran Borges — Mon, 18 Sep 2023 13:49:54 +0000

Tabela de Conteúdos!

Introdução
O que é HTTP e Status Code?
A importância de saber
Exemplos
Mais sobre Status code
Importância para a Resolução de Problemas
Conclusão

Introdução

Códigos de status http poderiam facilmente ser uma linguagem própria de códigos, informando ou às vezes advertindo um usuário por trás de um cliente(navegadores, aplicativos) ou servidores web de que uma requisição foi bem sucedida ou não, e se você já se viu recebendo algum erro como "404 Not found" ou "500 Internal Server Error" enquanto estava navegando pela internet, você já viu os códigos de status HTTP em ação. Nesse artigo, iremos conhecer e entender porque os códigos de status code são tão importantes e, porque a compreensão desses códigos e uma skill fundamental para nós desenvolvedores de software e analistas de sistemas.

Mas antes que é HTTP E o que são status HTTP?

HTTP (Hypertext Transfer Protocol): É um protocolo de comunicação usado na internet para transferir dados entre um navegador da web (cliente) e um servidor da web. Basicamente, é a "linguagem" que permite que você acesse páginas da web, e busque por sites de dogs fofinhos, e muito mais.

Status HTTP: São códigos numéricos que o servidor da web envia de volta para o navegador quando você faz uma solicitação (como abrir um site). Esses códigos indicam o resultado da solicitação. Por exemplo, o código "200 OK" significa que a solicitação foi bem-sucedida, enquanto o código "404 Not Found" indica que a página que você procurava não foi encontrada no servidor. Em resumo, os códigos de status HTTP comunicam o que aconteceu com a sua solicitação.

Por que a Compreensão sobre esse Tópico é Importante para os desenvolvedores:

Quando acessamos um site, o navegador ou aplicativo faz solicitações/requisições para servidores na web. Essas solicitações podem ser para vários recursos como carregar um video, buscar por uma imagem de gatinho fofo ou enviar um formulário. Os códigos de status HTTP que os servidores enviam de volta como resposta a essas solicitações trazem junto mensagens importantes para entendermos se a solicitação foi bem sucedida ou não.

Para desenvolvedores, entender esses códigos e essencial para saber depurar com mais eficiência erros e problemas como, problemas de autenticação, servidor instável e links que não funcionam, e, além disso, saber interpretar códigos de status para fornecer as respostas adequadas aos clientes.

Exemplos de Códigos de Status HTTP:

Para ilustrar melhor a importância dos códigos de status HTTP, vejamos alguns exemplos comuns:

200 OK:

Este é o sinal verde da web. Indica que a solicitação foi bem-sucedida e que o servidor está retornando o conteúdo solicitado. Quando você acessa uma página da web e consegue acessar, visualizar pelo que buscou, geralmente você recebe este código.

404 Not Found:

Um dos códigos mais famosos. Indica que o recurso solicitado não foi encontrado no servidor. Isso pode ocorrer quando um link está quebrado ou quando você tenta acessar uma página que não existe.

401 Unauthorized:

Indica que o cliente não está autorizado a acessar o recurso. Geralmente, isso ocorre quando você tenta acessar uma área restrita sem fazer o login antes.

400 Bad Request:

Indica que o servidor web não conseguiu entender ou processar a solicitação feita pelo cliente (como um navegador da web ou um aplicativo). Essa resposta é enviada quando a solicitação do cliente contém informações incorretas, incompletas ou malformadas, como senha ou e-mail incorretos.

500 Internal Server Error:

Este é um erro genérico do servidor, indicando que algo deu errado internamente. É um código que os desenvolvedores web geralmente querem evitar ao máximo, ao máximo mesmo!

Quer explorar mais códigos de status HTTP?

Se você está curioso para ver mais códigos de status HTTP e suas mensagens de resposta de uma forma divertida e fofa, acesse o site http.cat. Este site mostra códigos de status HTTP em um estilo muito único e muito muito fofo com gatos fazendo gatices que ilustram cada código. É uma maneira lúdica de aprender mais sobre como a web comunica informações por meio desses códigos. Divirta-se explorando!

Link para o site

Importância na Resolução de Problemas:

Imagine estar encarregado de um site e receber feedbacks de usuários sobre problemas de acesso a páginas ou recursos. Compreender os códigos de status HTTP permite que você identifique rapidamente o problema. Um "404 Not Found" indica que um recurso está ausente ou um link está quebrado, enquanto um "500 Internal Server Error" sugere um problema interno do servidor que requer investigação.

Além disso, ao desenvolver uma aplicação web, você pode usar códigos de status HTTP para comunicar com clareza a situação para seus clientes. Por exemplo, ao lidar com autenticação, retornar um "401 Unauthorized" informa aos usuários que eles precisam fazer login para acessar um recurso.

Conclusão

Os códigos de status HTTP são uma parte essencial no funcionamento da web e uma ferramenta fundamental para desenvolvedores e analistas de sistemas. Neste artigo, exploramos a importância de compreender esses códigos e fornecemos exemplos práticos para capacitá-lo a interpretá-los de forma eficaz.

Ao entender os códigos de status HTTP e como usá-los em seu trabalho, você estará melhor preparado para solucionar problemas, melhorar a experiência do usuário e construir aplicações web robustas. Portanto, continue aprofundando seu conhecimento sobre esse tópico fundamental para a web moderna.

Espero que esse artigo seja útil para alguém!!

Cover Image by @moovhe4rt <3

Minhas redes sócias e outros!

Meu LinkedIn
Meu Instagram
Meu GitHub

Como variáveis funcionam por debaixo dos panos: Uma breve explicação com Javascript.

Fran Borges — Mon, 24 Apr 2023 14:13:13 +0000

Nesse artigo tentarei dar uma breve explicação de como as variáveis funcionam por debaixo dos panos, segue a explicação logo a abaixo.

As variáveis são parte essencial no desenvolvimento de códigos para desenvolvimento web e no geral, elas são responsáveis por guardar dados que poderão ser manipulados nas nossas aplicações e apps, mas a dúvida que fica e como as variáveis realmente funcionam por debaixo dos panos???

Variáveis

Definição Técnica:
Em programação, as variáveis são pequenos espaços alocados na memória.

Seguindo a ilustração acima podemos perceber que dada à variável declarada ela aloca uma parte da memória do computador, essa parte além de possuir o dado como valor ela possui um endereço, mas isso e assunto para outro artigo.

Declaração de variáveis

Para visualizar a sintaxe das variáveis em javascript, segue os exemplos abaixo.

Onde as variáveis são armazenadas?

As variáveis são alocadas na memória RAM com um espaço reservado de tamanho apropriado, onde seus valores são armazenados usando endereços de memória únicos. Isso permite o acesso eficiente aos dados durante a execução do programa.

Então essa foi uma breve explicação sobre como as variáveis funcionam por debaixo dos panos, e o meu primeiro artigo, então espero que seja o primeiro de muitos!

Minhas redes sócias e outros!

Meu LinkedIn
Meu Instagram
Meu GitHub