The Key Conventions section in CLAUDE.md/AGENTS.md has two issues, found while cross-checking against the Handbook (control-toolbox/Handbook).
-
Incorrect import rule. It said import Pkg: Pkg, never bare using. The Handbook (philosophy/modules.md) mandates the opposite: import is never used anywhere in the ecosystem; only using is used, always qualified (using Pkg: Pkg, never bare using Pkg).
-
Missing conventions. Three Handbook tenets weren't reflected in the Key Conventions list: structured errors (seven typed exceptions), enforced type stability (@inferred/JET), and the "1-D is a scalar" convention.
See linked PR for the fix.
The Key Conventions section in CLAUDE.md/AGENTS.md has two issues, found while cross-checking against the Handbook (control-toolbox/Handbook).
Incorrect import rule. It said
import Pkg: Pkg, never bareusing. The Handbook (philosophy/modules.md) mandates the opposite:importis never used anywhere in the ecosystem; onlyusingis used, always qualified (using Pkg: Pkg, never bareusing Pkg).Missing conventions. Three Handbook tenets weren't reflected in the Key Conventions list: structured errors (seven typed exceptions), enforced type stability (
@inferred/JET), and the "1-D is a scalar" convention.See linked PR for the fix.