Hey Reader,

Agents write better code when they can read docs instead of guessing from memory.

A 2026 paper found up to a 20% improvement in first-try code accuracy when models were given the right programming context.

So what do you do with that?

Don’t rely on the agent to know everything from their training set. Instead, provide tools or local docs that they can reference.

Your local docs should include sample code so agents can use the code correctly (the first time).

If you’ve ever read Apple’s docs, you know some frameworks are hard to use…

… But, you can fix that.

GPT-5.4 is really good at searching the web and can help design proper guides for your agents to use.

​Better Docs, Fewer Bugs: My Codex App Dev Workflow​

If you’re making apps for iOS and macOS, check out my DocSetQuery tools to build your own documentation straight from Apple’s DocSet bundles.

Instead of wasting tool calls, your agents can search local docs directly with grep or rg (ripgrep).

Pro Tip

If your agent keeps showing that it doesn’t have rg installed, make sure you ask it to fix the issue.

Anytime you have a tool call fail, that is an opportunity to fix a problem. You’ll get faster searches with the best tool for the job.

brew install ripgrep

Sometimes, pathing issues, sandboxes, or virtual environments can get in the way. If your agent can’t see the tools, share your current path with them using:

echo $PATH

Copy the results of that so they can diagnose why they can’t see the installed tools.

Have a good tip? Let me know, just hit reply.

5 Links

1. Learn from Paul Hudson how Agent Skills can make your agents smarter: Agent Skills in Xcode - Build better SwiftUI apps with AI agents​
2. Are you struggling with getting started? Here’s a starting point: How I Build Apps with Codex and GPT-5.4.
3. Grab these Swift and Apple platform development skills from Github.
4. Want another documentation tool? Ray published Two MCPs That Save 97% of Your Context Window​
5. ​Official Codex Best Practices. Read them and learn where you can improve.

Want Better Documentation?

Here’s what the community shared:

Paul Solt @PaulSolt What is your best way to provide documentation to agents? - Context7 - Local Markdown docs - Other? 10:9 PM • Mar 9, 2026 1 Retweets 18 Likes Read 12 replies

​

Talk soon,

Paul Solt
Paul@SuperEasyApps.com

P.S. Next week, I’ll share some of my design tips for achieving an app’s look and feel.

​What design tools are you using for your apps? Click the link to vote, or reply.