Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
20 changes: 20 additions & 0 deletions README.th.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
ที่ตกหล่นโดยไม่เพิ่มภาระให้งานเล็ก

## เปรียบเทียบกับแนวทางอื่น

โครงการเหล่านี้มีค่าเริ่มต้นต่างกัน ไม่มีแนวทางใดชนะทุกกรณี ตารางนี้สรุปเอกสารสาธารณะ
Expand Down