git:20260910.6be81e4 to git:20260910.b01cff1

2 added, 3 removed. Audit A to A.

---

name: notifying-main-agent

description: Use when a dispatched agent routes a question, progress, or status to its main agent.

---

## Overview

A Herdr-launched session is an independent agent. Discuss work details and

authorization directly with the user; the main agent accepts those decisions.

Ask it only for integrated context or a coordinator-owned action result. Address

every operation by your instruction path.

- Live bodies are delta-only and at most two sentences. Put detailed context or

+ Live bodies carry one delta in at most two sentences. Put detailed context or

evidence in repeatable `--ref`; transport adds identity, intent, and correlation.

## Ask the main agent

```bash

uv run --script "${CLAUDE_PLUGIN_ROOT}/scripts/send-dispatch-message.py" \

--instruction-path <your exact instruction path> \

--to main --intent question \

--message "<one integration question; include expected reply shape>" \

--ref "<source or artifact when needed>"

```

Continue independent work. If the coordinator's answer becomes blocking, report

`awaiting-main-agent`; a user-owned question remains `awaiting-user-input`.

## Report status

At every checkpoint and terminal outcome, make exactly one call:

```bash

uv run --script "${CLAUDE_PLUGIN_ROOT}/scripts/report-task-status.py" \

--instruction-path <your exact instruction path> \

--status <done|failed|awaiting-authorization|awaiting-user-input|awaiting-main-agent> \

--note "<outcome or exact unblock>" --ref "<proof when needed>"

```

- For `done` and `failed`, the command writes first and then notifies the recorded

- main-agent Herdr endpoint. Delivery failure is surfaced and leaves durable state

+ The command persists status before notifying the recorded main-agent Herdr endpoint. Delivery failure is surfaced and leaves durable state

for watcher recovery.

## Report a feature-branch push

```bash

uv run --script "${CLAUDE_PLUGIN_ROOT}/scripts/send-dispatch-message.py" \

--instruction-path <your exact instruction path> \

--to main --intent inform \

--message "Pushed <branch>; continuing." --ref "<MR/PR>"

```

If no live endpoint exists, record the same detail with `report-progress.py`.

Continue immediately.

**Complete when:** the intended message was delivered, or terminal status was

persisted and its Herdr notification succeeded or visibly failed.