cards/docs/marketplace/seed/README.md

Cardecky Seed-Decks — Audit-Trail

Reproduzierbare Deck-Erzeugung. Pro Deck eine Sub-Direktive mit allen Stages des /cards-deck-Skill-Runs:

seed/<slug>/
├─ plan.md                  Stage 1: Thema, Subtopics, Card-Count, Type-Mix
├─ research/
│  ├─ sources.md           Stage 2: Quellen-Liste mit URLs + Zugriffsdatum
│  └─ notes.md             Stage 2: Recherche, Streitfall-Auflösungen
├─ design/
│  ├─ outline.md           Stage 3: Subtopic-Counts + F-Range
│  ├─ build_cards.py       Stage 3: deterministischer Generator
│  └─ cards.jsonl          Stage 3: 1 Karte/Zeile, mit source_refs
├─ validate/
│  └─ report.md            Stage 4: 5 Standard-Checks (atomicity,
│                           source-coverage, dedupe, type-fit,
│                           mission-check)
└─ publish/
   ├─ deck.json            Stage 5: Server-Response auf POST publish
   └─ cards.log            Stage 5: Audit-Log mit Round-Trip-Zeit

Wofür dieser Trail dient

1. Reproduzierbarkeit — bei jedem Skill-Re-Run mit derselben build_cards.py muss die identische cards.jsonl entstehen (deterministisch via random.seed). Jede Abweichung deutet auf einen Bug oder eine bewusste Schema-Änderung.
2. Editorial-Transparenz — User können in research/sources.md sehen, welche Quellen Cardecky-Decks zugrunde liegen. Sie können notes.md lesen, um die Streitfall-Entscheidungen zu verstehen.
3. Versions-Bumps via PR-Merge — wenn der Marketplace einen PR auf den Deck merged, entsteht eine neue Version 1.1.0 ohne dass dieser Trail mit-aktualisiert wird. Das ist OK: der Trail dokumentiert die initiale Veröffentlichung v1.0.0; spätere Versionen leben in der DB + im PR-Verlauf.
4. Compliance / DSGVO — falls jemand fragt, woher Cardecky die deutsche Übersetzung von „neighbor" hat: research/sources.md sagt PONS [4], research/notes.md zeigt die US-Spelling- Disziplin.

Konventionen

• Slug = Verzeichnis-Name = Marketplace-Slug. Genau dasselbe in cards-drafts/ und seed/. Slug-Validation in cards/apps/api/src/lib/marketplace/slug.ts.
• Quellen werden nicht mit-versioniert. URLs in sources.md bleiben wie sie zum Skill-Run-Zeitpunkt waren. Wenn eine URL später dead ist, wird sie hier nicht ersetzt — der historische Wahrheits-Stand bleibt erhalten.
• build_cards.py ist die Wahrheits-Quelle, cards.jsonl der Output. Bei Bug-Reports auf einer einzelnen Karte: in build_cards.py korrigieren, neu generieren, neuen Publish.
• Keine Geheimnisse hier. Cardecky-PW liegt in memory/ secret_cardecky_user.md (chmod 600), nicht hier. Die publish/deck.json-Response enthält die Server-IDs, aber keine Auth-Token.

Liste

Slug	Karten	Lizenz	Stand
geografie-welt-top30	30	CC0-1.0	v1.0.0 (2026-05-09)
english-a2-grundwortschatz	500	CC-BY-4.0	v1.0.0 (2026-05-09)
periodensystem-elemente	118	CC0-1.0	v1.0.0 (2026-05-09)

CONTENT_PLAN-Stand: 3 / 20 Phase-1-Seed-Decks done.

Wenn ein neuer Cardecky-Deck dazu kommt

1. Skill-Run via /cards-deck, Workspace unter ~/Documents/cards-drafts/<slug>/.
2. Nach Stage 5 published: cp -R ~/Documents/cards-drafts/<slug> docs/marketplace/seed/.
3. Liste oben aktualisieren.
4. Commit als seed: cardecky/<slug> v1.0.0 — <count> Karten.

Wenn eine Karte falsch ist

1. PR auf /d/<slug> direkt im Marketplace einreichen (User- facing Mechanik), Cardecky merged.
2. build_cards.py hier nachziehen, sodass eine Re-Generation denselben Stand liefern würde.
3. Commit als seed/<slug>: card F-NNN korrigiert (Spiegelung von PR #X).