> ## Documentation Index > Fetch the complete documentation index at: https://docs.langchain.com/llms.txt > Use this file to discover all available pages before exploring further. # Goals and rubrics > Define objectives and acceptance criteria for Deep Agents Code sessions Goals and rubrics help Deep Agents Code check whether its work satisfies the criteria you care about. Use a goal for objective-driven work where the agent should help define acceptance criteria, and use a rubric when you already know the criteria. ## Choose a goal or rubric Use a **goal** when you have one measurable objective and want Deep Agents Code to draft acceptance criteria before it starts. A goal has a lifecycle: once accepted it stays active across turns until you pause it, the agent marks it completed or blocked, or you clear it. You can also amend an active goal without restarting the work. Use a **rubric** when you already know the criteria you want the agent graded against. A rubric can apply to the next turn only or persist across future turns. Common patterns: * **One objective, agent drafts criteria**: Use `/goal `. * **Persistent criteria for every turn**: Use `/rubric set `. * **Criteria stored in a file**: Use `/rubric file `. * **One-turn quality gate**: Use `/rubric next `. ## Use a goal Use `/goal` when you know the outcome you want, but want Deep Agents Code to propose the acceptance criteria before work begins. Goals are useful for open-ended work: the agent turns an objective into a concrete definition of done, then iterates until those criteria are satisfied. ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} /goal add OAuth refresh handling ``` Deep Agents Code drafts acceptance criteria for review before starting the task. In the inline review you can accept the proposal, edit the criteria, request another revision, or cancel it. After you accept the criteria, the goal stays active across turns until it is paused, completed, blocked, or cleared. This approach lets you work toward a larger objective over multiple turns: ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} /goal migrate auth callbacks to the new API start with the OAuth callback now update the tests check the docs too ``` The goal panel above the input shows the current objective and whether it is active, paused, blocked, or completed. Use `/goal show` to inspect the current goal, and `/goal clear` to remove it. ### Amend, pause, and resume a goal Steer an ongoing goal without cancelling the current task and replaying work: * `/goal amend ` proposes coordinated updates to the objective and criteria. The amendment goes through the same inline review (accept, edit, revise, or cancel) before finalizing. * `/goal pause` saves the goal without letting it drive work or grading, so intervening prompts run without it. `/goal resume` reactivates the saved goal and continues from the existing conversation. ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} /goal amend remove JSON export, add streaming CSV support, keep the CSV tests /goal pause /goal resume ``` ### Completion and grading Each follow-up turn is graded against the goal's acceptance criteria until the work is done. * When a goal's completion is approved, Deep Agents Code clears the goal - `/goal `: Draft acceptance criteria from a plain-language objective and review them before work begins. - `/goal amend `: Propose coordinated updates to the objective and criteria for review. - `/goal pause`: Save the goal without letting it drive work or grading. - `/goal resume`: Reactivate a paused goal and continue from the existing conversation. - `/goal show`: Inspect the current goal, its status, and its criteria. - `/goal clear`: Remove the active goal. - `/goal model [provider:model|clear]`: Set or clear the model that grades the goal. - `/goal max-iterations `: Set or clear the maximum grading iterations for the goal. ## Use a rubric Use `/rubric` when you already know the acceptance criteria and want them to act as a quality gate for the agent's work. ```text theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} /rubric set tests pass; no unrelated files changed; help text is updated /rubric next only change the auth callback; do not refactor unrelated code /rubric file acceptance.md ``` A sticky rubric applies to future turns until cleared. A next-turn rubric applies only to the next submitted task. * `/rubric show`: Inspect the active rubric. * `/rubric clear`: Remove the active rubric. * `/rubric model `: Set the model that grades rubric results. Non-interactive runs cannot pause for goal review. Use `--rubric` for tasks where criteria are already known: ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} dcode -n "implement OAuth refresh handling" --rubric "tests pass; no unrelated files changed" dcode -n "implement OAuth refresh handling" --rubric @acceptance.md ``` You can also set the grader model and maximum grading iterations: ```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}} dcode -n "implement OAuth refresh handling" \ --rubric "tests pass; no unrelated files changed" \ --rubric-model openai:gpt-5.5 \ --rubric-max-iterations 3 ``` ## See also * [Deep Agents Code overview](/oss/javascript/deepagents/code/overview) * [Quickstart](/oss/javascript/deepagents/code/quickstart) ***
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers. [Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/code/goals-and-rubrics.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).