# Агентская разработка

Агент помогает собрать workflow, интегрировать приложение и сопровождать движок. Начните с [запроса в установке](/doc/operations/install#начать-с-агентом).

## Контекст проекта

Перед работой агент определяет установленную версию SDK, формат workflow и доступные блоки. [llms.txt](/doc/llms.txt) содержит ссылки на страницы в Markdown. Для готовых инструментов используется <a href="/store/llms.txt" target="_self">индекс магазина</a>.

`AGENTS.md` или `CLAUDE.md` в репозитории приложения фиксирует его соглашения, расположение определений и команды проверки. Правила приложения сохраняются при обновлении инструментария.

## Порядок работы

1. Найти готовый workflow или операцию в <a href="/store/" target="_self">магазине</a> и проверить совместимость.
2. Собрать процесс из существующих блоков и конструкций с явными входами и выходами.
3. При необходимости подключить плагин существующего блока.
4. Обсудить новый блок только при подтверждённом пробеле, описав контракт, разные применения и альтернативы.
5. Проверить успешное выполнение и существенные ошибки на изолированных данных.

Бизнес-логика остаётся в workflow. Callback, Python/JS-скрипт или плагин не должны скрывать порядок прикладных действий. Секреты и реальные данные приложения не включаются в примеры и публикации.

## Харнесс

Харнесс — инструкции и инструменты, которые помогают агенту работать в этих границах.

| Часть | Назначение |
| --- | --- |
| Инструкции | Архитектурные границы и порядок выбора готовых инструментов |
| Skills | Повторяемые процедуры для конкретных задач |
| Проверки | Валидация определений, примеры, контракты и архитектурные ограничения |
| Документация и магазин | Схемы, совместимость, зависимости и результаты проверок выбранной версии |

Для разработки движка используйте его `AGENTS.md`, `CLAUDE.md` и обязательные проверки. Для приложения — инструкции его собственного репозитория.

## Чтение документации

Markdown-копия доступна по ссылке из меню «Скопировать» на каждой странице. Индексы документации и магазина позволяют выбирать нужные страницы без загрузки всего справочника в контекст.

Поиск и чтение документации не предоставляют доступ к запуску workflow, данным или секретам. Доступность дополнительных агентских инструментов указана в [составе версии](/doc/operations/install#версии).

## Подключить комплект

После установки SDK 0.3.1 выполните в репозитории приложения:

```bash
workflow-platform agent init . --agent both --workflows definitions
workflow-platform capabilities
workflow-platform validate definitions
```

`--agent codex` устанавливает skill в `.agents/skills/`, `--agent claude` — в `.claude/skills/`. Комплект добавляет ссылку в проектные `AGENTS.md`/`CLAUDE.md`; существующие правила сохраняются. Версия и хеши управляемых файлов записываются в `.workflow-platform/harness.json`. Повторная установка идемпотентна; локальные правки skill требуют явного объединения.

`.workflow-platform/pre-commit` содержит проверку определений. Подключите её к своим hooks или CI. Установщик не меняет глобальные настройки агентов или Git. Статическая валидация не выполняет workflow и не заменяет проверку приложения.

## MCP документации

URL для удалённого MCP: `https://wf.mdmatvey.com/mcp`. Сервер предоставляет `search_docs`, `read_doc`, `search_store`, `read_item`. Он читает опубликованную документацию и сведения о релизах; доступа к инсталляциям, секретам, установке пакетов и исполнению workflow у него нет.

Локальный вариант — отдельный пакет `workflow-platform-docs-mcp`, устанавливаемый в своё окружение. Передайте `--content PATH` к собранной публичной документации с каталогами `doc/` и `store/`; по умолчанию используется stdio. Для HTTP задайте `--transport streamable-http`. Пакет не входит в ядро.

Реализация использует [официальный Python SDK MCP](https://github.com/modelcontextprotocol/python-sdk). Формат настройки подключения зависит от агента; добавьте указанный URL через его управление MCP.