Skip to content

docs(агенты): синк блока правил агентов из techcon_hub #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
pyramidheadshark merged 1 commit into from
Sep 10, 2026
Merged

docs(агенты): синк блока правил агентов из techcon_hub #40

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 27 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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.

<!-- techcon-hub:agent-rules:begin sha256:83faf5657d624d3d33e82954abac12551cd3ff5098ade01cf7f0e9104e274d9c -->
<!-- techcon-hub:agent-rules:begin sha256:c64cede8738f7b9f275a65913aaf6b33c5bf1eff2bd8f2f9168580b8103be524 -->
## Карта точек входа агентов

> Единственное место, где записана раскладка нормативного текста по файлам
Expand Down Expand Up @@ -124,6 +124,32 @@ squash) — `GIT-CONTRACT.md` §1.11.
Squash остаётся правильным для `feature/* → develop` — там проблемы ancestry
нет.

## Связь коммит↔задача Linear

> Извлечение действующего правила из `canon/GIT-CONTRACT.md` §1.13
> (08.09.2026, единая система Linear → лог работ → менеджерский экспорт).
> Полный контекст и обоснование — там; здесь — то, что агент обязан
> выполнять при работе над задачей Linear.

**Если коммит/PR продвигает конкретную задачу Linear** — имя ветки должно
содержать её идентификатор в форме `tml-<id>` (регистр неважен). Linear уже
сам предлагает такое имя ветки для каждой задачи (поле `gitBranchName`) —
использовать его, не изобретать своё.

**Без отдельной ветки на задачу** (мелкий фикс, хотфикс, коммит без заранее
созданной задачи) — указать идентификатор трейлером в теле коммита:
`Linear: TML-<id>` отдельной строкой, тем же местом, где стоит
`Co-Authored-By:` для агентских коммитов — не смешивать в одну строку.

**Не для каждого коммита.** Служебные/синхронизирующие коммиты
(`[automated]`-раздача, back-merge и подобные) привязки не требуют —
только коммиты, продвигающие содержательную работу, которую имело бы смысл
показать в «Логе работ» менеджмент-отчёта.

**Задача Linear остаётся человекочитаемой сама по себе** — идентификатор
живёт в git, не наоборот (не добавлять git-пермалинки в текст задачи, это
уже отменено, см. `canon/standards/linear-task-governance.md`).

## Формулировки в Swagger/OpenAPI — тот же стандарт, что и у портала документации

> Извлечение обязательного правила из `canon/standards/api-documentation-standard.md`
Expand Down
Loading