notes/beads.md line ~62 ('The five commands a coder needs') shows: bd comment <id> --body "text". Against the pinned bd 1.2.2 this errors 'unknown flag: --body' — the real forms are positional text (bd comment <id> "text"), --stdin, or --file (per bd comment --help). Hit live 2026-08-20 following the note verbatim. Post design-011 flip this line is on every session's claim/comment path, so the broken example bites immediately. Fix: correct the example; worth a quick sweep of the same block's other commands against 1.2.2's actual flags while there.
None.
Fixed: notes/beads.md line 62 now reads
bd comment <id> "text"(positional, or --stdin/--file), never --body. Verified the rest of that block (create/show/update/ready flags) against bd 1.2.2's actual --help output — all correct as documented, no other fixes needed. tools/nflib/bd.py's Bd.comment() already used --file correctly, so this was docs-only.