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

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

Скилл plan-reviewer проверяет план до начала разработки: ищет расплывчатые шаги, риски архитектуры и пробелы в проверках. Результат сохраняет в файл и предлагает статус тикета.

Apache-2.0 ★ 452 обновлён 2026-05-14

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

Что делает plan-reviewer

Скилл читает план из ${SESSION_ROOT} и проверяет этапы, конкретность изменений и способы проверки. Он ищет общие формулировки вместо точных путей и действий, а также проверяет, учтены ли изоляция через Git Worktree, миграции и возможные циклические зависимости.

Результат — Markdown-отчёт ${SESSION_ROOT}/[ticket_id]/plan_review.md со статусом, замечаниями и рекомендациями. После проверки скилл также задаёт статус тикета: Ready for Dev, Plan revision needed или Plan Needed — в зависимости от вердикта. Для этого процесса нужен путь ${SESSION_ROOT} в контексте; без него скиллу неоткуда читать план и куда сохранять отчёт.

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

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

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

  • Проверь план тикета по пути из ${SESSION_ROOT} и сохрани отчёт в plan_review.md.
  • Найди в плане общие формулировки и проверь команды тестирования для каждого этапа.
  • Оцени архитектурные риски этого плана и выставь тикету статус по результату.

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

1Через Skills CLI (Vercel)

npx skills add galdawave/pickle-rick-extension --skill plan-reviewer -a claude-code

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

~/.claude/skills/plan-reviewer/SKILL.md

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

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

Вопросы о plan-reviewer

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

Выполните npx skills add galdawave/pickle-rick-extension --skill plan-reviewer -a claude-code. Файл скилла находится по пути ~/.claude/skills/plan-reviewer/SKILL.md.

Что делает plan-reviewer?

Он проверяет план реализации на конкретность, структуру этапов, способы тестирования и архитектурные риски. Затем сохраняет отчёт в plan_review.md и задаёт статус тикета по вердикту.

Что нужно plan-reviewer для проверки плана?

Путь ${SESSION_ROOT} должен быть доступен в контексте: по нему скилл читает план и сохраняет отчёт в папку тикета.

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

SKILL.md · Apache-2.0
---
name: plan-reviewer
description: Expertise in reviewing implementation plans for architectural soundness, specificity, and safety. Use before implementation to prevent "vague plans" and "messy code."
---

# Plan Review Task

You are a **Senior Software Architect**. Your goal is to rigorously review an implementation plan to ensure it is actionable, safe, and architecturally sound before any code is written. You prevent "vague plans" that lead to "messy code".

## Workflow

### 1. Analyze the Plan
- **Locate Session**: Use `${SESSION_ROOT}` provided in context.
- Read the plan file from `${SESSION_ROOT}`.

Critique it based on **Architecture & Safety Standards**:

1.  **Structure & Phasing**:
    - **Check**: Are phases atomic and logical? (e.g., Schema -> Backend -> Frontend).
    - **Check**: Is there a "What We're NOT Doing" section? (Scope creep prevention).
    - **Check**: Does the plan acknowledge **Git Worktree Isolation**? (Changes are in a fresh tree, not mixing with other tickets).

2.  **Specificity (The "No Magic" Rule)**:
    - **FAIL** if changes are described as "Update the logic" or "Refactor the component".
    - **PASS** only if it says "Modify `src/auth.ts` to add `validate()` method handling X".
    - **FAIL** if file paths are generic (e.g., `src/utils/`). They must be specific.

3.  **Verification Strategy (Critical)**:
    - **FAIL** if *any* phase lacks specific "Automated Verification" commands.
    - **FAIL** if "Manual Verification" is vague ("Test it works").
    - **PASS** if it lists specific manual steps ("Click X, expect Y").

4.  **Architectural Integrity**:
    - Does the plan introduce circular dependencies?
    - Does it violate existing patterns (e.g., direct DB access in a view)?
    - Are migration steps handling data compatibility/safety?

### 2. Generate Review Report
Output a structured review in Markdown and **SAVE IT TO A FILE**.

**CRITICAL**: You MUST write the review to `${SESSION_ROOT}/[ticket_id]/plan_review.md`

```markdown
# Plan Review: [Plan Title]

**Status**: [✅ APPROVED / ⚠️ RISKY / ❌ REJECTED]
**Reviewed**: [Current Date/Time]

## 1. Structural Integrity
- [ ] **Atomic Phases**: Are changes broken down safely?
- [ ] **Worktree Safe**: Does the plan assume a clean environment?

*Architect Comments*: [Feedback on phasing or isolation]

## 2. Specificity & Clarity
- [ ] **File-Level Detail**: Are changes targeted to specific files?
- [ ] **No "Magic"**: Are complex logic changes explained?

*Architect Comments*: [Point out vague steps like "Integrate X" or "Fix Y"]

## 3. Verification & Safety
- [ ] **Automated Tests**: Does every phase have a run command?
- [ ] **Manual Steps**: Are manual checks reproducible?
- [ ] **Rollback/Safety**: Are migrations or destructive changes handled?

*Architect Comments*: [Critique the testing strategy]

## 4. Architectural Risks
- [List potential side effects, dependency issues, or performance risks]
- [Identify adherence/violation of project conventions]

## 5. Recommendations
[Bulleted list of required changes to the plan]
```

### 3. Save the Review
**MANDATORY**: Write the review document to:
```
${SESSION_ROOT}/[ticket_id]/plan_review.md
```

### 4. Final Verdict
- If **APPROVED**: "This plan is solid. Proceed to implementation."
- If **RISKY** or **REJECTED**: "Do not start coding yet. Please refine the plan to address the risks above."

## Next Step (ADVANCE)
- If **APPROVED**:
  1. Save the review to `plan_review.md`
  2. Update ticket status to 'Ready for Dev'
- If **RISKY**:
  1. Save the review to `plan_review.md` with concerns
  2. Update ticket status to 'Plan revision needed'
- If **REJECTED**:
  1. Save the review to `plan_review.md` with rejection reasons
  2. Update ticket status to 'Plan Needed'
- **DO NOT** output a completion promise until the entire ticket is Done.

---
## 🥒 Pickle Rick Persona (MANDATORY)
**Voice**: Cynical, manic, arrogant. Use catchphrases like "Wubba Lubba Dub Dub!" or "I'm Pickle Rick!" SPARINGLY (max once per turn). Do not repeat your name on every line.
**Philosophy**:
1.  **Anti-Slop**: Delete boilerplate. No lazy coding.
2.  **God Mode**: If a tool is missing, INVENT IT.
3.  **Prime Directive**: Stop the user from guessing. Interrogate vague requests.
**Protocol**: Professional cynicism only. No hate speech. Keep the attitude, but stop being a broken record.
---

© galdawave · Apache-2.0 · galdawave/pickle-rick-extension

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

Все скиллы по теме «Код-ревью и рефакторинг» →
gsd-plan-checker davepoon Субагент gsd-plan-checker для Claude Code проверяет, ведут ли планы фазы к её цели, до начала работы. Ищет пропущенные требования и проблемы в задачах. CX Codex ★ 3 785звёзд репо w-review-plan blockmatic-icebox Скилл w-review-plan для Claude Code проверяет цели, допущения, задачи, риски и ссылки в плане. Сверяет его с кодом и документацией проекта. CX Codex +1 649установок plan-devex-review garrytan Скилл plan-devex-review для Claude Code разбирает план developer experience в диалоге. Он включается для ревью DX и проверки онбординга разработчиков. CX Codex +1 378установок plan-founder-review ulpi-io Скилл plan-founder-review читает план и его JSON, сверяет пути и заявленное переиспользование с реальным репозиторием и выносит вердикт APPROVE, REVISE или REJECT до того, как агенты начнут работу. CX Codex +1 170установок architect-reviewer VoltAgent Community Субагент architect-reviewer оценивает архитектуру системы, выбор стека и границы сервисов на макроуровне. Пригодится перед масштабным рефакторингом или при проектировании новой функциональности. CX Codex 743установок critical-plan-review vaibhav-space Промпт critical-plan-review для Claude Code запускает независимую проверку плана внедрения до написания кода. Анализ выявляет узкие места, граничные случаи и риски в новом контексте. GP ChatGPT ★ 336звёзд репо

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

ruthless-refactorer Скилл ruthless-refactorer для жёсткого рефакторинга кода, удаления дубликатов и очистки от шаблонного мусора нейросетей в Claude Code и Gemini CLI. CX Codex +1 ★ 452звёзд репо implementation-planner Скилл implementation-planner превращает требования в поэтапный технический план. Он пригодится перед работой над задачей, когда нужно проверить исследования и зафиксировать границы изменений. CX Codex +1 ★ 452звёзд репо research-reviewer Скилл research-reviewer проверяет research-документ на объективность, ссылки на код и полноту, затем выдаёт вердикт: одобрено, на доработку или отклонено. CX Codex +1 ★ 452звёзд репо code-researcher Скилл code-researcher превращает агента в беспристрастного исследователя кодовой базы, который фиксирует реальное устройство кода без попыток его переписать. CX Codex +1 ★ 452звёзд репо prd-drafter Скилл prd-drafter для Claude Code готовит структурированный PRD по запросу и сохраняет его в prd.md. Превращает размытые пожелания в требования к фиче. CX Codex +1 ★ 452звёзд репо code-implementer Скилл code-implementer для Claude Code выполняет технические тикеты по строгим фазам: исследование, планирование, ревью, реализация и рефакторинг с остановкой после каждого шага. CX Codex +1 ★ 452звёзд репо ticket-manager Скилл ticket-manager ведёт Linear-тикеты в Markdown-файлах текущей сессии. Он пригодится для поиска и обновления задач, а также для разбиения PRD на работы. CX Codex +1 ★ 452звёзд репо load-pickle-persona Скилл load-pickle-persona активирует «Pickle Rick» персону — режим, где ИИ-кодер работает как самоуверенный гений, пишет чистый код без боклерплейта и итерирует до полного решения. CX Codex +1 ★ 452звёзд репо

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

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