cards/docs/marketplace/seed/geografie-welt-top30/plan.md
Till JS 9a07454b75 seed: 3 Cardecky-Decks v1.0.0 + Audit-Trail im Repo
Drei Cardecky-Decks live im lokalen Marketplace, mit komplettem
Audit-Trail unter docs/marketplace/seed/:

| Deck                          | Karten | Lizenz    |
|-------------------------------|--------|-----------|
| geografie-welt-top30          |    30  | CC0-1.0   |
| english-a2-grundwortschatz    |   500  | CC-BY-4.0 |
| periodensystem-elemente       |   118  | CC0-1.0   |

648 Karten gesamt = 1296 FSRS-Reviews. Alle drei via /cards-deck-
Skill 5-Stage-Pipeline (Plan, Recherche, Design, Validate, Publish).
Bulk-Mode mit Python-Heredoc-Generator, Server-Side atomic-Insert
in <1s pro Deck.

Pro Deck im Audit-Trail:
- plan.md (Subtopic-Boundaries, Streitfälle vorab)
- research/sources.md (3-8 nummerierte Quellen)
- research/notes.md (Recherche-Notes, Streitfall-Auflösungen)
- design/build_cards.py (deterministischer Generator mit Sanity-
  Checks gegen Front-Duplikate)
- design/cards.jsonl (atomic Output, 1 Karte/Zeile)
- design/outline.md (Subtopic-Counts + F-Range)
- validate/report.md (5 Standard-Checks alle ✓)
- publish/deck.json + cards.log (Server-Response + Round-Trip)

CONTENT_PLAN §8 Phase-1-Seed-Liste: 3/20 done.

README.md erklärt die seed/-Konvention für künftige Cardecky-Decks
sowie das Update-Protokoll bei PR-Merges aus dem Marketplace.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-09 18:49:05 +02:00

2.9 KiB

Plan — Geografie Welt: Top 30 Hauptstädte

Skill-Run: /cards-deck Stage 1 (Plan), 2026-05-09 Owner: cardecky@mana.how (Plattform-Author)

Thema

30 Länder + ihre Hauptstädte als atomarer Spaced-Repetition- Grundwortschatz für Sek-1-Geografie (CH-Zyklus 3 / DE-Klasse 7-9). Ergänzt später Deck #5 aus CONTENT_PLAN (Top 195) und Deck #14 (DACH-Vertiefung).

Subtopic-Boundaries

Auswahl-Kriterien für die Top 30:

  • Alle G20-Mitglieder (19 Staaten + EU als Block, ergibt 19 Country-Slots)
  • Plus alle DACH (DE+AT+CH — DE schon in G20)
  • Plus Skandinavien (SE+NO+DK+FI), Polen, Niederlande, Belgien (für CH/DE-Lerner alltagsrelevant)
  • Plus Türkei, Israel, Ägypten, Südafrika, Nigeria (G20-Komplement + geografische Ausgewogenheit)
  • Resultat: ~30 Länder mit höchster Wahrnehmung in DACH-Lehrplänen

Final Liste in Stage 3 (cards.jsonl).

Card-Count

Ziel: 30 Karten, alle basic-reverse.

  • Front: Land → Back: Hauptstadt (1 Review)
  • Reverse: Hauptstadt → Front: Land (1 Review)
  • Pro Karte 2 Reviews → 60 FSRS-Reviews insgesamt

Card-Type-Mix

basic-reverse only. Begründung:

  • Symmetrische Wissensrelation (Land ↔ Hauptstadt)
  • Atomar pro Karte
  • Maximaler Lern-Wert pro Insert (2 Reviews bei einmal Karte angelegt)
  • Cloze ist hier overkill, Image-Occlusion ist späteres Polish-Feature

Sprache

de — Karten-Front + -Back deutsch. Hauptstadt-Namen in deutscher Schreibweise wo etabliert (Peking statt Beijing, Moskau statt Moskva, etc.) — siehe Stage 2-Recherche für deutsche Schreibkonvention.

Target

local zuerst — gegen localhost:3081 (cards-api lokal), publish in marketplace-pgSchema. Prod-Push nachgelagert sobald cardecky- Profil auch dort email_verified=true ist.

Lizenz

CC0-1.0 — Hauptstädte sind gemeinfreie Faktendaten, keine Attribution nötig, maximale Verbreitung. (CONTENT_PLAN Deck #19 Einmaleins nutzt den gleichen Logik-Pfad.)

Quellen-Strategie (Stage 2)

  • Primär: Wikipedia-Artikel pro Land mit oldid-Permalinks für langzeitstabile Referenz
  • Sekundär: CIA World Factbook für Cross-Check
  • Pflicht-Disziplin: jede Karte hat ≥ 1 source_ref

Reviewer-Stop

HIER: User (Till) sagt go für die Liste der 30 Länder oder korrigiert die Auswahl. Danach geht's weiter zu Stage 2.

Offene Punkte (vor Stage 2)

  • Hauptstadt-Streitfälle: Israel (Jerusalem vs. Tel Aviv — faktisch sitzt die Knesset in Jerusalem, völkerrechtlich umstritten), Niederlande (Amsterdam ist konstitutionelle Hauptstadt, Sitz der Regierung in Den Haag), Bolivien (Sucre konstitutionell, La Paz Sitz der Regierung) — wir müssen pro Streitfall entweder eine eindeutige Lehrplan- Referenz nehmen oder die Karte mit Klartext-Erklärung im Back-Feld auflösen. Wikipedia-Konsens als Default.
  • DACH-Vertiefung später: Deck #14 (Gebirge + Flüsse) ist ein eigener Run, nicht hier mitnehmen.