From 081a464b044d8e0736609f83e43f442d7ac54160 Mon Sep 17 00:00:00 2001
From: CorVous <60035620+CorVous@users.noreply.github.com>
Date: Tue, 7 Apr 2026 18:21:58 -0700
Subject: [PATCH 1/3] Add CLAUDE.md with project notes and workflows

---
 CLAUDE.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 CLAUDE.md

diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..db0fd43
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1,25 @@
+# Claude Notes
+
+## First Step
+
+Update uv before anything else: `uv self update`
+
+## Key Documents
+
+- **`plan.md`** — contains the project plan and feature roadmap
+- **`README.md`** — contains project overview and development commands
+
+## TDD Workflow
+
+Always follow red/green TDD:
+1. Write a failing test first (red)
+2. Write the minimum code to make it pass (green)
+3. Refactor if needed
+
+**Import errors do not count as red.** A test that fails due to an `ImportError` or `ModuleNotFoundError` is not a valid red test — the module/function must exist before the test can legitimately fail for the right reason.
+
+## After Every Code Assignment
+
+1. Run `uv sync --dev` to keep dependencies up to date
+2. Run `uv run ruff check` to lint
+3. Run `uv run ty check` to type-check

From c74b024456649c284aa13303ff88cc79426547c8 Mon Sep 17 00:00:00 2001
From: CorVous <60035620+CorVous@users.noreply.github.com>
Date: Wed, 8 Apr 2026 00:29:19 -0700
Subject: [PATCH 2/3] Update commands for code assignment process

---
 CLAUDE.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index db0fd43..4c58cc6 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -22,4 +22,5 @@ Always follow red/green TDD:
 
 1. Run `uv sync --dev` to keep dependencies up to date
 2. Run `uv run ruff check` to lint
-3. Run `uv run ty check` to type-check
+3. Run `uv run ruff format` to format
+4. Run `uv run ty check` to type-check

From c88ab952bc9a664740811a99a2cfd9846ba73bd5 Mon Sep 17 00:00:00 2001
From: CorVous <60035620+CorVous@users.noreply.github.com>
Date: Wed, 8 Apr 2026 14:01:25 -0700
Subject: [PATCH 3/3] Clarify stub requirement for valid red tests

---
 CLAUDE.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 4c58cc6..a4d4b67 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -16,7 +16,7 @@ Always follow red/green TDD:
 2. Write the minimum code to make it pass (green)
 3. Refactor if needed
 
-**Import errors do not count as red.** A test that fails due to an `ImportError` or `ModuleNotFoundError` is not a valid red test — the module/function must exist before the test can legitimately fail for the right reason.
+**Import errors do not count as red.** A test that fails due to an `ImportError` or `ModuleNotFoundError` is not a valid red test — the module/function must exist as a stub before the test can legitimately fail for the right reason.
 
 ## After Every Code Assignment