Flashcard Drill

Run a timed flashcard drill session for a category in

0-python-flashcards/

.

Workflow

1. Setup (before starting)

• Read ALL flashcard files from the requested category directory
• Each

  .md

  file is one flashcard: the H1 heading is the question, the code block is the answer
• Tell the user the count and that you're ready
• User will say "go" or similar to start

2. Quiz Phase (be FAST)

• Present questions one at a time with the question number prefix (e.g., "Q1: How do you get bit at position i?")
• Get the question number from the filename (e.g.,

  03-clear-bit.md

  = Q3,

  01b-row-type.md

  = Q1b)
• The question text is in the

  **Q:**

  line of the flashcard (NOT the H1 heading)
• When user answers, respond IMMEDIATELY with:
  • "Correct!" or "Wrong - [correct answer]"
  • Blank line for readability
  • Then the next question in the SAME response
• NO extra commentary, NO thinking, NO explanations during the drill
• Track: correct count, incorrect cards (for later review)

3. Log Results

After the last card, ask the user for their time in seconds, then run:

~/.pyenv/versions/python-coding-dojo/bin/python scripts/log_flashcard_drill.py <category> --score <correct> --count <total> --time <seconds> --notes "Missed: Q3, Q7, Q12"

IMPORTANT: Always include

--notes

with the list of missed question numbers (e.g., "Missed: Q3, Q7, Q12"). Use the question number from the filename (e.g.,

03-clear-bit.md

= Q3).

Category names in progress.yaml:

• bitwise

  (for 1-bitwise)

• arrays

  (for 2-arrays)

• strings

  (for 3-strings)

• linked-lists

  (for 4-linked-lists)

• stacks-queues

  (for 5-stacks-queues)

• binary-trees

  (for 6-binary-trees)

• heaps

  (for 7-heaps)

• searching

  (for 8-searching)

• hash-tables

  (for 12-hash-tables)

• sorting

  (for 13-sorting)

• bst

  (for 14-bst)

• recursion

  (for 15-recursion)

• dynamic-programming

  (for 16-dynamic-programming)

• greedy-invariants

  (for 17-greedy-invariants)

• graphs

  (for 18-graphs)

4. Review Missed Cards

If any cards were missed, offer to drill them again. Repeat until user is satisfied.

5. Finish

~/.pyenv/versions/python-coding-dojo/bin/python scripts/update_readme.py

Then commit and push (no "Claude" in commit message):

git add -A && git commit -m "Log flashcard drill: <category>" && git push

Scoring Rules

From

log_flashcard_drill.py

:

• Pass: Perfect score (score == count) AND under target time
• Fail: Any wrong answers OR over target time

Flashcard Format

Each

.md

file in

0-python-flashcards/<category>/

:

# Card Title

**Q:** Question text here?

**A:** Brief answer description

\`\`\`python
answer_code_here
\`\`\`

The filename determines the question number (e.g.,

01-read-csv-basic.md

= Q1,

01b-row-type.md

= Q1b).

Example Session

User: "drill bitwise" Claude: reads all 17 files in 0-python-flashcards/1-bitwise/ Claude: "Ready! 17 cards. Say 'go' when ready." User: "go" Claude: "Q1: How do you get bit at position i?" User: "(x >> i) & 1" Claude: "Correct!

Q2: How do you set bit at position i?" ... Claude: "Done! 16/17 correct. What was your time in seconds?" User: "485" Claude: logs attempt with --notes "Missed: Q5" Claude: offers to drill missed card