# Organization one picture of a tenant's people and agents and how they stand to each other. At the top is the organization itself — the tenant, by its name — never a person assumed to be in charge. People report to people or to the organization; every agent reports to a person, its **manager**, or to the organization, whose owners then answer for it; and agents **work with** the people allowed to talk to them. It draws what the registry already holds — it is a view of who answers for what, never a second source of permissions. **Has:** the tenant's people (`person.md`) · its agents, each with its manager (`agent.md`) · two kinds of line: *reports to* (person → person or organization, agent → person or organization) and *works with* (agent ↔ person, from who is allowed to talk to the agent). Nothing of its own is stored: deleting the tenant deletes what it is drawn from. ## The shape - People and agents sit on one chart under the organization. A person reports to a person or to the organization. An agent reports to a person, to the organization, or to another agent — to any depth, so a lead agent can have agents under it, and they agents of their own. Nobody reports to an agent but an agent. People work with agents whoever manages them. - Every person with access to an agent is drawn working with it. The line is the same fact as the access: giving someone access on the agent's People tab draws it, taking it away removes it ([AGENTACCOUNT-ACCESS-IS-GRANTED](https://tonoman.com/docs/agent-account#agentaccount-access-is-granted)) — the chart adds no permission of its own. - e.g. Ben given access to Nova (managed by Ana) → a works-with line Ben–Nova; his access taken away → the line is gone within seconds. ## Managers - An agent placed directly under the organization is answered for by the tenant's owners: they are its managers for every rule here, and it is told about through them. No account stands in for the organization. Until someone places it, it reads *placed — confirm*. - e.g. Nova under Northwind Lab → each owner can change Nova as its manager; no "Northwind" login exists. - Follow any agent up through the agents it reports to and you reach a person or the organization: that is who **answers for** it, and for every agent in between. An agent that leads agents answers for none of them. - e.g. Proof reports to Scribe, Scribe to Nova, Nova to the organization → Northwind Lab's owners answer for all three. - The person who answers for an agent may change it — its settings, who may talk to it, its skills, and which agent it reports to — as an owner or admin may, whatever their own role in the tenant; so may the person who answers for the agent it reports to, all the way up. Answering for one chain gives no right over any other. - e.g. Ben is a member and Nova's manager → he edits Nova; he opens Echo and every control is disabled. - When a manager leaves ([PERSON-LEAVES](https://tonoman.com/docs/person#person-leaves)), each agent they managed is managed at once by whoever the leaver reported to — a person, or the organization and so its owners. Agents under those agents stay where they are: the chain moves whole. The agents keep serving everyone else; nothing waits for the hand-over. - e.g. Ana leaves; Nova now reports to Carla; Ben still talks to Nova the same minute. - What is the agent's stays when its manager leaves: its Slack app, its shared login, its skills and their settings, the tenant's credentials, and the people allowed to talk to it. What was the leaver's goes: their place on every agent of the tenant (their own login there, whether they were allowed), their personal credentials (revoked) and their brains (archived), and being known as a member. Their membership is not touched: leaving and losing Hub access are separate acts. - e.g. a per-person agent: Ana leaves → Ben's turns are unaffected; nothing runs on Ana's login again. - e.g. a shared agent signed in with Ana's own Claude login → it keeps serving until that login expires, and the new manager is told the login was a person's ([ORG-HANDED-OVER-IS-SAID](/docs/organization#org-handed-over-is-said)). - The new manager is told what came to them and from whom, and each agent handed over shows *inherited — confirm* on the chart until they confirm it or give it to someone else. The notice names anything that still leans on the leaver, such as a shared login they signed in with. - A change that would make an agent report to itself, directly or through other agents, is refused and nothing is written. - e.g. Scribe reports to Nova; making Nova report to Scribe → refused. ## The chart - The Organization screen draws the chart top-down from one card for the organization, named as the tenant: people as cards with name and title, each agent as a smaller card under its manager, works-with lines dashed. It pans, zooms and fits to the screen, and a card opens that person or agent. - An agent's card shows the same state and login badge as its card in the fleet ([AGENT-FLEET-STATE](https://tonoman.com/docs/agent#agent-fleet-state), [AGENT-FLEET-MATCHES-SCREEN](https://tonoman.com/docs/agent#agent-fleet-matches-screen)). - The chart opens on what involves agents: everyone who manages or works with one, and the chain above them. *Everyone* shows the whole organization. - People and agents are always counted apart: every card with anything under it says how many people and how many agents, and the chart says, for the part it is showing, how many of each sit at every level below the top. - e.g. Northwind Lab → level 1: 4 people · 1 agent; level 2: 1 person · 3 agents; level 3: 2 agents. - Every card with people or agents under it folds or unfolds them. A *Levels* control shows one, two, three or every level below the top; a tenant of more than fifty people opens at two. - e.g. Acme (481 people) opens with the organization, its two tops and their direct reports; the CEO's card says 256 under it. - Finding someone deep in the organization draws only their manager's part of it. Everything above folds to a trail of the organization, how many levels lie between, and the manager's own manager — each one a way back up — led by *Whole organization*, the way home. - e.g. a director four levels down → "Acme / 1 more above / / "; "1 more above" unfolds to the name it hides. - Selecting a card opens it where it stands, on a phone as on a desktop: the whole description the card had to cut short, the harness and model, its skills, who it reports to and works with, and *Open profile*. Its works-with lines are drawn while it is open; closing it hides them. - e.g. Scout's card reads "Answers questions about the p…"; selected → the full line, Claude Code · Sonnet, Rodolfo and Erich, and Open Scout's profile. - A person and an agent each have a profile reached from the chart: who they report to and answer for, what is under them by level, the agents they manage or work with, and, for an agent, the harness it runs on and its skills. *Edit* opens the person's edit page, or the agent's existing page with its manager added to it. - From a profile or an edit page, the breadcrumb and the back link lead to the Organization screen as it was left: the same tenant, line, levels and open card. - e.g. chart → Nova → Edit → *Organization* in the breadcrumb → the chart, Nova still open. - Finding a person or an agent by name opens the line it sits in, unfolds the way down to it, and selects it. - A manager's reports with nobody shown under them stack in a block of columns rather than one long row, so a team of seventeen reads as a box. - When more than a dozen people sit directly under the organization with nobody under them, they are drawn as one *Not placed yet* card with their number, listed when it is opened. A directory is often like this (Acme: 221 of 481, mostly without title or department). - Every member sees the chart; only those who may change a person or agent see its controls ([PERSON-EDITED-BY-ADMINS](https://tonoman.com/docs/person#person-edited-by-admins), [ORG-MANAGER-MANAGES](https://tonoman.com/docs/organization#org-manager-manages)). Another tenant's people never appear. - At phone width the chart becomes an indented list in the same order, nothing scrolling sideways.