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

فرض کریں کہ انوائس INV-2041 میں ادائیگی کی تاریخ 22 اکتوبر درج ہے، پھر سپلائر کی بعد میں آنے والی ای میل اسے 29 اکتوبر کر دیتی ہے۔ ایک ایجنٹ انوائس پڑھتا ہے، دوسرا ای میل پڑھتا ہے، اور تیسرا جو کچھ اسے ملتا ہے اس کی بنیاد پر ہفتے کی ادائیگیاں تیار کرتا ہے۔ پہلا 22 اکتوبر بتاتا ہے، دوسرا 29 اکتوبر، اور تیسرا وہ تاریخ بتاتا ہے جو اسے پہلے ملی۔ اس انتظام میں کوئی چیز یہ نہیں طے کرتی کہ کون سی تاریخ نافذ ہے، اس لیے ایجنٹوں کو چلانے والے شخص کو خود پڑتال کرنا پڑتی ہے۔

اس مخصوص انوائس کی مثال میں نے گھڑی ہے، لیکن اس کے پیچھے کا انتظام حقیقی ہے۔ میں ایک [Neotoma](https://neotoma.io/) انسٹینس کے ساتھ [تین ٹولز میں ایجنٹ](https://markmhendrickson.com/posts/what-my-agentic-stack-actually-does) چلاتا ہوں۔ ای میل دیکھنے والا عمل آنے والے پیغامات کو ان کے ماخذ کے ساتھ محفوظ کرتا ہے اور جن پیغامات پر کارروائی درکار ہو انہیں کاموں میں بدل دیتا ہے؛ Claude Code، Codex اور Cursor کے سیشن [وہی کام اور منصوبے](https://markmhendrickson.com/posts/the-swarm-that-runs-my-work) اٹھاتے ہیں۔ یہی انتظام، اور Neotoma کو ایک جامع نظامِ ریکارڈ بنانے کا میرا کام، اس مضمون کا نقطۂ آغاز ہیں۔

![ایک دستاویز اور ایک لفافہ الگ الگ حقائق کی پرچیوں سے جڑے ہیں](/images/posts/neotoma-paper/observation.svg "paper|فرضی مثال · INV-2041|ایک انوائس کے بارے میں دو ماخذ مختلف باتیں کہتے ہیں: PDF میں تاریخ 22 اکتوبر ہے، جبکہ بعد کی ای میل میں 29 اکتوبر۔")

## یادداشت کسی اور کام میں اچھی ہے

معلومات کی بازیافت ایسے مواد کو ڈھونڈتی ہے جو سوال سے متعلق معلوم ہوتا ہو۔ ویکٹر انڈیکس یا طویل چیٹ کی تاریخ یہ کام اچھی طرح کرتی ہے، اور بہت سے کاموں کے لیے یہ کافی ہے۔ لیکن اس سے [یہ طے نہیں ہوتا کہ اس وقت کیا نافذ ہے](https://markmhendrickson.com/posts/agentic-search-and-the-truth-layer)۔ آخری تاریخ پوچھی جائے تو بازیافت انوائس اور ای میل دونوں لوٹاتی ہے، سوال سے مشابہت کے لحاظ سے ترتیب دے کر، نہ کہ اس لحاظ سے کہ کون سا موجودہ صورت حال بتاتا ہے۔

زیادہ ٹولز اور ایجنٹ چلانے کے ماحول اس مسئلے کو مشکل بناتے ہیں۔ ایک ایجنٹ [Markdown فائل میں نوٹ](https://markmhendrickson.com/posts/the-markdown-memory-ceiling) رکھتا ہے، دوسرا اپنی چیٹ مصنوعات میں سیکھی ہوئی بات محفوظ کرتا ہے، اور تیسرا مشترکہ فولڈر پڑھتا ہے۔ ہر نقل لکھتے وقت درست تھی۔ جب حقیقت بدلتی ہے تو نقلیں مختلف اوقات میں بدلتی ہیں، یا بالکل نہیں بدلتیں۔ کوئی ایجنٹ یہ نہیں پوچھ سکتا کہ کس نقل کو مانا جائے، کیونکہ ایسی کوئی جگہ ہی نہیں جہاں اس سوال کا جواب ہو۔ نظامِ ریکارڈ کسی ایک ٹول سے باہر، ایسی جگہ ہونا چاہیے جہاں سب رسائی حاصل کر سکیں۔

اس سال کے آغاز میں میں نے Neotoma کو [یادداشت کی تہہ اور سچائی کی تہہ](https://markmhendrickson.com/posts/truth-layer-agent-memory) کہا تھا۔ پھر میں نے یہ کہنا چھوڑ دیا، کیونکہ مجھے لگا کہ Neotoma کے لیے ”یادداشت“ غلط زمرہ ہے: یہ [ابہام پیدا کرتی ہے](https://markmhendrickson.com/posts/your-ai-remembers-your-vibe-but-not-your-work)، اور لوگ Neotoma کا موازنہ یادداشت کی مصنوعات سے کرتے رہے۔ مجھے چاہیے کہ ایجنٹ بہت سی قسم کی چیزوں کے بارے میں درست ڈیٹا، ایسی شکل میں، محفوظ رکھے جس کی جانچ ہو سکے۔ اسے محفوظ رکھنے کی جگہ کا سیدھا نام نظامِ ریکارڈ ہے۔

نظامِ ریکارڈ سے میری مراد وہ جگہ ہے جو بتاتی ہے کہ اب کیا نافذ ہے، وہ کہاں سے آیا اور اس نے کس چیز کی جگہ لی۔ مشابہت کی بنیاد پر تلاش ان سوالوں کا جواب نہیں دے سکتی، کیونکہ مشابہت نہ وقت بتاتی ہے نہ ماخذ۔

> **بازیافت اور ریکارڈ**
>
> **یادداشت اور بازیافت کے ٹولز ایجنٹ کو سیاق محفوظ رکھنے اور ڈھونڈنے میں مدد دیتے ہیں۔ نظامِ ریکارڈ کا کام الگ ہے: وہ قبول شدہ مشاہدات سے موجودہ قدر نکالتا ہے اور ہر خانے کے ثبوت تک واپس جانے کا راستہ محفوظ رکھتا ہے۔ دونوں کاموں میں کچھ تداخل ہے، اور ایک ہی مصنوعات ایک سے زیادہ کام کر سکتی ہے۔**

## Neotoma آج کیا کرتا ہے

میں AI ایجنٹوں کے لیے نظامِ ریکارڈ Neotoma بناتا ہوں۔ یہ MIT لائسنس کے تحت کھلا ماخذ ہے اور آپ کی منتخب کردہ ڈیٹا ڈائریکٹری میں مقامی طور پر چلتا ہے۔ آگے وہ کچھ بیان ہے جو شائع شدہ پیکیج (npm پر 0.25.0) آج کرتا ہے۔

ہر تحریر کو ایک نئے مشاہدے کے طور پر محفوظ کیا جاتا ہے، جو اپنے ماخذ سے منسلک ہوتا ہے۔ نئی قدر پرانی قدر کو مٹانے کے بجائے اس کے ساتھ شامل کی جاتی ہے۔ Neotoma [اصل PDF یا ای میل](https://github.com/markmhendrickson/neotoma/blob/v0.25.0/docs/developer/source_storage_by_reference.md) کو اس سے اخذ کردہ ساختہ اکائیوں کے ساتھ محفوظ کر سکتا ہے، اور مشاہدات کا اپنے ماخذ سے تعلق قائم رکھتا ہے۔

مشاہدات اکائیوں سے متعلق ہوتے ہیں۔ کسی اکائی کی ID اس کی قسم اور شناخت کرنے والے خانوں سے اخذ ہوتی ہے۔ ایک ہی انسٹینس میں اور شناخت کے ایک جیسے قواعد کے تحت، شناخت کی ایک جیسی قدریں متعین طریقے سے ایک ہی ID بناتی ہیں، لہٰذا ایک ہی انوائس محفوظ کرنے والے دو ایجنٹ ایک ہی اکائی میں لکھتے ہیں۔

اکائیوں کو آپس میں بھی جوڑا جا سکتا ہے: انوائس کو اس کے سپلائر سے، یا بعد کے کام کو اس انوائس سے جس سے وہ متعلق ہے۔ ایجنٹ یہ تعلقات واضح طور پر بناتا ہے۔ یہ بتاتے ہیں کہ ریکارڈ کس طرح جڑے ہیں، جبکہ ماخذ کے روابط کسی مشاہدے کے پیچھے کا PDF یا ای میل دکھاتے ہیں۔

Neotoma ہر خانے کے لیے اسکیما کے ادغام کا قاعدہ خود لاگو کرتا ہے تاکہ مشاہدات سے اس کی موجودہ قدر نکالے۔ زیادہ تر خانوں میں تازہ ترین مشاہدہ غالب آتا ہے۔ اگر مشاہدات اور ادغام کے قواعد ایک جیسے ہوں تو یکجائی کا عمل ایک ہی اسنیپ شاٹ بناتا ہے؛ ہر بار پڑھتے وقت ماڈل سے دوبارہ انتخاب نہیں کرانا پڑتا۔

ہر موجودہ خانہ اس مشاہدے کی نشاندہی کرتا ہے جس نے اس کی قدر مقرر کی، اور محفوظ شدہ مشاہدہ اپنا ماخذ بتاتا ہے۔ یہ ثبوت تک پہنچنے کی راہ ہے، اس بات کا ثبوت نہیں کہ ایجنٹ نے اسے درست پڑھا تھا۔ تصحیح ایک اور مشاہدہ ہے، ترمیم نہیں؛ پرانی قدر فہرست میں رہتی ہے۔ آپ کسی اکائی کو اس شکل میں بھی پڑھ سکتے ہیں جس میں Neotoma نے اسے پہلے کسی وقت درج کیا تھا۔

اب انوائس کی طرف لوٹیں۔ دونوں ایجنٹوں کی تحریریں ایک ہی اکائی میں پہنچتی ہیں۔ ادائیگی کی آخری تاریخ اب 29 اکتوبر ہے اور ای میل سے آنے والے مشاہدے کی طرف اشارہ کرتی ہے۔ رقم اب بھی پہلے مشاہدے کی طرف اشارہ کرتی ہے کیونکہ وہ نہیں بدلی۔ ادائیگی والا ایجنٹ 29 اکتوبر پڑھتا ہے، اور 22 اکتوبر والا مشاہدہ اپنے ماخذ کے ساتھ فہرست میں باقی رہتا ہے۔

![الگ انوائس اور ای میل باریک لکیروں سے نشان زدہ ریکارڈ کارڈ سے جڑے ہیں](/images/posts/neotoma-paper/invoice-example.svg "paper|موجودہ ریکارڈ · INV-2041|ادائیگی کی آخری تاریخ اب 29 اکتوبر ہے۔ بدلا ہوا خانہ بعد کے مشاہدے کی طرف اشارہ کرتا ہے۔ رقم اب بھی پہلے مشاہدے سے آتی ہے۔ دونوں مشاہدات ریکارڈ میں باقی رہتے ہیں۔")

ایجنٹ MCP سرور، REST API اور CLI کے ذریعے Neotoma تک پہنچتے ہیں۔ تنصیب کی رہنمائی بتاتی ہے کہ معاونت یافتہ ٹولز اور ماحول کیسے جوڑے جائیں۔ ریکارڈ بانٹنے کے لیے ہر ٹول کو ایک ہی انسٹینس اور ڈیٹا پروفائل، یا ایک ہی MCP داخلے، کی طرف موڑیں؛ الگ داخلے الگ ڈیٹابیس استعمال کر سکتے ہیں۔

لوگ ساتھ آنے والی Neotoma ایپ میں اپنے ریکارڈ دیکھ سکتے ہیں۔

ایک منظور شدہ [دستخط شدہ درخواست](https://markmhendrickson.com/posts/know-which-of-your-agents-wrote-what/) تصدیق شدہ ایجنٹ شناخت قائم کر سکتی ہے۔ فعال اور محدود دائرے کی اجازتیں طے کرتی ہیں کہ کون سے اقدامات جائز ہیں؛ صرف دستخط اجازت نہیں ہیں۔

## آگے کا رخ

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

- ہر شعبے کے لیے واضح ذمہ دار مقرر کرنا، جسے اسی شعبے کے ریکارڈ درست کرنے کا محدود اختیار ہو۔
- متقابل دعووں، حل طلب اختلافات اور سرکاری مؤقف کو واضح طور پر ظاہر کرنا۔
- دکھانا کہ کوئی قدر کیوں نافذ ہے، وہ کس کے اختیار کی پیروی کرتی ہے اور تبدیلی کا اثر کہاں پڑے گا۔

Ateles اس رخ کو عملی پہلو سے آگے بڑھاتا ہے۔ [Ateles کے اڈاپٹر ڈیزائن](https://github.com/markmhendrickson/ateles/blob/a3e4d9ed2c33ac867bb67447221d559cbe8c5810/docs/foundation/adapters.md#L14-L22) میں اڈاپٹر ای میل، کیلنڈر اور کوڈ ہوسٹس جیسے نظاموں سے معلومات Neotoma میں لاتے ہیں، اور مجاز اقدامات واپس انہی نظاموں تک لے جاتے ہیں۔ Neotoma ریکارڈ محفوظ کرتا ہے؛ منسلک ٹولز کام انجام دیتے ہیں۔

مکمل تصور اور اس کے ہر حصے کی آج کی حالت [README](https://github.com/markmhendrickson/neotoma#vision-and-execution-status) میں موجود ہے۔

![شعبے کی ملکیت: بااختیار شخص دو محدود حصوں میں سے ایک تک پہنچتا ہے](/images/posts/neotoma-paper/vision-domain.svg "paper|شعبے کی ملکیت|شعبے کی ملکیت واضح کرے گی کہ نظامِ ریکارڈ کے ہر محدود حصے کو کون درست کر سکتا ہے۔")
![مؤقف کی نگرانی: دو محفوظ دعوے ایک فائل سے جڑے ہیں جہاں ایک مؤقف منتخب دکھائی دیتا ہے](/images/posts/neotoma-paper/vision-positions.svg "paper|مؤقف کی نگرانی|مؤقف کی نگرانی متقابل دعوے محفوظ رکھے گی اور واضح مؤقف کا معائنہ ممکن بنائے گی۔")
![وضاحتیں: موجودہ خانے کو اٹھانے سے اس کی بنیاد اور محدود اثرات ظاہر ہوتے ہیں](/images/posts/neotoma-paper/vision-explanation.svg "paper|وضاحتیں|وضاحتیں دکھائیں گی کہ کوئی قدر کیوں نافذ ہے، وہ کس کے اختیار کی پیروی کرتی ہے اور تبدیلی سے کون سی متعلقہ قدریں متاثر ہو سکتی ہیں۔")

## نظامِ ریکارڈ، صرف بازیافت نہیں

جواب بہتر انڈیکس نہیں ہے۔ بازیافت ایجنٹ کو پہلے کہی گئی بات ڈھونڈنے میں مدد دیتی ہے۔ [نظامِ ریکارڈ اسے بتاتا ہے کہ اس وقت کیا نافذ ہے](https://markmhendrickson.com/posts/the-spine-of-the-loop)۔ کئی ٹولز میں کام کرنے والے ایجنٹوں کو دوسری چیز چاہیے، ایسی جگہ جہاں سب پہنچ سکیں۔ اور نظامِ ریکارڈ تبھی مدد دیتا ہے جب ایجنٹ اس میں لکھیں اور اس سے پڑھیں۔

اگر آپ ایک سے زیادہ ٹول یا ماحول میں ایجنٹ چلاتے ہیں تو ایسے کام کے سلسلے سے شروع کریں جس کے حقائق اور اکائیاں آپس میں متعلق ہوں:

```
npm install -g neotoma
neotoma init
neotoma setup --tool claude-code
```

اپنے ٹول یا ماحول کے لیے سیٹ اپ کا اختیار استعمال کریں؛ تنصیب کی رہنمائی میں دیگر معاونت یافتہ انضمام بیان ہیں۔ پھر ایک ایجنٹ سے کام کے سلسلے کے مربوط حقائق اور اکائیاں محفوظ کریں اور انہیں دوسرے ایجنٹ سے پڑھیں، جو اسی ترتیب دیے گئے انسٹینس اور ڈیٹا پروفائل یا MCP داخلے سے منسلک ہو۔

تنصیب کی رہنمائی [neotoma.io/install](https://neotoma.io/install?utm_source=site&utm_medium=blog&utm_campaign=essay-system-of-record) پر ہے۔ کوڈ اور مسئلہ ٹریکر GitHub پر [github.com/markmhendrickson/neotoma](https://github.com/markmhendrickson/neotoma) میں ہیں۔

> **مقصد**
>
> **Neotoma AI ایجنٹوں کے لیے نظامِ ریکارڈ ہے۔ مقصد انسانوں اور ایجنٹوں کو ایسی مشترک سمجھ دینا ہے جسے وہ دیکھ سکیں اور اس کی حکمرانی کر سکیں: کیا معلوم ہے، اس پر یقین کیوں کیا جاتا ہے، وہ کہاں اختلاف کرتے ہیں، اور اسے بدلنے کا اختیار کس کے پاس ہے۔ یہ سمجھ کسی مخصوص ماڈل، ٹول یا ایپ سے آگے قائم رہنی چاہیے۔**