# 02 — The vocabulary (the words you'll keep hearing)

Learning Paperclip is mostly learning its words. Here's every one you'll meet,
with a plain-meaning and the workshop analogy. This is the glossary the
learning assistant and the quiz both use.

## Core words

| Word | What it really means | Workshop analogy |
|---|---|---|
| **Company** | The whole Paperclip "team" — its agents, budget, and settings. Yours is `ndyinc`. | The workshop. |
| **Board** | The admin/owner view — who runs the company. Its admin is **Mike** (you). | The boss's office. |
| **Agent** | One AI employee. Each has a name, a job, and skills. Can be Hermes itself. | A worker you hire. |
| **Adapter** | The "plug" that lets Paperclip drive a specific kind of AI. The **Hermes adapter** runs Hermes as an employee. | The power cable for a machine. |
| **Issue / ticket** | One specific piece of work assigned to an agent. It has a description and can be assigned. | A work order. |
| **Assignment** | Giving an issue to an agent to do. | Handing a worker a task. |
| **Approval** | A sign-off. Important work waits for the boss to approve before it ships. | The boss approves a big order. |
| **Heartbeat** | A regular check-in where an agent picks up new work and reports back. | A morning check-in with the foreman. |
| **Budget** | A limit on how much an agent may spend (on models/tools) per period. | A workman's allowance. |
| **Runtime** | The actual AI model/engine an agent uses. | The brand of machine a worker uses. |
| **Job / run** | A single execution of work that happened (a heartbeat run, a practice run). | A completed day's work, logged. |
| **Board operator** | The human who runs the board (you, Mike). | The owner. |

## A few you'll trigger in the UI

| Word | Meaning |
|---|---|
| **Onboard** | The first-run setup: booklet that creates your company and admin. |
| **Doctor** | Built-in diagnosis that checks your Paperclip install is healthy. |
| **Connections** | The linked accounts/plugs (e.g. an MCP connector to Hugging Face). |
| **Workspace operation** | Any file/folder change an agent does while working (logged). |
| **Agent Mail** | Messages between agents / from the board, task-bound. |
| **Company export/import** | Save your whole company as a portable file, or bring one in. |

## The three you must groove first

1. **Agent = employee.** Everything else hangs off that.
2. **Issue = work order.** Work happens because an issue is assigned to an agent.
3. **Approval = sign-off.** Big things pause until you approve.

If you can remember those three, you can reason about the rest.

## Quiz yourself

Run the quiz to check you've got the vocabulary:

```
cd /mnt/datapool/hermes_workspace/projects/paperclip-learning
./scripts/learnquiz.py
```

Aim for "first try" on all six. Then move to `docs/03-the-cli.md`.
