From 92c78f0813f2efcf5e47e8a553ca13b8f624e890 Mon Sep 17 00:00:00 2001
From: Shahovalov MIkhail <m.shahovalov@yandex.ru>
Date: Fri, 10 Apr 2026 22:53:40 +0300
Subject: [PATCH] =?UTF-8?q?=D0=A3=D1=82=D0=BE=D1=87=D0=BD=D0=B5=D0=BD?=
 =?UTF-8?q?=D1=8B=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0=20AGENTS.md?=
 =?UTF-8?q?=20=D0=BF=D0=BE=20=D1=81=D1=81=D1=8B=D0=BB=D0=BA=D0=B0=D0=BC,?=
 =?UTF-8?q?=20=D1=82=D1=80=D0=B8=D0=B3=D0=B3=D0=B5=D1=80=D0=B0=D0=BC=20CI?=
 =?UTF-8?q?=20=D0=B8=20approval=20gates?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENTS.md | 23 +++++++++++++++++------
 1 file changed, 17 insertions(+), 6 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 23a5fdc..8cf1938 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -22,7 +22,8 @@ Approval/clarification:
 - binary → yes/no
 - multiple → numbered options + brief context
 
-- File links: relative paths, `/`, spaces as `%20`.
+- File links in repo docs/checklists: relative paths, `/`, spaces as `%20`.
+- In assistant UI responses, use the link format required by the execution environment; include relative path text when possible.
 
 ---
 
@@ -30,7 +31,7 @@ Approval/clarification:
 - Never commit/push without explicit user approval.
 - After approval → commit + push immediately.
 - Commit messages: Russian, factual (what was done).
-- Branch (`fix/*` or `feat/*`): ask once at dialogue start; reuse decision for all subsequent tasks in same dialogue.
+- Branch (`fix/*` or `feat/*`): ask once before the first file-changing task that may lead to commit; reuse decision for all subsequent tasks in same dialogue.
 
 After work in `fix/*` or `feat/*`:
 1. MR → main
@@ -107,8 +108,9 @@ Release ZIP:
 - only `.pak` + `info.json`
 
 Triggers:
-- tag `v*`
-- manual only
+- automatic: push tag `v*`
+- manual: workflow_dispatch
+- branch pushes without tag MUST NOT publish release artifacts
 
 ---
 
@@ -130,6 +132,11 @@ Before tag:
 - derives version from tag
 - writes to `info.json` + staged `meta.lsx`
 
+Conflict resolution (MUST):
+- before release, `Version64` in `meta.lsx` MUST equal target tag version
+- if mismatch, run `scripts/set-version.ps1 -VersionTag <tag>` and re-check
+- if still mismatch, release is blocked
+
 ---
 
 ## info.json (MUST)
@@ -152,7 +159,7 @@ Before commit:
 - scope valid (localization/metadata only)
 - no forbidden content
 - no build artifacts (`.pak`, `build/`, staging)
-- no temp/debug artifacts; ignored patterns: `build/`, `build-stage*`, `.tools/`, `*.pak`
+- no temp/debug artifacts; ignored patterns MUST be present in `.gitignore`: `build/`, `build-stage*`, `.tools/`, `*.pak`
 - packaging invariants intact
 - version consistent (if applicable)
 
@@ -201,6 +208,10 @@ Before release:
 - generate changelog draft
 - ask for approval
 
+Approval gates:
+- Gate A: explicit approval for commit/push (code/content changes)
+- Gate B: explicit approval for release publish (after changelog draft)
+
 Release message:
 - version
 - changelog
@@ -214,4 +225,4 @@ Do not:
 
 ## Rules Maintenance (MUST)
 - Changes to `AGENTS.md` / `ACTIONS.md`: prefer compressed, machine-readable edits.
-- Keep updates minimal and non-duplicative: merge overlapping points, remove redundancy, preserve intent.
\ No newline at end of file
+- Keep updates minimal and non-duplicative: merge overlapping points, remove redundancy, preserve intent.