A jornada de aprendizado de Samuel Medeiros
Dev · Projetos · Estudos · Descobertas
O Arachne rodava 10 serviços em Docker Compose. Kubernetes aparecia no meu CV como keyword desejada — mas eu não usava. Em vez de mentir, decidi adotar k3s de verdade: single-node, com plano em fases, rollback garantido e métricas de RAM como critério de parada.
O pnpm audit do Portfólio gritava 61 vulnerabilidades. Em vez de sair atualizando dependência por dependência ou confiar no audit fix, resolvi com 5 linhas de pnpm.overrides no package.json. Resultado: 61 → 2, com as 2 restantes sem correção publicada nem pra dependência direta.
Depois de achar 28 textos PT hardcoded espalhados pelo Portfólio (botões, aria-labels, modais, tracking), criei um teste de auditoria que varre os componentes e falha o CI se qualquer texto português aparecer fora do t(). A lição: os testes antigos estavam ancorados no bug — buscavam o texto PT literal em vez do contrato i18n.
Os cards da home mostravam a data histórica do evento — e a ordem parecia bagunçada (07, 09, 09, 06). A mudança: exibir a data de publicação (pubDate). A história de um detalhe que muda como o blog é percebido.
Stripe com 500 DNS morto, Staging do Portifólio que não existia mais, rate limit que bloqueava o IP errado. A limpeza cirúrgica que fez o dashboard do Capivara voltar a dizer a verdade — e o CF-Connecting-IP que consertou o rate limit de verdade.
De madrugada, o Arachne acordava intermitente: o workflow de scraping falhava com 'browser agent não disponível neste worker'. O journal mostrava um RuntimeError enigmático: o lock do browser pool estava preso a um event loop que não era o do worker. A causa: asyncio.Lock() criado no import. O fix: lazy init — nascer dentro do loop certo.
O TatuEngine ganhou uma camada de punição v3: multa progressiva por reincidência, cold restart parcial, tool deny automático e reprimenda no output. A ideia: em vez de só recompensar o bom comportamento, punir o mau com intensidade crescente — como um sistema imunológico que aprende a cada erro.
O Dashboard do Capivara tinha 994 linhas e era impossível de manter. Refatorado pra 262 (-74%), o bundle inicial caiu de 668 kB pra 238 kB (-64%) com React Router + lazy loading. A lição: componente gigante não é feature — é dívida técnica disfarçada.
O Arachne respondia 200, mas as rotas autenticadas renderizavam vazio. Um Bug Hunter encontrou 1.239 erros de QueuePool no journal desde as 02:57. A causa: um generator de sessão que nunca era fechado — cada request vazava uma transação idle in transaction até o pool de 30 conexões estourar.
Todos os WebSockets do Dogwalk retornavam HTTP 500 no handshake. O app rodava, o banco respondia, mas o login em tempo real, o chat e o rastreamento de passeios simplesmente não conectavam. A causa: um receive_text() chamado sem o accept() que o Starlette exige.
Cinco dias tentando fazer um círculo de luz nascer exatamente de onde o dedo toca. O CSS parecia certo, o CI passava, mas o usuário via stutter, origem errada e conteúdo apagando. A causa raiz não era o código — era a interação entre View Transitions API, blend modes do Chromium e um node_modules fantasma.
O Portfólio estava 100% funcional, 218 testes passando, zero erros no CI. Mas usuários de mobile Chrome viam versões antigas ao restaurar abas. A causa: o bfcache do Chrome ignora headers HTTP — e a solução veio cruzada de outro projeto.
Automatizar posts narrativos parecia simples: um cron, um script, um preview. No mesmo dia, o pipeline esbarrou em 4 paredes — pnpm bloqueado pelo guard do gateway, MDX quebrando build com '<', capa de 0 bytes e sessão interrompida. Cada parede virou uma regra.
Depois de aprender a inferir (GPU 252×), o TatuEngine partiu pro ciclo Mestre-Aprendiz: um teacher Qwen2.5-3B com LoRA destilando raciocínio estruturado ([THOUGHT]/[ANSWER]) pro student BitMamba-2 1B. Seis versões num dia (v0.17→v0.22.2), 381 exemplos e a convergência que não vinha até o fix do system message.
Ninguém tocava no código, mas a Vercel recusava o build: ERR_PNPM_EEXIST. A causa: um cron de segurança rodava pnpm audit fix com o pnpm do Windows, regenerava o lockfile v10 e o packageManager declarava 9.12.3 — a saga de alinhar pnpm local, packageManager e CI.
O hub pessoal devolvia 502 intermitente no tunnel. A solução: espelhar o Capivara no Douglas (fallback) com sync one-way e healthcheck — e provar com um teste de failover real: cloudflared do Samuel parado 40s, site 5/5 = 200, Douglas assumiu sozinho.
MCP virou o conector universal (publicado no registry oficial), FTS5+vetorial virou busca híbrida com RRF, ai-jail isolou o agente e Ollama trouxe a IA pra casa — e as lições viraram regras: docs first, plan first, parar e perguntar.
Nasceu da pergunta absurda 'e se usássemos RT Cores pra processar redes neurais?', matou o sonho no WSL2, e virou um motor híbrido CPU/GPU com BitMamba-2 1B, 114× de compressão, agente com 8 subsistemas e sandbox de segurança — 302 commits depois.
529 commits, 218 testes, 5 mini-games, parallax scene multicamada, terminal interativo com 15+ comandos, i18n PT/EN — a jornada de um portfólio que virou vitrine interativa.
107 commits, 131 testes backend + 248 frontend, 2FA TOTP, RAG local com ChromaDB, backup R2 e D1 disaster recovery — a saga de transformar um painel pessoal em infraestrutura confiável.
777 commits, 2818 testes, RAG híbrido, ReAct Agent com 42 tools, MCP server, e a evolução de um scraper simples pra uma plataforma de conhecimento.
970 commits, 1456 testes, Stripe Connect, Open Design, e a saga de transformar um marketplace de pets em uma plataforma que não quebra no deploy.
158 commits, 49 posts bilíngues, 4 engines de tema, 59 capas AI, e uma decisão que mudou tudo: matar o robô que escrevia posts sozinho.
Em julho, 8 commits melhoraram o computer use do Hermes: permission modes, desktop control, voice barge-in. O código existe — mas no WSL ainda falta um servidor X11 pra rodar de verdade.
298 commits, zero novas features em 30 dias, e um motor de inferência SSM que roda sem supervisão. O TatuEngine não precisa de mudanças — ele só funciona.
Quando sua engine executa código gerado por IA, você precisa de um sandbox que não atrapalhe o desenvolvimento mas também não deixe passar path traversal.
Pix BR Code quebrado, focus trap roubando o teclado, scroll que pulava seção — uma auditoria profunda resolveu tudo de uma vez.
Julho de 2026 foi o mês em que o portfólio parou de ganhar features novas e começou a corrigir as que já tinha. Uma auditoria profunda revelou 10 problemas — do Pix ao focus trap — e no fim o deploy ficou mais automático do que nunca.
O Hermes entrava em loop de continuation 4x seguidas antes de desistir. A causa: o Ollama, por padrão, só aloca 4096 tokens de contexto — independente do modelo suportar 262K. Aprendi na marra que num_ctx do modelo ≠ num_ctx do slot.
Meu assistente Hermes tem acesso a tudo: tokens de API, chaves Stripe, credenciais de banco. Um comando errado no terminal() e vazava tudo. A solução: um sandbox em Rust que isola cada execução com bubblewrap, Landlock e Seccomp.
Implementei Pix no portfólio com pagamento via BR Code. Só que o QR Code não funcionava em nenhum app de banco. O culpado: String.fromCharCode gerando caracteres de controle em vez de dígitos decimais nos campos de tamanho.
Em vez de substituir o circular reveal por crossfade básico, corrigi a causa raiz do stutter em GPU low-end. VT clip-path + fallback limpo.
O momento em que percebi que meu blog de devlogs estava produzindo relatórios, não histórias — e como resolvi isso matando o robô que escrevia posts sozinho.
Debaixo dos panos da refatoração de 83% do frontend: Ghost Components, schema drift silencioso, a guerra dos dois systemd, o proxy fantasma do Umami e outras dores que não cabem num changelog.
Explorando estado atual do Capivara — aprendizados, desafios e descobertas.
Explorando estado atual do TatuEngine — aprendizados, desafios e descobertas.
25 ferramentas MCP, visão multimodal com IA local, observabilidade, billing e o sandbox que tornou o Arachne uma plataforma — o estado atual do projeto em julho de 2026.
Por que criei um blog pessoal em 2026, a escolha do Astro, e o que esperar daqui pra frente.
De 3 projetos em junho pra 5 em julho, o ecossistema Samuel agora tem 2.396 commits, 3.647+ testes, e um agente orquestrando tudo.
Explorando jogos do portfolio — aprendizados, desafios e descobertas.
A saga de fazer o Student BitMamba-1B aprender sem explodir: Adafactor vs AdamW, a economia de 4 GB de VRAM, e os 4 bugs que produziam NaN no treinamento em bf16.
Explorando busca híbrida — aprendizados, desafios e descobertas.
Explorando ferramentas de julho — aprendizados, desafios e descobertas.
A jornada (e as crateras) de treinar um Mamba-2 de 1.4B parâmetros do zero numa RTX 3060 — warmup, SFT, eval catastrófico e a Fase 4 da ressurreição.
Explorando D1 sync — aprendizados, desafios e descobertas.
Como o Capivara resolveu a bagunça financeira de múltiplas contas, planilhas e categorias — unificando tudo em um dashboard.
De zero testes a 853: como os testes Playwright viraram o backbone de qualidade do Dogwalk/PataPass, os aprendizados e o que mudou no processo.
JWT, Supabase, OAuth, refresh token, rotas protegidas e layout condicional — a história da autenticação no Dogwalk.
Explorando começo da TatuEngine — aprendizados, desafios e descobertas.
A história real de como um scraper Python de 200 linhas virou uma plataforma com 740+ arquivos, RAG, pipelines visuais e 36 ferramentas ReAct.
Das planilhas bagunçadas a um dashboard completo com health checks em tempo real, integração Umami e analytics financeiros com categorias de gasto. A evolução do Capivara de hub pessoal simples para centro de controle do ecossistema.
Experimentando Crawl4AI no Arachne: sidecar Docker, SDK Python, comparação com Trafilatura e a decisão de usar fallback automático entre engines.
Explorando rebuild do portfolio — aprendizados, desafios e descobertas.
A arquitetura que realmente resolve extração de dados na web: Trafilatura, Crawl4AI SDK, Sidecar Docker e Camoufox — como cada camada funciona, os critérios de fallback, e o que aprendi no caminho.
Como os testes end-to-end transformaram a qualidade e confiança no desenvolvimento do Dogwalk — a história real de uma stack que aprendeu a se testar sozinha.
Cansado de scrapers que quebravam do nada e serviços caros de terceiros, resolvi construir minha própria plataforma de extração de dados.
O scraper simples virou uma plataforma. Crawl4AI Sidecar, fallback automático em 4 camadas, e cache em SQLite com FTS5.
Com 3 projetos rodando, a infraestrutura precisava ser robusta. Backups automáticos, security hardening, e o Hermes Agent como cérebro do ecossistema.
Depois de construir ferramentas para os outros, resolvi dedicar tempo ao meu próprio espaço. Um portfólio que fosse mais que um currículo.
Depois da ideia, veio a parte mais difícil: colocar a mão na massa. Como escolhi React, Vite e FastAPI para construir o Dogwalk.
Explorando escolha da stack — aprendizados, desafios e descobertas.
Depois de semanas codando, chegou a hora de colocar o Dogwalk no ar. O primeiro deploy foi uma mistura de euforia e frustration — Vite + Cloudflare Pages.
