Агентская разработка
Агент помогает собрать workflow, интегрировать приложение и сопровождать движок. Начните с запроса в установке.
Контекст проекта
Перед работой агент определяет установленную версию SDK, формат workflow и доступные блоки. llms.txt содержит ссылки на страницы в Markdown. Для готовых инструментов используется индекс магазина.
AGENTS.md или CLAUDE.md в репозитории приложения фиксирует его соглашения, расположение определений и команды проверки. Правила приложения сохраняются при обновлении инструментария.
Порядок работы
- Найти готовый workflow или операцию в магазине и проверить совместимость.
- Собрать процесс из существующих блоков и конструкций с явными входами и выходами.
- При необходимости подключить плагин существующего блока.
- Обсудить новый блок только при подтверждённом пробеле, описав контракт, разные применения и альтернативы.
- Проверить успешное выполнение и существенные ошибки на изолированных данных.
Бизнес-логика остаётся в workflow. Callback, Python/JS-скрипт или плагин не должны скрывать порядок прикладных действий. Секреты и реальные данные приложения не включаются в примеры и публикации.
Харнесс
Харнесс — инструкции и инструменты, которые помогают агенту работать в этих границах.
| Часть | Назначение |
|---|---|
| Инструкции | Архитектурные границы и порядок выбора готовых инструментов |
| Skills | Повторяемые процедуры для конкретных задач |
| Проверки | Валидация определений, примеры, контракты и архитектурные ограничения |
| Документация и магазин | Схемы, совместимость, зависимости и результаты проверок выбранной версии |
Для разработки движка используйте его AGENTS.md, CLAUDE.md и обязательные проверки. Для приложения — инструкции его собственного репозитория.
Чтение документации
Markdown-копия доступна по ссылке из меню «Скопировать» на каждой странице. Индексы документации и магазина позволяют выбирать нужные страницы без загрузки всего справочника в контекст.
Поиск и чтение документации не предоставляют доступ к запуску workflow, данным или секретам. Доступность дополнительных агентских инструментов указана в составе версии.
Подключить комплект
После установки SDK 0.3.1 выполните в репозитории приложения:
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. Формат настройки подключения зависит от агента; добавьте указанный URL через его управление MCP.