Files
ruv a11537c00c docs(branch-state): /loop + /loop-worker lessons from the 38-iter ADR-110 sprint
Iter 39 — captures the 8 concrete lessons the SOTA /loop sprint learned
the hard way (cross-branch checkout incidents in iter 17-19, silent
absorption of foreign-branch Cargo.toml work in iter 18 → revert in
ca2059b07, fuzz-target stub gap in iter 11 → CI fail discovered in
iter 38). Future /loop or /loop-worker runs against THIS repo should
read these before kicking off a long autonomous sprint.

Key recommendations:
  1. git branch --show-current at the start of every iter
  2. git diff --cached before every commit after a branch switch
  3. Document sibling-region ownership in this file
  4. Extract pure helpers before committing inline mutations
     (sync_snapshot, apply_sync_packet, fleet_role_counts patterns)
  5. Cross-language wire-format pin in BOTH languages at the SAME iter
  6. Helper tests > integration tests when state is heavy
  7. Add fuzz stubs in the same commit as the firmware symbol they
     mirror (iter 38 caught c6_sync_espnow_is_valid this way)
  8. Reserve irreversible checkpoints (tag, release, PR ready) for
     iters with surplus confidence from prior CI evidence

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-05-23 15:22:42 -04:00
..