@startuml
skinparam backgroundColor #FEFEFE
skinparam handwritten false

title วิวัฒนาการของเซสชัน — จากเซสชัน 1 ถึง 150+
legend top
    |= Couleur |= Projet |
    | <#4CAF50> | cheroliv.com |
    | <#2196F3> | plantuml-plugin |
    | <#FF9800> | bakery-plugin |
    | <#9C27B0> | magic-stick |
endlegend

concise "เซสชันที่ใช้งานอยู่" as S

@S
0 is ".md แบบดิบ"
1 is "การย้ายข้อมูล\nAsciiDoc"
10 is "Eager/Lazy\nแบบเป็นทางการ"
62 is "กฎความปลอดภัย\n(site.yml)"
87 is "การแคร็ก\nบริบท"
109 is "การเพิ่มประสิทธิภาพ\n-60% โทเค็น"
133 is "133 เซสชัน\n240 การทดสอบ 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 "Racine du Projet (Eager - Auto-chargé)" {
    component "<b>AGENT.adoc</b>\nกฎสัมบูรณ์\nโครงสร้างและข้อกำหนด" as AGENT
    component "<b>PROMPT_REPRISE.adoc</b>\nภารกิจของเซสชัน N\nสรุป N-1" as PROMPT
    component "<b>INDEX.adoc</b>\nจุดเริ่มต้น\nกฎ + เซสชัน" as INDEX
    component "<b>*_ESSENTIALS.adoc</b>\nบริบททางธุรกิจ\nสำคัญยิ่ง" as ESS
}

package ".agents/ (Lazy - โหลดตามคำขอ)" {
    component "<b>sessions/N-*.adoc</b>\nคลังเก็บโดยละเอียด\nการตัดสินใจ & ผลลัพธ์" as SESS
    component "<b>SESSIONS_HISTORY.adoc</b>\nตารางสรุป\nวันที่/ประเภท/คะแนน" as HIST
    component "<b>PROCEDURES.adoc</b>\nเทมเพลตท้ายเซสชัน\n6 ขั้นตอน\n" as PROC
    component "<b>*_REFERENCE.adoc</b>\nสถาปัตยกรรมทั้งหมด\nข้อมูลอ้างอิงทางเทคนิค" as REF
    component "<b>COMPLETED_TASKS_ARCHIVE</b>\nงานที่เสร็จสิ้น\nรายเดือน" as ARCH
    component "<b>AGENT_MODUS_OPERANDI.adoc</b>\nเอกสารกลยุทธ์\nระเบียบวิธี" as MOD
    component "<b>*_REFERENCE.adoc</b>\nการทดสอบ Boot, พาร์ทิชัน A/B\nบริบทเฉพาะ" as SPEC
}

AGENT --> PROMPT : "ข้อมูลอ้างอิง"
AGENT --> INDEX : "ข้อมูลอ้างอิง"
INDEX --> SESS : "ดัชนี"
INDEX --> HIST : "ดัชนี"
INDEX --> PROC : "อ้างอิง"
INDEX --> ARCH : "อ้างอิง"
INDEX --> REF : "อ้างอิง"
PROMPT --> SESS : "คลังเก็บ N-1"
PROMPT --> ESS : "บริบททางธุรกิจ 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 |
----

No source text was provided to translate. Please send the French text you would like translated into Thai.`*_ESSENTIALS.adoc`** -- การเพิ่มเติมล่าสุด (Session 109, plantuml-plugin) เพื่อเพิ่มประสิทธิภาพบริบทแบบ Eager ให้ดียิ่งขึ้น แทนที่จะโหลดบริบททางธุรกิจ 200 บรรทัดบนพูลคีย์ API ฉันโหลด 50 บรรทัดของส่วนสำคัญ และอีก 150 บรรทัดที่เหลือยังคงอยู่ในสถานะ LAZY ใน`*_REFERENCE.adoc`.

ผลลัพธ์ที่วัดได้: การเปลี่ยนผ่านของ**~25k โทเคน EAGER ถึง ~10k โทเคน**(ประหยัดได้ 60%) เอเจนต์ไม่จำเป็นต้องใช้การแจ้งเตือนที่สิ้นเปลืองพลังงานอีกต่อไป

==== จุดเชื่อมที่หายไป : `opencode.json

ฉันต้องสารภาพกับคุณถึงเรื่องหนึ่งที่ฉันเกือบลืมบันทึกไว้ เหนือไฟล์ .adoc ทั้งหมดนี้ มีไฟล์ JSON ขนาดจิ๋วไฟล์หนึ่งซึ่งถ้าไม่มีมันแล้วทุกอย่างก็ไม่ทำงาน มันมีชื่อว่า`opencode.json`และมันมีหกบรรทัด ตามตัวอักษรคือหกบรรทัด

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

ไฟล์นี้เป็นไฟล์ที่บอกกับ Opencode ว่า « เมื่อเริ่มต้น ให้โหลด`AGENT.adoc`โดยอัตโนมัติ. » หากไม่มีมัน เอเจนต์ก็เป็นหน้าว่างเปล่าตรงกับที่ฉันอธิบายไว้ตอนต้นบทความทุกประการ เมื่อมีมัน เอเจนต์ก็มีกฎเด็ดขาด สถาปัตยกรรมของโปรเจกต์ และคำสั่งสำคัญอยู่ในมือแล้ว — ก่อนที่ฉันจะพูดสวัสดีด้วยซ้ำ

ฉันค้นพบความสำคัญของไฟล์นี้โดยบังเอิญ บน`bakery-plugin`, มันไม่มีอยู่จริง ฉันสงสัยว่าทำไมเอเจนต์จึงดู « หลงทาง » อย่างเป็นระบบในโปรเจกต์นี้มากกว่าโปรเจกต์อื่น กฎสัมบูรณ์นั้นอยู่ใน`AGENT.adoc`— แต่`AGENT.adoc`ไม่เคยถูกโหลด เอเจนต์อ่านเฉพาะสิ่งที่ฉันบอกให้อ่านด้วยตนเองในแต่ละเซสชัน นี่คือเซสชันที่ 11 ของ`bakery-plugin`เมื่อฉันตระหนักถึงการไม่มีอยู่ของ`opencode.json`. ฉันสร้างมันขึ้นมา — และเซสชันที่ 12 ก็เริ่มต้นเหมือนกับเซสชันอื่นๆ

ไฟล์นี้ชัดเจนสำหรับฉันมากในตอนนี้จนฉันไม่คิดถึงมันอีกแล้ว ความผิดพลาดแบบคลาสสิกของนักพัฒนาที่รู้จักเครื่องมือของตัวเองดีเกินไป วันนี้ฉันสร้างมันเป็นประจำ *ก่อน*`AGENT.adoc`. นี่คือศิลาก้อนแรก

==== ทวิภาพของ `INDEX.adoc

ความละเอียดอ่อนอีกประการหนึ่งที่สมควรได้รับการอธิบายให้ชัดเจน:`INDEX.adoc`อาศัยอยู่ใน`.agents/`— โฟลเดอร์ที่ฉันนำเสนอว่าเป็น LAZY อย่างไรก็ตาม ฉันระบุโฟลเดอร์นี้เป็น EAGER ในตารางทั้งหมดของฉัน มีความขัดแย้งที่ดูเหมือนจะปรากฏอยู่ตรงนี้

ความเป็นจริงภาคสนาม: ไฟล์`.agents/INDEX.adoc`ถูกโหลดโดยอัตโนมัติเรียบร้อยแล้วเมื่อเริ่มต้นเซสชัน เช่นเดียวกับ`AGENT.adoc` et `PROMPT_REPRISE.adoc`. พวกเขาอยู่ใน`.agents/`ด้วยเหตุผลด้านการจัดระเบียบ — ไม่ให้รุกล้ำราก — แต่พฤติกรรมของพวกมันเป็น EAGER

บน`plantuml-plugin`, `INDEX.adoc`มี 200 บรรทัด และมีกฎเด็ดขาดที่*ครบถ้วน*พร้อมประวัติของกฎเหล่านั้น (บทเรียนจากเซสชันที่ผ่านมา) EPIC พร้อมคะแนน และพอร์ตโฟลิโอโครงการ นี่คือเอกสารที่เอเจนต์ใช้ตรวจดูเพื่อรู้ว่า « ตอนนี้เราอยู่ตรงไหน » บน`bakery-plugin`, มันมี 150 บรรทัดพร้อมด้วยโรดแมปและเซสชันล่าสุด

ความซ้ำซ้อนโดยเจตนาระหว่าง`AGENT.adoc` et `INDEX.adoc`อาจทำให้ประหลาดใจได้ กฎเด็ดขาดมีอยู่ในทั้งสอง ทำไม? เพราะกฎเหล่านี้ทำหน้าที่สองบทบาทที่แตกต่างกัน: ใน`AGENT.adoc`, พวกมันเป็น *เชิงอธิบาย* (การเล่าเรื่องของกฎ บทเรียนที่ได้เรียนรู้) ; ใน`INDEX.adoc`, สิ่งเหล่านี้เป็น *เชิงปฏิบัติการ* (กฎเปล่า ๆ โดยไม่มีเหตุผลรองรับ สำหรับการอ้างอิงอย่างรวดเร็ว) เอเจนต์อ่าน`AGENT.adoc`ครั้งหนึ่งเพื่อ *ทำความเข้าใจ* ; เขาอ่านอีกครั้ง`INDEX.adoc`ในแต่ละเซสชันเพื่อ *นำไปใช้* สองการใช้งาน สองรูปแบบ

[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 ความเป็นคู่ของ AGENT.adoc ←→ INDEX.adoc
left to right direction

rectangle "AGENT.adoc\n(ราก — EAGER)" as AGENT #E3F2FD {
  rectangle "📖 **รูปแบบการเล่าเรื่อง**\nการเล่าเรื่องของกฎ\nบทเรียนที่ได้รับ, บริบท" as NARR
  rectangle "🏗️ **สถาปัตยกรรมแบบสมบูรณ์**\nโครงสร้างโครงการ, องค์ประกอบ\nBacklog โดยละเอียดของ US" as ARCHI
  rectangle "📋 **กฎเชิงอธิบาย**\nทำไมกฎจึงมีอยู่\nประวัติของเหตุการณ์" as EXPL
}

rectangle "INDEX.adoc\n(.agents/ — EAGER)" as INDEX #E8F5E9 {
  rectangle "⚡ **รูปแบบสำหรับผู้บริหาร**\nกฎล้วน ๆ โดยไม่มีเหตุผลประกอบ\nการเปิดดูอย่างรวดเร็ว" as EXEC
  rectangle "📊 **Roadmap & EPICs**\nตารางสรุป\nความคืบหน้า, คะแนน, ลำดับความสำคัญ" as ROAD
  rectangle "🌐 **พอร์ตโฟลิโอโครงการ**\nมุมมองข้ามโครงการ\n5 โครงการที่ซิงโครไนซ์แล้ว" as PORT
}

AGENT --> INDEX : "เอเจนต์อ่าน AGENT.adoc\n1 ครั้งเพื่อ **เข้าใจ**"
INDEX --> AGENT : "เอเจนต์อ่าน INDEX.adoc ซ้ำ\nทุกเซสชันเพื่อ **นำไปใช้**"

note bottom of AGENT
ขนาดสูงสุด: 200 บรรทัด
end note

note bottom of INDEX
ขนาดสูงสุด: 200 บรรทัด
  Source de vérité en cas de divergence
end note

@enduml
----

ความซ้ำซ้อนที่ตั้งใจไว้นี้เป็นทางเลือกในการออกแบบ โดยใช้โทเคน EAGER เพิ่มขึ้นราว 50 บรรทัด — แต่ช่วยรับประกันว่าตัวแทนจะมีกฎอยู่ตรงหน้าอยู่เสมอ รวมถึงในรูปแบบกระชับซึ่งเอื้อต่อการปฏิบัติตามได้ทันที

=== ไฟล์ LAZY: คู่มือเจ้าของ

ไฟล์เหล่านี้อยู่ใน`.agents/`และจะถูกอ่านเฉพาะเมื่อเอเจนต์จำเป็นต้องใช้เท่านั้น พวกมันเป็นความมั่งคั่งที่แท้จริงของวิธีการนี้ เพราะพวกมันสะสมความรู้ของโครงการโดยไม่ปนเปื้อนบริบทปัจจุบัน

[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 บรรทัด)" as IDX #E8F5E9
  file "AGENT_SESSION_MANAGER.adoc\n(แม่แบบเซสชัน)" as ASM
  file "SESSION_CHECKLIST.adoc\n(เมื่อใดควรเปลี่ยน)" as CHK
  file "PROCEDURES.adoc\n(6 ขั้นตอน + LAZY/EAGER)" as PRO
  file "SESSIONS_HISTORY.adoc\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 รายการอื่น" 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 : "จัดทำดัชนี"
IDX --> HIS : "จัดทำดัชนี"
IDX --> ARCH : "อ้างอิง"

note right of S109
เซสชัน 109 =
การทำให้กลยุทธ์เป็นทางการ
LAZY/EAGER
โทเคน : ~25k → ~10k
end note

@enduml
----

โครงสร้างแบบต้นไม้ด้านบนแสดงโครงสร้างจริงของโฟลเดอร์`.agents/`บน`plantuml-plugin`, โปรเจกต์ที่สมบูรณ์ที่สุด โปรดสังเกตความลึกแบบสามชั้น: ไฟล์ราก (เมทาดาทา), โฟลเดอร์`sessions/`(จดหมายเหตุตามลำดับเวลา) และแฟ้มเอกสาร`archives/`(การรวมและการสรุป) ความลึกนี้เองที่เปลี่ยนการกำกับดูแลของไฟล์ TODO ธรรมดาให้กลายเป็น**ความจำองค์กรที่สมบูรณ์**.

**.agents/sessions/{N}-{titre}.adoc**-- ไฟล์เก็บถาวรโดยละเอียดของแต่ละเซสชัน ปัจจุบัน:

* `plantuml-plugin`No source text was provided to translate. Please send the French text you'd like translated into Thai.**133 เซสชันที่ถูกเก็บถาวร**(ตั้งแต่เซสชันที่ 1 ถึง 133)
* `bakery-plugin`(No French text was provided to translate — the message ends with " : " and no source text follows.)**11 เซสชัน**
* `magic-stick`Please provide the French text you'd like me to translate into Thai.**23 เซสชัน**
* `cheroliv.com`No text was provided to translate. Please send the French text you'd like translated into Thai.**9 เซสชันอย่างเป็นทางการ**+ เซสชันก่อนระบบ 7 ครั้งที่สร้างขึ้นย้อนหลัง

ไฟล์เก็บถาวรแต่ละไฟล์มีบริบทที่สมบูรณ์ของเซสชัน การตัดสินใจที่ได้ทำ ปัญหาที่พบและวิธีแก้ไข คำสั่งที่รัน และเอาต์พุตของคำสั่งเหล่านั้น

**.agents/SESSIONS_HISTORY.adoc**-- ตารางสรุปของทุกเซสชันพร้อมคะแนน ตัวอย่างบน`cheroliv.com`ไม่มีข้อความภาษาฝรั่งเศสให้แปลในข้อความของคุณ กรุณาส่งข้อความที่ต้องการแปล

----

| -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

**.agents/COMPLETED_TASKS_ARCHIVE_{mois}.adoc**-- งานที่เสร็จสิ้นแล้วจะถูกเก็บถาวรเป็นรายเดือน เพื่อไม่ให้ backlog ที่ใช้งานอยู่มีภาระมากเกินไป เมื่อ user story เสร็จสิ้นแล้ว จะถูกย้ายมาที่นี่ backlog ยังคงอ่านง่าย: มีรายการที่ใช้งานอยู่สูงสุด 10 รายการ

**.agents/PROCEDURES.adoc**-- เทมเพลตโดยละเอียดของขั้นตอนการสิ้นสุดเซสชัน ยาว แต่เอเจนต์อ่านเพียงครั้งเดียวเมื่อเรียนรู้วิธีการ จากนั้นขั้นตอนจะกลายเป็นกลไกอัตโนมัติ

**.agents/AGENT_MODUS_OPERANDI.adoc**-- เอกสารเชิงกลยุทธ์ฉบับสมบูรณ์ เกี่ยวกับ`plantuml-plugin`, ไฟล์นี้ทำ**900+ บรรทัด**และในความเป็นจริงมีชื่อว่า`AGENT_METHODOLOGIES.adoc`— ฉันเปลี่ยนชื่อระหว่างการเขียนบทความนี้กับการนำไปใช้จริง ความคลาดเคลื่อนในการตั้งชื่อแบบนี้เป็นเรื่องเลี่ยงไม่ได้ในระบบงานฝีมือที่พัฒนาอยู่ สิ่งสำคัญคือแบบแผนการตั้งชื่อ: หากไฟล์นั้นอธิบาย *วิธีการ* มันจะเริ่มต้นด้วย`AGENT_`หรือคำนำหน้าที่ชัดเจน มันจัดทำเอกสารวิธีการ Eager/Lazy แพตเทิร์นที่ควรปฏิบัติตาม และแอนติแพตเทิร์นที่ควรหลีกเลี่ยง มันเป็น LAZY เพราะเอเจนต์ไม่จำเป็นต้องอ่านกลยุทธ์ทั้งหมดซ้ำในทุกเซสชัน แต่เฉพาะเมื่อมีความกำกวมเท่านั้น

No text was provided to translate. Please send the French text you'd like translated into Thai.`*_REFERENCE.adoc`** -- ข้อมูลอ้างอิงทางเทคนิคเฉพาะของโครงการ บน`magic-stick`, สองไฟล์ LAZY แบบหนาแน่น:

* `AB_PARTITION_REFERENCE.adoc`(147 บรรทัด) -- สถาปัตยกรรมพาร์ทิชัน A/B GPT, สคริปต์`update-system.sh`, ขนาดที่ประมาณไว้, กลไกการย้อนกลับ
* `BOOT_TEST_REFERENCE.adoc`(144 บรรทัด) -- ขั้นตอน QEMU + VNC สำหรับทดสอบการบูตของ ISO โดยไม่มีฮาร์ดแวร์จริง รายการตรวจสอบ BIOS/UEFI ข้อจำกัด CI/CD

บน`plantuml-plugin`It looks like your message is missing the French text you'd like translated into Thai. Could you please provide the source text?

* `ARCHITECTURE.adoc`(134 บรรทัด) -- โครงสร้างของ 11 data classes, จุดที่ควรระวัง (กับดักที่ควรหลีกเลี่ยง), คำสั่งทดสอบที่ปรับให้เหมาะสม
* `API_KEY_POOL_REFERENCE.adoc`-- รายละเอียดทั้งหมดของพูลคีย์ (LAZY ขณะที่`ESSENTIALS`คือ EAGER)

== เอเจนต์ผู้เชี่ยวชาญ: ทีมเสมือนจริง

การกำกับดูแลไม่ได้จำกัดอยู่เพียงไฟล์แบบพาสซีฟ ฉันได้จัดทำอย่างเป็นทางการ...**บทบาทของเอเจนต์เฉพาะทาง**ในไฟล์ LAZY ที่จัดเตรียมไว้โดยเฉพาะ ซึ่งกำหนดเวิร์กโฟลว์ที่คาดหวังตามประเภทของงาน

|===
|Please provide the French text you'd like me to translate into Thai. |ไฟล์ |บทบาท |โครงการ |**เข้ารหัส** |`CODER.adoc` |การนำ FTL/CSS/JS ไปใช้, แท็กเชิงความหมาย, เกณฑ์การเข้าถึง |cheroliv.com |**สครัมมาสเตอร์** |`SCRUM_MASTER.adoc` |การวางแผน US, การแบ่งเป็นงานย่อย, การตรวจจับการพึ่งพา |cheroliv.com |**PlantUML Designer** |`PLANTUML_DESIGNER.adoc` |การสร้างไดอะแกรม, ไวยากรณ์ PUML, การผสานรวม JBake |cheroliv.com
|===

ไฟล์`CODER.adoc`บน`cheroliv.com`มีกฎเกณฑ์ที่เป็นรูปธรรม : _มีเพียงหนึ่ง`<h1>`ต่อหน้า_, _นำหน้าเส้นทางด้วย`${content.rootpath}`_, _ประกาศภาษา`<html lang="${content.lang!"fr"}">`_. ข้อตกลงเหล่านี้ ซึ่งเขียนไว้เพียงครั้งเดียว ได้รับการปฏิบัติตามโดยอัตโนมัติโดยเอเจนต์ตั้งแต่เซสชันที่ 1

ไฟล์`SCRUM_MASTER.adoc`กำหนดโครงสร้างของสิ่งที่ต้องส่งมอบ:**วัตถุประสงค์**, **งาน**(เรียงลำดับพร้อมการกำหนดค่า),**เกณฑ์การยอมรับ**, **ความเสี่ยง**. เมื่อฉันขอแผนปฏิบัติการ เอเจนต์สร้างโครงสร้างนี้โดยที่ฉันไม่ได้ขอ การกำกับดูแล**โปรแกรม**เจ้าหน้าที่

==== เมื่อเอเจนต์เฉพาะทางกลายเป็นสิ่งที่ขาดไม่ได้

การสร้างเอเจนต์เฉพาะทางเป็นไปตามเส้นโค้งตามธรรมชาติ ในช่วงเริ่มต้นของโครงการ คุณยังไม่จำเป็นต้องมีมัน —`AGENT.adoc`ก็เพียงพอแล้วอย่างมาก แต่เมื่อโปรเจกต์เติบโตขึ้น (สมมติว่าเกิน 20 เซสชัน) สัญญาณสองอย่างต้องเตือนคุณ :

1. เอเจนต์ผสมปนธรรมเนียมปฏิบัติของสองโดเมนที่แตกต่างกัน (เช่น ไวยากรณ์ PlantUML และกฎ CSS)
2. คุณใช้เวลามากขึ้นในการแก้ไขเอเจนต์เกี่ยวกับแนวปฏิบัติที่คุณอธิบายให้มันฟังไปแล้ว 5 ครั้ง

บน`cheroliv.com`, มันเกิดขึ้นในเซสชัน... 1. ใช่ ตั้งแต่เริ่มแรก เพราะโปรเจกต์นี้เป็นเว็บไซต์ที่มีสามภาษา (FTL, CSS, JS) เนื้อหา AsciiDoc และไดอะแกรม PlantUML — สามโดเมนที่ไม่เกี่ยวข้องกันเลย เอเจนต์ CODER จำเป็นต้องรู้ขนาดฟอนต์และ media queries ; เอเจนต์ PLANTUML_DESIGNER จำเป็นต้องรู้ไวยากรณ์`@startuml`. หากไม่มีการแยกจากกัน เอเจนต์ CODER เสนอไดอะแกรมให้ฉัน และในทางกลับกัน ความวุ่นวาย

บน`jhipster-gradle-plugins`, ฉันได้สร้างเอเจนต์เฉพาะทางสองตัวที่เหมาะสำหรับการพัฒนาplugin Gradle:`PLUGIN_DEVELOPER.adoc` et `BACKLOG_MANAGER.adoc`. ตัวแรกเข้ารหัสแบบแผน Kotlin/Gradle ทั้งหมด (ไม่มี`!!`, คลาสข้อมูลสำหรับโมเดล,`@TaskAction`สำหรับงาน) คนที่สองรู้ว่า`persistence`ต้องเสถียรก่อนที่`assistant`ไม่เริ่มการพัฒนาของตน — การพึ่งพาที่สำคัญในโมโนรีโป

ข้อผิดพลาดที่ต้องไม่ทำ: การสร้างเอเจนต์มากเกินไปเร็วเกินไป`plantuml-plugin`ได้รอจนถึงเซสชัน 108 ก่อนที่จะจัดทำเป็นเอเจนต์เฉพาะทางสำหรับพูลคีย์ API ก่อนหน้านั้น บริบททางธุรกิจอยู่ภายใน`AGENT.adoc`. หลักการคร่าว ๆ: เอเจนต์เฉพาะทางมีความสมเหตุสมผลเมื่อโดเมนธุรกิจของมันมีเอกสารเกิน 100 บรรทัด

==== ข้อกำหนดการตั้งชื่อเซสชัน

รายละเอียดที่ดูเหมือนไม่สำคัญ แต่จะกลายเป็นเรื่องวิกฤตเมื่อถึง 100 เซสชัน จะตั้งชื่อไฟล์อาร์ไคฟ์อย่างไร?

ฉันเรียนรู้จากประสบการณ์ตรงว่าจำเป็นต้องมีข้อตกลงร่วมกัน — ตอนแรกมีสี่โปรเจกต์ สี่รูปแบบที่แตกต่างกัน และฉันก็ตามไม่ทันอีกต่อไป ตอนนี้ ข้อตกลงที่ฉันทำให้ลงตัวแล้วคือ:

ตัวอย่างที่เป็นรูปธรรม:

* `1-chore-migration-gouvernance-agent.adoc`— เซสชัน 1 ประเภทงานบ้าน
* `10-solidification-tests.adoc`— เซสชัน 10 โดยไม่มีชนิดที่ระบุชัดเจน (หัวข้อเพียงพอ)
* `036-debug-graphify-symlink-epic9.adoc`— เซสชัน 36 พร้อมหมายเลข 3 หลักสำหรับการจัดเรียง

หมายเลขเซสชันเป็นเกณฑ์การเรียงลำดับหลัก โปรเจกต์ที่ใช้หมายเลข 3 หลัก (001, 036, 133) จะหลีกเลี่ยงปัญหาการเรียงลำดับแบบพจนานุกรมเมื่อเกิน 99 นี่คือสิ่งที่ฉันใช้อยู่ตอนนี้บน`magic-stick`No French text was provided to translate.`001-init-projet.adoc`, `036-debug-graphify-symlink-epic9.adoc`.

ประเภทเป็นทางเลือกและได้มาจากคีย์เวิร์ดของเซสชัน (debug, feature, refactor, docs, chore, test) หัวข้อในรูปแบบ kebab-case เป็นส่วนที่สำคัญที่สุด: ต้องทำให้สามารถค้นหาเซสชันได้โดยไม่ต้องเปิดไฟล์ หากคุณสงสัยว่า «นั่นคือเซสชันไหนที่เราแก้ไข timeout ของการทดสอบการรวมระบบ?» คำตอบคือ`124-fix-timeout-integration-test.adoc`.

สำหรับเซสชันย้อนหลังที่สร้างขึ้นใหม่ (โปรเจกต์ที่เกิดก่อนการกำกับดูแล) ฉันใช้หมายเลขติดลบ บน`cheroliv.com`, เซสชัน -6 ถึง 0 ครอบคลุมประวัติศาสตร์ก่อนการกำกับดูแลของโครงการทั้งหมด และสำหรับเซสชัน « ที่ไม่ได้บันทึกเป็นเอกสาร » หรือที่สูญหาย ฉันสร้างรายการใน`SESSIONS_HISTORY.adoc`โดยไม่มีเอกสารเก็บถาวรที่สอดคล้องกัน โดยมีคะแนน`?`. ซึ่งซื่อสัตย์กว่าการแสร้งทำ

[plantuml, format=svg, id=diag-naming-convention, alt="Arbre de décision pour le nommage des fichiers de session"]

==== TEST_COVERAGE_ANALYSIS.adoc` — ขั้นตอนที่ 5 แบบเจาะลึก

ขั้นตอนที่ 5 ของกระบวนการสิ้นสุดเซสชันเป็นขั้นตอนที่ลึกลับที่สุด โดยกล่าวว่า « อัปเดต`TEST_COVERAGE_ANALYSIS.adoc`หากมีการเพิ่มหรือแก้ไขการทดสอบ » แต่ไฟล์นี้มีลักษณะอย่างไร?

บน`plantuml-plugin`, มันพัฒนาจากไม่กี่บรรทัดไปเป็นโครงสร้างที่สมบูรณ์ นี่คือรูปแบบที่เสถียรแล้วของมัน:

[source]