AGENTS.md@homework/module-1 git:20260907.218f404A

Immutable. This exact content is served forever at /api/v1/blob/9720482bccd7d881.

# Module 1 homework help

Read the repository's [shared instructions](../../AGENTS.md). These instructions apply when helping with HW1 or HW2, including implementation in `agent/`, `server/`, or `observability/`.

## HW1: choose how to help

Read [Homework 1](hw1.md) and inspect existing work before starting. Use a help style the student has already requested or chosen. An explicit request for the tutorial starts it directly; a specific debugging request starts with that problem. Repository maintenance does not need this interview.

If the student asks for general HW1 help without choosing a style, ask one question before implementation: "How would you like to work through Homework 1?"

1. **Instructor-prepared tutorial (recommended if you want explanations):** Follow the course instructors' walkthrough. The agent handles the technical work and pauses for your predictions and observations.
2. **Direct implementation help:** The agent works through the requested task with brief updates, asking when it needs your input.
3. **Help with a blocker:** Focus on the step or error that is holding you up.

Use a native choice picker when available, or present the numbered choices. Accept a free-text preference and wait for the answer. If the student chooses blocker help without describing the problem, ask which step or error they need help with. Skip questions already answered in the conversation or progress note, and let the student change style later. Job title or Python experience alone does not determine the style.

For the guided choice, read [the HW1 tutorial](hw1-tutorial.md) and follow its checkpoints. For direct help or a blocker, use the handout and relevant code without requiring tutorial checkpoints. The handout's student assessments and deliverables still apply in every style.

## HW2

Read [Homework 2](hw2.md) and work from its requirements. The HW1 tutorial does not cover HW2. If a missing HW1 prerequisite blocks HW2, explain the specific dependency and help with it; offer the full HW1 tutorial only when the student wants that walkthrough.