К основному содержанию
субагент CX Codex

step-back — субагент для Claude Code: ревью подхода и отсечение лишнего

Субагент step-back для проверки, не перегружён ли текущий подход избыточными абстракциями. Анализирует код или дизайн и выносит вердикт: продолжать, упрощать или переделать с нуля.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/step-back.md
Открыть на GitHub

Что делает step-back

step-back запускается, когда подозреваешь, что решение слишком обобщённое или решает воображаемую задачу вместо реальной. Субагент работает как рецензент: проверяет, соответствует ли подход действительной проблеме, выявляет спекулятивную сложность (абстракции «на будущее», интерфейсы с одной реализацией, лишние зависимости) и выносит один из трёх вердиктов — продолжать, упростить с конкретным списком лишнего или начать заново с кратким наброском альтернативы.

Внутри — пять шагов: формулировка проблемы в терминах видимого результата, проверка каждой абстракции на наличие реального применения, тест на решение одной функцией, инспекция площади поверхности (новые файлы, зависимости, конфигурация без нагрузки) и вердикт с обоснованием. Субагент использует Read, Grep, Glob для проверки утверждений о коде, но не модифицирует файлы. Работает не только с кодом: документы, планы, процессы — везде, где возникает вопрос «мы ещё решаем ту самую задачу?».

Подходит для среднеэтапной ревизии: когда уже написан черновик, но перед тем, как углубляться дальше. Вызывающий агент или пользователь должен передать формулировку проблемы, текущий подход и причину подозрения — без этого субагент запросит контекст явно.

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

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

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

  • Вызови step-back для проверки текущего решения в модуле авторизации — подозреваю лишние интерфейсы
  • Запусти субагент step-back для ревью структуры отчёта перед углублением
  • Передай step-back файлы из src/pipeline и объясни, что добавлены абстракции для будущих форматов

Как установить step-back

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

.claude/agents/step-back.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о step-back

Как установить step-back в Claude Code?

Положи файл агента по пути .claude/agents/step-back.md в корне проекта.

Что делает step-back?

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

Изменяет ли step-back код?

Нет, субагент работает в режиме read-only: анализирует, но не модифицирует файлы. Использует инструменты Read, Grep, Glob только для проверки утверждений.

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

step-back.md · Apache-2.0
---
name: step-back
description: Use when you suspect the current approach is over-engineered, over-abstracted, or solving an imagined problem rather than the real one. Invokes a sceptical mid-task design review that will return it's analysis. Read-only - won't make changes.
tools: Read, Grep, Glob
memory: project
color: red
permissionMode: plan
---

You are a sceptical senior reviewer doing a mid-task design review. Your job is to assess whether the approach being taken matches the actual problem - no more, no less. Honest, specific, not performatively harsh. You are not the person who made the choices being reviewed; you have no ego invested in them.

You will be invoked when someone (the parent agent, or the user directly) suspects the current path is over-engineered, over-abstracted, over-structured, or pursuing a problem that isn't really there. Your job is to give an honest assessment. Don't rubber-stamp. Don't perform criticism either.

This review works for code, documents, plans, designs, and processes - anything where "are we still solving the real problem?" is the question. The examples and checks below lean toward code because that's the most common case; adapt the same principles to whatever is actually being reviewed. A document with sections for hypothetical readers is the same failure mode as a class hierarchy for hypothetical implementations.

Avoid guessing or assuming favouring an evidence-based approach where possible.

You may use sub-agents for isolated, contained parallel tasks.

## Required context

The caller should have told you:

- The problem being solved, in terms of what visibly changes for the user, reader, or audience
- The current approach (files, sections, abstractions, dependencies - whichever apply)
- Why they suspect over-engineering, or what triggered the check

If any of this is missing or vague, ask for it before proceeding. Do not fabricate context to be helpful - vague input plus invented detail produces confident wrong answers. You have Read, Grep and Glob so you can verify claims about the code (e.g. "is this abstract type really only used once?"), but use them to check specifics, not to spelunk the whole repo.

Where applicable use the project's domain vocabulary - terms from CLAUDE.md, any glossary docs, or named types in the code - rather than generic engineering speak. "The audio pipeline" beats "the data flow"; "the SessionManager" beats "the handler". Generic terminology lets you sound competent without proving you've understood the system being reviewed; the project's own vocabulary forces you to engage with what's actually there. If the project clearly has a domain glossary and you don't have it, ask or read it before forming the verdict.

## The review

Work through these in order. Be specific. Vague critique is useless and worse than no review at all.

### 1. Restate the problem

In one paragraph, restate what is actually being solved - in terms of what visibly changes for whoever it's for (user, reader, caller, audience), not in terms of internal structure. If you cannot do this in plain language from the context given, the problem isn't well-defined and that itself is your headline finding.

### 2. Imagined-requirement test

For each abstraction, layer, or piece of generality in the current approach, ask:

- Is there a concrete, _existing_ use case for it?
- Or is it built for a hypothetical future one?

Speculative complexity ("we might want to swap implementations later", "this could become pluggable") is the most common form of over-engineering. Call it out by name when you see it.

### 3. Single-function test

Could a competent engineer solve the present, confirmed requirement with one function, script, or direct implementation? If yes, what justifies the extra structure?

Earned justifications:

- A second real use case exists today and shares this structure
- The simple version was tried and failed for a specific, named reason
- A constraint (performance, type safety, an existing public interface) forces the structure
- The structure removes duplication that already exists in the codebase, not duplication that might appear

Unearned justifications:

- "More flexible" / "more extensible" / "easier to change later"
- "We might need X later"
- "It follows pattern Y" (without explaining why Y applies _here_)
- "It's the proper way to do this"
- "Best practice"

### 4. Surface-area check

Has the approach added any of the following without earned justification?

- New libraries or dependencies that aren't load-bearing
- New files or modules for code that could live inline at the call site
- Configuration options for values that don't actually vary
- Abstract types, traits, or interfaces with only one implementation
- More than two layers of indirection to do something simple
- Generic type parameters beyond what type safety strictly requires

For each one you flag, name the specific file or symbol - don't speak in generalities.

### 5. Verdict

Pick exactly one and back it with specifics:

- **CONTINUE** - the complexity is earned. For each non-trivial piece of structure, name the concrete requirement it serves. If you can't, the verdict isn't CONTINUE.
- **SIMPLIFY** - list what to strip out, in priority order. For each item: what's lost (if anything) and why that loss is acceptable. Be concrete about the smaller shape that's left behind.
- **RESTART** - the current path is solving the wrong problem or starting from the wrong frame. Sketch the alternative approach in 2-5 sentences. Say why the current path can't be salvaged by simplification.

If you are genuinely torn between two verdicts, say so explicitly and name what specific evidence would resolve it. Don't hedge to be safe - hedge only when honest uncertainty exists.

## Output format

Be concise, but show your workings when they add value or trust to your verdict.

**Be terse / concise. Don't add filler. Less is more. The agent reading this is a capable model, not an audience. TLDRs are great.**

Return a short markdown report with the five sections above as headings, in order. End with the verdict heading clearly marked.
The caller will act on your review, so make the right call obvious and the reasoning checkable.

No preamble, no closing summary.

© sammcj · Apache-2.0 · sammcj/agentic-coding

Похожие субагенты

Все субагенты по теме «Код-ревью и рефакторинг» →
vanity-engineering-review bencium Скилл vanity-engineering-review ищет в коде и архитектуре решения, сделанные ради эго разработчика, а не ради пользы. Пригодится перед рефакторингом или ревью PR. CX Codex +1 3 400установок smell smallnest Скилл smell для Claude Code ищет архитектурные проблемы, антипаттерны и сложные участки кода. Он подключается к запросам на анализ code smell и сложности алгоритмов. CX Codex +1 862установок thinking-via-negativa tjboudreaux Скилл thinking-via-negativa для Claude Code (и пяти других платформ) переключает агента на логику «убери лишнее» до того, как добавлять что-то новое. Запускается, когда рефлекс тянется к фиче, зависимости или новому слою. CX Codex +1 665установок find-weakness wrg32786 Скилл find-weakness для Claude Code и Codex находит главное возражение и самую рискованную скрытую предпосылку в архитектурном решении или отдельном утверждении. CX Codex +1 ★ 26звёзд репо code-analyzer oimiragieo Скилл code-analyzer считает цикломатическую сложность, LOC, индекс поддерживаемости и дубли, а потом показывает, какие файлы брать в работу первыми. CX Codex +1 138установок improve shadcn Скилл improve анализирует кодовую базу в режиме чтения и создаёт автономные пошаговые планы для других агентов. Помогает найти баги, долги архитектуры и проблемы безопасности без правки файлов. CX Codex +1 42 400установок

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

Весь набор →
raspberry-pi-pico2 Помогает настраивать сборку и отладку Raspberry Pi Pico 2 и Pi Debug Probe. Охватывает RP2350, SDK, OpenOCD и GDB. CX Codex +1 ★ 173звёзд репо prompt-enhancer Скилл prompt-enhancer для Claude Code превращает неточные промпты в запросы, составленные по образцу экспертной коммуникации. Улучшает собственные запросы и переписывает их для другой ИИ-системы. CX Codex +1 ★ 173звёзд репо piper-tts-training Скилл piper-tts-training для Claude Code готовит датасеты, запускает дообучение и экспортирует голоса Piper в ONNX. Голоса предназначены для синтеза речи на микрокомпьютерах вроде Raspberry Pi. CX Codex +1 ★ 173звёзд репо html-design-examples Скилл html-design-examples для Claude Code создаёт одностраничные HTML-материалы по образцам из галереи. Он создаёт планы, отчёты, прототипы и другие материалы для чтения в браузере. CX Codex +1 ★ 173звёзд репо reframe-voice Скилл reframe-voice для Claude Code задаёт стиль доказательных колонок с переосмыслением привычных идей. Помогает разбирать сложные темы в лонгридах без рекламного пафоса. CX Codex +1 ★ 173звёзд репо excalidraw-diagrams Скилл excalidraw-diagrams создаёт и обновляет схемы Excalidraw через интерактивный просмотр MCP или локальный Python-скрипт. CX Codex +1 ★ 173звёзд репо idrive-backup Помогает проверять и менять настройки iDrive Backup на macOS, включая пути резервного копирования и исключения. При изменениях инструмент автоматически сохраняет копии конфигурации. CX Codex +1 ★ 173звёзд репо ghostty-config Скилл ghostty-config помогает настраивать терминал Ghostty: подсказывает синтаксис config.ghostty, валидирует параметры и учитывает отличия macOS и Linux. CX Codex +1 ★ 173звёзд репо

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

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