[K-09] Wiki: страницы Status и Rules
This commit is contained in:
1 parent
a763586026
commit
32db314bcb
2 files changed
+142
No files matched your search
@@ -0,0 +1,80 @@
|
||||
# Правила проекта
|
||||
|
||||
Обязательны для людей и агентов. Нарушение = работа не засчитана.
|
||||
|
||||
## Правило 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.
|
||||
Reference in new issue
Block a user