/ 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`