TimeLayer
Работа с агентами: Квитанции + Мозг
Это метод работы, а не продукт. Так строится весь этот проект — и это применимо к любой агентной или мультиагентной системе. Два правила снимают две главные болезни агентов: выдумывание «готово» без проверки и потерю контекста между шагами.
Содержание
1. Почему это работает
Наблюдение, проверено на практике многократно:
- Один проход вместо многих. Хорошо поставленная задача проходит как один аудит → один ремонт, без циклов «переделай». Агент не возвращается, потому что каждый шаг закрыт доказательством, а не обещанием.
- Спека через мозг — кратно быстрее и дешевле. Сначала загони спецификацию и план в мозг (внешнее состояние), потом работай из него — и задача делается в разы быстрее и с заметно меньшим расходом токенов: агент не перечитывает всё заново и не держит контекст в одном раздутом окне, а подхватывает актуальное состояние и продолжает с места.
- Качество выше. Проверка по коду и квитанции, а не по словам, убирает тихие ошибки и регрессии до того, как они накопятся.
Одной строкой
Думай мозгом (внешним состоянием), закрывай квитанцией (доказательством), проверяй по коду (не по словам).
2. Два столпа
Квитанция — ни один пункт не считается сделанным без доказательства. Доказательство — это не слова «я починил», а проверяемый факт: хэш коммита, результат теста (red → green), вывод команды, внешняя проверка. Нет квитанции → пункт открыт.
Мозг — планы, журнал действий и решения живут не в памяти одного прохода, а в постоянном хранилище (репозиторий-волт). Между сессиями состояние не теряется, поэтому не нужно держать всё в голове и не возникает путаницы. Отсюда и выигрыш в скорости и токенах: в начале сессии агент читает мозг и продолжает, а не начинает заново.
3. Тикет и квитанция
Каждая единица работы — тикет со статусом и обязательной квитанцией при
закрытии: корень (что не так, точный файл:строка), действие,
критерий приёмки (какая проверка это докажет), квитанция (доказательство).
Что считается квитанцией по типам работы:
| Тип работы | Валидная квитанция |
|---|---|
| Правка кода | хэш коммита + тест red→green + N passed; 0 failed |
| Деплой | sha256 бинаря до и после + подтверждение на всех хостах |
| Инфра/конфиг | вывод команды до и после (напр. коннект снаружи → отказ) |
| Проверка работы | подтверждение по коду/бинарю (grep, сверка sha), не по отчёту |
| Ложная тревога | доказательство, почему находка неверна, затем откат |
Квитанция должна быть воспроизводимой другим. Если её нельзя перепроверить — это не квитанция. И проверяешь по коду, а не по отчёту: отчёт может врать или отставать; неизменный sha бинаря = слой не трогали, что бы ни говорил отчёт.
4. Цикл одного прохода
1. Прочитать мозг: актуальный план + журнал (где остановились). 2. Взять следующий open-тикет по приоритету (критичное → высокое → среднее → низкое). 3. Найти корень в коде (файл:строка), не по памяти. 4. Сделать правку. Написать тест на исходный отказ (red → green). 5. Собрать / прогнать тесты. Получить доказательство. 6. Закрыть тикет с квитанцией. Записать в журнал. 7. Если деплой — сверить sha на всех хостах. 8. Следующий тикет. Ничего не пропускать молча: пропуск — отдельная запись.
5. Железные правила
- Нет квитанции — нет «сделано». Слова не закрывают тикет.
- Проверяй по коду и бинарю, а не по отчёту. Отчёт — гипотеза, код — факт.
- Тест на исходный отказ обязателен для нетривиальной правки (red → green).
- Деньги/безопасность: по умолчанию fail-closed. При сомнении — стоп и вопрос, а не «примерно чини».
- Тишина запрещена. Любой пропуск, ограничение или отложенное — явная запись в мозг.
- Ничего необратимого без подтверждения — сначала докажи безопасность, потом делай, в окне.
6. Полный метод
Эта страница — короткая версия. Полный метод — формат тикета, таблица квитанций, дисциплина
GitHub и мозга, приоритизация — лежит как AGENTS.md в каждом репозитории TimeLayer,
на английском и русском, чтобы любой агент мог подхватить: