repodocs
Gera uma wiki do repositório com cada afirmação apontando para o código de onde ela saiu. Roda com OMP, Claude Code ou Codex CLI.
uv tool install repodocsCódigo aberto e IA · Ary Rabelo
IA dá velocidade. Direção ainda é trabalho de engenheiro.
Agente de código escreve rápido. Entender o sistema, revisar a mudança e provar que funciona continua sendo o trabalho. Aqui está o que eu publico para isso: o itaruby, um verificador de tipos para Ruby, PRs aceitos no Rails, no Discourse e no fastlane, e ferramentas para trabalhar com agentes de código.
Código aberto
itaruby: um verificador de tipos para Ruby que acha bug sem anotação
Escrito em Rust, aberto (MIT) e ainda em alpha. Eu rodo o itaruby no código de projetos grandes e só mando correção do que consigo provar:
- O itaruby lê o projeto sem nenhuma anotação de tipo e aponta onde o código vai quebrar.
- Um aviso só vale se eu reproduzir o erro de verdade, um NameError, NoMethodError ou ArgumentError, rodando o código do próprio projeto.
- A correção só sai quando a mesma execução passa. Os falsos positivos ficam anotados, sem esconder.
Aceito em projetos dos outros
30 pull requests aceitos e 11 abertos, em 12 projetos, desde maio de 2026.
- rails/rails itaruby 3 aceitos
- discourse/discourse itaruby 6 aceitos
- fastlane/fastlane itaruby 1 aceito
- gastownhall/beads 1 aceito
- coleam00/Archon 1 aceito
- Chachamaru127/claude-code-harness 1 aceito
- serpapi/serpapi-mcp 1 aceito
- getpaseo/hub 1 aceito
- nicolasmelo1/software-factory 15 aceitos
Marcados com itaruby: correções que saíram de uma caça a bugs com ele.
Ver todas as contribuições →Ferramentas de IA que eu publico
O que eu fiz para trabalhar melhor com agentes de código, aberto e com o código no GitHub. Onde o README tem um comando de instalação, ele está no card.
Para agentes de código
Ver tudo em Projetos →next-action-protocol
Toda resposta do agente termina com uma única próxima ação clara: [DONE], [DECIDE], [HUMAN] ou [WAIT].
npx skills add aryrabelo/next-action-protocol --agent claude-code -gserpapi-agent-toolkit
Busca SerpApi para agentes, em CLI e skill do Claude Code, gastando bem menos contexto que um servidor MCP. Eu medi a diferença.
searchapi-agent-toolkit
A mesma ideia para a SearchApi: CLI sem dependências e skill do Claude Code que devolve só os campos que você pediu.
jev-accept
Lê a issue e o épico por trás de um pull request e julga se ele entrega o que foi pedido. CLI local e GitHub Action com o mesmo contrato.
Plugins do OMP
Ver tudo em Projetos →omp-burnrate
Burn rate por conta de assinatura ao abrir o OMP: qual conta vai bater no teto antes do reset.
omp plugin install github:aryrabelo/omp-burnrateomp-green-gh
Os pull requests do repositório na statusline do OMP: a branch atual está verde, o que está travando ela, e o que mais está aberto.
PlanQueue
Fila de tarefas por sessão: você escreve o plano uma vez e despacha linha por linha para o agente.
omp plugin install github:aryrabelo/planqueueCompartilhar o que aprendo
O que eu aprendo, eu deixo aberto.
“Eu entendi IA tudo errado! Fiz mais, criei mais e me importei de menos até que comecei a deixar de lado o que importava! Foquem em entender, em ser o humano que falta na IA.”
-
Notas
Cada nota parte de um problema real, com o número que eu medi e o que mudei por causa dele.
Ler o blog → -
O método gauntlet
Um agente constrói. Outro agente, que não sabe qual dos dois lados é o meu, compara o resultado com uma referência de fora e aponta a maior falha. A rodada se repete até o meu lado ganhar. É assim que eu deixo o agente trabalhar sem acreditar no que ele diz de si mesmo.
-
Seu primeiro dia com o Claude, sem pular etapa
claude-101: do primeiro prompt até automatizar uma tarefa sua. 5 módulos curtos, em português e inglês, no seu ritmo.
Começar o curso grátis →
Notas do que eu medi
Cada nota sai de um problema real, com o número que eu medi e o que mudei por causa dele.
- Artigo Por que construí o aryrabelo.com do zero Hub pessoal que é motor de leads, link-in-bio próprio, portfólio bilíngue e blog. Tudo self-hosted na Cloudflare, sem terceirizar dados.
- Artigo Medi MCP versus um CLI para busca de agentes. O MCP usou 17x mais tokens por chamada. A mesma busca no Google pelo serpapi-mcp da SerpApi e pelo serp, um pequeno CLI MIT. O MCP colocou 771 tokens no contexto antes de buscar e 6.047 por chamada; o CLI, 0 e 351. A medição, e por que isso importa para agentes.
Peça um curso
Quero aprender ___
Em Paralelo · uma edição por semana
O que quebrou esta semana, e o que eu mudei
Medições, erros e decisões da minha rotina com agentes. Sem hype, sem resumo de notícia.
Oi, eu sou o Ary
Engenheiro de software há vinte anos, Rails desde 2012, e uma plataforma com 1,8 milhão de visitas por mês em produção. Hoje escrevo código aberto em Ruby e ferramentas para agentes de código, e uso esses agentes todo dia.
Tudo o que publico aqui é aberto, ou é um curso que você faz sozinho.
Ler a história completa →