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.

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

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