На Hacker News появилась ссылка на gist с описанием «two-document pattern» — промпт-конвенции, предназначенной для предотвращения потери контекста у AI-агентов, работающих с кодом. Автор предлагает вести два файла: неизменяемый append-only лог для размышлений и опровержений, и редактируемый индекс с текущими правилами. На момент публикации пост набрал 2 points при нуле комментариев.
Суть подхода
Основная идея — заставить агента вести «дизайн-лог» в формате: пронумерованные датированные секции, которые никогда не редактируются, а новые секции могут ссылаться на старые и отменять их. Каждая секция обязана заканчиваться списком того, что не было сделано. Это делает отказ от неверной идеи дешёвым: вместо переписывания всего файла достаточно добавить одну новую секцию, что, по мнению автора, повышает частоту признания ошибок. Второй файл (CLAUDE.md) — редактируемый in-place индекс, хранящий актуальные правила и инструкции.
Обсуждение на Hacker News
Пока пост не вызвал дискуссии — 0 комментариев. Points (2) указывают на то, что ссылка была замечена, но активного обсуждения не возникло. Возможно, это связано с тем, что предложение лежит скорее в области «промпт-инжиниринга» и не касается фундаментальных архитектурных изменений. Тем не менее, сама идея снижения «стоимости признания ошибки» через append-only механизм может быть полезна для длительных сессий с агентами.
Что стоит проверить
Подтверждённых данных о практической эффективности пока нет. Автор приводит только описание подхода и мотивацию. Нет ни бенчмарков, ни примеров длительного использования. Стоит проверить, насколько этот паттерн совместим с различными моделями (GPT-4, Claude, локальные LLM) и как он ведёт себя на реальных проектах с сотнями шагов. Также неясно, как агент обрабатывает конфликт между append-only логом и редактируемым индексом — не возникает ли путаница.
| Punkt | Detail |
|---|---|
| Тип решения | Промпт-конвенция для AI-агентов |
| Зависимости | Нулевые |
| Ключевая идея | Append-only лог + редактируемый индекс |
| Активность на HN | 2 points, 0 комментариев |
| Статус проверки | Не подтверждена практикой |
Источник: оригинальный gist — https://gist.github.com/sourdecor/78b2ff9016f3f597934150a3501427ff. Для верификации и дополнительного контекста рекомендуется изучить обсуждения на GitHub Blog — https://github.blog/.