Tutorial

A pragmatist's guide to RAG (with code)

Updated Mar 2026tutorial

RAG is not a silver bullet. Here's when it works, when it doesn't, and how to know which problem you're actually solving.

The hype around RAG is that it lets you ground LLMs in fresh data. In practice, RAG is a retrieval problem disguised as an AI problem. Most failures are at the retrieval stage, not the generation stage.

When RAG wins

You have a corpus of documents and need the LLM to cite them accurately. RAG shines here. The retrieval step finds relevant context; the LLM synthesizes. You get citations for free.

When fine-tuning wins

You need the model to learn a new way of reasoning or style of output. Fine-tuning is the right tool. RAG won't teach the model anything; it only provides context.

The hard part is knowing which bucket your problem fits into. Hint: if you're uncertain, start with RAG. It's easier to debug.

More resources

Series · 4 parts

Building production voice agents that don't embarrass you

A voice agent that handles negotiations with real humans is not the same as a chatbot. Here's the architecture that keep...

Updated Apr 2026
Tutorial · Open source

AI-first PR review, codified

Every PR on my team gets reviewed by Claude before a human sees it. Here's the exact prompt and CI setup.AI code review ...

github.com/isheraz/ai-pr
Starter kit

Next.js × Supabase × Stripe - a deployable starter

Every SaaS I build starts from this template. Auth, billing, database, and AI hooks pre-wired. Here's what's included an...

github.com/isheraz/saas-kit
Training Session

From Pre-sales to Production: Solutions Architect, decoded

How to move from pre-sales engineering into an architecture role without taking a step backward.Pre-sales teaches you to...

Mind Maze · Sep 2025
Curated list

Books that changed how I architect systems

A short, opinionated list of books that shaped how I think about systems.Most architecture books are verbose and outdate...

12 books
Stack

Tools I actually use, daily

My exact dev stack. Updated quarterly.EditorVS Code with Copilot. The debugger integration alone is worth it.TerminalFis...

Updated Q2 2026
Reading list

AI-engineering reading list

Papers, blog posts, and talks every AI-focused engineer should read.FoundationStart with Attention Is All You Need if yo...

40+ links
Career guide

Resources for engineers from Pakistan

Remote work, visa sponsorship, OSS opportunities, and the things I wish someone had told me ten years ago.Getting remote...

Free