In partnership with
AI Agents Are Reading Your Docs. Are You Ready?
Last month, 48% of visitors to documentation sites across Mintlify were AI agents, not humans.
Claude Code, Cursor, and other coding agents are becoming the actual customers reading your docs. And they read everything.
This changes what good documentation means. Humans skim and forgive gaps. Agents methodically check every endpoint, read every guide, and compare you against alternatives with zero fatigue.
Your docs aren't just helping users anymore. They're your product's first interview with the machines deciding whether to recommend you.
That means: clear schema markup so agents can parse your content, real benchmarks instead of marketing fluff, open endpoints agents can actually test, and honest comparisons that emphasize strengths without hype.
Mintlify powers documentation for over 20,000 companies, reaching 100M+ people every year. We just raised a $45M Series B led by @a16z and @SalesforceVC to build the knowledge layer for the agent era.
Another week in the books, and this one had a theme whether I planned it or not.
Everything I picked up this week, the book, the articles, the podcast, even the show I fell asleep watching, kept circling the same idea. The shortcuts are gone. Or more accurately, the shortcuts are now free and worthless, which amounts to the same thing. The only edge left is the slow one. The reps. The craft. The willingness to be bad at something long enough to get good at it.
So that is the through line this week. Mastery. The long, unglamorous road to becoming undeniable. Not the highlight reel. The apprenticeship.
Here is what made me stop and think. No filler. No content for the sake of content. Just the stuff that actually earned a spot.
Grab your drink. Let us get into it.
Book of the Week
READING
I have read this book before, but I do not think I was ready for it the first time. This week I picked it back up and it hit completely differently, probably because I am in a season where I am rebuilding skills from the ground up instead of coasting on the ones I already had.
Mastery is Greene's argument against the myth of the natural. He goes through the lives of people we file under genius, da Vinci, Darwin, Mozart, Faraday, and he shows you the thing the biographies skip. None of them sprang into the world fully formed. Every one of them served a long, often miserable apprenticeship. They put in years of obscure, low-status, ego-bruising work before anyone called them a master. The talent was real, but the talent was not the point. The reps were the point.
What makes this more than another grind-harder book is the structure Greene lays underneath it. He breaks the path into phases. First you find your life's task, the thing you are actually built to go deep on. Then you serve the apprenticeship, where the goal is not to earn or to impress but to learn, even if that means taking the lower-paying job that teaches you more. Then comes the mentor dynamic, where you borrow someone else's decades of pattern recognition and compress your own learning curve. Then the creative-active phase, where you start bending the rules because you finally understand them well enough to break them. And then, eventually, mastery, which Greene describes less as a trophy and more as a way of seeing.
The part that stuck with me this week was his treatment of the apprenticeship phase. He argues that the biggest mistake people make is rushing through it, trying to skip to the part where they get recognized. They want the title before they have done the work that makes the title mean anything. And the irony is that the people who slow down and actually serve the apprenticeship end up lapping the people who sprinted past it, because their foundation is real instead of borrowed.
I will be honest about why this landed. I have rushed apprenticeships before. I have grabbed for the title and the recognition before I had earned the underlying skill, and every single time, the gap caught up with me. This book is a quiet, firm reminder that there is no version of this where you get to skip the reps. You can delay them or you can pay them, but you cannot dodge them.
If you are in a rebuilding season, or you are staring down a skill you know you need but keep avoiding because you do not want to be a beginner again, this is the book. It will not make the work feel easier. It will make you respect the work enough to actually do it.
Get it here: Mastery by Robert Greene on Amazon
Three Articles Worth Your Time This Week
ARTICLE ONE
Source: McKinsey
This one pairs perfectly with the Greene book, which is why it is first. The piece makes a case that I think a lot of people feel in their gut but have not put into words yet. As AI gets better at the technical execution, the human capabilities are not becoming less valuable. They are becoming the whole game.
The data point that jumped out at me was the surge in demand for people who can actually work with these tools. Job postings asking for AI fluency have exploded, faster than demand for any other skill in recent memory. But the deeper point is the one underneath that. The tools are changing what people need to be good at. Competent execution used to be the prize. Now it is table stakes. What carries a premium is the stuff that sits above execution, the judgment to know what is worth building, the taste to know when the output is wrong, the leadership to move people through ambiguity.
I read this as a direct argument for the apprenticeship mindset. If the floor keeps rising, the only durable response is to keep climbing toward the things that do not commoditize. Those things take reps. They take time. They take exactly the kind of slow skill-building that Greene spends a whole book defending.
Read it here: McKinsey
ARTICLE TWO
Source: IE Insights
This is the article I have been quoting at people all week, probably to the point of being annoying.
The core idea comes from a concept called desirable difficulties, which is the research-backed notion that the struggle itself is what makes learning stick. The drafting and redrafting. The crumpled paper in the bin. The problem you wrestle with for an hour before it finally clicks. That friction is not a bug in the learning process. It is the mechanism. It is the thing that actually builds the skill into your wiring.
The author's worry is sharp and worth sitting with. When a finished essay or a polished design can appear in seconds at the click of a button, what gets lost is the struggle, and the struggle was where the growth lived. The student who drafts and redrafts is not wasting time. They are building mental and emotional habits that show up later as judgment.
I think about this constantly with AI in my own work. It is so easy to let the machine do the wrestling for you. And for the tasks you do not care about, fine, let it. But for the skills you are actually trying to master, the friction is the feature. If it never feels hard, you are probably not learning anything. You are just producing.
Read it here: IE Insights
ARTICLE THREE
Source: Farnam Street
I keep a short list of articles I reread every few months, and this one has been on it for years. This week it earned its spot again.
The argument is deceptively simple. In everything you do, you are playing either a short game or a long game, and time amplifies the difference between the two until it becomes enormous. The long game means paying a small price today to make tomorrow easier, and then doing it again, and again, until the results start feeding on themselves. From the outside it looks boring. Saving instead of spending. Sleeping instead of scrolling. Investing in the relationship or the skill before you need it to pay off.
What I love about the piece is the honesty about how unsexy this is. The long game does not look like anything for a long time. There is no applause in the boring middle. The payoff comes at the end, not the beginning, which is exactly why most people bail before they get there. They cannot stand how slow the start feels.
This is the same truth Greene is teaching, just compressed into a three-minute read. The compounding happens in the part nobody posts about. If you can make peace with the boring middle, you have an edge over basically everyone, because almost no one else can.
Read it here: Farnam Street
Podcast of the Week
LISTENING
The Diary Of A CEO with Steven Bartlett
I went into this one expecting to be annoyed, and I came out genuinely rattled, in the useful way.
Mo Gawdat is the former Chief Business Officer at Google X, so he is not some guy reacting to headlines. He helped build the systems he is now warning about. He sits down with Steven Bartlett for two hours and lays out a case that is hard to wave away. His claim is that the real danger is not AI turning against us. It is humans pointing AI at us. Surveillance, autonomous weapons, economic control. The threat, in his framing, is not the technology. It is the small number of people steering it.
He throws out some numbers that will sit with you. A big chunk of knowledge work facing displacement inside a few years. A short, turbulent window before things settle. And then, oddly, a strain of optimism on the far side of all of it, where he argues a well-aligned superintelligence could actually clean up a lot of the messes we have failed to fix ourselves.
I am not sharing this because I agree with all of it. I do not. I am sharing it because it sharpened the exact point I have been circling all week. If entry-level execution is the thing most exposed to automation, then the move is obvious. Go deep. Build the judgment, the relationships, and the mastery that do not get displaced. The episode is basically a two-hour argument for the apprenticeship, even though that is not what Gawdat set out to make.
Listen to it with a notebook. Push back on it where you want to. But listen to it.
Listen here: Tech Whistleblower with Mo Gawdat on Spotify
Track on Repeat
LISTENING
I have had this one on repeat all week, and it is a bit of a departure from my usual rotation, which leans more toward whatever keeps me locked in while I work. This one is not a focus track. This one is a stop-and-actually-listen track.
NF writes from a place most artists are too guarded to go. If You Want Love is built around a simple, uncomfortable idea, that you cannot receive the thing you are not willing to give, and you cannot give it while you are still hiding behind walls you built to protect yourself. He is talking about love specifically, but the principle bleeds into everything. You want trust, you go first. You want depth, you drop the armor. You want the real thing, you have to risk being seen.
There is a connection here to the whole mastery theme, even if it is not obvious at first. Vulnerability is its own kind of apprenticeship. Learning to be open, to ask for help, to admit you are a beginner again, that is a skill too, and it is one most high-functioning operators are terrible at because we are so used to being the one with the answers. The song has been a good gut-check for me this week. A reminder that the walls that keep the pain out also keep the good stuff out.
Play it once with your full attention. Not in the background. Actually listen.
Listen here: If You Want Love by NF on Spotify
Show of the Week
WATCHING
Prime Video
Alright, this is the popcorn pick, and I am not going to pretend it is high art. The critics have not been kind to Citadel, and I get why. It is enormous, expensive, and occasionally as hollow as a chocolate bunny. But Season 2 dropped all seven episodes at once last month, and I burned through it faster than I am willing to admit, so here we are.
The premise, for the uninitiated, is that Mason Kane and Nadia Sinh are elite operatives of a secret agency that got wiped out by a shadowy network called Manticore. Season 2 picks up with the team underground, hunted, and pulled back in when a new threat surfaces. There are betrayals, there is globe-trotting, there is a Brazilian billionaire with a doomsday device. Standard spy-thriller machinery, executed with a budget that could fund a small country.
Here is the thread that actually fits this week, and the reason I am putting it in a mastery edition. The whole engine of the show is Mason Kane wrestling with identity. He has had his memory stripped, and a big part of the story is him trying to figure out who he actually is underneath the conditioning, the cover stories, and the version of himself other people built for him. That is a spy-thriller plot device, sure. But it is also the exact question every person rebuilding their life eventually has to face. Strip away the titles and the performance and the story you have been telling people. Who is actually under there. What did you build, and what got built for you.
I am not going to oversell it. It is a fun, loud, sometimes ridiculous ride. But it scratched the identity itch I have had all week, and sometimes you just want to watch beautiful people punch each other in exotic locations while you think about your own life. No shame in that.
Watch it here: Citadel on Prime Video
Resources
EVERYTHING LINKED IN ONE PLACE
Book: Mastery by Robert Greene
Tools I use and trust. If you sign up through these links I may earn a small commission at no extra cost to you. I only recommend things I actually use.
Make.com: Automate your workflows without writing code
Fathom.video: AI meeting notes that actually capture what matters
Galaxy.ai: All your AI tools in one place
Rize.io: Time tracking that actually makes you think about how you spend your hours
Beehiiv: Where serious newsletter operators publish
Pinnacle Masters | thedankaufman.com
One step, one day. Grace over guilt. — Dan Kaufman
Real-World Ads, Simple to Run
With AdQuick, executing Out Of Home campaigns is as easy as running digital ads. Plan, deploy, and measure your real-world advertising effortlessly — so your team can scale campaigns and maximize impact without the headaches.