From 64c61347df1d054b748df9c9f9c36d75f8a6ca60 Mon Sep 17 00:00:00 2001 From: techcon-hub-bot Date: Tue, 8 Sep 2026 11:31:06 +0000 Subject: [PATCH] =?UTF-8?q?docs(=D0=B0=D0=B3=D0=B5=D0=BD=D1=82=D1=8B):=20?= =?UTF-8?q?=D1=81=D0=B8=D0=BD=D0=BA=20=D0=B1=D0=BB=D0=BE=D0=BA=D0=B0=20?= =?UTF-8?q?=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=20=D0=B8=D0=B7=20techcon?= =?UTF-8?q?=5Fhub=20[automated]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- AGENTS.md | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) 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 менеджмент-отчёта. + ## Источник правды об инфраструктуре