> Source URL: /unit-3/project-paths/aiden-p/aiden-p-2026-04-14.guide
# Aiden's Project Guide

**Project:** Clash Royale Personality Quiz
**Category:** Data Science / Game
**Last updated:** April 14

---

> Note: This guide is created based on the latest state of your project repository + any notes from our discussion. It may not always reflect the most up-to-date information.

## Where You Are

You have a fun project idea: a personality quiz that matches you to a Clash Royale character. You've made good progress on the concept -- you have a `cards.txt` data file and a `main.py` in your `data/` folder, and your journal entry shows you're thinking through the approach.

A few things need work before Checkpoint 1 tomorrow:

- **MVP features** -- Your spec still has the template placeholder text ("Feature 1", "Feature 2"). Replace these with your actual features. Based on your journal, it sounds like the MVP is: ask personality questions, match answers to characters from `cards.txt`, display the result.
- **Category clarity** -- Your spec says "Game or Simulation" but you're using Pandas for data analysis. That's totally fine, but update your category to reflect what it actually is (could be "Data Science" or "Other -- personality quiz").
- **No pyproject.toml** -- Your project hasn't been initialized with `uv` yet.
- **Code location** -- Your `main.py` is inside `data/` which is meant for data files. Move it to the project root.

## Next Steps (Before Tomorrow 3pm)

1. **Fix your spec.** Replace the placeholder MVP features with real ones:

   ```text
   Read my project.spec.md. I'm building a Clash Royale personality
   quiz that asks questions and matches you to a character. Help me
   rewrite the MVP features to be specific and buildable. My features
   should include: personality questions, matching logic using my
   cards.txt data, and displaying the result.
   ```

2. **Scaffold your project.** Use this prompt:

   ```text
   Read my project.spec.md and the data science setup guide at
   https://csc-121.path.app/unit-3/resources/data-science-setup.guide.llm.md
   Set up my project: initialize uv, install pandas, move my main.py
   and cards.txt out of data/ to the right locations, and make sure
   I can run it.
   ```

3. **Get one tiny slice working.** A good first slice: ask the user one question, look up a match in `cards.txt`, and print the character name. Keep it simple.

4. **Update your journal.** You have a good start -- add what you're working on today.

5. **Commit and push.**

## Checkpoint 1 Readiness

By Thursday April 16th at 3pm, you need:

- [ ] Completed `project.spec.md` (replace placeholder features with real ones)
- [ ] Project initialized with `uv` and dependencies installed
- [ ] A basic scaffolding that runs
- [ ] One tiny working feature (e.g. ask one question, match to a character)
- [ ] Journal entry updated in `project.journal.md`
- [ ] Everything committed and pushed to GitHub

## Helpful Resources

- [Data Science Setup Guide](../../resources/data-science-setup.guide.md) -- follow this to scaffold your project
- [Checkpoint 1 Instructions](../../projects/final-project-checkpoint-1.project.md) -- the full checkpoint requirements


---

## Backlinks

The following sources link to this document:

- [April 14 -- Checkpoint 1 prep](/unit-3/project-paths/aiden-p/aiden-p.path.llm.md)