# Explanation

Understanding-oriented user docs, per [Diátaxis](https://diataxis.fr/).
Conceptual material: why a design works the way it does, what concepts
mean, how systems fit together. The reader wants to understand, not to do
or to look something up.

## Index

- [Evals: how the kit's eval harness works](evals.md) — the
  `tests/evals/` suite, the `evalkit` harness, and how to add a
  new eval. See also the spec at
  [`docs/specs/task-20-eval-harness/spec.md`](../../specs/task-20-eval-harness/spec.md).
