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:

    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:

    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:

Helpful Resources