Document D&D spell normalization behavior

examples/dnd-spells-production.config.yml

@@ -29,9 +29,11 @@ pipelines:
         extract:
           module: dnd/spells
           retries: 2
+          # Overlay behavior binds the same catalog independently at each stage.
           references:
             spell_catalog: ./dnd-spells-catalog.json
         normalize:
           module: dnd/spells
+          # Normalize-stage references are local and must be bound explicitly.
           references:
             spell_catalog: ./dnd-spells-catalog.json

examples/dnd-spells.config.yml

@@ -15,4 +15,5 @@ pipelines:
     artifacts:
       spells:
         extract: dnd/spells
+        # Base-only behavior: normalization uses the embedded SRD catalog.
         normalize: dnd/spells