Save session: document metadata vs body distinction

Update CLAUDE.md with metadata placement rules learned during
concepts page audit. Update NOTEBOOK.md with session history.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: respencer-ncl

CLAUDE.md

@@ -220,6 +220,25 @@ This site migrated from Hugo to MkDocs Material. Remove any Hugo shortcodes:
 Always use **RIDDL** (all caps) in prose. It's an acronym. Not "Riddl" or
 "riddl" except in code/filenames where lowercase is conventional.
 
+### Metadata vs Body Definitions
+
+RIDDL has a critical distinction between **body definitions**
+(inside `{ }`) and **metadata** (in `with { }` after the body):
+
+- **Body**: types, handlers, entities, states, functions, etc.
+- **Metadata**: term, option, author_ref (`by author`), briefly,
+  described by, attachment
+
+**Author definitions** (not references) only occur in Module and
+Domain bodies. All other definitions use `by author Name` in
+their `with { }` block to reference an author.
+
+**Option syntax** requires `is`: `option is event-sourced`,
+`option is technology("Kafka")`.
+
+**Term syntax**: `term SKU is { |Stock Keeping Unit... }` — not
+`term "SKU" is described by "..."`.
+
 ### RIDDL Syntax in Examples
 
 Code examples must match the EBNF grammar. Common issues to avoid:
@@ -230,7 +249,8 @@ Code examples must match the EBNF grammar. Common issues to avoid:
 
 2. **User terminology**: Use "User" not "Actor" (per Use Cases 2.0)
 
-3. **Hyphenation**: `event-sourced` (hyphenated as compound modifier)
+3. **Hyphenation**: `event-sourced` (hyphenated as compound
+   modifier)
 
 4. **Version requirements**:
    - JDK 25 (current LTS)

NOTEBOOK.md

@@ -2,8 +2,23 @@
 
 ## Current Status
 
-Documentation site is complete and deployed at https://ossum.tech. All major
-sections are documented with proper RIDDL syntax highlighting.
+Documentation site is complete and deployed at https://ossum.tech.
+All major sections are documented with proper RIDDL syntax
+highlighting.
+
+**Completed (2026-02-09):**
+
+- Fixed metadata vs body definition confusion across 10 files
+  - Rewrote metadata.md, author.md, term.md, option.md to show
+    correct `with { }` placement and syntax
+  - Removed incorrect Contains entries (Authors, Options, Terms)
+    from context.md, entity.md, projector.md, adaptor.md
+  - Removed Options and Terms from domain.md Contains (kept
+    Authors — correct per grammar)
+  - Updated cheat-sheet.md containment table to distinguish body
+    definitions from metadata, fixed "Lives in" entries for Term,
+    Option, and Author
+  - All examples now match EBNF grammar
 
 **Completed (2026-01-29):**