diff --git a/internal/shared/config.go b/internal/shared/config.go
index 234e4fa..1730d8c 100644
--- a/internal/shared/config.go
+++ b/internal/shared/config.go
@@ -246,6 +246,13 @@ type LogConfig struct {
 // the corpus-downgrade rule: it's already weak, no need to downgrade
 // further. Strong (paid / cloud / frontier) models trigger the gate.
 type ModelsConfig struct {
+	// ⚠ UNWIRED scaffolding — these tier fields parse from TOML and
+	// Resolve() reads them, but as of 2026-05-03 NO OTHER CODE calls
+	// Resolve(). Setting these in lakehouse.toml has no runtime effect
+	// on routing. Customer hot path uses local Ollama via direct model
+	// name per PRD line 70 (everything runs locally). If you wire up
+	// Resolve() consumers, document them here so the next person knows
+	// the field is live, not dead scaffolding.
 	LocalFast      string `toml:"local_fast"`
 	LocalEmbed     string `toml:"local_embed"`
 	LocalJudge     string `toml:"local_judge"`
@@ -260,6 +267,9 @@ type ModelsConfig struct {
 	FrontierStrong string `toml:"frontier_strong"`
 	FrontierFree   string `toml:"frontier_free"`
 
+	// WeakModels IS live — internal/workflow/modes.go reads it at
+	// startup, internal/matrix/downgrade.go uses the list for the
+	// strong-model auto-downgrade gate. Don't lump with unwired fields.
 	WeakModels []string `toml:"weak_models"`
 }