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

83 lines
2.9 KiB
Markdown

# 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.