# first-principles-review

Скилл first-principles-review для Claude Code проверяет продуктовые идеи, PRD и архитектуру от первых принципов. Он запускается только по прямому запросу с названием скилла и создаёт локальный отчёт с передачей для написания PRD.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 869 у репозитория
- Автор: sno-ai
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sno-ai/sno-station-skills/tree/HEAD/plugins/sno-station-standalone/skills/first-principles-review/SKILL.md
- Обновлён: 2026-11-16
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/sno-ai-first-principles-review

## Что делает

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

Для проверки запускаются два скрипта из `scripts`: `validate-report.py` и `extract-prd-handoff.py`. Оба требуют `python3`. Нужны доступ к оболочке и чтение и запись файлов; входной файл скилл не меняет. Имя отчёта по умолчанию — `reports/<input-stem>-first-principles-review.md`; если такой файл уже есть, выбирается другое имя. Скилл работает только после явного вызова или упоминания в запросе.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sno-ai/sno-station-skills --skill first-principles-review -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sno-ai/sno-station-skills --skill first-principles-review -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sno-ai/sno-station-skills --skill first-principles-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install sno-ai/sno-station-skills plugins/sno-station-standalone/skills/first-principles-review
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add sno-ai/sno-station-skills --skill first-principles-review -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/sno-ai/sno-station-skills --path plugins/sno-station-standalone/skills/first-principles-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add sno-ai/sno-station-skills --skill first-principles-review -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sno-ai/sno-station-skills/tree/HEAD/plugins/sno-station-standalone/skills/first-principles-review/SKILL.md

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

## Примеры запросов агенту
- Проведи `$first-principles-review` для идеи из `proposal.md` и создай отчёт.
- Запусти `/first-principles-review` для архитектуры в `design.md`; сравни её с текущим решением.
- Выполни `first-principles-review` для PRD и подготовь передачу автору требований.

## Похожие
- [thinking-first-principles](https://affpapa.org/nevibecode/skills/thinking-first-principles.md) — скилл · 844 установки
- [principle-redesign-from-first-principles](https://affpapa.org/nevibecode/skills/principle-redesign-from-first-principles.md) — скилл · 10200 установок
- [first-principles-thinking](https://affpapa.org/nevibecode/agents/first-principles-thinking.md) — субагент · ★ 26718 у репозитория
- [first-principles](https://affpapa.org/nevibecode/commands/first-principles.md) — команда · ★ 1988 у репозитория
- [design-principles](https://affpapa.org/nevibecode/rules/design-principles.md) — правило · ★ 3774 у репозитория
- [spec-driven-development](https://affpapa.org/nevibecode/skills/spec-driven-development.md) — скилл · 81900 установок

## Другие версии с тем же именем
- [first-principles-review · ganyuanran](https://affpapa.org/nevibecode/skills/first-principles-review.md) — ★ 1450 у репозитория

Из того же набора: [sno-ai/sno-station-skills](https://affpapa.org/nevibecode/by/sno-ai/sno-station-skills.md) — 40 карточек

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

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