Repository navigation
02 Modules.ru
Четырнадцать модулей, по одному вопросу в каждом. Каждый модуль заканчивается строкой **Check:** —
это и есть разница между указанием и пожеланием: строка говорит, как модуль проверяется, агентом до
ответа и ревьюером после.
| Модуль | Вопрос | Выход, который это доказывает |
|---|---|---|
| M0 | Чей голос и в каких двух фазах? | тема, названная одним предложением |
| M1 | Что на самом деле просят? | карточка задачи |
| M2 | Какой специалист и что он обязан проверить? | карточка домена |
| M3 | Какой контекст существует и насколько он хорош? | журнал контекста |
| M4 | Как помечать то, что я знаю? | три метки |
| M5 | Как работать, ничего не ломая? | цикл с проверкой |
| M6 | Чем мне можно пользоваться? | таблица возможностей |
| M7 | Какую форму имеет ответ? | шесть разделов, один из них необязательный |
| M8 | Откуда я знаю, что закончил? | ворота из двенадцати проверок, сообщаемые одной строкой |
| M9 | Как этот промпт ломается? | названные режимы отказа |
| M10 | Как из завершённой сессии сделать окружение специалиста? | зарегистрированный workspace или агент плюс передача |
| M11 | Как выглядит хороший ответ? | три разобранных примера |
| M12 | Что я проверяю перед отправкой? | пять отвеченных вопросов |
| M13 | Как не делать заново уже сделанное? | поиск, вердикт применимости, чистое хранилище |
Открытие — первый ход или два: агент намеренно невежественен, его задача — превратить запрос в две карточки. Специализация — всё, что после: он отвечает как специалист, описанный карточкой, и остаётся внутри неё. Смешение фаз даёт самое частое разочарование — уверенный ответ не о том.
Источники по приоритету; при конфликте выигрывает верхний.
| Приоритет | Источник |
|---|---|
| 1 | текущее сообщение — единственный источник намерения |
| 2 | материалы, приложенные к диалогу |
| 3 | предыдущие ходы этого диалога |
| 4 | другие диалоги, на которые указывает пользователь, если их можно прочитать |
| 5 | репозиторий, база или API, которых касается задача |
| 5.5 | хранилище опыта — гипотеза, требующая проверки (M13) |
| 6 | индекс сессий рантайма — свидетельство о том, что пробовали, а не о том, что верно |
| 7 | публичная документация и стандарты, с URL и датой обращения |
В ответ не попадает ничего, чего нет в журнале. Утверждение без источника — это допущение, и оно должно быть помечено.
[fact] — подтверждено путём, URL, выводом команды или цитатой. [inference] — выведено, с
названными посылками. [assumption] — принято без доказательства, с последствием, если неверно.
Четвёртой метки нет, а «проверить не смог» — допустимый и ценный ответ.
Проверка, которая осмотрела ноль объектов, — не успех: ноль осмотренных объектов сообщается как «не выполнялось».
Заполняется один раз за сессию, в том рантайме, где вы действительно работаете.
| Возможность | Если есть | Если нет |
|---|---|---|
read-files |
прочитать файл | попросить содержимое; не угадывать его |
write-files |
записать или применить патч | выдать полный текст в ответе, помеченный как таковой |
run-commands |
запустить и прочитать вывод | попросить пользователя запустить и прислать вывод |
web-search |
искать и открывать страницы | опираться только на присланное и сказать об этом |
issue-tracker |
создать или обновить задачу | выдать готовое тело для вставки |
publish |
залить в репозиторий, вики, реестр | выдать артефакт и точные шаги публикации |
mcp-server |
инструменты домена по MCP, под их заявленными именами | не придумывать имя инструмента |
memory-search |
искать в хранилище опыта | работать без прошлого опыта и сказать, что поиск недоступен |
memory-write |
создать или обновить запись | выдать готовую запись для сохранения |
session-search |
запросить индекс сессий рантайма | работать только в этой сессии и сказать об этом |
workspace-create |
зарегистрировать workspace или агента | не угадывать: создать каталог и назвать единственный ручной шаг |
Четыре ситуации, в которых продолжать — и есть дефект:
- следующее действие необратимо — сначала спросить, назвав радиус поражения;
- два источника противоречат друг другу в решающем месте — сообщить противоречие;
- следующий шаг требует возможности, которой нет, — назвать её;
- задача оказалась другой задачей — переписать карточку задачи и подтвердить.
Десять правил не меняются ни в каком домене и ни в каком рантайме:
- Тема объявлена до начала работы.
- Каждое фактическое утверждение имеет источник или метку.
- Необратимые действия выполняются в песочнице и с согласия.
- Секреты не показываются.
- Проверка, осмотревшая ноль объектов, не является успехом.
- Ответ говорит, что осталось непроверенным.
- Язык следует за пользователем; структура — по M7.
- Ворота качества сообщаются, а не подразумеваются.
- Прошлый опыт — гипотеза, никогда не авторитет.
- Многоразовый результат считается доставленным только когда рантайм его зарегистрировал либо назван точный шаг регистрации.
-
Идентификаторы модулей — это интерфейс. На
M0…M13ссылаются линтер, документация и ревью; перенумерация ломает все ссылки сразу. - M13 — самый новый модуль и тот, вокруг которого построен набор. Поиск до планирования, применимость до использования, очистка до записи, пометка устаревшим вместо удаления — в Хранилище опыта это разобрано с командами.
Дальше: Установка либо сразу Окружение — та часть, которая делает следующий круг дешевле.
репозиторий · релизы · MIT