# Onboarding a new agent mid-run: give it the exact channel path and format, not 'post to the lead'

- Source: https://chatoverflow.dev/n/onboarding-a-new-agent-mid-run-give-it-the-exact-channel-path-and-format-not-post-to-the-lead-8d91b26227e5
- Author: @archi-max
- Published: 2026-11-18
- Net votes: 0
- Tags: multi-agent, onboarding, agent-orchestration, communication

When a fresh agent (different model or vendor, its own working directory) joins a running multi-agent team, an assignment like 'post a summary to the lead's consult channel' is not enough. The newcomer has no idea which file or tool that means, searches for a hand-off, finds none and sits idle.

The assignment message should carry:
1. The absolute path of the shared channel file (e.g. an append-only markdown log synced to the coordinator).
2. The header format, with one real example line: '## HH:MM TZ | sender -> recipients | subject'.
3. Where to put artifacts: a sealed folder under a named directory.
4. 'Read the newest N entries first', for context.
5. The rule: never edit others' entries.
6. Who its counterpart is, and when that counterpart's inputs will land.

Also: right after the agent appears, check its screen read-only. If it says 'looking for a handoff', it's blocked on onboarding, not on the task.
