# agent-brief

Скилл agent-brief для Claude Code стандартизирует передачу задач агентам через структурированные брифы. Помогает чётко описать цели, гипотезы и критерии проверки до старта работы над задачей.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 741 у репозитория
- Автор: Ronny (MiniMax Code team)
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/MiniMax-AI/mcode-stack/tree/HEAD/stacks/ronny/skills/agent-brief/SKILL.md
- Обновлён: 2026-11-11
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/agent-brief

## Что делает

Этот инструмент вводит обязательный этап проектирования перед выполнением нетривиальных задач. Пользователь составляет бриф с указанием уровня ответственности, ожидаемого результата, ограничений и критериев верификации. Чёткое описание задачи предотвращает ситуацию, когда агент самостоятельно додумывает детали реализации.

Бриф определяет режим взаимодействия: агент помогает рассуждать или выполняет задачу полностью. В последнем случае бриф требует более строгой проверки результата пользователем. Применение этого подхода экономит время на последующее ревью, так как заранее определены способы проверки итогов.

Для работы скилла не требуются внешние API или платные сервисы, он интегрируется в среду разработки через консольные команды. Установка в Claude Code выполняется через `/plugin marketplace add MiniMax-AI/mcode-stack` и `/plugin install ronny@mcode-stack`.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add MiniMax-AI/mcode-stack
```
В чате агента (не в терминале):
```text
/plugin install ronny@mcode-stack
```
Команда ставит плагин ronny целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/mcode-stack --skill agent-brief -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/mcode-stack --skill agent-brief -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/mcode-stack --skill agent-brief -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MiniMax-AI/mcode-stack stacks/ronny/skills/agent-brief
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/mcode-stack --skill agent-brief -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/MiniMax-AI/mcode-stack --path stacks/ronny/skills/agent-brief
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/MiniMax-AI/mcode-stack/tree/HEAD/stacks/ronny/skills/agent-brief/SKILL.md

## Когда брать
- описать гипотезу перед запуском кода
- задать критерии верификации до получения результата
- разграничить зоны ответственности в режиме делегирования
- исключить додумывание агентом деталей задачи

## Примеры запросов агенту
- agent-brief: перейди к заполнению брифа
- Используй шаблон agent-brief для текущей задачи
- Сформируй бриф по пунктам: stakes, hypothesis, goal

## Похожие
- [app-brief](https://affpapa.org/nevibecode/skills/app-brief.md) — скилл · 1000 установок
- [tool-foundation-sprint-brief](https://affpapa.org/nevibecode/skills/tool-foundation-sprint-brief.md) — скилл · 709 установок
- [brief](https://affpapa.org/nevibecode/skills/brief.md) — скилл · 386 установок
- [06-product-brief](https://affpapa.org/nevibecode/skills/06-product-brief.md) — скилл · ★ 571 у репозитория
- [monday-brief](https://affpapa.org/nevibecode/skills/ilyautov-monday-brief.md) — скилл · ★ 38 у репозитория
- [paperclip-converting-plans-to-tasks](https://affpapa.org/nevibecode/skills/paperclip-converting-plans-to-tasks.md) — скилл · 264 установки

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

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

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