Skip to content
TESA Open Knowledge

Writing a brief for developers: the one-page decision canvas

Companion videos

Watch on YouTube (opens in a new tab)

Videos by Thai Embedded Systems Association (TESA) · The whole series in the playlist AIoT Foundation

Objectives

Section titled “Objectives”
  1. Complete your own project’s decision canvas
  2. Rewrite a vague brief so it can be measured
  3. Share the template with a correct TESA credit

Before you start

Section titled “Before you start”
  • From the previous lesson, what things must be settled with a partner before signing?
  • If a developer sat in front of you for ten minutes, how would you describe your project to them?

See it work first

Section titled “See it work first”

Compare two briefs sent to the same development contractor.

Brief A “I want a smart AI system to monitor the shop, easy to use, not expensive, get it done as fast as possible.”

Brief B “Measure the temperature in 12 fridges across three branches. If it stays over the threshold for more than 15 minutes, text the shift manager. Allow no more than 2 false alarms per branch per month. Must keep working even if the internet drops. Must not collect images or customer data. No mobile app needed in the first round. Source code and documentation must be handed over at the end of the job.”

Quotes for Brief A can differ by ten times between two contractors, because each interprets “smart” differently. Brief B can be compared on price and on scope, and at handover you can check whether it was really done.

Concepts

Section titled “Concepts”

1. A good brief can be checked at handover

Section titled “1. A good brief can be checked at handover”

Every sentence in a brief should be able to answer “at handover, how will we check that this was done?” Words like smart, easy to use, modern, and as fast as possible cannot be checked. Turn them into numbers or conditions, such as “no more than 2 false alarms per month” or “the manager can set a new threshold themselves within 1 minute”.

2. State what you will not do, too

Section titled “2. State what you will not do, too”

A good scope states both what will be done and what will not be done in this round. This prevents scope creep and makes prices comparable.

3. A one-page decision canvas

Section titled “3. A one-page decision canvas”

The template is at resources/decision-canvas.md. It has 15 fields, each drawn from one lesson in this course.

Fields From lesson
1–4 The problem, the three-part brief, the pre-AI ladder, metrics biz.m01.l01
5–7 Architecture, the site, data biz.m01.l02
8–9 Cost and time biz.m01.l03
10–11 Risk, rules and standards biz.m02.l01
12–13 The chosen option and what must be handed back biz.m02.l02
14–15 Scope and the decision-maker This lesson

4. You can share the template, but you must credit TESA

Section titled “4. You can share the template, but you must credit TESA”

This template (resources/decision-canvas.md) is published under CC BY 4.0. You may use it inside your company, hand it to clients, or use it in consulting work, including commercially (the course’s lesson content is CC BY-NC 4.0). The condition is that you credit the source, like this

“Decision canvas template” from TESA Open Knowledge by the Thai Embedded Systems Association (TESA), https://github.com/tesaiot/tesa-qualification-program, licensed under CC BY 4.0

If you edit the template, for example adding your company’s own field, add (adapted) after the attribution text and say briefly what changed. Crediting the source does not mean TESA endorses your project or service; never write it in a way that implies that. Details and examples are in ATTRIBUTION.md.

Practice

Section titled “Practice”
  1. Rewrite Brief A above into a brief that can be checked at handover. Use your own shop or a hypothetical one.
  2. Copy resources/decision-canvas.md and fill in all 15 fields for your own project, using what you built in the five earlier lessons.

Check your understanding

Section titled “Check your understanding”

Answer the questions in quiz.yaml. A score of 80% or more passes, and counts as finishing this course.

Lab

Section titled “Lab”

Take your completed decision canvas to at least one developer or contractor and ask them to point out the three least clear fields. Fix those fields, and keep both the before and after versions as evidence of your learning.

Going further

Section titled “Going further”
  • If your team will build it yourselves, have the team look at the developer pathway in catalog/tracks.yaml
  • If you must decide on the enclosure and industrial design, see the product design course in the entrepreneur pathway
  • TESA has training courses under the TESA Qualification Program (TQP) and a member network that can help you go further

Reflect

Section titled “Reflect”

Now that the canvas is complete, do you still want to use AI in this project? Has your answer changed from the first day of the course, and why?

Review questions

Answer on your own first, then open the answer.

  1. If you do not yet know the real unit cost, how should you fill the "three cost parts" field? (Objective 1)

    1. เดาตัวเลขที่ฟังดูดี
    2. เว้นว่างไว้
    3. เขียนตัวเลขที่รู้แล้ว และระบุว่าตัวไหนยังต้องขอใบเสนอราคาจากใคร
    4. ใช้ราคาจากอินเทอร์เน็ตโดยไม่บอกที่มา
    Show answer

    Answer: C. เขียนตัวเลขที่รู้แล้ว และระบุว่าตัวไหนยังต้องขอใบเสนอราคาจากใคร

    canvas ที่ดีบอกทั้งสิ่งที่รู้และสิ่งที่ยังไม่รู้ พร้อมบอกว่าต้องถามใคร ดีกว่าตัวเลขที่เดาขึ้นมา

  2. Which requirement can be checked at hand-over? (Objective 2)

    1. ระบบต้องใช้ง่ายและทันสมัย
    2. ต้องเตือนผิดไม่เกินเดือนละ 2 ครั้งต่อสาขา และผู้จัดการตั้งเกณฑ์ใหม่ได้เองภายใน 1 นาที
    3. ใช้ AI ที่เก่งที่สุด
    4. ทำให้เสร็จเร็วที่สุด
    Show answer

    Answer: B. ต้องเตือนผิดไม่เกินเดือนละ 2 ครั้งต่อสาขา และผู้จัดการตั้งเกณฑ์ใหม่ได้เองภายใน 1 นาที

    ตัวเลขและเงื่อนไขที่ชัดทำให้ทั้งสองฝ่ายตรวจได้ตรงกันว่างานเสร็จหรือยัง

  3. Why write what is "not in scope" this round? (Objective 2)

    1. เพื่อให้เอกสารยาวขึ้น
    2. เพื่อกันงานงอก และทำให้ใบเสนอราคาจากหลายรายเทียบกันได้
    3. เพื่อให้ผู้รับจ้างทำงานน้อยลงโดยไม่มีเหตุผล
    4. ไม่จำเป็น เพราะทุกคนเข้าใจตรงกันอยู่แล้ว
    Show answer

    Answer: B. เพื่อกันงานงอก และทำให้ใบเสนอราคาจากหลายรายเทียบกันได้

    ขอบเขตที่บอกทั้งสิ่งที่ทำและไม่ทำ ช่วยให้ราคาและเวลาตรงกับความคาดหวังของทั้งสองฝ่าย

  4. You added a "marketing budget" field to the canvas template and gave it to clients. Which credit is most correct? (Objective 3)

    1. แม่แบบโดยบริษัทของเรา
    2. "Edge AI และ IoT สำหรับการตัดสินใจเชิงผลิตภัณฑ์" จาก TESA Open Knowledge โดยสมาคมสมองกลฝังตัวไทย (Thai Embedded Systems Association: TESA) https://github.com/tesaiot/tesa-qualification-program สัญญาอนุญาต CC BY-NC 4.0 (ดัดแปลง: เพิ่มช่องงบการตลาด)
    3. แม่แบบที่ TESA รับรองแล้ว
    4. "Edge AI และ IoT สำหรับการตัดสินใจเชิงผลิตภัณฑ์" จาก TESA Open Knowledge
    Show answer

    Answer: B. "Edge AI และ IoT สำหรับการตัดสินใจเชิงผลิตภัณฑ์" จาก TESA Open Knowledge โดยสมาคมสมองกลฝังตัวไทย (Thai Embedded Systems Association: TESA) https://github.com/tesaiot/tesa-qualification-program สัญญาอนุญาต CC BY-NC 4.0 (ดัดแปลง: เพิ่มช่องงบการตลาด)

    ต้องมีชื่อ ผู้สร้าง แหล่งที่มา และสัญญาอนุญาตครบ และเมื่อแก้ไขต้องเติม (ดัดแปลง) ห้ามเขียนว่า TESA รับรอง

Cite this lesson

If you teach from this lesson or reuse it in slides or documents, credit it with the text below. If you changed it, add (adapted) after the title.

"Writing a brief for developers: the one-page decision canvas" from TESA Open Knowledge by the Thai Embedded Systems Association (TESA), https://github.com/tesaiot/tesa-qualification-program, licensed under CC BY-NC 4.0

Thai attribution: "เขียนโจทย์ให้นักพัฒนา: Decision Canvas หนึ่งหน้า" จาก TESA Open Knowledge โดยสมาคมสมองกลฝังตัวไทย (Thai Embedded Systems Association: TESA) https://github.com/tesaiot/tesa-qualification-program สัญญาอนุญาต CC BY-NC 4.0

Lesson link: https://tesaiot.github.io/tesa-qualification-program/en/courses/edge-ai-iot-for-business/m02-decide-and-brief/l03-developer-brief/

Full guide: how to cite TESA

TESA Open Knowledge · © 2026 สมาคมสมองกลฝังตัวไทย (TESA) · CC BY-NC 4.0

Content is licensed CC BY-NC 4.0. Reuse it non-commercially and credit the Thai Embedded Systems Association (TESA) every time. · How to cite TESA