Browse pages
Agent Delegation
Agent delegation lets one software agent start another on the same working tree by giving it a written brief with its own paths. This page states what the brief carries, how a worker stays inside its paths, and how the delegating agent verifies the result before accepting it. A project selects it when one agent starts another on the same tree, so each worker owns its part instead of rewriting another's.
Stack: any
Layer: workspace
Activation#
Activation scope: project.
Applicable specification kinds: None.
The consumer selects delegation when one agent starts another agent on the same tree.
Baseline Relationship#
This extension replaces no baseline provision. The agent protocol governs one agent working alone, and this extension governs the handoff between two.
This extension switches on no optional record type.
Standards#
Write a Brief Before Delegating#
ruleruleguidancelitespec/ext/delegation#write-a-brief-before-delegatingAn agent that starts another agent MUST give it a written brief stating goal, context, sources, and output.
Why
Two agents sharing one tree collide without a written split of goal, context, sources, and output. The brief states what the worker owns and what it builds on. When workers collide, the defect lies in the brief rather than in either worker.
Example
A brief carries four sections, each answering one question for the worker.
Goal: the change the worker owns.
Context: the repository facts the change builds on.
Sources: the records and pages to read first.
Output: the files to change and the report to write.Checka reviewer answers
Reviewed forWhich briefs lack goal, context, sources, or output? Look at the briefs the delegating agent wrote.
Marked guidance: a reviewer answers this question.
Restrict a Worker to Its Paths#
rulerulecheckablelitespec/ext/delegation#restrict-a-worker-to-its-pathsA delegated worker MUST stay inside the paths its brief names and commit nothing.
Why
The brief names the paths the worker may change. A worker that stays inside them cannot rewrite what another worker owns. One that roams the whole tree overwrites parallel work and commits what nobody asked for.
Checkchecked by a tool
Checked bygit diff --name-only lists only the brief's named paths. The worker commits nothing.
Marked checkable: the tool named here checks it.
Ask Only Unanswered Questions#
ruleruleguidancelitespec/ext/delegation#ask-only-unanswered-questionsA delegated worker MUST ask no question its brief answers.
Why
The brief answers the questions the delegating agent already settled. A worker that re-asks them spends a round trip on a reading failure. Questions stay for what the brief leaves genuinely unanswered.
Checka reviewer answers
Reviewed forWhich worker questions repeat answers the brief gives? Look at the worker questions beside the brief.
Marked guidance: a reviewer answers this question.
Verify Before Accepting Worker Output#
ruleruleguidancelitespec/ext/delegation#verify-before-accepting-worker-outputA delegating agent MUST re-run the verification its brief names before accepting worker output.
Why
The delegating agent owns the result, so it re-runs the verification the brief named and watches it pass. A done claim without that run is a claim, not evidence. Accepting on trust moves the worker's defect into the delegating agent's change.
Checka reviewer answers
Reviewed forWhich accepted outputs lack a watched verification run? Look at the verification runs the delegating agent reports.
Marked guidance: a reviewer answers this question.
Hold Back Example Rows from the Implementing Worker#
ruleruleguidancelitespec/ext/delegation#hold-back-example-rows-from-the-implementing-workerA delegating agent MUST check a delegated refusal or calculation implementation against example rows held back from the worker that wrote it.
Why
Example rows given to the implementing worker become the values the implementation is tuned to pass, so the check proves nothing. Rows held back stay an independent verdict: the delegating agent runs them after the worker finishes, and the implementation passes or fails on unseen cases.
Checka reviewer answers
Reviewed forWhich delegated refusal or calculation implementations were checked only against rows the worker saw? Look at the held-back rows and the check runs.
Marked guidance: a reviewer answers this question.
Conventions#
None.
Dependencies#
Packages: None.
Related extensions: None.
Guides: None.