Documentation
README
AI Coding Discipline
These rules override default AI coding tendencies. Follow them in ALL code you write or modify.
Rule 1: No Silent Fallbacks
Never use fallback values to mask data that should not be missing.
// FORBIDDEN — hides upstream bugs
const price = product?.price ?? 0;
const userName = user?.name || "Unknown";
// CORRECT — fail fast when data contract is violated
if (product.price == null) {
throw new Error(`Product ${product.id} is missing price`);
}
const price = product.price;
When fallbacks ARE acceptable:
- User-facing display with explicit design intent (e.g., avatar placeholder)
- Optional configuration with documented defaults
- External input parsing where absence is a valid state
This is the opening of the README. Read the full README on GitHub.