У меня десктоп на Ubuntu: свежее ядро, RTX 5070 Ti, Wayland — всё то, что периодически ломается. И я не девопс, я аналитик, который хочет, чтобы система просто работала. Недавно опять отвалилось переключение языка. Раньше я бы два часа гуглил, копировал команды со StackOverflow, ломал что-нибудь ещё — починил бы, но не понял как. А через месяц всё заново, потому что ничего не записал. В этот раз я сделал по-другому.

Что я сделал

Создал папку devops/ и один файл — CLAUDE.md. Это инструкция для Claude Code (AI-агент, работающий в терминале):

# Система
- OS: Ubuntu 25.04, ядро 6.14
- GPU: RTX 5070 Ti, драйвер 570
- Сервисы: Docker, PostgreSQL, Nginx

# Правила
- Перед началом — прочитай логи из logs/
- Каждое действие логируй в logs/
- Не трогай конфиги без бэкапа
- После фикса — проверь, что не сломал другое

Всё. Это вся «архитектура».

Как это работает

Запускаю агента в этой папке. Он читает CLAUDE.md и знает: какая система, что стоит, что чинили раньше. Говорю: «раскладка крашит сессию, почини». Агент читает логи (видит, что месяц назад уже была эта проблема), диагностирует, перед опасными командами спрашивает подтверждение, и записывает результат:

# 2025-02-15: Переключение раскладки
Проблема: после обновления GNOME 48 сессия падает
Диагностика: input-sources пустой, ошибки extension
Решение: пересоздал input-sources, отключил расширение
Проверка: переключил 50 раз — не крашится

В следующий раз агент не начинает с нуля: читает историю и не тратит время на тупиковые решения.

Это же ровно работа аналитика

Если убрать слово «Linux», получится то, чем мы занимаемся каждый день:

  • CLAUDE.md — это AS-IS системы и одновременно ТЗ для исполнителя (агента).
  • logs/ — журнал решений, тот же changelog.
  • Вся папка — инструкция для повторяемого процесса.

Обычно мы описываем чужие системы для чужих исполнителей. А тут — свою систему для своего агента.

Что может пойти не так

Агент выполняет команды с правами твоего пользователя. Если не понимаешь, что он делает, — ты не делегируешь, а играешь в рулетку. Поэтому: читаю команды перед подтверждением (rm -rf точно замечу), держу папку в git (наломает — откачусь), sudo подтверждаю вручную.

Делегирование не отупляет — оно учит, если не жмёшь «подтвердить» с закрытыми глазами. После десятка сессий я уже понимаю, что такое systemctl restart и зачем journalctl -xe, хотя специально systemd не учил.

Выводы

  • Не обязательно быть экспертом — достаточно уметь описать контекст, поставить задачу и организовать процесс так, чтобы знания не терялись.
  • Это тот же навык, что и в аналитике, просто направленный на свою систему.
  • AI-агент без контекста — гугл с автодополнением. С контекстом и историей — младший коллега, который помнит прошлый спринт.