README.md 2.2 KB
description: "The goal group map: one durable completion objective per session, with model tools, a human command, and automatic continuation, for users and maintainers navigating the group."
kind: "package-group"
packages/goal
English | 中文
Summary
The goal group lets one agent session pursue a durable completion objective across restarts, resumes, and forks. Agents can create and update the objective, while people can inspect or control it directly with /goal without spending a model turn. An optional continuation package can keep active work moving through sequential Rounds. Each session has only one current goal, and that goal records completion state rather than scheduling work; automatic continuation must therefore be enabled separately.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
goal |
One durable goal per session: create, edit, pause, resume, complete, block, and clear | ctx.goals |
tool-goal |
Model tools get_goal, create_goal, update_goal |
registers on ctx.tools |
command-goal |
Human /goal command in UI command planes |
registers on ctx.commands |
goal-round-driver |
Automatic continuation: turns an active goal into sequential Rounds | no service key |
Related documentation
- Goal subsystem — goal types, durable
goal/changeevents, and the generated service API. - Generated tool catalog — the three goal-tool schemas the model receives.
- Generated configuration catalog — every accepted config field of the goal service.
- Goal domain Agent Note — the domain design and its decisions.