Bee Box documentation · directory: https://beebox.run/docs/reference/cards/ · index: https://beebox.run/docs/reference/cards/index.md · root: https://beebox.run/llms.txt

# progress Card

# Progress Cards

A progress card is a per-learner, **evidence-backed** record of what a learner understands. It is tracked **separately** from a course's content — its own card, which may live in the course's attach scope or in its own tree (it points back at the course by `ref`). Each entry is a qualitative status for one **concept-map node** (named by the node's `id`).

## Keep it sparse — record only what you have signal on

It is a **sparse overlay on the concept-map, not a mirror of it.** Add an entry only for a node you actually have signal on — something you observed, or a genuine inference worth keeping. **A node with no entry simply means "not assessed yet"** — that's the default, and it's fine. **Do not enumerate the whole map** or manufacture "not directly probed; inferred from…" entries; that's tedious noise, not knowledge. A handful of real entries beats a full sweep of filler.

## No status without evidence

Every entry must cite the learner's actual words/work and how the rating was reached:

- `status`: `unfamiliar | partial | working | solid` — qualitative, and **judged against the course's `success-criteria`**. Understanding the mechanism with fuzzy terminology can be `working`/`solid` when names aren't the goal.
- `basis`: `observed | inferred | self-report` — how you know.
- `evidence`: at least one concrete item — what the learner said or did. **Rate the evidence, not the learner's confidence.** Don't upgrade a status just because they sound sure.
- `next-probe` (optional): what would test or change this rating.
- `misconception` (optional): an active wrong model to address.

This is a **present-state snapshot, not a decay model** — it records where the learner is now, not forgetting over time.

```yaml
course: { ref: /_content/courses/Acids.course.card }
learner: the-learner
entries:
  - node: electron-transfer        # a concept-map node id
    status: partial
    basis: observed
    evidence:
      - "Said acids 'give away' something but couldn't say what; didn't mention protons"
    next-probe: Ask what's actually moving when an acid reacts
    misconception: Thinks acidity is about taste/corrosiveness, not proton donation
```

## Session log

The running narrative of each sitting — what was covered, notable utterances, ratings changed and why — lives as a plain file in this card's `<basename>.attach/` scope, **not** in the card body. The body is a short running summary.

## The `contains:` field

Give this card a one-sentence `contains:` — the prime retrieval field for
`bbx search` and listings. How to write a good one (carry the information when
it's concise, never a list of parts, under 200 characters) is in the agent
guide's ABOUT_CARDS section.

## Templates

### progress

A per-learner, evidence-backed record of understanding against a course's concept-map

```bash
bbx create <path>.progress.card -t progress
```

Template: progress
Description: A per-learner, evidence-backed record of understanding against a course's concept-map
Card types: progress

Arguments:
  title (optional): Display title