Define an agent specification

New project assignment

You've received a new email in Outlook from your manager at Tailwind Traders.
Read the message to understand why the team is writing a specification before building the agent.

New mail
Inbox1
Junk Email
Drafts
Sent Items
Deleted Items
Archive
Inbox Filter ▾
Priya Nair8:30 AM
Write the spec before we build "Tailwind Assist"
Hi there, We're finally green-lit to build Tailwind Assist…
Marcus WebbYesterday
Support dashboard — last 30 days
Exported the contact insights you asked for…
Dana LopezMon
Re: data access for the agent
Here's what we can safely wire up for v1…
Reply Reply all Forward Delete Archive Flag
Write the spec before we build "Tailwind Assist"
PN
Priya NairToday, 8:30 AM
Priya Nair <priya.nair@tailwindtraders.com>
To: You

Hi there,

We're finally green-lit to build Tailwind Assist, an AI agent to help customers on our support site. I know the team is eager to open a chat playground and start writing prompts, but last time that led to endless rework, everyone imagined a different agent, and no one could agree on when it was good enough to launch.

This time we do it properly. Before a single line of code, we write an agent specification: the blueprint, or job description, for the agent. It captures what the agent does, how it behaves, and how we'll know it works.

A complete specification answers five questions: user intent, suggested prompts, capabilities, evaluation, and test data. You'll define one section at a time.

How we'll work:

  • I've created a board in Azure DevOps with one work item per specification section.
  • You'll capture the spec in agent-spec.md in VS Code, the same way we track any product requirement.
  • Each section is grounded in real input, emails from colleagues, support dashboards, and reports on our current customer support data.

With the spec in hand, we can make design choices, like which model to use, with clear targets to aim for. Open the Azure DevOps board to get started.

Thanks,
Priya