Generate skeleton attention and genepool catalogs (#49)

codegen/README.md

@@ -91,6 +91,32 @@ constant-time indexed lookup. Golden fixtures cover all catalog counts,
 representative complete records, public getters/setters, appearance decoding,
 and every generated relationship category.
 
+## Skeleton, attentions, and genepool
+
+The skeleton generator validates the pinned hierarchy root, declared counts,
+finite three-component transforms, unique joint names and aliases, collision
+volumes, support categories, and child element schema. Its checked-in
+[`skeleton_catalog.rs`](../crates/libremetaverse/src/skeleton_catalog.rs) output
+constructs all 133 joints and 26 collision volumes in source hierarchy order.
+The native skeleton records also implement depth-first enumeration, canonical
+and alias lookup, expanded mesh-joint lists, the built-in loader, and validated
+custom XML loading without a serializer or managed runtime.
+
+The attention generator validates both pinned attention inputs independently,
+requiring masculine and feminine sets with each of the nine named parameters
+exactly once. The generated
+[`attention_catalog.rs`](../crates/libremetaverse/src/attention_catalog.rs)
+keeps the eleven `LookAtType` slots in enum-discriminant order, including the
+observable zero-initialized `None` and `Clear` entries.
+
+The genepool generator validates unique archetype names and parameter IDs,
+finite values, and each ignored-but-schema-relevant texture UUID and slot. The
+generated [`genepool_catalog.rs`](../crates/libremetaverse/src/genepool_catalog.rs)
+preserves source archetype and parameter order for all 24 archetypes and 3,360
+parameter values; exact-name lookup returns the original source index. Separate
+generated headers retain the input hashes and BSD-3-Clause provenance for the
+skeleton, both attention files, and genepool asset.
+
 ## Commands
 
 Regenerate every currently registered Rust output using only checked-in data: