/ commit-mapping.md
commit-mapping.md
1 # Commit Mapping: Course Lessons → Commits 2 3 Starting point: `main` branch 4 End point: `live-run-through` branch 5 6 Commit naming: `XX.YY.ZZ: Title` 7 8 ## Sources 9 10 Commits come from two repos: 11 - **Main repo**: `live-run-through` branch in this repo 12 - **Fork repo**: `~/repos/ai/cohort-003-project-fork` (a throwaway fork created during lesson 07.07) 13 - To fetch: `git remote add fork ~/repos/ai/cohort-003-project-fork && git fetch fork` 14 - Fork commits are used for 07.08 (admin analytics Phase 3 + polish) 15 16 ## Section 01: Before We Start 17 18 No commits. All conceptual/setup lessons. Students start from `main`. 19 20 - 01.01 Where We're Going — no commit 21 - 01.02 Repo Setup — no commit 22 - 01.03 Playground Walkthrough — no commit 23 - 01.04 How To Take This Course — no commit 24 - 01.05 Which Model Should I Use? — no commit 25 - 01.06 How Big A Subscription Will I Need? — no commit 26 - 01.07 Navigating The Discord — no commit 27 28 ## Section 02: Getting To Know Claude Code 29 30 No commits. All conceptual/demo lessons. 31 32 - 02.01 Managing Your Claude Code Session — no commit 33 - 02.02 Prompting In The Terminal — no commit 34 - 02.03 Claude And Your IDE — no commit 35 - 02.04 Going Forwards And Backwards In Time — no commit 36 - 02.05 Running Bash Commands — no commit 37 - 02.06 Permissions — no commit 38 39 ## Section 03: Day 1 Fundamentals 40 41 **Status: CONFIRMED** 42 43 - 03.01 The Constraints Of LLMs — no commit 44 - 03.02 What Are Subagents — no commit 45 - 03.03 Codebase Exploration — no commit (exploration only, no code produced) 46 - 03.04 Build A Feature — `03.04.01: Add course star rating system` ← squash from `0111bd2` 47 - 03.05 Showing Context In The Status Line — no commit 48 - 03.06 What Is Plan Mode — no commit 49 - 03.07 The Plan-Execute-Clear Loop — `03.07.01: Add lesson comments with soft-delete and moderation` ← squash from `577a82d` 50 - 03.08 Compaction — no commit 51 52 ## Section 04: Day 2 Steering 53 54 **Status: CONFIRMED** 55 56 - 04.01 What Is An Agents.md File — `04.01.01: Add CLAUDE.md with steering instructions` ← from `5e288ba` 57 - 04.02 Steering With The Agents.md File — `04.02.01: Add lesson bookmarks for enrolled students` ← from `c0fe1c3` (includes CLAUDE.md updates) 58 - 04.03 Progressive Disclosure — no commit (conceptual) 59 - 04.04 What Are Agent Skills — no commit (conceptual) 60 - 04.05 A Skill For Writing Skills: 61 - `04.05.01: Add write-a-skill skill` ← from `2cdac0d` 62 - `04.05.02: Add zod-to-valibot skill` ← skill files from `18eca59` + `0ba1d7d` (CLAUDE.md removal folded in) 63 - `04.05.03: Migrate Zod to Valibot` ← app changes from `18eca59` 64 - 04.06 Automatic Memory — no commit 65 66 ## Section 05: Day 3 Planning 67 68 **Status: CONFIRMED** 69 70 - 05.01 How To Tackle Massive Tasks — no commit 71 - 05.02 Write Great PRDs With This Skill: 72 - `05.02.01: Add write-a-prd skill` ← from `ec26d3b` 73 - `05.02.02: Add instructor analytics dashboard PRD` ← from `d593610` 74 - 05.03 Split Features Across Multiple Context Windows — `05.03.01: Add naive multi-phase plan` ← from `aa592e6` 75 - 05.04 What Are Tracer Bullets — no commit 76 - 05.05 Use Tracer Bullets In Our Multi-Phase Plan: 77 - `05.05.01: Add prd-to-plan skill` ← from `b1fa4b2` 78 - `05.05.02: Improve plan with tracer bullets` ← from `f58a0ce` (overwrites naive plan) 79 - 05.06 Executing Our Multi-Phase Plan: 80 - `05.06.01: Instructor analytics Phase 1 — service + route + summary cards` ← from `c480c9b` 81 - `05.06.02: Instructor analytics Phase 2 — revenue chart + per-course table` ← from `a658f4e` 82 - `05.06.03: Instructor analytics Phase 3 — admin access + empty states` ← from `b86284f` 83 84 ## Section 06: Day 4 Feedback Loops 85 86 **Status: CONFIRMED** 87 88 - 06.01 Is Code Cheap — no commit 89 - 06.02 Steering Agents To Use Feedback Loops With Skills — no commit 90 - 06.03 Building A Do Work Skill — `06.03.01: Add do-work skill` ← from `ea4fb35` 91 - 06.04 Using Our Do Work Skill: 92 - `06.04.01: Add in-app notifications PRD and plan` ← from `f7a683a` (setup) 93 - `06.04.02: Add in-app enrollment notifications for instructors` ← from `afc9937` (solution) 94 - 06.05 Fixing Agents' Broken Formatting With Pre-Commit — `06.05.01: Add Husky pre-commit hooks with lint-staged` ← from `e608069` 95 - 06.06 What Is Red-Green-Refactor — no commit 96 - 06.07 Red-Green-Refactor: 97 - `06.07.01: Add coupon redemption notifications plan` ← from `b05ab02` (setup) 98 - `06.07.02: Update do-work skill with red-green-refactor` ← from `a0b5325` 99 - `06.07.03: Add coupon redemption notifications for team admins` ← from `a4b3ccb` (solution) 100 101 ## Section 07: Day 5 RALPH 102 103 **Status: CONFIRMED** 104 105 - 07.01 What Is RALPH — no commit 106 - 07.02 HITL vs AFK RALPH — no commit 107 - 07.03 Trying HITL RALPH: 108 - `07.03.01: Add admin analytics PRD and plan` ← from `d589fd0` (setup) 109 - `07.03.02: Admin analytics Phase 1 — summary cards via HITL` ← from `c897b95` (solution) 110 - 07.04 Sandboxing — no commit 111 - 07.05 Setting Up And Trying AFK RALPH — `07.05.01: Admin analytics Phase 2 — revenue chart via AFK` ← from `306c513` 112 - 07.06 Using Backlogs To Queue Tasks For RALPH — no commit 113 - 07.07 Setting Up Our Repo For GitHub Issues — no commit 114 - 07.08 Hooking Up RALPH To Your Backlog: 115 - `07.08.01: Hook up RALPH to GitHub issues` ← from `45e8f01` 116 - `07.08.02: Admin analytics Phase 3 — course breakdown table` ← from fork `5fbd305` 117 - `07.08.03: Change admin analytics default period to 12 months` ← from fork `777221a` 118 - 07.09 Updating Our PRD And Plan Skill To Use GitHub — `07.09.01: Update PRD and plan skills to use GitHub` ← from `f8d8719` 119 120 ## Section 08: Day 6 Human-In-The-Loop Patterns 121 122 **Status: CONFIRMED** 123 124 - 08.01 HITL And AFK Tasks — no commit 125 - 08.02 Don't Plan, Kanban — `08.02.01: Add prd-to-issues skill` ← from `5527d0b` (replaces prd-to-plan skill) 126 - 08.03 Using The Kanban Skill: 127 - `08.03.01: Add gamification PRD` ← from `587ba10` (setup) 128 - `08.03.02: Add XP, streaks, quiz XP, and dashboard gamification` ← squash `ebfe6c9` + `7462241` + `54af3a7` + `31f9f1e` (solution) 129 - 08.04 Research — no commit 130 - 08.05 Trying Out Research — `08.05.01: Add live-presence-indicator research` ← from `93b11a2` 131 - 08.06 Prototyping — no commit 132 - 08.07 Trying Out Prototyping — `08.07.01: Add live presence prototype with Ably` ← from `1be908f` 133 - 08.08 Designing Codebases AI Loves — no commit 134 - 08.09 The Improve My Codebase Skill — `08.09.01: Add improve-codebase-architecture skill` ← from `a357190` 135 - 08.10 Adding Module Awareness To Our Plan/PRD Skill — `08.10.01: Add module awareness to write-a-prd skill` ← from `c1295dc`