خلاصه

پس از ۴۸ جلسه در یک پروژه واحد و مجموعاً بیش از ۱۵۰، سیستم مدیریت Eager/Lazy که با دقت ساخته بودم، شروع به تنگشده شدن کرد. فایل‌های عامل که باید سبک باشند، مجموعاً ۵۲۰۰ خط وزن داشتند. بارگذاری خودکار context به سرعت بیشتری نسبت به توانایی من برای کنترل آن افزایش می‌یافت. این مقاله می‌گوید که چگونه من مکانیزم بکاپی — بین پنجره اسلایding و موج خنک یکسان — را طراحی کردم تا بتوانم یکcontext فعال سبک را حفظ کنم بدون اینکه هرگز چیزی را از دست دهم.

سیگنال: 5200 خطوط

من در میانه جلسه ۰۴۸ هستم بر`magic-stick`، پروژه‌ی من برای ساخت ISO زنده لینوکس. Opencode به من نگاه می‌کند. همان‌طور که همیشه، به‌طور خودکار فایل‌های Eager من را در ابتدای جلسه بارگذاری کرده —AGENT.adoc, PROMPT_REPRISE.adoc, .agents/INDEX.adoc. هیچ چیز غیرعادی نیست.

اما چیزی مشکل دارد. پاسخ‌ها کندتر شده‌اند. استدلال سطحی‌تر شده است. عامل جزئیاتی را که دو پیام پیش پیش‌روی او بود، فراموش می‌کند.

من یک ترمینال باز می‌کنم و تایپ می‌کنم:

wc -l .agents/INDEX.adoc .agents/SESSIONS_HISTORY.adoc \
  .agents/archives/COMPLETED_TASKS_ARCHIVE_2026-04.adoc

260 خط برای INDEX. 55 برای SESSIONS_HISTORY.1756 برای COMPLETED_TASKS_ARCHIVE.

پرونده`sessions/`حدود 3200 خط دیگر اضافه می‌شود. مجموع:۵۲۰۰ خطمحتوایی که بارگذاری می‌شوند، به یک صورت یا دیگری، در مغز موقت عامل.

استراتژی Eager/Lazy که در مقاله قبلی نظریه‌ام کردم کار می‌کند — اما یک عیب خلقی دارد که من پیش‌بینی نکردم : آن نداردبدون مکانیزم پیرایی. هر جلسه یک خط به INDEX، یک پاراگراف به COMPLETED_TASKS و یک فایل در sessions/ اضافه می‌کند. هیچ چیز هرگز خارج نمی‌شود. محتوا یک توپ برف است که در هر جلسه جدید بزرگتر می‌شود.

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

title رشد بافت عامل — جلسات ۱ تا ۴۸
rectangle "جلسه ۱-۱۰" as S10 #E8F5E9
rectangle "جلسه ۱۱-۲۰" as S20 #C8E6C9
rectangle "جلسه ۲۱-۳۰" as S30 #A5D6A7
rectangle "جلسه ۳۱-۴۰" as S40 #81C784
rectangle "جلسه ۴۱-۴۸" as S48 #66BB6A

note right of S10
شاخص : ~۵۰ خط
نشست‌ها : ~۱۰ خط
بایگانی : ~۱۰۰ خط
**مجموع : ~۳۰۰ خط**
end note

note right of S20
شاخص : ~100 خط
نشست‌ها : ~20 خط
آرشیو : ~400 خط
**مجموع : ~800 خط**
end note

note right of S30
شاخص: ~۱۶۰ خط
نشست‌ها: ~۳۰ خط
آرشیو: ~۹۰۰ خط
**مجموع: ~۱۸۰۰ خط**
end note

note right of S40
فهرست : ~۲۲۰ خط
جلسات : ~۴۵ خط
آرشیو : ~۱۴۰۰ خط
**مجموع : ~۳۲۰۰ خط**
end note

note right of S48
شاخص : **۲۶۰ خط**
نشست‌ها : **۵۵ خط**
بایگانی : **۱۷۵۶ خط**
**مجموع : ۵۲۰۰ خط** ⚠️
end note

S10 -[#green]-> S20
S20 -[#green]-> S30
S30 -[#FF9800]-> S40
S40 -[#red]-> S48

@enduml

این یک باگ نیست، بلکه نتیجه مستقیم از روی کار پایان جلسه است که هر جزئی را به‌دقت بایگانی می‌کند. سیستم قربانی موفقیت خود شده است.

تشخیص: سه‌گانه redundant

من از مامور می‌خواهم مشکل را تشخیص دهد. پاسخ او فوری و دقیق است.

فایل

خطوط

نقش

مشکل

.agents/INDEX.adoc

260+

EAGER (بارگذاری خودکار)

جدول همه جلسات از جلسه 001 —+1 خط در هر جلسه

.agents/SESSIONS_HISTORY.adoc

55

هوس‌ور

جدول خلاصه —تکراری با INDEX

COMPLETED_TASKS_ARCHIVE_2026-04.adoc

1756

EAGER (ضمنی)

جزئیات کامل تمام جلسات آوریل

.agents/sessions/*.adoc

~5200 total

کسل (گیرایه)

بایگانی‌های فردی، امااستفاده نشدهچون همه چیز قبلاً در COMPLETED_TASKS است

عامل چهار دلیل اصلی را شناسایی می‌کند:

  1. COMPLETED_TASKS_ARCHIVE همه چیز را جذب می‌کند— به جای اشاره به آرشیوها`.sessions/`, او هر جلسه را به‌طور کامل کپی می‌کند.

  2. INDEX.adoc به عنوان یک تاریخچهٔ کامل عمل می‌کند— جدول "جلسات اخیر" شامل 30+ ورودی است.

  3. SESSIONS_HISTORY.adoc مיותר— همان اطلاعات که در INDEX، فرمت متفاوت است.

  4. قاعده LAZY رعایت نشده است— COMPLETED_TASKS به‌صورت ضمنی EAGER است زیرا شامل همه چیز است.

پیشنهادش ریشه‌ای : محدود کردن INDEX به 10 جلسه, خالی کردن COMPLETED_TASKS, انتقال SESSIONS_HISTORY به LAZY خالص. سود فوری :~1900 خط ذخیره شده.

این تمیز، مؤثر، منطقی است. اما من یک مشکل با این رویکرد دارم.

چرا من راه‌حل واضح را رد کردم

راه‌حل عامل همانند یک مهندس است که یک حافظه caché را بهینه می‌سازد. محدود کردن. کوتاه کردن. حذف تکرارها.

اما این "redondances" نیستند. هر فایل مدیریت یکزاویه متفاوتبر روی همانrealite:

  • فهرست= منظره ماکرو، داشبورد اجرایی

  • تاریخ_جلسات= جدول زمانی خطی، امتیاز داده‌شده

  • آرشیو وظایف تکمیل‌شده= روایت دقیق همراه با متریک‌ها

  • sessions/*.adoc = آرشیوهای فردی، بخش کامل

این تکرار احمقی نیست. این …دیدگاه چندگانه ساختاری. این دقیقاً همان چیزی است که برای تقطیر نیاز داریم — تا بعداً یک انسان (یا یک LLM آینده بهتر آموزش‌دیده) بتواند زاویه‌ها را ترکیب کند و الگو‌ها را استخراج کند.

تصور کنید یک دانشمند داده به شما می‌گوید: « سه ستون از شش ستون را حذف می‌کنیم، چون هم‌ارتباط (correlated) هستند. » شما به او چه پاسخی می‌دهید؟ اینکه هم‌ارتباط معادل تکرار نیست وقتی هر ستون یک بعد مختلف از همان پدیده را می‌گیرد. دقیقاً همین غنای بعد‌ای است که دیتاست را قابل‌استفاده می‌کند.

این حدس من است. و من آن را در مقابل عقلانیت خنک عامل دفاع می‌کنم.

_ من در ایده‌ام یک انبار ساکت نمیبینم. نه همه چیز را جمع‌آوری می‌کنیم، بلکه نتیجه ساختاریافته از پایان جلسه را جابجا می‌کنیم — هر فایل با زاویه خود، تکرارهایی که در واقع ارتقاست. این مواد چندبعدی است که برای دیستیلاسیون بهتر خواهد بود. _

agenshit gets the blow. And he corrects himself.

پیشنهاد: موج خنک یکسان

سپس عامل یک مکانیزم دقیق‌تر پیشنهاد می‌دهد که حدس من از یک دیتاست غنی را محترم بگذارند و در عین حال مشکل فنی زمینه‌ای که منفجر می‌شود را حل کنند.

اصل ساده است و به صورت مستقیم از الگو الهام می‌گیردذخیره‌سازی داغ/گرم/سردبه مدیریت بایگانی اعمال شده :

  • گرم (EAGER)= 10 جلسه آخر در INDEX, PROMPT_REPRISE از جلسه N+1، 2 فایل آخر جلسه

  • گرم (کسل)= SESSIONS_HISTORY اخیر, SCRIPT_VERIFICATION, تمام مستندات مرجع

  • سرد(پشتیبان/)= همه چیز دیگر، جابه‌جا شدهسالم, بدون تبدیل، بدون باز نمایه‌سازی

----
----
----
----
.agents/
├── INDEX.adoc                         → Sessions N-9 à N (10 dernières)
├── SESSIONS_HISTORY.adoc              → Sessions N-9 à N
├── SCRIPT_VERIFICATION.adoc           → Dernière vérif (pas d'historique)
├── PROMPT_REPRISE.adoc                → Session N+1 uniquement
├── sessions/                          → Sessions N-1 à N uniquement
└── backup/
    └── Y2026-sessions-001-039/          ← Vague froide, COPIE INTÉGRALE
        ├── INDEX.adoc                  → Sessions 001 à 039 (complet)
        ├── SESSIONS_HISTORY.adoc       → Sessions 001 à 039 (complet)
        ├── COMPLETED_TASKS_ARCHIVE.adoc → Sessions 001 à 039 (complet)
        └── sessions/                   → 001.adoc, 002.adoc...
----

کلید مکانیزم:**بکاپ یک شاخص مرکزی نیست؛ یک کپی دقیق از موج گذشته است.**. وقتی که از آستانه 10 جلسه فعال عبور می‌کنیم، چیزی را حذف نمی‌کنیم. کاری را reindex نمی‌کنیم. کاری را ادغام نمی‌کنیم. بسته فایل‌های agentes را همان‌طور که در جلسه N-10 بود، می‌گیریم و آن را جابه‌جا می‌کنیم در`backup/`.

فایل‌های فعال خود تقطیع شده‌اند:

* INDEX : فقط 10 خط آخر (پنجره لغزشی)
* SESSIONS_HISTORY : همان
* COMPLETED_TASKS_ARCHIVE : فایل جدید برای دوره جاری
* sessions/ : فقط دو جلسه اخیر

[plantuml, format=svg, id=diag-hot-warm-cold, alt="Architecture Hot/Warm/Cold du contexte agent — EAGER/LAZY/backup"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title معماری Hot / Warm / Cold از عامل Context
package "HOT (EAGER)\nبارگذاری خودکار\n~300 خط" as HOT #FFCDD2 {
  file "INDEX.adoc\n(10 sessions)" as IDX_HOT
  file "PROMPT_REPRISE\n(جلسه N+1)" as PRO_HOT
  file "AGENT.adoc\n(قوانین مطلق)" as AG_HOT
}

package "WARM (LAZY)\nبارگذاری بر حسب درخواست\nتقریبا ۵۰۰ خط" as WARM #FFF9C4 {
  file "SESSIONS_HISTORY\n(10 آخرین)" as HIS_WARM
  file "SCRIPT_VERIFICATION\n(آخرین)" as VER_WARM
  file "PROCEDURES.adoc\n(templates)" as PRO_WARM
  file "*_REFERENCE.adoc\n(مستند فنی)" as REF_WARM
}

package "COLD (backup/)\nهرگز بارگذاری نشده\nفقط برای خواندن توسط انسان" as COLD #BBDEFB {
  folder "Y2026-001-039/" as WAVE {
    file "فهرست (کامل)" as IDX_COLD
    file "SESSIONS_HISTORY\n(کامل)" as HIS_COLD
    file "COMPLETED_TASKS\n(کامل)" as ARCH_COLD
    folder "جلسات/ (001-039)" as SESS_COLD
  }
  folder "Y2026-040-???\n(future)" as FUTURE
}

HOT --> WARM : "نماینده بالا می‌رود\nاگر لازم باشد"
WARM --> COLD : "هرگز خودکار نیست\nانسان تنها به آنجا می‌رود"

note bottom of COLD
  Règle : COPIE INTÉGRALE
  Pas de transformation
  Pas de réindexation
  Read-only après archivage
end note

@enduml
----

سود فوری بسیار زیاد است: منطق EAGER از**~5200 تا ~300 خط**. یک تقسیم بر ۱۷. بدون اینکه حتی یک خط داده تاریخی از دسترفته باشد.

== چرا این یک جعبه‌ی הכל نیست

عامل، در تکرار اول خود، ترسید که`backup/`به یک جعبه سیاه تبدیل شود — یک پوشه‌ای که در آن فایل‌هایی که هرگز دوباره نخوانده می‌شوند را اندازیم. این ترس قانونی است. اما این بر یک سردرگمی استوار است.

یک جعبه‌ی همه‌چیز این است وقتی که ما فایل‌ها را می‌اندازیم.**بدون ساختار، بدون عرف، بدون منطق گروه‌بندی**. اینجا، بکاپ بر اساس دوره (Y2026-001-039) ساختار یافته است، و هر پوشه بکاپ شامل است**ساختار یکسان**که پرونده`.agents/`فعال : INDEX, SESSIONS_HISTORY, COMPLETED_TASKS_ARCHIVE, sessions/.

این یک جورجور نیست. این یک**عکس لحظه‌ای با مهر زمانی**. می‌توانست حتی گفت که این یک مکانیسم ساده‌سازی‌شده‌ی نسخه‌بندی است — به این نکته که فایل‌ها را به‌صورت جداگانه نسخه‌بندی نمی‌کند، بلکه بسته کامل حاکمیت را در یک لحظه T نسخه‌بندی می‌کند.

وقتی می‌خواهید اطلاعات قدیمی را بازیابی کنید، نیازی به یک فهرست مرکزی ندارید. دو گزینه دارید :

1. **grep` مستهدف** : `grep -r "zsh" backup/Y2026-001-039/`— و شما تمام چیزی که zsh را در آن دوره ذکر می‌کند را پیدا می‌کنید، به هر لحاظ (INDEX, SESSIONS_HISTORY, آرشیو جلسه).
2. **بازگشت دستی**: شما موقتاً پوشه بکاپ را در زمینه فعال کپی می‌کنید، و از عامل می‌خواهید این دوره خاص را تحلیل کند.

اندیس ضمنی است. او در ساختار خود فایل‌ها است — هر فایل از قبل یک اندیس است که از زاویه خودش است.

== استعاره‌ی قفسه‌ها

برای اینکه Mekanizem بديهي شود، من آن را به صورت سه شفه مفهومی طراحی کردم:

* **رف ۱ (EAGER)**— برنامه کار. چه چیزی که من نیاز دارم *الاکنون*. INDEX اخیر, PROMPT_REPRISE, قوانین مطلق. کاهف، فوری، بحرانی.
* **قفسه 2 (LAZY)**— کتابخانه مشاوره‌ای. چیزی که می‌توانم به‌صورت در دسترس جستجو کنم. مراجع فنی، تاریخچهٔ اخیر، رویه‌ها. بزرگ‌تر اما در حافظه بارگذاری نشده است.
* **غار (backup/)**— آرشیوهای سرد. هرچیزی که گذشته است اما من نمی‌خواهم آن را بگذارم. عامل هرگز وارد آن مکان نمی‌شود. انسان وقتی می‌خواهد дистилاسیون انجام دهد، به پایین آن مکان می‌رود.

نمایندهٔ در ابتدا یک قافهٔ چهارم پیشنهاد داد — یک`index-backup.adoc`که LAZY باشد و یک فهرست محتوا برای همهٔ بکاپ داشته باشد. من آن را رد کردم. این یک تکرار اضافی در یک سیستمی خواهد بود که از قبل تحت رشد خطی قرار دارد. ساختار فایل‌های بایگانی‌شده پیشاً یک ایندکس است.

== سنسور دوтриگر

مفهوم‌سازی محکم بود، اما یک نقطهٔ کور باقی مانده بود:**دقیقاً چه زمانی دوران را شروع کردن ؟**مقاله اولیه آن را به‌عنوان یک سؤال باز شناسایی کرد. دو روز بعد، پاسخ در فایل‌های حکمرانی شش پروژه کدگذاری شد: یک سنسور با دو trigger.

=== تلقای خودکار — `N % 10 == 0

عامل اول ریاضی است. وقتی شماره جلسه مضربی از ۱۰ باشد — جلسه ۱۰، ۲۰، ۳۰، ۴۰ — چرخش بکاپ به‌طور خودکار در پروسیجر پایان جلسه اجرا می‌شود، دقیق پس از گام ۶.

چرا ۱۰؟ این تعادلی بین دو نیروی متضاده است: یک پنجره بسیار کوتاه (۵ جلسه) زمینه لازم برای استمرار را از دست می‌دهد؛ یک پنجره بسیار طولانی (۲۰ جلسه) مشکل تشدید زمینه را حل نمی‌کند. ده جلسه، با نرخ یک تا دو جلسه در روز، تقریباً یک هفته کار را پوشش می‌دهند — کافی است که العامل تصمیمات اخیر را به یاد داشته باشد، اما کافی نیست تا زمینه به درجة burst (متفجر) شود.

=== مُحرّك آستانه‌ای — 500 خط EAGER

دومین trigger پویاست. صرف‌نظر از شماره جلسه، اگر فایل‌های EAGER جمع‌آوری‌شده exceeds**500 خط**, چرخش فعال می‌شود.

این آستانه در برابر سناریویی محافظت می‌کند که در آن جلسات به‌طور فوق‌العاده تولیدی هستند — بسیاری از محتوای نوشته شده در چند جلسه. یک جلسه که 120 خط محتوا编یت تولید می‌کند، COMPLETED_TASKS_ARCHIVE را به‌طور بسیار سریع‌تر نسبت به یک جلسه دیباگ که دو خط را رفع می‌کند، افزایش می‌دهد. آستانه 500 خط، که از طریق`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`, این ناهمگونی را می‌گیرد.

=== триггер دستی — "rotation backup

در نهایت، انسان کنترل را دارد. کلیدواژگان`rotation backup`, `backup rotation` ou `lance la rotation backup`به درخواست، این رویه را آغاز می‌کنند، صرف‌نظر از پایان جلسه. کاربردی است وقتی احساس می‌کنید که وضعیت سنگین می‌شود اما هنوز به مضرب ۱۰ نرسیده‌اید، یا وقتی می‌خواهید یک فاز کار را قبل از شروع یک فاز جدید بایگانی کنید.

[plantuml, format=svg, id=diag-capteur-trigger, alt="Les trois déclencheurs du capteur de rotation backup — automatique, seuil, manuel"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title سنسور چرخش پشتیبان — سه ترگر
start

:Procédure de fin de session;
note right: Mots-clés "پایان جلسه"\nou "در اینجا متوقف می‌شویم"

:Étapes 1 à 6\n(archivage standard);
note right
  1. Archive sessions/N.adoc
  2. MAJ PROMPT_REPRISE
  3. MAJ SESSIONS_HISTORY
  4. MAJ INDEX.adoc
  5. MAJ TEST_COVERAGE
  6. MAJ COMPLETED_TASKS
end note

if (N % 10 == 0\nOU\nEAGER cumulé > 500 lignes ?) then (oui)
  :⚙️ Rotation Backup\n(étape 7);
  note right
    1. Créer backup/Y20XX-sessions-X-Y/
    2. Copier intégrale INDEX + HISTORY
       + COMPLETED_TASKS + sessions/
    3. Tronquer actifs à 10 sessions
    4. Ajouter _Localisation active_
  end note
else (non)
  :Pas de rotation;
endif

:Checklist [✅] x 7\n(si applicable);

stop

@enduml
----

این نمودار قرارگیری دقیق سنسور در روش پایان جلسه را نشان می‌دهد. مرحله 7 اختیاری است — فقط در صورتی اجرا می‌شود که یکی از دو شرط صحیح باشد — اما به‌طور منظم *بررسی* می‌شود. فهرست نهایی شامل`[✅] 7. Backup roté (si applicable)`.

=== دور بسته

این سنسور حلقه‌ای که توسط مقاله قبلی باز شده بود را می‌بندد. حکمگیری ایگر/لازی مشکل حافظه عامل بین دو جلسه را حل کرده بود. مekانیزم Hot/Warm/Cold مشکل حافظه‌ای که در حال رشد است را حل کرده بود. سنسور دو-trigger problem quand را حل می‌کند — بار ذهنی انسانی را از نظارت بر زمینه برمی‌دارد.

[plantuml, format=svg, id=diag-boucle-fermee, alt="Les trois couches de la gouvernance agent — Eager/Lazy, Hot/Warm/Cold, Capteur"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title سه لایه گویرننس عامل
left to right direction

package "لایه 1 — حافظه\n(ماده 0108)" as C1 #E8F5E9 {
  rectangle "**EAGER**\nداشبورد\nبارگذاری خودکار" as EAG
  rectangle "**LAZY**\nراهنمای مالک\nبارگذاری عند الطلب" as LAZ
  EAG -[hidden]right-> LAZ
}

package "لایه 2 — سختی\n(ماده 0110)" as C2 #FFF9C4 {
  rectangle "**HOT**\n10 جلسات فعال\n~300 خطوط" as HOT
  rectangle "**WARM**\nمراجع\nروش‌ها" as WRM
  rectangle "**COLD**\nbackup/\nموج خنک" as CLD
  HOT -[hidden]right-> WRM
  WRM -[hidden]right-> CLD
}

package "لایه 3 — عامل راه‌اندازی\n(امروز)" as C3 #BBDEFB {
  rectangle "**اتوماتیک**\nN % 10 == 0" as AUTO
  rectangle "**آستانه**\n> 500 lignes" as SEUIL
  rectangle "**Manuel**\nپشتیبان‌گیری چرخشی" as MAN
  AUTO -[hidden]right-> SEUIL
  SEUIL -[hidden]right-> MAN
}

C1 --> C2 : "khātere bāyzad\n→ yeki mekānizam lāzem ast\naz pirāyish"
C2 --> C3 : "سنخودگی\n→ نیاز به یک عامل تحریک‌کننده\nبرای اجرای آن"

note bottom of C3
  ✅ Déployé sur 6 projets
  magic-stick · bakery-gradle
  plantuml-gradle · cheroliv.com
  jhipster-gradle-plugins
  quizz-benchmark-gradle
end note

@enduml
----

سه لایه به‌طور منطقی بر یکدیگر قرار می‌گیرند. لایه اول حافظه‌ای به‌عامل می‌دهد. لایه دوم مانع می‌شود تا این حافظه عامل را سرکوب کند. لایه سوم نگهداری این حافظه را خودکار می‌سازد تا انسان نیازی به فکر کردن نداشته باشد.

=== مهاجرت مؤثر روی cheroliv.com

مکانیسم نظری نماند. روی`cheroliv.com`، اولین چرخش بکاپ اجرا شد در ۲۹ آوریل ۲۰۲۶ — جلسات -6 تا 2 منتقل شدند به`.agents/backup/Y2026-sessions-neg6-a-002/`:

|===
|فایل |قبل از چرخش |پس از چرخش |سود |`.agents/INDEX.adoc` |19 جلسه فهرست شده |10 جلسه (3-12) |-9 ورودی |`.agents/SESSIONS_HISTORY.adoc` |18 جلسات |10 جلسات |-۸ ورودی |`COMPLETED_TASKS_ARCHIVE` |161 خط (جلسات 1-12) |135 خطوط (جلسات 3 تا 12) |-26 سطر |`sessions/` |20 فایل |10 فایل |-10 فایل |**پشتیبان/** |عدم وجود |1 موج سرد (10 جلسه بایگانی) |+1 بسته خنک
|===

افزایش در líneas — پروژه جوان است، 12 جلسه — اما مهم این است که**مکانیسم قرار دارد**. چرخش خودکار بعدی در جلسه 20 اجرا خواهد شد، یا زودتر اگر 500 خط EAGER وصول شود.

== درس انسان-Agent

این جلسه 048 به من چیزی اساسی دربارهٔ همکاری با یک عامل هوش مصنوعی یاد داد.

عامل یک گرایش طبیعی : او سعی می‌کند**بهینه‌سازی**, à **ساده‌سازی**, à **حذف تکرارات**. این یک طرفه‌ای است که یک سامانه آموزش‌دیده برای تولید پاسخ‌های تمیز و مختصر است. در مواجهه با یک dataset غنی و multidimensionnel، اولین بازخوردش این است که آن را به ساده‌ترین شکل کاهش دهد.

انسان، او، حدس متفاوتی دارد: او حدس می‌کند که redundantای ساختاری یک**مزیت**, نه یک عیب. تنوع زاویه‌ها بر یک واقعیت یکسان دقیقاً همان چیزی است که بعداً distillation با کیفیت را ممکن می‌سازد.

نه این نیست که factor اشتباه دارد. بهینه‌اش برابر با بهینه من نیست. عامل برای بهینه‌سازی برای**حاضر**— زمینه فوری، پاسخ سریع به سؤال پرسیده‌شده. انسان برای بهینه‌سازی**آینده**— قدرت یافتن، تقاطع کردن، تقطیر کردن در سه ماه یا سه سال.

____ من می‌خواهم مواد خام باشد. فکرهایت، تردیدهایت، پاسخ‌های تو به سوالات من. نه، سنتز تو. سنتز، من می‌دانم که بهتر از تو می‌توانم آن را انجام دهم. من می‌خواهم مواد خام باشد. ____

این جمله‌ای که به او در پایان جلسه گفتم، همه چیز را خلاصه می‌کند. عامل یک ابزار تولید است. انسان یک ابزار تقطیر است. حکومت نه برای این است که عامل بتواند به تنهایی همه چیز را درک کند، بلکه برای این است که انسان بتواند، در آینده، materیال تولید شده را پردازش کند.

موج سرد یکسان ترجمهٔ معماری این فلسفه است: هیچ چیز را پرت نمی‌کنیم، هیچ چیز را ادغام نمی‌کنیم، هیچ چیز را دوباره indexing نمی‌کنیم. بسته‌ی سالم جابجا می‌شود. distillation بعداً به‌صورت دستی توسط انسان انجام می‌شود.

== ادامه منطقی مقاله قبلی

اگر شما خوانده‌ایدlink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[مقاله دربارهٔ استراتژی Eager/Lazy], شما پیشرفت طبیعی را می‌شناسید :

1. **ماده 0108**— حکمگشای Eager/Lazy : *چگونه* ساختاردهی کنیم به محیط عامل در دو سطح از دسترسی
2. **این مقاله 0110**مekanizme بک‌آپ: *چطور* این زمینه را پیر کند بدون از دست دادن آن وقتی که بسیار حجیم می‌شود

مقاله اول به این سؤال پاسخ می‌داد: « عامل بین دو جلسه چیزی را به خاطر ندارد، چگونه می‌توانیم به آن حافظه بدهیم؟

این به سؤالی که به‌طور حتمی از اولین سؤال پیش می‌آید، پاسخ می‌دهد: « حافظه در هر نشست بزرگتر می‌شود؛ چگونه می‌توان آن را از خنق شدن factor بدون حذف آن جلوگیری کرد؟

پاسخ شامل یک algوست :**بسیار گرم/گرم/سرد**, اعمال‌شده بر روی فایل‌های حکمرانی. و در یک اصل :**هرگز چیزی را گم نکن، همیشه همه چیز را جابه‌جا کن**.

== لینک‌ها

* مقاله قبلی :link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[قوه‌گذاری یک عامل هوش مصنوعی با AsciiDoc]
* سایتم : https://cheroliv.com
* پروژه`magic-stick`: https://github.com/cheroliv/magic-stick

---

*یک sistem مدیریت خوب داده‌ها را هرگز حذف نمی‌کند؛ آن‌ها را سازماندهی می‌کند.*
----
----

کلید مکانیسم:**بک‌آپ یک ایندکس مرکزی نیست، بلکه یک کپی دقیق از موج گذشته است**. وقتی از افق ۱۰ نشست فعال فراتر می‌رویم، هیچ‌چیزی حذف نمی‌شود. هیچ‌چیزی بازاندیسه (reindex) نمی‌شود. هیچ‌چیزی ادغام نمی‌شود. بسته فایل‌های ایجنت را همان‌طور که در نشست N-10 بود برمی‌داریم و به داخل انتقال می‌دهیم`backup/`لطفاً متن مورد نظر خود را برای ترجمه ارسال کنید.

فایل‌های فعال، اما، قطع شده‌اند:

* شاخص: فقط ۱۰ سطر آخر (پنجره لغزان)
* SESSIONS_HISTORY : همانند قبلی
* COMPLETED_TASKS_ARCHIVE : فایل جدید برای دوره جاری
* sessions/ : فقط ۲ جلسه اخیر

[plantuml, format=svg, id=diag-hot-warm-cold, alt="Architecture Hot/Warm/Cold du contexte agent — EAGER/LAZY/backup"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title معماری Hot / Warm / Cold زمینه عامل
package "HOT (EAGER)\nبارگذاری خودکار\n~۳۰۰ خط" as HOT #FFCDD2 {
  file "INDEX.adoc\n(۱۰ جلسه)" as IDX_HOT
  file "PROMPT_REPRISE\n(جلسه N+1)" as PRO_HOT
  file "AGENT.adoc\n(قوانین مطلق)" as AG_HOT
}

package "WARM (LAZY)\nبارگذاری در صورت درخواست\n~۵۰۰ خط" as WARM #FFF9C4 {
  file "SESSIONS_HISTORY\n(۱۰ مورد اخیر)" as HIS_WARM
  file "SCRIPT_VERIFICATION\n(آخرین مورد)" as VER_WARM
  file "PROCEDURES.adoc\n(الگوها)" as PRO_WARM
  file "*_REFERENCE.adoc\n(مستند فنی)" as REF_WARM
}

package "COLD (backup/)\nهرگز بارگذاری نمی‌شود\nفقط برای خوانش انسانی" as COLD #BBDEFB {
  folder "Y2026-001-039/" as WAVE {
    file "INDEX (کامل)" as IDX_COLD
    file "SESSIONS_HISTORY\n(کامل)" as HIS_COLD
    file "COMPLETED_TASKS\n(کامل)" as ARCH_COLD
    folder "sessions/ (001-039)" as SESS_COLD
  }
  folder "Y2026-040-???\n(آینده)" as FUTURE
}

HOT --> WARM : "عامل در صورت نیاز\nبازمی‌گرداند"
WARM --> COLD : "هرگز خودکار نیست\nانسان به تنهایی مراجعه می‌کند"

note bottom of COLD
قانون: کپی کامل
بدون تغییر
بدون بازاندیس‌گذاری (reindexing)
فقط خواندنی پس از آرشیو کردن
end note

@enduml
----

بهره‌ی فوری بسیار زیاد است: بافت EAGER از**حدود ۵۲۰۰ خط به حدود ۳۰۰ خط**. تقسیم بر ۱۷. بدون از دست دادن حتی یک خط از داده‌های تاریخی.

== چرا این یک ظرف همه‌کاره نیست

عامل، در اولین تکرار خود، می‌ترسید که`backup/`به یک جعبه سیاه تبدیل شود — پوشه‌ای که فایل‌هایی را که هرگز دوباره خوانده نمی‌شوند در آن می‌ریزیم. این ترسی به‌جا است، اما بر پایه یک سردرگمی است.

یک «کیسه همه-چی» (fourre-tout) زمانی است که فایل‌ها را رها می‌کنیم**بدون ساختار، بدون قرارداد، بدون منطق گروه‌بندی**. در اینجا، بک‌آپ بر اساس دوره (Y2026-001-039) ساختاریافته است و هر پوشه بک‌آپ شامل**همان ساختار**که پرونده`.agents/`فعال: `INDEX`, `SESSIONS_HISTORY`, `COMPLETED_TASKS_ARCHIVE`, `sessions/`.

این یک کیسه همه‌کاره نیست. این یک**اسنپ‌شات زمان‌دار شده**حتی می‌توان گفت که این یک مکانیسم نسخه‌بندی (versioning) ساده‌شده است — با این تفاوت که فایل‌ها را به‌صورت مجزا نسخه‌بندی نمی‌کند، بلکه کل بسته حاکمیت را در یک لحظه T نسخه‌بندی می‌کند.

وقتی می‌خواهید اطلاعات قدیمی را بازیابید، نیازی به یک نمایه مرکزی ندارید. شما دو گزینه دارید:

1. **grep` هدفمند**لطفاً متن مورد نظر خود را وارد کنید تا ترجمه شود.`grep -r "zsh" backup/Y2026-001-039/`— و هر چیزی که در آن بازه زمانی به `zsh` اشاره کند، از هر زاویه‌ای که باشد (INDEX، SESSIONS_HISTORY، آرشیو نشست)، پیدا می‌کنید.
2. **بازگردانی دستی**: شما موقتاً پوشه‌ی پشتیبان (backup) را در بافت فعال کپی می‌کنید و از عامل (agent) می‌خواهید که این بازه‌ی زمانی خاص را تحلیل کند.

اندکس ضمنی است. در خودِ ساختار فایل‌ها قرار دارد — به گونه‌ای که هر یک از آن‌ها پیشاپیش از زاویه دید خود یک اندکس است.

== استعاره‌ی قفسه‌ها

برای بصری کردن این مکانیزم، آن را در قالب سه قفسه مفهوم‌سازی کردم:

* **قفسه ۱ (EAGER)**— نقشه کاری. چیزی که *هم‌اکنون* به آن نیاز دارم. INDEX اخیر، PROMPT_REPRISE، قوانین مطلق. سبک، فوری، حیاتی.
* **قفسه ۲ (LAZY)**— کتابخانه‌ی مرجع. چیزهایی که می‌توانم در صورت درخواست بازیابی کنم. مراجع فنی، تاریخچه‌ی اخیر، دستورالعمل‌ها. حجیم‌تر، اما در حافظه بارگذاری نشده است.
* **Cave (backup/)**— آرشیوهای سرد. هر آنچه گذشته است اما نمی‌خواهم دور بریزم. ایجنت هرگز به آنجا وارد نمی‌شود. انسان هرگاه بخواهد تقطیر کند، به آنجا می‌رود.

کارگزار در ابتدا یک قفسه چهارم را پیشنهاد کرد — یک`index-backup.adoc`که `LAZY` باشد و شامل فهرست مطالب تمام بک‌آپ باشد. من رد کردم. این یک افزونگی دیگر در سیستمی خواهد بود که همین حالا هم از رشد خطی رنج می‌برد. ساختار فایل‌های آرشیو شده در حال حاضر خود یک ایندکس است.

== سنسور دو ماشه‌ای

مفهوم‌سازی محکم بود، اما یک نقطه کور باقی مانده بود:**دقیقاً چه زمانی چرخش را فعال کنیم؟**مقاله اولیه آن را به عنوان یک مسئله باز شناسایی کرده بود. دو روز بعد، پاسخ در فایل‌های حاکمیتی شش پروژه کدگذاری شد: یک حسگر با دو ماشه.

=== ماژیک خودکار — `N % 10 == 0

اولین محرک ریاضی است. وقتی شماره جلسه مضربی از ۱۰ باشد — جلسه ۱۰، ۲۰، ۳۰، ۴۰ — چرخش backup به‌طور خودکار در چارچوب رویه پایان جلسه، درست بعد از مرحله ۶ اجرا می‌شود.

چرا ۱۰؟ این یک مصالحه بین دو نیروی متضاد است: یک پنجره بیش از حد کوتاه (۵ جلسه) بافت لازم برای تداوم را از دست می‌دهد؛ یک پنجره بیش از حد طولانی (۲۰ جلسه) مشکل حجیم شدن بافت را حل نمی‌کند. ده جلسه، با ریتم یک تا دو جلسه در روز، تقریباً یک هفته کاری را پوشش می‌دهد — به اندازه‌ای که عامل تصمیمات اخیر را به خاطر بسپارد، و نه آنقدر زیاد که بافت منفجر شود.

=== محرک آستانه‌ای — ۵۰۰ خط `EAGER

محرک دوم پویا است. صرف‌نظر از شماره نشست، اگر مجموع فایل‌های EAGER از**۵۰۰ خط**، چرخش آغاز می‌شود.

این آستانه در برابر سناریویی که در آن نشست‌ها به‌طور استثنایی بهره‌ور هستند — محتوای زیاد نوشته شده در نشست‌های کم — محافظت می‌کند. نشستی که ۱۲۰ خط محتوای تحریری تولید می‌کند، `COMPLETED_TASKS_ARCHIVE` را بسیار سریع‌تر از نشستی برای دیباگ که دو خط را اصلاح می‌کند، بزرگ می‌کند. آستانه ۵۰۰ خط، که از طریق`wc -l .agents/INDEX.adoc .agents/archives/COMPLETED_TASKS_ARCHIVE_*.adoc PROMPT_REPRISE.adoc`، این عدم تقارن را جذب می‌کند.

=== راه انداز دستی — "rotation backup

در نهایت، کنترل در دست انسان باقی می‌ماند. کلمات کلیدی`rotation backup`, `backup rotation` ou `lance la rotation backup`رویه را در صورت درخواست، مستقل از پایان نشست، فعال می‌کنند. این قابلیت زمانی مفید است که احساس کنید بافت (context) بیش از حد سنگین شده اما هنوز به مضرب ۱۰ نرسیده‌اید، یا زمانی که می‌خواهید یک مرحله از کار را پیش از شروع مرحله‌ای جدید، آرشیو کنید.

[plantuml, format=svg, id=diag-capteur-trigger, alt="Les trois déclencheurs du capteur de rotation backup — automatique, seuil, manuel"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title سنسور چرخش پشتیبان — سه محرک
start

:Procédure de fin de session;
note right: Mots-clés "پایان نشست"\nou "همین‌جا متوقف می‌شویم"

:Étapes 1 à 6\n(archivage standard);
note right
1. آرشیو جلسات/N.adoc
2. به‌روزرسانی `PROMPT_REPRISE`
3. به‌روزرسانی `SESSIONS_HISTORY`
4. به‌روزرسانی `INDEX.adoc`
5. به‌روزرسانی `TEST_COVERAGE`
6. به‌روزرسانی `COMPLETED_TASKS
end note

if (N % 10 == 0\nOU\nEAGER cumulé > 500 lignes ?) then (oui)
  :⚙️ Rotation Backup\n(étape 7);
  note right
۱. ایجاد backup/Y20XX-sessions-X-Y/
۲. کپی کامل INDEX + HISTORY
+ COMPLETED_TASKS + sessions/
۳. کوتاه کردن فعال‌ها به ۱۰ جلسه
۴. افزودن _Localisation active_
  end note
else (non)
  :Pas de rotation;
endif

:Checklist [✅] x 7\n(si applicable);

stop

@enduml
----

این نمودار جایگذاری دقیق حسگر در رویه پایان جلسه را نشان می‌دهد. مرحله ۷ اختیاری است — یعنی تنها در صورتی اجرا می‌شود که یکی از دو شرط برقرار باشد — اما به‌طور سیستماتیک *بررسی* می‌شود. چک‌لیست نهایی شامل`[✅] 7. Backup roté (si applicable)`لطفاً متن مورد نظر برای ترجمه را ارسال کنید.

=== حلقه بسته

این حسگر حلقه بازی را که در مقاله قبلی باز شده بود، می‌بندد. حاکمیت Eager/Lazy مشکل حافظه عامل بین دو نشست را حل کرده بود. مکانیزم Hot/Warm/Cold مشکل رشد حافظه را حل کرد. حسگر با دو ماشه، مشکل «چه زمانی» را حل می‌کند — و بار ذهنی نظارت بر اندازه بافت (context) را از دوش انسان برمی‌دارد.

[plantuml, format=svg, id=diag-boucle-fermee, alt="Les trois couches de la gouvernance agent — Eager/Lazy, Hot/Warm/Cold, Capteur"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title سه لایه حاکمیت عامل
left to right direction

package "لایه ۱ — حافظه\n(ماده 0108)" as C1 #E8F5E9 {
  rectangle "**EAGER**\nداشبورد\nبارگذاری خودکار" as EAG
  rectangle "**LAZY**\nدفترچه راهنمای مالک\nبارگذاری در صورت درخواست" as LAZ
  EAG -[hidden]right-> LAZ
}

package "لایه ۲ — قدیمی شدن\n(ماده 0110)" as C2 #FFF9C4 {
  rectangle "**HOT**\n۱۰ نشست فعال\n~۳۰۰ خط" as HOT
  rectangle "**WARM**\nمراجع\nرویه ها" as WRM
  rectangle "**COLD**\nbackup/\nموج سرد" as CLD
  HOT -[hidden]right-> WRM
  WRM -[hidden]right-> CLD
}

package "لایه ۳ — محرک\n(امروز)" as C3 #BBDEFB {
  rectangle "**Auto**\nN % 10 == 0" as AUTO
  rectangle "**Seuil**\n> ۵۰۰ خط" as SEUIL
  rectangle "**Manuel**\nچرخش پشتیبان" as MAN
  AUTO -[hidden]right-> SEUIL
  SEUIL -[hidden]right-> MAN
}

C1 --> C2 : "حافظه رشد می‌کند\n← به یک مکانیسم\nقدیمی شدن نیاز است"
C2 --> C3 : "قدیمی شدن\n← به یک محرک\nبرای اجرای آن نیاز است"

note bottom of C3
✅ مستقر شده در ۶ پروژه
`magic-stick` · `bakery-gradle`
`plantuml-gradle` · `cheroliv.com`
`jhipster-gradle-plugins`
`quizz-benchmark-gradle
end note

@enduml
----

این سه لایه به‌طور منطقی روی هم قرار می‌گیرند. لایه اول به عامل حافظه می‌دهد. لایه دوم مانع از آن می‌شود که این حافظه عامل را خفه کند. لایه سوم نگهداری از این حافظه را خودکار می‌کند تا انسان نیازی به فکر کردن به آن نداشته باشد.

=== مهاجرت نهایی در cheroliv.com

این مکانیسم تئوریک باقی نماند. در`cheroliv.com`، اولین چرخش پشتیبان در ۲۹ آوریل ۲۰۲۶ اجرا شد — نشست‌های 6- تا 2 به انتقال به`.agents/backup/Y2026-sessions-neg6-a-002/`لطفاً متن مورد نظر برای ترجمه را وارد کنید.

|===
|فایل |پیش از چرخش |پس از چرخش |بهره |`.agents/INDEX.adoc` |۱۹ جلسه لیست شده است |۱۰ جلسه (۳-۱۲) |۹ ورودی- |`.agents/SESSIONS_HISTORY.adoc` |۱۸ جلسه |۱۰ جلسه |۸ ورودی- |`COMPLETED_TASKS_ARCHIVE` |۱۶۱ خط (جلسات ۱-۱۲) |۱۳۵ خط (جلسات ۳-۱۲) |۲۶- خط |`sessions/` |۲۰ فایل |۱۰ فایل |-۱۰ فایل |**پشتیبان/** |موجود نیست |۱ موج سرد (۱۰ جلسه آرشیو شده) |+۱ بسته یخ
|===

بهبود در تعداد خطوط ناچیز بود — پروژه نوپاست، ۱۲ جلسه — اما نکته مهم این است که**مکانیزم برقرار است**. چرخش خودکار بعدی در نشست ۲۰، یا زودتر در صورت رسیدن به ۵۰۰ خط `EAGER` فعال خواهد شد.

== درس انسان-عامل

این جلسه `048` چیز بنیادی‌ای درباره همکاری با یک عامل هوش مصنوعی به من آموخت.

عامل دارای یک سوگیری طبیعی است: او تلاش می‌کند تا**بهینه‌سازی کردن**, à **ساده‌سازی کردن**, à **حذف موارد تکراری**. این سوگیریِ سیستمی است که برای تولید پاسخ‌های تمیز و مختصر آموزش دیده است. در مواجهه با یک مجموعه داده غنی و چندبعدی، اولین واکنش آن این است که آن را به ساده‌ترین شکل ممکن تقلیل دهد.

انسان اما شهود متفاوتی دارد: او احساس می‌کند که افزونگی ساختاریافته یک**مزیت**، نه یک نقص. بلکه تنوع زوایای دید نسبت به یک واقعیت واحد، دقیقاً همان چیزی است که بعدها امکان یک تقطیر باکیفیت را فراهم می‌کند.

مسئله این نیست که عامل اشتباه می‌کند. بلکه مسئله این است که «بهینه»‌ی او با مال من یکی نیست. عامل برای ... بهینه‌سازی می‌کند**حاضر**— زمینه فوری، پاسخ سریع به سؤال مطرح شده. انسان برای ... بهینه می‌کند**آینده**— توانایی بازیابی، تطبیق و پالایش در سه ماه یا سه سال آینده.

لطفاً متن مورد نظر خود را برای ترجمه ارسال کنید. آنچه من می‌خواهم، مواد خام است. افکار تو، تردیدهای تو، پاسخ‌های تو به سوالات من. نه سنتز تو. سنتز را من بهتر از تو بلد هستم. من ماده اولیه را می‌خواهم. لطفاً متن مورد نظر خود را برای ترجمه ارسال کنید.

این جمله‌ای که در پایان جلسه به او گفتم، همه چیز را خلاصه می‌کند. عامل یک ابزار تولید است. انسان ابزار تقطیر است. حاکمیت برای این نیست که عامل همه چیز را به تنهایی بفهمد — بلکه برای این است که انسان بتواند بعداً روی متریال تولید شده کار کند.

موج سرد مشابه، ترجمه‌ی معماری این فلسفه است: هیچ‌چیز دور ریخته نمی‌شود، هیچ‌چیز ادغام نمی‌شود و هیچ‌چیز بازاندیسه نمی‌شود. بسته به‌صورت دست‌نخورده جابه‌جا می‌شود. پالایش، بعداً و به‌صورت دستی توسط انسان انجام خواهد شد.

== ادامه‌ی منطقی مقاله قبلی

اگر خوانده‌ایدlink:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[مقاله در مورد استراتژی `Eager/Lazy]، پیشرفت طبیعی را تشخیص خواهید داد:

1. **ماده ۰۱۰۸**— حاکمیت Eager/Lazy: *چگونه* بافت عامل (agent context) را در دو سطح در دسترس بودن ساختاردهی کنیم
2. **این مقاله 0110**— مکانیسم پشتیبان (backup): *چگونه* این بافتار (context) را بدون از دست دادن آن، در زمانی که بیش از حد حجیم می‌شود، قدیمی کنیم

اولین مقاله به این سؤال پاسخ می‌داد: «عامل بین دو نشست هیچ چیز را به خاطر نمی‌آورد، چگونه می‌توان به او حافظه داد؟

این مورد به سؤالی پاسخ می‌دهد که به‌طور اجتناب‌ناپذیری از سؤال اول حاصل می‌شود: «حافظه در هر جلسه افزایش می‌یابد، چگونه می‌توان از خفه شدن عامل جلوگیری کرد بدون آنکه حافظه پاک شود؟

پاسخ در یک الگو خلاصه می‌شود:**داغ/گرم/سرد**، که بر روی فایل‌های حاکمیتی اعمال شده است. و به عنوان یک اصل:**هرگز هیچ‌چیز را گم نکن، همیشه همه چیز را دوباره مکان‌یابی کن**لطفاً متنی را که می‌خواهید ترجمه شود ارسال کنید.

== پیوندها

* مقاله قبلی:link:/blog/2026/0108_gouvernance_agent_opencode_eager_lazy_post.html[مدیریت یک عامل هوش مصنوعی با `AsciiDoc]
* سایت من: https://cheroliv.com
* پروژه`magic-stick`: https://github.com/cheroliv/magic-stick

---

یک سیستم حاکمیتی خوب هرگز داده‌ها را حذف نمی‌کند، بلکه آن‌ها را بایگانی می‌کند.
----

مقالات مرتبط