# agent-prompt-kit

Переносимый системный промпт, который делает агента специалистом в той теме, что стоит перед ним,
— и, когда тот же класс работы повторяется, оставляет после себя рабочее окружение, из которого
следующая сессия стартует вместо нуля.

Четырнадцать модулей, десять инвариантов, ворота из двенадцати проверок, которые сообщаются одной
строкой. Имён инструментов внутри нет: каждая возможность определяется самим рантаймом (M6), поэтому
один и тот же текст работает в AutoClaw2, HARNESS, SagaAI и в любом агенте, который умеет читать
файлы и выполнять команды.

## Проблема, ради которой это существует

Хорошо сделанная один раз работа обычно оплачивается дважды. Следующее окно не знает, что
пробовали, какие имена колонок оказались настоящими, какая команда доказала результат, — поэтому
аналогичная задача стоит того же времени, тех же токенов и тех же ошибок, что и первая.

Ответ здесь не «стараться запомнить лучше». Ответ — артефакт: каталог с правилами, карточка домена,
критерий приёмки, разобранные примеры и хранилище прошлых работ, зарегистрированный в рантайме так,
чтобы следующая сессия действительно его видела. Механика и границы — на странице
[Зачем](00-Why.ru.md).

## С чего начать

| # | Страница | Что вы получите |
|---:|---|---|
| 1 | [Зачем](00-Why.ru.md) | почему второй прогон стоит как первый и что делает его дешевле |
| 2 | [Использование](01-Usage.ru.md) | как загрузить промпт, что прогнать для проверки, как выглядит готовый ответ |
| 3 | [Карта модулей](02-Modules.ru.md) | четырнадцать модулей, инварианты, таблица возможностей |
| 4 | [Установка](03-Install.ru.md) | AutoClaw2, HARNESS, SagaAI: что делает модель, что обязан сделать человек |
| 5 | [Окружение](04-Environment.ru.md) | как превратить завершённую сессию в зарегистрированный workspace |
| 6 | [Хранилище опыта](05-Experience.ru.md) | хранилище, одна команда поиска и что оно отклоняет |
| 7 | [Проверки](06-Checklists.ru.md) | ворота, девятнадцать режимов отказа, ловушки |

## Два выхода

| Выход | Когда | Где живёт |
|---|---|---|
| ответ | любая задача | в текущем диалоге |
| окружение специалиста | работа сделана и повторится | каталог, который рантайм регистрирует, названный путём |

## Проверить за две команды

```bash
git clone https://github.com/paulmann/agent-prompt-kit.git
cd agent-prompt-kit
python tools/prompt_lint.py          # PASS: 0 error(s), 0 warning(s)
python tools/experience.py selftest  # 13/13 experience checks passed
```

Обе возвращают `0` на свежем клоне: первая проверяет документ, вторая — что хранилище действительно
отклоняет то, что обещает отклонять. Что именно линтер считает ошибкой, перечислено в
[QA.md](https://github.com/paulmann/agent-prompt-kit/blob/main/docs/QA.md).

## Чем это не является

- **Не продукт памяти.** В хранилище лежат написанные вами Markdown-записи, а не эмбеддинги ваших
  диалогов.
- **Не промпт под одну предметную область.** Домен никогда не попадает в тело промпта: он живёт в
  карточке домена (M2) и в окружении (M10). Тело промпта не меняется, когда вы добавляете
  специальность.
- **Не гарантия.** Ворота прогоняет агент, а читает человек. Строка ворот, которые никто не
  прогонял, — первый режим отказа, который называет сам набор (M9).
- **Не установлено, пока рантайм об этом не знает.** Файлы на диске — ещё не окружение
  (M10, шаг 4).

## Ссылки

- [Репозиторий](https://github.com/paulmann/agent-prompt-kit)
- [Промпт](https://github.com/paulmann/agent-prompt-kit/blob/main/PROMPT.ru.md)
- [Три разобранных примера](https://github.com/paulmann/agent-prompt-kit/blob/main/examples/EXAMPLES.ru.md)
- [История изменений](https://github.com/paulmann/agent-prompt-kit/blob/main/CHANGELOG.ru.md)
- English version: [Home](Home.md)

> [!TIP]
> Ответ без строки ворот не проходил ворот. Считайте его незавершённым, а не вопросом оформления, —
> и назовите пропущенный модуль (M8), вместо того чтобы переспрашивать всю задачу.