docs(agents): контракт скиллов — трекер, метки триажа, доки и нейминг

- Зачем:
  - инженерные скиллы (to-tickets, triage, wayfinder, domain-modeling) ждут
    репо-локальную настройку; без неё они не знают, чем заводить issues и
    какими метками размечать. Дока трекера жила ссылкой на репозиторий
    предшественника — внешняя зависимость на месте источника истины.
- Что:
  - заведён docs/agents/: issue-tracker.md (Gitea через tea, команды,
    wayfinding, отдельный раздел про то, что «Закрывает #NN» issue не
    закрывает), triage-labels.md (пять канонических меток без переименований)
    и domain.md (один контекст, CONTEXT.md и docs/adr/).
  - в AGENTS.md добавлен раздел «Agent skills» со ссылками на эти файлы,
    ссылка на доку предшественника заменена локальной.
  - в «Структуре» закреплён нейминг: ГГГГ-ММ-ДД-слаг для docs/specs/ и
    docs/research/, NNNN-слаг для docs/adr/.
- Проверка:
  - tea labels list — все пять меток триажа заведены в репозитории;
  - tea api version — Gitea 1.27.0, команды из доки отвечают живьём.
This commit is contained in:
2026-07-31 09:45:19 +03:00
parent 6c10f48c17
commit d3bc2f7c18
4 changed files with 234 additions and 2 deletions
+22
View File
@@ -0,0 +1,22 @@
# Метки триажа
Скиллы говорят о пяти канонических ролях триажа. Эта таблица переводит роли в
метки, которые реально заведены в трекере репозитория.
| Роль в скиллах | Метка у нас | Значение |
| ----------------- | ----------------- | ------------------------------------------- |
| `needs-triage` | `needs-triage` | Задачу надо оценить, решение не принято |
| `needs-info` | `needs-info` | Ждём уточнений от автора |
| `ready-for-agent` | `ready-for-agent` | Постановка полная, можно отдавать агенту |
| `ready-for-human` | `ready-for-human` | Нужен человек |
| `wontfix` | `wontfix` | Делать не будем |
Имена совпадают с каноническими: переименований нет. Когда скилл говорит про
роль («поставь метку готовности для агента»), берём строку из правой колонки.
Все пять меток уже созданы в Gitea (проверено `tea labels list` 2026-07-31) —
заводить их заново не нужно. Кроме них в репозитории живут метки карты
`wayfinder:*` (`map`, `research`, `prototype`, `grilling`, `task`); к триажу они
отношения не имеют, ими размечает `/wayfinder`.
Если вокабуляр меток поменяется — править правую колонку здесь, а не в скиллах.