Q1: Comments

Options: # (Ruby, Python, Elixir) or // (Rust, Go, C). Recommendation: #. Why: It’s the Ruby and Python convention, it’s one character, and // looks like division to a reader on a phone. Doc comments are just a # block directly above a declaration; no separate ## or /// form. One comment syntax. ✅ Robert: IN (session 2). Single comment form, no block comments, no doc-comment variant. Accepted cost: no commenting-out of regions; agents delete and let history hold it.

Session 3 note (tension 6: tested doc examples)

Robert (session 3): “I want you to decide 3 through 7 because we need an answer and then we need to test everything, so your decisions are as good as mine.” So this is Claude’s call, provisional, and marked with what tests it. Decision: no change. test blocks under the code (pick 12) are the executable examples; the spec-altitude view renders a function’s pub signature, contracts and tests together, which is what Elixir’s doctests give. No doc-comment variant.