rustams/inbound-agent-system

Inbound Agent System

Проект Inbound Marketing — приложение Битрикс24: синхронизация редакции, публикация контента на площадки, сбор аналитики, путь контакта от статьи до сделки.

Мета-скилл, объединяющий память, контекст, мультиагентность, оценку и жизненный цикл проекта в одну согласованную систему.

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

• Запуск нового чата с агентом и нужно быстро привести контекст в порядок.
• Координация работы «команды» (исследование → разработка → оценка).
• Раздувание контекста, забывание целей или изменённых файлов.
• Введение системы оценки качества ответов или пайплайнов.
• Планирование проекта от идеи до деплоя с участием агентов.

Компоненты системы

1. Память (filesystem + memory-systems)

| Слой | Путь | Назначение | |------|------|------------| | Рабочая | контекст чата | Текущий план, последние решения, активные артефакты | | Краткосрочная | .cursor/agent/scratch/ | Крупные выводы инструментов, логи; не держать в контексте | | Долгосрочная | .cursor/agent/memory/ | preferences, facts, entities — между сессиями | | Планы | .cursor/agent/plans/ | current_plan.yaml, чеклисты; перечитывать при смене задачи |

Правило: загружать в контекст по запросу (just-in-time), не держать всю память в окне.

2. Контекст (context-fundamentals, context-optimization, context-compression, context-degradation)

• Бюджет: целевое использование контекста до 70–80%; при превышении — компрессия или маскирование.
• Размещение: важное — в начале и конце; детали и длинные тексты — в середине или в файлах со ссылкой.
• Компрессия: структурированная сводка (Session Intent, Files Modified, Decisions, Current State, Next Steps) в .cursor/agent/summaries/; anchored iterative (добавлять к существующей сводке).
• Деградация: не полагаться на «середину» длинного контекста; при отравлении или противоречиях — откат к сводке или чистому контексту.

Подробно: правила в .cursor/rules/context-optimization.mdc.

3. Мультиагентность (multi-agent-patterns, filesystem-context)

• Роли: Coordinator, Researcher, Developer, Evaluator. Работа как одна команда с изоляцией контекста через файлы.
• Handoff: под-роли пишут выводы в .cursor/agent/agents/<role>/; координатор читает файлы, не пересказывает в своём контексте.
• Git / PR: по умолчанию Developer не открывает PR; координатор владеет push ветки (если нужно), созданием PR и описанием — см. docs/WORKFLOW.md §3.5.
• План и общее состояние — в .cursor/agent/plans/ и .cursor/agent/memory/.

Подробно: .cursor/rules/multi-agent-handoffs.mdc.

4. Инструменты и правила (tool-design)

• Минимизировать дублирование: один инструмент на рабочий поток, где возможно.
• Крупные ответы — в scratch, в контекст возвращать выжимку и путь.
• Имена инструментов и параметры — единообразные (verb-noun, явные описания).

5. Оценка (evaluation, advanced-evaluation)

• Рубрики и кейсы: .cursor/agent/evaluation/rubrics/, .cursor/agent/evaluation/cases/.
• Результаты прогонов: .cursor/agent/evaluation/runs/ (при необходимости не коммитить).
• LLM-as-judge: чёткие критерии, шкала, структурированный вывод; при сравнении — pairwise с митигацией position/length bias.

6. Ведение проекта (project-development)

• Этапы: acquire → prepare → process → parse → render; состояние пайплайна — в файловой системе.
• Task–model fit: проверять вручную на одном примере перед автоматизацией.
• Agent-assisted development: чёткие требования, разбиение на компоненты, итерация по сбоям.

Быстрый чеклист для нового чата

1. Прочитать docs/AGENT-ARCHITECTURE.md (обзор и запуск агента).
2. Проверить наличие .cursor/agent/plans/current_plan.yaml и при необходимости создать/обновить.
3. При длинной истории — проверить объём контекста; при >70% — сделать сводку в .cursor/agent/summaries/.
4. Подключить релевантные правила: context-optimization.mdc, multi-agent-handoffs.mdc, плюс правила Битрикс24 из bitrix24-knowledge.mdc.
5. Загружать скиллы по запросу (progressive disclosure): сначала список скиллов из bitrix24-knowledge.mdc и этот SKILL, при необходимости — context-*, memory-systems, evaluation, project-development.
6. История: после значимых исходов (коммит, релиз, смена архитектуры) предложить записать краткий итог в .cursor/agent/memory/recent_context.md или записать по просьбе пользователя. Подробнее: docs/AGENT-CONTROL.md.
7. Обновление контекста (все роли, включая Developer): при записи в recent_context.md, сводках, handoff-файлах в agents/<role>/ — учитывать .cursor/rules/bitrix24-knowledge.mdc как источник обязательных ограничений и навигации (см. подсекцию в том файле и docs/AGENT-CONTROL.md).

Связь с другими скиллами

• context-fundamentals — анатомия контекста, прогрессивная загрузка.
• context-degradation — lost-in-middle, poisoning, distraction.
• context-compression — сводки, tokens-per-task, артефакты.
• context-optimization — бюджет, маскирование, компактирование.
• memory-systems — слои памяти, выбор архитектуры.
• multi-agent-patterns — supervisor, handoff, изоляция.
• filesystem-context — scratch, планы, под-агенты.
• tool-design — консолидация инструментов, описания.
• evaluation / advanced-evaluation — рубрики, LLM-as-judge.
• project-development — пайплайн, task–model fit.

Ссылки

• Архитектура и запуск: docs/AGENT-ARCHITECTURE.md
• Правила Битрикс24 и проекта (в т.ч. для обновления памяти/контекста): .cursor/rules/bitrix24-knowledge.mdc
• Правила контекста: .cursor/rules/context-optimization.mdc
• Правила мультиагента: .cursor/rules/multi-agent-handoffs.mdc
• Структура памяти и агентов: .cursor/agent/*/README.md