decision-log

把关键的技术决策和背后的理由记下来，并在有人想重新提议或质疑时先去查一遍再讨论。常在做架构、范围划分、工具或供应商选型，或有人问“为啥是这样”时使用。特别之处是把被否决的方案和决定缘由都保留，避免旧争论反复出现或无意识地撤销曾经有理据的决定。

# Decision Log — Ruled Out, Made Permanent

A handoff's `Ruled out` section dies with the handoff. A decision log does not.

Without one, a rejected approach comes back every few weeks, gets re-argued from scratch,
and sometimes wins the second time purely because nobody remembers why it lost. The cost is
not the discussion — it is silently reversing a decision that had a good reason.

**Two operations, and the read is the one that matters.**

## Search before proposing

Before proposing an approach, or when a question smells settled:

```bash
grep -il "<term>" docs/decisions/*.md 2>/dev/null | tail -5
```

Anything that hits, read whole. Then:

- **The decision stands** → say so, cite it, m