เอกสารของ project
Brief, working notes และ handoff ของแต่ละ project พร้อม company brief — บริบทที่ทั้งคนและ AI agent ทุกค่ายอ่านก่อนเริ่มงาน มีประวัติ version และกู้คืนได้
เอกสารของ project มีอะไรบ้าง?
แต่ละ project มีเอกสาร 3 ชนิด และแต่ละชนิดมีได้หลายไฟล์ เพื่อให้คนใหม่และ AI agent รู้ว่าโครงการนี้ทำเพื่ออะไรและงานอยู่ตรงไหนโดยไม่ต้องถามซ้ำ
| ชนิด | ใช้เขียนอะไร |
|---|---|
| Brief | ทำไมต้องมีโครงการนี้ ความต้องการ เป้าหมายทางธุรกิจ และโครงสร้างทางเทคนิค |
| Working notes | ความคืบหน้า สถานะปัจจุบัน กฎ และบทเรียน — คนหรือ agent อัปเดตเมื่อเห็นสมควร ไม่บังคับ |
| Handoff | ส่งต่องานให้ทีมหรือทั้ง project — คนที่เกี่ยวข้องได้รับแจ้งและกดรับทราบ |
| Company brief | ระดับบริษัท: กฎ วิธีใช้ BoardMark ของบริษัท หรือคำอธิบายบริษัท — แสดงในทุก project แบบอ่านอย่างเดียว |
เปิดและเขียนเอกสารที่ไหน?
กดปุ่มเฟืองบนบอร์ด: ผู้ดูแลได้หน้าตั้งค่าโปรเจกต์ที่มีแท็บเอกสาร สมาชิกและผู้ดูอย่างเดียวได้หน้าเอกสารโปรเจกต์ กดเอกสารใหม่หรือ Handoff ใหม่ หรือลากไฟล์ .md / .txt มาวาง แล้วเขียนด้วย editor เดียวกับ issue ใส่ “อะไรเปลี่ยน” ได้เพื่อให้เห็นในประวัติ
- ทุกคนใน project แก้ brief, working notes และ handoff ได้ ผู้ดูอย่างเดียวอ่านได้อย่างเดียว
- รับเฉพาะ .md และ .txt ไม่เกิน 1 MB ต่อเอกสาร และนับรวมพื้นที่ของบริษัท
- ถ้ามีคนบันทึกก่อนคุณ ข้อความที่คุณพิมพ์ยังอยู่ และเลือกได้ว่าจะดูส่วนที่ต่าง ใช้ของอีกฝ่าย หรือบันทึกของคุณเป็น version ใหม่
- “คัดลอกบริบทให้ AI” ได้ข้อความ markdown เดียวที่รวม company brief และ brief ของ project กับ working notes และ handoff ที่เปิดอยู่ ไว้วางให้ AI ใดก็ได้
ดูประวัติและกู้คืนเอกสารได้ไหม?
ได้ ทุกการบันทึกเป็น version ใหม่ที่เก็บว่าใครแก้ (และระบุว่าเป็น AI agent ถ้ามาจาก agent) ในประวัติ version เปิดดู เทียบกับ version ปัจจุบัน หรือกดกู้คืน ซึ่งสร้าง version ใหม่จากของเก่าโดยไม่ลบประวัติ เอกสารที่ลบแล้วก็กู้คืนจากประวัติได้ (เปิด “แสดงเอกสารที่ลบแล้ว”)
Handoff ทำงานอย่างไร?
Handoff คือการส่งต่องานระดับทีมหรือทั้ง project: เลือกทีมที่ต้องรับ (ถ้าไม่เลือกทีม ถือว่าถึงทุกคนใน project) ใส่ issue ที่เกี่ยวข้อง แล้วบันทึก คนในทีมนั้นได้รับแจ้ง เห็นป้าย “ถึงคุณ” และจุดบนปุ่มเฟือง แล้วกดรับทราบ ผู้เขียนได้รับแจ้งกลับ สถานะเปลี่ยนจากเปิดอยู่ → รับทราบแล้ว → ปิดแล้ว (เปิดใหม่ได้)
Company brief คืออะไร ใครแก้ได้?
เอกสารระดับบริษัทในคอนโซลผู้ดูแล แท็บ Company brief ใช้เขียนกฎ วิธีที่บริษัทใช้ BoardMark หรือคำอธิบายบริษัท ทุก project แสดงแบบอ่านอย่างเดียวในแท็บเอกสาร และ AI agent อ่านก่อนเริ่มงาน แก้ได้เฉพาะผู้ดูแลบริษัท สมาชิกอ่านได้
AI agent ใช้เอกสารเหล่านี้อย่างไร?
ผ่าน MCP (ใช้ได้กับ Claude, ChatGPT หรือ Gemini รวมถึง Copilot, Cursor และ client อื่น) agent เห็นว่าเอกสารไหนต้องอ่านก่อนจาก get_project หรืออ่านทั้งหมดในครั้งเดียวด้วย get_docs_context และแก้เอกสารได้ด้วย tool ของเอกสาร โดยทุกการแก้เป็น version ใหม่ที่ระบุ agent token