You MUST use a todo list to complete these steps in order. Never move on to one step if you haven't completed the previous step. If you have multiple read steps in a row, read them all at once (in parallel).

Add all steps to your todo list now and begin executing.

## Steps

1. [Gather Arguments: Load Due Cards] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `decksPath`: documents/flashcard-decks.json
- `dueCardsPath`: session/flashcards-due-cards.json
- `deckFilter` - Optional deck slug to filter by (omit for all decks)

2. [Run Code: Load Due Cards]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/study.flashcards.load/preview,
    "args": [
      "decksPath",
      "dueCardsPath",
      "deckFilter"
    ]
  },
  "packages": null
}
```

3. [Read Due Cards Session]: Read the file at `session/flashcards-due-cards.json` and analyze its contents (Load the due cards data)

4. Check the due cards summary. If there are no cards due, tell the user
when their next card will be due and suggest they create more flashcards
if they want to study now.

If there are cards due, tell the user how many and from which decks.
Ask if they're ready to start.


5. [Read Flashcard Review Guide]: Read the documentation in: `skills/sauna/[skill_id]/references/study.flashcards.review.md` (How to conduct review sessions and evaluate answers)

6. Conduct the review session following the guidance in the slice.

For each due card:
1. Show the front (question) and wait for the user's response
2. Evaluate their answer semantically against the expected answer
3. Provide brief feedback (correct/incorrect with the right answer if needed)
4. Track the result (cardId, deckSlug, correct boolean)

Continue until all cards are reviewed or the user wants to stop.

When done, write the results to `session/flashcards-review-results.json` with format:
{
  "results": [
    { "cardId": "...", "deckSlug": "...", "correct": true/false }
  ]
}


7. [Gather Arguments: Update Review Results] The next step has the following requirements for arguments, do not proceed until you have all the required information:
- `resultsPath`: session/flashcards-review-results.json
- `decksPath`: documents/flashcard-decks.json

8. [Run Code: Update Review Results]: Call `run_script` with:

```json
{
  "file": {
    "path": https://sk.ills.app/code/study.flashcards.update/preview,
    "args": [
      "resultsPath",
      "decksPath"
    ]
  },
  "packages": null
}
```

9. Summarize the session results for the user:
- How many cards they reviewed
- How many they got correct vs incorrect
- When the missed cards will come back (tomorrow)
- Encouragement to keep up their study habit