База знаний
Общее хранилище знаний человека и ИИ: правила работы, факты о проекте и ловушки окружения. Доходит до модели на всех этапах.
База знаний — это то, что ваша организация знает о себе и о своих проектах, в одном месте и в одинаковом виде для людей и для модели. Правила работы («обязательно YAGNI», «отвечаем по-русски»), факты о проекте, которые не вычитать из кода, и ловушки окружения, на которые уже наступали.
Модель видит эти записи на всех этапах работы: при формулировке задачи, при декомпозиции, при разработке и ревью, в аудите, в «Спросить» и в глубоком исследовании. Она же их и пополняет — по итогам законченной работы.
Зачем это нужно
Модель не помнит вчерашний день. Каждая задача начинается с нуля: она заново читает код, заново выясняет, что тесты не идут без поднятого окружения, и заново предлагает подход, от которого вы отказались месяц назад. База знаний — это то, что переживает конец задачи.
Три вещи, ради которых она существует:
- Ваши правила соблюдаются без напоминаний. Записанное правило доходит до каждого прогона — не нужно повторять его в постановке каждой задачи.
- Ошибки не повторяются. То, что вы поправили один раз — отклонили формулировку, вернули на доработку, объяснили в уточнении, — становится записью и работает дальше само.
- Знание не уходит с людьми. Причина решения, ловушка окружения, особенность легаси-модуля живут в организации, а не в голове того, кто это выяснил.
Чем это НЕ является
- Не документация репозитория. Структуру кода, пути и конвенции модель читает из самого кода — и читает актуальные, а не снимок полугодовой давности. В базу знаний идёт то, чего в коде нет.
- Не постановка задачи. Постановка — про одну конкретную работу. База знаний — про то, что верно для всех работ в этом проекте или организации.
- Не хранилище секретов. Записи уходят в промпт модели; токенам, паролям и ключам здесь не место — для них есть учётные данные репозиториев.
Как устроено
| Что | Где читать |
|---|---|
| Из чего состоит запись и как написать хорошую | Запись |
| Три типа записей и что куда класть | Типы |
| Знание всей организации или одного проекта | Области |
| Как знание доходит до модели и во что обходится | Как это доходит до модели |
| Что пишет ИИ и как это отличить | Записи ИИ |
| Проходы по итогам работы | Проходы |
| Удаления нет — есть архив | Архив |
| Кто что видит и меняет | Права |
| Готовые рецепты и типичные ошибки | Рецепты |
Где найти
Раздел «База знаний» в левом меню. Он относится к организации, а не к проекту: правила для всех проектов можно завести до того, как появится первый проект разработки.