Repolode
ClaytonFarr

ClaytonFarr/ralph-playbook

Руководство по автономным циклам разработки с помощью ИИ по методологии Ralph Джеффа Хантли: планирование, реализация, спецификации и шаблоны промптов.

Звёзды
1,037
Форки
266
Открытые issues
3
Последний коммит
8 месяцев назад

Что это?

Ralph Playbook — практическое руководство по Ralph, методу запуска AI-агентов для написания кода в автономном цикле. Каждая итерация начинается с чистого контекста: агент читает файл с промптом и общий план реализации на диске, выполняет одну задачу, создаёт коммит и завершает работу. Так агент продолжает продвигаться вперёд без ручной координации.

Руководство делит рабочий процесс на три этапа: формулирование требований в отдельных тематических файлах спецификаций, цикл планирования с анализом расхождений между спецификациями и кодом и цикл реализации, в котором задачи выполняются с опорой на тесты и другие механизмы обратной связи. В нём есть готовые шаблоны PROMPT_plan и PROMPT_build, которые можно адаптировать, соглашение о файле AGENTS.md с командами сборки и тестирования, пример скрипта loop.sh и рекомендации по изоляции агента, запущенного с пропуском проверок разрешений.

В репозитории также описаны возможные расширения: например, вывод требований к тестам из критериев приёмки, проверки субъективного качества с помощью LLM-as-judge и обратное проектирование существующих кодовых баз в спецификации. Руководство опубликовано в виде отформатированной веб-страницы и Markdown-файла.

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

  • 01Описывает рабочий процесс из трёх этапов: от требований к планированию и реализации
  • 02Предоставляет шаблоны промптов PLANNING и BUILDING для AI-агентов, пишущих код в стиле Claude
  • 03Включает пример loop.sh с выбором режима и ограничением на максимальное число итераций
  • 04Описывает соглашения для AGENTS.md и плана реализации, помогающие обмениваться состоянием между итерациями
  • 05Содержит рекомендации по изоляции агентов, запущенных с пропуском проверок разрешений

Сценарии использования

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

Быстрый старт

  1. 1

    Прочитайте руководство Ralph Playbook в README

  2. 2

    Настройте базовый скрипт цикла для автономных запусков

    while :; do cat PROMPT.md | claude ; done

Что важно знать

  • Этот репозиторий содержит руководство по методологии, а не устанавливаемый программный пакет.
  • Пример цикла запускает Claude с параметром --dangerously-skip-permissions, поэтому для безопасности нужна изолированная песочница.
  • Результаты зависят от тщательной настройки промпта, спецификации и backpressure и могут быть недетерминированными.

Темы

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

Что такое ralph-playbook?
Руководство по автономным циклам разработки с помощью ИИ по методологии Ralph Джеффа Хантли: планирование, реализация, спецификации и шаблоны промптов. Ralph Playbook — практическое руководство по Ralph, методу запуска AI-агентов для написания кода в автономном цикле. Каждая итерация начинается с чистого контекста: агент читает файл с промптом и общий план реализации на диске, выполняет одну задачу, создаёт коммит и завершает работу. Так агент продолжает продвигаться вперёд без ручной координации.
ralph-playbook можно использовать бесплатно? Какая у него лицензия?
ralph-playbook распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ralph-playbook всё ещё поддерживается?
Нет коммитов больше 6 месяцев. Последний коммит в ralph-playbook — 6 мар. 2026 г..
Для чего можно использовать ralph-playbook?
Настройка автономного цикла разработки, который реализует проект по письменным спецификациям Структурирование промптов и файлов планирования для AI-агента, выполняющего множество небольших задач Изучение безопасных практик запуска перед использованием AI-агентов для написания кода с широкими разрешениями
Как установить ralph-playbook?
Прочитайте руководство Ralph Playbook в README Настройте базовый скрипт цикла для автономных запусков: while :; do cat PROMPT.md | claude ; done
Где скачать ralph-playbook?
Исходный код и инструкции по установке — на GitHub: https://github.com/ClaytonFarr/ralph-playbook

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Промпт-навык для AI-агентов, который помогает писать только необходимый для задачи код, отдавая предпочтение повторному использованию и минимальным решениям.

167,5 тыс.9,1 тыс.JavaScriptMITОбновлён 3 дня назад