šŸ” Search

Open
Writing good docs for agents šŸ¤–, Siri SVP retires ✖️, why use React šŸ¤”

Writing good docs for agents šŸ¤–, Siri SVP retires ✖️, why use React šŸ¤”

GitHub analyzed 2,500+ `agents.md` files and found the successful ones were specialists with clear jobs, not vague helpers ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌  ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ ‌ 

TLDR

Together With Clerk

 TLDR Dev 2025-12-02

Secure your backend services without the auth headaches (Sponsor)

Your microservices, background workers, and distributed systems need authentication too, but rolling your own M2M auth is a nightmare. Clerk's M2M tokens are now production-ready: stable APIs, usage tracking in the dashboard, and straightforward token-based auth between any backend service. No more managing service credentials, rotating secrets, or debugging custom auth flows. Ship secure service-to-service auth in minutes, not weeks.
šŸ§‘‍šŸ’»

Articles & Tutorials

How to write a great agents.md: Lessons from over 2,500 repositories (6 minute read)

GitHub analyzed 2,500+ `agents.md` files and found the successful ones were specialists with clear jobs, not vague helpers. Good agents.md files give your agent specific commands to run, concrete code examples to follow, and explicit boundaries (like "never touch these files"). Start simple with one focused task like writing tests or docs, then iterate based on what breaks.
On Inheriting and Sharing Property Values (11 minute read)

CSS doesn't let you set one property based on another's value (like `border-radius: height`), and there's no magic `compute()` function coming. Your best bets right now are to use CSS custom properties if you know the values, `aspect-ratio` to link width/height, `currentColor` to reuse colors, or container query units like `100cqh` to steal parent dimensions.
Introducing AWS Lambda Managed Instances: Serverless simplicity with EC2 flexibility (5 minute read)

AWS Lambda Managed Instances is a new capability that can run AWS Lambda functions on Amazon Elastic Compute Cloud compute while maintaining serverless operational simplicity. It allows developers to access specialized compute options and optimize costs for steady-state workloads using a familiar serverless development experience. Lambda Managed Instances can be used to define how Lambda functions run on EC2 instances. Developers can just select compute profiles optimized for specific workload requirements without taking on the operational burden of managing Amazon EC2 infrastructure.
🧠

Opinions & Advice

Why use React? (14 minute read)

While React makes sense as a server-side authoring tool (developers love JSX and component architecture), shipping it to the browser hurts users with unnecessary JavaScript. Frameworks like Astro let you write in React but render plain HTML to users, while Next.js defaults to the "hydration" pattern that sends all that server-side JavaScript to the client anyway.
My weekly tech industry intake routine as a Staff Engineer (10 minute read)

A Staff Engineer shares his Saturday morning ritual for staying current: he batches all newsletters into a 2-3 hour block using Superhuman's split inbox (to separate articles from urgent emails) and Mailbrew (to group 60+ weekly emails into just 2 digests). His process is simple: queue interesting articles by title only, read them one by one, then immediately take action by either saving to Notion for reference or adding to Todoist as a work idea.
šŸš€

Launches & Tools

Track B2B growth like you track users (Sponsor)

Your organizations are just as important as your users. Now track them the same way. Clerk's new Organization Growth Analytics gives you retention, churn, and cohort analysis for every organization in your app. Daily, weekly, or monthly active orgs. Flexible filtering. Click any chart segment to drill into specific cohorts. Stop flying blind on B2B metrics.
AWS announces preview of AWS Interconnect - multicloud (1 minute read)

AWS Interconnect - multicloud makes it easy to connect AWS networking services to other cloud service providers. It will start in preview with Google Cloud and then open up to Microsoft Azure later in 2026. The service is now available in preview in five AWS regions. Cloud service providers can easily adopt the service via a published open API package on GitHub.
Rad (GitHub Repo)

Rad gives users Python-like scripting with CLI superpowers built in. It allows users to write maintainable scripts with declarative argument parsing, built-in JSON processing, and more. The project is still in early development, but it is already useful for real scripts. Rad is optimized for CLI scripting - a general-purpose language may be more appropriate for enterprise applications, high-performance computations, and projects that require specialized libraries.
šŸŽ

Miscellaneous

AI agents find $4.6M in blockchain smart contract exploits (22 minute read)

Anthropic researchers evaluated AI agents' ability to exploit smart contracts on a newly created benchmark, SCONE-bench. The agents, including Claude Opus 4.5 and GPT-5, successfully exploited vulnerabilities in smart contracts, collectively amassing $4.6 million in simulated stolen funds from contracts exploited after March. In a separate simulation, the AI agents uncovered two novel zero-day vulnerabilities in recently deployed contracts, showing the technical feasibility of profitable, real-world autonomous exploitation.
The Performance Inequality Gap, 2026 (42 minute read)

Despite devices and networks improving, the performance gap between rich and poor users is still growing. For 2026, the budget is ~150KiB of HTML/CSS/fonts and ~300-350KiB of JavaScript (gzipped) to serve the global 75th percentile, but less than half of mobile sites pass Core Web Vitals because developers keep shipping way more JavaScript than reasonable.

Quick Links

John Giannandrea to retire from Apple (7 minute read)

Apple announced that John Giannandrea will retire as senior vice president for Machine Learning and AI Strategy, and Amar Subramanya (previously part of Microsoft and ex-VP of the Gemini App at Google) will join as the new vice president of AI.
Google unkills JPEG XL? (6 minute read)

After initially rejecting JPEG XL despite community support, Chromium has reversed its decision and will now support the format.
Google, Nvidia, and OpenAI (20 minute read)

Google's advancements in AI with Gemini 3 and its TPU offerings are challenging the dominance of OpenAI and Nvidia, forcing them to re-evaluate their moats and strategies.
Last Week on My Mac: Losing confidence (30 minute read)

This dev has lost confidence in macOS due to silent failures, uninformative error messages, and the resulting reliance on workarounds.

Love TLDR? Tell your friends and get rewards!

Share your referral link below with friends to get free TLDR swag!
Track your referrals here.

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 or send a friend's resume to jobs@tldr.tech and get $1k if we hire them!

If you have any comments or feedback, just respond to this email!

Thanks for reading,
Priyam Mohanty, Jenny Xu & Ceora Ford


Manage your subscriptions to our other newsletters on tech, startups, and programming. Or if TLDR Dev isn't for you, please unsubscribe.

Post a Comment

0 Comments

Users_Online! 🟢

FOUNDER/AUTHOR

FOUNDER/AUTHOR VHAVENDA I.T SOLUTIONS