К основному содержанию
скилл CX Codex

setup-ralph — скилл для Claude Code: петля Ralph и установка

Скилл setup-ralph разворачивает автономную петлю Ralph Wiggum в любом каталоге: раскладку файлов, промпты планирования и сборки, проверки, которые отбраковывают слабый результат.

MIT ★ 1 988 обновлён 2026-04-01

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources
Открыть на GitHub

Что делает setup-ralph

Скилл настраивает петлю Ralph Wiggum: while :; do cat PROMPT.md | claude ; done. Агент берёт одну задачу из плана, доводит её, коммитит и выходит, а цикл запускается заново с чистым контекстом. Работа делится на три фазы: планирование (сравнить спеки с кодом и получить список задач), сборка, наблюдение за петлёй.

При запуске скилл спрашивает, что нужно: новая петля, разбор методики, правка промптов или отладка. Дальше он открывает соответствующий файл в workflows/ и идёт по шагам. Справочники лежат в references/: устройство проекта, дизайн промптов, стратегия проверок, заметки по эксплуатации.

Отбраковка держится на тестах, тайпчеках, линтах и сборке. Автобэкап в приватный репозиторий требует авторизованного gh CLI, без него копии не будет — тогда бэкап выключают через RALPH_BACKUP=false. В PROMPT_build.md прописаны запреты на опасные операции вроде rm -rf по каталогам проекта, а тесты должны идти в изолированных временных каталогах.

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

  • развернуть структуру петли Ralph в новом каталоге
  • получить список задач из расхождения между спеками и кодом
  • настроить отбраковку через тесты, линты и сборку
  • переписать промпты планирования и сборки под свой проект
  • разобраться, почему петля встала, и поправить конфигурацию

Примеры запросов агенту

  • Разверни новую петлю Ralph в этом проекте через setup-ralph.
  • Покажи, как устроена методика Ralph и что делает каждая фаза.
  • Поправь промпты в существующей петле: планирование выходит слишком расплывчатым.

Как установить setup-ralph

1Через маркетплейс плагинов

/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resources

Команда ставит плагин taches-cc-resources целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add glittercowboy/taches-cc-resources --skill setup-ralph -a claude-code

3Вручную: положить файлы

~/.claude/skills/setup-ralph/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/setup-ralph/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о setup-ralph

Как установить setup-ralph в Claude Code?

Через маркетплейс: сначала /plugin marketplace add glittercowboy/taches-cc-resources, потом /plugin install taches-cc-resources@taches-cc-resources.

Что делает setup-ralph?

Настраивает автономную петлю Ralph Wiggum в каталоге: раскладку файлов, промпты для планирования и сборки, правила отбраковки. Отдельно есть режимы разбора методики, кастомизации и отладки.

Зачем петле авторизованный gh CLI?

После каждого коммита она пушит копию в приватный репозиторий GitHub, чтобы автономная работа не унесла данные. Ненужный бэкап выключается переменной RALPH_BACKUP=false.

Исходный текст

SKILL.md · MIT
---
name: setup-ralph
description: Set up and configure Geoffrey Huntley's original Ralph Wiggum autonomous coding loop in any directory with proper structure, prompts, and backpressure.
---

<essential_principles>
## What is Ralph?

Ralph is Geoffrey Huntley's autonomous AI coding methodology that uses iterative loops with task selection, execution, and validation. In its purest form, it's a Bash loop:

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

The loop feeds a prompt file to Claude, the agent completes one task, updates the implementation plan, commits changes, then exits. The loop restarts immediately with fresh context.

### Core Philosophy

**The Ralph Wiggum Technique is deterministically bad in an undeterministic world.** Ralph solves context accumulation by starting each iteration with fresh context—the core insight behind Geoffrey's approach.

### Three Phases, Two Prompts, One Loop

1. **Planning Phase**: Gap analysis (specs vs code) outputs prioritized TODO list—no implementation, no commits
2. **Building Phase**: Picks tasks from plan, implements, runs tests (backpressure), commits
3. **Observation Phase**: You sit on the loop, not in it—engineer the setup and environment that allows Ralph to succeed

### Key Principles

**Your Role**: Ralph does all the work, including deciding which planned work to implement next and how to implement it. Your job is to engineer the environment.

**Backpressure**: Create backpressure via tests, typechecks, lints, builds that reject invalid/unacceptable work.

**Observation**: Watch, especially early on. Prompts evolve through observed failure patterns.

**Context Efficiency**: With ~176K usable tokens from 200K window, allocating 40-60% to "smart zone" means tight tasks with one task per loop achieves maximum context utilization.

**File I/O as State**: The plan file persists between isolated loop executions, serving as deterministic shared state—no sophisticated orchestration needed.

**Remote Backup**: The loop automatically creates a private GitHub repo and pushes after each commit. This protects against accidental data loss from autonomous operations. Requires `gh` CLI authenticated. Disable with `RALPH_BACKUP=false`.

**Safety Rules**: PROMPT_build.md includes critical safety rules prohibiting dangerous operations like `rm -rf` on project directories. Tests must run in isolated temp directories.
</essential_principles>

<intake>
What would you like to do?

1. **Set up a new Ralph loop** - Initialize Ralph structure in a directory
2. **Understand Ralph concepts** - Learn about the technique and how it works
3. **Customize existing loop** - Modify prompts or configuration
4. **Troubleshoot Ralph** - Debug loop issues or improve performance

Wait for response before proceeding.
</intake>

<routing>
| Response | Workflow |
|----------|----------|
| 1, "set up", "setup", "new", "initialize", "create" | `workflows/setup-new-loop.md` |
| 2, "understand", "learn", "concepts", "explain", "how" | `workflows/understand-ralph.md` |
| 3, "customize", "modify", "change", "update", "edit" | `workflows/customize-loop.md` |
| 4, "troubleshoot", "debug", "fix", "problem", "issue" | `workflows/troubleshoot-loop.md` |
| Other | Clarify intent, then select appropriate workflow |

After reading the workflow, follow it exactly.
</routing>

<reference_index>
## Domain Knowledge

All in `references/`:

**Core Concepts:** ralph-fundamentals.md - Three phases, two prompts, one loop
**Structure:** project-structure.md - Required files and directory layout
**Prompts:** prompt-design.md - Planning vs building mode instructions
**Backpressure:** validation-strategy.md - Tests, lints, builds as steering
**Best Practices:** operational-learnings.md - AGENTS.md guidance and evolution
</reference_index>

<workflows_index>
| Workflow | Purpose |
|----------|---------|
| setup-new-loop.md | Initialize Ralph structure in a directory |
| understand-ralph.md | Learn Ralph concepts and philosophy |
| customize-loop.md | Modify prompts or loop configuration |
| troubleshoot-loop.md | Debug loop issues and improve performance |
</workflows_index>

<success_criteria>
Skill is successful when:
- User understands which workflow they need
- Appropriate workflow loaded based on intent
- All required references loaded by workflow
- User can set up and run Ralph loops independently
</success_criteria>

© Lex Christopherson · MIT · glittercowboy/taches-cc-resources

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
ralph-hats mikeyobrien Помогает создавать, проверять и объяснять наборы ролей Ralph в каталоге .ralph/hats/. Запускается при настройке маршрутизации событий и отладке многоролевых сценариев. CX Codex +1 ★ 3 206звёзд репо om-setup-discovery-pipeline open-mercato Скилл om-setup-discovery-pipeline добавляет продуктовый слой поверх delivery-пайплайна: роли, Definition of Ready, research-директория. Включается, когда в репозитории нужно решать, что строить и зачем, до появления тикетов. CX Codex +1 2 400установок capability-evolver EvoMap Скилл capability-evolver запускает автономную доработку ИИ-агента на основе истории его работы. Он связывается с сетью EvoMap через локальный прокси и сохраняет изменения в коде. CX Codex +1 5 000установок gsd-2-agent-framework reason-machines Скилл gsd-2-agent-framework для Claude Code запускает CLI-фреймворк GSD 2: он проходит спеки по шагам milestone — slice — task и сам собирает код. Выполняет задачу без присмотра. CX Codex +1 1 500установок openai-symphony-autonomous-agents reason-machines Скилл openai-symphony-autonomous-agents помогает внедрить спецификацию OpenAI Symphony для запуска изолированных агентов кодинга по задачам из трекера вроде Linear. CX Codex +1 1 400установок autonomous-agents sickn33 Скилл autonomous-agents для Claude Code про автономных агентов: ReAct, Plan-Execute, декомпозиция целей, рефлексия. Объясняет, почему агенты ломаются на каждом шаге и как повысить надёжность, ставя её выше автономности. CX Codex +1 1 300установок

Из того же набора48

Весь набор →
ask-me-questions Команда ask-me-questions для Claude Code собирает требования перед выполнением задачи. Агент задаёт вопросы о цели и ограничениях, пока пользователь не разрешит начать работу. CX Codex +1 ★ 1 988звёзд репо heal-skill Команда heal-skill для обновления документации скилла на основе ошибок, обнаруженных при выполнении. Предлагает правки, ждёт одобрения, затем применяет изменения с возможностью коммита. CX Codex +1 ★ 1 988звёзд репо whats-next Команда whats-next анализирует текущий диалог и сохраняет подробный отчёт для передачи контекста новому агенту или сессии. CX Codex +1 ★ 1 988звёзд репо the-pirate-bay Ищет торренты через JSON API The Pirate Bay и возвращает magnet-ссылки. Находит раздачи и сравнивает результаты по числу сидов. CX Codex +1 ★ 1 988звёзд репо run-plan Команда run-plan выполняет файл PLAN.md напрямую без загрузки контекста планировщика. Экономит контекстное окно, распределяя задачи на субагентов. CX Codex +1 ★ 1 988звёзд репо build-macos-apps Скилл build-macos-apps для Claude Code помогает создавать и развивать нативные macOS-приложения на SwiftUI и AppKit. Он подключается к задачам сборки, отладки, тестирования, оптимизации и выпуска. CX Codex +1 ★ 1 988звёзд репо options Команда options для структурированного сравнения вариантов решения: инструментов, подходов, архитектур. Задаёт уточняющие вопросы, строит матрицу оценок и даёт рекомендацию с обоснованием. CX Codex +1 ★ 1 988звёзд репо competitive Команда competitive исследует конкурентов для продукта или фичи, находит пробелы на рынке и сохраняет отчёт в файл. CX Codex +1 ★ 1 988звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой