steelmorgan/agent-context

Протокол контекста агента (процедура)

Каждый агент — и оркестратор, и сабагенты — MUST сохранять контекст перед завершением и MUST читать его при старте. Оркестратор ведёт orchestrator-context.md, сабагенты — {role}-context.md. Этот навык — детальная процедура; инвариант-триггер «старт читай / выход пиши» зафиксирован в правиле framework/rules/agent-context-protocol/SKILL.md.

Язык документов

Все артефакты задачи MUST быть на русском языке: спецификации, тех. дизайн, контексты агентов, отчёты, комментарии в .feature-файлах, final-report.md. Исключение — идентификаторы кода (имена переменных, модулей, метаданных) остаются как есть.

Расположение контекстов

Все контекстные файлы агентов хранятся в подкаталоге .context/ внутри task_dir:

task_dir/.context/{role}-context.md

Агент MUST создать каталог .context/, если он ещё не существует (mkdir -p).

Первый шаг при старте

Каждый агент (оркестратор и сабагенты) MUST как первый шаг: проверить task_dir/.context/{role}-context.md, прочитать его и продолжить работу, не повторяя выполненные шаги.

| Агент | Файл контекста | |-------|----------------| | orchestrator | orchestrator-context.md | | analyst | analyst-context.md | | architect | architect-context.md | | scenario-author | scenario-author-context.md | | developer-tests | developer-tests-context.md | | developer-code | developer-code-context.md | | tester | tester-context.md | | reviewer | reviewer-context-{scope}.md |

Последний шаг перед завершением

Каждый агент (оркестратор и сабагенты) MUST записать task_dir/.context/{role}-context.md перед любым завершением: completed, clarification_needed, implementation_error.

Структура файла контекста

# {Role} Context

## Status
{completed | clarification_needed | implementation_error}

## Completed Steps
- {файлы, инструменты, артефакты — достаточно чтобы не повторять работу}

## Findings
- {модули, паттерны, структуры данных, зависимости}

## Assumptions
- {допущения при неопределённости}

## Pending Questions
- {только при clarification_needed, все вопросы одним блоком}

## User Answers
- {заполняет оркестратор}

Что НЕ включать

• Полное содержимое файлов — только выводы и пути
• Промежуточные рассуждения — только финальные находки
• Информацию из других артефактов task_dir

Механизм resume

{role}-context.md — основной механизм. resume agentId — оптимизация в рамках одной сессии. При resume контекст-файл всё равно MUST быть записан.

Экономия контекста через делегирование

Контекстное окно агента — ограниченный ресурс. Тяжёлые операции поиска и анализа кода SHOULD быть делегированы сабагентам, а не выполняться вручную через последовательные Read/Grep.

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

Когда делегировать

| Ситуация | Действие | |----------|----------| | Нужно найти все вхождения паттерна в проекте | Запустить Explore-агента с конкретным вопросом | | Нужно понять структуру модуля (500+ строк) | Запустить Explore-агента: «перечисли экспортные функции и их назначение» | | Нужно проверить граф вызовов | Запустить explorer-агента с задачей на call_graph | | Нужно независимое мнение по куску кода | Запустить reviewer-агента с узким scope | | Простой поиск (1-2 grep по известному паттерну) | Выполнить самостоятельно — делегирование дороже |

Как делегировать

Agent(subagent_type="Explore", prompt="В модуле <путь> найди все вызовы <функция> и верни список: файл:строка → контекст вызова")

MUST: формулировать задачу конкретно — что искать, где искать, в каком формате вернуть результат.

MUST NOT: делегировать тривиальные операции (чтение одного файла, один grep) — накладные расходы на запуск агента превышают экономию.

Кто может делегировать

Все агенты с доступом к инструменту Agent (developer-code, reviewer, tester, architect, analyst, explorer, scenario-author, developer-tests). Агенты Explore и Plan НЕ могут запускать сабагентов.

---

depends_on: []