# fractal

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 788
- Автор: plasma-ai
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/plasma-ai/fractal/tree/HEAD/fractal/skills/fractal/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/fractal

## Что делает

fractal организует работу агентов по иерархии. Каждый узел получает цель, работает в собственном Git worktree, выполняет итерации и при необходимости создаёт дочерние узлы для параллельных подзадач. Агент может самостоятельно вносить изменения и создавать коммиты. Запуск происходит через tmux или отдельную фоновую группу процессов без графического интерфейса.

Перед стартом скилл преобразует текстовую директиву в параметры `fractal node init`: имя узла, путь к проекту, ветку, модель, лимиты итераций и вложенности, тайм-ауты и бюджет. Настройки записываются в `config.json`, где их можно изменить до запуска. Шаблоны с `NODE.md`, `steps/`, `scripts/`, `skills/` и `agents/` позволяют задавать исходную конфигурацию узлов. Дочерние агенты могут получать часть настроек родителя.

Работа не заканчивается запуском. Корневой узел не имеет собственного цикла, поэтому оператор следит за деревом агентов, направляет их работу и передаёт результаты пользователю. Скилл отключает автоматический вызов модели через фронтматтер, так что его нужно запускать явно. Для продолжения остановленного узла учитывайте бюджет: после завершения по лимиту стоимости команда продолжения требует явного `--max-cost`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add plasma-ai/fractal --skill fractal -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/fractal/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/fractal/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add plasma-ai/fractal --skill fractal -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/fractal/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add plasma-ai/fractal --skill fractal -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/fractal/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install plasma-ai/fractal fractal
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/fractal/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add plasma-ai/fractal --skill fractal -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/plasma-ai/fractal --path fractal/skills/fractal
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/fractal/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add plasma-ai/fractal --skill fractal -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/plasma-ai/fractal/tree/HEAD/fractal/skills/fractal/SKILL.md

## Когда брать
- Разбить крупную задачу разработки на параллельные подзадачи
- Запустить независимых агентов в отдельных Git worktree
- Ограничить глубину дерева агентов и число дочерних узлов
- Задать бюджет и временные лимиты для запуска
- Подготовить дочерние узлы по шаблону с конфигурацией и шагами

## Примеры запросов агенту
- Раздели задачу рефакторинга на независимые подзадачи и запусти их через `/fractal`.
- Запусти дерево агентов для изменений в `tests`, ограничив число дочерних узлов и общий бюджет.
- Продолжи существующий узел fractal с явным лимитом стоимости.

## Похожие
- [setup-matt-pocock-skills](https://affpapa.org/nevibecode/skills/setup-matt-pocock-skills.md) — скилл · 1052851 установка
- [ask-matt](https://affpapa.org/nevibecode/skills/ask-matt.md) — скилл · 766587 установок
- [to-tickets](https://affpapa.org/nevibecode/skills/to-tickets.md) — скилл · 711230 установок
- [writing-plans](https://affpapa.org/nevibecode/skills/writing-plans.md) — скилл · 282859 установок
- [caveman-review](https://affpapa.org/nevibecode/skills/caveman-review.md) — скилл · 411800 установок
- [caveman-compress](https://affpapa.org/nevibecode/skills/caveman-compress.md) — скилл · 411500 установок

## Другие версии с тем же именем
- [fractal · plasma-ai](https://affpapa.org/nevibecode/skills/plasma-ai-fractal.md) — ★ 788

Из того же набора: [plasma-ai/fractal](https://affpapa.org/nevibecode/by/plasma-ai/fractal.md) — 5 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md