Data Track — Week 1 Assignment

The HackYourFuture Data Track Week 1 assignment: The Data Cleaning Pipeline.

Full instructions, learning context, and submission flow live in the curriculum chapter: Week 1 Assignment on Notion. Read it first; this README is a quick reference.

How to start

1. Fork this repository (HackYourAssignment/c55-data-week1) to your own GitHub account using the Fork button at the top right.
2. Clone your fork locally:

   git clone https://github.com/<your-username>/c55-data-week1.git
   cd c55-data-week1

3. Create a working branch: git switch -c week1-attempt
4. Work through the three tasks below. Commit and push to your fork as you go.
5. Open a Pull Request from <your-username>/c55-data-week1:week1-attempt against HackYourAssignment/c55-data-week1:main. The auto-grader runs on every push and posts a score comment on the PR.

⚠️ Do not click "Use this template". This repo is your cohort's assignment repo: fork it and open the PR back here so your teacher can review and grade.

Tasks at a glance

Task	Folder	Points	What you build
Task 1 — Cleaner Pipeline	task-1/	60	A modular Python pipeline that reads data/messy_users.csv, cleans each field via helpers in src/utils.py, validates, and writes JSON to output/clean_users.json.
Task 2 — AI Debug Report	task-2/	20	Document one debugging session where you used an LLM to fix a bug. Fill in the four sections of AI_DEBUG.md.
Task 3 — HYF Azure proof	task-3/	20	Accept the HYF Azure tenant invite, switch to that directory, screenshot proof at task-3/azure_proof.png.

Total: 100 · Passing: 60.

Repository layout

.
├── task-1/
│   ├── data/
│   │   └── messy_users.csv      # the dataset (committed; do not edit)
│   ├── src/
│   │   ├── cleaner.py           # entry point — fill in TODOs
│   │   └── utils.py             # field-cleaning helpers — fill in TODOs
│   └── output/
│       └── clean_users.json     # your cleaner writes here
├── task-2/
│   └── AI_DEBUG.md              # fill in the four sections
├── task-3/
│   └── azure_proof.png          # add your screenshot here
├── .hyf/
│   └── test.sh                  # auto-grader (read it to see exactly what it checks)
└── .github/workflows/
    └── grade-assignment.yml     # runs .hyf/test.sh on every PR

Run the grader locally

Before opening a PR, run the same checks the auto-grader runs:

bash .hyf/test.sh
cat .hyf/score.json

This prints a per-task breakdown and writes score.json. Iterate until pass: true (or until you've given it your best attempt), then push.

Submission

Open a PR from your fork against HackYourAssignment/c55-data-week1:main. Share the PR URL with your teacher.