[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78EM2YP5MFGX0A1V8DS2Z2N":3,"skill-same:01M78EM2YP5MFGX0A1V8DS2Z2N":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":25,"commitSha":26,"skillDirectory":27,"forksCount":28,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":31,"ownerDescription":32,"updatedAt":33,"install":34,"resources":46},"01M78EM2YP5MFGX0A1V8DS2Z2N","wayfinder",null,"วางแผนงานก้อนใหญ่ — ใหญ่เกินกว่าหนึ่ง agent session จะรับไหว — เป็นแผนที่ร่วมของ ticket สำหรับการ investigate บน issue tracker ของคุณ แล้วไล่ resolve ทีละใบจนกว่าเส้นทางไปยังจุดหมายจะชัด","Boom-Vitt\u002Fskills-thai","Boom-Vitt","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F169876956?v=4","01M78EJ7J23WSZJ2R2WTZGGAPR","Vittawat","01M78EJ7JPKFWHN7WJ94HE7F9R",5,"MIT","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fwayfinder\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: wayfinder\ndescription: วางแผนงานก้อนใหญ่ — ใหญ่เกินกว่าหนึ่ง agent session จะรับไหว — เป็นแผนที่ร่วมของ ticket สำหรับการ investigate บน issue tracker ของคุณ แล้วไล่ resolve ทีละใบจนกว่าเส้นทางไปยังจุดหมายจะชัด\ndisable-model-invocation: true\n---\n\nไอเดียหลวม ๆ ก้อนหนึ่งเพิ่งมาถึง — ใหญ่เกินกว่าหนึ่ง agent session และถูกหมอกปกคลุม: เส้นทางจากตรงนี้ไปยัง **จุดหมาย (destination)** ยังมองไม่เห็น Wayfinding คือการหาเส้นทางนั้น ไม่ใช่การพุ่งเข้าใส่จุดหมาย skill นี้จะวาดเส้นทางเป็น **แผนที่ร่วม (shared map)** บน issue tracker ของ repo แล้วไล่ทำ ticket ของมันทีละใบจนกว่าเส้นทางจะชัด\n\nจุดหมายของแต่ละ effort ไม่เหมือนกัน และการตั้งชื่อจุดหมายคือก้าวแรกของการวาดแผนที่ — มันกำหนดรูปร่างของทุก ticket จุดหมายอาจเป็น spec ที่จะส่งต่อไป iterate กันต่อ เป็นการตัดสินใจที่ต้องล็อกก่อนเริ่มวางแผน หรือเป็นการเปลี่ยนแปลงที่ลงมือทำในที่เลย เช่นการ migrate data structure ตัวแผนที่ไม่ผูกกับ domain ไหน — งาน engineering เนื้อหาคอร์ส หรืออะไรก็ตามที่เข้ารูปแบบนี้\n\n## วางแผน อย่าเพิ่งลงมือทำ\n\nWayfinder คือการ**วางแผน**โดย default: แต่ละ ticket ปิดการตัดสินใจหนึ่งเรื่อง และแผนที่จะเสร็จเมื่อเส้นทางชัด — ไม่เหลืออะไรให้ตัดสินใจก่อนที่ใครสักคนจะไปลงมือทำของจริง แรงดึงที่อยากลงมือทำงานเลยมักเป็นสัญญาณว่าคุณมาถึงขอบแผนที่แล้ว และถึงเวลา hand off แต่ละ effort สามารถ override เรื่องนี้ได้ใน **Notes** ของมัน — ดึง execution เข้ามาอยู่ในแผนที่ด้วย — แต่ถ้าไม่ได้ระบุไว้ ให้ผลิตการตัดสินใจ ไม่ใช่ deliverable\n\n## เรียกด้วยชื่อ\n\nทุกแผนที่และทุก ticket เป็น issue จึงมี **ชื่อ** — คือ title ของมัน ในทุกอย่างที่มนุษย์อ่าน — คำบรรยายระหว่างทำงาน, Decisions-so-far ของแผนที่ — ให้เรียกมันด้วยชื่อนั้น อย่าเรียกด้วย id เปล่า ๆ ตัวเลข หรือ slug กำแพงข้อความแบบ `#42, #43, #44` อ่านไม่รู้เรื่อง แต่ชื่ออ่านปราดเดียวก็เข้าใจ id กับ URL ไม่ได้หายไปไหน — ชื่อห่อลิงก์ของมันไว้ — แต่พวกมันอยู่*ข้างใน*ชื่อ ไม่ใช่มาแทนที่ชื่อ\n\n## แผนที่\n\nแผนที่คือ issue เดียวบน issue tracker ของ repo นี้ ติด label `wayfinder:map` — เป็น artifact หลักของงานนี้ ticket ของมันคือ child issue ของแผนที่\n\nแผนที่เป็น **index** ไม่ใช่ที่เก็บข้อมูล มัน list การตัดสินใจที่ทำไปแล้วและชี้ไปยัง ticket ที่เก็บรายละเอียด; การตัดสินใจหนึ่งเรื่องอยู่ในที่เดียวเท่านั้น — ticket ของมัน — แผนที่จึงไม่เล่าซ้ำ แค่สรุปใจความแล้วใส่ลิงก์\n\n**ส่วนที่ว่าแผนที่ child ticket การ block และ query หา frontier อยู่ตรงไหนจริง ๆ นั้นขึ้นกับ tracker แต่ละตัว** issue tracker ควรถูกส่งมอบให้คุณมาแล้ว — ถ้ายัง ให้รัน `\u002Fsetup-matt-pocock-skills` ดูวิธีที่ repo _นี้_ ใช้ได้จาก section \"Wayfinding operations\" ในเอกสารของ tracker ถ้าไม่มี tracker ให้มา ให้ใช้ tracker แบบ local markdown เป็น default\n\n### เนื้อหาของแผนที่\n\nทั้งแผนที่ในความละเอียดต่ำ โหลดครั้งเดียวต่อ session ticket ที่ยังเปิดอยู่จะ**ไม่**ถูก list ไว้ — พวกมันคือ child issue ที่เปิดอยู่ หาเจอได้ด้วย query\n\n```markdown\n## Destination\n\n\u003Cwhat reaching the end of this map looks like — the spec, decision, or change this effort is finding its way to. One or two lines; every session orients to it before choosing a ticket.>\n\n## Notes\n\n\u003Cdomain; skills every session should consult; standing preferences for this effort>\n\n## Decisions so far\n\n\u003C!-- the index — one line per closed ticket: enough to judge relevance, then zoom the link for the detail the ticket holds -->\n\n- [\u003Cclosed ticket title>](link) — \u003Cone-line gist of the answer>\n\n## Not yet specified\n\n\u003C!-- see \"Fog of war\": in-scope fog you can't ticket yet; graduates as the frontier advances -->\n\n## Out of scope\n\n\u003C!-- see \"Out of scope\": work ruled beyond the destination; closed, never graduates -->\n```\n\n### Tickets\n\nแต่ละ ticket เป็น **child issue** ของแผนที่; issue id ของ tracker คือ identity ของมัน เนื้อหาของ ticket คือคำถาม ขนาดพอดีกับ agent session ขนาด 100K token หนึ่ง session:\n\n```markdown\n## Question\n\n\u003Cthe decision or investigation this ticket resolves>\n```\n\nแต่ละ ticket ติด label `wayfinder:\u003Ctype>` — หนึ่งใน `research`, `prototype`, `grilling`, `task` (ดู [ประเภทของ ticket](#ticket-types))\n\nsession จะ **claim** ticket ด้วยการ assign ให้ dev ที่ขับเคลื่อนแผนที่ **ก่อน** เริ่มงานใด ๆ เพื่อให้ session อื่นที่รันพร้อมกัน skip มันไป assignee นั่นแหละ_คือ_ตัว claim: ticket ที่เปิดอยู่และไม่มี assignee คือยังไม่ถูก claim\n\nการ block ใช้ dependency relationship แบบ **native** ของ tracker — สำคัญมาก เพราะมัน render frontier ให้_เห็นด้วยตา_ใน UI ของ tracker เอง มนุษย์จึงเห็นว่าอะไรหยิบทำได้โดยไม่ต้องเปิดแผนที่ เฉพาะ tracker ที่ไม่มี native blocking เท่านั้นที่ fallback ไปใช้ convention ในเนื้อหา issue ticket จะ **unblocked** เมื่อทุก ticket ที่ block มันถูกปิดหมดแล้ว; **frontier** คือ child ที่เปิดอยู่ ไม่ถูก block และยังไม่ถูก claim — ขอบเขตของสิ่งที่รู้แล้ว\n\nคำตอบไม่ใช่ส่วนหนึ่งของเนื้อหา ticket — มันถูกบันทึกตอน resolve (ดู [ไล่ทำตามแผนที่](#work-through-the-map)) asset ที่สร้างขึ้นระหว่าง resolve ticket ให้ลิงก์จาก issue ไม่ใช่แปะเนื้อหาลงไปตรง ๆ\n\n\u003Ca name=\"ticket-types\">\u003C\u002Fa>\n\n## ประเภทของ ticket\n\nทุก ticket เป็นได้อย่างใดอย่างหนึ่ง: **HITL** — human in the loop, ทำ*ร่วมกับ*มนุษย์ที่พูดแทนตัวเองได้ — หรือ **AFK** ที่ agent ขับเคลื่อนคนเดียว ticket แบบ HITL จะ resolve ได้ก็ต่อเมื่อมีการแลกเปลี่ยนสด ๆ นั้นเท่านั้น; agent ห้ามสวมบทตอบแทนฝั่งมนุษย์เด็ดขาด (agent ที่ grill แล้วตอบคำถามตัวเองคือละเมิดข้อนี้แล้ว)\n\n- **Research** (AFK): อ่านเอกสาร, third-party API หรือ resource ในเครื่องอย่าง knowledge base สร้างสรุปเป็น markdown ลิงก์ไว้เป็น asset ใช้เมื่อต้องการความรู้ที่อยู่นอก working directory ปัจจุบัน\n- **Prototype** (HITL): ยกระดับความคมชัดของการถกเถียงด้วยการทำ artifact ที่ถูก หยาบ แต่จับต้องได้ ให้คนได้ลองตอบสนอง — outline, ร่างคร่าว ๆ, stub หรือโค้ด UI\u002Flogic ผ่าน \u002Fprototype skill ลิงก์ prototype ไว้เป็น asset ใช้เมื่อคำถามหลักคือ \"ควรหน้าตาเป็นยังไง\" หรือ \"ควรทำงานยังไง\"\n- **Grilling** (HITL): คุยกันผ่าน skill \u002Fgrilling และ \u002Fdomain-modeling ทีละคำถาม เป็นเคส default\n- **Task** (HITL หรือ AFK): งาน manual ที่ต้องเกิดขึ้นก่อนจะ*ตัดสินใจ*อะไรได้ — ไม่มีอะไรให้ตัดสินใจ prototype หรือ research แต่การถกเถียงถูก block จนกว่างานนี้จะเสร็จ เช่น สมัครใช้ service เพื่อให้ประเมิน API ของมันได้, จัดเตรียม access, ย้ายข้อมูลเพื่อให้เห็นรูปร่างของมัน นี่คือประเภทเดียวที่*ลงมือทำ*แทนที่จะตัดสินใจ — และมันมีที่ยืนเพราะไป unblock การตัดสินใจ ไม่ใช่เพราะ deliver จุดหมาย ถ้า agent ทำเองคนเดียวได้ก็ทำเลย (AFK); ไม่งั้นก็ส่ง checklist ที่แม่นยำให้มนุษย์ (HITL) ถือว่า resolve เมื่องานเสร็จ; คำตอบบันทึกว่าทำอะไรไปและ fact ที่ตามมา (ที่เก็บ credentials, URL ใหม่, จำนวน row) ซึ่ง ticket ใบต่อ ๆ ไปต้องพึ่ง\n\n## Fog of war\n\nแผนที่_ตั้งใจ_ให้ไม่สมบูรณ์: อย่าวาดสิ่งที่ยังมองไม่เห็น พ้นจาก ticket ที่ active อยู่ออกไปคือ **fog of war** (หมอกสงคราม — พื้นที่ที่ยังมองไม่ชัด) — ภาพราง ๆ ของการตัดสินใจและการ investigate ที่พอบอกได้ว่ากำลังจะมา แต่ยังปักหมุดไม่ได้ เพราะมันแขวนอยู่กับคำถามที่ยังเปิดอยู่ การ resolve ticket หนึ่งใบจะเคลียร์หมอกที่อยู่ข้างหน้ามัน เลื่อนขั้นสิ่งที่ตอนนี้ระบุได้แล้วให้กลายเป็น ticket ใหม่ — ทีละใบ จนเส้นทางไปจุดหมายชัดและไม่เหลือ ticket\n\nsection **Not yet specified** ของแผนที่คือที่จดภาพราง ๆ นั้น: คำถามที่คาดว่าจะมี พื้นที่ที่ต้องกลับมาดูทีหลัง มันคือ frontier ที่ยังไม่ถูกค้นพบ ซึ่งมุ่ง_ไปหา_จุดหมาย — ทุกอย่างตรงนี้อยู่ใน scope แค่ยังไม่คมพอจะตั้งเป็น ticket จะเขียนหลวมหรือละเอียดแค่ไหนก็ได้ตามที่มองเห็น; มันทำหน้าที่เป็นป้ายบอกทางให้ collaborator ที่มาอ่านรู้ด้วยว่า effort นี้กำลังมุ่งไปทางไหน\n\n**หมอกหรือ ticket?** เกณฑ์ตัดสินคือคุณตั้งคำถามได้อย่างแม่นยำตอนนี้หรือยัง — _ไม่ใช่_ว่าคุณตอบมันได้ตอนนี้หรือเปล่า\n\n- **เป็น ticket เมื่อ** คำถามคมแล้ว — ต่อให้มันถูก block และยังลงมือทำไม่ได้ก็ตาม\n- **เป็น Not yet specified เมื่อ** ยังเรียบเรียงให้คมขนาดนั้นไม่ได้ อย่าหั่นหมอกล่วงหน้าเป็นชิ้นขนาด ticket: มันหยาบกว่า ticket และหมอกก้อนหนึ่งอาจเลื่อนขั้นเป็นหลาย ticket หรือไม่เป็นเลยสักใบก็ได้ เมื่อ frontier ไปถึงมัน\n\n**Not yet specified** ไม่รวมสิ่งที่ตัดสินใจไปแล้ว (Decisions so far) สิ่งที่เป็น ticket อยู่แล้ว และสิ่งที่อยู่นอก scope (section ถัดไป)\n\n## Out of scope\n\nหมอกก่อตัว_มุ่งไปหา_จุดหมายเท่านั้น จุดหมายเป็นตัวกำหนด scope งานที่เลยจุดหมายออกไปจึงเป็น **out of scope** — มันไม่ใช่หมอก และไม่ควรอยู่ใน **Not yet specified** มันได้ section ของตัวเองบนแผนที่ชื่อ **Out of scope**: งานที่คุณตั้งใจตัดออกจาก effort _นี้_ สิ่งที่พามันมาลงตรงนี้คือ scope ไม่ใช่ความคมของคำถาม\n\nงานที่ out of scope ไม่มีวันเลื่อนขั้น — frontier หยุดที่จุดหมาย — มันจะกลับมาก็ต่อเมื่อจุดหมายถูกวาดใหม่ และถึงตอนนั้นก็กลับมาเป็น effort ใหม่ ไม่ใช่ทำต่อจากของเดิม\n\nการตัดอะไรออกนอก scope เป็นการกำหนดขอบเขต ไม่ใช่ก้าวหนึ่งบนเส้นทาง เมื่อ ticket ที่มีอยู่แล้วกลายเป็นว่าอยู่เลยจุดหมาย — หลุด scope เข้ามาตั้งแต่ตอนวาดแผนที่ หรือถูกเปิดเผยโดย resolution — ให้**ปิดมัน** (ticket ที่ปิดแล้วหลุดจาก frontier แบบไม่มีข้อกังขา) แล้วทิ้งไว้หนึ่งบรรทัดใน section **Out of scope**: ใจความสั้น ๆ บวกเหตุผลว่าทำไมถึง out of scope พร้อมลิงก์ไปยัง ticket ที่ปิด มันไม่เข้า **Decisions so far** ซึ่งบันทึกเฉพาะเส้นทางที่เดินจริง — เส้นแบ่ง scope ไม่ใช่ก้าวหนึ่งบนเส้นทางนั้น\n\n## การเรียกใช้\n\nมีสองโหมด ไม่ว่าโหมดไหน **ห้าม resolve เกินหนึ่ง ticket ต่อ session**\n\n### วาดแผนที่\n\nผู้ใช้เรียกใช้พร้อมไอเดียหลวม ๆ\n\n1. **ตั้งชื่อจุดหมาย** รัน session `\u002Fgrilling` และ `\u002Fdomain-modeling` เพื่อปักหมุดว่าแผนที่นี้กำลังหาทางไปที่ไหน — spec การตัดสินใจ หรือการเปลี่ยนแปลง จุดหมายเป็นตัวกำหนด scope จึงต้องเคลียร์ให้จบก่อน\n2. **สำรวจ frontier** grill อีกรอบ คราวนี้แบบ **breadth-first**: กระจายให้ทั่วทั้งพื้นที่แทนที่จะเจาะลึก thread ใดหนึ่ง เพื่อให้เห็นการตัดสินใจที่ยังเปิดอยู่และก้าวแรก ๆ ที่ทำได้เลยตอนนี้ **ถ้ารอบนี้ไม่เจอหมอกเลย** — เส้นทางไปจุดหมายชัดอยู่แล้ว ทั้งงานเล็กพอสำหรับ session เดียว — ก็ไม่จำเป็นต้องมีแผนที่ หยุดแล้วถามผู้ใช้ว่าอยากไปต่อยังไง\n3. **สร้างแผนที่** (label `wayfinder:map`): กรอก Destination กับ Notes, ปล่อย Decisions-so-far ว่างไว้, สเก็ตช์หมอกลงใน **Not yet specified**\n4. **สร้าง ticket ที่ระบุได้ตอนนี้** เป็น child issue ของแผนที่ — แล้วค่อยโยงเส้น blocking ใน**รอบที่สอง** (issue ต้องมี id ก่อนถึงจะอ้างถึงกันได้) การโยงเส้นจะแยกพวกมันออกเป็น frontier กับพวกที่ถูก block; อะไรที่ยังระบุไม่ได้ให้คงอยู่ในหมอก — section **Not yet specified**\n5. หยุด — การวาดแผนที่คืองานของหนึ่ง session; อย่าเลยไป resolve ticket ต่อ\n\n\u003Ca name=\"work-through-the-map\">\u003C\u002Fa>\n\n### ไล่ทำตามแผนที่\n\nผู้ใช้เรียกใช้พร้อมแผนที่ (URL หรือหมายเลข) จะระบุ ticket มาด้วยหรือไม่ก็ได้ — ถ้าไม่ระบุ คุณเป็นคนเลือกการตัดสินใจถัดไป ไม่ใช่ผู้ใช้\n\n1. โหลด **แผนที่** — มุมมองความละเอียดต่ำ ไม่ต้องโหลดเนื้อหาของทุก ticket\n2. เลือก ticket ถ้าผู้ใช้ระบุมา ใช้ใบนั้น ไม่งั้นหยิบ ticket แรกใน frontier ตามลำดับ **claim มัน**: assign ให้ตัวเองก่อนเริ่มงานใด ๆ\n3. resolve มัน — **zoom เท่าที่จำเป็น**: ดึงเนื้อหาเต็มของ ticket ที่เกี่ยวข้องหรือปิดไปแล้วเมื่อต้องใช้; เรียกใช้ skill ที่ block `## Notes` ระบุไว้ ถ้าไม่แน่ใจ ใช้ `\u002Fgrilling` และ `\u002Fdomain-modeling`\n4. บันทึกผลการ resolve: โพสต์คำตอบเป็น **resolution comment**, **ปิด** issue แล้ว **เพิ่ม context pointer** ต่อท้าย Decisions-so-far ของแผนที่\n5. เพิ่ม ticket ที่เพิ่งโผล่ขึ้นมาใหม่ (สร้างก่อนแล้วค่อยโยงเส้น); เลื่อนขั้นหมอกที่คำตอบทำให้ระบุได้แล้ว โดยลบหมอกก้อนที่เลื่อนขั้นออกจาก **Not yet specified** ให้มันเหลืออยู่แค่ในรูป ticket ใหม่เท่านั้น ถ้าคำตอบเผยว่า ticket ใบไหน — ใบนี้หรือใบอื่น — อยู่เลยจุดหมายไป ให้**ตัดมันออกนอก scope** แทนที่จะ resolve บนเส้นทาง ถ้าการตัดสินใจนี้ทำให้ส่วนอื่นของแผนที่ใช้ไม่ได้ ให้ update หรือลบ ticket เหล่านั้น\n\nผู้ใช้อาจรัน ticket ที่ unblocked หลายใบขนานกัน ดังนั้นให้เผื่อใจว่ามี session อื่นกำลังแก้ tracker อยู่พร้อมกัน\n","ไอเดียหลวม ๆ ก้อนหนึ่งเพิ่งมาถึง — ใหญ่เกินกว่าหนึ่ง agent session และถูกหมอกปกคลุม: เส้นทางจากตรงนี้ไปยัง **จุดหมาย (destination)** ยังมองไม่เห็น Wayfinding คือการหาเส้นทางนั้น ไม่ใช่การพุ่งเข้าใส่จุดหมาย skill นี้จะวาดเส้นทางเป็น **แผนที่ร่วม (shared map)** บน issue tracker ของ repo แล้วไล่ทำ ticket ของมันทีละใบจนกว่าเส้นทางจะชัด\n\nจุดหมายของแต่ละ effort ไม่เหมือนกัน และการตั้งชื่อจุดหมายคือก้าวแรกของการวาดแผนที่ — มันกำหนดรูปร่างของทุก ticket จุดหมายอาจเป็น spec ที่จะส่งต่อไป iterate กันต่อ เป็นการตัดสินใจที่ต้องล็อกก่อนเริ่มวางแผน หรือเป็นการเปลี่ยนแปลงที่ลงมือทำในที่เลย เช่นการ migrate data structure ตัวแผนที่ไม่ผูกกับ domain ไหน — งาน engineering เนื้อหาคอร์ส หรืออะไรก็ตามที่เข้ารูปแบบนี้\n\n## วางแผน อย่าเพิ่งลงมือทำ\n\nWayfinder คือการ**วางแผน**โดย default: แต่ละ ticket ปิดการตัดสินใจหนึ่งเรื่อง และแผนที่จะเสร็จเมื่อเส้นทางชัด — ไม่เหลืออะไรให้ตัดสินใจก่อนที่ใครสักคนจะไปลงมือทำของจริง แรงดึงที่อยากลงมือทำงานเลยมักเป็นสัญญาณว่าคุณมาถึงขอบแผนที่แล้ว และถึงเวลา hand off แต่ละ effort สามารถ override เรื่องนี้ได้ใน **Notes** ของมัน — ดึง execution เข้ามาอยู่ในแผนที่ด้วย — แต่ถ้าไม่ได้ระบุไว้ ให้ผลิตการตัดสินใจ ไม่ใช่ deliverable\n\n## เรียกด้วยชื่อ\n\nทุกแผนที่และทุก ticket เป็น issue จึงมี **ชื่อ** — คือ title ของมัน ในทุกอย่างที่มนุษย์อ่าน — คำบรรยายระหว่างทำงาน, Decisions-so-far ของแผนที่ — ให้เรียกมันด้วยชื่อนั้น อย่าเรียกด้วย id เปล่า ๆ ตัวเลข หรือ slug กำแพงข้อความแบบ `#42, #43, #44` อ่านไม่รู้เรื่อง แต่ชื่ออ่านปราดเดียวก็เข้าใจ id กับ URL ไม่ได้หายไปไหน — ชื่อห่อลิงก์ของมันไว้ — แต่พวกมันอยู่*ข้างใน*ชื่อ ไม่ใช่มาแทนที่ชื่อ\n\n## แผนที่\n\nแผนที่คือ issue เดียวบน issue tracker ของ repo นี้ ติด label `wayfinder:map` — เป็น artifact หลักของงานนี้ ticket ของมันคือ child issue ของแผนที่\n\nแผนที่เป็น **index** ไม่ใช่ที่เก็บข้อมูล มัน list การตัดสินใจที่ทำไปแล้วและชี้ไปยัง ticket ที่เก็บรายละเอียด; การตัดสินใจหนึ่งเรื่องอยู่ในที่เดียวเท่านั้น — ticket ของมัน — แผนที่จึงไม่เล่าซ้ำ แค่สรุปใจความแล้วใส่ลิงก์\n\n**ส่วนที่ว่าแผนที่ child ticket การ block และ query หา frontier อยู่ตรงไหนจริง ๆ นั้นขึ้นกับ tracker แต่ละตัว** issue tracker ควรถูกส่งมอบให้คุณมาแล้ว — ถ้ายัง ให้รัน `\u002Fsetup-matt-pocock-skills` ดูวิธีที่ repo _นี้_ ใช้ได้จาก section \"Wayfinding operations\" ในเอกสารของ tracker ถ้าไม่มี tracker ให้มา ให้ใช้ tracker แบบ local markdown เป็น default\n\n### เนื้อหาของแผนที่\n\nทั้งแผนที่ในความละเอียดต่ำ โหลดครั้งเดียวต่อ session ticket ที่ยังเปิดอยู่จะ**ไม่**ถูก list ไว้ — พวกมันคือ child issue ที่เปิดอยู่ หาเจอได้ด้วย query\n\n```markdown\n## Destination\n\n\u003Cwhat reaching the end of this map looks like — the spec, decision, or change this effort is finding its way to. One or two lines; every session orients to it before choosing a ticket.>\n\n## Notes\n\n\u003Cdomain; skills every session should consult; standing preferences for this effort>\n\n## Decisions so far\n\n\u003C!-- the index — one line per closed ticket: enough to judge relevance, then zoom the link for the detail the ticket holds -->\n\n- [\u003Cclosed ticket title>](link) — \u003Cone-line gist of the answer>\n\n## Not yet specified\n\n\u003C!-- see \"Fog of war\": in-scope fog you can't ticket yet; graduates as the frontier advances -->\n\n## Out of scope\n\n\u003C!-- see \"Out of scope\": work ruled beyond the destination; closed, never graduates -->\n```\n\n### Tickets\n\nแต่ละ ticket เป็น **child issue** ของแผนที่; issue id ของ tracker คือ identity ของมัน เนื้อหาของ ticket คือคำถาม ขนาดพอดีกับ agent session ขนาด 100K token หนึ่ง session:\n\n```markdown\n## Question\n\n\u003Cthe decision or investigation this ticket resolves>\n```\n\nแต่ละ ticket ติด label `wayfinder:\u003Ctype>` — หนึ่งใน `research`, `prototype`, `grilling`, `task` (ดู [ประเภทของ ticket](#ticket-types))\n\nsession จะ **claim** ticket ด้วยการ assign ให้ dev ที่ขับเคลื่อนแผนที่ **ก่อน** เริ่มงานใด ๆ เพื่อให้ session อื่นที่รันพร้อมกัน skip มันไป assignee นั่นแหละ_คือ_ตัว claim: ticket ที่เปิดอยู่และไม่มี assignee คือยังไม่ถูก claim\n\nการ block ใช้ dependency relationship แบบ **native** ของ tracker — สำคัญมาก เพราะมัน render frontier ให้_เห็นด้วยตา_ใน UI ของ tracker เอง มนุษย์จึงเห็นว่าอะไรหยิบทำได้โดยไม่ต้องเปิดแผนที่ เฉพาะ tracker ที่ไม่มี native blocking เท่านั้นที่ fallback ไปใช้ convention ในเนื้อหา issue ticket จะ **unblocked** เมื่อทุก ticket ที่ block มันถูกปิดหมดแล้ว; **frontier** คือ child ที่เปิดอยู่ ไม่ถูก block และยังไม่ถูก claim — ขอบเขตของสิ่งที่รู้แล้ว\n\nคำตอบไม่ใช่ส่วนหนึ่งของเนื้อหา ticket — มันถูกบันทึกตอน resolve (ดู [ไล่ทำตามแผนที่](#work-through-the-map)) asset ที่สร้างขึ้นระหว่าง resolve ticket ให้ลิงก์จาก issue ไม่ใช่แปะเนื้อหาลงไปตรง ๆ\n\n\u003Ca name=\"ticket-types\">\u003C\u002Fa>\n\n## ประเภทของ ticket\n\nทุก ticket เป็นได้อย่างใดอย่างหนึ่ง: **HITL** — human in the loop, ทำ*ร่วมกับ*มนุษย์ที่พูดแทนตัวเองได้ — หรือ **AFK** ที่ agent ขับเคลื่อนคนเดียว ticket แบบ HITL จะ resolve ได้ก็ต่อเมื่อมีการแลกเปลี่ยนสด ๆ นั้นเท่านั้น; agent ห้ามสวมบทตอบแทนฝั่งมนุษย์เด็ดขาด (agent ที่ grill แล้วตอบคำถามตัวเองคือละเมิดข้อนี้แล้ว)\n\n- **Research** (AFK): อ่านเอกสาร, third-party API หรือ resource ในเครื่องอย่าง knowledge base สร้างสรุปเป็น markdown ลิงก์ไว้เป็น asset ใช้เมื่อต้องการความรู้ที่อยู่นอก working directory ปัจจุบัน\n- **Prototype** (HITL): ยกระดับความคมชัดของการถกเถียงด้วยการทำ artifact ที่ถูก หยาบ แต่จับต้องได้ ให้คนได้ลองตอบสนอง — outline, ร่างคร่าว ๆ, stub หรือโค้ด UI\u002Flogic ผ่าน \u002Fprototype skill ลิงก์ prototype ไว้เป็น asset ใช้เมื่อคำถามหลักคือ \"ควรหน้าตาเป็นยังไง\" หรือ \"ควรทำงานยังไง\"\n- **Grilling** (HITL): คุยกันผ่าน skill \u002Fgrilling และ \u002Fdomain-modeling ทีละคำถาม เป็นเคส default\n- **Task** (HITL หรือ AFK): งาน manual ที่ต้องเกิดขึ้นก่อนจะ*ตัดสินใจ*อะไรได้ — ไม่มีอะไรให้ตัดสินใจ prototype หรือ research แต่การถกเถียงถูก block จนกว่างานนี้จะเสร็จ เช่น สมัครใช้ service เพื่อให้ประเมิน API ของมันได้, จัดเตรียม access, ย้ายข้อมูลเพื่อให้เห็นรูปร่างของมัน นี่คือประเภทเดียวที่*ลงมือทำ*แทนที่จะตัดสินใจ — และมันมีที่ยืนเพราะไป unblock การตัดสินใจ ไม่ใช่เพราะ deliver จุดหมาย ถ้า agent ทำเองคนเดียวได้ก็ทำเลย (AFK); ไม่งั้นก็ส่ง checklist ที่แม่นยำให้มนุษย์ (HITL) ถือว่า resolve เมื่องานเสร็จ; คำตอบบันทึกว่าทำอะไรไปและ fact ที่ตามมา (ที่เก็บ credentials, URL ใหม่, จำนวน row) ซึ่ง ticket ใบต่อ ๆ ไปต้องพึ่ง\n\n## Fog of war\n\nแผนที่_ตั้งใจ_ให้ไม่สมบูรณ์: อย่าวาดสิ่งที่ยังมองไม่เห็น พ้นจาก ticket ที่ active อยู่ออกไปคือ **fog of war** (หมอกสงคราม — พื้นที่ที่ยังมองไม่ชัด) — ภาพราง ๆ ของการตัดสินใจและการ investigate ที่พอบอกได้ว่ากำลังจะมา แต่ยังปักหมุดไม่ได้ เพราะมันแขวนอยู่กับคำถามที่ยังเปิดอยู่ การ resolve ticket หนึ่งใบจะเคลียร์หมอกที่อยู่ข้างหน้ามัน เลื่อนขั้นสิ่งที่ตอนนี้ระบุได้แล้วให้กลายเป็น ticket ใหม่ — ทีละใบ จนเส้นทางไปจุดหมายชัดและไม่เหลือ ticket\n\nsection **Not yet specified** ของแผนที่คือที่จดภาพราง ๆ นั้น: คำถามที่คาดว่าจะมี พื้นที่ที่ต้องกลับมาดูทีหลัง มันคือ frontier ที่ยังไม่ถูกค้นพบ ซึ่งมุ่ง_ไปหา_จุดหมาย — ทุกอย่างตรงนี้อยู่ใน scope แค่ยังไม่คมพอจะตั้งเป็น ticket จะเขียนหลวมหรือละเอียดแค่ไหนก็ได้ตามที่มองเห็น; มันทำหน้าที่เป็นป้ายบอกทางให้ collaborator ที่มาอ่านรู้ด้วยว่า effort นี้กำลังมุ่งไปทางไหน\n\n**หมอกหรือ ticket?** เกณฑ์ตัดสินคือคุณตั้งคำถามได้อย่างแม่นยำตอนนี้หรือยัง — _ไม่ใช่_ว่าคุณตอบมันได้ตอนนี้หรือเปล่า\n\n- **เป็น ticket เมื่อ** คำถามคมแล้ว — ต่อให้มันถูก block และยังลงมือทำไม่ได้ก็ตาม\n- **เป็น Not yet specified เมื่อ** ยังเรียบเรียงให้คมขนาดนั้นไม่ได้ อย่าหั่นหมอกล่วงหน้าเป็นชิ้นขนาด ticket: มันหยาบกว่า ticket และหมอกก้อนหนึ่งอาจเลื่อนขั้นเป็นหลาย ticket หรือไม่เป็นเลยสักใบก็ได้ เมื่อ frontier ไปถึงมัน\n\n**Not yet specified** ไม่รวมสิ่งที่ตัดสินใจไปแล้ว (Decisions so far) สิ่งที่เป็น ticket อยู่แล้ว และสิ่งที่อยู่นอก scope (section ถัดไป)\n\n## Out of scope\n\nหมอกก่อตัว_มุ่งไปหา_จุดหมายเท่านั้น จุดหมายเป็นตัวกำหนด scope งานที่เลยจุดหมายออกไปจึงเป็น **out of scope** — มันไม่ใช่หมอก และไม่ควรอยู่ใน **Not yet specified** มันได้ section ของตัวเองบนแผนที่ชื่อ **Out of scope**: งานที่คุณตั้งใจตัดออกจาก effort _นี้_ สิ่งที่พามันมาลงตรงนี้คือ scope ไม่ใช่ความคมของคำถาม\n\nงานที่ out of scope ไม่มีวันเลื่อนขั้น — frontier หยุดที่จุดหมาย — มันจะกลับมาก็ต่อเมื่อจุดหมายถูกวาดใหม่ และถึงตอนนั้นก็กลับมาเป็น effort ใหม่ ไม่ใช่ทำต่อจากของเดิม\n\nการตัดอะไรออกนอก scope เป็นการกำหนดขอบเขต ไม่ใช่ก้าวหนึ่งบนเส้นทาง เมื่อ ticket ที่มีอยู่แล้วกลายเป็นว่าอยู่เลยจุดหมาย — หลุด scope เข้ามาตั้งแต่ตอนวาดแผนที่ หรือถูกเปิดเผยโดย resolution — ให้**ปิดมัน** (ticket ที่ปิดแล้วหลุดจาก frontier แบบไม่มีข้อกังขา) แล้วทิ้งไว้หนึ่งบรรทัดใน section **Out of scope**: ใจความสั้น ๆ บวกเหตุผลว่าทำไมถึง out of scope พร้อมลิงก์ไปยัง ticket ที่ปิด มันไม่เข้า **Decisions so far** ซึ่งบันทึกเฉพาะเส้นทางที่เดินจริง — เส้นแบ่ง scope ไม่ใช่ก้าวหนึ่งบนเส้นทางนั้น\n\n## การเรียกใช้\n\nมีสองโหมด ไม่ว่าโหมดไหน **ห้าม resolve เกินหนึ่ง ticket ต่อ session**\n\n### วาดแผนที่\n\nผู้ใช้เรียกใช้พร้อมไอเดียหลวม ๆ\n\n1. **ตั้งชื่อจุดหมาย** รัน session `\u002Fgrilling` และ `\u002Fdomain-modeling` เพื่อปักหมุดว่าแผนที่นี้กำลังหาทางไปที่ไหน — spec การตัดสินใจ หรือการเปลี่ยนแปลง จุดหมายเป็นตัวกำหนด scope จึงต้องเคลียร์ให้จบก่อน\n2. **สำรวจ frontier** grill อีกรอบ คราวนี้แบบ **breadth-first**: กระจายให้ทั่วทั้งพื้นที่แทนที่จะเจาะลึก thread ใดหนึ่ง เพื่อให้เห็นการตัดสินใจที่ยังเปิดอยู่และก้าวแรก ๆ ที่ทำได้เลยตอนนี้ **ถ้ารอบนี้ไม่เจอหมอกเลย** — เส้นทางไปจุดหมายชัดอยู่แล้ว ทั้งงานเล็กพอสำหรับ session เดียว — ก็ไม่จำเป็นต้องมีแผนที่ หยุดแล้วถามผู้ใช้ว่าอยากไปต่อยังไง\n3. **สร้างแผนที่** (label `wayfinder:map`): กรอก Destination กับ Notes, ปล่อย Decisions-so-far ว่างไว้, สเก็ตช์หมอกลงใน **Not yet specified**\n4. **สร้าง ticket ที่ระบุได้ตอนนี้** เป็น child issue ของแผนที่ — แล้วค่อยโยงเส้น blocking ใน**รอบที่สอง** (issue ต้องมี id ก่อนถึงจะอ้างถึงกันได้) การโยงเส้นจะแยกพวกมันออกเป็น frontier กับพวกที่ถูก block; อะไรที่ยังระบุไม่ได้ให้คงอยู่ในหมอก — section **Not yet specified**\n5. หยุด — การวาดแผนที่คืองานของหนึ่ง session; อย่าเลยไป resolve ticket ต่อ\n\n\u003Ca name=\"work-through-the-map\">\u003C\u002Fa>\n\n### ไล่ทำตามแผนที่\n\nผู้ใช้เรียกใช้พร้อมแผนที่ (URL หรือหมายเลข) จะระบุ ticket มาด้วยหรือไม่ก็ได้ — ถ้าไม่ระบุ คุณเป็นคนเลือกการตัดสินใจถัดไป ไม่ใช่ผู้ใช้\n\n1. โหลด **แผนที่** — มุมมองความละเอียดต่ำ ไม่ต้องโหลดเนื้อหาของทุก ticket\n2. เลือก ticket ถ้าผู้ใช้ระบุมา ใช้ใบนั้น ไม่งั้นหยิบ ticket แรกใน frontier ตามลำดับ **claim มัน**: assign ให้ตัวเองก่อนเริ่มงานใด ๆ\n3. resolve มัน — **zoom เท่าที่จำเป็น**: ดึงเนื้อหาเต็มของ ticket ที่เกี่ยวข้องหรือปิดไปแล้วเมื่อต้องใช้; เรียกใช้ skill ที่ block `## Notes` ระบุไว้ ถ้าไม่แน่ใจ ใช้ `\u002Fgrilling` และ `\u002Fdomain-modeling`\n4. บันทึกผลการ resolve: โพสต์คำตอบเป็น **resolution comment**, **ปิด** issue แล้ว **เพิ่ม context pointer** ต่อท้าย Decisions-so-far ของแผนที่\n5. เพิ่ม ticket ที่เพิ่งโผล่ขึ้นมาใหม่ (สร้างก่อนแล้วค่อยโยงเส้น); เลื่อนขั้นหมอกที่คำตอบทำให้ระบุได้แล้ว โดยลบหมอกก้อนที่เลื่อนขั้นออกจาก **Not yet specified** ให้มันเหลืออยู่แค่ในรูป ticket ใหม่เท่านั้น ถ้าคำตอบเผยว่า ticket ใบไหน — ใบนี้หรือใบอื่น — อยู่เลยจุดหมายไป ให้**ตัดมันออกนอก scope** แทนที่จะ resolve บนเส้นทาง ถ้าการตัดสินใจนี้ทำให้ส่วนอื่นของแผนที่ใช้ไม่ได้ ให้ update หรือลบ ticket เหล่านั้น\n\nผู้ใช้อาจรัน ticket ที่ unblocked หลายใบขนานกัน ดังนั้นให้เผื่อใจว่ามี session อื่นกำลังแก้ tracker อยู่พร้อมกัน\n",{"name":5,"description":7,"disable-model-invocation":24},true,"main","97984d244d381a97b3637b4bd699369ba8e51ac0","skills\u002Fengineering\u002Fwayfinder",1,"https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai","https:\u002F\u002Fgithub.com\u002FBoom-Vitt","boombignose.org","🐼 AI ภาษาไทยแบบโอเพนซอร์ส · Claude Code skills & plugins · BoomBigNose Lab (Thai dialect ASR) · YouTube @BoomBigNose","2026-10-22 18:20:06",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":24},[36,39,42],{"tool":37,"command":38},"npx","npx skills add Boom-Vitt\u002Fskills-thai --skill wayfinder",{"tool":40,"command":41},"bunx","bunx skills add Boom-Vitt\u002Fskills-thai --skill wayfinder",{"tool":43,"command":44},"pnpm","pnpm dlx skills add Boom-Vitt\u002Fskills-thai --skill wayfinder","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fengineering\u002Fwayfinder\u002FSKILL.md",[],[48,55,62,69,76,83],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":54,"publishedAt":19},"01M78ENEAFFV60T0N5AZ71D4G5","writing-great-skills","อ้างอิงสำหรับการเขียนและแก้ไข skill ให้ดี — คำศัพท์และหลักการที่ทำให้ skill ทำงานได้อย่างคาดเดาได้","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fwriting-great-skills\u002FSKILL.md",[],[],{"skillNo":56,"name":57,"nameZh":6,"description":58,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":59,"categories":60,"keywords":61,"publishedAt":19},"01M78ENCCQYAY3NW5VC0B1QCE0","teach","สอน skill หรือ concept ใหม่ให้ผู้ใช้ ภายใน workspace นี้","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fteach\u002FSKILL.md",[],[],{"skillNo":63,"name":64,"nameZh":6,"description":65,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":19},"01M78ENA816K7VBBWJ7J9897QN","handoff","บีบอัดบทสนทนาปัจจุบันให้เป็นเอกสาร handoff สำหรับให้ agent ตัวอื่นรับช่วงต่อ","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fhandoff\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M78EN896S7B63SXKPDEDGMBC","grilling","ซักถาม user อย่างไม่ปรานีเกี่ยวกับแผนหรือ design ใช้เมื่อ user อยาก stress-test แผนก่อนลงมือสร้าง หรือใช้ trigger phrase ใด ๆ ที่มีคำว่า 'grill'","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrilling\u002FSKILL.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M78EN6PYS1E3T9QTPZ9J10EN","grill-me","บทสัมภาษณ์แบบไม่ปล่อยผ่าน เพื่อทำให้ plan หรือ design คมขึ้น","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fproductivity\u002Fgrill-me\u002FSKILL.md",[],[],{"skillNo":84,"name":85,"nameZh":6,"description":86,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":19},"01M78EN4A7TXNABFXQWHK2FS01","obsidian-vault","ค้นหา สร้าง และจัดการ note ใน Obsidian vault ด้วย wikilinks และ index note ใช้เมื่อ user อยากหา สร้าง หรือจัดระเบียบ note ใน Obsidian","https:\u002F\u002Fgithub.com\u002FBoom-Vitt\u002Fskills-thai\u002Fblob\u002Fmain\u002Fskills\u002Fpersonal\u002Fobsidian-vault\u002FSKILL.md",[],[]]