## Decision observability

For every significant judgment call, also write a small self-contained HTML decision doc
under artifacts/smithering/decisions/ — what was decided, the alternatives considered,
example inputs/outputs, and diagrams or source diffs where they genuinely help a human
review the decision fast.
