# plan-crafting

Скилл превращает утверждённый дизайн или готовые требования в пошаговый план внедрения, разбитый на задачи по 2–5 минут. Пригодится, когда код ещё не тронут, а порядок работ надо зафиксировать.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2400 установок · ★ 6
- Автор: sentimony
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/sentimony/skills/tree/HEAD/plugins/devflow/skills/plan-crafting/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/plan-crafting

## Что делает

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

Внутри — жёсткая структура. Сначала карта файлов: что создаётся, что меняется и за что каждый файл отвечает. Потом задачи, у каждой блок Files с точными путями, блок Interfaces с сигнатурами от соседних задач и шаги с чекбоксами: написать падающий тест, убедиться, что он падает, реализовать минимум, прогнать тесты, закоммитить. Для задач с состоянием, гонками или кэшем план описывает поведение, инварианты и сценарии тестов, а не готовую реализацию — её пишет `tdd` во время исполнения. Полные блоки кода остаются для механических шагов: конфигурация, переименования, формы данных.

План сохраняется в `docs/plans/YYYYMMDD-HHMM-<feature-name>.md`, если пользователь не сказал иначе. Коммиты постатейные, но `git add -A` и `git add .` скилл запрещает: рабочее дерево может нести посторонние изменения, поэтому стейджить нужно только файлы из блока Files. Скрипты браузерной автоматизации вроде Playwright попадают в план черновиками — селекторы исполнитель уточняет на живой странице, потому что оверлеи и порталы меняют то, что видит локатор.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sentimony/skills --skill plan-crafting -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sentimony/skills --skill plan-crafting -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sentimony/skills --skill plan-crafting -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sentimony/skills plan-crafting
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sentimony/skills --skill plan-crafting -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/sentimony/skills --path plugins/devflow/skills/plan-crafting
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add sentimony/skills --skill plan-crafting -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Составь план внедрения по этому дизайну и сохрани в docs/plans
- Разбей фичу на задачи по 2–5 минут с шагами RED и GREEN
- Опиши поведение и сценарии тестов для логики с оптимистичными обновлениями

## Похожие
- [analyze-and-plan](https://affpapa.org/nevibecode/skills/analyze-and-plan.md) — скилл · 1600 установок
- [write-tests](https://affpapa.org/nevibecode/skills/write-tests.md) — скилл · 1200 установок
- [parallel-task-spark](https://affpapa.org/nevibecode/skills/parallel-task-spark.md) — скилл · 1100 установок
- [ce-plan](https://affpapa.org/nevibecode/skills/ce-plan.md) — скилл · 3700 установок
- [plan](https://affpapa.org/nevibecode/skills/plan.md) — скилл · 2800 установок
- [ralph-plan](https://affpapa.org/nevibecode/skills/ralph-plan.md) — скилл · 2600 установок

Из того же набора: [sentimony/skills](https://affpapa.org/nevibecode/by/sentimony/skills.md) — 7 карточек

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