# chamnan — تاکہ ریپوزٹری خود کو پہچانے

<sub>[🇬🇧 English](../../README.md) · [🇨🇳 中文](README.zh-CN.md) · [🇹🇼 繁體中文](README.zh-TW.md) · [🇯🇵 日本語](README.ja.md) · [🇰🇷 한국어](README.ko.md) · [🇹🇭 ไทย](README.th.md) · [🇻🇳 Tiếng Việt](README.vi.md) · [🇮🇩 Indonesia](README.id.md) · [🇮🇳 हिन्दी](README.hi.md) · [🇧🇩 বাংলা](README.bn.md) · [🇸🇦 العربية](README.ar.md) · [🇮🇱 עברית](README.he.md) · [🇹🇷 Türkçe](README.tr.md) · [🇷🇺 Русский](README.ru.md) · [🇺🇦 Українська](README.uk.md) · [🇵🇱 Polski](README.pl.md) · [🇨🇿 Čeština](README.cs.md) · [🇩🇪 Deutsch](README.de.md) · [🇳🇱 Nederlands](README.nl.md) · [🇫🇷 Français](README.fr.md) · [🇪🇸 Español](README.es.md) · [🇵🇹 Português](README.pt-PT.md) · [🇧🇷 Português (BR)](README.pt-BR.md) · [🇮🇹 Italiano](README.it.md) · [🇷🇴 Română](README.ro.md) · [🇬🇷 Ελληνικά](README.el.md) · [🇭🇺 Magyar](README.hu.md) · [🇸🇪 Svenska](README.sv.md) · [🇫🇮 Suomi](README.fi.md) · [🇩🇰 Dansk](README.da.md) · [🇳🇴 Norsk](README.no.md) · [🇵🇭 Tagalog](README.tl.md)</sub>

> اس صفحے پر جان بوجھ کر کوئی عدد نہیں ہے۔ تمام پیمائشیں انگریزی README میں ہیں اور ہر ریلیز کے ساتھ بدلتی ہیں؛ یہ صفحہ نہیں بدلتا۔ ← [Evidence](../../README.md#evidence)

## یہ کیا ہے

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

یہ جو کچھ لکھتا ہے وہ سادہ markdown ہے جو کوڈ کے ساتھ ہی commit ہوتا ہے۔ چلتے وقت کوئی نیٹ ورک کال نہیں، کوئی ڈیٹابیس نہیں، کوئی daemon نہیں، کوئی embedding ماڈل نہیں — صرف Python کی معیاری لائبریری۔

## یہ کیا حل کرتا ہے

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

chamnan اس دوبارہ دریافت کو ہونے ہی نہیں دیتا: فہرست سیشن کے آغاز پر ہی دے دی جاتی ہے، اور قیمت ایک معلوم، محدود عدد ہوتی ہے، نہ کہ لامحدود فائل خوانی۔

## تنصیب

```bash
claude plugin marketplace add ArcticFox2029/chamnan
claude plugin install chamnan@chamnan
```

ایک نیا سیشن کھولیں، پھر ہر ریپوزٹری میں ایک بار `/chamnan:bootstrap` چلائیں۔

<!-- generated: build_sections.py -->

## تمام خصوصیات

چار صلاحیتیں۔ نیچے درج ہر چیز موجودہ ریلیز میں واقعی چل رہی ہے۔ ہر حصہ `.chamnan/config.json` میں الگ سے بند کیا جا سکتا ہے، اور کوئی حصہ دوسرے پر منحصر نہیں۔

### سمجھنا — کیا موجود ہے، اور کیا کس سے جڑا ہے

| | |
|---|---|
| **اشاریہ** | `MAP.md` — ہر فائل کے لیے ایک سطر، خود کوڈ سے بنائی گئی۔ ایجنٹ اشاریہ پڑھتا ہے اور مطلوبہ تفصیل grep کر لیتا ہے، پورے درخت میں گھومنے کے بجائے۔ |
| **اثر** | اس فائل پر کون انحصار کرتا ہے، اور کون سے ٹیسٹ اسے ڈھانپتے ہیں۔ فائل کی اپنی import تو اوپر ہی لکھی ہوتی ہے؛ مہنگی تلاش الٹی سمت کی ہوتی ہے — بدلنے سے پہلے راستے کو grep کر لیں۔ |
| **ڈیٹا ماڈل** | ٹیبل اور ماڈل کے نام، ایک سطر کے خلاصے کے ساتھ، DDL، مائیگریشن اور ORM ماڈلز سے لیے گئے — پورا اسکیما ڈمپ نہیں۔ صرف تب ظاہر ہوتا ہے جب ریپازٹری میں تعریف موجود ہو۔ |
| **API سطح** | میتھڈ، راستہ اور ہینڈلر — روٹ ڈیکوریٹر، OpenAPI دستاویزات اور `.proto` سروس تعریفوں سے، پوری تفصیلات نہیں۔ |
| **کنفیگریشن** | وہ ماحولیاتی متغیرات جن کے نام ریپازٹری پڑھتی ہے۔ **صرف نام، قدر کبھی نہیں** — اور اگر `.env` gitignore میں نہ ہو تو خبردار کرتا ہے۔ |
| **تعیناتی** | جو واقعی چلتا ہے، Kubernetes، Ansible، Compose، Helm اور CI مینی فیسٹ سے پڑھا گیا: قسم اور نام، امیج، کردار، پائپ لائن۔ Secret صرف اپنا نام دیتا ہے، اس کے نیچے کچھ نہیں۔ |
| **غیر ماخذ مواد** | اسکین شدہ کاغذات، برآمدات، آرکائیو — صرف تعداد، حجم اور غالب ایکسٹینشن۔ یہ اس لیے ہے کہ ایجنٹ خود دیکھنے نہ چلا جائے، جو کہیں زیادہ مہنگا پڑتا ہے۔ **کبھی کھولا نہیں جاتا، کبھی پڑھا نہیں جاتا۔** |

### یاد رکھنا — کیا کیا جا رہا تھا، اور کیوں

| | |
|---|---|
| **کام کی حالت** | `STATE.md` — اس وقت جس پر کام ہو رہا ہے، سیشن کے آغاز پر شامل کیا جاتا ہے تاکہ سیاق کی تلخیص اسے مٹا نہ سکے۔ |
| **سیشن ریکارڈ** | `.chamnan/sessions/` میں فی سیشن ایک۔ **صرف نامکمل حصہ** اگلے سیشن تک پہنچتا ہے؛ صاف ستھرے انجام کو پہنچا سیشن کچھ بھی شامل نہیں کرتا۔ |
| **یادداشت** | `decisions/`، `lessons/`، `rules/`۔ اصول مستقل پابندیاں ہیں، اس لیے ہر سیشن میں ایجنٹ کے سامنے رہتے ہیں؛ فیصلے اور اسباق صرف عنوان دیتے ہیں اور تب پڑھے جاتے ہیں جب عنوان متعلقہ لگے۔ |
| **کھلے سلسلے** | ابھی جاری کام کی لڑیاں، اس تاریخ کے ساتھ کہ اس لڑی نے کن فائلوں کو چھوا — اور فائل کا نام بدلنے کے بعد بھی پیچھا کرتی ہیں۔ |

### دوبارہ استعمال — جو ایک بار حل ہو چکا

| | |
|---|---|
| **طریقہ کار** | وہ مہارتیں جو ایجنٹ کسی پیچیدہ یا بار بار آنے والی چیز سے واسطہ پڑنے پر **خود لکھتا ہے**۔ یہ کوئی تیار لائبریری نہیں، ایک طریقہ کار ہے۔ |
| **اوزار** | جب وہی عارضی اسکرپٹ دوبارہ لکھی جاتی ہے تو متوجہ کرتا ہے اور اسے رکھ لینے کی پیشکش کرتا ہے — اور نئی اسکرپٹ لکھنے سے پہلے اسی کی یاد دلاتا ہے۔ |
| **کام کا بہاؤ** | جب وہی کمانڈز الگ الگ دنوں میں اسی ترتیب سے چلتی ہیں، تو اس ترتیب کو لکھ رکھنے کی پیشکش کرتا ہے۔ |

### ارتقا — ریپازٹری نے اپنے بارے میں کیا سیکھا

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

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

## کمانڈز

سب شیل سے چلائی جا سکتی ہیں، اور ایجنٹ بھی خود چلاتا ہے۔

| | |
|---|---|
| `chamnan-map` | اشاریہ بنانا اور تازہ رکھنا |
| `chamnan-report` | ورک اسپیس میں کیا ہے، اور فی باری سیاق کیسے بدلا |
| `chamnan-impact` | اس فائل پر کون انحصار کرتا ہے، کون سے ٹیسٹ اسے ڈھانپتے ہیں |
| `chamnan-timeline` | اس فائل کے ساتھ اب تک کیا کیا ہوا |
| `chamnan-peek` | بڑی فائل کو سیاق میں پڑھے بغیر بتانا کہ اس کے اندر کیا ہے |
| `chamnan-promote` | کسی اسکرپٹ کو ریپازٹری کا مستقل اوزار بنا دینا |
| `chamnan-candidates` | پکڑی گئی تکرار دیکھنا، منظور کرنا یا رد کرنا |
| `chamnan-env` | ماحول اور اس کی ممانعتیں بیان کرنا، اور دیکھنا کہ بیان اب بھی تازہ ہے |
| `chamnan-age` | جمع شدہ علم کہاں سے پرانا ہونے لگا ہے |

اور سیشن کے اندر سے بلائی جانے والی مہارتیں: `/chamnan:bootstrap` `/chamnan:remap` `/chamnan:resume` `/chamnan:remember` `/chamnan:milestone` `/chamnan:capture` `/chamnan:promote` `/chamnan:report`

## یہ کیا لکھتا ہے، اور کہاں

سب کچھ `.chamnan/` کے اندر، سادہ markdown اور JSON۔ پڑھا جا سکتا ہے، ہاتھ سے بدلا جا سکتا ہے، کسی بھی وقت مٹایا جا سکتا ہے — کچھ نہیں ٹوٹے گا۔

| | |
|---|---|
| `MAP.md` | کیا موجود ہے، اور کیا کس پر منحصر ہے |
| `STATE.md` | اس وقت کیا کیا جا رہا ہے |
| `sessions/` | پچھلا کام کہاں رکا |
| `memory/` | فیصلے، اسباق اور مستقل اصول |
| `threads/` | ابھی کھلی کام کی لڑیاں |
| `skills/` · `tools/` | رکھنے کے قابل طریقے اور اسکرپٹ |
| `milestones.md` | وہ تبدیلیاں جنہوں نے ریپازٹری کی شکل بدلی |
| `config.json` | ہر حصے کا چالو بند، اور سیشن میں شامل ہونے والے حصے کی حجمی حد |

**`.chamnan/` سے باہر واحد تحریر** ایک اختیاری Git pre-commit hook ہے، جو اشاریے کو کوڈ کے ساتھ چلاتا رکھتا ہے — یہ صرف تب لگتا ہے جب آپ ہاں کہیں، اور ہٹایا جا سکتا ہے۔

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

## حفاظت

| | |
|---|---|
| **چلتے وقت کوئی نیٹ ورک کال نہیں** | ایک بھی نہیں۔ کوئی API key درکار نہیں، کہیں کچھ نہیں بھیجا جاتا۔ |
| **آپ کا سورس دوبارہ نہیں لکھتا** | یہ رپورٹ کرتا ہے، ترمیم نہیں۔ اشاریہ وہی تبصرے نقل کرتا ہے جو آپ پہلے ہی لکھ چکے ہیں، گھڑتا نہیں؛ بغیر تبصرے والی فائلوں کے نام گنوا دیے جاتے ہیں تاکہ آپ بھر دیں۔ |
| **کوئی ڈیمن نہیں، کوئی پس منظر کا کام نہیں** | کوئی مستقل پروسیس نہیں، کوئی ڈیٹا بیس نہیں، کوئی ایمبیڈنگ ماڈل نہیں — صرف Python کی معیاری لائبریری۔ |
| **رازداری پہلے چھانی جاتی ہے** | جو کچھ لکھا جائے گا یا سیشن میں شامل ہوگا، سب پہلے رازداری کے چھلنی سے گزرتا ہے: متغیر کے *نام* رہتے ہیں، قدریں نہیں۔ اور یہ چھلنی جہاں تک نہیں پہنچ سکتی، وہ حد انگریزی README میں اسی کے عدد کے ساتھ لکھی ہے۔ |
| **ایک نصب شدہ پلگ ان آپ کے ساتھ کیا کر سکتا ہے** | انگریزی README میں پورا لکھا ہے، یہ بھی کہ chamnan اخراج کی زنجیر کہاں توڑتا ہے۔ |

## ضروریات

Claude Code · Python · Git · macOS، Linux یا Windows

اس کے سوا کچھ نہیں، اور نصب کرنے کے لیے کوئی انحصار نہیں۔ Python کا کم سے کم ورژن [README › Requirements](../../README.md#requirements) میں ہے — اس صفحے پر اعداد نہیں لکھے جاتے، کیونکہ بدلتے تو اعداد ہی ہیں۔

## بند کرنا یا ہٹانا

`.chamnan/config.json` میں حصہ بہ حصہ بند کریں · ایک ریپازٹری میں روکیں · پلگ ان پوری مشین سے ہٹائیں · `.chamnan/` کسی بھی وقت مٹائیں، کچھ نہیں ٹوٹے گا — تفصیلی مراحل [README › Update, disable, uninstall](../../README.md#update-disable-uninstall) میں۔

<!-- /generated -->

## تنصیب سے پہلے پڑھیں

**chamnan اُس مرکزی فولڈر کے لیے ہے جس پر آپ بار بار واپس آتے ہیں۔** یہ جو کچھ کرتا ہے وہ پہلے ادا کیا جاتا ہے اور بعد کے سیشنوں میں وصول ہوتا ہے — جس ریپوزٹری کو آپ ایک ہی بار کھولتے ہیں، وہاں آپ نے پورا ادا کیا اور کچھ وصول نہ ہوا۔

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

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

## تفصیل کہاں ہے

| | |
|---|---|
| ہر عدد، اور وہ کیسے ناپا گیا | [README › Evidence](../../README.md#evidence) |
| ریگریشن ٹیسٹ — آپ خود چلا سکتے ہیں | [`tests/run_tests.py`](../../tests/run_tests.py) |
| ہر ریلیز میں کیا بدلا، اور کیوں | [CHANGELOG.md](../../CHANGELOG.md) |
| سب کچھ | [README.md](../../README.md) |

---

<sub>MIT · [github.com/ArcticFox2029/chamnan](https://github.com/ArcticFox2029/chamnan)</sub>