version: "1.0.2" name: agent-context description: MUST use WHEN агент стартует или завершает работу. Provides процедуру ведения {role}-context.md (расположение, структура файла, таблица имён, механизм resume, экономия контекста через делегирование). alwaysApply: false

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

Каждый агент — и оркестратор, и сабагенты — 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, прочитать его и продолжить работу, не повторяя выполненные шаги.

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

Каждый агент (оркестратор и сабагенты) 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.

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

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

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

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: []