seed: curriculum content

1.solar-system/1.welcome/03.first-repo/review/general.md

@@ -0,0 +1,38 @@
+# First Repo — Extended Notes
+
+*Not rendered yet. For instructors and a future "learn more" surface.*
+
+## Purpose
+
+The first paired exercise of the program. Cadets have just finished
+the bash basics; this introduces them to the battle pattern (defender
+writes, attacker reviews, then swap) using a tiny but real Git
+workflow: init, commit, log.
+
+## Skills Demonstrated
+
+- Composing learned commands (`git init`, `git config`, `git add`,
+  `git commit`) into a single script
+- Reading another cadet's script to verify behavior
+- Filling out the review checklist constructively
+
+## Common Pitfalls
+
+- **Skipping `git config`** — the commit either fails or uses a
+  fallback identity that's not the cadet's. Reviewer should run
+  `git config --local user.name` to confirm.
+- **Wrong file content** — `echo "hello world"` (lowercase) doesn't
+  match `Hello, World`. Reviewer must `cat hello-world.txt` and check
+  byte-for-byte.
+- **Wrong commit message** — `add hello world` (no dash) is *not*
+  `add hello-world`. Reviewer should run `git log --format=%s`.
+- **Multiple commits** — sometimes a cadet stages files twice and
+  ends up with two commits. The spec asks for exactly one.
+
+## Discussion Prompts (post-battle)
+
+After both rounds, pair discusses for 2–3 minutes:
+
+1. Whose script was easier to read? Why?
+2. What did you check first when reviewing? Why?
+3. If this script ran on a server, what could go wrong?