DEV Community

LOI CHIANG HAO
LOI CHIANG HAO

Posted on

What's the first thing that breaks when a RAG system leaves the notebook?

I've been studying and building RAG systems for a while, and I've noticed a pattern.

Most tutorials stop once the demo works.
But production introduces a completely different set of problems.
In my experience, the first issues usually aren't model-related.
They're system-related.

Examples:

  • Retrieval returns technically relevant but practically useless context
  • Costs grow much faster than expected
  • Evaluation becomes difficult and inconsistent
  • Model updates introduce subtle behavior changes
  • Latency becomes a real constraint

The more I worked on RAG systems, the more I realized that many failures happen between components rather than inside the model itself.

That shifted how I think about AI engineering.

Instead of asking:
"Can this work?"

I started asking:
"What happens when it fails?"

I've been organizing everything I've learned into an open-source project called AI Model Atlas, focused on AI system design rather than specific frameworks.

GitHub:

GitHub logo Hao610 / AI-Model-Atlas

Dual-track AI reference architecture: RAG system design & AI Security Engineering (EN/ZH) | 双轨 AI 参考架构:RAG 系统设计与 AI 安全工程

AI Model Atlas Logo

🗺️ AI Model Atlas

👉 Read This First: Why AI-Model-Atlas Exists?

An AI DevSecOps & Security Engineering Reference Architecture

📖 Bilingual docs (EN/ZH) · Security Capability Map · Threat Models · CI/CD Pipelines 🎯 Evolved from a learning map into a Production-Grade AI Security Engineering Reference Architecture.

License: MIT CC BY 4.0 Security Pipeline Bilingual


📌 Reading guide

  • ✅ Great for: learning AI concepts, RAG system design, and hands-on experimentation
  • ⚠️ Model names & API prices may change — always verify against official docs
  • 🚫 Not intended for: production deployment or real-time benchmarking

🧭 Start Here

I want to… Go to
📚 Learn from scratch (step-by-step) CURRICULUM.md — 37 modules, Phase 1→5
🧬 Understand the math & internals DEEP_DIVES.md — 17 chapters
🛡️ See the new DevSecOps Blueprint CONSTRAINT_THREAT_MODEL.md — 36 chapters, DevSecOps Blueprint
📐 See the system architecture ARCHITECTURE.md
▶️ Run the sandbox in 5 min Quick Start ↓
🗺️ Pick a learning track Getting Started
…

For people who have deployed RAG systems:
What was the first production issue that surprised you?

Top comments (0)