3.7 KiB
Контекст знаний о системе
Цель навигации — дать читателю знания, необходимые для конкретного вопроса, без предварительного чтения всей документации. Самостоятельное объяснение связывает понятия, сценарии и ограничения, а не воспроизводит устройство кода.
Routing context
Тематический индекс направляет к нужному предмету: аутентификация связана с безопасностью и сессиями, денежный показатель — с его происхождением и валютой, ошибка интерфейса — с восстановлением данных. Вопрос о внешнем виде не требует автоматически изучать хранение данных. При обнаружении новой существенной границы расширяется и нужный контекст.
Источники и конфликты
Публичный HTTP-контракт описывается OpenAPI backend; документация объясняет систему, ADR сохраняют причины решений, исследования предлагают варианты. Существующее поведение не отменяет согласованное требование, а рекомендация из исследования не становится принятым решением автоматически.
При расхождении возможны устаревшее объяснение, дефект реализации или незавершённое изменение. Неустановленный смысл, особенно в безопасности, данных и публичном контракте, явно отмечается для ручного решения. Карта ответственности за знания — ведение документации.
Recovery и handoff
Продолжение работы опирается на ожидаемый результат, выполненные изменения, оставшиеся вопросы, результаты проверок и ограничения. Дублирование требований в нескольких независимых пересказах создаёт риск расхождения. Исторические проверки сохраняют своё значение только для того состояния системы, в котором они выполнялись; секреты не являются допустимым содержимым свидетельств.
Проверка эффективности
Проверочные вопросы показывают, можно ли получить правильную модель системы и отличить близкие понятия. Качество оценивается по верности ответа, найденным ограничениям и необходимости дополнительных уточнений. Число документов, их краткость или успешная проверка Markdown сами по себе не доказывают полезность знания. Сравнение результатов требует одинаковых вопросов и сопоставимых условий.