Agent brief template: give the work a finish line

Use this as a starting point whenever a task needs more than a one-line prompt:

# Task: [short name]

## Goal

[What should be true when the work is finished?]

## Context

[What does the agent need to know? Include links, files, examples, or constraints.]

## Available tools

[Which tools or sources may it use?]

## Working rules

- [What should it always do?]
- [What should it never do?]
- [When should it ask before continuing?]

## Done when

- [Observable success condition]
- [Observable success condition]

## Report back

Tell me:

1. What you completed.
2. What you changed or decided.
3. What remains uncertain.
4. What you need from me next.

The most important line is Done when. It gives the agent a finish line instead of asking it to “make this better.”

Keep the brief short enough to read, but specific enough to test. If the same working rules appear in several briefs, they may belong in a reusable skill instead.