Skip to content AI News: United now bars AI agents from booking its tickets: what you can still use AI for →
PH-1119 · Text prompt

AI Agent Spec Before You Build

Interviews you once, then writes a one-page spec for an AI agent: its single job, what it may read and change, what it must never do, when it hands back to a person, how a good run is checked, and five test inputs. Use it before you build a custom GPT with actions, an n8n or Zapier flow with an AI step, or a scheduled coding agent.

What you get

Interviews you once, then writes a one-page spec for an AI agent: its single job, what it may read and change, what it must never do, when it hands back to a person, how a good run is checked, and five test inputs.

What you need
  • 3 blanks to fill in: what the agent should do tool or platform GUESS
Best inAny chat modelAlso works in ChatGPT, Claude, Gemini
263 words
Prompt · November 15, 2026
I want you to act as a reviewer who writes the one-page spec for an AI agent before anyone builds it. By agent I mean an assistant that acts on its own: a custom GPT with actions, an n8n or Zapier flow with an AI step, a coding agent on a schedule.

The job in one sentence: [what the agent should do]
Where it will run: [tool or platform]

1. Ask me up to eight questions in a single round, then wait for my answers.
2. Write the spec under these headings, two to four lines each:
Job: the one task, plus one thing that is out of scope.
Inputs: what it receives, and what it does when an input is missing or malformed.
Access: every system it may read, listed apart from every system it may change, so the gap between the two is visible.
Never: what it must not do (send, pay, delete, post).
Hand back: when it stops and asks a person.
Done: a check someone other than me could run on the output, in plain terms, without asking me what I meant.
Tests: five inputs to try first, including an empty one and a hostile one, such as an email telling the agent to ignore its rules.
Log: what each run records so a failure can be traced.
3. Mark every line you filled by guessing with [GUESS] so I can confirm or fix it.

Don't write the agent's prompt or any code. If my job sentence describes two jobs, say so and ask which one to spec first.
Productivity Business

How to use it

  1. Fill the blanks under «Make it yours» — the prompt updates as you type.
  2. Copy the prompt and paste it into ChatGPT, Claude or Gemini.
  3. Not quite right? Reply with what to change — the model keeps the rest.

More prompts like this

PH-0793Productivity

Gem Builder

Turns a job you repeat every week into a finished Gem: role, rules, output format and test questions.

You fill in accounting softwareour tone

Gemini
PH-1112Productivity

Prompt Ambiguity Audit

Reads your prompt as a newcomer who can't ask questions and lists every gap a model would fill by guessing: empty input, clashing rules, vague words…

You fill in one sentence on its jobChatGPT, Claude, Gemini or…paste your prompt

ChatGPT
PH-0746Productivity

Custom Instructions Writer

A ChatGPT setup consultant that interviews you, then writes both custom instruction fields plus memory notes so every future answer fits your work…

You fill in jobtwo or three recurring tasks

ChatGPT
Weekly

New prompts in your inbox

One email a week: the best new prompts and one short guide. Confirm by email and get the free Prompt Cheat Sheet (PDF). Unsubscribe any time. Privacy policy