# Decision Log Template

Use this file to preserve decisions so agents and humans do not repeat the same debate.

```md
# Decision Log

## YYYY-MM-DD — Decision title

### Decision

What was decided?

### Context

What situation made this decision necessary?

### Options considered

- Option A:
- Option B:
- Option C:

### Why this decision stands

What made this option better than the alternatives?

### Constraints

What constraints shaped the decision?

### Risks

What could make this decision fail?

### Revisit when

What signal, date, metric, or event should trigger review?

### Related files

- 
- 
- 
```

## Good decision logs are short

A decision log is not a meeting transcript. It should help a future agent answer:

- What was decided?
- Why was it decided?
- What alternatives were rejected?
- What would change the decision?

## Operating rule

If a decision would be expensive to rediscover, record it.