## The database choice that ages poorly

ایک کمپنی کسٹمر سپورٹ کے لیے ایک ایجنٹ بناتی ہے۔ یہ مشاہدات کو ڈیٹا بیس، پوسٹگریس، مونگو، ریڈیس، جو بھی ٹیم پہلے سے چلا رہی ہے میں محفوظ کرتا ہے۔ مہینوں بعد، ایک اور ٹیم اکاؤنٹ ہیلتھ ایجنٹ بناتی ہے۔ کوئی ان کو جوڑتا ہے کیونکہ ایک انسان ٹولز کے درمیان کاپی پیسٹ سیاق و سباق سے تھک گیا ہے۔ That connection, a shared database table, becomes multi-agent shared state by accident.

Three agents now share state about customer accounts: inbound support, health scoring, and renewal recommendations.

The support agent processes a frustrated customer and stores: "customer expressed dissatisfaction with pricing, considering alternatives." ہیلتھ اسکورنگ ایجنٹ اسے پڑھتا ہے، اکاؤنٹ کو ڈاؤن گریڈ کرتا ہے۔ The renewal agent reads the downgraded score, generates and sends a discount offer. سب کچھ منٹوں میں۔ لوپ میں کوئی انسان نہیں۔

The support agent's initial observation was wrong. کسٹمر بلنگ کی غلطی سے مایوس تھا، قیمتوں کا تعین نہیں۔ But the LLM-mediated memory extraction compressed the interaction into a misleading summary, and that summary propagated through shared state as ground truth.

Retrieval worked at every step. The failure was in the write. Nothing in the system could detect that the initial observation was unfaithful to its source, or trace the causal chain from bad write to bad action.

## Why single-agent systems mask the problem

With one agent writing to one memory store, write corruption degrades quality slowly. The agent summarizes an observation slightly wrong. It overwrites an entity attribute. It stores contradictory facts. نظام اب بھی کام کرتا ہے۔ It just gets gradually less reliable. The memory layer never gets blamed because the failure mode looks like an LLM problem.

This is where almost everyone is today. درد اویکت ہے۔ Nobody can answer basic questions: what did the agent learn, when, from what source, did it contradict something it stored last week. But the system doesn't visibly break. بھروسہ بالکل ختم ہو جاتا ہے۔

## What changes with multiple agents

When Agent A writes observations that Agent B reads and acts on, a different failure topology emerges.

**Contradiction amplification.** Two agents store conflicting facts about the same entity from different interactions. A third agent arrives to take action and sees whichever fact the retrieval layer surfaces, with no basis for adjudicating between them. Without an append-only observation log with timestamps and source attribution, there's no forensic path to understand the contradiction.

**Silent overwrite cascades.** Agent A updates a record. Agent B, operating on a stale read, writes its own update that implicitly reverts Agent A's change. In a mutable database, this is nearly undetectable. In an append-only log with hash-linked observations, it's structurally impossible.

**Trust boundary collapse.** Shared state means each agent trusts the other's writes. But agents have different capabilities, prompt contexts, and error profiles. A specialized financial analysis agent and a general-purpose support agent probably shouldn't have equal write authority over the same entity state. In a flat database with no schema constraints on who can write what, they do.

## چار مراحل

The industry is moving through a predictable arc.

### 1. "Just use Postgres" (or [just use a markdown file](/posts/the-markdown-memory-ceiling))

Manus, Claude Code, and OpenClaw all use plain text files for memory. Convergent evolution, not a shared playbook. When a team reaches for a database, memory gets bolted onto whatever is already there: RAG over Postgres with pgvector, Redis for session state, embeddings in Pinecone. Either path works for simple use cases. The mental model is agents need to remember stuff, files or databases store stuff, problem solved.

### 2. Retrieval optimization

Mem0، Zep، اور MemPalace جیسے پروڈکٹس قبول کرتے ہیں کہ ایجنٹوں کو ایک وقف شدہ میموری خلاصہ کی ضرورت ہوتی ہے لیکن مسئلہ کو بازیافت کے معیار کے طور پر تیار کیا جاتا ہے۔ صحیح وقت پر پرامپٹ میں صحیح سیاق و سباق کیسے حاصل کریں۔ اس سے وہ مسئلہ حل ہو جاتا ہے جو ڈویلپر پہلے ہی محسوس کر سکتے ہیں: خراب یاد، فولا ہوا سیاق و سباق کی کھڑکیاں، غیر متعلقہ بازیافت۔ لیکن یہ مرحلہ لکھنے کے راستے کو بغیر جانچے چھوڑ دیتا ہے۔ جو بھی LLM اقتباسات کو زمینی سچائی سمجھا جاتا ہے۔

یہ مرحلہ اگلے یا دو سال تک غالب رہے گا کیونکہ بازیافت کا درد قابل مطالعہ ہے۔ جب ایجنٹ بھول جاتا ہے یا غلط چیز بازیافت کرتا ہے تو ڈویلپر نوٹس لیتے ہیں۔ لکھیں کرپشن ناجائز ہے۔ ایجنٹ بری حالت پر اعتماد کے ساتھ کام کرتا ہے اور کسی کو اس وقت تک احساس نہیں ہوتا جب تک کہ نیچے کی طرف سے نتائج سامنے نہ آئیں۔

### 3. اعتماد کا بحران

یہ اس وقت ہوتا ہے جب ایجنٹ کم اسٹیک اسسٹنٹ سے اعلی اسٹیک اداکاروں میں منتقل ہوتے ہیں، رقم کا انتظام کرتے ہیں، خریداری کے فیصلے کرتے ہیں، تعمیل کے کام کے بہاؤ کو سنبھالتے ہیں، دنوں یا ہفتوں میں خود مختار طور پر کام کرتے ہیں۔ سوال "کیا ایجنٹ نے صحیح چیز بازیافت کی؟" سے بدل جاتا ہے۔ "کیا میں ثابت کر سکتا ہوں کہ ایجنٹ کیا جانتا تھا، جب اسے معلوم تھا، اور کیا وہ علم جائز تھا؟"

ہائی پروفائل کی ناکامیاں جہاں ایجنٹوں نے میموری کی خراب حالت پر کام کیا ہے وہ اس تبدیلی کو مجبور کرے گی۔ انٹرپرائز کے خریدار آڈٹ ٹریلز کا مطالبہ کریں گے۔ مالیات اور صحت کی دیکھ بھال میں ریگولیٹرز کو تعییناتی بنیاد کی ضرورت ہوگی۔

### 4. تقسیم

انڈسٹری تقسیم ہو جاتی ہے۔ راستہ A: موجودہ ڈیٹا بیس ایجنٹ پرائمیٹوز کو شامل کرتے ہیں۔ پوسٹگریس کو مشاہدے کے لاگنگ اور ہستی کے حل کے لیے توسیع ملتی ہے۔ Supabase یا PlanetScale ایک "ایجنٹ میموری" پروڈکٹ پرت بھیجتا ہے۔ یہ استعمال کے بہت سے معاملات کو پکڑتا ہے جہاں اعتماد کے تقاضے معتدل ہوتے ہیں۔

پاتھ بی: ٹرسٹ باؤنڈری کے پار کام کرنے والے ایجنٹوں کے لیے مقصد سے بنایا ہوا ایجنٹ ریاست کا بنیادی ڈھانچہ، طویل عرصے سے چلنے والی خود مختار حالت کو برقرار رکھنا، یا کرپٹوگرافک پرویننس کی ضرورت ہے۔ کلیدی انویریئنٹس (صرف ضمیمہ، ہیش سے منسلک، سکیما سے محدود، ڈیٹرمینسٹک ہستی ریزولوشن) آرکیٹیکچرل وعدے ہیں جنہیں ڈیٹا بیس ایکسٹینشن کے طور پر قابل اعتماد طریقے سے دوبارہ نہیں بنایا جا سکتا۔

یہ وہ راستہ ہے جہاں ایجنٹی نظام اپنی پوری صلاحیت تک پہنچتے ہیں۔ وہ ایجنٹ جو اپنی ریاست پر بھروسہ کر سکتے ہیں، اپنے استدلال کا پتہ لگا سکتے ہیں، اور خاموش بدعنوانی کے بغیر دوسرے ایجنٹوں کے ساتھ ہم آہنگی کر سکتے ہیں وہ بہترین کوشش کی یادداشت پر چلنے والے ایجنٹوں سے زیادہ قابلیت رکھتے ہیں۔

لکھنے کی سالمیت ایک حفاظتی خصوصیت نہیں ہے جو حقیقت کے بعد بند کی گئی ہے۔ یہ وہ بنیاد ہے جو خود مختار آپریشن کو ممکن بناتی ہے۔

## ملٹی ایجنٹ سسٹم اصل میں کیسے بنیں گے۔

زیادہ تر کو ملٹی ایجنٹ سسٹم کے طور پر ڈیزائن نہیں کیا جائے گا۔ وہ بڑھیں گے۔

**انسانی مرکز کے ساتھ حب اور گفتگو** موجودہ غالب نمونہ ہے۔ ایک بنیادی ایجنٹ صارف کا سامنا کرتا ہے اور ذیلی کام خصوصی ایجنٹوں کو سونپتا ہے۔ مشترکہ ریاست بنیادی ایجنٹ کی سیاق و سباق کی ونڈو ہے۔ تحریری سالمیت کا خطرہ کم ہے۔ لیکن اس ٹوپولوجی کی ایک سخت حد ہے: حب ایجنٹ رکاوٹیں اور طویل عرصے سے چلنے والے ورک فلو میں سیاق و سباق کو برقرار نہیں رکھ سکتا۔ یہ نقشہ مراحل 1 اور 2 کا ہے: "صرف پوسٹگریس کا استعمال کریں" یا بازیافت پرت ٹھیک کام کرتی ہے کیونکہ ایک ایجنٹ ریاست کو کنٹرول کرتا ہے۔

**پائپ لائن ایجنٹ** آگے آتے ہیں۔ ترتیب وار ہینڈ آف جہاں ہر ایجنٹ کسی کام کی شے کو پروسیس اور افزودہ کرتا ہے۔ میٹنگ شیڈولنگ تک ڈرافٹنگ کو آؤٹ ریچ کرنے کے لیے کمپنی کی تحقیق میں لیڈ قابلیت۔ لکھنے کی سالمیت یہاں سے اہم ہوتی ہے۔ اگر ریسرچ ایجنٹ کمپنی کے غلط ڈیٹا کو اسٹور کرتا ہے، تو ہر نیچے کا ایجنٹ غلط کیلیبریٹ کرتا ہے۔ یہ وہ جگہ ہے جہاں ٹیمیں فیز 2 سے فیز 3 میں پھسلنا شروع کرتی ہیں: بازیافت اب بھی کام کرتی ہے، لیکن سطح کے نیچے اعتماد کا بحران پیدا ہو رہا ہے۔

**مشترکہ سیاق و سباق کے ساتھ ایونٹ سے چلنے والے ایجنٹس** کی پیروی کریں۔ ایک سے زیادہ ایجنٹس مشترکہ ماحول (CRM، codebase، کمیونیکیشن چینل) کے واقعات کو سبسکرائب کرتے ہیں، اپنے اپنے نقطہ نظر کو برقرار رکھتے ہیں، اور مشاہدات کو ایک مشترکہ اسٹور پر واپس لکھتے ہیں۔ کوئی آرکیسٹریٹر نہیں۔ یہ مکمل طور پر تیسرا مرحلہ ہے: مختلف تشریحی فریم ورک کے ساتھ ایجنٹوں کی طرف سے ہم آہنگی لکھنا، تضادات کو پکڑنے کے لیے کوئی رابطہ کار نہیں، اور لکھنے کی دیانت حقیقی طور پر خطرناک ہو جاتی ہے۔

**مستقل خود مختار ایجنٹس کے ساتھ طویل عرصے تک چلنے والی ریاست** آخری حالت ہے۔ ایجنٹ مسلسل چل رہے ہیں، دنیا کے ترقی پذیر ماڈلز کو برقرار رکھتے ہوئے، وقتاً فوقتاً دوسرے ایجنٹوں یا مشترکہ سچائی اسٹور کے ساتھ ہم آہنگ ہوتے ہیں۔ سیاق و سباق کی ونڈوز میموری کے طور پر کام نہیں کرسکتی ہیں۔ ان ایجنٹوں کو حقیقی سالمیت کی ضمانتوں کے ساتھ مستقل اسٹوریج کی ضرورت ہوتی ہے۔ یہ مرحلہ 4 ہے: تقسیم۔ یا تو آپ کا انفراسٹرکچر اس کے لیے بنایا گیا تھا یا ایسا نہیں تھا۔

ایک اہم تناؤ یہ ہے کہ بہت سے ڈویلپرز ایک اور دو ٹوپولاجی میں اپنے اسٹوریج کا انتخاب کرتے ہیں، جب مشترکہ ریاست کا خطرہ ہلکا ہوتا ہے۔ وہ اپنے پاس پہلے سے موجود ڈیٹا بیس کو چنتے ہیں اور یادوں کا ٹیبل شامل کرتے ہیں۔ جب تک وہ ٹوپولاجیز تین اور چار تک پہنچتے ہیں، تعمیراتی وعدے مکمل ہو جاتے ہیں۔ تغیر پذیر سے صرف ضمیمہ حالت میں منتقل ہونا لائبریری کی تبدیلی نہیں ہے۔ یہ ایک تعمیر نو ہے۔

## انضمام کی سطح جو اہمیت رکھتی ہے۔

جیتنے والا فن تعمیر شاید "اپنے ڈیٹا بیس کو تبدیل کریں" نہیں ہے بلکہ "اپنے ایجنٹوں اور آپ کے ڈیٹا بیس کے درمیان بیٹھنا ہے۔"

ایجنٹ لکھنے کی سالمیت کی پرت پر مشاہدات لکھتے ہیں: صرف ضمیمہ، اسکیما سے محدود، پرویننس ٹریکڈ۔ وہ پرت ایجنٹ کے پڑھنے کے قابل حالت کا انتظام کرتی ہے۔ ڈویلپر کا موجودہ ڈیٹا بیس کاروباری ڈیٹا، گاہک کے ریکارڈ، لین دین، پروڈکٹ کیٹلاگ کے ریکارڈ کا نظام رہتا ہے۔ لیکن ایجنٹ سے پیدا ہونے والی حالت، مشاہدات، قیاس آرائیاں، ہستی کی قراردادیں، فیصلے، مقصد سے بنی تہہ میں رہتے ہیں۔

عملی طور پر، دونوں پرتیں ایک دوسرے سے بات کرتی ہیں۔ ایک ایجنٹ پوسٹگریس سے گاہک کا ریکارڈ پڑھتا ہے، ایک تجزیہ کرتا ہے، اور اپنے مشاہدات (صحت کا سکور، خطرہ، تجویز کردہ کارروائی) کو تحریری سالمیت کی پرت میں لکھتا ہے جس میں سورس ریکارڈ کا حوالہ دیا جاتا ہے۔ دوسرا ایجنٹ اس گاہک کے بارے میں تمام مشاہدات کے لیے سالمیت کی پرت سے استفسار کرتا ہے، اس کی اصل کے ساتھ ایک مستقل سنیپ شاٹ حاصل کرتا ہے، اور اس پر عمل کرتا ہے۔ اگر کچھ غلط ہو جاتا ہے، تو آپ سلسلہ کو ٹریس کرتے ہیں: کس ایجنٹ نے کیا، کب، کس سورس ڈیٹا کی بنیاد پر لکھا۔ کاروباری ڈیٹا بیس کبھی بھی ایجنٹ سے پیدا ہونے والی حالت سے آلودہ نہیں ہوتا ہے، اور ایجنٹ کی پرت کبھی بھی اس بات کا پتہ نہیں کھوتی ہے کہ اس کے مشاہدات کہاں سے آئے ہیں۔

"انسانی تحریری کاروباری ڈیٹا" اور "ایجنٹ کی تحریر کردہ مشاہداتی حالت" کے درمیان فرق اس بات کے لیے سب سے واضح فریمنگ ہے کہ ڈیٹا لیئر کی ضرورت کیوں ہے۔ آپ ان کے ڈیٹا بیس کو تبدیل نہیں کر رہے ہیں۔ آپ ڈیٹا کے اس زمرے کے لیے ایک پرت شامل کر رہے ہیں جو ایجنٹوں کے خود مختاری سے لکھنا شروع کرنے سے پہلے موجود نہیں تھی۔

## جو میں بنا رہا ہوں۔

یہ وہی ہے جو [Neotoma](https://github.com/markmhendrickson/neotoma) کرتا ہے۔ صرف مشاہدات شامل کریں۔ ہیش سے منسلک پرووننس۔ سکیما سے مجبور لکھتے ہیں۔ ڈیٹرمنسٹک ہستی کی قرارداد۔ ہر مشاہدہ جو ایک ایجنٹ لکھتا ہے وہ پہلے دن سے ہی قابل شناخت، قابل سماعت اور مستقل ہوتا ہے۔

میں اس کے ذریعے اپنا ایجنٹ اسٹیک چلا رہا ہوں۔ ایک سے زیادہ ایجنٹس (ای میل ٹریج، ٹاسک مینجمنٹ، فنانس، مواد کی منصوبہ بندی) سبھی ایک ہی اسٹور پر لکھتے ہیں۔ ملٹی ایجنٹ مشترکہ ریاست کا مسئلہ میرے لیے فرضی نہیں ہے۔ یہ وہ چیز ہے جسے میں ہر ہفتے مارتا ہوں جب ایک ایجنٹ کا نکالنا دوسرے سے متصادم ہوتا ہے، یا جب کوئی باسی پڑھنا خراب حالت پر نیچے کی طرف کارروائی کرتا ہے۔

تحریری سالمیت کو اپنانے کے انتظار کی قیمت تکنیکی قرض نہیں ہے جسے آپ بعد میں ادا کر سکتے ہیں۔ یہ آپ کی آڈٹ کی تاریخ میں ایک خلا ہے۔ ہجرت سے پہلے کی ہر چیز بلیک باکس ہے۔ یہ خلا دائمی ہے۔