---
title: Agents and the chart
description: Roadstar and the agents it makes, job descriptions, the chart, models and budgets.
source: [packages/agents/src/prompts.ts, packages/agents/src/tools/team.ts, packages/agents/src/org.ts, packages/agents/src/agent.ts]
---

> Roadstar docs for agents. Every page, as markdown: https://docs.roadstar.app/llms.txt

Every agent works for one person, the owner. The owner's agents are one staff: any of them can hand work to any other.

## Roadstar

Roadstar is the owner's chief of staff. It answers the owner, starts work, hands it to the agent whose job it is, and makes and changes agents. Every owner has Roadstar, and it can't be removed. It keeps the About: what every agent should know about the owner and the business.

## The agents it makes

Roadstar makes one agent at a time with `make_agent`, for a lasting job, never for a single task. An agent has:

- **A name and a job**, the job in one line: "Answers new and current clients."
- **A job description** in four parts, 600 characters together:
  - **Owns**: what it is responsible for.
  - **Good is**: what good work looks like.
  - **Works**: when it works, such as "as mail arrives" or "Fridays at 4 PM".
  - **Asks first**: what it asks the owner before doing.
- **A model**, and a thinking level for its threads. See [models](/reference/models/).
- **A budget**, in dollars a month, where the owner set one.
- **Notes**, **skills** and **routines**. See [notes and memory](/how-it-works/notes-and-memory/) and [routines and skills](/how-it-works/routines-and-skills/).

The work that led Roadstar to make an agent goes to it next, with `hand_off`, as its first work. See [making an agent](/use-cases/make-an-agent/).

Agents split by job, never by tool: every agent has every tool. Separate clients don't need separate agents. They get separate threads.

An owner keeps up to 40 agents besides Roadstar. See [limits](/reference/limits/).

## The chart

Each agent sits on a chart under another agent (`reportsTo`), Roadstar by default, and in a department. The chart is for the owner to see their agents by. Nothing that runs an agent reads it: an agent can hand work to any other agent, whatever their places on the chart.

## Every agent knows the others

An agent's instructions list every other agent by name, with its job, and Roadstar for work no one's job covers. A paused agent shows as paused.

## Budgets

An agent that spends past its monthly budget is paused, and a card on Home asks the owner whether to raise it. Nothing reaches down the chart: each agent has its own budget.

## Where an agent runs

An agent runs on Roadstar, or on one of the owner's Macs, in Claude Code or Codex. See [Macs and outside AI apps](/how-it-works/computers-and-apps/).