# backend-to-frontend-handoff-docs

Скилл собирает API-хендофф-документ для фронтенд-разработчиков: эндпоинты, DTO, валидация и граничные случаи в одном markdown-файле.

- скилл · `type=skill` · Claude Code · 164 установки
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/backend-to-frontend-handoff-docs
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/backend-to-frontend-handoff-docs

## Что делает

Скилл включается, когда бэкенд-работа закончена и её нужно передать на фронтенд. Агент собирает контекст — название фичи, эндпоинты, DTO, правила авторизации, граничные случаи — и пишет документ в `.claude/docs/ai/<feature-name>/api-handoff.md`. При повторном запуске после правок к имени файла добавляется суффикс итерации: `-v2`, `-v3` и так далее.

Внутри — один markdown-блок по шаблону: бизнес-контекст, эндпоинты с методами и примерами запроса/ответа, модели данных, перечисления, правила валидации, логика и граничные случаи, заметки по интеграции и тестовые сценарии. Агент заполняет каждую секцию конкретными данными, а подразделы опускает только тогда, когда они неприменимы. В чат при этом ничего не выводится: готовый текст уходит в файл, а не в диалог.

Для простого API есть короткий путь: если это обычный CRUD без сложной бизнес-логики, полный шаблон не нужен — хватит метода, пути и примеров JSON. Ограничение в другом: скилл требует уже готового кода бэкенда, потому что примеры payload-ов должны совпадать с реальным поведением API. Если что-то осталось нерешённым, агент помечает это явно.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --skill enterprise-communication/backend-to-frontend-handoff-docs
```

2. **Через Skills CLI (Vercel)**
```bash
npx skills add davila7/claude-code-templates --skill backend-to-frontend-handoff-docs -a claude-code
```

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

### Codex

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

### Cursor

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install davila7/claude-code-templates backend-to-frontend-handoff-docs
```

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

### Gemini CLI

**Командой платформы**
```bash
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/enterprise-communication/backend-to-frontend-handoff-docs
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/skills/enterprise-communication/backend-to-frontend-handoff-docs

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

## Примеры запросов агенту
- создай handoff для API корзины
- задокументируй эндпоинты заказов для фронтенда
- сделай api-handoff по завершённой работе над профилем

## Похожие
- [handoff](https://affpapa.org/nevibecode/skills/alireza-rezvani-handoff.md) — скилл · 427 установок
- [design-handoff](https://affpapa.org/nevibecode/skills/design-handoff.md) — скилл · 3500 установок
- [stripe-docs](https://affpapa.org/nevibecode/skills/stripe-stripe-docs.md) — скилл · 2700 установок
- [convex-docs](https://affpapa.org/nevibecode/skills/convex-docs.md) — скилл · 36100 установок
- [project-docs](https://affpapa.org/nevibecode/skills/project-docs.md) — скилл · 1200 установок
- [cloudinary-docs](https://affpapa.org/nevibecode/skills/cloudinary-docs.md) — скилл · 993 установки

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 224 карточки

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