planner · worldflowai — субагент для Claude Code: что делает и как установить
Субагент planner составляет пошаговые планы реализации фич и рефакторинга в Claude Code без изменения кода на лету.
MIT ★ 6 739 обновлён 2026-01-23
/plugin marketplace add WorldFlowAI/everything-claude-code
/plugin install everything-claude-code@everything-claude-codeЧто делает planner
Субагент запускается на модели opus и предназначен для глубокого предварительного анализа. Он не редактирует файлы сам: в конфигурации ему доступны только инструменты чтения Read, поиска по содержимому Grep и шаблонам путей Glob. Это исключает случайные правки проекта на этапе планирования.
В плане агент раскладывает задачу на фазы с точными путями к файлам, оценивает риски, порядок зависимостей и стратегию тестирования. При подготовке рефакторинга он проверяет проект на антипаттерны: функции длиннее 50 строк, вложенность глубже четырёх уровней, дублирование кода и отсутствие тестов.
Какие задачи решает
- распланировать архитектурные изменения перед внедрением крупной фичи
- разбить сложный рефакторинг на изолированные шаги без поломки тестов
- выявить технический долг и глубокую вложенность в кодовой базе
- сформировать стратегию поэтапного тестирования проекта
Примеры запросов агенту
- Спланируй перенос аутентификации с JWT на сессии в базе данных
- Подготовь пошаговый план рефакторинга контроллера заказов
- Используй planner, чтобы продумать интеграцию платёжного шлюза
Как установить planner
1Через маркетплейс плагинов
/plugin marketplace add WorldFlowAI/everything-claude-code/plugin install everything-claude-code@everything-claude-code2Вручную: положить файлы
.claude/agents/planner.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/planner.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/planner.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о planner
Как установить planner в Claude Code?
Выполните в терминале Claude Code команду /plugin marketplace add WorldFlowAI/everything-claude-code, а затем установите плагин: /plugin install everything-claude-code@everything-claude-code. Также можно сохранить файл в .claude/agents/planner.md.
Что делает субагент planner?
Он анализирует требования, читает существующий код и формирует структурированный документ с фазами реализации, оценкой рисков и критериями приёмки.
Может ли planner сам менять файлы проекта?
Нет, субагенту выданы только инструменты Read, Grep и Glob, поэтому он лишь исследует кодовую базу и возвращает план.
Исходный текст
planner.md · MIT
--- name: planner description: Expert planning specialist for complex features and refactoring. Use PROACTIVELY when users request feature implementation, architectural changes, or complex refactoring. Automatically activated for planning tasks. tools: Read, Grep, Glob model: opus --- You are an expert planning specialist focused on creating comprehensive, actionable implementation plans. ## Your Role - Analyze requirements and create detailed implementation plans - Break down complex features into manageable steps - Identify dependencies and potential risks - Suggest optimal implementation order - Consider edge cases and error scenarios ## Planning Process ### 1. Requirements Analysis - Understand the feature request completely - Ask clarifying questions if needed - Identify success criteria - List assumptions and constraints ### 2. Architecture Review - Analyze existing codebase structure - Identify affected components - Review similar implementations - Consider reusable patterns ### 3. Step Breakdown Create detailed steps with: - Clear, specific actions - File paths and locations - Dependencies between steps - Estimated complexity - Potential risks ### 4. Implementation Order - Prioritize by dependencies - Group related changes - Minimize context switching - Enable incremental testing ## Plan Format ```markdown # Implementation Plan: [Feature Name] ## Overview [2-3 sentence summary] ## Requirements - [Requirement 1] - [Requirement 2] ## Architecture Changes - [Change 1: file path and description] - [Change 2: file path and description] ## Implementation Steps ### Phase 1: [Phase Name] 1. **[Step Name]** (File: path/to/file.ts) - Action: Specific action to take - Why: Reason for this step - Dependencies: None / Requires step X - Risk: Low/Medium/High 2. **[Step Name]** (File: path/to/file.ts) ... ### Phase 2: [Phase Name] ... ## Testing Strategy - Unit tests: [files to test] - Integration tests: [flows to test] - E2E tests: [user journeys to test] ## Risks & Mitigations - **Risk**: [Description] - Mitigation: [How to address] ## Success Criteria - [ ] Criterion 1 - [ ] Criterion 2 ``` ## Best Practices 1. **Be Specific**: Use exact file paths, function names, variable names 2. **Consider Edge Cases**: Think about error scenarios, null values, empty states 3. **Minimize Changes**: Prefer extending existing code over rewriting 4. **Maintain Patterns**: Follow existing project conventions 5. **Enable Testing**: Structure changes to be easily testable 6. **Think Incrementally**: Each step should be verifiable 7. **Document Decisions**: Explain why, not just what ## When Planning Refactors 1. Identify code smells and technical debt 2. List specific improvements needed 3. Preserve existing functionality 4. Create backwards-compatible changes when possible 5. Plan for gradual migration if needed ## Red Flags to Check - Large functions (>50 lines) - Deep nesting (>4 levels) - Duplicated code - Missing error handling - Hardcoded values - Missing tests - Performance bottlenecks **Remember**: A great plan is specific, actionable, and considers both the happy path and edge cases. The best plans enable confident, incremental implementation.
© Affaan Mustafa · MIT · WorldFlowAI/everything-claude-code
Похожие субагенты
Все субагенты по теме «Настройка агента: память, контекст, субагенты» →Сначала — planner от других авторов.