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

81 lines
2.9 KiB
Markdown

# Правила проекта
Обязательны для людей и агентов. Нарушение = работа не засчитана.
## Правило 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.