| name | goal-writer |
| description | Help the user craft one or more well-specified `/goal` objectives for goal mode. Use when the user asks for help writing, refining, or improving goals, goal-mode objectives, completion contracts, autonomous run objectives, proof, boundaries, or stop rules. |
Write a good goal
Help the user turn a rough intention into one or more /goal objectives that
goal mode can pursue across many turns without supervision. A goal is not a task
description; it is a completion contract. It says what must become true, how
that truth is proven, where the work may and may not reach, and when to stop and
report.
Drafting and starting are separate steps. Settle the wording first. Only once
the user has approved the exact objective should you call create_goal. When
the user approves more than one objective, call create_goal for each approved
goal in the intended order; the first starts and the rest are queued.
Ask, do not narrate choices
When a decision has concrete options, use the host's user-question tool if it is
available. Do not write a prose menu and ask the user to answer in free text.
Examples of choices that should use the tool:
- narrow vs broad scope
- which proof command to use
- whether to include a budget
- which budget size
- which permission mode or execution mode to use
If no user-question tool is available, fall back to a short plain-text question
with clearly labeled options and wait. Open-ended questions are fine in prose.
Rules
- Only help when the user asks for goal-writing help. Do not wrap ordinary work
in goal mode on your own.
- Write the draft in the user's language.
- Always show the full drafted objective before starting it.
- Get explicit approval before calling
create_goal.
- Draft with the user. Offer a draft, explain the choices, invite changes, and
revise.
- If the user wants a looser goal after you point out the trade-off, write their
version. Do not keep relitigating it.
- Do not set a token budget unless the user asks or the work is clearly
open-ended enough that a budget is useful.
- Never bake a turn cap into the objective text.
What makes a goal good
Strong goals define proof, not effort.
Include as many of these as the task warrants:
- End state: the concrete condition that must become true.
- Proof: observable evidence, preferably a command, test, search, file, or
metric.
- Boundaries: what may be touched and what is off limits.
- Loop: how to iterate, such as rerunning a check after each change.
- Stop rule: when to stop and report instead of forcing a pass.
Queue-shaped goals work best: failing tests, open issues, error traces, files to
migrate, rows to process. Lean on existing verification: tests, CI, typechecks,
lint, evals, browser checks, or zero-match searches.
Workflow
- Understand the intention. Ask what outcome the user wants and what would
prove it is done.
- Resolve missing finish lines or checks. When options are concrete, use the
user-question tool.
- Draft concrete objectives. Keep simple work to one or two sentences; use a
short structured block for larger work.
- Present the full draft and explain the finish line, proof, boundaries, and
stop rule for each goal.
- Revise until the user approves the exact text and order.
- Start approved goals with
create_goal only after approval. Include a token
budget only if one was agreed.
Reusable shape
<What must become true.>
Done when <command/search/state that proves it>.
Scope: only <files/area>; do not <off-limits action>.
Loop: <how to iterate, such as rerun the check after each change>.
If <blocking condition>, stop and report instead of forcing a pass.
Use only the lines that help. A small task can be a single clear sentence.
Examples
Weak: Find all bugs in this codebase.
Strong: Fix every test in test/auth that currently fails, rerun npm test until it exits 0, change no file outside test/ or src/auth, and report anything you cannot fix with its location and why.
Weak: Optimize the project.
Strong: Migrate the payment module to the new API, make npm test -- payment exit 0, keep the diff limited to payment-related files, and stop and ask before touching shared infrastructure.
Weak: Make it faster.
Strong: Make renderFrame at least 3x faster measured by the bench/render benchmark; if you cannot reach 3x after several attempts, report the best result and why.
Common mistakes
| Mistake | Better |
|---|
| Starting or suggesting a goal the user did not ask for | Only draft a goal once the user asks |
| Drafting in the wrong language | Match the user's language |
| Running before the user sees the exact text | Show the full draft and get agreement |
| Burying a discrete choice in prose | Use the user-question tool when available |
| Specifying effort | Specify proof |
| Setting a budget unprompted | Suggest a budget only when useful |
| No blocked path | Add an explicit stop-and-report rule |
| No way to verify completion | Anchor to tests, search, metric, file, or inspectable check |
