Blog

Notas do Laboratório

Documentação técnica, decisões de engenharia e reflexões sobre a construção de sistemas que funcionam. Escrever como ferramenta de pensamento.

Filtrar:
23 de jul. de 20264 min read

O Prompt Nunca Foi o Problema

Amigos e familiares viviam me pedindo dicas de IA. Depois de conversas suficientes, o padrão ficou óbvio: quase ninguém estava travado no prompt. Estavam travados em descrever o que realmente queriam.

IAAprendizadoEnsinoWorkshop
Ler mais
14 de jul. de 20263 min read

Depurando um RCU Stall no Proxmox: A Causa Não Era a Placa de Rede

O servidor ficava inacessível a cada poucas horas e exigia reboot físico. Eu tinha acabado de trocar a placa de rede, então obviamente a culpa era dela. Não era.

HomelabProxmoxLinuxDebugging
Ler mais
24 de jun. de 20264 min read

Por Que Construir um Homelab em 2026

A cloud te dá escala. Um homelab te dá coragem de destruir e recriar sem medo de conta surpresa — e essa diferença muda a forma como você aprende.

HomelabInfraestruturaProxmoxAprendizado
Ler mais
3 de jun. de 20264 min read

Multi-tenancy em SaaS B2B: Trade-offs e o Modelo Que Escolhi

Multi-tenancy é a decisão arquitetural mais irreversível de um SaaS B2B — e a maioria dos times a toma implicitamente, no meio de uma sprint, quando percebe que precisa isolar dados de clientes diferentes.

ArquiteturaPostgreSQLMulti-tenancySegurança
Ler mais
20 de mai. de 20263 min read

Escolhendo Rails para um Produto de Compliance

Um desenvolvedor, dezoito semanas, um produto de compliance B2B. A decisão de stack errada pode dobrar o esforço sem você perceber até a semana doze.

ArquiteturaRubyRailsDecisões
Ler mais
6 de mai. de 20264 min read

Por Que Eu Escrevo ADRs Antes de Escrever Código

Código captura o que você construiu. Um ADR captura por que você construiu assim — e o porquê é a primeira coisa a desaparecer conforme o projeto envelhece.

ArquiteturaDocumentaçãoDecisõesEngenharia
Ler mais
22 de abr. de 20264 min read

A Staff Architect Skill: Projetando Produtos com IA

A maioria dos times usa IA para escrever código mais rápido. Eu uso para não tomar decisões arquiteturais ruins às 23h sob pressão de sprint.

IAArquiteturaProdutoEngenharia
Ler mais
8 de abr. de 20264 min read

Cursor Rules: Contexto Persistente para o Seu Agente de IA

Você reconfigura o agente a cada conversa nova porque ele não lembra de nada. Isso é um problema de design, não uma limitação inevitável.

IACursorFerramentasEngenharia
Ler mais
25 de mar. de 20264 min read

Compound Engineering: O Loop Que Transforma Experiência em Ativos

Plan, Work, Review — todo engenheiro faz isso. O quarto passo é o que separa quem acumula conhecimento de quem refaz o mesmo trabalho indefinidamente.

ProcessoEngenhariaConhecimentoAprendizado
Ler mais
11 de mar. de 20264 min read

Por Que Todo Repositório Deveria Ter uma Pasta docs/solutions

Um dev que entra no projeto seis meses depois não precisa do changelog. Precisa saber por que a decisão foi tomada e o que quase deu errado. Uma pasta, versionada junto ao código, captura exatamente isso.

DocumentaçãoProcessoConhecimentoEngenharia
Ler mais
26 de fev. de 20265 min read

Zettelkasten para Engenheiros: Por Que e Como Eu Uso

Conhecimento técnico decai. O que você dominou sobre row-level security no PostgreSQL em 2024 está inacessível em 2026, a menos que esteja indexado e conectado. Zettelkasten não é um sistema de organização — é um sistema de pensamento.

ConhecimentoZettelkastenLogseqEngenharia
Ler mais
10 de fev. de 20262 min read

Projetando Peças 3D Confiáveis

Lições de centenas de horas de impressão sobre como a escolha de material, orientação e tolerâncias determinam se uma peça sobrevive ao uso real ou falha no primeiro dia.

Impressão 3DFDMDesignConfiabilidade
Ler mais
28 de jan. de 20262 min read

Por Que o Pensamento Sistêmico Importa na Arquitetura de Software

Software não é uma coleção de funcionalidades. É um sistema de dependências, loops de feedback e modos de falha. Como pensar em sistemas muda a forma como você constrói.

SoftwareArquiteturaSistemasEngenharia
Ler mais