Điều khiển Agent AI bằng AsciiDoc: Chiến lược Eager/Lazy của tôi cho các phiên Opencode không bị rò rỉ ngữ cảnh

@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

title Tiến triển của các Phiên — Từ Phiên 1 đến 150+
legend top
    |= Couleur |= Projet |
    | <#4CAF50> | cheroliv.com |
    | <#2196F3> | plantuml-plugin |
    | <#FF9800> | bakery-plugin |
    | <#9C27B0> | magic-stick |
endlegend

concise "Phiên hoạt động" as S

@S
0 is ".md thô"
1 is "Di chuyển\nAsciiDoc"
10 is "Eager/Lazy\nđã chính thức hóa"
62 is "Quy tắc an toàn\n(site.yml)"
87 is "Giải mã\nngữ cảnh"
109 is "Tối ưu hóa\n-60% token"
133 is "133 phiên\n240 bài kiểm tra PASS"

S@0 -> S@1 : Session 1\n(cheroliv.com)
S@1 -> S@10
S@10 -> S@62 : Session 62\n(plantuml-plugin)
S@62 -> S@87 : Session 87\n(Cry 4 help)
S@87 -> S@109 : Session 109\n(API Key Pool)
S@109 -> S@133 : Session 133\n(Aujourd'hui)

@enduml

@startuml
skinparam defaultTextAlignment center
skinparam wrapWidth 200

package "Gốc Dự án (Eager - Tự động tải)" {
    component "<b>AGENT.adoc</b>\nQuy tắc tuyệt đối\nCấu trúc & Quy ước" as AGENT
    component "<b>PROMPT_REPRISE.adoc</b>\nNhiệm vụ của phiên N\nTóm tắt N-1" as PROMPT
    component "<b>INDEX.adoc</b>\nĐiểm nhập\nQuy tắc + Phiên" as INDEX
    component "<b>*_ESSENTIALS.adoc</b>\nNgữ cảnh nghiệp vụ\nquan trọng" as ESS
}

package ".agents/ (Lazy - Tải khi yêu cầu)" {
    component "<b>sessions/N-*.adoc</b>\nLưu trữ chi tiết\nQuyết định & Kết quả" as SESS
    component "<b>SESSIONS_HISTORY.adoc</b>\nBảng tổng hợp\nNgày/Loại/Điểm" as HIST
    component "<b>PROCEDURES.adoc</b>\nTemplate cuối phiên\n6 bước\n" as PROC
    component "<b>*_REFERENCE.adoc</b>\nKiến trúc đầy đủ\nTham chiếu kỹ thuật" as REF
    component "<b>COMPLETED_TASKS_ARCHIVE</b>\nNhiệm vụ đã hoàn thành\nTheo tháng" as ARCH
    component "<b>AGENT_MODUS_OPERANDI.adoc</b>\nTài liệu chiến lược\nPhương pháp luận" as MOD
    component "<b>*_REFERENCE.adoc</b>\nBoot tests, phân vùng A/B\nNgữ cảnh cụ thể" as SPEC
}

AGENT --> PROMPT : "Tham chiếu"
AGENT --> INDEX : "Tham chiếu"
INDEX --> SESS : "Chỉ mục"
INDEX --> HIST : "Chỉ mục"
INDEX --> PROC : "Tham chiếu"
INDEX --> ARCH : "Tham chiếu"
INDEX --> REF : "Tham chiếu"
PROMPT --> SESS : "Lưu trữ N-1"
PROMPT --> ESS : "Ngữ cảnh nghiệp vụ N"

@enduml

----
| magic-stick    | Session 23 | SCRIPT_VERIFICATION.adoc | 2026-04-27 |
| bakery-gradle  | Session 11 | TEST_COVERAGE_ANALYSIS   | 2026-04-27 |
| cheroliv.com   | Session 9  | TEST_COVERAGE_ANALYSIS   | 2026-04-27 |
| plantuml-gradle| Session 133| TEST_COVERAGE_ANALYSIS   | 2026-04-23 |
| jhipster-gradle-plugins | Session 1 | TEST_COVERAGE_ANALYSIS | 2026-04-28 |
----

**`*_ESSENTIALS.adoc`** -- Một bổ sung gần đây (Session 109, plantuml-plugin) để tối ưu hóa hơn nữa ngữ cảnh Eager. Thay vì tải 200 dòng ngữ cảnh nghiệp vụ về pool khóa API, tôi tải 50 dòng thiết yếu, và 150 dòng còn lại vẫn ở chế độ LAZY trong`*_REFERENCE.adoc`Vui lòng cung cấp văn bản cần dịch.

Kết quả đo lường: chuyển từ**~25k token EAGER sang ~10k token**(tiết kiệm 60%). Tác nhân không còn cần các lời nhắc tiêu tốn năng lượng nữa.

==== Mắt Xích Còn Thiếu: `opencode.json

Tôi phải thú nhận với bạn một điều mà tôi suýt chút nữa đã quên ghi chép lại. Phía trên tất cả những tệp .adoc này, có một tệp JSON nhỏ xíu mà nếu không có nó thì không có gì hoạt động được. Nó tên là`opencode.json`và nó dài sáu dòng. Đúng nghĩa là sáu dòng.

[source,json]
----
{
  "$schema": "https://opencode.ai/config.json",
  "instructions": [
    "AGENT.adoc"
  ]
}
----

Chính tệp này là thứ nói với Opencode rằng: « Khi khởi động, hãy tải`AGENT.adoc`tự động. » Nếu không có nó, tác nhân là một trang giấy trắng chính xác như tôi đã mô tả ở đầu bài viết. Với nó, tác nhân đã nắm trong tay các quy tắc tuyệt đối, kiến trúc của dự án và các câu lệnh thiết yếu — ngay cả trước khi tôi nói lời chào.

Tôi đã tình cờ phát hiện ra tầm quan trọng của tệp này. Trên`bakery-plugin`, nó đã không tồn tại. Tôi tự hỏi tại sao tác nhân này lại luôn "lạc lối" trong dự án này hơn so với các dự án khác. Các quy tắc tuyệt đối thực sự nằm trong`AGENT.adoc`— nhưng`AGENT.adoc`chưa bao giờ được tải. Tác nhân chỉ đọc những gì tôi bảo nó đọc, một cách thủ công, trong mỗi phiên. Đó là phiên thứ 11 của`bakery-plugin`khi tôi nhận ra sự thiếu vắng của`opencode.json`. Tôi đã tạo nó — và phiên `12` đã bắt đầu như những phiên khác.

Tệp này giờ đây quá hiển nhiên đối với tôi đến mức tôi thậm chí không còn nghĩ về nó nữa. Một sai lầm điển hình của một lập trình viên quá am hiểu công cụ của mình. Giờ đây, tôi luôn tạo nó *trước*`AGENT.adoc`. Đó là viên gạch đầu tiên.

==== Tính lưỡng tính của `INDEX.adoc

Một điểm tinh tế khác đáng được làm rõ:`INDEX.adoc`sống tại`.agents/`— một thư mục mà tôi đã trình bày là `LAZY`. Tuy nhiên, tôi lại liệt kê nó là `EAGER` trong tất cả các bảng của mình. Có một sự mâu thuẫn rõ ràng ở đây.

Thực tế hiện trường: các tệp tin`.agents/INDEX.adoc`được tự động tải lên vào đầu phiên làm việc, tương tự như`AGENT.adoc` et `PROMPT_REPRISE.adoc`. Họ đang ở trong`.agents/`vì lý do tổ chức — không làm tràn ngập thư mục gốc — nhưng hành vi của chúng là EAGER.

Trên`plantuml-plugin`, `INDEX.adoc`dài 200 dòng và chứa các quy tắc tuyệt đối *đầy đủ* cùng với lịch sử của chúng (các bài học từ những phiên trước), các EPIC kèm theo điểm số, và danh mục dự án. Đây là tài liệu mà agent tham chiếu để biết « chúng ta đang ở đâu ». Trên`bakery-plugin`, nó dài 150 dòng với roadmap và các phiên gần đây.

Sự dư thừa có chủ đích giữa`AGENT.adoc` et `INDEX.adoc`có thể gây ngạc nhiên. Các quy tắc tuyệt đối hiện diện trong cả hai. Tại sao? Bởi vì chúng đáp ứng hai vai trò khác nhau: trong`AGENT.adoc`, chúng mang tính *giải thích* (cách kể chuyện của quy tắc, bài học rút ra); trong`INDEX.adoc`, chúng là *thực thi* (quy tắc thuần túy, không có giải thích, để tra cứu nhanh). Tác nhân đọc`AGENT.adoc`một lần để *hiểu*; anh ấy đọc lại`INDEX.adoc`cho mỗi phiên để *áp dụng*. Hai cách dùng, hai định dạng.

[plantuml, format=svg, id=diag-dualite-agent-index, alt="Comparaison entre AGENT.adoc (narratif) et INDEX.adoc (exécutif)"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center

title Tính song hành AGENT.adoc ←→ INDEX.adoc
left to right direction

rectangle "AGENT.adoc\n(Gốc — EAGER)" as AGENT #E3F2FD {
  rectangle "📖 **Định dạng Tường thuật**\nCách kể chuyện của quy tắc\nbài học rút ra, bối cảnh" as NARR
  rectangle "🏗️ **Kiến trúc Đầy đủ**\nCấu trúc dự án, các thành phần\nBacklog chi tiết US" as ARCHI
  rectangle "📋 **Quy tắc Giải thích**\nTại sao quy tắc tồn tại\nLịch sử sự cố" as EXPL
}

rectangle "INDEX.adoc\n(.agents/ — EAGER)" as INDEX #E8F5E9 {
  rectangle "⚡ **Định dạng Điều hành**\nQuy tắc thuần túy, không giải thích\nTra cứu nhanh" as EXEC
  rectangle "📊 **Roadmap & EPICs**\nBảng tổng hợp\nTiến độ, Điểm số, Ưu tiên" as ROAD
  rectangle "🌐 **Danh mục Dự án**\nXem xuyến ngang\n5 dự án được đồng bộ hóa" as PORT
}

AGENT --> INDEX : "Agent đọc AGENT.adoc\n1 lần để **hiểu**"
INDEX --> AGENT : "Agent đọc lại INDEX.adoc\nmỗi phiên để **áp dụng**"

note bottom of AGENT
Kích thước tối đa: 200 dòng
end note

note bottom of INDEX
Kích thước tối đa: 200 dòng
  Source de vérité en cas de divergence
end note

@enduml
----

Sự dư thừa có chủ đích này là một lựa chọn thiết kế. Nó tiêu tốn thêm khoảng 50 dòng token EAGER — nhưng nó đảm bảo rằng tác nhân luôn có các quy tắc ngay trước mắt, bao gồm cả định dạng súc tích giúp dễ dàng tuân thủ ngay lập tức.

=== Các Tệp LAZY: Hướng dẫn dành cho Chủ sở hữu

Các tệp này nằm trong`.agents/`và chỉ được đọc khi agent cần đến. Chúng tạo nên giá trị thực sự của phương pháp này, vì chúng tích lũy kiến thức về dự án mà không làm nhiễu ngữ cảnh hiện tại.

[plantuml, format=svg, id=diag-agents-tree, alt="Arborescence complète du dossier .agents/"]
----
@startuml
skinparam folderBackgroundColor #E3F2FD
skinparam folderBorderColor #1565C0
skinparam fileBackgroundColor #FFF3E0
skinparam fileBorderColor #EF6C00

folder ".agents/" as ROOT {
  file "INDEX.adoc\n(EAGER -- 200 dòng)" as IDX #E8F5E9
  file "AGENT_SESSION_MANAGER.adoc\n(Template phiên)" as ASM
  file "SESSION_CHECKLIST.adoc\n(Khi nào thay đổi)" as CHK
  file "PROCEDURES.adoc\n(6 bước + LAZY/EAGER)" as PRO
  file "SESSIONS_HISTORY.adoc\n(Tất cả các phiên)" as HIS

  folder "sessions/" as SESS {
    file "1-chore-migration.adoc" as S1
    file "109-formalisation-lazy.adoc" as S109 #FFECB3
    file "133-epic11-article.adoc" as S133
    file "... +130 khác" as SMORE
  }

  folder "archives/" as ARCH {
    file "COMPLETED_TASKS_2026-04.adoc" as CTA
    file "SESSIONS_HISTORY_83-95.adoc" as SHIST
    folder "sessions_summaries/" as SUM {
      file "SESSION_64_SUMMARY.adoc" as SU64
      file "SESSION_73_SUMMARY.adoc" as SU73
      file "..." as SUMORE
    }
    folder "prompts_archive/" as PARCH {
      file "PROMPT_REPRISE_S65.adoc" as PR65
      file "PROMPT_REPRISE_S75.adoc" as PR75
      file "..." as PMORE
    }
  }
}

IDX --> SESS : "Chỉ mục"
IDX --> HIS : "Chỉ mục"
IDX --> ARCH : "Tham chiếu"

note right of S109
Phiên 109 =
Hình thức hóa chiến lược
LAZY/EAGER
Token : ~25k → ~10k
end note

@enduml
----

Cấu trúc cây bên trên cho thấy cấu trúc thực tế của thư mục`.agents/`trên`plantuml-plugin`, dự án hoàn thiện nhất. Lưu ý độ sâu ba lớp: tệp gốc (siêu dữ liệu), thư mục`sessions/`(lưu trữ theo trình tự thời gian), và hồ sơ`archives/`(tổng hợp và tóm tắt). Chính chiều sâu này đã biến việc quản trị từ một tệp TODO đơn thuần thành một**bộ nhớ tổ chức đầy đủ**Vui lòng cung cấp văn bản tiếng Pháp cần dịch.

**.agents/sessions/{N}-{titre}.adoc**-- Các kho lưu trữ chi tiết của mỗi phiên. Hiện tại:

* `plantuml-plugin`Vui lòng cung cấp nội dung cần dịch.**133 phiên lưu trữ**(từ phiên 1 đến 133)
* `bakery-plugin`Vui lòng cung cấp văn bản cần dịch.**11 phiên**
* `magic-stick`Vui lòng cung cấp văn bản cần dịch.**23 phiên**
* `cheroliv.com`Hãy cung cấp văn bản cần dịch.**9 phiên chính thức**+ 7 phiên trước hệ thống được khôi phục hồi tố

Mỗi bản lưu trữ chứa toàn bộ ngữ cảnh của phiên làm việc, các quyết định đã đưa ra, các vấn đề gặp phải và cách giải quyết, các câu lệnh đã thực thi và output của chúng.

**.agents/SESSIONS_HISTORY.adoc**-- Một bảng tổng hợp tất cả các phiên với một điểm số. Ví dụ về`cheroliv.com`Vui lòng cung cấp văn bản cần dịch.

| -6 | 2025-05 | chore | Initialisation projet Gradle/JBake | 7/10
|  1 | 2026-04-25 | chore | Migration gouvernance agent | 8/10
|  7 | 2026-04-27 | debug/fix | Correction publishSite | 9/10
|  8 | 2026-04-27 | analyse | Analyse article 0108 | 7/10

----
{N}-{type}-{sujet-kebab-case}.adoc
----

Ví dụ cụ thể:

* `1-chore-migration-gouvernance-agent.adoc`— phiên 1, loại chore
* `10-solidification-tests.adoc`— phiên 10, không có kiểu tường minh (chủ thể là đủ)
* `036-debug-graphify-symlink-epic9.adoc`— phiên 36 với số gồm 3 chữ số để phân loại

Số phiên là tiêu chí sắp xếp chính. Các dự án sử dụng số có 3 chữ số (001, 036, 133) giúp tránh các vấn đề về sắp xếp theo thứ tự từ điển khi vượt quá 99. Đây là điều tôi hiện đang sử dụng trên`magic-stick`Vui lòng cung cấp nội dung cần dịch.`001-init-projet.adoc`, `036-debug-graphify-symlink-epic9.adoc`Vui lòng cung cấp văn bản cần dịch.

Loại là tùy chọn và được dẫn xuất từ các từ khóa của phiên (debug, feature, refactor, docs, chore, test). Chủ đề ở dạng kebab-case là phần quan trọng nhất: nó phải cho phép tìm thấy một phiên mà không cần mở tệp. Nếu bạn tự hỏi « phiên nào mình đã sửa lỗi timeout của các bài kiểm tra tích hợp nhỉ? », câu trả lời là`124-fix-timeout-integration-test.adoc`Vui lòng cung cấp văn bản cần dịch.

Đối với các phiên lịch sử được tái lập (các dự án ra đời trước khi có quản trị), tôi sử dụng các số âm. Trên`cheroliv.com`, các phiên từ -6 đến 0 bao quát toàn bộ lịch sử trước thời kỳ quản trị của dự án. Và đối với các phiên "không được ghi chép" hoặc bị mất, tôi tạo một mục nhập trong`SESSIONS_HISTORY.adoc`không có lưu trữ tương ứng, với một điểm số`?`. Điều đó thành thật hơn là giả vờ.

[plantuml, format=svg, id=diag-naming-convention, alt="Arbre de décision pour le nommage des fichiers de session"]
----
@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam wrapWidth 200

title Quy ước Đặt tên Phiên
start

:Une session se termine;
note right: Trigger "kết thúc phiên"

if (Session antérieure\nà la gouvernance ?) then (oui)
  :Numéro **NÉGATIF**\n-6, -5 ... 0;
  note right: Lịch sử\nđược khôi phục
  :Suffixe : reconstitution;
else (non)
  :Numéro **POSITIF**\nsur 3 chiffres si > 99;
  note right: 001, 036, 133\ncho việc sắp xếp theo thứ tự từ điển

  :Détecter le **TYPE**;
  if (Mots-clés trouvés ?) then (oui)
    :debug / feature / refactor\ndocs / chore / test;
  else (non)
    :Omettre le type\n(le sujet suffit);
  endif

  :Formuler le **SUJET** en kebab-case;
  note right
fix-timeout-integration-test
Phải cho phép tìm thấy
mà không cần mở tệp
  end note
endif

:Nom final : {N}-{type}-{sujet}.adoc;
note right
  • 1-chore-migration-gouvernance.adoc
  • 036-debug-graphify-symlink.adoc
  • 124-fix-timeout-integration-test.adoc
  • 133-epic11-article-blog-kg.adoc
end note

if (Session documentée ?) then (oui)
  :Créer archive dans sessions/;
  :Ajouter ligne SESSIONS_HISTORY\navec score X/10;
else (non)
  :Ajouter ligne SESSIONS_HISTORY\navec score **?**\n**sans archive**;
  note right: Sự trung thực\nthay vì sự trống rỗng
endif

stop
@enduml
----

==== TEST_COVERAGE_ANALYSIS.adoc` — Chi tiết Bước 5

Bước 5 của quy trình kết thúc phiên là bước bí ẩn nhất. Bước này ghi « Cập nhật`TEST_COVERAGE_ANALYSIS.adoc`nếu có các bài kiểm tra được thêm vào hoặc thay đổi. » Nhưng tệp này trông như thế nào?

Trên`plantuml-plugin`, nó đã phát triển từ vài dòng thành một cấu trúc hoàn chỉnh. Đây là dạng ổn định của nó:

[source]
----
= Analyse de Couverture de Tests

== Suivi des Tests
|===
| Classe de test | Type | Tests | Statut | Dernière MAJ
| PlantumlServiceTest | unit | 45/45 | ✅ PASS | 2026-04-23
| ApiKeyPoolTest | integration | 15/15 | ✅ PASS | 2026-04-20
|===

== Historique par Session
| Session | Tests ajoutés | Tests modifiés | Couverture
| 133     | 0             | 2              | 100%
| 132     | 5             | 0              | 100%
|===
----

Điểm quan trọng không phải là bản thân tệp tin — mà là nghĩa vụ phải *ghi chú* lại những gì đã thay đổi. Nếu không có bước này, sau 50 phiên làm việc, bạn sẽ không còn biết bài kiểm tra nào bao quát nội dung nào. Agent cũng vậy. Tệp tin này trở thành nguồn sự thật duy nhất (single source of truth) về mức độ bao phủ kiểm thử của dự án.

Đối với các dự án không có bài kiểm tra truyền thống (như`magic-stick`người kiểm thử các script bash), bước 5 được thay thế bằng`SCRIPT_VERIFICATION.adoc`Cơ chế tương tự: một tệp theo dõi trạng thái xác thực của các script. Hãy điều chỉnh bước 5 cho phù hợp với dự án của bạn, nhưng tuyệt đối không được bỏ qua. Đó là lưới an toàn giúp ngăn chặn sự thoái lui trong im lặng.

Nếu dự án của bạn *không có* bất kỳ bài kiểm tra nào — dù là đơn vị, chức năng hay kịch bản — thì hãy cứ tạo tệp trống với phần « Cần làm: xác định chiến lược kiểm thử. » Đây là một dấu ghi nhớ để nhắc nhở chính bạn trong tương lai rằng chủ đề này chưa được xử lý.

[plantuml, format=svg, id=diag-session-flow, alt="Flux d'une session type avec Eager/Lazy et agents"]
----
@startuml
skinparam backgroundColor #FEFEFE

start

:Début session;
note right: Agent là một trang giấy trắng

:Chargement EAGER auto;
note right
* AGENT.adoc (quy tắc tuyệt đối)
* PROMPT_REPRISE.adoc (nhiệm vụ N)
* INDEX.adoc (trạng thái dự án)
end note

if (Mission claire ?) then (oui)
  :Exécution directe;
else (non)
  :Charge LAZY sur demande;
  note right
* SESSIONS_HISTORY.adoc (ngữ cảnh trước đó)
* sessions/{N-1}-*.adoc (quyết định)
* *_REFERENCE.adoc (kiến trúc)
  end note
endif

:Délégation agent spécialisé ?;

if (CODER ?) then (oui)
  :Lit CODER.adoc;
  :Suit conventions FTL/CSS;
elseif (SCRUM Master ?) then (oui)
  :Lit SCRUM_MASTER.adoc;
  :Structure livrable imposée;
elseif (PlantUML ?) then (oui)
  :Lit PLANTUML_DESIGNER.adoc;
  :Syntaxe PUML + intégration;
else (non)
endif

:Travail de la session;

:Fin de session (trigger utilisateur);

:Procédure 6 étapes;
note right
1. Lưu trữ sessions/N-*.adoc
2. Cập nhật PROMPT_REPRISE.adoc (N+1)
3. Cập nhật SESSIONS_HISTORY.adoc
4. Cập nhật INDEX.adoc
5. Cập nhật TEST_COVERAGE (nếu áp dụng)
6. Cập nhật COMPLETED_TASKS_ARCHIVE.adoc
end note

:Checklist [✅] x 6;

stop
@enduml
----

Sơ đồ trên cho thấy toàn bộ vòng đời của một phiên. Điểm mấu chốt là sự phân nhánh sau khi tải EAGER: hoặc nhiệm vụ đủ rõ ràng để thực thi trực tiếp (80% trường hợp), hoặc tác nhân tải thêm LAZY để giải quyết sự mơ hồ (20% trường hợp). Chính sự phân loại này giúp tiết kiệm token.

== Quy trình Kết thúc Phiên: Quy tắc Vàng

=== Tại sao cô ấy lại không thể bỏ qua

Nếu không có quy trình này, chiến lược Eager/Lazy sẽ trở nên vô dụng. Chính nó là thứ chuyển đổi công việc của session thành thông tin bền vững. Nó thực thi**theo yêu cầu rõ ràng của người dùng**(từ khóa: "fin de session", "je quitte", v.v.), và nó là**bắt buộc**-- không ngoại lệ, không bỏ sót.

Tệp`SESSION_CHECKLIST.adoc`xác định các chỉ số của một phiên lý tưởng:

* Thời lượng: 15-30 phút
* Số tệp đã sửa đổi: tối đa 1-3
* Trao đổi LLM: 5-10 tin nhắn
* Ngữ cảnh token: < 50k

Và các dấu hiệu cho thấy cần thay đổi phiên làm việc: _LLM lặp lại các lỗi đã được sửa_, _Có hơn 3 tệp được sửa đổi song song_, _Cuộc hội thoại > 50 tin nhắn_. Quy tắc vàng:**Thà chia thành 5 phiên 20 phút còn hơn một phiên 2 giờ với tình trạng debugging hỗn loạn.**

=== Luồng 6 Bước (Im lặng)

[plantuml, format=svg, id=diag-end-session-flow, alt="Flux de la procédure de fin de session"]
----
@startuml
skinparam defaultTextAlignment center
skinparam wrapWidth 200
skinparam activityBackgroundColor #E3F2FD

start
:L'utilisateur dit "kết thúc phiên làm việc";
note right: Từ khóa kích hoạt

:Agent détecte le trigger;

:Étape 1\nCréer archive\n`.agents/sessions/N-*.adoc`;
note right: Toàn bộ ngữ cảnh của phiên

:Étape 2\nMettre à jour\n`PROMPT_REPRISE.adoc`;
note right: Nhiệm vụ N + tiêu chí chấp nhận N+1

:Étape 3\nMettre à jour\n`SESSIONS_HISTORY.adoc`;
note right: Dòng tổng kết: # / Ngày / Loại / Chủ đề / Điểm số

:Étape 4\nMettre à jour\n`INDEX.adoc`;
note right: Trạng thái hiện tại, roadmap, các tệp đã thay đổi

:Étape 5\nMettre à jour\n`TEST_COVERAGE_ANALYSIS.adoc`;
note right: Nếu các bài kiểm tra được thêm vào hoặc thay đổi

:Étape 6\nMettre à jour\n`COMPLETED_TASKS_ARCHIVE.adoc`;
note right: Lưu trữ các tác vụ đã hoàn thành

:Afficher la checklist de confirmation;
note right: Kiểm tra xem mỗi [✅] có xứng đáng không

stop
@enduml
----

=== Kết quả của 150+ Phiên làm việc

Đây là kết quả khi áp dụng quy trình này một cách hệ thống cho bốn dự án của tôi:

**plantuml-plugin**Vui lòng cung cấp văn bản cần dịch.

* **133 phiên**kể từ khi bắt đầu dự án
* **240/240 bài kiểm tra VƯỢT QUA**(độ bao phủ 100%) -- EPICs 1-7 đã hoàn thành
* **57 kịch bản Cucumber BDD**đã xác nhận
* Quy tắc an toàn về các tệp cấu hình nảy sinh từ một lỗi thực tế (Session 2 bakery-plugin)

**bakery-plugin**Hãy cung cấp nội dung cần dịch.

* **11 phiên**trong hai tuần
* Hoàn tất di chuyển Supabase → Firebase (đã sửa 9 bài kiểm tra)
* EPIC 6 (publishProfile) đã hoạt động trong môi trường production
* Quy tắc 0 đã được tạo:`publishToMavenLocal`bắt buộc sau mỗi lần chỉnh sửa

**gậy phép thuật**Hãy cung cấp văn bản cần dịch.

* **23 phiên**để xây dựng một hệ thống Xubuntu live với phân vùng A/B
* ISO đầu tiên được tạo tại phiên 10
* Các bài kiểm tra boot QEMU + VNC đã được chính thức hóa (tài liệu LAZY dài 144 dòng)
* CI/CD SourceForge đã hoạt động

**cheroliv.com**Vui lòng cung cấp văn bản cần dịch.

* **9 phiên chính thức**+ khôi phục 7 phiên tiền hệ thống
* Điều 0101 (OpenCode PATH) đã được xuất bản
* Điều 0108 (điều này) được viết lại sau khi phân tích các thiếu sót của nó
* Quản trị toàn diện đã được di chuyển từ Markdown sang AsciiDoc

=== Danh sách Kiểm tra Cuối cùng

Sau khi thực hiện âm thầm 6 bước, tác nhân phải hiển thị một danh sách kiểm tra xác nhận:

✅ Procédure de fin de session exécutée
📋 Checklist :
[✅] 1. Archive session N créée
[✅] 2. PROMPT_REPRISE.adoc mis à jour pour session N+1
[✅] 3. SESSIONS_HISTORY.adoc mis à jour
[✅] 4. INDEX.adoc mis à jour
[✅] 5. TEST_COVERAGE_ANALYSIS.adoc mis à jour (si applicable)
[✅] 6. COMPLETED_TASKS_ARCHIVE.adoc mis à jour

mkdir -p .agents/sessions .agents/archives

= {NOM_PROJET} — Directives Agent

[CAUTION]

@startuml
skinparam backgroundColor #FEFEFE
skinparam defaultTextAlignment center
skinparam nodeBackgroundColor #E3F2FD

title Danh mục Dự án — Tham chiếu Chéo INDEX.adoc
node "**magic-stick**\nPhiên 037\nSCRIPT_VERIFICATION" as MS #E1BEE7
node "**bakery-gradle**\nPhiên 11\nTEST_COVERAGE" as BG #FFE0B2
node "**cheroliv.com**\nPhiên 10\nTEST_COVERAGE" as CH #C8E6C9
node "**plantuml-gradle**\nPhiên 133\nTEST_COVERAGE" as PG #BBDEFB
node "**jhipster-gradle**\nPhiên 1 🆕\nTEST_COVERAGE" as JG #FFCDD2

MS --> BG : INDEX.adoc référence
MS --> CH : INDEX.adoc référence
MS --> PG : INDEX.adoc référence
MS --> JG : INDEX.adoc référence 🆕

BG --> MS : INDEX.adoc référence
BG --> CH : INDEX.adoc référence
BG --> PG : INDEX.adoc référence
BG --> JG : INDEX.adoc référence 🆕

CH --> MS : INDEX.adoc référence
CH --> BG : INDEX.adoc référence
CH --> PG : INDEX.adoc référence
CH --> JG : INDEX.adoc référence 🆕

PG --> MS : INDEX.adoc référence
PG --> BG : INDEX.adoc référence
PG --> CH : INDEX.adoc référence
PG --> JG : INDEX.adoc référence 🆕

JG --> MS : INDEX.adoc référence
JG --> BG : INDEX.adoc référence
JG --> CH : INDEX.adoc référence
JG --> PG : INDEX.adoc référence

note bottom of JG
Khi thêm một dự án:
• 4 `INDEX.adoc` cần cập nhật
• 1 dòng cho mỗi danh mục đầu tư
• Chi phí: 5 phút
end note

legend bottom
  |= Couleur |= Projet |
  | <#E1BEE7> | magic-stick — ISO Linux live |
  | <#FFE0B2> | bakery-gradle — Plugin JBake |
  | <#C8E6C9> | cheroliv.com — Site personnel |
  | <#BBDEFB> | plantuml-gradle — Plugin IA |
  | <#FFCDD2> | jhipster-gradle — Mono-repo JHipster |
endlegend

@enduml