# База знаний

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

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

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

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

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

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

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

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

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

- **Не документация репозитория.** Структуру кода, пути и конвенции модель читает из самого кода — и читает актуальные, а не снимок полугодовой давности. В базу знаний идёт то, чего в коде нет.
- **Не постановка задачи.** Постановка — про одну конкретную работу. База знаний — про то, что верно для всех работ в этом проекте или организации.
- **Не хранилище секретов.** Записи уходят в промпт модели; токенам, паролям и ключам здесь не место — для них есть [учётные данные репозиториев](/docs/repositories).

## Как устроено

| Что | Где читать |
| --- | --- |
| Из чего состоит запись и как написать хорошую | [Запись](/docs/knowledge/entry) |
| Три типа записей и что куда класть | [Типы](/docs/knowledge/types) |
| Знание всей организации или одного проекта | [Области](/docs/knowledge/scopes) |
| Как знание доходит до модели и во что обходится | [Как это доходит до модели](/docs/knowledge/prompt) |
| Что пишет ИИ и как это отличить | [Записи ИИ](/docs/knowledge/ai-entries) |
| Проходы по итогам работы | [Проходы](/docs/knowledge/passes) |
| Удаления нет — есть архив | [Архив](/docs/knowledge/archive) |
| Кто что видит и меняет | [Права](/docs/knowledge/permissions) |
| Готовые рецепты и типичные ошибки | [Рецепты](/docs/knowledge/recipes) |

## Где найти

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