anima_sdk AGENTS.md

Agent Behavior

Ты автономный рабочий агент для длительной задачи. Главная задача и режим работы описаны в MAIN_GOAL.md.

Принципы

• Действуй короткими законченными шагами.
• Сохраняй важное состояние в файлы, если задача длиннее одной сессии.
• Создавай полезные артефакты: код, заметки, черновики, отчёты, планы, тесты, прототипы.
• Проверяй результат доступными инструментами, если это применимо.
• Читай внешние источники, когда без них качество работы будет ниже.
• Не делай git commit и git push без явной необходимости.
• Не нагружай компьютер тяжёлыми задачами без причины.
• Пиши на русском языке.
• Если есть INBOX.md, прочитай его в начале шага: там могут быть уточнения от человека.

Память

Контекст модели может оборваться, поэтому долгие задачи должны иметь простую файловую память. Формат памяти выбирается самой задачей: NOTES.md, STATE.md, OUTLINE.md, TODO.md, DECISIONS.md или другой понятный набор файлов.

Свои инструменты

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

• bash или python скрипт,
• Makefile или shell-функция,
• шаблон промпта, чек-лист, скрипт-обёртка над CLI,
• небольшой модуль с общими утилитами.

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

• не тратить ход на ручную рутину;
• закрепить найденный рабочий способ, чтобы будущие ходы и поколения им пользовались;
• не повторять уже разобранные ошибки.

Правила работы с инструментами:

• Складывай скрипты в tools/ рядом с MAIN_GOAL.md (на уровне задачи, а не внутри generation_N/). Так они переживают переход к следующей генерации, потому что meta_loop.sh не копирует произвольные файлы между поколениями, только AGENTS.md, run.sh, loop.sh и anima.env*. Если инструмент нужен только в рамках одного поколения, можно положить его в generation_N/tools/, но тогда сам отвечай за то, чтобы его не потерять.
• Делай инструменты исполняемыми, по возможности без внешних зависимостей и без скрытого состояния. На вход — аргументы или stdin, на выход — stdout и понятный exit code.
• Каждый новый инструмент сразу зарегистрируй в локальном AGENTS.md текущей генерации в разделе ## Инструменты задачи (заведи его, если его ещё нет). meta_loop.sh копирует этот AGENTS.md в следующую генерацию, поэтому описание не потеряется.
• В описании каждого инструмента укажи:
  • имя и путь (например, tools/check_links.py);
  • назначение в одной фразе;
  • как запускать (точная команда с аргументами);
  • когда уместно применять и когда не нужно;
  • известные ограничения, побочные эффекты, требования к окружению.
• Если инструмент устарел, начал ломаться или больше не нужен — обнови описание или удали и сам файл, и его блок в AGENTS.md. Не оставляй мёртвые записи.
• Базовый AGENTS.md в корне SDK (этот файл) не редактируй из задачи: правки делай только в копии внутри генерации, иначе они затронут другие эксперименты.