# Правила проекта Обязательны для людей и агентов. Нарушение = работа не засчитана. ## Правило 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 "сообщение" ``` Скрипт: 1. проверяет, что ID есть в `STATUS.md`; 2. требует, чтобы `STATUS.md` был обновлён (или явно `--no-status`); 3. делает коммит с префиксом `[ID]`; 4. пушит в Gitea.