# Menschen German — Co-learning Context Repo

This repo tracks what I've actually covered in the *Menschen* German course
(course book + workbook), lesson by lesson, so that Claude (or any LLM) has
exact context on my vocabulary and grammar level when we study together.

## How to use this with Claude

At the start of a study session, point Claude at the relevant lesson file(s)
under the current book folder (e.g. `A1.1/course-book/lesson-05.md` and
`A1.1/workbook/lesson-05.md`), or the whole `A1.1/INDEX.md` for a running
summary. Ask Claude to only use vocabulary/grammar that appears in those
files (or earlier lessons) when creating exercises, example sentences, or
corrections — this keeps practice within what I've actually learned.

## Structure

```
A1.1/
  course-book/lesson-XX.md   ← vocab, grammar, dialogues from the course book
  workbook/lesson-XX.md      ← additional vocab/exercise types from the workbook
  INDEX.md                   ← one-line summary of every lesson so far
A1.2/                        ← added once I move on to the next book
  ...
```

## Adding a new lesson

1. Upload photos or a PDF of the course book / workbook pages for that lesson.
2. Claude extracts content into `lesson-XX.md` using `_template.md`.
3. Review and correct anything Claude got wrong or over-summarized.
4. Update `INDEX.md` with a one-line entry for the lesson.
5. Commit.

## Audio (listening exercises)

Course book audio has no printed transcript (the workbook's back section is
the *Lösungsschlüssel* — answer key — not a transcript, so that doesn't help
here). Raw audio files are **not** stored in this repo (see `.gitignore`);
only their transcripts are, since that's what gives Claude context.

Workflow:
1. Get the audio files locally (publisher CD/app/download), any folder outside git.
2. Run `scripts/transcribe.py` (uses `faster-whisper` on GPU) to transcribe them:
   ```bash
   pip install faster-whisper
   python scripts/transcribe.py "<path-to-lesson-audio>" "A1.1/course-book/transcripts/lektion-XX"
   ```
3. Skim the `.txt` output for ASR mistakes (names, numbers, fast speech) and fix them.
4. Reference/paste the transcript into the lesson's `.md` file under "Audio / Listening",
   or just point at the `transcripts/lektion-XX/*.txt` path — either works, transcripts
   are small text files so committing them is fine.

## Adding a new book (e.g. A1.2)

Copy the `A1.1/` folder structure (minus content) into a new `A1.2/` folder
and repeat the process.