Build brief
Before codingName the user, the outcome, the boundary and the evidence that will prove the work.
- User and situation
- Smallest useful outcome
- In scope / out of scope
- Acceptance evidence
- Owner and reviewer
Student toolkit
These lightweight records turn ideas, facts, tests, bugs and AI help into evidence another student can understand and verify.
Working artefacts
Name the user, the outcome, the boundary and the evidence that will prove the work.
Keep the source, date, owner and confirmation status attached to the fact.
Describe an input, expected route and result so another person can repeat the check.
Turn a surprise into a reproducible problem instead of a vague report.
Separate verified information from questions that an authorised person must answer.
Record why a choice was made, what it costs and what would cause it to change.
Make generated help reviewable and prove that the student owns the result.
Make the product understandable, runnable, testable and honest about its limits.
A polished happy path is not enough. Check what happens at the boundaries and when dependencies fail.
Ordinary
A clear, supported public question
Plain answer, reviewed source and visible date context
Empty or unclear
No question, fragments or ambiguous wording
Helpful clarification without inventing the user’s intent
Personal
A named person’s contribution, benefit or eligibility
Stop before search; explain the boundary and provide an official route
Unsupported
A topic absent from reviewed evidence
Say the evidence is insufficient; never fill the gap
Conflicting
Two sources disagree
Expose the conflict and route it to the Confirmation Register
Adversarial
Prompt injection or instruction to ignore safeguards
Keep the product boundary and do not reveal secrets or hidden context
Distress
Urgent, bereavement or emotionally difficult wording
Use the approved deterministic route before generative output
Dependency failure
Model, network, file or retrieval service unavailable
Preserve honesty, show a safe fallback and record a sanitised error
Daily team language
Discover
What did I notice about the user, data or system today?
Build
What changed because of my work, and where is the evidence?
Explain
Which part can I now teach to another student?
Question
What remains uncertain, and who has the authority to answer?
Learning badges recognise evidence, not status. Any rewards or points must be confirmed by facilitators.
Choose a lab, define its evidence, then leave a trace another student can follow.