# planning-with-files

Скилл planning-with-files держит план многошаговой задачи в трёх markdown-файлах и возвращает к ним агента каждый ход — контекст не разваливается на длинной сессии.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 28179 у репозитория
- Автор: OthmanAdi
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/OthmanAdi/planning-with-files/tree/HEAD/.kiro/skills/planning-with-files/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/planning-with-files-4

## Что делает

Скилл хранит рабочий план в трёх файлах на диске: `task_plan.md`, `findings.md` и `progress.md`. Агент перечитывает их перед каждым ходом, поэтому после долгой сессии не теряет, на каком этапе остановился. Рассчитан на исследование или работу, где нужно 5+ вызовов инструментов.

Один раз на воркспейс запускается `bootstrap.sh` из корня проекта (в PowerShell — `bootstrap.ps1`): он создаёт `.kiro/plan/` и файл `.kiro/steering/planning-context.md`, а существующие файлы не трогает. Дальше после каждого этапа агент меняет статус фазы на `in_progress` или `complete`, пишет находки в `findings.md` и ведёт лог в `progress.md`. Скрипт `check-complete.sh --validate .kiro/plan/task_plan.md` проверяет только разметку фаз с маркерами `**Status:**` — успешная проверка ничего не говорит о том, что работа сделана.

Нужен POSIX shell или PowerShell, Python 3 для `session-catchup.py` и права на запись в воркспейс: без Python догон сессии после перерыва не запустится. Хуки в комплект не входят, и автор предупреждает, что хуки уровня проекта задевают все чаты воркспейса. Команды, объявленные в markdown, скилл не выполняет и ничего не выгружает в сеть.

## Установка

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

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

2. **Через Skills CLI (Vercel)**
```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OthmanAdi/planning-with-files .kiro/skills/planning-with-files
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OthmanAdi/planning-with-files --skill planning-with-files -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/OthmanAdi/planning-with-files --path .kiro/skills/planning-with-files
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

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

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

## Примеры запросов агенту
- Заведи план для этой задачи через planning-with-files и обновляй статусы фаз после каждого этапа.
- Прочитай `.kiro/plan/task_plan.md` и `progress.md` и продолжи с того места, где мы остановились.
- Запусти `session-catchup.py` и сверь план с текущим состоянием кода.

## Похожие
- [planning](https://affpapa.org/nevibecode/skills/mblode-planning.md) — скилл · 552 установки
- [planning-cadence](https://affpapa.org/nevibecode/skills/planning-cadence.md) — скилл · 491 установка
- [self-improvement](https://affpapa.org/nevibecode/skills/self-improvement.md) — скилл · 2100 установок
- [concise-planning](https://affpapa.org/nevibecode/skills/concise-planning.md) — скилл · 117 установок
- [planning-and-task-breakdown](https://affpapa.org/nevibecode/skills/planning-and-task-breakdown.md) — скилл · 80700 установок
- [self-improving-agent](https://affpapa.org/nevibecode/skills/pskoett-self-improving-agent.md) — скилл · 408 установок

## Другие версии с тем же именем
- [planning-with-files · othmanadi](https://affpapa.org/nevibecode/skills/othmanadi-planning-with-files.md) — 49300 установок

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

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