Аннотация инструмента описывает его свойства для клиента, но не заменяет серверное ограничение полномочий
Статьи
Обрабатывайте отмену как сигнал прекратить дальнейшую работу там, где это возможно
После таймаута исход операции может быть неизвестен
Различайте пагинацию каталога протокола и пагинацию бизнес-результата вашего инструмента
Выбирайте ресурс для адресуемого содержимого, а инструмент — для вызываемой операции с параметрами и явным результатом
В stdio-режиме оставьте stdout для сообщений протокола, а диагностические логи направьте в stderr
Определите различие между «не менять поле» и «очистить поле»
Подберите данные, которые разделяют возможные ошибки, а не просто напоминают рабочий пример
Остановите редактирование и восстановите проверяемую гипотезу
Сравните точные команды, зависимости и условия запуска
Начните с изменения поведения и границ доверия, затем переходите к структуре и стилю
Делите фичу по законченным проверяемым сценариям и зависимостям
Проверьте установленную версию, экспортируемый интерфейс и минимальный вызов
Разделите изменение схемы, перенос данных и совместимость работающего приложения
Передавайте минимальный обезличенный фрагмент, который сохраняет причинную связь ошибки
Опишите результат через вход, действие и наблюдаемый выход
Проверяйте не только совпадение изображения, но и сценарии взаимодействия
Передавайте текущее состояние, проверенные факты и следующий проверяемый шаг
Разделите рабочие каталоги и согласуйте контракты до параллельного изменения
Запишите наблюдаемый контракт до изменения внутреннего устройства: входы, выходы, ошибки и значимые побочные эффекты
