clean-russian-exchange

name: clean-russian-exchange description: Clean up Russian vocabulary CSV files from language exchange sessions. Use when the user asks to clean up, format, or process a language exchange CSV file.

Clean Russian Language Exchange Notes

Transform messy language exchange notes into properly formatted vocabulary CSV files for Anki.

Examples

See the examples/ directory:

• Raw input: examples/exchange-raw.csv
• Cleaned output: examples/exchange-cleaned.csv

CSV Output Format

4 columns, comma-separated:

Processing Rules

1. Identify Key Vocabulary

Language exchange notes are often messy with fragments, partial sentences, or just words. Extract the key vocabulary worth studying:

• Single words
• Collocations (keep phrases like физи́ческое наси́лие together)
• Useful expressions

2. Stress Marks (Column 1 Only)

• Add stress mark (´) on the stressed vowel for multisyllabic words
• Skip monosyllables (e.g., да, нет, шерсть)
• Skip words with ё (always stressed)
• Only add stress marks in column 1, not in example sentences

3. Gender for Soft Sign Nouns

• For nouns ending in soft sign (ь), indicate gender with (m.) if masculine
• Most soft-sign nouns are feminine, so only mark masculine ones
• Examples: день (m.) — day, гость (m.) — guest, дождь (m.) — rain

4. Verb Pairs

• When the word is a verb, include both the perfective and imperfective forms
• When the verb is used with a preposition in the context, include that preposition and the case used with that preposition in this context Format: imperfective/perfective (e.g., ви́деть/уви́деть)
• Only include one form if the other isn't commonly used or doesn't make sense
• Include both when learners should know the pair

5. Full Sentences

• Turn fragments into complete, natural example sentences
• Keep examples simple and relevant to the vocabulary
• Example sentences should demonstrate typical usage

6. CSV Quoting

• Wrap any field containing commas in double quotes
• Example: "Даже если у тебя есть опыт, условия другие."

Example Transformation

Raw notes (from examples/exchange-raw.csv):

увидим,will see,
физическое насилие,,
машина сломалась,,

Cleaned output (see examples/exchange-cleaned.csv):

ви́деть/уви́деть,to see,"Увидим, что будет завтра.",We'll see what happens tomorrow.
физи́ческое наси́лие,physical violence,Физическое насилие — это серьёзное преступление.,Physical violence is a serious crime.
лома́ться/слома́ться,to break down,Машина сломалась посреди дороги.,The car broke down in the middle of the road.

Creating the Anki Deck

After the cleaned CSV is ready, the user may want to create an Anki deck using create_deck.py:

python3 create_deck.py cleaned.csv -o deck.apkg

Important: Do NOT automatically create the deck after generating the CSV. The user often wants to review and edit the CSV first. Ask the user if they want to create the deck.