# Notes

## Learner profile
- Goal: **thorough understanding** of unclebob/swarm-forge for **reimplementation + customization**
- Target rewrite: **Rust** or **TS + TUI** (undecided; pick after domain model is clear)
- Clone location: `/tmp/swarm-forge` (main) and `/tmp/swarm-forge-packs/{two,four,six}-pack`
- Teach workspace only under `SwarmForge/` here — no project code in this folder

## Teaching preferences
- What / how / why — load-bearing decisions, not shell trivia
- Ground every claim in repo files (README, handoff-protocol, `.bb` scripts, pack branches)
- Build toward a **migration map**: what must be reimplemented vs swapped
- Short interactive lessons; dense facts live in `reference/`
- **Visuals matter:** learner asked for strong diagrams after lesson 2 — prefer interactive steppers / maps for spatial-temporal concepts

## Repo map (for the teacher)
- `main` — documentary + shared operational scripts (Babashka) + default constitution articles
- Runnable branches: `two-pack`, `four-pack`, `six-pack` — conf, roles, local constitution; `./swarm` pulls scripts from main
- Core code: `swarmforge/scripts/swarmforge.bb` (launcher), `handoffd.bb`, `swarm_handoff.bb`, queue helpers, terminal adapters
- Protocol doc: `swarmforge/handoff-protocol.md`
- Tests: `test/swarmforge/handoff_test.clj`, `script_test.clj`

## Session log
- 2026-07-14: Workspace scaffolded; mission set from user intent; resources from primary repo; lesson 1 (three-layer map)
- 2026-07-14: Learner passed lesson 1; lesson 2 (handoff lifecycle) + handoff-lifecycle reference
- 2026-07-14: Learner passed lesson 2; requested visualizations → handoff-viz interactive reference
- 2026-07-14: Send-vs-finished Q&A; learner passed; lesson 3 pack pipelines + pack-pipelines viz