К основному содержанию
скилл CX Codex

plan-first-development — скилл для Claude Code: планирование

Скилл plan-first-development для Claude Code помогает спланировать проект до начала разработки и вести прогресс между сессиями. Он включается при запуске проекта, крупных изменениях и разбиении работы на этапы.

MIT 107 установок ★ 29 обновлён 2026-08-17

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add oakoss/agent-skills --skill plan-first-development -a claude-code
Открыть на GitHub

Что делает plan-first-development

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

Для продолжения работы после сброса контекста скилл использует SESSION.md: в нём хранится конкретное следующее действие и ссылка на план. При возобновлении агент читает этот файл и планировочные документы. Методика советует тратить на планирование не менее 80% времени до реализации; быстрые исправления и очевидные изменения в одном файле она относит к задачам без планирования.

Какие задачи решает

  • составить план нового проекта в Markdown
  • разбить крупную функцию на этапы с зависимостями
  • зафиксировать следующий шаг между сессиями
  • задать критерии проверки для этапов реализации

Примеры запросов агенту

  • Составь план нового проекта и разбей реализацию на этапы.
  • Разложи эту крупную функцию на самостоятельные задачи с зависимостями.
  • Продолжи работу по SESSION.md после сброса контекста.

Как установить plan-first-development

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill plan-first-development -a claude-code

2Вручную: положить файлы

~/.claude/skills/plan-first-development/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/plan-first-development/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о plan-first-development

Как установить plan-first-development в Claude Code?

Выполни npx skills add oakoss/agent-skills --skill plan-first-development -a claude-code. Файл скилла находится по пути ~/.claude/skills/plan-first-development/SKILL.md.

Что делает plan-first-development?

Помогает подготовить и уточнить план разработки, разделить его на фазы и отслеживать прогресс между сессиями через SESSION.md.

Когда скилл предлагает пропустить планирование?

Методика не рекомендует планировать быстрые исправления, изменения в одном файле и очевидные мелкие рефакторинги.

Исходный текст

SKILL.md · MIT
---
name: plan-first-development
description: |
  Planning methodology and session management for software projects.
  Covers markdown plan creation, iterative refinement, multi-model blending,
  phase-based implementation docs, and cross-session progress tracking.

  Use when starting new projects, adding major features, breaking large work
  into phases, resuming after context clears, or managing multi-phase implementations.
license: MIT
metadata:
  author: oakoss
  version: '1.2'
---

# Planning

## Overview

Plan-first development methodology where 80%+ of time goes to planning before implementation begins. Planning tokens are cheaper than implementation tokens, and models reason better about a detailed plan that fits their context window than about a sprawling codebase.

**When to use:** Starting new projects, adding major features, breaking complex work into phases, resuming work after context clears, managing multi-session implementations, coordinating multiple agents on the same codebase.

**When NOT to use:** Quick bug fixes, one-file changes, exploratory prototyping where requirements are unknown, trivial refactors where the change is obvious.

## Quick Reference

| Planning Phase          | Description                                    |
| ----------------------- | ---------------------------------------------- |
| 1. Initial plan         | Write goals, intent, workflows, tech stack     |
| 2. Iterative refinement | 4-5 rounds of review until suggestions plateau |
| 3. Multi-model blend    | Get competing plans, merge best-of-all-worlds  |
| 4. Convert to tasks     | Self-contained tasks with dependency structure |
| 5. Polish tasks         | 6+ rounds of cross-model review                |

| Phase Type     | Scope                                 | Max Files | Duration  |
| -------------- | ------------------------------------- | --------- | --------- |
| Infrastructure | Scaffolding, build config, deployment | 3-5       | 1-3 hours |
| Database       | Migrations, schema, seed data         | 2-4       | 2-4 hours |
| API            | Routes, middleware, validation        | 3-6       | 3-6 hours |
| UI             | Components, forms, state, styling     | 4-8       | 4-8 hours |
| Integration    | Third-party services, webhooks        | 2-4       | 3-5 hours |
| Testing        | E2E tests, integration tests          | varies    | 3-6 hours |

| Pattern               | Purpose                             | Key Points                              |
| --------------------- | ----------------------------------- | --------------------------------------- |
| When to plan vs build | Decision tree by complexity signals | Match planning depth to task complexity |
| Risk assessment       | Probability x impact matrix         | Focus on high-risk items first          |

| Session Lifecycle | Action                                                        |
| ----------------- | ------------------------------------------------------------- |
| Start             | Read SESSION.md, check "Next Action", continue                |
| Work              | Implement, verify, debug (repeat)                             |
| Checkpoint        | Git commit with structured format, update SESSION.md hash     |
| Wrap              | Update SESSION.md, git checkpoint, set concrete "Next Action" |
| Resume            | Read SESSION.md + planning docs, continue from "Next Action"  |

| Document              | When to Generate                               |
| --------------------- | ---------------------------------------------- |
| Implementation phases | Always -- core plan doc for every project      |
| Session tracking      | Always -- navigation hub for progress          |
| Database schema       | 3+ tables                                      |
| API endpoints         | 5+ endpoints                                   |
| Architecture overview | Multiple services or complex system boundaries |
| Critical workflows    | Complex setup steps, order-sensitive workflows |

| Good Plan               | Great Plan                                |
| ----------------------- | ----------------------------------------- |
| Describes what to build | Explains WHY you are building it          |
| Lists features          | Details user workflows and interactions   |
| Mentions tech stack     | Justifies tech choices with tradeoffs     |
| Has tasks               | Has tasks with dependencies and rationale |
| ~500 lines              | ~3,500+ lines after refinement            |

## Common Mistakes

| Mistake                                             | Correct Pattern                                                                               |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Starting implementation before planning is complete | Spend 80%+ of time on planning; finish all refinement rounds before writing code              |
| Writing vague next actions like "continue API work" | Be specific: "Implement PATCH /api/tasks/:id in src/routes/tasks.ts:47"                       |
| Session tracking doc over 200 lines                 | Collapse completed phases to summaries; reference planning docs for details                   |
| Creating phases with 10+ files                      | Auto-split into sub-phases of 5-8 files that fit in one 2-4 hour session                      |
| Single-round plan review                            | Iterate 4-5 rounds until suggestions plateau; use multi-model blending for fresh perspectives |
| Copying code into session docs                      | Reference file paths and line numbers instead of pasting code                                 |
| Duplicating planning doc content in session doc     | Link to sections with anchors; session doc is a navigation hub                                |
| No verification criteria on phases                  | Every phase needs specific, testable exit criteria (status codes, user flows, constraints)    |
| Skeleton-first coding before a plan exists          | One thorough plan beats incremental skeleton-first coding                                     |
| Planning without prototyping unknown tech           | Build a spike first for unfamiliar frameworks, then create the plan                           |
| Over-planning simple tasks                          | Match planning depth to complexity; skip for trivial work                                     |
| Not validating assumptions early                    | Run a spike for the riskiest assumption first                                                 |

## Delegation

- **Explore existing codebase for architecture decisions**: Use `Explore` agent to survey file structure, patterns, and dependencies before planning
- **Execute phase implementation with verification**: Use `Task` agent to implement individual phases, run verification criteria, and create checkpoint commits
- **Design architecture and decompose into phases**: Use `Plan` agent to create implementation phases with dependency ordering and gate criteria

## References

- [Planning process and iterative refinement](references/planning-process.md)
- [Session management and context tracking](references/session-management.md)
- [Phase-based implementation planning](references/phase-planning.md)
- [Review workflows and multi-model blending](references/review-workflows.md)
- [Decision tracking and conditional documents](references/decision-tracking.md)
- [Planning document templates](references/document-templates.md)

© oakoss · MIT · oakoss/agent-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
first-reader mizchi Скилл first-reader прогоняет черновик через симуляцию живого читателя: скользит по тексту, теряет внимание, забывает. Финальная проверка перед публикацией. CX Codex +1 874установок first-principles-review sno-ai Скилл first-principles-review для Claude Code проверяет продуктовые идеи, PRD и архитектуру от первых принципов. Он запускается только по прямому запросу с названием скилла и создаёт локальный отчёт с передачей для написания PRD. CX Codex +1 ★ 869звёзд репо time-to-first-value AIDevGTM Скилл time-to-first-value для Claude Code помогает найти барьеры на пути от первого запуска продукта до первой ощутимой пользы. Разработчики часто регистрируются или пробуют продукт, но не возвращаются — скилл выявляет, где они уходят. CX Codex +1 ★ 344звёзд репо spec-driven-development addyosmani Скилл spec-driven-development для Claude Code готовит спецификацию до начала разработки. Он включается, когда нужно разобрать расплывчатые требования, спланировать функцию или оформить изменения к уже выпущенной спецификации. CX Codex +1 81 900установок investigate-first JuliusBrussee Скилл investigate-first для Claude Code держит агента в режиме разбора: собрать доказательства, назвать причину — и только потом трогать код. Останавливает плавающие падения с неясной причиной. CX Codex +1 129 600установок source-driven-development addyosmani Скилл source-driven-development привязывает код агента к официальной документации библиотек и фреймворков. Скилл нужен, когда важна точность версий API и защита от устаревших приёмов из обучающей выборки. CX Codex +1 74 200установок

Из того же набора106

Весь набор →
trpc trpc — скилл для Claude Code, который помогает строить типобезопасные API на TypeScript с tRPC v11. Он подключается к задачам с роутерами, процедурами, React-клиентом и тестами. CX Codex +1 109установок tauri Помогает собирать приложения на Tauri v2 с веб-интерфейсом и бэкендом на Rust. Подключается при настройке проекта, IPC, разрешений или выпуска приложения. CX Codex +1 108установок turborepo Помогает настраивать Turborepo в монорепозиториях на JavaScript и TypeScript. Запускается при настройке задач, кэша, зависимостей между пакетами и CI. CX Codex +1 108установок realtime-sync Скилл realtime-sync помогает проектировать синхронизацию данных с низкой задержкой, связывать WebTransport, CRDT и пакетный рендеринг потоков ИИ-токенов. CX Codex +1 108установок tracer-bullets Скилл tracer-bullets для Claude Code разбивает многоуровневую разработку на вертикальные срезы. Каждый срез проверяется до начала следующего. CX Codex +1 107установок expert-instruction Скилл expert-instruction для Claude Code помогает проектировать системные инструкции для ИИ-агентов. Он включается при настройке роли агента, ограничений, формата ответов и работы с инструментами. CX Codex +1 106установок codebase-packager Скилл codebase-packager для Claude Code готовит контекст крупного репозитория для ИИ-кодинга. Он собирает дайджесты, упаковывает файлы и помогает проследить связи между ними. CX Codex +1 105установок skill-management Скилл skill-management для Claude Code помогает создавать, проверять и исправлять скиллы по стандарту Agent Skills. Он включается для аудита структуры, описаний и соответствия файлов манифесту. CX Codex +1 105установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой