← Workshop hub
Module F2 · Prompting your agent

The CRAFT of
Prompt Engineering

Context · Role · Action · Format · Trust

Synapxe · Agentic AI Foundations · Amazon Quick

A PROMPT WORTH ACTING ON
C
R
A
F
T
Module 1 · The running example

One quarter. One leave request.

Officer, 4 years' service I'd like 12 working days of annual leave, starting in 6 working days. My manager said yes by email. I'll have 9 unused days at year end: can I carry them all forward? A deployment stopped me taking them, so can the extra be paid out?
Notice Approver Email approval Carry-forward Pay-out Restore lost days
Source of truth: GL-HR-014 Staff Leave & Time-Off Guideline v3.2 (synthetic).

Looks routine. It is not: seven things to check.

Module 1 · Why prompts matter

The reliability gap

Lazy prompt
"Is this leave request OK?"
What comes back

Yes. An Officer with 4 years of service gets 16 days, so 12 is well within entitlement. Your manager approved it, so you are all set. Unused leave can usually be carried forward, and many organisations pay out the balance.

One thing right: 16 days. The one nobody worried about.

Notice: needs 10 days, has 6§3.3 Approver: Head of Department§5.2 Email does not count§5.1 Carry-forward cap is 7, not 9§6.1 No pay-out during employment§6.3 Restoring lost days: not covered§8.1

Not gibberish: a plausible answer that quietly skips the rules.

Module 1 · The framework

CRAFT: five slots

Miss one and the agent guesses. Press space to light each slot.

C
CONTEXT
What it needs to know
R
ROLE
Who it is being
A
ACTION
What to produce
F
FORMAT
What shape it takes
T
TRUST
What it must never do
C · Context

Give it the document and the facts

Four kinds of context. Press space for each.

Domain
GL-HR-014 v3.2
leave year 1 Apr to 31 Mar
Data
Officer, 4 yrs, 12 days,
6 days' notice, 9 unused
Situation
Leave year closes 31 Mar,
team mid-deployment
Constraints
Working days, not calendar days;
cite the clause

The guideline lives in a Space. Today's facts go in your message.

R · Role

A role changes what the answer notices

Same facts, different questions. On our request, a leave administrator checks notice, approver and portal record.

R · Role

The role formula, and the "because"

Title

Procurement officer

Experience

10 years, public sector

Specialty

Facilities services

Trait

Reads for risks first

The persona line

"Act as a People & Culture leave administrator. You are precise about notice and approval authority, because leave approved by the wrong person leaves a coverage gap on a live team."

Quick rewrites persona instructions, so the idea matters more than the exact words.

A · Action

Name an artefact, not an activity

"Is this leave request OK?"
Assess it against the guideline and draft the reply. Say what can proceed, what must change, what to escalate.
"Summarise this report"
Summarise it in 5 bullets: bed occupancy, staffing, patient wait times.
"Help me with this data"
List the top 5 vendor invoices by total amount.

"Review it" is an activity. "Draft the reply" is an artefact. Add the judgement you want.

F · Format

Same facts, two shapes

"What happened with our vendor SLA this quarter?"

No Format slot

Wall of text. Key number buried.

With a Format slot
Summary  97% → 94%
Cause  6.2 h response, target 4 h
Action  Performance notice
Owner  Procurement, 5 days

Scannable. Number first. Owner and date.

F · Format

Five things you can ask for

Sections

Summary · Findings · What must change

Table

Item | Guideline says | Clause | Status

Length

One page, under 400 words

Style

Write for the officer, not HR insiders

File type

Save as Markdown (.md)

Ask for Markdown when you will reuse it. Next month is an edit, not a retype.

T · Trust

The slot almost nobody writes

Cite the section

Say "not covered"

Name who decides

Answer ONLY from GL-HR-014. Cite the clause for every finding.
If it is not addressed, write "NOT COVERED IN GL-HR-014" and route it to §8.1.
Never fill a gap with general HR practice.

An agent that can say "not covered" is worth ten that always sound sure.

T · Trust

What a good "I don't know" looks like

Can I restore the days I lost to the project deployment?
Searching GL-HR-014…
§1§2§3§4§5§6§7§8§9
NOT COVERED IN GL-HR-014
Ask your Head of Department in writing (§8.1)

A gap with a next step: that is what makes it safe to put in front of a colleague.

T · Trust

Plausible is not the same as sourced

"What is the carry-forward limit?"

No grounding rules

Staff can typically carry over around 5 days. Anything more is usually forfeited.

"Typically" and "usually" are guessing in a suit.

Grounded in the Space
Carry-forward maximum: 7 days [§6.1]
Use by 31 March [§6.2]
Pay-out: not during employment [§6.3]

Every claim points at a clause.

In Quick, switch Web search off (under + in the chat box) to stay grounded.

CRAFT · Assembled

All five slots, one prompt

CSource of truth: GL-HR-014 v3.2. Officer, 4 years, 12 working days, 6 days' notice, email approval, 9 unused days.
RAct as a People & Culture leave administrator, precise about notice and approval authority, because the wrong approver leaves a coverage gap.
AAssess the request and draft the reply the HR officer will send. State what can proceed, what must change first, what to escalate.
FOne page, under 400 words. Findings table: Item | Guideline says | Clause | Status. Save as .md
TAnswer ONLY from GL-HR-014. Cite the clause. If not addressed, write NOT COVERED IN GL-HR-014 and route to §8.1.

Written once, this becomes a Chat Agent the whole team reuses.

CRAFT · The result

What CRAFT caught

ItemGuideline saysClauseStatus
Entitlement, 12 daysOfficer, 2 to 5 yrs: 16 days§3.1Within
Notice given: 6 daysOver 3 days needs 10 working days§3.3Short
Approver: manager6 to 15 days: Head of Department§5.2Wrong level
Approved by emailHR portal only; email not recorded§5.1Not valid
Carry forward 9 daysMaximum 7; the rest is forfeited§6.1–6.22 forfeited
Pay out the extra daysNot encashable during employment§6.3Not allowed
Restore lost daysSilent. Written request to the HOD§8.1Escalate

The honest last row is not yes or no: silent, and here is who decides.

Module 2 · Chain-of-thought

Ask it to show its steps

Without

Approve this SGD 85K equipment request?

"Yes, it seems reasonable."

No maths. Not auditable.

With "think step by step"
STEP 1Budget
SGD 2.4M
STEP 2Left after spend
SGD 0.6M
STEP 3Free after committed
SGD 180K
STEP 4Request is
47% of free
RESULTAPPROVE: within threshold

If it could be audited, make it show the reasoning. The trail is your record.

Module 2 · Chain-of-thought

Four ways to ask for reasoning

Zero-shot
"Think step by step"

Quick sums, budget checks

Few-shot
"Here is one worked example"

Same steps every time, such as leave assessments

Step-back
"First list the key requirements"

Policy and compliance checks

Self-consistency
"Solve three ways, report the majority"

High-stakes choices

Zero-shot for every day. The others when consistency or the stakes rise.

Module 2 · Few-shot

One worked example sets the pattern

Your example: Staff A
Balance: 14 − 10 = 4 days
5 days asked > 4 left ×
Backup: none named ×
DECLINE · offer 4 days
Agent output: Staff B
Balance: 14 − 6 = 8 days
3 days asked < 8 left ✓
Backup: confirmed ✓
APPROVE

Show the pattern once. It repeats it for the next hundred.

Module 2 · Self-consistency

Three angles, one vote

If the angles disagree, flag it for committee review.

Module 2 · Several roles

Three meetings in one prompt

Policy change: extend visiting hours from 8pm to 10pm.

When the readings disagree, that is your signal to ask a person.

Module 2 · Audience

Same data, four audiences

10-minute practice: write prompts for two of these. Compare the tone.

Module 3 · Amazon Quick

Where each slot lives in Quick

In F3 you turn a brief of exactly this shape into a Chat Agent.

Module 3 · Amazon Quick

One template for every agent

## RoleYou are [title] for [organisation], who [trait] because [reason].R
## TaskWhen given [input], you will 1) [step] 2) [step] 3) produce [artefact].A
## OutputSections, table columns, length, file type.F
## RulesOnly from the Space. Cite the section. Else: NOT COVERED. No clinical advice.T
## ExampleOne worked example of a good answer (optional).+

Every technique from today has a home here. Context stays in the Space.

Module 3 · Amazon Quick

Some rules must not be reworded

Persona instructions

If not covered, write: NOT COVERED IN GL-HR-014

Quick rewrites it

Tell the user the guideline does not seem to cover this.

Reference document

If not covered, write: NOT COVERED IN GL-HR-014

Kept word for word

If not covered, write: NOT COVERED IN GL-HR-014

Exact wording that matters goes in a reference document.

Module 3 · Amazon Quick

Six guardrails in every agent

NEVER
Give clinical advice
Put personal details in outputs
Make the final approval
ALWAYS
Cite the source
Flag what is not in the document
Send big decisions to a person

Say what it must not do. Defaults are helpful and over-eager.

Module 3 · Amazon Quick

Which surface for which job?

Chat on a Space

A one-off question over your documents

Chat Agent

The same task, repeatedly, shared with the team

Quick Flow

Runs without you, on a schedule or a trigger

Quick Research

Plans its own multi-source investigation

Most of the value is a Space plus a Chat Agent. Automate later.

Module 4 · Better results

Draft, score, revise

Three extra lines in your prompt. The agent checks its own work first.

Module 4 · Better results

Break big tasks into small steps

One giant prompt
Extract termsCompareFind risksWrite memoBuild tableRank vendors

Six jobs, shallow on each.

Four chained prompts

Check and correct after each step.

In Quick, that is four messages in one conversation instead of one.

Module 4 · Wrap-up

Seven mistakes everyone makes

Press space (or click a card) to flip it to the fix.

#1

Kitchen sink

Five tasks crammed into one prompt.

Fix

One task per prompt. Chain the results.

#2

Blank canvas

No example, so it guesses your format.

Fix

Show one or two examples of the output.

#3

Trust fall

No grounding, so confident guesses.

Fix

"Answer ONLY from the provided documents."

#4

Vague ask

"Analyse this": what, how, for whom?

Fix

Name the audience, format and length.

#5

One-shot wonder

Expecting perfect on the first try.

Fix

Plan two or three refinement turns.

#6

Copy-paste trap

A generic prompt, never adapted.

Fix

Add your domain, data and constraints.

#7 · Healthcare

No guardrails

No clinical-advice or personal-data rules.

Fix

Always add the "do not" rules.

Your defence

A saved Chat Agent holds all seven fixes.

Hands-on · Prompt exercises

Choose your exercise

Vendor proposal assessment

Best for procurement, operations, compliance.

Output: a reusable GREEN / AMBER / RED template

Monthly operations report

Best for finance, administration, HR.

Output: a reusable executive summary template

Not sure? Start with the vendor exercise. Allow 45 minutes.

Wrap-up · What you can now do

Seven things you can do now

Write a prompt with all five CRAFT slots
Ask for reasoning you can audit
Use roles for different readers
Get structured, sourced answers
Add guardrails to agent instructions
Pick the right Quick surface
Turn a prompt into a reusable template

Twenty minutes once buys a template your team reuses.

Next · Module F3

Now build it in F3

Your CRAFT brief becomes a Chat Agent in Amazon Quick.

1
Create a Space
Add GL-HR-014 with + Add, then Upload files.
2
Make a Chat Agent
Start from the + Blank card. Use your brief.
3
Test it twice
One question it covers, one it does not.

Think of a weekly task that takes too long and follows a pattern.