Hey there!
Summary of this email:
- MCPs vs Skills vs Subagents vs Documentation (+ second part of the Agentic Programming with AI course published)
- 🗞️ Claude Code source code has been leaked
- Tech reflection of the week
🎓 MCPs vs Skills vs Subagents vs Documentation
The goal of agentic programming is for the agent to code the way we expect it to.
This might seem trivial, but especially in large codebases, it gets complicated.
Agents are trained to repeat patterns, and if your code has legacy parts, they will most likely replicate those patterns.
Unless you tell them not to, that it's legacy, and that the new way of doing it is different.
For that, we have several alternatives: from setting up an MCP with all the company's documentation, to creating subagents or skills to distribute it.
For us, after many months of testing, the one that convinces us the most is a simpler one: having a docs folder and documenting everything. EVERYTHING.
This might seem trivial, but there are quite a few nuances about how and why.
We explain it all in the Agentic Programming course.
In the course, we don't give you the fish, nor do we give you the rod. We give you the instructions to build your own rod.
To do that, we go deep into understanding how agents work internally, so you can learn how to guide them better.
🗞️ Top tech and programming news of the week
By now you've probably heard that Claude Code's source code has been leaked.
There's been a lot of noise about how it works internally, but most of what's been discussed was already in its own documentation.
But there is one very interesting thing: It's been confirmed that they have a bug that's breaking the cache and causing users to hit the limits much sooner.
Also, this week there was another security attack, this time on Axios, one of the most popular JS libraries for making HTTP requests.
And completely unrelated, but it seems like it's becoming a tradition, GitHub went down again.
We covered all of this news this morning on Café con Codely. We did it on Thursday because tomorrow is a holiday.
But don't worry if you couldn't make it to the livestream! It's been recorded on YouTube.😊
And since you've made it to this part of the newsletter, here's the joke of the week the reflection of the week, which I know you were waiting for:
When people like my agent more, is it because they're a good person or a good agent? 🤔 🤔 🤔
Cheers!