explanatory-output-style — плагин для Claude Code: объясняет решения
Добавляет в каждую сессию короткие пояснения о том, почему код написан именно так и какие в проекте есть паттерны.
/plugin install explanatory-output-style@claude-plugins-official
/plugin marketplace add anthropics/claude-plugins-officialЧто делает explanatory-output-style
Плагин возвращает поведение удалённого стиля вывода Explanatory, только теперь через хук SessionStart. При старте сессии хук подкладывает в контекст инструкции: перед написанием кода и после него Claude даёт 2–3 коротких замечания об образовательной стороне решения. Оформляются они блоком с рамкой и звёздочкой.
Пояснения касаются конкретики вашей кодовой базы: выбранных подходов, принятых соглашений, компромиссов в дизайне. Общих лекций про программирование там не будет. Настраивать после установки ничего не нужно, плагин включается сам в начале каждой сессии.
Главное, что стоит взвесить заранее: дополнительные инструкции и вывод съедают токены. Автор прямо предупреждает — не ставьте плагин, если не готовы платить эту цену. Ещё момент: стили вывода, которые касаются не разработки, лучше делать субагентами, потому что субагент меняет системный промпт, а SessionStart-хук только дополняет его.
Какие задачи решает
- понять, почему в проекте выбран именно такой подход
- разобраться в незнакомых соглашениях чужой кодовой базы
- получать пояснения к коду прямо во время работы, а не после ревью
- восстановить поведение удалённого стиля Explanatory
- учиться на собственных решениях в проекте
Примеры запросов агенту
- объясни, почему здесь выбран этот паттерн
- добавь инсайты по ходу правки этого модуля
- покажи компромиссы такого решения в нашем коде
Как установить explanatory-output-style
Через маркетплейс плагинов
/plugin install explanatory-output-style@claude-plugins-official/plugin marketplace add anthropics/claude-plugins-officialПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о explanatory-output-style
Как установить explanatory-output-style в Claude?
Сначала добавьте маркетплейс: /plugin marketplace add anthropics/claude-plugins-official, затем установите плагин: /plugin install explanatory-output-style@claude-plugins-official.
Что делает explanatory-output-style?
Через хук SessionStart добавляет в начало каждой сессии инструкции, по которым Claude даёт короткие пояснения об устройстве кода и принятых решениях.
Чем это отличается от стиля Explanatory?
Тот стиль вывода устарел. Плагин воспроизводит его поведение хуком SessionStart, а такой хук можно распространять через плагины.
Исходный текст
explanatory-output-style · Apache-2.0
# Explanatory Output Style Plugin
This plugin recreates the deprecated Explanatory output style as a SessionStart
hook.
WARNING: Do not install this plugin unless you are fine with incurring the token
cost of this plugin's additional instructions and output.
## What it does
When enabled, this plugin automatically adds instructions at the start of each
session that encourage Claude to:
1. Provide educational insights about implementation choices
2. Explain codebase patterns and decisions
3. Balance task completion with learning opportunities
## How it works
The plugin uses a SessionStart hook to inject additional context into every
session. This context instructs Claude to provide brief educational explanations
before and after writing code, formatted as:
```
`★ Insight ─────────────────────────────────────`
[2-3 key educational points]
`─────────────────────────────────────────────────`
```
## Usage
Once installed, the plugin activates automatically at the start of every
session. No additional configuration is needed.
The insights focus on:
- Specific implementation choices for your codebase
- Patterns and conventions in your code
- Trade-offs and design decisions
- Codebase-specific details rather than general programming concepts
## Migration from Output Styles
This plugin replaces the deprecated "Explanatory" output style setting. If you
previously used:
```json
{
"outputStyle": "Explanatory"
}
```
You can now achieve the same behavior by installing this plugin instead.
More generally, this SessionStart hook pattern is roughly equivalent to
CLAUDE.md, but it is more flexible and allows for distribution through plugins.
Note: Output styles that involve tasks besides software development, are better
expressed as
[subagents](https://docs.claude.com/en/docs/claude-code/sub-agents), not as
SessionStart hooks. Subagents change the system prompt while SessionStart hooks
add to the default system prompt.
## Managing changes
- Disable the plugin - keep the code installed on your device
- Uninstall the plugin - remove the code from your device
- Update the plugin - create a local copy of this plugin to personalize this
plugin
- Hint: Ask Claude to read
https://docs.claude.com/en/docs/claude-code/plugins.md and set it up for
you!
© Anthropic · Apache-2.0 · anthropics/claude-plugins-official
