Tutorial

A pragmatist's guide to RAG (with code)

When RAG actually beats fine-tuning, when it doesn't, and how to tell which one you need.

Updated Mar 2026Tutorials

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 walkthrough of the state machine, audio pipeline, and fallback design I use for Chasyr.

Updated Apr 2026
Tutorial · Open source

AI-first PR review, codified

The exact prompts and CI workflows my team runs on every PR. Copy-paste, MIT licensed.

github.com/isheraz/ai-pr
Starter kit

Next.js × Supabase × Stripe - a deployable starter

The boilerplate I clone for every new SaaS bet. Auth, billing, RLS, AI hooks pre-wired.

github.com/isheraz/saas-kit
Talk · 32 min

AI-First Engineering Teams - Lahore Devs Meetup

How I restructured a 7-person team around AI tooling. Velocity numbers, cultural pitfalls, what worked.

November 2025
Lecture

From Pre-sales to Production: Solutions Architect, decoded

A guest lecture at COMSATS on how mid-career engineers can move into architecture roles.

COMSATS · Sep 2025
Panel

Voice Agents in Regulated Markets

Panel at AusFinTech 2026 - the legal, technical, and ethical scaffolding for AI that talks to customers.

AusFinTech · 2026
Curated list

Books that changed how I architect systems

A handful of titles - short list, opinionated commentary, no affiliate nonsense.

12 books
Stack

Tools I actually use, daily

My exact dev stack - IDE, terminal, AI agents, productivity hacks. Updated quarterly.

Updated Q2 2026
Reading list

AI-engineering reading list

Papers, blog posts, and talks I send every engineer I mentor on getting up to speed with AI.

40+ links
Career guide

Resources for engineers from Pakistan

Remote-friendly companies, visa sponsors, OSS scholarships - things I wish I had a decade ago.

Free