diff --git a/AGENTS.md b/AGENTS.md index ef76c9a3..4c97c235 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,7 +4,7 @@ - This repo is part of the TechCon working set. - Use repo-local docs/status for task-specific truth, and use the hub-level access surface for no-secrets infra access guidance. - + ## Карта точек входа агентов > Единственное место, где записана раскладка нормативного текста по файлам @@ -290,6 +290,30 @@ python3 scripts/gates/workspace_hygiene.py остановить работу. Но игнорировать его вывод — значит оставлять следующей сессии ту же путаницу, из-за которой это правило и появилось. +## Задача Linear должна быть самостоятельной, а не указателем на файл + +Живая проверка 08.09.2026 (`scripts/gates/linear_description_heuristic.py`) +нашла: **30 из 111** живых задач команды `TML` несли в теле только имя +карточки канона и фразу «полный текст — путь к yaml-файлу» без единого слова +пересказа, а одна (TML-211) вообще ссылалась на файл на личной машине +владельца. Для читателя без доступа к `canon/` или к чужому диску такая +задача пуста. + +**Правило.** Тело задачи, создаваемой через `save_issue`, обязано нести все +4 блока `canon/standards/task-description-standard.md` целиком («Что +происходит» / «Почему это важно» / «Что сделать» / «Как поймём, что +готово») — не как обещание, а как факт: читатель без доступа к `canon/` +должен понять суть без единого дополнительного клика. + +Ссылка на карточку канона (`canon/problems/*.yaml`) — **разрешена +ДОПОЛНИТЕЛЬНО**, отдельной строкой `Ссылка:` внизу, не вместо текста. Не +пишите путь на личную машину владельца (`~/.claude/...` и подобные) — +ни один сторонний читатель не может его открыть. + +Это не заменяет стандарт — сверяйте с ним напрямую, а не с этим кратким +пересказом. Измеряется `scripts/gates/task_self_sufficiency.py` +(`observe_only`, не блокирует) как публичный KPI менеджмент-отчёта. + ## Источник правды об инфраструктуре