diff --git a/docs/decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md b/docs/decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md
index f11ba0d..184c882 100644
--- a/docs/decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md
+++ b/docs/decomposition/modules/E3_M1_ResourceNodeAndGatherLoop.md
@@ -54,8 +54,8 @@ World resource nodes, gather interactions, and yield outputs feeding inventory (
 
 | Contract | Illustrative fields |
 |----------|---------------------|
-| `ResourceNodeDef` | `nodeDefId`; `gatherLens` (`consumer_salvage`, `subsurface`, `bio`, `urban_bulk`); `maxGathers`; `yieldTableId` or embedded yields |
-| `ResourceYieldTable` | `nodeDefId`; `grants[]` with `itemId`, `quantity` |
+| `ResourceNodeDef` | `nodeDefId`; `displayName`; `gatherLens` (`consumer_salvage`, `subsurface`, `bio`, `urban_bulk`); `maxGathers` — see `content/resource-nodes/*_resource_nodes.json` |
+| `ResourceYieldTable` | `nodeDefId`; `itemId`; `quantity` — prototype: one row per node in `*_resource_yields.json` |
 | `GatherResult` | `success`; `reasonCode`; `grantsApplied[]`; `remainingGathers`; optional `xpGrantSummary` |
 
 ## Module dependencies