Достоверность передачи параметров

Между тем, как модель воспринимает мир, и тем, как инструмент действует, не должно быть систематического расхождения.

Антипаттерны:

  • тихое преобразование входа — инструмент незаметно заменяет фигурные кавычки на прямые: модель видит одно, а записывается другое, и бесконечно бьётся с «совпадение не найдено»;
  • тихая инъекция параметров — автоматически добавленный флаг ломает старые версии Git.

Если нормализация необходима — она должна быть явно указана в описании и сообщена в результате.

Связано: Искусство описания инструментов, Механизм Sidecar