terminology

An agent is the coding agent tool itself, such as Claude Code, Codex, or Gemini. A session is one running instance of that tool: a process on a machine in a repository that someone is talking to. Never call a session an agent.

The owner is who a session answers to, either another session or the user, and it controls display and attention behavior. The parent is simply the session that started it, a historical fact with no effect on display.

Use the translation table in the glossary: Controller becomes Owner, HoldState becomes Snooze, seat becomes Participation, and Crew becomes Team. Do not rename old code opportunistically; each rename is a deliberate, separate change.

Group and Crew are retired; use Mission and Team instead. Also avoid hold or parked (use snooze), seat (use participation), and supervisor or controller when referring to a session's owner.

The five roles are Standalone, Architect, Manager, Worker, and Reviewer. Four are settable today; Reviewer is agreed but not yet recordable. An Inspector is a Reviewer from a different agent family, not a sixth role.