Developing taste ๐จ, Android apps on your Mac ๐ป, when retries backfire ๐
TLDR
TLDR Dev 2026-10-20
2 out of 3 documentation visitors are AI agents. But that's not all they're reading... (Sponsor)
Agents are now the default docs reader. But what happens when they don't find answers in the docs? They look at:
Agents are now the default docs reader. But what happens when they don't find answers in the docs? They look at:
- help centers,
- changelogs,
- community forums,
- support ticket archives
Is all of that information AI-ready?
In Mintlify's survey, only 7% of professionals said their company has made all its knowledge readable by agents.
The 2026 State of Knowledge Report explores Mintlify's 2,400-test navigation benchmark, how Anthropic maintains Claude Code's docs, and what teams need to rethink about managing knowledge.
๐งโ๐ป
Articles & Tutorials
When Retries Make Things Worse: Protecting Your System From Overload (16 minute read)
Retries can turn a slow dependency into a wider outage by multiplying attempts and exhausting connections or workers. A PHP example combines one retry owner, an operation deadline, admission limits, shared retry budgets, and jitter, then outlines a load test that measures both overload and recovery.
Retries can turn a slow dependency into a wider outage by multiplying attempts and exhausting connections or workers. A PHP example combines one retry owner, an operation deadline, admission limits, shared retry budgets, and jitter, then outlines a load test that measures both overload and recovery.
Making a website AI friendly: what the bots actually fetched from mine (17 minute read)
An analysis of 18 days of traffic to one personal site found that verified crawlers mostly fetched ordinary pages, robots.txt, and the sitemap. Markdown copies attracted verified crawlers within a day, while llms.txt saw no verified training or search crawler requests, suggesting that basic HTML and measured traffic matter more than adding every proposed discovery file.
An analysis of 18 days of traffic to one personal site found that verified crawlers mostly fetched ordinary pages, robots.txt, and the sitemap. Markdown copies attracted verified crawlers within a day, while llms.txt saw no verified training or search crawler requests, suggesting that basic HTML and measured traffic matter more than adding every proposed discovery file.
The generic circular dependency problem (15 minute read)
Generic services become coupled to their consumers when shared types or domain logic pull application knowledge back into analytics, email, or authorization modules. Domain wrappers, locally owned handlers, smaller contracts, and plugin registration can break those cycles, while extracting a shared type package may only hide the conceptual coupling.
Generic services become coupled to their consumers when shared types or domain logic pull application knowledge back into analytics, email, or authorization modules. Domain wrappers, locally owned handlers, smaller contracts, and plugin registration can break those cycles, while extracting a shared type package may only hide the conceptual coupling.
๐ง
Opinions & Advice
Developing Taste (3 minute read)
As working software becomes easier to produce, design, usability, and attention to detail become stronger differentiators. Taste develops through studying excellent work, explaining why specific choices succeed, and practicing with useful critique.
As working software becomes easier to produce, design, usability, and attention to detail become stronger differentiators. Taste develops through studying excellent work, explaining why specific choices succeed, and practicing with useful critique.
No more tech debt (4 minute read)
A completed design system migration shows how coding agents can make broad cleanup practical once reusable components, written guidance, and linters are in place. The team migrated through 45 pull requests across eight stacks, using vertical slices and before-and-after screenshots, then removed the old patterns so agents would stop copying them.
A completed design system migration shows how coding agents can make broad cleanup practical once reusable components, written guidance, and linters are in place. The team migrated through 45 pull requests across eight stacks, using vertical slices and before-and-after screenshots, then removed the old patterns so agents would stop copying them.
Writing is no longer proof of work (6 minute read)
Organizations often use reports and templates as evidence that someone put in effort, followed a process, or understood a topic. LLMs weaken that signal by producing plausible documents without the underlying work, leaving companies to find better evidence and reserve careful writing for actual communication.
Organizations often use reports and templates as evidence that someone put in effort, followed a process, or understood a topic. LLMs weaken that signal by producing plausible documents without the underlying work, leaving companies to find better evidence and reserve careful writing for actual communication.
๐
Launches & Tools
Survey: Developers are concerned about giving AI access to the cloud. They do it anyway. (Sponsor)
In a new survey, nearly 80% of developers said they give AI agents access to cloud environments, while 97% cited concerns about the security, cost, and quality implications of doing so. Read the report
In a new survey, nearly 80% of developers said they give AI agents access to cloud environments, while 97% cited concerns about the security, cost, and quality implications of doing so. Read the report
Mac.apk (GitHub Repo)
Mac.apk implements the Android application environment directly on Apple Silicon Macs so apps run as native macOS processes with their own windows and GPU rendering. It is alpha software, with compatibility ranging from fully working apps to partial support or apps that do not launch.
Mac.apk implements the Android application environment directly on Apple Silicon Macs so apps run as native macOS processes with their own windows and GPU rendering. It is alpha software, with compatibility ranging from fully working apps to partial support or apps that do not launch.
Pele (Website)
Pele renders Mermaid diagrams as SVG with zero dependencies and CSS variable theming that can change colors without rendering again. The site reports a 230 kB gzipped bundle and support for every diagram type built into Mermaid 12.1.0, with layouts that adapt to small screens.
Pele renders Mermaid diagrams as SVG with zero dependencies and CSS variable theming that can change colors without rendering again. The site reports a 230 kB gzipped bundle and support for every diagram type built into Mermaid 12.1.0, with layouts that adapt to small screens.
MiniMax M3.1 Flash: Redefining Agent Performance and Cost (3 minute read)
MiniMax M3.1 Flash targets coding, computer use, and other agent workflows, with published pricing of $0.15 per million input tokens and $0.60 per million output tokens. MiniMax reports 73.7% on DeepSWE v1.1 and 70% lower overall agent task costs than its predecessor, with API access available now and model weights planned for later.
MiniMax M3.1 Flash targets coding, computer use, and other agent workflows, with published pricing of $0.15 per million input tokens and $0.60 per million output tokens. MiniMax reports 73.7% on DeepSWE v1.1 and 70% lower overall agent task costs than its predecessor, with API access available now and model weights planned for later.
๐
Miscellaneous
My experience running local LLMs (22 minute read)
Tests on an AMD Ryzen AI Max+ 395 system show why model size, memory bandwidth, context length, and serving engine all affect local agent performance. A quantized MoE model generated about 42 tokens per second for one request versus about 11 for a dense model, but the experiments measured generation speed rather than completed coding tasks.
Tests on an AMD Ryzen AI Max+ 395 system show why model size, memory bandwidth, context length, and serving engine all affect local agent performance. A quantized MoE model generated about 42 tokens per second for one request versus about 11 for a dense model, but the experiments measured generation speed rather than completed coding tasks.
Your coding agent loses its cache while it waits for you (19 minute read)
A survey of agent inference research distinguishes cache misses caused by memory pressure from those caused by human pauses. One public trace reported about 97% cache reuse after tool calls but 18% after gaps longer than an hour, highlighting a retention problem that autonomous benchmark loops often miss.
A survey of agent inference research distinguishes cache misses caused by memory pressure from those caused by human pauses. One public trace reported about 97% cache reuse after tool calls but 18% after gaps longer than an hour, highlighting a retention problem that autonomous benchmark loops often miss.
Agentic Monitoring (10 minute read)
Agents with access to code and telemetry can create targeted monitoring plans and investigate unusual signals around releases or configuration changes. An early prototype produced cleaner signals and used fewer tokens when an agent wrote monitoring specifications for a deterministic runner, with another agent investigating triggers and escalating to humans.
Agents with access to code and telemetry can create targeted monitoring plans and investigate unusual signals around releases or configuration changes. An early prototype produced cleaner signals and used fewer tokens when an agent wrote monitoring specifications for a deterministic runner, with another agent investigating triggers and escalating to humans.
โก
Quick Links
Is Meta's Muse agent browsing your site right now? (Sponsor)
Muse alters its fingerprint and suppresses automation flags and most bot detection never sees it. Fingerprint identifies it by name:
Muse alters its fingerprint and suppresses automation flags and most bot detection never sees it. Fingerprint identifies it by name:
meta_muse, one API response. Here's how it works. Ask HN: How to deal with shipping AI-written code you don't understand? (Website)
This discussion explores how much generated code engineers need to understand before shipping.
This discussion explores how much generated code engineers need to understand before shipping.
Adding an MCP server to a personal website (7 minute read)
A Go backend gains authenticated MCP tools for logging books, films, and performances from chat.
A Go backend gains authenticated MCP tools for logging books, films, and performances from chat.
useOverflow (3 minute read)
A React hook that compares scroll and client dimensions and rechecks on resize to show expansion controls only when text is clipped.
A React hook that compares scroll and client dimensions and rechecks on resize to show expansion controls only when text is clipped.
Code is clay now (5 minute read)
Cheaper code changes enable rapid exploratory iteration and automated production pipelines.
Cheaper code changes enable rapid exploratory iteration and automated production pipelines.
Love TLDR? Tell your friends and get rewards!
Share your referral link below with friends to get free TLDR swag!
Want to advertise in TLDR? ๐ฐ
If your company is interested in reaching an audience of web developers and engineering decision makers, you may want to advertise with us.
Want to work at TLDR? ๐ผ
Apply here, create your own role or send a friend's resume to [email protected] and get $1k if we hire them! TLDR is one of Inc.'s Best Bootstrapped businesses of 2025.
If you have any comments or feedback, just respond to this email!
Thanks for reading,
Priyam Mohanty, Jenny Xu
Thanks for reading,
Priyam Mohanty, Jenny Xu