Pusaram AI Academy
Pusaram sites

Lesson O02 · AI Awareness Weekend

Give clear instructions and improve a useful draft

Draft lesson

Draft lesson. Published by {PUBLISHER}. Complete text, quiz and task, but not yet tried with learners or reviewed by an independent specialist. Examples use synthetic facts. What the status labels mean.

Your outcome

Write a request with a goal, relevant context, constraints, and an output format; then improve a draft using specific feedback. You can type, dictate, or work with a partner.

Why a vague request is difficult to evaluate

“Make something good for our event” leaves many choices unstated. Who is the audience? What is confirmed? What tone is appropriate? What information must not be invented? You may receive polished wording that cannot be used.

A clear request is similar to a useful brief for a colleague. It should tell the assistant what task to perform and what success looks like. The analogy has limits: clear instructions improve the specification, but cannot guarantee a correct output.

The four-part request

State the goal: what artifact do you need? Supply relevant context: which facts and audience matter? Set constraints: what must be included, excluded, or left unknown? Specify a format: a paragraph, table, checklist, or structured set of fields.

Examples can clarify style, but too many unrelated details can obscure the task. Longer is not automatically better. Include information that changes the answer and omit personal details that are unnecessary.

This is a practical form of task specification. Long before AI chat interfaces, professional briefs and software requirements made work easier to assess. The same principle applies here: make important assumptions visible.

Worked example: an invitation

Use these synthetic facts: a community repair workshop; Saturday, 10:00–12:00; Riverside Hall; adults; 20 places; bring one small item; booking contact not yet confirmed.

Request: “Draft a friendly invitation for adults to a community repair workshop. Use only these facts: Saturday, 10:00–12:00, Riverside Hall, 20 places, and participants may bring one small item. Use no more than 80 words. Do not invent a date, price, repair guarantee, or contact. Mark missing booking information as [booking details to be confirmed].”

Illustrative output: “Have a small item you would like to try repairing? Join our community repair workshop at Riverside Hall on Saturday, 10:00–12:00. There are 20 places, and adults may bring one small item. [booking details to be confirmed].”

Check the output against every supplied fact. It does not invent a price or guarantee. However, “Saturday” is ambiguous for actual publication. The human organizer should add the confirmed calendar date before sending it. The task has produced a usable draft, not a publication-ready fact set.

1 GoalWhat artifact you need
Draft a friendly invitation for adults to a community repair workshop.
2 ContextFacts and audience that matter
Saturday, 10:00–12:00, Riverside Hall, 20 places; participants may bring one small item.
3 ConstraintsWhat to include, exclude or leave unknown
No more than 80 words. Do not invent a date, price, repair guarantee or contact. Mark missing booking information.
4 FormatThe shape of the answer
A short invitation, with the placeholder [booking details to be confirmed].
Still missing before it can be sent: the confirmed calendar date and the booking contact. A person adds these; the request keeps them as a placeholder.
Figure 1. The invitation request, taken apart
Text equivalent

The request has four parts. Goal: Draft a friendly invitation for adults to a community repair workshop. Context: Saturday, 10:00–12:00, Riverside Hall, 20 places; participants may bring one small item. Constraints: No more than 80 words. Do not invent a date, price, repair guarantee or contact. Mark missing booking information. Format: A short invitation, with the placeholder [booking details to be confirmed]. The confirmed calendar date and the booking contact are still missing and stay as a placeholder until a person adds them.

Improve with precise feedback

Weak feedback: “Make it better.” Stronger feedback: “Keep the facts unchanged. Use shorter sentences and a more welcoming opening. Keep the booking placeholder.” Compare both drafts against the original facts after revision; a rewrite can introduce new errors.

An example of a failure is “All repairs are guaranteed and refreshments are free.” Neither claim was supplied. Ask for its removal, but also check the rest of the draft. Fixing one error does not establish that no others remain.

Practice without depending on a paid account

Use O02-T01. If an approved AI interface is available, run your request with synthetic facts and compare its actual output. Do not upload personal documents for this activity. If access is unavailable, exchange briefs with a partner or review the supplied illustrative outputs. Mark that attempt as a specification exercise, not a live model test.

For independent transfer, write a request for a study-group reminder, a family activity plan, a project update, or a volunteer message. Include a missing fact that should remain a placeholder. Ask another learner whether the request makes that boundary clear.

A reusable review habit

Before generating, state what must be true. After generating, check whether it is true. If you cannot verify a claim, mark it as unverified rather than making the wording more confident.

Complete quiz O02. Save your original request, one draft or illustrative response, and a short explanation of what you changed. Next: check an answer against evidence and simple arithmetic.

References and context

The instruction pattern is a teaching recommendation, not a guaranteed formula for every model. Clear steps and examples also support accessibility: https://www.w3.org/WAI/WCAG2/supplemental/patterns/o4p07-step-instructions/. Review date: 17 November 2026.

Check your understanding

This is a self-study check, not a graded test. Choose one answer for each question, then check. Explanations appear after you check, and you can try again. The answers are in this page, so it cannot prove what you know.

Question 1 of 4 Which addition most improves a vague request for an invitation?
Question 2 of 4 Booking details are unknown. What instruction is most appropriate?
Question 3 of 4 After a style revision, what should you check?
Question 4 of 4 You reviewed a supplied illustrative response without running a model. How should you record it?

Try it: Write a checkable request

About 15 minutes. Uses the practice packet (synthetic facts only).

  1. Use Practice Packet B; do not add real contact details.
  2. Write a request stating audience, goal, facts, constraints, and output form.
  3. Request a placeholder for missing booking details.
  4. Run it in an approved tool if available, or inspect the illustrative response.
  5. Review facts and record one revision.

You produce: Original request; Response or labeled illustrative review; One revision and reason.

Open the full task, rubric, hints and sample answer

Selected references and optional next reading

These are supporting choices, not extra required homework for the four-hour workshop. The lesson and supplied exercise remain sufficient for this introductory outcome.

Core reading

  • Prompt engineering guide OpenAI · documentation · Free docs; live API use may be paidClear instructions, examples, and context; actual behavior depends on the model.Try it: Explain the idea and apply it to the supplied synthetic example.About this reference (W16)

Supporting reading

Optional

Use the selected concept to explain or check your workbook task. Technical code and paid books are optional; read only the introductory passages that match the focus.

Links go to the owners' own sites. Linking to a book or repository is not permission to copy it, and some resources cost money; the lesson does not require them. Reviewed 2026-11-17. See all references.