five-whys — правило для Claude Code: установка
Правило five-whys проводит разбор первопричины через пять вопросов «почему». Подходит для поиска системной причины сбоя, а не только его симптома.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает five-whys
five-whys задаёт последовательность из четырёх этапов: формулировка проблемы, пять вопросов «почему», проверка корневой причины и разработка решений. Claude Code помогает выстроить логическую цепочку от симптома к причине, проверить, предотвратит ли её устранение повторение проблемы, и учесть несколько причин, если они есть.
Правило предлагает искать сбои в процессах и системе, а не назначать виноватых. В разбор стоит вовлекать заинтересованных участников, документировать ход анализа и проверять решения на уровне первопричины. Для команды это означает: если цепочка «почему» не объясняет, как исправление предотвратит повторение, причина ещё не подтверждена.
После установки файл правила находится в .claude/rules/five-whys.md. Оно не запускается отдельной слэш-командой: попросите Claude Code разобрать проблему по методу пяти вопросов.
Какие задачи решает
- найти первопричину сбоя в приложении
- отделить симптом от причины проблемы
- проверить логическую цепочку причин
- сформировать меры, предотвращающие повторение
- документировать анализ проблемы
Примеры запросов агенту
- Разбери падение приложения по правилу пяти вопросов «почему» и сначала сформулируй проблему.
- Проверь, действительно ли найденная причина предотвращает повторение сбоя.
- Проанализируй проблему по
five-whys, учитывая возможные системные причины.
Как установить five-whys
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineering2Вручную: положить файлы
.claude/rules/five-whys.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/five-whys.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/five-whys.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/five-whys.mdВручную: положить файлы
.clinerules/five-whys.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о five-whys
Как установить five-whys в Claude Code?
Выполните /plugin marketplace add johnrogers/claude-swift-engineering, затем /plugin install swift-engineering@claude-swift-engineering. Файл правила находится в .claude/rules/five-whys.md.
Что делает five-whys?
Правило ведёт Claude Code через пять последовательных вопросов «почему», затем предлагает проверить первопричину и разработать меры против повторения проблемы.
Как правило проверяет найденную причину?
Оно предлагает проверить логическую цепочку и выяснить, предотвращает ли устранение причины повторение проблемы. При необходимости учитываются несколько первопричин.
Исходный текст
five-whys.md · MIT
## Five Whys Analysis Use the "Five Whys" root cause analysis technique to deeply understand problems. ### Process: #### 1. Define the Problem Clearly state the issue or symptom #### 2. Ask "Why?" Five Times - Why did this problem occur? → Answer 1 - Why did Answer 1 happen? → Answer 2 - Why did Answer 2 happen? → Answer 3 - Why did Answer 3 happen? → Answer 4 - Why did Answer 4 happen? → Answer 5 (Root Cause) #### 3. Validate Root Cause - Verify the logical chain - Check if addressing root cause prevents recurrence - Consider multiple root causes if applicable #### 4. Develop Solutions - Address the root cause, not just symptoms - Create preventive measures - Consider systemic improvements ### Example: **Problem**: Application crashes when processing large files 1. **Why?** → The application runs out of memory 2. **Why?** → It loads entire file into memory at once 3. **Why?** → The file parser wasn't designed for streaming 4. **Why?** → Initial requirements only specified small files 5. **Why?** → Requirements gathering didn't consider future growth **Root Cause**: Incomplete requirements gathering process **Solution**: Implement streaming parser and improve requirements process ### Best Practices: - Focus on process, not people - Look for systemic issues - Document the analysis - Involve relevant stakeholders - Test solutions address root cause
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering