Buff Development
База знаний

База знаний

Общее хранилище знаний человека и ИИ: правила работы, факты о проекте и ловушки окружения. Доходит до модели на всех этапах.

База знаний — это то, что ваша организация знает о себе и о своих проектах, в одном месте и в одинаковом виде для людей и для модели. Правила работы («обязательно YAGNI», «отвечаем по-русски»), факты о проекте, которые не вычитать из кода, и ловушки окружения, на которые уже наступали.

Модель видит эти записи на всех этапах работы: при формулировке задачи, при декомпозиции, при разработке и ревью, в аудите, в «Спросить» и в глубоком исследовании. Она же их и пополняет — по итогам законченной работы.

База знаний: что уходит в промпт каждого прогона, активные записи и архив.

Зачем это нужно

Модель не помнит вчерашний день. Каждая задача начинается с нуля: она заново читает код, заново выясняет, что тесты не идут без поднятого окружения, и заново предлагает подход, от которого вы отказались месяц назад. База знаний — это то, что переживает конец задачи.

Три вещи, ради которых она существует:

  1. Ваши правила соблюдаются без напоминаний. Записанное правило доходит до каждого прогона — не нужно повторять его в постановке каждой задачи.
  2. Ошибки не повторяются. То, что вы поправили один раз — отклонили формулировку, вернули на доработку, объяснили в уточнении, — становится записью и работает дальше само.
  3. Знание не уходит с людьми. Причина решения, ловушка окружения, особенность легаси-модуля живут в организации, а не в голове того, кто это выяснил.

Чем это НЕ является

  • Не документация репозитория. Структуру кода, пути и конвенции модель читает из самого кода — и читает актуальные, а не снимок полугодовой давности. В базу знаний идёт то, чего в коде нет.
  • Не постановка задачи. Постановка — про одну конкретную работу. База знаний — про то, что верно для всех работ в этом проекте или организации.
  • Не хранилище секретов. Записи уходят в промпт модели; токенам, паролям и ключам здесь не место — для них есть учётные данные репозиториев.

Как устроено

ЧтоГде читать
Из чего состоит запись и как написать хорошуюЗапись
Три типа записей и что куда кластьТипы
Знание всей организации или одного проектаОбласти
Как знание доходит до модели и во что обходитсяКак это доходит до модели
Что пишет ИИ и как это отличитьЗаписи ИИ
Проходы по итогам работыПроходы
Удаления нет — есть архивАрхив
Кто что видит и меняетПрава
Готовые рецепты и типичные ошибкиРецепты

Где найти

Раздел «База знаний» в левом меню. Он относится к организации, а не к проекту: правила для всех проектов можно завести до того, как появится первый проект разработки.

On this page