Go Interfaces and Composition

Resource Routing

• scripts/check-interface-compliance.sh - Run as a heuristic to find exported interfaces that may need compile-time assertions.
• scripts/check-interface-compliance.go - Implementation helper invoked by check-interface-compliance.sh; patch this when changing method-set analysis.
• references/EMBEDDING.md - Read when embedding interfaces or structs in public APIs.
• references/RECEIVER-TYPE.md - Read when pointer/value receivers affect interface satisfaction.

Accept Interfaces, Return Concrete Types

Interfaces belong in the package that consumes values, not the package that implements them. Return concrete (usually pointer or struct) types from constructors so new methods can be added without refactoring.