diff --git a/README.md b/README.md index 2ff1961..3aa24eb 100644 --- a/README.md +++ b/README.md @@ -79,6 +79,28 @@ Roadmap updates happen only when priority, milestone, ordering, or a deferred-wo WORK owns scope and decisions, EVIDENCE owns checks and limitations, and state contains only the context needed to resume. +### With and without Solodeveling + +A coding agent can keep a `TODO.md` or write next-session notes without installing +any skill. Solodeveling does not make the model inherently smarter; it packages a +repeatable delivery policy so the user does not have to reconstruct it in every +prompt or session. + +| Concern | Without a shared skill | With Solodeveling | +| --- | --- | --- | +| Coordination | Instructions and working conventions depend on the current prompt, agent, and session | Project-local skills provide the same routing and vocabulary on each supported runtime | +| Continuity | Notes can use any format the user or agent chooses | Compact state records only resumable context, with one owner for each durable fact | +| Small work | Can have almost no ceremony when the agent makes the right call | Direct Read-Only and Ephemeral Quick explicitly require no lifecycle artifacts | +| Completion | The prompt or session determines what evidence is enough | Completion claims require recent verification scoped to the changed boundary | +| Risky work | Security, authority, recovery, and release checks must be supplied by the prompt or another process | Critical work routes through explicit security, recovery, provenance, and authorization gates | + +Not every project needs Solodeveling. A small, low-risk, single-session project may +be better served by a clear prompt and a `TODO.md`. Solodeveling earns its overhead +when repeatable decisions, cross-session continuity, or risk-sensitive verification +matter. The testable claim is not that a skill makes the model smarter, but that a +shared protocol reduces repeated coordination and missed gates without burdening +small work. + ## How it compares These projects have different defaults rather than a universal winner. The table diff --git a/README.th.md b/README.th.md index 1550ef2..667ac15 100644 --- a/README.th.md +++ b/README.th.md @@ -78,6 +78,26 @@ durable decision หรือยังอยู่ใน batch ที่ goal, a หรือการตัดสินใจเลื่อนงานเปลี่ยนไป WORK เป็นเจ้าของ scope และ decision ส่วน EVIDENCE เป็นเจ้าของ checks และ limitations โดย state เก็บเฉพาะบริบทที่จำเป็นต่อการทำงานต่อ +### เมื่อใช้และไม่ใช้ Solodeveling + +coding agent สามารถเขียน `TODO.md` หรือบันทึกสิ่งที่ต้องทำใน session ถัดไปได้โดยไม่ต้อง +ติดตั้ง skill ใด Solodeveling ไม่ได้ทำให้โมเดลฉลาดขึ้นโดยตรง แต่บรรจุกติกาการส่งมอบที่ใช้ซ้ำได้ +เพื่อให้ผู้ใช้ไม่ต้องสร้างวิธีทำงานขึ้นใหม่ในทุก prompt หรือทุก session + +| ประเด็น | เมื่อไม่มี skill ร่วม | เมื่อใช้ Solodeveling | +| --- | --- | --- | +| การประสานงาน | คำสั่งและวิธีทำงานขึ้นอยู่กับ prompt, agent และ session ปัจจุบัน | skill ที่ติดตั้งในโปรเจกต์ให้ routing และคำศัพท์ชุดเดียวกันบน runtime ที่รองรับ | +| ความต่อเนื่อง | ผู้ใช้หรือ agent เลือกรูปแบบการจดบันทึกได้อย่างอิสระ | state แบบกระชับเก็บเฉพาะบริบทที่ต้องใช้ทำงานต่อ และข้อมูลถาวรแต่ละชนิดมีเจ้าของเพียงแห่งเดียว | +| งานเล็ก | แทบไม่มีพิธีการได้หาก agent ตัดสินใจเหมาะสม | Direct Read-Only และ Ephemeral Quick ระบุชัดว่าไม่ต้องสร้าง lifecycle artifact | +| การยืนยันว่าเสร็จ | prompt หรือ session เป็นตัวกำหนดว่าหลักฐานเท่าใดจึงเพียงพอ | การกล่าวอ้างว่าเสร็จต้องมี verification ล่าสุดที่ตรงกับขอบเขตซึ่งเปลี่ยนไป | +| งานเสี่ยง | ต้องระบุ security, authority, recovery และ release checks ผ่าน prompt หรือกระบวนการอื่น | งาน Critical ใช้ security, recovery, provenance และ authorization gate ที่ชัดเจน | + +ไม่ใช่ทุกโปรเจกต์ที่จำเป็นต้องใช้ Solodeveling โปรเจกต์เล็ก ความเสี่ยงต่ำ และจบใน session เดียว +อาจเหมาะกับ prompt ที่ชัดเจนและ `TODO.md` มากกว่า Solodeveling จะคุ้มกับ overhead เมื่อการตัดสินใจ +ต้องทำซ้ำ งานต้องต่อข้าม session หรือจำเป็นต้องตรวจสอบตามระดับความเสี่ยง ข้อกล่าวอ้างที่ทดสอบได้ +จึงไม่ใช่ว่า skill ทำให้โมเดลฉลาดขึ้น แต่เป็น shared protocol ที่ลดการประสานงานซ้ำและลด gate +ที่ตกหล่นโดยไม่เพิ่มภาระให้งานเล็ก + ## เปรียบเทียบกับแนวทางอื่น โครงการเหล่านี้มีค่าเริ่มต้นต่างกัน ไม่มีแนวทางใดชนะทุกกรณี ตารางนี้สรุปเอกสารสาธารณะ