Obedience-Corp/festival

Obedience-Corp

Фреймворк для организации работы AI-агентов через файловую систему и Git: планы, задачи и проверки сохраняются в файлах, а агент выполняет шаги по команде fest next.

Festival — это фреймворк для организации работы AI-агентов, который использует файловую систему и Git для хранения планов, задач и проверок. Он нужен разработчикам и командам, которые работают с агентами в масштабе и хотят контролировать процесс.

Ключевые возможности

  • Планы и задачи хранятся в файлах и Git, а не в контексте сессии
  • Команда fest next показывает агенту следующий шаг
  • Рабочие пространства (camp) с собственными навыками и процессами
  • Переключение между camp командами camp switch или csw
  • Совместимость с Claude Code, Codex, Cursor, OpenCode и другими агентами
  • Встроенные проверки и ревью на этапах выполнения

Для каких задач подходит

  • Организация работы нескольких AI-агентов над крупной целью
  • Сохранение контекста и планов между сессиями агента
  • Настройка повторяемых процессов и проверок для агентов
  • Разделение рабочих пространств под разные проекты или команды

Подробнее

Festival предлагает подход, при котором вся логика работы агента описывается через файлы и Git. Вы создаёте рабочее пространство (camp), где хранятся навыки, планы, скрипты и проекты. Внутри camp вы формулируете цель — фестиваль, — и агент планирует её в рамках заданных процессов. Команда fest next подсказывает агенту следующий шаг, а результаты работы (планы, проверки, коммиты) остаются в файлах после завершения сессии. Это позволяет отслеживать и ревьюить работу агентов, не полагаясь на их внутреннюю память.

В отличие от инструментов, которые управляют агентами через API или специализированные интерфейсы, Festival использует обычные файлы и Git, что делает процесс прозрачным и переносимым. Вы можете создавать несколько camp с разными настройками и переключаться между ними, меняя контекст и подход агента. Festival не привязан к конкретному агенту: его можно использовать с Claude Code, Codex, Cursor, OpenCode и другими инструментами, которые умеют читать файлы и выполнять команды.

Стоит обратить внимание, что Festival требует настройки под ваши рабочие процессы: нужно описать навыки, планы и проверки. Это не готовое решение «из коробки», а фреймворк, который адаптируется под задачи. Также для работы необходимы базовые знания Git и файловой системы.

Частые вопросы

Как установить festival?

Отдельной команды установки в README нет — склонируйте репозиторий и следуйте инструкции из README:

git clone https://github.com/Obedience-Corp/festival.git

Какие задачи решает festival?

Festival решает задачи организации и контроля работы AI-агентов: он хранит планы, задачи и проверки в файлах и Git, позволяет агенту следовать заданным процессам и сохранять контекст между сессиями. Инструмент подходит для команд, которые работают с агентами в масштабе и хотят сделать их работу прозрачной и управляемой.

Какие агенты поддерживаются?

Festival можно использовать с Claude Code, Codex, Grok Build, Cursor, OpenCode и другими агентами, которые умеют читать файлы и выполнять команды.

Нужен ли Git для работы?

Да, Festival использует файловую систему и Git для хранения планов, задач и проверок, поэтому базовые знания Git необходимы.

Можно ли использовать Festival в коммерческих проектах?

Да, проект распространяется под лицензией Apache-2.0, которая разрешает коммерческое использование.