Редакция 4 мая 2026 г.

Agent Workspace as Code: убираем копипаст `CLAUDE.md` и собираем `.agents/` как код

Agent Workspace as Code (AWaC) в посте на DEV Community описан как способ собрать правила, skills и workflows для AI coding agent из декларативного манифеста, версионируемых стеков и локального CLI — вместо бесконечного копирования .agents/, CLAUDE.md и .cursorrules, когда MCP и инструкции для Claude Code, Cursor и Aider расходятся между проектами. Автор проводит параллель с инфраструктурой: декларация желаемого состояния вытеснила чисто ручную настройку серверов до 2014 года и закрепилась после эпохи широкого распространения Terraform (временные ориентиры приводит сам материал).

Почему конфигурация под агентов «плывёт» между проектами

Здесь обычно рождается дрейф: без общей модели версионирования одна команда чинит промпт в одном репозитории, а в форке остаётся старая версия правил. AWaC трактует слой правил, skills, workflows и соглашений, которые читает агент, как объект, который можно описать декларативно и воспроизводимо собрать — и тем самым сближает инженерную дисциплину с тем, как устроены AI coding agents в повседневной разработке.

Terraform как метафора для слоя над кодом

Идея не в том, чтобы заменить Terraform, а перенести знакомый паттерн «задекларировал — получил согласованное состояние» на каталог .agents/ и сопутствующие файлы вроде CLAUDE.md: один раз описать состав стеков и политику сборки, а не бесконечно синхронизировать форки заметок между командами.

Манифест `workspace.yml`, стеки GitHub и цикл `wsp bootstrap`

В материале показан пример фрагмента workspace.yml: поле schema: workspace/1, имя окружения и список stacks, в том числе core, aws, mcp, my-product/agent-stack. Логика wsp bootstrap включает шаги: разрешение shortcuts через registry в /agent-stack-core/awac.yml, клонирование репозиториев стеков на последний коммит ветки main, детерминированная сборка .agents/{rules,skills,workflows}/ с правилом «last stack wins on collisions», генерация CLAUDE.md и AGENTS.md, фиксация workspace.lock.yml с точными коммитами. Stack задаётся как обычный репозиторий на GitHub с корневым awac.yml и каталогами rules/, skills/, workflows/, опционально templates/. Упоминаются открытые эталонные стеки с префиксом имени getGanemo/agent-stack-* (в том числе core, AWS, MCP, Cloudflare) и мысль, что свой стек можно публиковать, соблюдая конвенцию.

CLI «с прицелом на агента»: структурированный вывод и самодиагностика

В agent-first CLI команды принимают флаг --json и возвращают структурированный результат; ошибки свёрнуты в поля code, category, cause, remediation — среди иллюстраций встречается code: "WSP_007", категория environment, причина связана с gh CLI, ремедиация — через gh auth login. Роль wsp doctor — обрабатывать падения проверок: агент может идти по подсказке remediation или передать эскалацию человеку.

Локальная модель, релизы и решения в ADR

В тексте поста проект описан как решение без SaaS и без хостинга дашборда: CLI работает полностью локально, стеки лежат в GitHub, отдельно заявлены отсутствие telemetry и backend; мотивацию открытого исходника без коммерческого облака связывают с ADR 014 (adoption, thought leadership, не revenue). Распространение — через GitHub Releases (gh release download и pipx install), а не через PyPI, с отсылкой к ADR 012; в roadmap PyPI обещан при появлении спроса. В core-командах нет интерактивных промптов; подтверждения — флагами --yes и --update. Лицензия обозначена как MIT; контраст с Apache 2.0 подано как позиция изложения, без претензии на юридическую оценку. Для архитектурных решений заявлено 14 ADR; среди примеров: 001 — единица композиции workspace; 004 — CLAUDE.md каноничен, AGENTS.md зеркален; 007 — CLI agent-first; 010 — DevVault как двухслойная модель; 012 — GitHub Releases против PyPI; 014 — AWaC остаётся open-source без SaaS. Подробности отсылаются в репозиторий документации getGanemo/awac-docs.

С чего начать и куда писать с обратной связью

В блоке «Try it» описан типовой путь: узнать тег релиза через gh release view --repo getGanemo/workspace-cli, скачать .whl, установить через pipx install, затем выполнить wsp init my-feature --template blank и wsp bootstrap. Обсуждение и багрепорты предлагается вести в issues репозитория workspace-cli; дорожная карта вынесена в issue #2.

Источники

«Agent Workspace as Code: stop copy-pasting your CLAUDE.md across projects» — DEV Community (профиль fernando_pastor). URL: Dev.to (дата доступа для верификации содержания: 2026-05-04, 12:00 UTC).