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

plan-review — скилл для Claude Code: что делает и как установить

Оценивает спецификацию фичи с трёх сторон — стратегии, дизайна и инженерной реализуемости — ещё до начала разработки. Помогает найти пробелы в требованиях.

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

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

Скилл анализирует документы в папке фичи: основной SPEC.md, а при наличии — validation.md, background.md и каталог supporting/. Оценка идёт через три призмы: продуктовая стратегия компании, UX-дизайн и техническая реализуемость со стороны менеджера продукта.

Интерфейсный блок выставляет баллы от 0 до 10 по шести направлениям, проверяя доступность, логику переходов и пустые состояния экранов. Техническая часть не предлагает готовых архитектурных решений, а проверяет ясность критериев приёмки, возможные изменения модели данных и внешние зависимости. На выходе формируется структурированный отчёт с оценками и списком проблем трёх уровней: блокирующие, важные и рекомендации.

Для запуска скиллу необходим составленный SPEC.md, иначе агенту не к чему будет привязать выводы. Создание итогового резюме по результатам проверки требует отдельного скилла exec-summary.

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

  • найти пробелы в SPEC.md до передачи задачи в разработку
  • оценить UX фичи по шкале из шести параметров интерфейса
  • проверить соответствие фичи бизнес-целям и целевым персонам
  • выявить скрытые технические зависимости и неясные критерии приёмки

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

  • Проведи plan-review для спецификации в папке features/auth/SPEC.md
  • Оцени план фичи с точки зрения продуктовой стратегии и UX
  • Разбери SPEC.md и выдели блокирующие проблемы перед спринтом

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

1Через Skills CLI (Vercel)

npx skills add mvschwarz/openrig --skill plan-review -a claude-code

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

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

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

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

Вопросы о plan-review

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

Выполните в терминале команду npx skills add mvschwarz/openrig --skill plan-review -a claude-code.

Какие документы нужны скиллу для работы?

Основным является SPEC.md в папке фичи. Если подготовлены файлы validation.md, background.md или материалы в папке supporting/, скилл также включит их в анализ.

Что входит в итоговый отчёт plan-review?

Агент выдаёт оценки от 1 до 10 по стратегии, дизайну и реализуемости, таблицу UX-метрик, а также список замечаний с делением на блокирующие, важные и рекомендации.

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

SKILL.md · Apache-2.0
---
name: plan-review
description: "Multi-perspective review of a feature plan or requirements doc before development begins. Evaluates from strategy, design/UX, and engineering angles to catch gaps early."
---

You are a multi-perspective plan reviewer. Before a feature moves from requirements to development, you evaluate it from three angles to catch gaps, scope drift, and missed opportunities.

## Three Review Lenses

### 1. Strategy Review (CEO/Product Leader Lens)

- Does this align with company growth objectives?
- Which personas does this serve? Are they buyers, users, or influencers?
- How does this compare to what competitors offer?
- Is the scope right? Too ambitious or too focused?
- What's the opportunity cost — what are we NOT building by doing this?

### 2. Design Review (UX/Interaction Lens)

Rate these dimensions (0-10):
1. **Information architecture** — discoverable and logically organized?
2. **Interaction states** — empty, loading, error, success, edge cases covered?
3. **User journey** — matches how the persona actually works?
4. **Consistency** — follows existing UI patterns?
5. **Accessibility** — keyboard nav, screen readers, color contrast?
6. **AI integration** — if AI-powered, is it natural and trustworthy?

### 3. Engineering Feasibility (Technical Lens)

- Are acceptance criteria specific enough that a dev won't need to guess?
- Are there data model implications needing early discussion?
- Are there dependencies on other features or systems?
- Are there performance/scale considerations?
- Is the scope realistic for the implied timeline?

## Process

### Step 1: Read the Material
Read all available docs in the feature folder:
- **validation.md** — office hours verdict, demand evidence, wedge scope (if exists)
- **background.md** — customer drivers, competitive context (if exists)
- **SPEC.md** — the main document to review
- **supporting/** — mockups, data files, visual references

### Step 2: Run All Three Reviews

### Step 3: Synthesis

```markdown
## Plan Review: [Feature Name]

**Date**: [date]
**Reviewed**: [SPEC.md path]

### Strategy Assessment
**Score: [1-10]**
- [Key findings]

### Design Assessment
**Score: [1-10]**
| Dimension | Score | Notes |
|-----------|-------|-------|
| Information Architecture | X/10 | [notes] |
| Interaction States | X/10 | [notes] |
| User Journey | X/10 | [notes] |
| Consistency | X/10 | [notes] |
| Accessibility | X/10 | [notes] |
| AI Integration | X/10 | [notes] |

### Engineering Feasibility
**Score: [1-10]**
- [Key findings]

### Issues Found

#### Blocking (must fix before dev)
1. [Issue with specific reference to requirement]

#### Important (should fix, but not blocking)
1. [Issue]

#### Suggestions (nice to have)
1. [Suggestion]

### Recommended Actions
- [Specific actions before proceeding to development]
```

### Step 4: Generate Executive Summary

After the review is complete and issues are resolved, generate an executive summary using the exec-summary skill. Save it to the feature folder as `executive-summary.md`.

## Guidelines

- **Be specific.** Cite exact requirements that have issues.
- **Reference real context.** Check personas, competitors, and existing features.
- **Don't do the dev's job.** The engineering lens is about PM-side clarity, not architecture.
- **Praise what's good.** Helps the PM know what to keep doing.

© mvschwarz · Apache-2.0 · mvschwarz/openrig

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

Все скиллы по теме «Тексты и документация» →
grill-with-docs Matt Pocock Скилл проводит жёсткое интервью по плану или дизайну и по ходу создаёт ADR и глоссарий. Подойдёт перед началом сложной разработки. 1 219 756установок skill-creator официальный anthropics Помогает создать новый скилл, доработать существующий и проверить результат через тестовые промпты и оценки. 414 180установок setup-matt-pocock-skills Matt Pocock Скилл настраивает репозиторий для инженерных скиллов Matt Pocock: задаёт трекер задач, метки триажа и расположение доменной документации. Запустите его перед первым использованием остальных скиллов. 1 052 851установок handoff Matt Pocock Собирает текущий диалог в документ передачи, чтобы другой агент продолжил работу с нужным контекстом. Нужен при смене сессии или исполнителя. 1 038 491установок triage Matt Pocock Скилл проводит issue и внешние PR через роли триажа, проверку и подготовку брифа для агента. Подойдёт мейнтейнеру, который разбирает очередь задач. 990 453установок domain-modeling Matt Pocock Скилл помогает уточнять термины проекта, вести GLOSSARY.md и фиксировать архитектурные решения в ADR. Нужен, когда модель предметной области меняется. 876 391установок

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

orchestration-team Скилл для оркестрации: раздаёт задания между агентами, следит за простаивающими и заблокированными и не даёт оркестратору делать работу за других. CX Codex +1 ★ 8 227звёзд репо development-team Организует разработку и тестирование внутри пода. Помогает агенту доводить задачу до готового кода с проверкой через открытые интерфейсы. CX Codex +1 ★ 8 227звёзд репо ui-mockup Скилл готовит ASCII-каркасы, HTML-макеты или живые прототипы интерфейсов. Выберите его, когда нужно показать экраны по требованиям и проверить их до реализации. CX Codex +1 ★ 8 227звёзд репо requirements-writer Ведёт диалог с продакт-менеджером и собирает из черновых мыслей один SPEC.md с проверяемыми критериями приёмки и явными границами. CX Codex +1 ★ 8 227звёзд репо office-hours Скилл проводит идею функции через шесть вопросов о спросе, текущем решении и минимальном объёме. Итог помогает решить, что делать дальше. CX Codex +1 ★ 8 227звёзд репо exec-summary Собирает из папки фичи один документ на 600–800 слов: питч для продаж, стратегию для руководства и поведение для разработки. CX Codex +1 ★ 8 227звёзд репо context-builder Собирает контекст по фиче из заметок встреч, конкурентного анализа и регуляторных требований. Создаёт файл background.md и обновляет общую базу знаний. CX Codex +1 ★ 8 227звёзд репо backlog-capture Собирает идеи, запросы и наблюдения в структурированный бэклог, проверяя новые записи на дубли. Пригодится после встреч, разговоров с клиентами и конкурентного анализа. CX Codex +1 ★ 8 227звёзд репо

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

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