← all playbooks

Turn a brief into a job advert a candidate would actually answer

An advert built from the brief: what the job is, what it pays where the client allows it, what is hard about it and what is not required, with a question for every gap, and on your approval a draft of the role in your connected ATS that is not published.

use when
you have a client's job description or your own brief, and what goes on the careers page has to be written for the candidate, not for the client's file
starts from
A job spec

The prompt

Paste it into Claude Code or the Claude desktop app with Hyreflow connected. The first line tells your agent to use Hyreflow, so it reads the play, asks before it spends anything, and hands the work back to you.

paste this into Claude
Use hyreflow and turn this brief into a job advert a good candidate would
actually answer.

The brief: <PASTE THE BRIEF, THE CLIENT JD, OR A FILE PATH>
What I can publish: salary <SALARY_RANGE_OR_NOT_ALLOWED>, client name
<NAMED_OR_ANONYMOUS>, location <LOCATION_AND_WORK_MODEL>.

Write it for the person reading it: what the job is, what it pays if I am
allowed to say, what is hard about it, and what is not required. Keep the
requirements to the real must-haves. Under <WORD_LIMIT> words, in this
tone: <TONE_OR_PASTE_AN_AD_I_LIKE>.
- Use only what the brief says. Do not invent a salary, a benefit or a
  perk. Every gap comes back to me as a question, most important first.
- Flag wording that reads as coded for age, gender or background.

Write the opening and the pay section first so I can check the tone, and
tell me what the full run costs before you do the rest.

If I ask for a draft in <ATS_NAME>, show me the exact fields before you
write anything to the ATS. Create it as a draft. Publish nothing.

Replace every <PLACEHOLDER> with your own detail. Everything else can stay as written.

What you need first

  • The brief, the client's job description, or your notes from the briefing call
  • What the client allows you to publish: salary, company name, location
  • A Hyreflow workspace with credits, since the writing is metered
  • Optional: Ashby, Lever, SmartRecruiters or Recruitee connected with your own API key, if you want a draft created

Tools it can reach for

The agent picks per step from what your workspace has. Nothing here is required by name.

What happens when you run it

Free steps are marked free. Anything that spends credits is marked, and the agent asks before the first paid run of any size.

  1. 1

    Read the brief and separate fact from wish

    credits

    Responsibilities, must-haves, nice-to-haves, pay, location, work model and process are pulled out of the brief as written. Anything the brief does not say stays empty. It is not filled in.

  2. 2

    Turn every gap into a question

    free

    The salary band and whether it can be published, the hybrid days, who the role reports to, why it is open. You answer, or mark the question for the client. The advert is not written around a guess.

  3. 3

    Read the adverts yours will sit beside

    credits

    Optional. Live adverts for the same title and location are pulled from LinkedIn or Indeed, so you can see what a candidate will compare yours with. Starting the search is free and each advert returned is charged.

  4. 4

    Write the advert for the reader

    credits

    What the job is, what it pays where allowed, what is hard about it, what is not required, and how to apply. Internal jargon, the wish list and the boilerplate are cut back, and the requirements stay limited to the must-haves you confirmed.

  5. 5

    Check the draft against the brief

    credits

    Every claim in the advert is traced to a line in the brief or to an answer you gave. Phrases that read as coded for age, gender or background are flagged for you to decide on. It is a wording check, not legal advice.

  6. 6

    Review it with the open questions

    free

    You see the advert, the unanswered questions and the flags together. Your edits go into the advert, and anything still open stays listed at the top so it is not forgotten when the advert goes out.

  7. 7

    Create a draft in your ATS, on approval

    free

    You see the exact fields first, and the internal ids an ATS needs are asked for, never guessed. Lever, SmartRecruiters and Recruitee hold the advert text on the draft role. Ashby holds it on a separate posting, which also starts as a draft. Creating publishes nothing.

What a run costs

Credits are spent per role the play actually works, and a lookup that finds nothing usually costs nothing. The two figures are the run where the first provider answers and the run where every lookup walks its full chain.

rolesif the first provider answersif every lookup walks the chain
25under $11.3 creditsunder $11.3 credits
100under $15 creditsunder $15 credits
500$2.525 credits$2.525 credits
1,000$550 credits$550 credits

Free before anything is charged

  • Turn every gap into a question
  • Review it with the open questions
  • Create a draft in your ATS, on approval

What moves the number

  • How many roles survive the free filters. Everything dropped before the paid steps costs nothing.
  • The scoring and drafting steps run on the metered agent, charged on what they read and write rather than per role, so they sit outside this table.
  • Providers you connect with your own key. Those calls bill your account, not your credits.

An estimate, not a quote, priced at the volume credit rate. Your agent sizes the run against your own workspace and tells you what it will cost before it spends anything.

A job description is written for the file, an advert for the reader

The document a client sends you was written to get a headcount approved. It lists every duty the role might ever touch, a dozen requirements of which three matter, and a paragraph about the company that could describe any company. Pasted onto a careers page, it is read by the people who apply to everything and skipped by the person you want, who has a job and a phone and gives an advert one glance.

That person is asking four things. What is the job, in plain words. What does it pay. What is hard about it, because every job has something and an advert that admits none is not believed. And what is not required, because good candidates rule themselves out over a wish-list item the client would happily waive.

An advert that answers those gets answered. This play writes it from the brief and from nothing else. Where the brief is silent, you get a question, not a plausible sentence. No invented salary, no assumed benefits, no "competitive package".

What you get back

The advert: a headline, a short opening on what the job is, the pay where the client allows it, the real must-haves, what is hard, what is not required, and how to apply. Beside it, the open questions in order of importance. And the flagged phrases, each with a plainer alternative.

If you asked for it, a draft of the role sits in your ATS, unpublished, with its id.

Variations worth knowing

From a recorded call. If the brief was taken on a call, turn the recorded briefing call into a search brief first, then write the advert from that.

Anonymous client. Say so, and the advert describes the company by type and scale. The check step then looks for details that would name the client by accident.

Several systems. Creating and publishing the role in more than one ATS is covered by post one role to every ATS.

Where this goes wrong

A brief that is all wish list. If the client cannot say which requirements are real, the advert cannot either. That goes back to the client as the first question.

Pay the ATS cannot hold. Recruitee does not accept a salary when a role is created, so the band is in the advert text or it is finished by hand inside Recruitee.

An id nobody supplied. Each ATS keys a role to its own team, location or user ids. A missing id means no draft in that system, and you are told which one.

Hard means hard, not alarming. One honest line about the difficult part is enough. A paragraph of warnings reads as a client in trouble.

Treating the flags as clearance. The wording check catches common coded phrases. It is not a legal review, and the advert carries your client's name or yours.

Questions

What if the brief has no salary?

Then the advert has no salary and you have a question to take back to the client. The agent does not estimate a band, borrow one from similar adverts, or add benefits the brief does not mention. If the client will not publish pay, the advert says nothing about it, and whether to push back is a conversation for you and the client.

Will it publish the advert?

No. The optional last step creates a draft of the role in a connected ATS, and creating publishes nothing in any of them. Going live is a separate, approved action, and it puts the role on the careers site that ATS hosts. Hyreflow does not post to LinkedIn or Indeed directly.

Why say what is hard about the job?

Because the candidates you want are employed and have read a great many adverts that promise a dynamic team. One honest line about the legacy system, the travel or the turnaround is what makes the rest believable. It also filters: the people who would leave over it do not apply.

Does the client's name appear?

Only if you say it can. Agency adverts are often anonymous, and the advert is then written so the description does not identify the client by accident. A named product, a precise headcount or an unusual location can do that as well as a logo can.

What does it cost?

Structuring the brief, writing the advert and checking it are AI work, metered on usage, and you are told the cost before it runs. Reading comparison adverts is charged per advert returned. Creating the draft runs on your own ATS account and uses no Hyreflow credits.