type: concept
title: "Критерии качества правила"
status: draft
version: 1.0.0
date: 2026-04-15
knowledge_level: У1
source: architect/concept/design-criteria.md
Любое правило платформы — стандарт, политика, конвенция — должно проходить
этот чеклист перед утверждением. Без проверки правила накапливаются,
конфликтуют и перестают работать.
| # | Критерий | Тест |
|---|---|---|
| 1 | Минимально достаточно | Короче — теряем смысл. Длиннее — лишнее. |
| 2 | Самообъясняет | Убери документ — из структуры/названия всё ещё понятно что делать? |
| 3 | Один путь | Есть ли слово "или" в формулировке? Если да — упрости. |
| 4 | Проверяемо | Назови команду или визуальный признак нарушения. Не можешь — правило не проходит. |
| 5 | Без поддержки | Требует ли обновления реестра, индекса или конфига чтобы работать? |
| 6 | Обратимо | Можно ли отменить действие выполненное по этому правилу? |
| 7 | Масштабируется | Работает одинаково для 1 объекта и для 1000? |
□ 1. Минимально достаточно — нельзя убрать слово без потери смысла
□ 2. Самообъясняет — понятно без документа
□ 3. Один путь — нет "или", нет вариантов
□ 4. Проверяемо — команда: ________________________
□ 5. Без поддержки — не нужен реестр/индекс
□ 6. Обратимо — откат: ____________________________
□ 7. Масштабируется — работает при любом масштабе
Если хотя бы один пункт не пройден → правило нужно переработать.
| Антипаттерн | Какой критерий нарушает |
|---|---|
| "Обычно делай X, но если Y — то Z" | 1 (не минимально), 3 (не один путь) |
| "Смотри документ X для деталей" | 2 (не самообъясняет) |
| "X или Y на ваш выбор" | 3 (не один путь) |
| "Команда проверки сложная и субъективная" | 4 (не проверяемо) |
| "Обновить реестр при каждом изменении" | 5 (требует поддержки) |
| "После удаления восстановить нельзя" | 6 (не обратимо) |
| "Работает только для малых проектов" | 7 (не масштабируется) |