# 05 — Tickets (issues), work, and approvals

In Paperclip, work enters as an **issue** (a "ticket"), gets **assigned** to an
agent, and important results need an **approval** (your sign-off). Let's see each.

## Issue = a work order

An **issue** is a single, specific task with a title and a description. It can be
assigned to one agent.

List what exists today (read-only):

```
cd /mnt/datapool/hermes_workspace/projects/paperclip-learning
./scripts/status.sh issues
```

If nothing's there, that's fine — it just means no work is filed yet on this
project. The live `ndyinc` company may have some from the workgroup project.

## Creating a work order (practice)

Creating an issue is harmless — it's just filing a note. You can create a *test*
issue with a clear label to practice, then archive it. Create is safe; it does
not run anything by itself.

```
$NODE $CLI issue create --help
```

Read what it asks for (title/description). If you want to try, create one clearly
marked TEST and plan to delete/archive it in `docs/09-practice-runs.md`. Keep the
learning company's real work tidy.

## Approval = the boss signs off

Some work, before it's accepted, needs an **approval**. It sits waiting for the
board (you) to approve or reject. This is the "boss signing off" step.

View any pending approvals:

```
./scripts/status.sh approvals
```

## The full lifecycle

```
Create issue  →  Assign to agent  →  Agent works (heartbeat)
     →  Approval  →  Done & logged
```

You (board admin) sit at two points: **creating work** and **approving results**.
That's the position of power — you decide what gets done and what ships.

## Why this matters for you

Even if you never run a big org, understanding "issue = task, approval =
sign-off" lets you read what any Paperclip company is up to in one glance.
It's also how you'll later see **Hermes** working as an employee: it just
receives issues, works, and reports back.

## Try it

View issues and approvals (read-only). If you're comfortable explaining "what is
an issue and where does the boss sign off?", move to `docs/06-safety-and-heartbeats.md`.
