Files
buryan-infra/ops/PROJECT-RULES.md

2.9 KiB

Правила проекта

Обязательны для людей и агентов. Нарушение = работа не засчитана.

Правило 1. Всё в Gitea

Любое изменение — код, конфиг, документ, решение — попадает в Gitea. Нет коммита — изменения не существует.

Что Куда
Код и скрипты agent-qwen/buryan-infra
Документация и знания infrastructure/buryan-wiki
Статусы ops/STATUS.md + страница Wiki Status
Решения ops/adr/ + страница ADR

Правило 2. У каждого изменения есть статус

Каждый коммит содержит идентификатор задачи из ops/STATUS.md:

[K-03] Бэкап конфигов CT-сервисов

Где префикс — раздел статуса:

Префикс Раздел
K- Скелет
A- Агенты
S- Сервисы и структура
W- Работа (Presale)
X- Инфраструктура и эксплуатация

Запрещено коммитить без идентификатора. Проверка:

python3 ops/tools/status.py check "K-03"

Правило 3. Статус меняется вместе с работой

Статус Значение
⏳ запланировано
🔄 в работе (начато)
✅ сделано и проверено
⛔ заблокировано (указать чем)

Нельзя поставить ✅ без артефакта: файл, сервис, страница, коммит.

Правило 4. Нет карточки — нет сервиса

Новый сервис добавляется только вместе с:

  • карточкой в ops/services/cards/,
  • записью в services.yaml,
  • бэкапом,
  • мониторингом,
  • строкой в STATUS.md.

Правило 5. Документация обновляется тем же коммитом

Изменил поведение — обнови описание. Иначе Wiki врёт.

Правило 6. Агенты подчиняются политике

Классы A/B/C/D из ops/agents/policy.yaml. Класс C — только с подтверждением владельца. Журнал — обязателен.

Проверка перед пушем

/usr/local/bin/commit-with-status <ID> "сообщение"

Скрипт:

  1. проверяет, что ID есть в STATUS.md;
  2. требует, чтобы STATUS.md был обновлён (или явно --no-status);
  3. делает коммит с префиксом [ID];
  4. пушит в Gitea.