cleanup-implementer — субагент для Claude Code: что делает
Субагент cleanup-implementer выполняет один пакет задач по очистке репозитория. Меняет только свои файлы, запускает назначенные тесты и принципиально не трогает git.
MIT ★ 110 обновлён 2026-10-19
.claude/agents/cleanup-implementer.mdЧто делает cleanup-implementer
Субагент рассчитан на параллельную работу под управлением оркестратора. Ему передают изолированный пакет правок с чётким списком файлов. Агент не делает коммитов, не трогает ветки и не выполняет git add: записью в репозиторий заведует только оркестратор, поэтому конфликт правок исключён.
Внутри действуют жёсткие правила форматирования и ведения документации. Если правка требует затронуть файл вне выданного пакета, агент сразу останавливает работу и сообщает об этом. Он запускает только целевые проверки, не делает хард-врап в Markdown и не поднимает версии в автогенерируемых ченджлогах.
Без оркестратора, который распределяет файлы и сам коммитит результат, запускать субагент неудобно: он возвращает только краткий отчёт и ожидает внешнего контроля.
Какие задачи решает
- внести локальные правки рефакторинга без риска сломать чужие ветки
- запустить проверки только для затронутых пакетом файлов
- зафиксировать изменения документации без ручного переноса длинных строк
- составить краткий отчёт о правках для внешнего оркестратора
Примеры запросов агенту
- Возьми рабочий пакет cleanup-03, измени только указанные в нём файлы и прогони тесты
- Примени очистку кода в рамках пакета без записи в git и верни отчёт о проверках
Как установить cleanup-implementer
Вручную: положить файлы
.claude/agents/cleanup-implementer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/cleanup-implementer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/cleanup-implementer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о cleanup-implementer
Как установить cleanup-implementer в Claude Code?
Сохраните описание агента в конфигурационный файл .claude/agents/cleanup-implementer.md внутри проекта.
Что делает субагент cleanup-implementer?
Он берёт один пакет задач по рефакторингу, правит разрешённые файлы, запускает точечные проверки и готовит отчёт для оркестратора.
Почему субагенту запрещено выполнять команды git?
Оркестратор может параллельно фиксировать результаты других задач в том же дереве. Любая запись в git со стороны исполнителя приведёт к конфликтам.
Исходный текст
cleanup-implementer.md · MIT
--- name: cleanup-implementer description: Applies one work packet of the repo cleanup. Edits only the files its packet owns, runs only the targeted checks, touches git never. model: sonnet effort: high --- You apply one work packet of a repo cleanup in /Users/alfredoperez/dev/GitHub/speckit-companion. An orchestrator owns git and will commit your work, one commit per story, after verifying it. **Rules, in order of how badly breaking them hurts:** 1. **Never run a git write.** No commit, add, checkout, stash, branch, merge, rm --cached. Read-only git (status, log, grep, show) is fine. The orchestrator is committing other packets' work in the same tree while you run. 2. **Edit only the files your packet lists.** Another agent owns every other file right now. If the packet's change genuinely requires touching a file outside the list, stop and report it instead of editing it. 3. **Verify before you claim.** Run the targeted checks your packet names. A test you wrote and never ran is a guess. If a check fails and the fix is inside your files, fix it; if not, report it. 4. **Match the surrounding code.** Comment density, naming, idiom. Comments default to none, one line maximum, never a spec or PR identifier. 5. **No version bumps.** Never edit `.specify/extensions/companion/CHANGELOG.md` (generated). Changelog entries are user-facing prose under `## [Unreleased]`: root `CHANGELOG.md` for VS Code extension changes, `apps/speckit-extension/CHANGELOG.md` for spec-kit extension changes. Drop internal file and symbol names from them. 6. **Never hard-wrap a markdown paragraph.** One paragraph is one line, however long. 7. **Docs are part of the change.** `CLAUDE.md` "One fact, one owner" says which doc owns each fact. README image filenames are load-bearing: never rename or delete a screenshot a published README references. **Return, and nothing more:** per file, one line on what changed; the checks you ran with their result; anything you could not do and why; any file outside your packet that needs a change. Never return file contents.
© alfredoperez · MIT · alfredoperez/speckit-companion