Зачем сисадмину ИИ-агент — реальный опыт работы с pi: Ansible-роли как контракт для людей и агентов
Саммари
Практик-сисадмин описывает, как опенсорсный терминальный агент pi (MIT, earendil-works) вписался в реальную инфраструктурную работу: от генерации Ansible-ролей до документации и расширения самого себя. Главный тезис статьи — хорошо написанная IaC-роль плюс файл AGENTS.md в корне репозитория образуют «контракт», понятный и коллеге-человеку, и следующему ИИ-агенту, поэтому агент и инженер выстраивают инструмент совместно, а не подменяют друг друга. Материал ценен честным разбором граблей (конфиги в Git, секреты вне Git, подтверждение опасных команд) и паттерном памяти проекта, который работает без векторных баз.
Из этого следует, что память агента не обязана быть сложной системой: один текстовый AGENTS.md, который читает и обновляет сам агент, даёт эффект «контекст уже на месте» и для людей, и для моделей — дешевле любого RAG на старте.
На практике для Revit-инструментов это прямой паттерн: PLAN.md с намерением («что должен сделать скрипт над моделью») + AGENTS.md с архитектурой проекта RevitApiTools, чтобы следующий Claude Code не переоткрывал базовые решения проекта.
Важный нюанс: идемпотентность и валидация — не самоцель, а способ сделать артефакт «читаемым для агента»: роль, которую можно прогнать сто раз и которая проверяет конфиг до рестарта, безопасна для автономных циклов правки.
Ограничение: статья — опыт одного практика, измеримых цифр (время экономии, частота ошибок) в ней нет; масштабирование на команду и на регулируемые среды требует собственной метрики.