Vinicius Rocha

Guia rápido do Herdr

Thu, 23 Jul 2026 00:00:00 +0000

O Herdr é um multiplexador de terminal feito em torno de agentes de codificação. Eu escrevi sobre por que o uso; esta é a referência de atalhos que mantenho por perto enquanto aprendo seu fluxo de trabalho pelo teclado.

O Herdr usa uma tecla de prefixo para não conflitar com os programas em execução dentro de seus painéis. O prefixo padrão é Ctrl+b: pressione-o, solte-o e então pressione a tecla do comando. Neste post, escrevo essa sequência como prefix+key.

Herdr

Wed, 15 Jul 2026 00:00:00 +0000

Nas últimas semanas, venho usando o Herdr como meu multiplexador de terminal diário. Comecei a usá-lo porque gerenciar vários agentes de codificação em janelas de terminal diferentes estava ficando difícil: eu ficava alternando entre sessões o tempo todo para ver quais agentes estavam trabalhando, tinham terminado ou esperavam por mim. O Herdr reúne essas sessões em um só lugar.

O Herdr foi feito pensando em agentes de codificação. Assim como o tmux, ele organiza sessões de terminal em espaços de trabalho, abas e painéis, mantendo seus processos em execução quando eu me desconecto. O que o torna diferente é sua consciência dos agentes de codificação: ele mostra se cada agente está trabalhando, terminou, está ocioso ou esperando minha entrada.

O que é um agente de IA?

Thu, 09 Jul 2026 00:00:00 +0000

Um agente de IA é formado por duas partes essenciais: um loop de raciocínio e um conjunto de ferramentas.

O loop de raciocínio é o processo de pensamento do agente. É o ciclo contínuo de observar o que está acontecendo, interpretar as informações disponíveis, planejar o próximo passo e agir conforme esse plano.

Preparando-se para o Azure AI Fundamentals

Fri, 19 Jun 2026 00:00:00 +0000

TL;DR

passei no exame beta AI-901 e obtive a credencial Microsoft Certified: Azure AI Fundamentals
usei o Microsoft Learn e exercícios práticos em Python como meus principais recursos de preparação
foquei no esboço de habilidades do AI-901, Microsoft Foundry, serviços de IA do Azure, exemplos em Python e IA responsável, em vez de memorização

Recentemente obtive a certificação Azure AI Fundamentals ao passar no exame beta AI-901, e queria registrar os recursos de estudo e a abordagem que me ajudaram a passar. Como o AI-901 está substituindo o AI-900, este post foca nos objetivos mais recentes do exame e no caminho de aprendizado centrado no Microsoft Foundry.

Engenharia de harness

Thu, 28 May 2026 00:00:00 +0000

O que é?

A engenharia de harness de agentes de IA é a prática de construir a infraestrutura essencial que cerca, controla e sustenta sistemas de IA autônomos.

Pense em um agente de IA como um motor de carro de corrida potente e veloz; o “harness” é o chassi, o volante, os freios e o painel de diagnóstico que o tornam realmente dirigível e seguro. Em termos práticos, isso significa que agentes de IA precisam dos ambientes necessários para gerenciamento de memória, integração com ferramentas externas (como conectar-se a APIs ou bancos de dados), salvaguardas de segurança rígidas e monitoramento de desempenho em tempo real. Em última análise, trata-se de construir uma estrutura confiável e supervisionada que permita a esses modelos inteligentes executar tarefas complexas no mundo real sem sair dos trilhos.

O Zen do Python

Tue, 12 May 2026 00:00:00 +0000

O Easter Egg

Execute import this em qualquer interpretador Python e você recebe 19 aforismos escritos por Tim Peters em 1999, embutidos na linguagem como um Easter egg:

Python 3.14.5 (tags/v3.14.5:5607950, May 10 2026, 10:43:50)
Type "help", "copyright", "credits" or "license" for more information.
>>> import this
The Zen of Python, by Tim Peters

Beautiful is better than ugly.
Explicit is better than implicit.
Simple is better than complex.
Complex is better than complicated.
Flat is better than nested.
Sparse is better than dense.
Readability counts.
Special cases aren't special enough to break the rules.
Although practicality beats purity.
Errors should never pass silently.
Unless explicitly silenced.
In the face of ambiguity, refuse the temptation to guess.
There should be one-- and preferably only one --obvious way to do it.
Although that way may not be obvious at first unless you're Dutch.
Now is better than never.
Although never is often better than *right* now.
If the implementation is hard to explain, it's a bad idea.
If the implementation is easy to explain, it may be a good idea.
Namespaces are one honking great idea -- let's do more of those!

Por trás do poema

O poema é anterior ao PEP 20; ele circulou na lista de discussão comp.lang.python anos antes de Guido van Rossum formalizá-lo. O código-fonte do módulo this é, por si só, uma piscadela: o poema é armazenado como uma string codificada em ROT-13 e decodificado no momento do import.

Spinel: o compilador nativo de Ruby do Matz

Fri, 24 Apr 2026 00:00:00 +0000

Yukihiro “Matz” Matsumoto, o criador do Ruby, está trabalhando no Spinel — um compilador ahead-of-time (AOT) que transforma código-fonte Ruby em executáveis nativos independentes. Ele o apresentou na RubyKaigi 2026 com uma demonstração ao vivo, e os resultados são impressionantes: 11,6x mais rápido que o miniruby nos benchmarks, com cargas de trabalho intensivas em computação alcançando ganhos de 24–87x.

Como funciona

O pipeline de compilação do Spinel tem três estágios:

Depurando o TurboTax com o Claude Code

Sun, 05 Apr 2026 00:00:00 +0000

TL;DR

O Claude Code consegue analisar arquivos HAR — exportações de tráfego de rede do navegador — para depurar problemas do mundo real rapidamente.
O TurboTax estava detectando o fuso horário do meu navegador e inferindo que eu estava no Canadá, redirecionando-me para a página de login canadense.
Um único prompt foi suficiente para identificar a causa raiz e obter passos acionáveis para corrigi-la.

O Claude Code como ferramenta diária

O Claude Code pode ser um companheiro poderoso para tarefas do dia a dia, especialmente as que envolvem grandes quantidades de dados para analisar. Eu o uso todos os dias como parte do meu trabalho, e venho encontrando mais formas de trazê-lo para minha vida diária além do trabalho.

Notas sobre: Ruby é a melhor linguagem para construir apps de IA

Fri, 27 Mar 2026 00:00:00 +0000

Carmine Paolino defende de forma convincente que o Ruby é a melhor linguagem para construir aplicações de IA em 2026 — não por causa do treinamento de ML (esse é o território do Python), mas porque o desenvolvimento moderno de IA é apenas chamadas HTTP, e tudo ao redor disso é engenharia web.

O argumento central: a integração com um LLM é uma chamada HTTP. O que importa é tudo ao redor dela — streaming de respostas, persistência de conversas, rastreamento de custos, troca de providers. É aí que o Rails brilha.

I/O com e sem buffer no Unix

Thu, 30 Oct 2025 00:00:00 +0000

TL;DR

I/O com buffer agrupa dados em buffers no espaço do usuário (ou da biblioteca) e realiza menos chamadas de sistema, porém maiores. Ótimo para throughput.
I/O sem buffer envia dados diretamente (ou de forma mais direta) ao kernel/dispositivo, oferecendo menor latência e timing mais previsível — a um custo de throughput para muitas operações pequenas.
Use I/O com buffer para processamento normal de arquivos e tarefas de alto throughput. Use I/O sem buffer ou síncrono quando precisar de visibilidade imediata, determinismo ou durabilidade estrita.

O que ‘com buffer’ e ‘sem buffer’ significam

I/O com buffer: o runtime (por exemplo, o FILE* da biblioteca padrão do C) mantém um buffer intermediário e só chama read()/write() quando o buffer está cheio, vazio ou é esvaziado. Isso reduz o número de chamadas de sistema e geralmente melhora o throughput.
I/O sem buffer: suas operações são passadas ao kernel (ou dispositivo) com o mínimo de agregação no espaço do usuário. Exemplos: chamar read()/write() do POSIX repetidamente com tamanhos pequenos.

Duas camadas de buffer no Unix

Buffer no espaço do usuário (stdio, runtime da linguagem) — o que a maioria das pessoas quer dizer com “I/O com buffer” no nível da aplicação.
Page cache do kernel — mesmo depois que write() retorna, o kernel frequentemente mantém o conteúdo na RAM (o page cache) até gravá-lo no disco. Para tornar os dados duráveis em armazenamento estável, você precisa de fsync()/fdatasync() ou das semânticas O_SYNC/O_DSYNC.

Entender as duas camadas importa: você pode fazer fflush() (espaço do usuário) e ainda precisar de fsync() (kernel/disco) se exigir persistência.

Valores de tempo Unix (o epoch)

Thu, 16 Oct 2025 00:00:00 +0000

O tempo Unix (muitas vezes chamado de “o epoch”) é uma forma simples de representar um ponto no tempo: o número de segundos decorridos desde 1970-01-01 00:00:00 UTC, sem contar os segundos bissextos. É compacto, independente de linguagem e fácil de comparar e ordenar.

Quadrinho: xkcd #376 — usado sob a Licença Creative Commons Atribuição-NãoComercial 2.5. Crédito: Randall Munroe / xkcd.

Guia rápido do tmux

Wed, 05 Jun 2024 00:00:00 +0000

Este é um documento vivo que pretendo manter conforme me familiarizo mais com o tmux.

Atalhos de teclado

Todos os atalhos devem ser prefixados com uma tecla de prefixo, C-b (CTRL+b) por padrão, seguida de uma tecla de comando.

Categoria	Atalho	Descrição
Window	`c`	Criar uma nova janela
Window	`,`	Renomear a janela
Window	`w`	Escolher a janela em uma lista
Window	`0` a `9`	Ir da janela 0 à 9
Window	`n`	Ir para a próxima janela
Pane	`%`	Dividir em dois painéis, à esquerda e à direita
Pane	`"`	Dividir em dois painéis, em cima e embaixo
Pane	`Left`	Ir para o painel à esquerda
Pane	`Right`	Ir para o painel à direita
Pane	`Down`	Ir para o painel de baixo
Pane	`Up`	Ir para o painel de cima
Pane	`o`	Ir para o próximo painel
Pane	`x`	Fechar/matar o painel atual
Pane	`q`	Exibir brevemente os índices dos painéis.
System	`?`	Listar todos os atalhos
System	`d`	Desanexar (detach)
System	`:`	Entrar no prompt de comando do tmux

Recursos

man 1 tmux (versão web)
GitHub.com/tmux/tmux
[vídeo] Tmux will SKYROCKET your productivity - here’s how
[vídeo] Tmux has forever changed the way I write code.

Instalando o Ruby com chruby e ruby-install

Thu, 18 Apr 2024 00:00:00 +0000

Todo desenvolvedor Ruby provavelmente usará um gerenciador de versões do Ruby. Os mais populares são: RVM, rbenv e chruby. Use o que te deixar feliz. Eu fui de chruby e estou feliz com ele.

O que é o chruby

O chruby é uma ferramenta de linha de comando que permite alternar entre diferentes versões do Ruby. Ela permite que você mude entre elas manualmente, ou pode mudar a versão para você automaticamente conforme você navega entre as pastas de projeto.

Configurando o Rails com chruby e ruby-install

Wed, 15 Dec 2021 00:00:00 +0000

Nota: Veja a versão atualizada deste post: Instalando o Ruby com chruby e ruby-install.

Aqui estão os passos para instalar e configurar o Ruby e o Ruby on Rails no macOS usando chruby e ruby-install. Ambas são ferramentas muito leves, escritas por Hal Brodigan. Uma abordagem semelhante também pode ser usada no Linux ou no Windows/WSL.

Configuração

Vamos começar instalando o Homebrew. Siga as instruções oficiais de instalação no site deles.

O Z shell

Tue, 03 Aug 2021 00:00:00 +0000

O que é

O shell é o que fica entre o usuário e o núcleo do sistema operacional, geralmente na forma de uma interface de linha de comando (CLI). O shell mais popular nas distribuições Linux é o bash. Em 2019, a Apple começou a lançar o MacOS com o Zsh (Z shell) por padrão. Acredito que essa seja uma das razões que tornaram o zsh tão popular.

Adicionando um arquivo de configuração JSON a uma aplicação de console .NET Core

Tue, 02 Mar 2021 00:00:00 +0000

Uma aplicação .NET Core pode lidar com configuração usando diferentes formatos (providers) como memória, linha de comando e variáveis de ambiente. Aqui, usaremos um provider de arquivo, mais especificamente um JsonConfigurationProvider. Clique neste link para saber mais sobre os diferentes tipos de providers de configuração.

Configuração do projeto

Vamos começar criando uma aplicação de console e adicionando o pacote NuGet do provider. No nosso caso, será um provider JSON.

Tratando eventos de diálogo de janelas WPF da forma elegante

Fri, 26 Jul 2019 00:00:00 +0000

Aqui estão duas formas elegantes que você pode usar para tratar diálogos WPF a partir do ViewModel. Vou demonstrar os dois exemplos fechando um diálogo de janela WPF a partir do ViewModel, dependendo de alguma lógica.

Usando eventos

A primeira solução é usar um evento que notifica o diálogo da janela para fechar. Considere o seguinte exemplo:

public class DialogViewModel
{
    public event EventHandler Saved;

    public DialogViewModel()
    {
        SaveCommand = new DelegateCommand(OnSave);
    }

    public ICommand SaveCommand { get; }

    public void Save()
    {
        //
        // SOME LOGIC TO SAVE GOES HERE
        //
        Saved?.Invoke(this, EventArgs.Empty);
    }
}

A janela de diálogo pode escutar esse evento e se fechar de acordo.

Validação condicional no ASP.NET

Wed, 20 Sep 2017 00:00:00 +0000

A validação condicional pode ser muito útil, e fico feliz por ter encontrado uma forma elegante de fazê-la. Você pode usar o mesmo View-Model em duas actions diferentes do seu controller e ter validações distintas para cada uma delas.

Cenário de exemplo

Para ajudar a ilustrar o problema e a solução, vamos descrever um cenário simples de gerenciamento de usuários. Teremos um controller que adiciona e edita usuários. Vou abstrair a camada de negócio para que possamos focar apenas na validação de usuário.

Testes de unidade para mapeamentos do NHibernate

Wed, 21 Jun 2017 00:00:00 +0000

Qual é a melhor abordagem para mapear suas classes de domínio para o banco de dados usando NHibernate? Depois de fazer alguns testes, acredito que a melhor resposta é: não importa. Desde que você tenha testes de unidade para isso, você está coberto.

O mesmo problema de mapeamento que você enfrentará usando arquivos HBM, você encontrará usando FHN ou Mapping By Code. Por causa disso, fiz alguns experimentos sobre qual seria uma boa abordagem para testar mapeamentos do NHibernate com testes de unidade.

Arquivos

Mon, 01 Jan 0001 00:00:00 +0000

Citações

Mon, 01 Jan 0001 00:00:00 +0000

“Simplicity is prerequisite for reliability.”

— Edsger W. Dijkstra

“Make it work, make it right, make it fast.”

— Kent Beck

“Talk is cheap. Show me the code.”

— Linus Torvalds

“Premature optimization is the root of all evil.”

— Donald Knuth

“The best way to predict the future is to invent it.”

— Alan Kay

“Good code is its own best documentation.”

Sobre

Mon, 01 Jan 0001 00:00:00 +0000

Olá, eu sou Vinicius Rocha, desenvolvedor de software.

Escrevo código há mais de 20 anos. Comecei nos primeiros tempos do .NET, passei muito tempo em sistemas backend e ainda gosto das partes da programação que deixam o trabalho do dia a dia mais suave: ferramentas de shell, editores, infraestrutura, depuração e pequenas melhorias de fluxo de trabalho.

Este blog são minhas anotações tornadas públicas. A maioria dos posts começa como algo que precisei descobrir por conta própria: um comando que vivo esquecendo, uma ferramenta que testei, um bug que persegui ou uma ideia que queria explicar com clareza suficiente para que o meu eu do futuro pudesse encontrá-la novamente.