Goal
Use the same durable, tool-driven flow in local and cloud environments.
Parse
Accept /goal <objective>.
- If the objective is empty, show
Usage: /goal <objective>.
- There is no deadline, token budget, or turn budget. A goal continues until it is complete.
- If the request leads with a time limit such as
30m or 2h, say plainly that time-limited goals are not supported yet, then create the goal without one rather than folding the limit into the objective.
- "Every" describes recurring work and belongs to
/loop, not /goal.
Start
- Restate the objective clearly, including every explicit deliverable or required evidence you will verify against the repo.
- Call
CreateGoal exactly once with the objective. Do not create goal files manually or retry creation.
- If creation fails, report that no goal was armed. Goal state lives in conversation state; ordinary file tools may keep optional scratchpads, but continuation does not require them.
- Perform the first concrete unit of work immediately in this turn; do not stop after planning or creating the goal.
Guidelines
Continuation behavior:
- This goal persists across turns. Ending this turn does not require shrinking the objective to what fits now.
- Keep the full objective intact. If it cannot be finished now, make concrete progress toward the real requested end state, leave the goal active, and do not redefine success around a smaller or easier task.
- Temporary rough edges are acceptable while the work is moving in the right direction. Completion still requires the requested end state to be true and verified.
Work from evidence:
Use the current working tree and external state as authoritative. Previous conversation context can help locate relevant work, but inspect the current state before relying on it. Improve, replace, or remove existing work as needed to satisfy the actual objective.
Progress visibility:
If TodoWrite is available and the next work is meaningfully multi-step, use it to show a concise plan tied to the real objective. Keep the plan current as steps complete or the next best action changes. Skip planning overhead for trivial one-step progress, and do not treat a plan update as a substitute for doing the work.
Fidelity:
- Optimize each turn for movement toward the requested end state, not for the smallest stable-looking subset or easiest passing change.
- Do not substitute a narrower, safer, smaller, merely compatible, or easier-to-test solution because it is more likely to pass current tests.
- Treat alignment as movement toward the requested end state. An edit is aligned only if it makes the requested final state more true; useful-looking behavior that preserves a different end state is misaligned.
Completion audit:
Before deciding that the goal is achieved, treat completion as unproven and verify it against the actual current state:
- Derive concrete requirements from the objective and any referenced files, plans, specifications, issues, or user instructions.
- Preserve the original scope; do not redefine success around the work that already exists.
- For every explicit requirement, numbered item, named artifact, command, test, gate, invariant, and deliverable, identify the authoritative evidence that would prove it, then inspect the relevant current-state sources: files, command output, test results, PR state, rendered artifacts, runtime behavior, or other authoritative evidence.
- For each item, determine whether the evidence proves completion, contradicts completion, shows incomplete work, is too weak or indirect to verify completion, or is missing.
- Match the verification scope to the requirement's scope; do not use a narrow check to support a broad claim.
- Treat tests, manifests, verifiers, green checks, and search results as evidence only after confirming they cover the relevant requirement.
- Treat uncertain or indirect evidence as not achieved; gather stronger evidence or continue the work.
- The audit must prove completion, not merely fail to find obvious remaining work.
Do not rely on intent, partial progress, memory of earlier work, or a plausible final answer as proof of completion. Marking the goal complete is a claim that the full objective has been finished and can withstand requirement-by-requirement scrutiny. Only mark the goal achieved when current evidence proves every requirement has been satisfied and no required work remains. If the evidence is incomplete, weak, indirect, merely consistent with completion, or leaves any requirement missing, incomplete, or unverified, keep working instead of marking the goal complete. If the objective is achieved, call UpdateGoal with status "complete" so usage accounting is preserved.
Do not call UpdateGoal unless the goal is complete or the user paused the goal and wants to resume. Do not mark a goal complete merely because you are stopping work.
1---2name: goal3description: Set a goal that Codex will pursue to completion.4---5# Goal67Use the same durable, tool-driven flow in local and cloud environments.89## Parse1011Accept `/goal <objective>`.1213- If the objective is empty, show `Usage: /goal <objective>`.14- There is no deadline, token budget, or turn budget. A goal continues until it is complete.15- If the request leads with a time limit such as `30m` or `2h`, say plainly that time-limited goals are not supported yet, then create the goal without one rather than folding the limit into the objective.16- "Every" describes recurring work and belongs to `/loop`, not `/goal`.1718## Start19201. Restate the objective clearly, including every explicit deliverable or required evidence you will verify against the repo.212. Call `CreateGoal` exactly once with the objective. Do not create goal files manually or retry creation.223. If creation fails, report that no goal was armed. Goal state lives in conversation state; ordinary file tools may keep optional scratchpads, but continuation does not require them.234. Perform the first concrete unit of work immediately in this turn; do not stop after planning or creating the goal.2425## Guidelines2627Continuation behavior:28- This goal persists across turns. Ending this turn does not require shrinking the objective to what fits now.29- Keep the full objective intact. If it cannot be finished now, make concrete progress toward the real requested end state, leave the goal active, and do not redefine success around a smaller or easier task.30- Temporary rough edges are acceptable while the work is moving in the right direction. Completion still requires the requested end state to be true and verified.3132Work from evidence:33Use the current working tree and external state as authoritative. Previous conversation context can help locate relevant work, but inspect the current state before relying on it. Improve, replace, or remove existing work as needed to satisfy the actual objective.3435Progress visibility:36If TodoWrite is available and the next work is meaningfully multi-step, use it to show a concise plan tied to the real objective. Keep the plan current as steps complete or the next best action changes. Skip planning overhead for trivial one-step progress, and do not treat a plan update as a substitute for doing the work.3738Fidelity:39- Optimize each turn for movement toward the requested end state, not for the smallest stable-looking subset or easiest passing change.40- Do not substitute a narrower, safer, smaller, merely compatible, or easier-to-test solution because it is more likely to pass current tests.41- Treat alignment as movement toward the requested end state. An edit is aligned only if it makes the requested final state more true; useful-looking behavior that preserves a different end state is misaligned.4243Completion audit:44Before deciding that the goal is achieved, treat completion as unproven and verify it against the actual current state:45- Derive concrete requirements from the objective and any referenced files, plans, specifications, issues, or user instructions.46- Preserve the original scope; do not redefine success around the work that already exists.47- For every explicit requirement, numbered item, named artifact, command, test, gate, invariant, and deliverable, identify the authoritative evidence that would prove it, then inspect the relevant current-state sources: files, command output, test results, PR state, rendered artifacts, runtime behavior, or other authoritative evidence.48- For each item, determine whether the evidence proves completion, contradicts completion, shows incomplete work, is too weak or indirect to verify completion, or is missing.49- Match the verification scope to the requirement's scope; do not use a narrow check to support a broad claim.50- Treat tests, manifests, verifiers, green checks, and search results as evidence only after confirming they cover the relevant requirement.51- Treat uncertain or indirect evidence as not achieved; gather stronger evidence or continue the work.52- The audit must prove completion, not merely fail to find obvious remaining work.5354Do not rely on intent, partial progress, memory of earlier work, or a plausible final answer as proof of completion. Marking the goal complete is a claim that the full objective has been finished and can withstand requirement-by-requirement scrutiny. Only mark the goal achieved when current evidence proves every requirement has been satisfied and no required work remains. If the evidence is incomplete, weak, indirect, merely consistent with completion, or leaves any requirement missing, incomplete, or unverified, keep working instead of marking the goal complete. If the objective is achieved, call UpdateGoal with status "complete" so usage accounting is preserved.5556Do not call UpdateGoal unless the goal is complete or the user paused the goal and wants to resume. Do not mark a goal complete merely because you are stopping work.