2.9 KiB
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> "сообщение"
Скрипт:
- проверяет, что ID есть в
STATUS.md; - требует, чтобы
STATUS.mdбыл обновлён (или явно--no-status); - делает коммит с префиксом
[ID]; - пушит в Gitea.