cardslisted

# /cards — generate flashcards Creates flashcards from the topic catalog and the references under `knowledge/`, as YAML files in `cards/<topic-slug>.yaml`. ## Steps 1. No `catalog/topics.md` → point at `/catalog`, done. 2. **Determine the selection**: arguments name a topic/subtopic (match fuzzily, e.g. "bayes" → subtopic "Bayes' theorem"). Without arguments: cover the whole catalog **except the subtopics the catalog marks** — see *Scope*. When ambiguous, name the matches and ask briefly. 3. **Per subtopic**: read the referenced files (not just the catalog bullet points!) and write cards. Read `goal.md` too if the project has one: its `depth` is a **ceiling, not a slice**, so it names the highest kind of card the deck carries and every level below it comes along. An `expert` deck still carries the `awareness` card that names the concept and the `working` card that puts it to use; `depth` says how far the cards go, never where they start. Aim for 3–8 cards per subtopic, depending on how dense the material is. **One of those cards is the anchor**: every subtopic that produces cards produces at least one card that names the concept the subtopic is about and says what it is. The anchor is *one of* the 3–8, not a card on top of them — it does not raise the count. See *The anchor card* below for what it has to contain. With > 5 subtopics, parallelise generation via an agent fan-out (one agent per topic; put the reference paths and the