Agent Workflow
Навык про то, как вести работу с агентом, а не про содержимое кода. Пять
режимов — стадии одного цикла: решить → разбить → сформулировать → провести
сессию → отрефлексировать.
Шаг 0. Выбери режим
| Режим |
Вопрос пользователя |
Куда дальше |
| delegate |
«сам или агент», «какой режим/модель», «почему агент справился плохо» |
references/delegation.md |
| decompose |
«разбей задачу», «слишком большая», «с чего начать фичу» |
references/decomposition.md |
| prompt |
«улучши промт», «сформулируй задачу для агента» |
references/prompt-craft.md |
| context |
«новая сессия или продолжаем», «ты забыл», «что положить в CLAUDE.md» |
references/context.md |
| audit |
«проверь себя», «что устарело», «какие ошибки повторяешь» |
references/self-audit.md |
Режимы часто идут подряд: крупная задача — это обычно delegate → decompose →
prompt. Не гони через все пять, если спрошено про один; но если выбранный режим
явно не тот (просят «улучши промт» на задаче, которая не влезет в один заход) —
скажи об этом и предложи начать с decompose.
Сквозные принципы
Размер куска решает больше, чем формулировка. Самая частая причина плохой
работы агента — не «плохой промт», а кусок, который не проходит тест одного
захода. Проверь размер прежде, чем полировать текст.
Разведка отделена от изменений. Агент, который одновременно изучает и
правит, изучает плохо и правит наугад. Разведку — отдельным куском, лучше
сабагентом: в основной контекст вернётся вывод, а не двадцать прочитанных файлов.
Что должно пережить сессию — пишется в файл. План, решения, найденные
факты. Договорённость, живущая только в диалоге, исчезает при компактификации.
Контекст — исчерпаемый ресурс. Всё, что лежит в нём постоянно (CLAUDE.md,
описания навыков), стоит токенов в каждой сессии. Клади туда только то, что
модель не выведет сама из структуры проекта.
Требования — не делегируются. Агенту можно поручить уточнение требований
вопросами, но не выбор за пользователя. «Сделай как лучше» даёт среднее
по интернету.
Границы навыка
session-catchup — возобновить прерванную работу (восстановление, а не рефлексия).harness-engineering — построить обвязку проекта: Makefile, CI, ARCHITECTURE.md, DoD.spec-writer — документ-план с фазами, оценками и рисками (decompose даёт рабочий
список кусков, а не документ).goal-pipeline / ratchet-loop — автономное исполнение фаз и оптимизация метрики.change-review — второе мнение о полученном коде.
Справочники
- references/delegation.md — карта сильных и слабых
сторон LLM, матрица делегируемости, выбор режима и модели, анти-паттерны,
таблица «агент справился плохо → причина → чем чинить».
- references/decomposition.md — тест одного
захода, порядок разрезания, карточка куска, правила очерёдности, исполнение.
- references/prompt-craft.md — пять принципов,
шаблон структуры, чек-лист самопроверки, адаптация под язык и тип задачи.
- references/prompt-examples.md — два полных
примера трансформации сырого описания в промт.
- references/context.md — диагностика деградации,
«продолжать или новая», разгрузка контекста, слои постоянного знания,
чек-лист CLAUDE.md.
- references/self-audit.md — режимы аудита,
сканирование, пять блоков разбора, формат отчёта, автоприменение.
1---2name: agent-workflow3description: Работа с самим агентом, а не с кодом — пять режимов одного цикла: delegate (сам или поручить, каким режимом и моделью), decompose (разбить крупную задачу на куски размером в один заход), prompt (из разговорного описания в однозначное задание), context (сессия деградировала: продолжать или начать новую, что вынести в файлы, что положить в CLAUDE.md), audit (ретроспектива: какие ошибки агент повторяет, что в документации протухло). Используй когда пользователь спрашивает «продолжим здесь или рекомендуешь новую сессию», «суммаризация убила весь контекст сессии», «сам или агент», «разбей задачу», «подготовь промт для ИИ агента», «что положить в CLAUDE.md», «проверь себя». Возобновить прерванную работу — session-catchup; обвязка проекта — harness-engineering.4---56# Agent Workflow78Навык про то, **как вести работу с агентом**, а не про содержимое кода. Пять9режимов — стадии одного цикла: решить → разбить → сформулировать → провести10сессию → отрефлексировать.1112## Шаг 0. Выбери режим1314| Режим | Вопрос пользователя | Куда дальше |15|---|---|---|16| **delegate** | «сам или агент», «какой режим/модель», «почему агент справился плохо» | [references/delegation.md](references/delegation.md) |17| **decompose** | «разбей задачу», «слишком большая», «с чего начать фичу» | [references/decomposition.md](references/decomposition.md) |18| **prompt** | «улучши промт», «сформулируй задачу для агента» | [references/prompt-craft.md](references/prompt-craft.md) |19| **context** | «новая сессия или продолжаем», «ты забыл», «что положить в CLAUDE.md» | [references/context.md](references/context.md) |20| **audit** | «проверь себя», «что устарело», «какие ошибки повторяешь» | [references/self-audit.md](references/self-audit.md) |2122Режимы часто идут подряд: крупная задача — это обычно delegate → decompose →23prompt. Не гони через все пять, если спрошено про один; но если выбранный режим24явно не тот (просят «улучши промт» на задаче, которая не влезет в один заход) —25скажи об этом и предложи начать с decompose.2627## Сквозные принципы2829**Размер куска решает больше, чем формулировка.** Самая частая причина плохой30работы агента — не «плохой промт», а кусок, который не проходит тест одного31захода. Проверь размер прежде, чем полировать текст.3233**Разведка отделена от изменений.** Агент, который одновременно изучает и34правит, изучает плохо и правит наугад. Разведку — отдельным куском, лучше35сабагентом: в основной контекст вернётся вывод, а не двадцать прочитанных файлов.3637**Что должно пережить сессию — пишется в файл.** План, решения, найденные38факты. Договорённость, живущая только в диалоге, исчезает при компактификации.3940**Контекст — исчерпаемый ресурс.** Всё, что лежит в нём постоянно (CLAUDE.md,41описания навыков), стоит токенов в каждой сессии. Клади туда только то, что42модель не выведет сама из структуры проекта.4344**Требования — не делегируются.** Агенту можно поручить *уточнение* требований45вопросами, но не *выбор* за пользователя. «Сделай как лучше» даёт среднее46по интернету.4748## Границы навыка4950- `session-catchup` — возобновить прерванную работу (восстановление, а не рефлексия).51- `harness-engineering` — построить обвязку проекта: Makefile, CI, ARCHITECTURE.md, DoD.52- `spec-writer` — документ-план с фазами, оценками и рисками (decompose даёт рабочий53 список кусков, а не документ).54- `goal-pipeline` / `ratchet-loop` — автономное исполнение фаз и оптимизация метрики.55- `change-review` — второе мнение о полученном коде.5657## Справочники5859- [references/delegation.md](references/delegation.md) — карта сильных и слабых60 сторон LLM, матрица делегируемости, выбор режима и модели, анти-паттерны,61 таблица «агент справился плохо → причина → чем чинить».62- [references/decomposition.md](references/decomposition.md) — тест одного63 захода, порядок разрезания, карточка куска, правила очерёдности, исполнение.64- [references/prompt-craft.md](references/prompt-craft.md) — пять принципов,65 шаблон структуры, чек-лист самопроверки, адаптация под язык и тип задачи.66- [references/prompt-examples.md](references/prompt-examples.md) — два полных67 примера трансформации сырого описания в промт.68- [references/context.md](references/context.md) — диагностика деградации,69 «продолжать или новая», разгрузка контекста, слои постоянного знания,70 чек-лист CLAUDE.md.71- [references/self-audit.md](references/self-audit.md) — режимы аудита,72 сканирование, пять блоков разбора, формат отчёта, автоприменение.
goldenprofile