goal_refine_batch
Refine multiple project goals in a single batch by reading the source document once, drafting all objectives, and recording doc references while raising unresolved questions as gates.
Instructions
Refine several goals in one call. Drafting is derivable from each goal's own documentation, so the expensive part is the handful of genuine decisions, not a sitting per goal. Read the source document ONCE and slice it by heading — re-reading it per goal is the same file four times. Draft the lot, record the lot with doc_ref so the next pass has a pointer instead of a search, and raise the questions that remain as gates.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Directory identifying the project and the tree. Defaults to this session's working directory, which in a git worktree is that worktree. | |
| actor | No | ||
| goals | Yes | ||
| conferral | No | Required. ONE conferral and ONE peer call for the whole batch — not one per goal, which multiplies the wall clock by the batch size and asks a worse question each time. The pair argues about the SET of objectives — whether they overlap, whether one swallows another — and that argument does not decompose into one review per goal. |