diff --git a/internal/normalizers/doc.go b/internal/normalizers/doc.go
index a8bb850..0548d6d 100644
--- a/internal/normalizers/doc.go
+++ b/internal/normalizers/doc.go
@@ -68,7 +68,7 @@
 //
 //	weather.<kind>.vN
 //
-// weatherfeeder centralizes schema strings in internal/standards/schemas.go.
+// weatherfeeder centralizes schema strings in internal/standards/schema.go.
 // Always use those constants (do not inline schema strings).
 //
 // Example mappings:
diff --git a/internal/standards/doc.go b/internal/standards/doc.go
index e3c6a8c..c323f61 100644
--- a/internal/standards/doc.go
+++ b/internal/standards/doc.go
@@ -1,8 +1,14 @@
-// Package standards contains shared canonical vocabularies and lookup tables
-// used across multiple providers.
+// File: internal/standards/doc.go
 //
-// The guiding principle is:
-// - Canonical types live in internal/model (provider-independent).
-// - Shared reference tables and helpers live here.
-// - Provider-specific mapping logic lives in internal/sources/<provider>.
+// Package standards defines weatherfeeder’s provider-agnostic “project law”:
+//
+//   - Schema identifiers and versioning conventions (see schema.go).
+//   - Canonical interpretations / cross-provider mappings that are not specific to a
+//     single upstream API (e.g., shared code tables, text heuristics, unit policy).
+//
+// Standards are used by both sources and normalizers. Keep this package free of
+// provider-specific logic and free of dependencies on internal/sources/* or
+// internal/normalizers/* to avoid import cycles.
+//
+// Provider-specific decoding and mapping lives in internal/normalizers/<provider>.
 package standards