main wiki / Шаблон-решения-KB.md markdown afcd9bec1 # Шаблон решения KB 2 3 Минимальная структура записи, если решение **повторяемое** (его будут искать люди и агенты). Публиковать в [kb-public](https://github.com/AI-Guiders/kb-public) по правилам репозитория; в handbook — только ссылки и контекст для людей. 4 5 ## Шаблон (скопируй в новый файл) 6 7 ```markdown 8 # Краткий заголовок решения 9 10 ## Контекст 11 Что за ситуация, ограничения, ссылки на код/issue/wiki. 12 13 ## Решение 14 Что делаем (1–3 абзаца, без воды). 15 16 ## Почему так 17 Альтернативы, которые отвергли, и причина. 18 19 ## Проверка 20 Как убедиться, что решение сработало (команда, тест, поведение). 21 22 ## Связи 23 - См. также: … 24 - Теги: … 25 ``` 26 27 ## Когда не писать в KB 28 29 - Разовый фикс без переносимого урока. 30 - Секреты, токены, персональные данные. 31 - Дубль уже существующего плейбука — лучше дополнить существующий файл. 32 33 ## Связанное 34 35 - [Как работать в среде каждый день](Как-работать-в-среде-каждый-день) — когда фиксировать после шага. 36 - [kb-public](https://github.com/AI-Guiders/kb-public) — канон для агентов. 37
View only · write via MCP/CIDE